Learn more about Platform products at http://www.platform.com

[ 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

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 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:

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:

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:

The following parameters are optional:

lsfinstall creates a local lsf.conf for the slave host, which sets the following parameters:

-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.