Installing IBM Spectrum LSF for an IBM Spectrum Symphony-IBM Spectrum LSF cluster with a Windows primary host

After you have installed and configured IBM Spectrum Symphony, you can install IBM Spectrum LSF Standard Edition for Symphony your Windows primary host, Windows management hosts, and Windows or Linux® compute hosts within your cluster.

1. Obtain the IBM Spectrum LSF Standard Edition for Symphony packages.
   You require the Windows packages on your primary host and management hosts, and on your Windows compute hosts. If your cluster includes Linux compute hosts, you also require the Linux packages.

   Windows package:

   lsf-10.1.0.2_sym7.3.2.0.exe

   Linux 64-bit package (required if your cluster includes Linux 64-bit compute hosts):

   lsf-10.1.0.2_sym7.3.2.0_x86_64.bin

   Linux for POWER LE package (required if your cluster includes Linux on POWER compute hosts):

   lsf-10.1.0.2_sym7.3.2.0_ppc64le.bin

2. Prepare your Windows hosts for the installation. Complete these steps on the primary host, then repeat on each management and compute host:
   1. During installation, you must use the same EGO installation directory as the existing IBM Spectrum Symphony cluster.
   2. During installation, you must use the same connection ports as the existing IBM Spectrum Symphony cluster. Ensure these ports are available on all hosts.
3. Install IBM Spectrum LSF Standard Edition for Symphony on each Windows host. Complete these steps on the primary host, then repeat on each management and compute host:
   1. Use an installation account that belongs to the Local Administrators group or use DOMAIN\egoadmin if it belongs to the Local Administrators group. Log on to each compute host and run the installer.
   2. Select I accept both the IBM and non IBM terms and click Next.
   3. Install according to the following settings:

      ---

      Installation parameters	Description
      SBD and RES control Command-line syntax: SERVICETYPE=EGO	By default, IBM Spectrum LSF res and sbatchd are created as Windows services. Set the value to EGO so that the EGO Service Controller will start IBM Spectrum LSF res and sbatchd, and restart if they fail. This parameter is required. You must install res and sbatchd as EGO services in this cluster.
      Installation directory Command-line syntax: INSTALLDIR=path For example, C:\Program Files\IBM\Platform Symphony.	The cluster installation directory. Specify the IBM Spectrum Symphony installation directory.
      IBM Spectrum LSF ports Command-line syntax: RESPORT=port_number SBDPORT=port_number MBDPORT=port_number For example: RESPORT=6878 SBDPORT=6882 MBDPORT=6881	LSF ports to use for res, sbatchd, and mbatchd. These parameters are optional. The default ports are as follows: For res: 6878 For sbatchd: 6882 For mbatchd: 6881

      ---

   4. On the primary host, entitle the cluster for IBM Spectrum LSF Standard Edition by running:

      egoconfig setentitlement entitlement_file_path

      For example, run:

      egoconfig setentitlement %EGO_CONFDIR%\..\..\lsf\conf\lsf.entitlement

   5. If you installed IBM Spectrum LSF 10.1.0.2 after you installed IBM Spectrum Symphony 7.3.2, complete these steps to ensure IBM Spectrum LSF 10.1.0.2 works with your multiple product environment:
      1. Set your JAVA_HOME environment variable in the Installation_top\perf\lsf\10.1\etc\jobdt.bat file. For example, change the set JAVA_HOME="" line to set JAVA_HOME=%SOAM_HOME%\..\jre\version. Complete this step for your primary host.
      2. For all hosts, set your EGO path (EGO_TOP\version\etc) in your Windows system environment settings: from the Windows Start menu, click Computer, right-click Properties, select Advanced system settings, select the Advanced tab, click the Environment Variables button, locate and select Path under the System variables section:
         • If the EGO path is set to an older (that is, lower) version than EGO 4.0, change the directory to EGO_TOP\4.0\etc. Select OK and save and close all dialogs.
         • If EGO path is not set at all, then add it as EGO_TOP\4.0\etc. Select OK and save and close all dialogs.
4. If you have a shared directory for IBM Spectrum Symphony, configure the management hosts. Complete this step on the primary host, then repeat on each management host.
   1. All EGO management hosts should use IBM Spectrum LSF files in a shared directory, instead of using IBM Spectrum LSF files on the local host. To update the host, run egoconfig mghost lsf with the cluster administrator name and password. For example:

      egoconfig mghost lsf DOMAIN\egoadmin mypasswd

   2. Exit the command console to reset your environment.
5. As the cluster administrator or as a user that belongs to the Local Administrators group, shut down and then start EGO on each host:

   egosh ego shutdown
   egosh ego start

6. If your cluster includes Linux compute hosts, install IBM Spectrum LSF Standard Edition for Symphony on those Linux hosts using the Linux IBM Spectrum LSF Standard Edition for Symphony packages (lsf-10.1.0.2_sym7.3.2.0_x86_64.bin or lsf-10.1.0.2_sym7.3.2.0_ppc64le.bin) from step 1. Complete these steps on each Linux compute host.
   1. Log on to the host as root.
   2. Set the IBM Spectrum LSF ports.
   3. Install IBM Spectrum LSF Standard Edition for Symphony on the Linux host by running:

      ./package_name.bin --prefix Symphony_installation_dir

      Note: If you installed IBM Spectrum Symphony to the default directory (/opt/ibm/spectrumcomputing), you can omit the --prefix option, or use /opt/ibm/spectrumcomputing as the --prefix value.
   4. Set your environment so that your IBM Spectrum LSF settings take effect by logging in as the cluster administrator operating system user, and then running one of the following commands:

      For csh or tcsh: source /opt/ibm/spectrumcomputing/cshrc.platform

      For sh, ksh, or bash: ./opt/ibm/spectrumcomputing/profile.platform

   5. Restart EGO on each host in the cluster by logging onto each host as root, and running:

      egosh ego shutdown
      egosh ego start

7. If your cluster includes Linux compute hosts, configure job submissions from Linux to Windows hosts.
   On all Linux compute hosts, map user accounts so a Linux user can submit a job and have it run on a Windows host. To do this, in the $LSF_ENVDIR/lsf.conf file, set LSF_USER_DOMAIN = DOMAIN (where DOMAIN is the domain of egoadmin).

   For example, if the LSF_USER_DOMAIN = DOMAIN setting is configured, a Linux user called User2 can submit an LSF job. The job will execute for User2 if it runs on a Linux host and it will execute for DOMAIN\User2 if it runs on a Windows host.