[ Platform Documentation ]

[ Title ]

[ Contents ]

[ Previous ]

[ Next ]

[ Index ]

---

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 install as a non-root user, with limitations, described in If you install as a non-root user.

Required install.config variables

• LSF_TOP="/path"
• LSF_ADMINS="user_name [user_name...]"
• LSF_CLUSTER_NAME="cluster_name"

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:

• LSF_TOP="/path"
• LSF_TARDIR="/path"
• LSF_SERVER_HOSTS="host_name [host_name ...]"

See slave.config for an example slave.config file.

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 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 file lsf6.0_lsfinstall.tar.Z and is located in the lsf6.0_lsfinstall directory created when you uncompress and extract installation script tar file.

After LSF installation, lsfinstall is located in LSF_TOP/6.0/install/.

Before running lsfinstall

1. 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")
2. 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 and release_notes.html files (on the LSF CD or in /distrib/6.0/ on the ftp.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 of lsf6.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 and lsf6.0_lsfinstall.tar.Z

   ---

   If you do not specify a license file with LSF_LICENSE, or lsfinstall cannot find a license file in the default location, lsfinstall exits.

   ---

   • Make sure the installation file system containing LSF_TOP is writable by the user account that is running lsfinstall

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:
x86 systems running Linux	450 MHz	1 GHz	>1 GHz
Sun SPARC systems running Solaris	270 MHz	450 MHz	750 MHz

Running lsfinstall

1. Log on as root to the LSF installation file server.
2. Edit lsf6.0_lsfinstall/install.config or lsf6.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.

   ---

3. Change to lsf6.0_lsfinstall/.
4. Run lsfinstall:
   • ./lsfinstall -f install.config

   OR

   • ./lsfinstall -s -f slave.config
5. Before using your cluster, read the following:
   • lsf6.0_lsfinstall/lsf_getting_started.html to find out how to set up your LSF hosts, start LSF and test your new cluster.
   • lsf6.0_lsfinstall/lsf_quick_admin.html to learn more about your new LSF cluster.

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 and badmin to root, and the file permission mode to -rwsr-xr-x (4755) so that the user ID bit for the owner is setuid.

  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

1. Optional. Run hostsetup to set up LSF hosts.
   1. 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.

   2. 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, enter hostsetup -h.

2. Log on to the LSF master host as root, and set your LSF environment:
   • For csh or tcsh:

     % source LSF_TOP/conf/cshrc.lsf
     

   • For sh, ksh, or bash:

     $ . LSF_TOP/conf/profile.lsf
     

3. Run lsfstartup to start the cluster.
4. 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 or LSF_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 launch hostsetup on remote hosts.

rhostsetup uses either ssh or rsh. It is included in the LSF installation script tar file lsf5.0_lsfinstall.tar.Z and is located in the lsf5.0_lsfinstall directory created when you uncompress and extract installation script tar file.

After LSF installation, rhostsetup is located in LSF_TOP/5.0/install/.

rhostsetup parameters

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 or ssh) 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 from lsf.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).

Example rshostsetup configuration

LSF_RSHCMD="ssh -n"
LSF_HOSTS="hostA hostB hostC"
LSF_TOPDIR=/usr/local/lsf
LSF_BOOT=y
LSF_QUIET=n

OPTIONS

-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 file slave.config.

-s

Install a dynamic slave host.

Specify installation options in the slave.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 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 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=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.