9. Upgrading LSF

This chapter describes the procedure for upgrading LSF from an older version to the current one. The upgrade procedure replaces the installed binaries and daemons, and automatically updates your configuration files to support LSF 3.2, if necessary.

Obtaining the Distribution File(s)

You will need to obtain one LSF distribution file for each host type in the cluster you are upgrading. For example, if you are upgrading 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.

Upgrading the License Key

When you upgrade LSF to 3.2, you will have to upgrade your license key as well, so that the license server will support the new version. Because the license key names contained in the license file have changed in LSF 3.2, old (i.e. version 3.1) license.dat files are incompatible.

If you received a DEMO license key, you can proceed directly with the installation. To get a permanent license from your LSF vendor, see the Release Notes or `Getting License Key Information' on page 34. You can install LSF with a DEMO license key and change to a permanent license later with no interruption in service.

Instructions for upgrading your license key are contained in `Updating an LSF License' on page 41.

The Upgrade Procedure

This section describes the procedure for installing LSF when you already have a previous version of LSF installed on your system.

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

CAUTION!

All interactive jobs running under LSF will be killed. Make sure that the system is completely idle before upgrading LSF--including the graphical applications!

You should do a complete backup of your LSF binaries and configuration files before upgrading LSF.

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

   This means you should copy the /etc/lsf.conf file created by the previous installation.

3. Log in to an LSF server host as root.
4. Change directory to the distribution directory you have created for the LSF upgrade.
5. Run the ./lsfsetup command.
6. Choose option 5, `Upgrade From a Previous Version'.

   A product selection menu is displayed.

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

   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) for the existing version of LSF is located.

8. Specify the configuration file describing the old installation.
9. The upgrade 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 software.

   Perform the upgrade 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.