First Steps

0. What You Need Before Installing the Run 1 Linux code

Our distribution includes:

Required/Recommended software & installation:

1. Installing the Run 1 Linux code

There are currently two ways to get the code onto your machine, through: A) tar files or B) the CVS repository on cdfsga for Run 1 code.

A) Getting Run 1 code from tar files:

1. Find a place to put the code on. We assume that you have already installed Run II software onto your machine, so we would recommend that you put the code into a directory next to the Run II software directory. You will need a total of at least 1 Gb of space for the Run I code.
** Example **
On our machine, we have a directory "/cdf/code" where we have all located our software. A subdirectory of "/cdf/code" is for the Run II software and is "/code/cdfsoft". We put the Run I code in "/cdf/code/cdfsoft1".

Declare the environmental variable CODE to be the directory one above your Run II code -- in our case that would be "/cdf/code". Then your Run I software should reside in "$CODE/cdfsoft1".

Steps 2 - 8 must be executed as the cdfsoft user. Preferably, execute the command "su - cdfsoft" to become cdfsoft.

2. Get these gzipped tar files of the Run 1 code and place them in $CODE/cdfsoft1:

3. Place this file in the Run II directory ($CODE/cdfsoft): run1.tar.gz (13 MB).

Untar the files in their respective directories (i.e., all except run1.tar.gz in $CODE/cdfsoft1, run1.tar.gz in $CODE/cdfsoft)
** Example **
("-->" stands for the shell prompt)
-->tar -xzvf development.tar.gz
This will create the files in the proper directory structure.

5. The cdf1.cshrc file is required for setting up various items required for the Run II or Run I environment. Place this file in your top-level directory for Run II code ($CODE/cdfsoft). You should have the file "setups.csh" in your "$CODE/cdfsoft/products/setups" directory, by virtue of having Run II code set up. "setups.csh" calls several other scripts located in the same directory to set up the UPS software.

6. Setup cdfsoft2 and source cdf1.cshrc.
--> setup cdfsoft2
--> source $CODE/cdfsoft/cdf1.cshrc

7. Declare the development and 7.12 version packages and the gcc compiler in UPS.
** Example **
--> ups declare cdfsoft1 development -f Linux+2 -M ups -m cdfsoft1.table -r $CODE/cdfsoft/run1/dist/releases/development -c
--> ups declare cdfsoft1 7.12 -f Linux+2 -M ups -m cdfsoft1.table -r $CODE/cdfsoft1/7.12
--> ups declare gcc v2_95_2 -f Linux+2.2 -M ups -m gcc.table -r $CODE/cdfsoft/run1/gcc/v2_95_2

  • Append the qualifier "-c" to the end of the development declaration to make that version the current version.
  • If the ups declarations have been successful, several files should be created in the $RUN1_PRODUCTS/cdfsoft1 and $RUN1_PRODUCTS/gcc directories (aka "$CODE/cdfsoft/run1/upsdb/cdfsoft1" and "$CODE/cdfsoft/run1/upsdb/gcc"). These files include "development.version", "7.12.version", and "v2_95_2.version" and should resemble these files. In addition, if you declared 7.12 or development as the current version, then the file "current.chain" will also be present.
  • You may have to manually edit "current.chain", "development.version", "7.12.version", or "v2_95_2.version" in order to get the products declared properly, but do so carefully.

    8. Set up the Run I environment variables.
    ** Example **
    --> setup cdfsoft1 xxx (where "xxx" is "development" for development code and is "7.12" for the 7.12 version)
    If you have declared either 7.12 or development as the current version, you can simply type in "setup cdfsoft1".
    The output of this command may resemble this.

    Setup has been completed and you should be able to use the code as any user.

    You will have to setup cdfsoft2 and source the cdf1.cshrc file whenever you open a new shell before you can issue the setup command.
    ** Example **
    Upon login:
    --> setup cdfsoft2
    --> source YOUR_RUN_II_CODE_DIRECTORY/cdf1.cshrc
    [i.e. "source $CODE/cdfsoft/cdf1.cshrc"]
    --> setup cdfsoft1 xxx (where "xxx" is "development" for development code and is "7.12" for the 7.12 version)

    9. (Optional) Recompiling the code.
    If you wish to recompile the code (for the development version):

    1. Become the cdfsoft user
    2. Run the setups as described in part 8
    3. Switch to the development directory
    4. To compile with gcc, run setenv SRT_CXX EGCS_1_1 && setenv SRT_SUBDIR Linux2-EGCS_1_1 && setenv BFARCH Linux2-EGCS_1_1 && setenv DEFAULT_SRT_CXX EGCS_1_1
    5. Run gmake clean followed by gmake all.

    Please let us know if you encounter any problems along the way and please send your comments and suggestions to us.

    B) Getting Run 1 code from the CVS repository on cdfsga:

    The procedure for installing Run 1 code using the CVS repository is currently being tested on a new Linux machine. Once the proper steps have been determined, the correct procedure will be posted.

    2. Frequently Asked Questions and Known Problems

    More to come later!

    Please contact Peter and Henry if you have further questions.

    Back to the Run 1 Code on Linux: Users' Page

    Last update 2/28/01