Enabling LSF Cluster Control on an IBM Spectrum LSF cluster

To grant IBM Spectrum LSF RTM access to an LSF cluster, you must enable LSF cluster control on the cluster. This allows you to run LSF commands on that cluster.

Before you begin

Ensure that the LSF cluster and the RTM host meet the following requirements:

  • The LSF management host is a Linux®, AIX®, HPUX, or Solaris host with sh or bash installed.
  • The RTM host is an LSF server or is added to the LSF cluster as an LSF client.
  • The RTM host has rsh or ssh access to the LSF management host.
  • The LSF management host uses at least one of the following methods of authentication and meets the corresponding requirements:
    • ssh password authentication: You are asked for the password of the LSF management host root user each time you start a cluster control action.
    • ssh private key authentication
      • You created an ssh public key pair by running sshkeygen -t rsa on the RTM host as root, then added the public key to the authorized_keys file of the LSF management host root user.
      • The LSF management host has password-less authentication (ssh private key authorization or rsh) available with all other hosts in the LSF cluster.
    • rsh password-less authentication
      • The .rhosts file in the LSF management host specifies the root user of the RTM host.
      • The LSF management host and the RTM host both have the incoming TCP port 514 open.
      • The LSF management host has password-less authentication (ssh private key authorization or rsh) available with all other hosts in the LSF cluster.

About this task

Perform the following steps to control LSF clusters from the RTM Console.

Procedure

  1. Click the Console tab.
  2. Enable LSF Cluster Control for each applicable user in the RTM host.
    1. Go to Console > Configuration > Users.
    2. Select the name of the user for which you want to enable cluster control.
    3. In the User Management window, click Permissions.
    4. In the Plugin Permissions section, toggle on LSF Cluster Control.
    5. Click Save.
  3. Go to Console > Clusters > Clusters.
  4. For each cluster that you want to be able to control through RTM:
    1. Click the name of the cluster that you want to control.
    2. In the Cluster Settings page click theControl tab.
    3. In the User Authentication settings section, specify the settings for the Primary LSF administrator account on the LSF management host.
      Important: To ensure that RTM has access to the appropriate LSF commands, you must consider the following points:
      • The specified Primary LSF administrator user name is the name of the LSF administrator account in the LSF cluster for which you are enabling cluster control. You must specify the user name of the Primary LSF Administrator for the LSF workstation. You must set the cluster user name before you run the cluster by advocate. Otherwise, errors indicating invalid credentials or no user name specified are displayed.

        This account is used by the host, queue, and job level controls through eauth in the LSF management host to start the control actions. After these settings are saved, this user name is created as a disabled Unix local account in the RTM host.

      • If you are connecting to the LSF management host through ssh private key authentication, you must provide the private key path that points to the private key file. The public key of this file is added to the authorized_keys file of the LSF management host root user.
      • The LSF server top directory is the top-level LSF installation directory (LSF_TOP).
    4. Click Save.