Platform LSF Configuration Reference Chapter 1
Total Page:16
File Type:pdf, Size:1020Kb
Platform LSF Version 9 Release 1.2 Configuration Reference SC27-5306-02 Platform LSF Version 9 Release 1.2 Configuration Reference SC27-5306-02 Note Before using this information and the product it supports, read the information in “Notices” on page 631. First edition This edition applies to version 9, release 1 of IBM Platform LSF (product number 5725G82) and to all subsequent releases and modifications until otherwise indicated in new editions. Significant changes or additions to the text and illustrations are indicated by a vertical line (|) to the left of the change. If you find an error in any Platform Computing documentation, or you have a suggestion for improving it, please let us know. Send your suggestions, comments and questions to the following email address: [email protected] Be sure include the publication title and order number, and, if applicable, the specific location of the information about which you have comments (for example, a page number or a browser URL). When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright IBM Corporation 1992, 2013. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Chapter 1. Configuration Files .....1 lsf.licensescheduler ...........502 cshrc.lsf and profile.lsf ...........1 lsf.shared ...............554 dc_conf.cluster_name.xml parameters ......9 lsf.sudoers ..............560 hosts ................16 lsf.task ...............566 install.config ..............18 setup.config ..............569 lim.acct ................30 slave.config ..............572 lsb.acct ................31 lsb.applications .............40 Chapter 2. Environment Variables . 579 lsb.events ...............86 Environment variables set for job execution . 579 lsb.hosts ...............126 Environment variables for resize notification lsb.modules ..............142 command ..............580 lsb.params ..............146 Environment variables for session scheduler lsb.queues ..............224 (ssched) ...............581 lsb.resources..............286 Environment variable reference .......582 lsb.serviceclasses ............320 lsb.users ...............330 Notices ..............631 lsf.acct................338 Trademarks ..............633 lsf.cluster ...............340 Privacy policy considerations ........633 lsf.conf ...............361 © Copyright IBM Corp. 1992, 2013 iii iv Platform LSF Configuration Reference Chapter 1. Configuration Files Important: Specify any domain names in all uppercase letters in all configuration files. cshrc.lsf and profile.lsf 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: v cshrc.lsf sets the C shell (csh or tcsh) user environment for LSF commands and libraries v profile.lsf sets and exports the Bourne shell/Korn shell (sh, ksh,orbash) user environment for LSF commands and libraries Tip: 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 installation. After installation, they are located in LSF_CONFDIR (LSF_TOP/conf/). Format cshrc.lsf and profile.lsf are conventional UNIX shell scripts: v cshrc.lsf runs under /bin/csh v 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: v LSF_BINDIR v LSF_SERVERDIR v LSF_LIBDIR v XLSF_UIDDIR cshrc.lsf and profile.lsf also set the following user environment variables: v LSF_ENVDIR v LD_LIBRARY_PATH v PATH to include the paths to: – LSF_BINDIR – LSF_SERVERDIR © Copyright IBM Corp. 1992, 2013 1 cshrc.lsf and profile.lsf v MANPATH to include the path to the LSF man pages If EGO is enabled If EGO is enabled in the LSF cluster (LSF_ENABLE_EGO=Y and LSF_EGO_ENVDIR are defined in lsf.conf), cshrc.lsf and profile.lsf set the following environment variables. v EGO_BINDIR v EGO_CONFDIR v EGO_ESRVDIR v EGO_LIBDIR v EGO_LOCAL_CONFDIR v EGO_SERVERDIR v EGO_TOP Setting the LSF environment with cshrc.lsf and profile.lsf Before using LSF, you must set the LSF execution environment. After logging on to an LSF host, use one of the following shell environment files to set your LSF environment: v For example, in csh or tcsh: source /usr/lsf/lsf_9/conf/cshrc.lsf v For example, in sh, ksh,orbash: . /usr/lsf/lsf_9/conf/profile.lsf Making your cluster available to users with cshrc.lsf and profile.lsf To set the LSF user environment, run one of the following two shell files: v LSF_CONFDIR/cshrc.lsf (for csh, tcsh) v LSF_CONFDIR/profile.lsf (for sh, ksh,orbash) Tip: 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: v Copy the cshrc.lsf file into .cshrc,or v Add a line similar to the following to the end of .cshrc: source /usr/lsf/lsf_9/conf/cshrc.lsf After running cshrc.lsf, use setenv to see the environment variable settings. For example: setenv PATH=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin ... MANPATH=/usr/lsf/lsf_9/9.1.2/man 2 Platform LSF Configuration Reference cshrc.lsf and profile.lsf ... LSF_BINDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin LSF_SERVERDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/etc LSF_LIBDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib LD_LIBRARY_PATH=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib XLSF_UIDDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib/uid LSF_ENVDIR=/usr/lsf/lsf_9/conf Note: These variable settings are an example only. Your system may set additional variables. For sh, ksh, or bash Add profile.lsf to the end of the .profile file for all users: v Copy the profile.lsf file into .profile,or v Add a line similar to following to the end of .profile: . /usr/lsf/lsf_9/conf/profile.lsf After running profile.lsf, use the setenv command to see the environment variable settings. For example: setenv ... LD_LIBRARY_PATH=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib LSF_BINDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin LSF_ENVDIR=/usr/lsf/lsf_9/conf LSF_LIBDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib LSF_SERVERDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/etc MANPATH=/usr/lsf/lsf_9/9.1.2/man PATH=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin ... XLSF_UIDDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib/uid ... Note: These variable settings are an example only. Your system may set additional variables. 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). LSF environment variables set by cshrc.lsf and profile.lsf LSF_BINDIR Syntax LSF_BINDIR=dir Description Directory where LSF user commands are installed. Chapter 1. Configuration Files 3 cshrc.lsf and profile.lsf Examples v Set in csh and tcsh by cshrc.lsf: setenv LSF_BINDIR /usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin v Set and exported in sh, ksh,orbash by profile.lsf: LSF_BINDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/bin Values v In cshrc.lsf for csh and tcsh: setenv LSF_BINDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/bin v Set and exported in profile.lsf for sh, ksh,orbash: 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 v Set in csh and tcsh by cshrc.lsf: setenv LSF_ENVDIR /usr/lsf/lsf_9/conf v Set and exported in sh, ksh,orbash by profile.lsf: LSF_ENVDIR=/usr/lsf/lsf_9/conf Values v In cshrc.lsf for csh and tcsh: setenv LSF_ENVDIR $LSF_TOP/conf v Set and exported in profile.lsf for sh, ksh,orbash: LSF_ENVDIR=$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. 4 Platform LSF Configuration Reference cshrc.lsf and profile.lsf Examples v Set in csh and tcsh by cshrc.lsf: setenv LSF_LIBDIR /usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib v Set and exported in sh, ksh,orbash by profile.lsf: LSF_LIBDIR=/usr/lsf/lsf_9/9.1.2/linux2.6-glibc2.3-x86/lib Values v In cshrc.lsf for csh and tcsh: setenv LSF_LIBDIR $LSF_TOP/$LSF_VERSION/$BINARY_TYPE/lib v Set and exported in profile.lsf for sh, ksh,orbash: 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.