7. Installing an Additional Host Type

This section describes the procedure for installing LSF software for any additional host type after the LSF software for the initial host type has been installed. You can install LSF products for as many types of host as you plan to use in your LSF cluster: the procedure is the same in each case.

In this section of the LSF Installation Guide, you will find procedures for:

• acquiring one or more additional LSF distribution files, either via download from Platform's WWW or FTP sites or from hard media
• uncompressing the distribution file and extracting its contents, which creates the distribution directory
• determining whether the initial installation was default or custom
• copying the existing lsf.conf file to the appropriate directory (this step is skipped for default installations)
• running lsfsetup and installing the LSF software for the additional host type

Additional Distribution File(s)

You will need to obtain one LSF distribution file for each additional host type you are installing in the cluster. For example, if you are adding the HP-UX, IRIX, and SOLARIS host types to an existing LSF cluster, you must obtain three LSF distribution files, one for each of these host types.

For instructions on obtaining distribution files and for creating the LSF distribution directory, see `LSF Distribution Files' on page 8.

Checking the Initial Installation

Because LSF has two software installation procedures--default and custom--there are two corresponding paths that may be taken when adding an additional host type. Which path you take depends on which path was followed when the initial LSF host type(s) was(were) installed.

If LSF was originally installed using the default installation procedure, you can now add a host type to the installation using either the default or custom procedures. If you still accept the assumptions made by the default installation, it is recommended that you use it again.

If LSF was originally installed using the custom installation procedure, you must use the custom installation procedure to add a host type.

If you aren't sure how the original installation was done, you can check LSF's configuration file, lsf.conf to find out.

1. Open your existing lsf.conf file with any text editing or viewing program.

   This placement of this file depends upon decisions made during the initial installation, but it is placed in the LSF_SERVERDIR directory by default in all cases but one--if you used the default installation procedure, it is stored in the LSF_CONFDIR directory.

2. Search the file, using a search function or simply by glancing through it, for the following variable:

   LSF_DEFAULT_INSTALL=

If this variable is set to "y", then the initial LSF installation was a default installation. If this variable is set to "n", then the initial LSF installation was a custom installation.

Adding a Host Type

Once you have created the distribution directory, and know how the initial installation was done, you can proceed to install the software for the additional host type. Two procedures are given here: one is for adding a host type using the default install (when the initial installation was done using the default installation procedure), and one is for adding a host type using the custom install.

Default Procedure

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

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

4. Choose option 1, `Default Install'.
5. 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.

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

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

8. Allow the installation to proceed.

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

If you are not installing LSF on any other additional host types, you can continue with `Adding an Additional Host to an Existing Cluster' on page 79 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.

Custom Procedure

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

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

4. Choose option 2, `Custom Install'.
5. Choose option 2, `Install Another Host Type'.
6. Confirm the location of the LSF configuration file (lsf.conf)--created when you installed the initial host type.
7. 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.

8. 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 any other additional host types, you can continue with `Adding an Additional Host to an Existing Cluster' on page 79 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.

Next Steps

Once you have installed the software for the additional host types, you can proceed to set up individual hosts in the cluster. Procedures for this are given in `Adding an Additional Host to an Existing Cluster' on page 79.