Setting up remote LSF pollers

This section describes the requirements and steps for installing remote IBM Spectrum LSF pollers for IBM Spectrum LSF RTM.

Before you begin

Note the support OSes for your remote IBM Spectrum LSF poller host:

For x86_64 servers:
- RHEL 7.1+ and 8.0, with specific certification for RHEL 7.1 to 7.3 and 8.0. Refer to RHEL compatibility policies if you want to use any other version: https://access.redhat.com/solutions/5154
- CentOS 7.0+ with specific certification for CentOS 7.2 to 7.4
- SLES 15.0, 15.1
- Ubuntu 18.04
For Linux for IBM Power Systems servers:
- RHEL 7.4 and 8.0 on Power 8 Little Endian certified
- RHEL 7.5 on Power 9 Little Endian certified

Note: When you set up remote pollers, you also have to set up the DB_Pollerids on the RTM server to cover the pollerID's for the management host (LSF pollers only). For example, you can set DB_PollerIDs 1,2,3,4,5,6,7. You also have to set the DB_Pollerids in the lsfpollerd.conf file.

Attention: Make sure that the unixODBC and mysql-connector-odbc are installed and configured. It is required to configure the odbc.ini and odbcinst.ini files when you define a unixODBC connection to the database so that RTM can access ODBC data sources.

Remember: The location of the RTM_TOP directory must be the same on the RTM server and remote poller servers.

Procedure

Install the remote poller OS if applicable. Ensure that the MySQL client is installed.
For RHEL:
```
 # yum install mysql
```
Download the following RPM from rtm-poller-10.2.0-<OS_type><version>.tar.gz:
For example,
```
- rtm-poller-<version>.<arch>.rpm
```
Tip: When using IBM Spectrum LSF RTM with remote LSF pollers, note the compatibility requirements:
- Remote LSF pollers for IBM Spectrum LSF Fix Pack 13 are compatible with these LSF versions:
  - IBM Spectrum LSF Fix Pack 12, if the LSF cluster is explicitly configured with the LSF_GPU_RESOURCE_IGNORE parameter, with a value of Y or N in the lsf.conf configuration file on the cluster.
  - IBM Spectrum LSF Fix Pack 13.
- Remote LSF pollers for IBM Spectrum LSF Fix Pack 7 are compatible with these LSF versions:
  - IBM Spectrum LSF Fix Pack 7 to 11.
  - IBM Spectrum LSF Fix Pack 12, if the LSF cluster is explicitly configured with the LSF_STRICT_CHECKING and LSF_AUTH_QUERY_COMMANDS parameters in the lsf.conf configuration file on the cluster.
  - IBM Spectrum LSF Fix Pack 13, if the LSF cluster is explicitly configured with the LSF_STRICT_CHECKING, LSF_AUTH_QUERY_COMMANDS, and LSF_GPU_RESOURCE_IGNORE parameters in the lsf.conf configuration file on the cluster.
Copy the RPMs to the remote poller host and then install.
```
# rpm -Uvh rtm-poller*.rpm
```
Add the new remote pollers through the RTM Console. Ensure that you are adding only the correct LSF versions for your needs. Note the Poller ID for the next step.

Note:
If the location of RTM_TOP on the remote poller server is not the same as on the RTM server, select “Remote Poller”.
Modify the RTM_TOP/rtm/etc/lsfpollerd.conf and RTM_TOP/rtm/lsf<version>/bin/grid.conf configuration files on the remote poller.
1. Change DB_Host to point to the RTM database IP.
  
  Note: If you are using a remote database, configure the IP to point to that host. For more information, see Setting up a remote database host.
2. Add a new entry for DB_Pollerids. It contains a comma-separated list of all remote poller ids (no spaces).
3. Change the Log_File path to something locally accessible (such as /var/log/lsfpollerd).
4. Set Daemon_User to the user who will have read/write permissions to the log directory
  
  The default user is apache on RHEL or wwwrun on SuSE, or www-data on Ubuntu, for example.
Add the lsfpollerd daemon as a system service:
```
# systemctl enable lsfpollerd
```

Grant the remote poller host access to the RTM database:

# mysql -u root mysql -e "GRANT ALL ON cacti.* TO cacti@<ip of remote poller host> 
IDENTIFIED BY 'admin';"
# mysql -u root mysql -e "GRANT SELECT ON mysql.time_zone_name TO cacti@
 <IP of remote poller host> IDENTIFIED BY 'admin';"

Test the connection between the remote RTM poller and the RTM server:
```
mysql -ucacti -padmin -hrtmwebserver -A cacti
```
Modify the firewalls for the RTM database and the LSF Server to allow for connections from the remote poller host.
Modify the RTM_TOP/rtm/etc/lsfpollerd.conf configuration file on the main RTM server.

Note: The DB_Pollerids must be set to a comma-separated list of pollerids 'local' to the RTM server.
Restart the lsfpollerd service on the RTM server:
```
# systemctl restart lsfpollerd
```
Copy the folder RTM_TOP/rtm/etc/clusterID from the RTM host to RTM_TOP/rtm/etc/clusterID the remote LSF poller host.

Note: If you are using the advance LSF conf option, you do not have to perform this step but you must ensure that the path toLSF_ENVDIR is accessible by the remote LSF poller host.
Start the remote poller service:
```
# systemctl start lsfpollerd
```
From the RTM Console, change the poller ID for the clusters you want to poll remotely.