Adding AIX server hosts to your IBM Spectrum LSF Suite for Enterprise cluster

Add AIX LSF server hosts to your IBM Spectrum LSF Suite for Enterprise cluster.

About this task

The following steps describe how to add AIX-bit hosts to your IBM Spectrum LSF Suite for Enterprise cluster.

For example, the existing cluster that you want to add the AIX server to has GUI hosts, a database host, and LSF management hosts. These hosts are either IBM Power or 64-bit x86 hosts that run a supported version of Linux, or a combination of both. The LSF server hosts are also a combination of IBM Power and x86 hosts that run Linux.

Note: In order for AIX hosts to join the cluster, you must configure the LSF_HOST_ADDR_RANGE=*.*.*.* parameter in the lsf.cluster file and the LSF_DYNAMIC_HOST_WAIT_TIME=60 parameter in the lsf.conf file.

1. Download the LSF standard product package for AIX and the LSF installation package from IBM Passport Advantage.
   Download the following files:

   • lsf10.1_aix-64.tar.Z
   • lsf10.1_no_jre_lsfinstall.tar.Z

   Note: The installation package is the standard LSF installer with no JRE. These steps use the JRE provided by the OS vendor. If a JRE is not installed, use yum or apt-get to install a JRE.

   For details about LSF product download, see IBM Spectrum LSF product packages in the IBM Spectrum LSF release notes.

2. Copy the downloaded packages to the AIX hosts that you want to add to the cluster.
   Tip: It might be convenient to use a shared directory to host the LSF packages.
3. Extract the LSF installer package.

   tar zxvf lsf10.1_aix-64.tar.Z

4. Change to the installation directory.

   cd lsf10.1_lsfinstall

5. Log in to your LSF management host to get some information that the AIX installation needs.
   1. Copy the LSF entitlement file (/opt/ibm/lsfsuite/lsf/conf/lsf.entitlement) to the AIX hosts.
   2. Determine who the LSF administrators are.
      Run the following command:

      grep -h 'Administrators=' /opt/ibm/lsfsuite/lsf/conf/lsf.cluster.*

      The LSF administrator users (for example, lsfadmin) must exist on all AIX hosts.
   3. Determine the list of LSF servers.
      Run the following command:

      grep -h 'LSF_SERVER_HOSTS' /opt/ibm/lsfsuite/lsf/conf/lsf.conf

6. Edit the slave.config installation template to set the parameters for your cluster.
   Set values the following parameters:

   LSF_TOP

   Full path to the top level LSF installation directory.

   Important: You must use the same path for every server host you install.

   The LSF_TOP file path cannot be the root directory (/).

   LSF_ADMINS

   List of LSF administrators. Use the list of administrators that you got in step 5. The default LSF administrator user is lsfadmin.

   The first user account name in the list is the primary LSF administrator. It cannot be the root user account.

   All the LSF administrator accounts must exist on all hosts in the cluster before you install LSF. Secondary LSF administrators are optional.

   Important: If the lsfadmin user does not exist on your AIX hosts, you must create it. For example,

   /usr/sbin/groupadd -g 491 lsfadmin
   /usr/sbin/useradd -u 495 -d "/usr/local/lsf" -g lsfadmin -M -r lsfadmin
   

   Where /usr/local/lsf is the LSF_TOP directory.

   LSF_TARDIR

   Full path to the directory that contains the LSF distribution .tar files that you downloaded. This path points to the directory where you downloaded the lsf10.1_aix-64.tar.Z file.

   LSF_ENTITLEMENT_FILE

   Full path to the LSF entitlement file. Use the location of the entitlement file that you got in step 5.

   LSF uses the entitlement to determine which features are enabled or disabled based on the edition of the product. The entitlement file for LSF is lsf_std_entitlement.dat.

   LSF_SERVER_HOSTS

   List of hosts that can provide host and load information to client hosts. Use the list of server hosts that you got in step 5.

   Define this parameter to ensure that commands run successfully when no LIM is running on the local host, or when the local LIM is started.

   LSF_LIM_PORT

   TCP service port for the server host.

   Use the same port number as the value of the LSF_LIM_PORT parameter in the lsf.conf file on the management host. The default value is 7869. You can use this default to set up your AIX hosts.

   ENABLE_EGO

   Enables the enterprise grid orchestrator (EGO) functions in the LSF cluster.

   Specify ENABLE_EGO="Y". Enabling EGO causes the lsfinstall command to uncomment the LSF_EGO_ENVDIR parameter and sets the LSF_ENABLE_EGO parameter to "Y" in the lsf.conf file.

   Set the value to "Y" to take advantage of the LSF features that depend on EGO. For more information, see EGO in the LSF cluster and Manage LSF on EGO.

   For example,

   LSF_TOP="/usr/local/lsf"
   LSF_ADMINS="lsfadmin"
   LSF_TARDIR="/usr/local/lsf_distrib"
   LSF_ENTITLEMENT_FILE="/usr/share/lsf_distrib/lsf.entitlement"
   LSF_SERVER_HOSTS="hostB hostC hostD hostE lsfmaster"
   LSF_LIM_PORT="7869"
   ENABLE_EGO="Y"
   

7. As root, run the lsfinstall command with the slave.config file.

   lsfinstall -f -s slave.config

8. Start the LSF Daemons on the server hosts.

   For the cs or tcsh shell, run the following command: source LSF_TOP/conf/cshrc.lsf

   For the sh, ksh or bash shell, run the following command: source LSF_TOP/conf/profile.lsf

   If running a new daemon, use the following commands:

   lsadmin limstartup
   lsadmin resstartup
   badmin hstartup

9. Test your cluster by running some basic LSF commands.