Platform LSF Version 6.0 - Platform LSF Reference

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]

cshrc.lsf and profile.lsf

Contents

About cshrc.lsf and profile.lsf
LSF Environment Variables Set by cshrc.lsf and profile.lsf

[ Top ]

About cshrc.lsf and profile.lsf

The user environment shell files cshrc.lsf and profile.lsf set the LSF operating environment on an LSF host. They define machine-dependent paths to LSF commands and libraries as environment variables:

cshrc.lsf sets the C shell (csh or tcsh) user environment for LSF commands and libraries
profile.lsf sets and exports the Bourne shell/Korn shell (sh, ksh, or bash) user environment for LSF commands and libraries

LSF Administrators should make sure that cshrc.lsf or profile.lsf are available for users to set the LSF environment variables correctly for the host type running LSF.

Location

cshrc.lsf and profile.lsf are created by lsfinstall during installaton. After installation, they are located in LSF_CONFDIR (LSF_TOP/6.0/conf/).

Format

cshrc.lsf and profile.lsf are conventional UNIX shell scripts:

cshrc.lsf runs under /bin/csh
profile.lsf runs under /bin/sh

What cshrc.lsf and profile.lsf do

cshrc.lsf and profile.lsf determine the binary type (BINARY_TYPE) of the host and set environment variables for the paths to the following machine- dependent LSF directories, according to the LSF version (LSF_VERSION) and the location of the top-level installation directory (LSF_TOP) defined at installation:

LSF_BINDIR
LSF_SERVERDIR
LSF_LIBDIR
XLSF_UIDDIR

cshrc.lsf and profile.lsf also set the following user environment variables:

LSF_ENVDIR
LD_LIBRARY_PATH
PATH to include the paths to:

LSF_BINDIR
LSF_SERVERDIR

MANPATH to include the path to the LSF man pages

Setting up the LSF environment with cshrc.lsf and profile.lsf

Before using LSF, you must set up the LSF execution environment.

After logging on to an LSF host, use one of the following shell environment files to set your LSF environment:
For example, in csh or tcsh:
% source /usr/share/lsf/lsf_51/conf/cshrc.lsf
For example, in sh, ksh, or bash:
$ . /usr/share/lsf/lsf_51/conf/profile.lsf
Making your cluster available to users with cshrc.lsf and profile.lsf

To set up the LSF user environment, run one of the following two shell files:

LSF_CONFDIR/cshrc.lsf (for csh, tcsh)
LSF_CONFDIR/profile.lsf (for sh, ksh, or bash)

LSF administrators should make sure all LSF users include one of these files at the end of their own .cshrc or .profile file, or run one of these two files before using LSF.

For csh or tcsh

Add cshrc.lsf to the end of the .cshrc file for all users:

Copy the cshrc.lsf file into .cshrc

OR
Add a line similar to the following to the end of .cshrc:
source /usr/share/lsf/lsf_51/conf/cshrc.lsf
After running cshrc.lsf, use setenv to see the environment variable settings. For example:

% setenvPATH=/usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/bin:/usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/etc:/home/user1/bin:/local/private/user1/bin:/etc:/usr/etc:/usr/local/bin:/u sr/local/sbin:/bin:/usr/bin:/usr/sbin:/opt/local/bin:/local/share/bin:/opt/gnu/ bin:/sbin:/usr/bin/X11:/usr/bsd:/usr/ucb:/local/bin/X11:/usr/hosts:/usr/openwin /bin:/usr/ccs/bin:/usr/vue/bin:. ... MANPATH=/usr/share/lsf/lsf_51/5.1/man:/home/user1/man:/opt/SUNWhpc/man:/usr/man :/usr/local/man:/usr/softbench/man:/usr/openwin/man:/opt/SUNWmotif/man:/opt/ans ic/share/man:/opt/hpnp/man:/usr/share/man:/usr/share/catman ... LSF_BINDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/bin LSF_SERVERDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/etc LSF_LIBDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib LD_LIBRARY_PATH=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib XLSF_UIDDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib/uid LSF_ENVDIR=/usr/share/lsf/lsf_51/conf

For sh, ksh, or bash

Add profile.lsf to the end of the .profile file for all users:

Copy the profile.lsf file into .profile

OR
Add a line similar to following to the end of .profile:
. /usr/share/lsf/lsf_51/conf/profile.lsf
After running profile.lsf, use the set command to see the environment variable settings. For example:

$ set... LD_LIBRARY_PATH=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib LSF_BINDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/bin LSF_ENVDIR=/usr/share/lsf/lsf_51/conf LSF_LIBDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib LSF_SERVERDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/etc MANPATH=/usr/share/lsf/lsf_51/5.1/man:/home/user1/man:/opt/SUNWhpc/man:/usr/man :/usr/local/man:/usr/softbench/man:/usr/openwin/man:/opt/SUNWmotif/man:/opt/ans ic/share/man:/opt/hpnp/man:/usr/share/man:/usr/share/catman PATH=/usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/bin:/usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/etc:/home/user1/bin:/local/private/user1/bin:/etc:/usr/etc:/usr/local/bin:/u sr/local/sbin:/bin:/usr/bin:/usr/sbin:/opt/local/bin:/local/share/bin:/opt/gnu/ bin:/sbin:/usr/bin/X11:/usr/bsd:/usr/ucb:/local/bin/X11:/usr/hosts:/usr/openwin /bin:/usr/ccs/bin:/usr/vue/bin:. ... XLSF_UIDDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib/uid ...

cshrc.lsf and profile.lsf on dynamically added LSF slave hosts

Dynamically added LSF hosts that will not be master candidates are slave hosts. Each dynamic slave host has its own LSF binaries and local lsf.conf and shell environment scripts (cshrc.lsf and profile.lsf).

[ Top ]

LSF Environment Variables Set by cshrc.lsf and profile.lsf

LSF_BINDIR

Syntax

LSF_BINDIR=dir

Description

Directory where LSF user commands are installed.

Examples
Set in csh and tcsh by cshrc.lsf:
setenv LSF_BINDIR /usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/bin
Set and exported in sh, ksh, or bash by profile.lsf:
LSF_BINDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/bin
Values
In cshrc.lsf for csh and tcsh:
setenv LSF_BINDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/bin
Set and exported in profile.lsf for sh, ksh, or bash:
LSF_BINDIR=$LSF_TOP/$LSF_VERSION/$BINARY_TYPE/bin
LSF_ENVDIR

Syntax

LSF_ENVDIR=dir

Description

Directory containing the lsf.conf file.

By default, lsf.conf is installed by creating a shared copy in LSF_CONFDIR and adding a symbolic link from /etc/lsf.conf to the shared copy. If LSF_ENVDIR is set, the symbolic link is installed in LSF_ENVDIR/lsf.conf.

The lsf.conf file is a global environment configuration file for all LSF services and applications. The LSF default installation places the file in LSF_CONFDIR.

Examples
Set in csh and tcsh by cshrc.lsf:
setenv LSF_ENVDIR /usr/share/lsf/lsf_51/conf
Set and exported in sh, ksh, or bash by profile.lsf:
LSF_ENVDIR=/usr/share/lsf/lsf_51/conf
Values
In cshrc.lsf for csh and tcsh:
setenv LSF_ENVDIR $LSF_TOP/conf
Set and exported in profile.lsf for sh, ksh, or bash:
LSF_DIR=$LSF_TOP/conf
LSF_LIBDIR

Syntax

LSF_LIBDIR=dir

Description

Directory where LSF libraries are installed. Library files are shared by all hosts of the same type.

Examples
Set in csh and tcsh by cshrc.lsf:
setenv LSF_LIBDIR /usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/lib
Set and exported in sh, ksh, or bash by profile.lsf:
LSF_LIBDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib
Values
In cshrc.lsf for csh and tcsh:
setenv LSF_LIBDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/lib
Set and exported in profile.lsf for sh, ksh, or bash:
LSF_LIBDIR=$LSF_TOP/$LSF_VERSION/$BINARY_TYPE/lib
LSF_SERVERDIR

Syntax

LSF_SERVERDIR=dir

Description

Directory where LSF server binaries and shell scripts are installed.

These include lim, res, nios, sbatchd, mbatchd, and mbschd. If you use elim, eauth, eexec, esub, etc, they are also installed in this directory.

Examples
Set in csh and tcsh by cshrc.lsf:
setenv LSF_SERVERDIR /usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/etc
Set and exported in sh, ksh, or bash by profile.lsf:
LSF_SERVERDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/etc
Values
In cshrc.lsf for csh and tcsh:
setenv LSF_SERVERDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/etc
Set and exported in profile.lsf for sh, ksh, or bash:
LSF_SERVERDIR=$LSF_TOP/$LSF_VERSION/$BINARY_TYPE/etc
XLSF_UIDDIR

Syntax

XLSF_UIDDIR=dir

Description

(UNIX only) Directory where Motif User Interface Definition files are stored.

These files are platform-specific.

Examples
Set in csh and tcsh by cshrc.lsf:
setenv XLSF_UIDDIR /usr/share/lsf/lsf_51/5.1/sparc-sol7- 32/lib/uid
Set and exported in sh, ksh, or bash by profile.lsf:
XLSF_UIDDIR=/usr/share/lsf/lsf_51/5.1/sparc-sol7-32/lib/uid
Values
In cshrc.lsf for csh and tcsh:
setenv XLSF_UIDDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/lib/uid
Set and exported in profile.lsf for sh, ksh, or bash:
XLSF_UIDDIR=$LSF_TOP/$LSF_VERSION/$BINARY_TYPE/lib/uid
SEE ALSO

lsfinstall(8), install.config(5), lsf.cluster(5), lsf.conf(5), lsf.sudoers(5), slave.config(5)

[ Top ]

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]

Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.