lsfinstall
The LSF installation and configuration script.
Synopsis
lsfinstall -f install.configDescription
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
- LSF_TOP="/path"
- LSF_ADMINS="user_name [user_name ...]"
- LSF_CLUSTER_NAME="cluster_name"
Required server.config variables
- 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.
# 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. - For numeric resources, use name-value pairs:
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.