10. Adding a Product

This chapter describes the procedure for installing additional LSF products after an initial LSF installation.

This section of the LSF installation documentation contains procedures for:

• locating or obtaining the appropriate distribution file(s) for LSF
• uncompressing the distribution file and extracting the installation files from it
• updating your license key
• installing the new product using LSF's installation program, lsfsetup

LSF Distribution Files

You will need to obtain one LSF distribution file for each host type in the cluster to which you are adding an LSF product. For example, if you are adding a product to an LSF cluster that includes host machines running HP-UX, IRIX, and SOLARIS operating systems, you must obtain three LSF distribution files, one for each of these.

See`LSF Distribution Files' on page 8 for information on obtaining LSF distribution files and creating the LSF distribution directory.

Updating the License Key

When you add an LSF product to an existing installation, you will have to update your license key as well, so that the license server will support the new product. In this case, you may be provided with an INCREMENT license key or a new PRODUCT line.

To install an LSF INCREMENT license key or a new FEATURE line:

1. Edit your license.dat file using a text editor like vi or emacs (UNIX) or Notepad (Windows NT).
2. Add the INCREMENT line immediately after the PRODUCT line in the license.dat file.
3. Save the file.
4. Run the following program:

   lmreread -c <LSF_LICENSE_FILE>

The lmreread program is found in your LSF_SERVERDIR. Both variables are defined in your lsf.conf file. See `LSF Variables' on page 5 for more detailed information.

5. Run the following program:

   lsadmin reconfig

   The license file is reread and the changes accepted by LSF.

Adding a Product

This section describes the procedure for adding another product from the LSF suite to an existing installation of LSF. LSF products are described in the preface of this book.

The procedure replaces the installed binaries and the running daemons, and automatically updates your configuration files to support the new LSF product configuration, if necessary.

CAUTION!

All interactive jobs running under LSF will be killed. Make sure that the system is completely idle before adding a product.

You should do a complete backup of your LSF binaries and configuration files before adding a product to LSF.

1. Shut down all LSF daemons and make sure there are no currently running jobs.
2. Copy the LSF configuration file to the distribution directory.

   This means you should copy the /etc/lsf.conf file.

3. Log in to an LSF server host as root.
4. Change directory to the distribution directory you have created.
5. Run the ./lsfsetup command.
6. Choose option 6, `Install Additional Product(s)'.

   A product selection menu is displayed.

7. Select the product(s) you are going to add.

   Remember that if you choose more than one, you must separate them with commas.

You are prompted to indicate where the configuration file (lsf.conf) is located.

8. Specify the configuration file's location.
9. The procedure now follows the standard lsfsetup installation procedure as described in `Default Installation Procedures' on page 14 or `Custom Installation Procedures' on page 24. You should review the installation settings and modify them, if necessary, before installing the additional software.

   Perform the procedure once for each host type. The lsfsetup command automatically upgrades the necessary portions of LSF for each host type.

10. Restart the LSF daemons on all hosts.