3. Custom Installation

Introduction

This chapter describes the procedure for installing the LSF system software using the LSF installation and setup program, lsfsetup. When you install LSF following the steps in this section, you have complete control over all aspects of the installation, and will be asked where to place configuration files, set up service ports, and other questions about the LSF installation.

If you could not accept one or more of the preconfigured settings in the default LSF setup described in the previous chapter, or if you are experienced with and generally knowledgeable about LSF and operating system software, then you should be able to use LSF's custom installation procedure.

What You Will Do In This Section

This chapter describes the procedures for installing the LSF software, which are:

• installing LSF software for one host type on the file server host, using LSF's installation program, lsfsetup
• reviewing, modifying, and accepting the LSF configuration settings
• installing the LSF software license key (optional for now, but must be done before you can use LSF products), or obtaining the information necessary to get an LSF software license key
• setting up LSF host models and types, and modifying the LSF configuration file as necessary
• 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, creating symbolic links, and setting up LSF service port numbers

Custom 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 28 to install the files for LSF on one or more additional platforms--but only if you plan to create an LSF cluster including host machines which do not all use the same operating system. If all hosts in your LSF cluster are running under the same operating system, you should skip to `LSF Host Setup' on page 29.

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.

After the software is installed, some setup must be done for each host in the LSF cluster. These steps are given in `LSF Host Setup' on page 29.

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 allows you to install all LSF files--host type independent and host type dependent--for the host type you have chosen to install first, on the file server host you have selected. The LSF distribution file you obtained, and from which you extracted and uncompressed the LSF installation files, determines which host type dependent files are installed.

These installation procedures will work correctly even if the file server host 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. Log in to the file server host as root.
2. Load the distribution file for the version of LSF you are installing first (from the distribution medium or download it 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.

3. Change directory to the distribution directory.
4. Run the ./lsfsetup program.

   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 2, `Custom Install'.

   All LSF installable 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 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.

8. Specify LSF_MACHDEP, the directory into which you want the LSF host type dependent files installed.

   This is the directory that contains all host type dependent LSF files, which include programs, daemons, and libraries compiled for a specific type of host machine. These files can be shared by all hosts of the same type in the cluster.

   More information on the LSF_MACHDEP directory can be found in `LSF Directory Structure' on page 3.

9. Specify LSF_INDEP, the directory into which you want the LSF host type independent files installed.

   This is the directory that contains all host type independent LSF files, which include manual pages, configuration files, and working directories. These files can be shared by all hosts in the cluster.More information on the LSF_INDEP directory can be found in `LSF Directory Structure' on page 3.

10. Enter a name for the LSF cluster.

    The name may be up to 39 characters in length, and should not be the same as the name of any host in the cluster.

11. Enter the login name of the LSF administrator.

    The installed LSF files will be owned by this account.

    A menu containing options for the LSF configuration settings is displayed.

12. Review and modify the LSF configuration settings as needed.

    Choose option 1, `List Current Settings', to review the LSF configuration settings.

Choose option 2, `Change Current Settings', to change any or all of the LSF configuration settings.

Choose option 3, `Install the Software Now', to begin installing LSF files onto the server.

Choose option 4, `Use Default Settings', to reset all LSF configuration settings to their default values, which are based on the values you entered for LSF_INDEP, LSF_MACHDEP, and the cluster name and administrator's account name.

13. Choose option 3, `Install the Software Now', when you are satisfied that all of the LSF configuration variables are set the way you want them to be.

    This copies all the LSF files into their final locations and creates a default set of configuration files. The lsfsetup program is installed into the LSF_SERVERDIR directory. You can use lsfsetup later to maintain LSF.

This part of the installation procedure may take a few minutes, but you will be notified when it has been successfully completed.

14. Press the return key when prompted.

    A menu offering you license key options is displayed.

15. Select the option you want.

    If you do not want to install your license key now for any reason, or are planning to use a DEMO license and have not yet obtained it, select the [q]uit option. Instructions for obtaining a DEMO license are in `Licensing Information' on page 11. You can install it after you have finished installing LSF by following the instructions in `License Installation' on page 33.

If you require a permanent license and do not yet have it, select option 1, `Get Information for a Permanent License'.

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

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

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, continue with the procedure in `LSF Host Setup' on page 29. If you are installing LSF on one or more additional host types, see the following section, `Installing LSF Software for Additional Host Types'.

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.

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

   A distribution directory is created. 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 2, `Custom Install'.
6. Choose option 2, `Install Another Host Type'.
7. Confirm the location of the LSF configuration file (lsf.conf)--created when you installed the initial host type.
8. Specify the LSF_MACHDEP directory (specified when you installed the previous host type(s), default value /usr/local/lsf).

   The other installation settings are automatically updated.

9. Choose option 3, `Install the Software Now'.

   The lsfsetup program installs all the products necessary for the additional host type.

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 29 for instructions on how to complete your LSF installation and setup. If you need to install LSF for an additional host type, repeat the steps in this section once for each additional host type.

LSF Host Setup

At this point, you have finished the physical installation of LSF files on the machine you have chosen to be your 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 custom installation procedure, you have full control over where you install the LSF files and how the LSF hosts in the cluster access them. To make the installation procedure as easy as possible, you should install all LSF files under the LSF_TOP directory (which you specified when you installed the LSF software), and it is this directory which you should mount on each LSF host.

1. If you aren't already, log in to the LSF host as root.
2. Create the LSF_TOP directory (the default value 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 machine. These procedures will:

• create a symbolic link to the LSF configuration file lsf.conf, simplifying setup and maintenance by allowing all hosts to access the same configuration file
• 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
• check to see where the LSF service ports have been registered, and if they have been registered correctly

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 LSF_MACHDEP/etc directory.

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.
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, modifying the LSF configuration file, 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 and information are given in `After Installation' on page 63.