2. Default Installation

Introduction

This section of the LSF Installation Guide covers the default procedure for initial installations of LSF products on UNIX platforms (for Windows NT, see`LSF on Windows NT' on page 47). This is the quickest and easiest way to install LSF products, because a number of installation settings are assigned default values which you must accept. If you cannot accept all of these default values, you must use LSF's custom installation procedure, which allows you to assign alternate values.

What the Default Installation Assumes

When you use LSF's default installation procedure, the parameters you must accept are:

• all binaries and configuration files will be installed on a single file server, under a single directory which will be shared by all hosts in the cluster--this directory must be accessible with the same path name on all machines
• all paths in the lsf.conf file are machine independent, and lsf.conf is placed in LSF_CONFDIR rather than LSF_SERVERDIR
• LSF daemons are configured to log to /tmp rather than the system log
• service ports are defined automatically in lsf.conf instead of in
  /etc/services or using NIS
• The DEMO license file is automatically installed into LSF_CONFDIR (installation directory for a permanent license file is still up to you)

What You Will Do In This Section

This chapter describes the procedure for loading LSF distribution files and installing the LSF software, which are:

• installing LSF software for one host type on the file server host, using LSF's installation program, lsfsetup
• installing the LSF software license key (optional for now, but must be done before you can use LSF products)
• optionally, installing LSF software for additional host types. This is necessary if you plan to create an LSF cluster which includes host machines which do not all use the same operating system.
• mounting directories and creating symbolic links

Default Installation Procedures

After you have successfully installed the LSF files for the initial host type, you can follow the instructions in `Installing LSF Software for Additional Host Types' on page 17 to install the files for LSF on one or more additional platforms. If all hosts in your LSF cluster are running under the same operating system, you should skip to `LSF Host Setup' on page 19.

If you do not install your license key during this procedure, you will have to do it later using the procedure found in `License Installation' on page 33.

All LSF files, both host type dependent and host type independent, will physically reside on the file server host at your site. For this installation procedure, the LSF directories are assumed to be NFS-mounted on the other LSF machines in the cluster, and accessible under the same directory name.

If you are installing on an AFS file system, follow the instructions in `Installation on AFS' on page 97. If you are installing on DCE/DFS, follow the instructions in `Installation on DCE/DFS' on page 105.

Installing LSF Software for the Initial Host Type

This procedure describes installing the LSF files on a file server, for the host type you have chosen to install first. These installation procedures will work correctly even if the file server is not the same host type as the LSF software you are installing. Installation takes from 10 to 20 minutes for the first host in an LSF cluster, and approximately 3 minutes for each additional host in the cluster.

1. Load the distribution file for the version of LSF you are installing first (from the distribution medium or downloaded from Platform's WWW or FTP sites), and uncompress it.

   This will create the distribution directory. See `LSF Distribution Files' on page 8 for details if you have yet to take this step.

2. Log in to the file server host as root.
3. Change directory to the distribution directory.
4. Run the ./lsfsetup program.

   LSF's install program starts up, and its main menu is displayed.

   The lsfsetup program prompts you for all information needed to install LSF. Most prompts include a default value, displayed in square brackets. If you press return, the default value is used.

5. Choose option 1, `Default Install'.

   All installable LSF products are displayed in a numbered list.

6. Specify one or more of the products to install.

   If you select more than one product, make sure you separate them with commas.

7. Specify the directory into which you want the LSF files installed. This is the LSF_TOP directory (default /usr/local/lsf).

   Remember that the installation directory you choose must be accessible from all machines in the cluster using the same path name.

8. Specify whether or not to use external user authentication (eauth). By default, LSF installs and configures eauth. You may also choose to write and configure your own site-specific eauth after the installation is complete. External authentication is the only type of security that works on Windows NT, so if your cluster is going to include Windows NT machines, you should use eauth.

   If you choose not to use eauth, LSF uses privileged ports for authentication, and installs some utilities with the setuid bit set, and root as the owner of the file.

9. Choose and enter a name for the LSF cluster, and the login name of the LSF administrator's account.
10. Indicate whether or not you want to install your LSF license key.

    If you do not want to install your license key now for any reason, or you have not yet obtained it from your LSF vendor, you can install it later by running the lsfsetup program and choosing option 4, License Management.

    Detailed instructions and information on installing a license key this way are contained in `License Installation' on page 33.

11. If you want to install your license key now, indicate where you have placed it.

    The lsfsetup program determines whether the license is a DEMO or a permanent license.

    If it is a DEMO license, it is copied into the LSF_CONFDIR. If it is a permanent license, a menu of choices is displayed, from which you can select the appropriate action. For more information, see `License Installation' on page 33.

You are informed when the installation for this initial host type is finished.

Note

When you run lsfsetup, you will be prompted for additional information if you are installing LSF Analyzer or LSF Parallel.

- If you are installing LSF Analyzer, specify the machine that you want to use as the LSF database server. It should have at least 200MB free disk space.

- If you are installing LSF Analyzer, specify the LSF database directory on the LSF database server. The default is /usr/local/lsf_db.

- If you are installing LSF Parallel, LSF creates two files in the LSF_BINDIR directory, mpicc and mpif77. These are wrapper scripts that compile an LSF Parallel MPI program in the cluster. Specify the C and Fortran compilers that you want these scripts to use. The defaults are cc and f77.

If you are not installing LSF on additional host types, you can skip to `LSF Host Setup' on page 19 for instructions on how to complete your LSF installation and setup.

If you are installing LSF on one or more additional host types, follow the instructions in `Installing LSF Software for Additional Host Types' on page 17.

Installing LSF Software for Additional Host Types

If you plan to use LSF products in a heterogeneous environment, you must install the LSF files which are specific to each operating system in the cluster. The process is similar to that used for the installation of LSF for the initial host type, but must now be repeated for each operating system.

These steps install the LSF host type dependent files for the type of host corresponding to the distribution file you are using to install them.

1. Obtain the appropriate version of the LSF software from the distribution medium or download it from Platform's WWW or FTP sites. On the file server, uncompress the distribution file and extract the installation files.

   A distribution directory is created. If you are unsure about any part of this procedure, see `LSF Distribution Files' on page 8 for details.

2. Log in to the file server host as root.
3. Change directory to the distribution directory.
4. Run the ./lsfsetup program.

   LSF's install utility starts up, and its main menu is displayed.

5. Choose option 1, `Default Install'.
6. Specify the directory into which the first LSF host type was installed.

   The setup utility will detect that the initial host type has been installed, and proceed to install the host type specific files for the host type you are installing now.

The setup utility will also look for an existing license key, the license.dat file.

7. If the lsfsetup program detects an existing license key, simply allow the installation to proceed. If you did not install a license key when you installed the initial (or any subsequent) additional host type, you will be prompted to install it now.

   If you do not want to install your license key now for any reason, or you have not yet obtained it from your LSF vendor, you can install it later by running the lsfsetup program and choosing option 4, License Management.

   Detailed instructions and information on installing a license key this way are contained in `License Installation' on page 33.

8. If you want to install your license key now, indicate where you have placed it.

   The lsfsetup program determines whether the license is a DEMO or a permanent license.

   If it is a DEMO license, it is copied into the LSF_CONFDIR. If it is a permanent license, a menu of choices is displayed, from which you can select the appropriate action. For more information, see `License Installation' on page 33.

9. Allow the installation to proceed.

   You are informed when the installation for this host type is finished.

   If you are not installing LSF on additional host types, you can continue with `LSF Host Setup' on page 19 for instructions on how to complete your LSF installation and setup.

   If you need to install LSF for one or more additional host types, repeat the steps in this section for each one, until you have installed LSF software for all the host types you plan to include in your cluster. When you have finished, you can continue with the following section, `LSF Host Setup'.

LSF Host Setup

At this point, you have finished the physical installation of LSF files on the file server host. Before you can start the LSF daemons and test the cluster configuration, you must perform a few simple procedures on each host machine you want to include in your LSF cluster.

• LSF_TOP/mnt must be mounted on each LSF host from the file server host
• the `Host Setup' procedure in the lsfsetup program must be run on each host in the cluster

Mounting the LSF_TOP/mnt Directory

When you use LSF's default installation procedure, it is assumed that all hosts in the cluster will share LSF files from a single file server, accessible with the same path name. All LSF files are installed on the file server under the LSF_TOP directory (which you specified when you installed the LSF software).

1. If you aren't already, log in to the LSF host as root.
2. Create the LSF_TOP directory (by default, it is /usr/local/lsf).
3. Mount the LSF_TOP/mnt directory from the file server as LSF_TOP/mnt (assuming the default value, this is /usr/local/lsf/mnt).

   You must not mount this directory with the nosuid flag; some LSF programs require setuid permission. See the manual page for the mount command for more details (the specifics vary from platform to platform).

4. Create the symbolic links appropriate for the host type. For example, on an HP-UX host, you might do the following:

   ln -s /usr/local/lsf/mnt/hppa/bin /usr/local/lsf/bin
ln -s /usr/local/lsf/mnt/hppa/lib /usr/local/lsf/lib
ln -s /usr/local/lsf/mnt/hppa/etc /usr/local/lsf/etc

5. Repeat these steps for each LSF host in the cluster.

   If you are unclear as to LSF's directory structure, see `LSF Directory Structure' on page 3 for detailed information.

Executing the Host Setup Procedure

After mounting LSF_TOP/mnt, you must run the lsfsetup program and execute its `Host Setup' procedures on each LSF host. These procedures will:

• create symbolic links to host type specific directories, allowing all hosts to access the host type specific LSF binaries using the same path
• modify startup files on the LSF server hosts so that the LSF daemons start automatically when the machines boots up
• modify the lsf.cluster.cluster file to include all the new hosts

1. If you aren't already, log in to the LSF host as root.
2. Run the lsfsetup program.

   It has been installed in the mnt/<host_type>/etc subdirectory of LSF_TOP, the directory you specified for the LSF installation.

3. Select option 3, `Host Setup'.
4. You are prompted to confirm the location of the LSF configuration file (lsf.conf) you want to use to set up the cluster.

   The following symbolic links are created:

   • from LSF_TOP/bin to LSF_TOP/mnt/<host_type_directory>/bin
   • from LSF_TOP/etc to LSF_TOP/mnt/<host_type_directory>/etc
   • from LSF_TOP/lib to LSF_TOP/mnt/<host_type_directory>/lib
5. You are asked to specify if this host will be a LSF server host or a LSF client host. By default, each host is a server host. If you are installing a server host, proceed to the next step in this procedure.

   If you choose to make the host a client host, you will be prompted to specify a server host (running LIM) that will accept jobs from the client host and submit them to the cluster. You only need to specify one server host, but you may choose to specify additional ones for backup purposes. The client host will attempt to contact the server hosts in the order that they are listed.

6. If you are installing a server host, the lsfsetup program attempts to modify the rc file so that the LSF daemons start automatically when the host is booted or rebooted.

   The host setup procedure is complete.

   You should repeat this procedure for each host in the cluster. When you have finished setting up all the hosts in your cluster, you can move on to the following section, `Next Steps', for further instructions.

Next Steps

If you have finished installing LSF software for all desired host types, setting up individual LSF hosts, and acquiring and installing a license key, you are ready to start the LSF daemons (except on LSF client hosts) and test the installation. Instructions for this are given in `After Installation' on page 63.