LSF_TMPDIR

Syntax

LSF_TMPDIR=directory

Description

Specifies the path and directory for temporary job output.

When LSF_TMPDIR is defined in lsf.conf, LSF creates a temporary directory under the directory specified by LSF_TMPDIR on the execution host when a job is started and sets the temporary directory environment variable (TMPDIR) for the job.

The name of the temporary directory has the following format:
$LSF_TMPDIR/job_ID.tmpdir

On UNIX, the directory has the permission 0700 and is owned by the execution user.

After adding LSF_TMPDIR to lsf.conf, use badmin hrestart all to reconfigure your cluster.

If LSB_SET_TMPDIR= Y, the environment variable TMPDIR will be set equal to the path specified by LSF_TMPDIR.

If the path specified by LSF_TMPDIR does not exist, the value of TMPDIR is set to the default path /tmp/job_ID.tmpdir.

Valid values

Specify any valid path up to a maximum length of 256 characters. The 256 character maximum path length includes the temporary directories and files that the system creates as jobs run. The path that you specify for LSF_TMPDIR should be as short as possible to avoid exceeding this limit.

UNIX

Specify an absolute path. For example:
LSF_TMPDIR=/usr/share/lsf_tmp

Windows

Specify a UNC path or a path with a drive letter. For example:
LSF_TMPDIR=\\HostA\temp\lsf_tmp
LSF_TMPDIR=D:\temp\lsf_tmp

Temporary directory for tasks launched by blaunch

By default, LSF creates a temporary directory for a job only on the first execution host. If LSF_TMPDIR is set in lsf.conf, the path of the job temporary directory on the first execution host is set to LSF_TMPDIR/job_ID.tmpdir.

If LSB_SET_TMPDIR= Y, the environment variable TMPDIR will be set equal to the path specified by LSF_TMPDIR.

Tasks launched through the blaunch distributed application framework make use of the LSF temporary directory specified by LSF_TMPDIR:
  • When the environment variable TMPDIR is set on the first execution host, the blaunch framework propagates this environment variable to all execution hosts when launching remote tasks

  • The job RES or the task RES creates the directory specified by TMPDIR if it does not already exist before starting the job

  • The directory created by the job RES or task RES has permission 0700 and is owned by the execution user

  • If the TMPDIR directory was created by the task RES, LSF deletes the temporary directory and its contents when the task is complete

  • If the TMPDIR directory was created by the job RES, LSF will delete the temporary directory and its contents when the job is done

  • If the TMPDIR directory is on a shared file system, it is assumed to be shared by all the hosts allocated to the blaunch job, so LSF does not remove TMPDIR directories created by the job RES or task RES

Default

By default, LSF_TMPDIR is not enabled. If LSF_TMPDIR is not specified in lsf.conf, this parameter is defined as follows:
  • On UNIX: $TMPDIR/job_ID.tmpdir or /tmp/job_ID.tmpdir

  • On Windows: %TMP%, %TEMP, or %SystemRoot%