[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
lsfinstall
runs
lsfinstall
, the Platform LSF installation and configuration scriptSYNOPSIS
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 install as a non-root user, with limitations, described in If you install as a non-root user.
Required install.config variables
See install.config for an example
install.config
file.Required slave.config variables
If you use
slave.config
for dynamic slave host installation, the following parameters are required:See slave.config for an example
slave.config
file.Variables that require an absolute path
What lsfinstall does
Before installing and configuring LSF,
lsfinstall
checks the installation prerequisites, and outputs the results tolsfprechk.rpt
.lsfinstall
writes any unrecoverable errors to theInstall.err file
and exits. You must correct these errors before continuing to install and configure LSF.During installation,
lsfinstall
logs installation progress in theInstall.log
file, calls other utilities to uncompress, extract and copy LSF files, installs an LSF license, and configures the cluster.After installation, you should run the
hostsetup
script to set up each LSF server host in the cluster. After setting up the LSF hosts, you should start your cluster and test the installation by running some basic LSF commands.Where lsfinstall is located
lsfinstall
is included in the LSF installation script tar filelsf6.0_lsfinstall.tar.Z
and is located in thelsf6.0_lsfinstall
directory created when you uncompress and extract installation script tar file.After LSF installation,
lsfinstall
is located inLSF_TOP/6.0/install/
.Before running lsfinstall
- Plan your installation by choosing:
- LSF installation directory on file server (e.g.,
LSF_TOP="/usr/share/lsf"
)- LSF hosts (master host, server hosts, and client-only hosts; e.g.,
LSF_ADDSERVERS="hosta hostb hostc"
)- Cluster name (39 characters or less with no white spaces; e.g.,
LSF_CLUSTER_NAME="cluster1"
)
Do not use the name of any host, user, or user group as the name of your cluster.
- Primary LSF administrator (owns the LSF configuration files and log files; e.g.,
LSF_ADMINS="lsfadmin"
)- LSF server hosts that are candidates to become the master host for the cluster, if you are installing a new host to be dynamically added to the cluster (e.g.,
LSF_MASTER_LIST="hosta hostb"
)- Prepare your systems for installation:
- Make sure the installation file system on the file server host has enough disk space for all hosts types (approximately 300 MB per host type)
- Make sure the top-level installation directory (LSF_TOP) is accessible with the same path name from all hosts in the LSF cluster (e.g.,
/usr/share/lsf
)- Create UNIX user accounts for LSF administrators (e.g.,
lsfadmin
)- Read the LSF Version 6.0
readme.html
andrelease_notes.html
files (on the LSF CD or in/distrib/6.0/
on theftp.platform.com
FTP site) for detailed steps for downloading LSF distribution tar files- Get the LSF installation script tar file
lsf6.0_lsfinstall.tar.Z
and extract it (e.g.,# zcat lsf6.0_lsfinstall.tar.Z | tar xvf -
)- Read
lsf6.0_lsfinstall/README
for information about the contents oflsf6.0_lsfinstall.tar.Z
- Get the LSF distribution tar files for all host types you need, and put them in the same directory as
lsf6.0_lsfinstall.tar.Z
(e.g., for AIX:lsf6.0_aix4.tar.Z
). Do not extract the distribution tar files.- Get a valid LSF license key and create an LSF license file (
license.dat
) in the same directory as the distribution files andlsf6.0_lsfinstall.tar.Z
If you do not specify a license file with LSF_LICENSE, orlsfinstall
cannot find a license file in the default location,lsfinstall
exits.
Recommended master host system configuration
The following recommendations apply to clusters with the following characteristics:
Number of... Small Medium Large Hosts
<100
100-500
>500
Jobs per day
<1000
1000-10,000
>10,000
Active users
<100
100-1,000
>1,000
Candidate master hosts should have the following minimum configuration:
Small Medium Large Memory
256 MB
1 GB
>2 GB
Swap space
512 MB
1 GB
2 GB
Number of CPUs per host
1
2
2
Example CPU speeds:
450 MHz
1 GHz
>1 GHz
270 MHz
450 MHz
750 MHz
Running lsfinstall
- Log on as root to the LSF installation file server.
- Edit
lsf6.0_lsfinstall/install.config
orlsf6.0_lsfinstall/slave.config
.Uncomment the options you want in the template file, and replace the example values with your own settings.
The sample values in the install.config and slave.config template files are examples only. They are not default installation values.
- Change to
lsf6.0_lsfinstall/
.- Run
lsfinstall
:OR
- Before using your cluster, read the following:
If you install as a non-root user
You can install LSF as a non-root user with some limitations. During installation,
lsfinstall
detects that you are not root. You must choose to configure either a multi-user cluster or a single-user cluster:
- Single-user--Your user account must be primary LSF administrator. You will be able to start LSF daemons, but only your user account can submit jobs to the cluster. Your user account must be able to read the system kernel information, such as
/dev/kmem
.- Multi-user -- By default, only root can start the LSF daemons. Any user can submit jobs to your cluster. To make the cluster available to other users, you must manually change the ownership and setuid bit for
lsadmin
andbadmin
to root, and the file permission mode to-rwsr-xr-x
(4755) so that the user ID bit for the owner issetuid
.Use the following commands to set the correct owner, user ID bit, and file permission mode for a multi-user cluster:
#chown root lsadmin badmin eauth
#chmod 4755 lsadmin badmin eauth
After installing Platform LSF
- Optional. Run
hostsetup
to set up LSF hosts.
- Log on to each LSF server host as root. Start with the LSF master host.
If you are not root, you can continue with host setup, but by default, only root can start the LSF daemons.
- Run
hostsetup
on each LSF server host. For example:#cd /usr/share/lsf/5.0/install
#./hostsetup --top="/usr/share/lsf" --boot="y"
For complete
hostsetup
usage, enterhostsetup -h
.- Log on to the LSF master host as root, and set your LSF environment:
- Run
lsfstartup
to start the cluster.- Test your cluster by running some basic LSF commands (e.g.,
lsid
,lshosts
,bhosts
)After testing your cluster, be sure all LSF users include
LSF_CONFDIR/cshrc.lsf
orLSF_CONFDIR/profile.lsf
in their.cshrc
or.profile
.Example hostsetup command
The following
hostsetup
command sets up a host to use the LSF cluster installed in/usr/share/lsf
. It also configures the LSF daemons to start automatically (--boot="y"
):#hostsetup --top="/usr/share/lsf" --boot="y"
Running host setup remotely (rhostsetup)
Use the
rhostsetup
script to launchhostsetup
on remote hosts.
rhostsetup
uses eitherssh
orrsh
. It is included in the LSF installation script tar filelsf5.0_lsfinstall.tar.Z
and is located in thelsf5.0_lsfinstall
directory created when you uncompress and extract installation script tar file.After LSF installation,
rhostsetup
is located inLSF_TOP/5.0/install/
.Before using
rhostsetup
, you must configure the following parameters at the the top of the script:
- LSF_RSHCMD--the remote shell command (e.g,
rsh
orssh
) accessing the remote host- LSF_HOSTS--list of hosts to run
hostsetup
on- LSF_TOPDIR--sets the
hostsetup --top
option. Specify the full path to the top-level installation directory.rhostsetup
tries to detect this fromlsf.conf
if it is not defined here.- LSF_BOOT--sets the
hostsetup
--boot
option. Default is no (n
).- LSF_QUIET--sets the
hostsetup --quiet
option. Default is no (n
).LSF_RSHCMD="ssh -n" LSF_HOSTS="hostA hostB hostC" LSF_TOPDIR=/usr/local/lsf LSF_BOOT=y LSF_QUIET=nOPTIONS
-f option_file
Name of the file containing LSF 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 fileslave.config
.-s
Install a dynamic slave host.
Specify installation options in the
slave.config
file. The following parameters are required:The following parameters are optional:
- 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 will be the resource name in the form:
[resource
resource_name]
For example:
LSF_LOCAL_RESOURCES=[resourcemap 1*verilog] [resource linux]
If LSF_LOCAL_RESOURCES are already defined in a locallsf.conf
on the slave host,lsfinstall
does not add resources you define in LSF_LOCAL_RESOURCES inslave.config
.
lsfinstall
creates a locallsf.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=6.0
-h
Prints command usage and exits.
SEE ALSO
lsf.conf
(5),install.config
(5),slave.config
(5)[ Top ]
[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]
Date Modified: February 24, 2004
Platform Computing: www.platform.com
Platform Support: support@platform.com
Platform Information Development: doc@platform.com
Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.