Note: This version of the VDT (1.8.1) is no longer supported. Feel free to look through the documentation and install it, but we cannot guarantee support for it. The current stable release is 2.0.0.
The Job-Environment package is currently targeted at users in the Open Science Grid. If people consider it to be useful enough, we can generalize it.
The purpose of the Job-Environment package is to allow system
adminstrators to define environment variables that will appear in a
job's environment. For example, you may wish to define
$JOB_TMP to be /share/tmp, so that jobs can
discover where a large, shared temporary directory is located.
These environment variables should be placed in two files:
$VDT_LOCATION/monitoring/osg-job-environment.conf and
$VDT_LOCATION/monitoring/osg-local-job-environment.conf.
These files look like Bourne shell script. Note, however, that thes file must be
considerably simpler than a Bourne shell script. Lines that do not
define variables are ignored. Empty lines and comments are ignored. Lines beginning
with export are ignored. Do not put whitespace around the
equal signs. For example:
# Define job environment variables # These comments are ignored. JOB_TMP=/share/tmp # Good, JOB_TMP will be in environment export TMP # Ignored export JOB_FOO=/share/foo # Ignored, JOB_FOO will not be in environment JOB_TMP= /share/tmp # Bad because value of JOB_TMP will start with a space
While both of these files are treated equivalently, they have slightly
different purposes within OSG. The OSG's configure-osg.sh
script creates osg-job-environment.conf and any changes
you make to this file may be lost if you rerun
configure-osg.sh. Instead, you should only edit
osg-local-job-environment.conf.