lsfinstall

The LSF installation and configuration script.

Synopsis

lsfinstall -f install.config
lsfinstall -s -f server.config
lsfinstall -h

Description

The lsfinstall script runs the LSF installation scripts and configuration utilities to install a new LSF cluster or upgrade LSF from a previous release.

To install a fully operational LSF cluster that all users can access, run the lsfinstall script as root.

You can run the lsfinstall script as a non-root user, with limitations.

Required install.config variables

The following parameters are required for installation with the install.config configuration file:
  • LSF_TOP="/path"
  • LSF_ADMINS="user_name [user_name ...]"
  • LSF_CLUSTER_NAME="cluster_name"

Required server.config variables

If you use the server.config file to install dynamic server hosts, the following parameters are required:
  • LSF_TOP="/path"
  • LSF_TARDIR="/path"
  • LSF_SERVER_HOSTS="host_name [host_name ...]"

Variables that require an absolute path

  • LSF_TOP="/path"
  • LSF_TARDIR="/path"
  • LSF_ENTITLEMENT_FILE="/path"

What lsfinstall does

Before it installs and configures LSF, the lsfinstall script checks the installation prerequisites, and outputs the results to the lsfprechk.rpt file. The lsfinstall script writes any unrecoverable errors to the Install.err file and exits. You must correct these errors before you continue to install and configure LSF.

During installation, the lsfinstall script logs installation progress in the Install.log file and calls other utilities to decompress, extract, and copy product files. After it copies files to the installation location, the script configures the cluster.

(Optional) run hostsetup

After installation, you can run the hostsetup command to set up LSF hosts and automatic LSF startup. After you set up the server hosts, start your cluster and test the installation by running some basic commands.

Run the hostsetup command on each LSF server host.

For complete usage of the hostsetup command, run the hostsetup -h command to see the command usage and options help.

Note: Running the hostsetup command is only required if you plan to run IBM POE jobs by using IBM® Parallel Environment (IBM PE).
Important: Before you run the hostsetup command, make sure that the hosts you want to set up are in the lsf.cluster.cluster_name file.
For example, run the following commands to use the LSF cluster that is installed in the /usr/share/lsf directory and configure LSF daemons to start automatically at system startup time:
# cd /usr/share/lsf/10.1.0/install
# ./hostsetup --top="/usr/share/lsf" --boot="y"

Where lsfinstall is located

lsfinstall is included in the LSF installation script TAR file lsf10.1.0_lsfinstall.tar.Z and is located in the lsf10.1.0_lsfinstall directory that is created when you decompress and extract installation script TAR file.

After you install LSF, the lsfinstall script is located in the LSF_TOP/10.1.0/install/ directory.

Options

-f option_file
Name of the file that specifies the installation options. The file can be any name that you choose. The name of the default template file for normal installation is install.config. To install server hosts for dynamic host configuration, use the template file server.config.
-s
Install a dynamic server host.

Specify installation options in the server.config file.

The following parameters are required:
  • LSF_SERVER_HOSTS="host_name [host_name ...]"
  • LSF_TOP="/path"
  • LSF_TARDIR="/path"
The following parameters are optional:
LSF_LIM_PORT=port_number
If the management host does not use the default LSF_LIM_PORT, you must specify the same LSF_LIM_PORT defined in lsf.conf on the management host.
LSF_LOCAL_RESOURCES="resource ..."
Defines the local resources for a dynamic host.
  • For numeric resources, use name-value pairs:
    "[resourcemap value*resource_name]"
    
  • For Boolean resources, define resource names:
    "[resource resource_name]"
    
The following example defines a numeric resource for verilog licenses and Boolean resource linux:
LSF_LOCAL_RESOURCES="[hostname hostA] [server 1] [resourcemap 1*verilog] [resource linux]"
Tip: If LSF_LOCAL_RESOURCES are already defined in a local lsf.conf file on the server host, the lsfinstall script does not add resources that you defined in LSF_LOCAL_RESOURCES in the server.config file.
The lsfinstall script creates a local lsf.conf file for the server host, which sets the following parameters:
  • LSF_CONFDIR="/path"
  • LSF_GET_CONF=lim
  • LSF_LIM_PORT=port_number
  • LSF_LOCAL_RESOURCES="resource ..."
  • LSF_SERVER_HOSTS="host_name [host_name ...]"
  • LSF_VERSION=10.1.0
-h
Prints command usage and exits.

See also

lsf.conf, install.config, server.config