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 uses the directory specified by LSF_TMPDIR on the execution host when a job is started and creates a job-specific temporary directory as a subdirectory of the LSF_TMPDIR directory.

The name of the job-specific temporary directory has the following format:

  • For regular jobs:

    • Unix: $LSF_TMPDIR/jobID.tmpdir

    • Windows: %LSF_TMPDIR%\jobID.tmpdir

  • For array jobs:

    • Unix: $LSF_TMPDIR/arrayID_arrayIndex.tmpdir

    • Windows: %LSF_TMPDIR%\arrayID_arrayIndex.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 to the job-specific temporary directory.

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 the job-specific temporary directory only on the first execution host.

To create a job-specific temporary directory on each execution host, set LSB_SET_TMPDIR=Y so that the path of the job-specific temporary directory is available through the TMPDIR environment variable, or set LSB_SET_TMPDIR to a user-defined environment variable so that the path of the job-specific temporary directory is available through the user-defined environment variable.

Tasks launched through the blaunch distributed application framework make use of the job-specific temporary directory:

  • When the job-specific temporary directory environment variable 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 job-specific temporary directory 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 job-specific temporary directory was created by the task RES, LSF deletes the directory and its contents when the task is complete

  • If the job-specific temporary directory was created by the job RES, LSF deletes the directory and its contents when the job is done

  • If the job-specific temporary 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 the 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 or /tmp

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

Parent topic: lsf.conf