DRMS Environment Variables

In order to use JSOC-SDP DRMS software you will need to set a few environment variables. The easiest way to do this is to include a standard script into your .cshrc file (assuming you use csh, tcsh, or a related shell)

User but not developer

If you will not be developing new analysis programs (at least for now) and simply need to run existing JSOC programs then do the following:

Add the following line to your .cshrc file:

source /home/jsoc/.setJSOCuser_env

This will add JSOCROOT and JSOC_MACHINE variables to your environment and set the search path to find JSOC programs.

If you use the "MANPATH" method of finding user man pages you should also add MANPATH info in your .login file (or other startup file of choice), after where you source .setJSOCenv, by including a line such as:

setenv MANPATH $MANPATH":$JSOCROOT/man"

However, if you run on linux, setting MANPATH is not necessary.

Now type:

source ~/.cshrc

And you are ready to run commands. Go back to the previous page and proceed to the next step.

Developer

If you expect to compile programs in the JSOC DRMS environment you will need to setup a work area. You will setup your cvs work area in the next main step but now you can setup your .cshrc file to set some environment variables and to set the search path. At present the best thing to do is to add the following line to your .csrhc file:

source /home/jsoc/.setJSOCenv

This will add JSOCROOT, JSOC_MACHINE, CVSROOT and CVS_RSH to your environment. It will also add to your path the jsoc binary and script path.

The .setJSOCenv file can be seen [http://jsoc.stanford.edu/setJSOCenv.txt here]

NOTE: If you are "upgrading" from the "user" setup, be sure to remove the alternate version. Also make sure you do not have any other "setenv JSOCanything" in your .cshrc. To check that all is OK, after opening a new window or sourcing the above file, $JSOCROOT shouldbe your cvs/JSOC place, NOT ~jsoc/cvs/JSOC!!

(Warning: the above script will only work if your JSOC root is set up as suggested in the [wiki:CvsInit Make Your CVS Work Area] instructions. If your cvs Work Area is somewhere other than at $HOME/cvs/JSOC, you need to specify that directory as your JSOCROOT environment variable.)

You should also add MANPATH info in your .cshrc file (or other startup file of choice), after sourcing .setJSOCenv, by including a line such as:

setenv MANPATH $MANPATH":$JSOCROOT/man"

It is not necessary to modify (or even set) your MANPATH under Linux. Linux man searches all directories in your executable path for corresponding directories named ../man

The above is based on the directory JSOC in $HOME/cvs/. Since there are other cvs trees that may be of interest this is the suggested way. If you deviate from this then you should make the apporpriate adjustments to the scripts and variables used in them. For simplicity in typing many users make a link in their $HOME directory such as: "ln -s cvs/JSOC JSOC".