Adding ARM 64-bit server hosts to your IBM Spectrum LSF Suite for Workgroups cluster

Add ARM 64-bit LSF server hosts to your IBM Spectrum LSF Suite for Workgroups cluster.

Before you begin

See Installation requirements for IBM Spectrum LSF Suite for Workgroups for general prerequisites for installation. The following steps are already complete, described in IBM Spectrum LSF Suite for Workgroups installation overview:

Make sure that the Java Runtime Environment (JRE) is installed on the ARM host. The LSF installation was tested on JRE V1.7 and V1.8.
Download the .bin package files for IBM Spectrum LSF Suite for Workgroups.
Run the .bin files to create the deployer host. This host contains the Ansible playbooks and repositories for installation.
Check host prerequisites and decide host roles.
Install your cluster according to one of the scenarios that are described in IBM Spectrum LSF Suite for Workgroups installation scenarios.

Restriction: ARM 64-bit Linux hosts can serve only as execution hosts. These hosts cannot serve as IBM Spectrum LSF Suite for Workgroups LSF management hosts, GUI hosts, or database host. You must use the native LSF installation script (lsfinstall) to install the ARM hosts.

About this task

The following steps describe how to add ARM 64-bit hosts to your IBM Spectrum LSF Suite for Workgroups cluster.

LSF Suites mixed-architecture installation - IBM Power and ARM64

For example, the existing cluster that you want to add the ARM 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 ARM 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.

Procedure

Download the LSF standard product package for ARM64 and the LSF installation package from IBM Passport Advantage.
Download the following files:
- lsf10.1_lnx312-lib217-armv8.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.
Copy the downloaded packages to the ARM hosts that you want to add to the cluster.

Tip: It might be convenient to use a shared directory to host the LSF packages.

Extract the LSF installer package.

tar zxvf lsf10.1_lnx312-lib217-armv8.tar.Z

Change to the installation directory.
```
cd lsf10.1_lsfinstall
```
Log in to your LSF management host to get some information that the ARM installation needs.
1. Copy the LSF entitlement file (/opt/ibm/lsfsuite/lsf/conf/lsf.entitlement) to the ARM 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 ARM hosts.
3. Determine the list of LSF servers.
  Run the following command:
```
grep -h 'LSF_SERVER_HOSTS' /opt/ibm/lsfsuite/lsf/conf/lsf.conf
```
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 ARM 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_lnx312-lib217-armv8.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 ARM 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"
```
As root, run the lsfinstall command with the slave.config file.
```
lsfinstall -s -f slave.config
```
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
```
Test your cluster by running some basic LSF commands.

What to do next

When you install IBM Spectrum LSF Suite for Workgroups for the first time, HTTPS is enabled by default. Additional configuration steps are required for high availability. For the detailed steps, see Enabling HTTPS when high availability is enabled. To configure the Energy Data Collector, see Configuring Energy Data Collector for IBM Spectrum LSF Suite for Workgroups.