lsfinstall

runs lsfinstall, the Platform LSF installation and configuration script

Synopsis

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

Description

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

To install a fully operational LSF cluster that all users can access, you should install as root.

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

Required install.config variables

  • LSF_TOP="/path"

  • LSF_ADMINS="user_name [user_name...]"

  • LSF_CLUSTER_NAME="cluster_name"

Required slave.config variables

If you use slave.config for dynamic slave host installation, 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_LICENSE="/path/license_file"

  • LSF_TOP="/path"

  • LSF_TARDIR="/path"

What lsfinstall does

Before installing and configuring LSF, lsfinstall checks the installation prerequisites, and outputs the results to lsfprechk.rpt. lsfinstall writes any unrecoverable errors to the Install.err file and exits. You must correct these errors before continuing to install and configure LSF.

During installation, lsfinstall logs installation progress in the Install.log file, calls other utilities to uncompress, extract and copy product files, installs a license, and configures the cluster.

After installation, you should run hostsetup to set up each server host in the cluster. After setting up the server hosts, you should start your cluster and test the installation by running some basic commands.

Where lsfinstall is located

lsfinstall is included in the LSF installation script tar file lsf8.0_lsfinstall.tar.Z and is located in the lsf8.0_lsfinstall directory created when you uncompress and extract installation script tar file.

After installation, lsfinstall is located in LSF_TOP/8.0/install/.

Options

-f option_file

Name of the file containing the installation options. The file can be any name you choose. The name of the default template file for normal installation is install.config. To install slave hosts for dynamic host configuration, use the template file slave.config.

-s

Install a dynamic slave host.

Specify installation options in the slave.config file.

Required parameters:
  • LSF_SERVER_HOSTS="host_name [host_name ...]"

  • LSF_TOP="/path"

  • LSF_TARDIR="/path"

Optional parameters:

LSF_LIM_PORT=port_number

If the master host does not use the default LSF_LIM_PORT, you must specify the same LSF_LIM_PORT defined in lsf.conf on the master host.

LSF_LOCAL_RESOURCES="resource ..."

Defines the local resources for a dynamic host.

  • For numeric resources, defined name-value pairs:

    "[resourcemap value*resource_name]"
  • For Boolean resources, the value is the resource name in the form:

    "[resource resource_name]"
For example:
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 on the slave host, lsfinstall does not add resources you define in LSF_LOCAL_RESOURCES in slave.config.

lsfinstall creates a local lsf.conf for the slave 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=8.0

-h

Prints command usage and exits.

See also

lsf.conf, install.config, slave.config