Using testPack.pl

testPack.pl  is a component of the ReleaseManager that provides the ability for users to automatically build and test their packages in Linux. It takes as input a GLAST package name and version tag (which can be "head") as well as a checkout package name and version to build against. It runs a setup script for the checkout package (if found in the GLAST release area) and tries to build the package using standard CMT commands. If alternative versions for some of the packages are desired, a file containing 3 white space separated columns, using the format for use statements in CMT requirements files should be provided.  This can be done in one of two ways. The user can 1) provide the name of the file as a command line option or 2) name the file RMUsePacks.txt and put the file in the directory from which testPack.pl is run. If successful re. building the package testPack.pl then tries to run a conventionally named and placed test (i.e. the program named test_<package>.exe in the package binary directory). It builds standard error and standard output logs locally, in a file called GlastRM under the directory from which the program was run, for the users convenience. It also builds a web page with the error or test output and sends email to the user containing a brief description of the results and a link to the web page.

The man page style usage description follows:

Usage: testPack.pl [-c] package version checkpack version [usefile]

ARGUMENTS
package - name of package to test
version1 - version of package to test (with head as option)
checkpack - checkout package to build against (note that this must be a package that has been successfully built and currently lives in the GLAST release package area)
version2 - version of checkout package to build against
usefile - optional 3 column text file containing lines with the format of CMT requirements file use statements specifying a list of packages and versions to use to build the package against (i.e. to override versions specified by the checkout package). If a usefile is not specified testPack.pl will look in the current directory for a file called RMUsePacks.txt.

OPTIONS
-c - use the users CMTPATH environment varaible (NOTE: this option MUST proceed arguments)

EXAMPLES
Example 1: testPack.pl  tkrRecon v4r4 pdrApp v3r1 usefile - try to build and run test for tkrRecon version 4 release 4 against the packages specified in the requirements file for version 3 release 1 of the pdrApp.

Example 2: testPack.pl -c tkrRecon v4r4 pdrApp v7r1 - try to build and run test for tkrRecon version 4 release 4 against the packages specified in the requirements file for version 7 release 1 of pdrApp package and use the users CMTPATH

Created by: K. Young

14 February 2002 17:19