Add or edit LSF clusters for RTM to monitor

The following is a list of actions that you must take, in chronological order, to add or edit LSF clusters for RTM to monitor:

Add or edit clusters

About this task

Add or edit any LSF clusters that you want RTM to monitor by either of the following methods:

Procedure

Add or edit clusters by using the RTM Console

You can use the RTM Console to add or edit an LSF cluster for monitoring.
Add clusters to RTM by using a script

You can use a script to add an LSF cluster for monitoring by RTM.

Add or edit clusters by using the RTM Console

About this task

Use the RTM Console to add an LSF® cluster for monitoring by RTM.

Procedure

Click the Console tab.
Under the Grid Management section, click Clusters.
Choose to add or edit a cluster.
- To add an LSF cluster, click Add.
- To edit an existing LSF cluster, click the name of the cluster that you want to edit.
Specify (or update) the required fields that describe your LSF cluster.

At a minimum, you must specify the following fields to add the LSF cluster: Cluster Name, LSF Master LIM Hostname, LSF Master LIM Port, Grid Poller, and Primary LSF Administrator Username.

If you want to monitor multiple clusters and if the RTM host is an LSF server, make sure the clusters use different LIM Ports. However, it is recommended to install RTM on the LSF client host.

For the Grid Poller field, select the appropriate poller for your version of the LSF cluster.

In this release, you can now select Poller for LSF 8 from the list of Grid Poller.
Click Create (or Save) to save the settings for your LSF cluster.

What to do next

If you edited an LSF cluster that was already in the RTM Console, you do not have to do anything else.
If you added an LSF cluster to the RTM Console, you must add the RTM host to the LSF cluster as described in Add the RTM host to the LSF cluster as an LSF client.

Add clusters to RTM by using a script

About this task

Use the grid_add_cluster.php script to add an LSF cluster to RTM.

Procedure

From the command line, go to the plugins/grid subdirectory of the Cacti installation directory.
Use php to run the grid_add_cluster.php script.
php -q grid_add_cluster.php --type=0 --pollerid=lsf_type --cluster_name=cluster_name_text --cluster_env=lsf_envdir_path
where
- lsf_type is an integer that represents the version of LSF running in the cluster:
  
  Note: The Poller ID does not necessarily follow an order. You can add your own pollers in a different order. It is best to use the RTM Console to identify the Poller ID you want to use.
  Poller IDs are maintained during upgrade and only new pollers are inserted into the database.
- Go to the Console tab then click Pollers under Grid Management section. The RTM Pollers page opens displaying the Poller Names and Poller ID. Use the Poller ID value in the list for the grid_add_clusters.php.
- cluster_name_text is the name of the cluster
- lsf_envdir_path is the path to the lsf.conf file for your LSF cluster.
Note: To get the pollerid of LSF run mysql cacti -e "select * from grid_pollers;"

For example, to add an LSF 10.1 cluster named maincluster with lsf.conf in /share/lsf/conf with a pollerid of 9:

php -q grid_add_cluster.php --type=0 --pollerid=9 --cluster_name=maincluster

--cluster_env=/share/lsf/conf

What to do next

If you add clusters to RTM by using a script, you must:

Add the RTM host to the LSF cluster as described in Add the RTM host to the LSF cluster as an LSF client.
Verify that the new cluster is added to RTM from the RTM Console by clicking Clusters and checking that the new cluster is up.

Add the RTM host to the LSF cluster as an LSF client

About this task

For any LSF cluster that RTM monitors, you must add the RTM host to the cluster as an LSF client to give RTM access to LSF cluster data.

Procedure

Log in to the LSF master host.
If the LSF master host cannot resolve the RTM host name to an IP address, edit the /etc/hosts file and add the IP address and host name of your RTM host.

Note: If you can successfully ping the RTM host name from the LSF master host, you can skip this step.
Edit the lsf.cluster.cluster_name file and add the RTM host to the Host section.

If you have configured floating clients in LSF, then no need to add RTM host; the floating clients configuration can assign hosts dynamically that submits a request to LSF.
Reconfigure LIM and restart mbatchd to apply your changes to the cluster.
lsadmin reconfig

badmin mbdrestart
Test that you added the RTM host successfully to the LSF cluster.
1. Log in to the RTM host.
2. From the RTM host, use telnet to log in to the LSF LIM port of your RTM host.
  
  The default LIM port is 7869 for LSF version 8 and above clusters.
  
  For example, for LSF version 8 and above clusters,
  
  telnet<LSF Master IP>7869
  
  If you connect to the IP address of the LSF master host, you added the RTM host successfully.

Results

After you add the RTM host to the LSF cluster, RTM can now monitor the LSF cluster.

What to do next

If you want RTM to be able to monitor all individual hosts in the LSF cluster, add all hosts in the LSF cluster to RTM as described in Add or edit clusters.