The install.config file contains options for LSF installation and configuration. Use lsfinstall -f install.config to install LSF using the options specified in install.config.
The sample values in the install.config template file are examples only. They are not default installation values.
After installation, the install.config containing the options you specified is located in <LSF_TOP>/9.1/install/.
NAME="STRING1 STRING2 ..."
The equal sign = must follow each NAME even if no value follows and there should be no spaces around the equal sign.
A value that contains multiple strings separated by spaces must be enclosed in quotation marks.
Blank lines and lines starting with a pound sign (#) are ignored.
CONFIGURATION_TEMPLATE="DEFAULT" | "PARALLEL" | "HIGH_THROUGHPUT"
LSF Standard Edition on UNIX or Linux only. Selects the configuration template for this installation, which determines the initial LSF configuration parameters specified when the installation is complete. The following are valid values for this parameter:
The installer uses the DEFAULT configuration template when installing LSF Standard Edition on Windows.
The installer specifies the following initial configuration file parameter values based on the selected configuration template:
DAEMON_SHUTDOWN_DELAY=180
LSF_LINUX_CGROUP_ACCT=Y
LSF_PROCESS_TRACKING=Y
JOB_DEP_LAST_SUB=1
JOB_SCHEDULING_INTERVAL=1
MAX_JOB_NUM=10000
NEWJOB_REFRESH=Y
SBD_SLEEP_TIME=7
LSB_SHORT_HOSTLIST=1
LSF_LINUX_CGROUP_ACCT=Y
LSF_PROCESS_TRACKING=Y
LSF_ENABLE_EXTSCHEDULER=Y
LSF_HPC_EXTENSIONS="CUMULATIVE_RUSAGE LSB_HCLOSE_BY_RES SHORT_EVENTFILE"
Refer to the Enable LSF HPC Features section for a full description.
JOB_DEP_LAST_SUB=1
JOB_SCHEDULING_INTERVAL=1
NEWJOB_REFRESH=Y
LSB_MAX_PACK_JOBS=300
LSB_SHORT_HOSTLIST=1
CONDENSE_PENDING_REASONS=Y
JOB_SCHEDULING_INTERVAL=50ms
MAX_INFO_DIRS=500
MAX_JOB_ARRAY_SIZE=10000
MAX_JOB_NUM=100000
MIN_SWITCH_PERIOD=1800
NEWJOB_REFRESH=Y
PEND_REASON_UPDATE_INTERVAL=60
SBD_SLEEP_TIME=3
The installer specifies the following initial configuration parameters for all configuration templates:
EGO_ENABLE_AUTO_DAEMON_SHUTDOWN=Y
LSB_DISABLE_LIMLOCK_EXCL=Y
LSB_MOD_ALL_JOBS=Y
LSF_DISABLE_LSRUN=Y
LSB_SUBK_SHOW_EXEC_HOST=Y
LSF_PIM_LINUX_ENHANCE=Y
LSF_PIM_SLEEPTIME_UPDATE=Y
LSF_STRICT_RESREQ
LSF_UNIT_FOR_LIMITS=MB
ABS_RUNLIMIT=Y
DEFAULT_QUEUE=normal interactive
JOB_ACCEPT_INTERVAL=0
MAX_CONCURRENT_JOB_QUERY=100
MBD_SLEEP_TIME=10
PARALLEL_SCHED_BY_SLOT=Y
Begin Queue
...
FAIRSHARE=USER_SHARES[[default, 1]]
...
End Queue
CONFIGURATION_TEMPLATE="HIGH_THROUGHPUT"
DEFAULT (the default configuration template is used)
EGO_DAEMON_CONTROL="Y" | "N"
Enables EGO to control LSF res and sbatchd. Set the value to "Y" if you want EGO Service Controller to start res and sbatchd, and restart if they fail. To avoid conflicts, leave this parameter undefined if you use a script to start up LSF daemons.
If you specify EGO_ENABLE="N", this parameter is ignored.
EGO_DAEMON_CONTROL="N"
N (res and sbatchd are started manually)
ENABLE_DYNAMIC_HOSTS="Y" | "N"
Enables dynamically adding and removing hosts. Set the value to "Y" if you want to allow dynamically added hosts.
If you enable dynamic hosts, any host can connect to cluster. To enable security, configure LSF_HOST_ADDR_RANGE in lsf.cluster.cluster_name after installation and restrict the hosts that can connect to your cluster.
ENABLE_DYNAMIC_HOSTS="N"
N (dynamic hosts not allowed)
ENABLE_EGO="Y" | "N"
Enables EGO functionality in the LSF cluster.
ENABLE_EGO="Y" causes lsfinstall uncomment LSF_EGO_ENVDIR and sets LSF_ENABLE_EGO="Y" in lsf.conf.
ENABLE_EGO="N" causes lsfinstall to comment out LSF_EGO_ENVDIR and sets LSF_ENABLE_EGO="N" in lsf.conf.
N (EGO is disabled in the LSF cluster)
ENABLE_STREAM="Y" | "N"
Enables LSF event streaming.
Enable LSF event streaming if you intend to install IBM Platform Analytics or IBM Platform Application Cluster.
N (Event streaming is disabled)
LSF_ADD_SERVERS="host_name [ host_name...]"
List of additional LSF server hosts.
Host names separated by spaces
Name of a file containing a list of host names, one host per line.
Any valid LSF host name.
List of host names:
LSF_ADD_SERVERS="hosta hostb hostc hostd"
Host list file:
LSF_ADD_SERVERS=:lsf_server_hosts
hosta
hostb
hostc
hostd
Only hosts in LSF_MASTER_LIST are LSF servers.
LSF_ADD_CLIENTS="host_name [ host_name...]"
After installation, you must manually edit lsf.cluster.cluster_name to include the host model and type of each client listed in LSF_ADD_CLIENTS.
Any valid LSF host name.
List of host names:
LSF_ADD_CLIENTS="hoste hostf"
Host list file:
LSF_ADD_CLIENTS=:lsf_client_hosts
hoste
hostf
No client hosts installed.
LSF_ADMINS="user_name [ user_name ... ]"
Required. List of LSF administrators.
The first user account name in the list is the primary LSF administrator. It cannot be the root user account.
Typically this account is named lsfadmin. It owns the LSF configuration files and log files for job events. It also has permission to reconfigure LSF and to control batch jobs submitted by other users. It typically does not have authority to start LSF daemons. Usually, only root has permission to start LSF daemons.
You should not configure the root account as the primary LSF administrator.
Existing user accounts
LSF_ADMINS="lsfadmin user1 user2"
None—required variable
LSF_CLUSTER_NAME="cluster_name"
Required. The name of the LSF cluster.
LSF_CLUSTER_NAME="cluster1"
Do not use the name of any host, user, or user group as the name of your cluster.
None—required variable
LSF_DYNAMIC_HOST_WAIT_TIME=seconds
Time in seconds slave LIM waits after startup before calling master LIM to add the slave host dynamically.
This parameter only takes effect if you set ENABLE_DYNAMIC_HOSTS="Y" in this file. If the slave LIM receives the master announcement while it is waiting, it does not call the master LIM to add itself.
Up to 60 seconds for every 1000 hosts in the cluster, for a maximum of 15 minutes. Selecting a smaller value will result in a quicker response time for new hosts at the expense of an increased load on the master LIM.
LSF_DYNAMIC_HOST_WAIT_TIME=60
Hosts will wait 60 seconds from startup to receive an acknowledgement from the master LIM. If it does not receive the acknowledgement within the 60 seconds, it will send a request for the master LIM to add it to the cluster.
Slave LIM waits forever
LSF_ENTITLEMENT_FILE=path
Full path to the LSF entitlement file. LSF uses the entitlement to determine which feature set to be enable or disable based on the edition of the product. The entitlement file for LSF Standard Edition is platform_lsf_std_entitlement.dat. For LSF Express Edition, the file is platform_lsf_exp_entitlement.dat. For LSF Advanced Edition, the file is platform_lsf_adv_entitlement.dat. The entitlement file is installed as <LSF_TOP>/conf/lsf.entitlement.
You must download the entitlement file for the edition of the product you are running, and set LSF_ENTITLEMENT_FILE to the full path to the entitlement file you downloaded.
Once LSF is installed and running, run the lsid command to see which edition of LSF is enabled.
LSF_ENTITLEMENT_FILE=/usr/share/lsf_distrib/lsf.entitlement
None — required variable
LSF_MASTER_LIST="host_name [ host_name ...]"
Required for a first-time installation. List of LSF server hosts to be master or master candidates in the cluster.
You must specify at least one valid server host to start the cluster. The first host listed is the LSF master host.
During upgrade, specify the existing value.
LSF server host names
LSF_MASTER_LIST="hosta hostb hostc hostd"
None — required variable
LSF_QUIET_INST="Y" | "N"
Enables quiet installation.
Set the value to Y if you want to hide the LSF installation messages.
LSF_QUIET_INST="Y"
N (installer displays messages during installation)
LSF_SILENT_INSTALL_TARLIST="ALL" | "Package_Name ..."
A string which contains all LSF package names to be installed. This name list only applies to the silent install mode. Supports keywords ?all?, ?ALL? and ?All? which can install all packages in LSF_TARDIR.
LSF_SILENT_INSTALL_TARLIST="ALL" | "lsf9.1.2_linux2.6-glibc2.3-x86_64.tar.Z"
None
LSF_TARDIR="/path"
Full path to the directory containing the LSF distribution tar files.
LSF_TARDIR="/usr/share/lsf_distrib"
The parent directory of the current working directory. For example, if lsfinstall is running under usr/share/lsf_distrib/lsf_lsfinstall the LSF_TARDIR default value is usr/share/lsf_distrib.
LSF_TOP="/path"
Required. Full path to the top-level LSF installation directory.
The path to LSF_TOP must be shared and accessible to all hosts in the cluster. It cannot be the root directory (/). The file system containing LSF_TOP must have enough disk space for all host types (approximately 300 MB per host type).
LSF_TOP="/usr/share/lsf"
None - required variable
PATCH_BACKUP_DIR="/path"
Full path to the patch backup directory. This parameter is used when you install a new cluster for the first time, and is ignored for all other cases.
The file system containing the patch backup directory must have sufficient disk space to back up your files (approximately 400 MB per binary type if you want to be able to install and roll back one enhancement pack and a few additional fixes). It cannot be the root directory (/).
If the directory already exists, it must be writable by the cluster administrator (lsfadmin).
If you need to change the directory after installation, edit PATCH_BACKUP_DIR in <LSF_TOP>/patch.conf and move the saved backup files to the new directory manually.
PATCH_BACKUP_DIR="/usr/share/lsf/patch/backup"
LSF_TOP/patch/backup
PATCH_HISTORY_DIR="/path"
Full path to the patch history directory. This parameter is used when you install a new cluster for the first time, and is ignored for all other cases.
It cannot be the root directory (/). If the directory already exists, it must be writable by lsfadmin.
The location is saved as PATCH_HISTORY_DIR in LSF_TOP/patch.conf. Do not change the directory after installation.
PATCH_BACKUP_DIR="/usr/share/lsf/patch"
LSF_TOP/patch
SILENT_INSTALL="Y" | "N"
Enabling the silent installation (setting this parameter to Y) means you want to do the silent installation and accept the license agreement.
N