#acl AdminGroup:admin,read,write
#acl All:read

= 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 JSOC'''''anything'''''" 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 [[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".