lsf.conf

The lsf.conf file controls the operation of LSF.

About lsf.conf

lsf.conf is created during installation and records all the settings chosen when LSF was installed. The lsf.conf file dictates the location of the specific configuration files and operation of individual servers and applications.

The lsf.conf file is used by LSF and applications built on top of it. For example, information in lsf.conf is used by LSF daemons and commands to locate other configuration files, executables, and network services. lsf.conf is updated, if necessary, when you upgrade to a new version.

This file can also be expanded to include application-specific parameters.

Parameters in this file can also be set as environment variables, except for the parameters related to job packs.

Corresponding parameters in ego.conf

When EGO is enabled in LSF Version 7, you can configure some LSF parameters in lsf.conf that have corresponding EGO parameter names in EGO_CONFDIR/ego.conf (LSF_CONFDIR/lsf.conf is a separate file from EGO_CONFDIR/ego.conf). If both the LSF and the EGO parameters are set in their respective files, the definition in ego.conf is used. You must continue to set LSF parameters only in lsf.conf.

When EGO is enabled in the LSF cluster (LSF_ENABLE_EGO=Y), you also can set the following EGO parameters related to LIM, PIM, and ELIM in either lsf.conf or ego.conf:
  • EGO_DISABLE_UNRESOLVABLE_HOST (dynamically added hosts only)

  • EGO_ENABLE_AUTO_DAEMON_SHUTDOWN

  • EGO_DAEMONS_CPUS

  • EGO_DEFINE_NCPUS

  • EGO_SLAVE_CTRL_REMOTE_HOST

  • EGO_WORKDIR

  • EGO_PIM_SWAP_REPORT

  • EGO_ESLIM_TIMEOUT

If EGO is not enabled, you do not need to set these parameters.

See Administering IBM Platform LSF for more information about configuring LSF for EGO.

Change lsf.conf configuration

Depending on the parameters you change in lsf.conf, you may need to run the following commands:
  • lsadmin reconfig to reconfigure LIM

  • badmin mbdrestart to restart mbatchd

  • badmin hrestart to restart sbatchd

If you have installed LSF in a mixed cluster, you must make sure that lsf.conf parameters set on UNIX and Linux match any corresponding parameters in the local lsf.conf files on your Windows hosts.

Location

The default location of lsf.conf is in $LSF_TOP/conf. This default location can be overridden when necessary by either the environment variable LSF_ENVDIR.

Format

Each entry in lsf.conf has one of the following forms:
NAME=VALUE
NAME=
NAME="STRING1 STRING2 ..."

The equal sign = must follow each NAME even if no value follows and there should be no space beside the equal sign.

A value that contains multiple strings separated by spaces must be enclosed in quotation marks.

Lines starting with a pound sign (#) are comments and are ignored. Do not use #if as this is reserved syntax for time-based configuration.