Installing IBM Spectrum LSF RTM on RHEL or CentOS

Perform this task to prepare to install RTM.

1. Install mandatory packages:
   Example for RHEL 8.x:

   yum install bash chkconfig chrony coreutils gd httpd initscripts libnsl mariadb mariadb-connector-odbc mariadb-server mod_ssl perl php php-common php-gd php-json php-ldap php-mbstring php-mysqlnd php-process php-xml python3-pexpect python3-pyOpenSSL python36 rrdtool rsyslog rsyslog-mysql shadow-utils unixODBC

   Example for RHEL 9.x:

   yum install bash chkconfig chrony coreutils gd httpd initscripts libnsl mariadb mariadb-connector-odbc mariadb-server mod_ssl perl php php-common php-gd php-json php-ldap php-mbstring php-mysqlnd php-process php-xml python3-pexpect rrdtool rsyslog rsyslog-mysql shadow-utils unixODBC

   Note: Ensure that mariadb-server has been installed properly. This is optional if you are using RTM with a remote database.

   After you select the packages, the program proceeds with the installation.

2. The yum install command in the previous step installs the MariaDB database. To use the database, enable and secure it as follows:

   systemctl enable mariadb
   systemctl start mariadb
   mysql_secure_installation
   systemctl stop mariadb

3. Ensure that the firewall is disabled and port 80 and 443 are open. As a best practice, disable Security Enhanced Linux (SELinux). If you do not disable SELinux or allow port 80 and 443 during installation, then you must ensure they are configured appropriately, according to OS specifications. For more details, refer to Red Hat documentation for Disabling SELinux.
4. (For RHEL 9.x only) Apply pcre2-10.40-2.el9 or later from the RHN update channel:

   dnf upgrade pcre2

Download the necessary RTM installation files, and the latest RTM Fix Pack, to a location on the RTM host.

1. Log in to the RTM host as root.
2. Create a directory to store the RTM and RTM Fix Pack installation packages.
   For example:

   mkdir -p /root/rtm
   mkdir -p /root/rtm-fix-pack

3. Download the following RTM packages, which includes the initial release of IBM Spectrum LSF RTM 10.2.0 from IBM Passport Advantage, and then the latest IBM Spectrum LSF RTM 10.2.0 Fix Pack from IBM Fix Central:

   For RHEL and CentOS on x64

   From IBM Passport Advantage:

   • rtm-poller-10.2.0-rhel(version)-x64.tar.gz
   • rtm-server-10.2.0-rhel(version)-x64.tar.gz

   From IBM Fix Central:

   • rtm10.2.0-buildversion-rhelversion-x64.tar.gz.

   For RHEL on IBM Power systems

   From IBM Passport Advantage:

   • rtm-poller-10.2.0-rhel(version)-ppc64le.tar.gz
   • rtm-server-10.2.0-rhel(version)-ppc64le.tar.gz

   From IBM Fix Central:

   • rtm10.2.0-buildversion-rhelversion-ppc64le.tar.gz.

4. Download the following third-party files:
   Important: You can only use the RTM license monitoring feature if you have the following packages downloaded.

   • If you are using Reprise License Manager (RLM) version rlmutil v11.0 BL2, and if you want RTM to monitor license services, then either copy RLM_TOP/rlmstat to RTM_TOP/rlm/bin/rlmstat, or copy RLM_TOP/rlmutil to RTM_TOP/rlm/bin/rlmstat.
     Note: If you are using a Windows host for RLM, download these kits to the Windows host as well:

     wget http://www.reprisesoftware.com/license_admin_kits/x64_l1.admin.tar.gz
     wget http://www.reprisesoftware.com/license_admin_kits/p64_l1.admin.tar.gz

   • If you are using FlexLM, then copy FLEXLM_TOP/lmstat to RTM_TOP/flexlm/bin/lmstat.

Perform this task to install the RTM packages (initial release and the latest Fix Pack) on the host. The steps are applicable to RHEL and CentOS, and also tested on Rocky 8.10 and AlmaLinux 9.4.

1. Log in to the RTM host as root.
2. Make sure that you downloaded all the installation packages (for RTM and the latest Fix Pack) as described in Obtaining the installation files before you run the installation script.
3. Remove any existing databases log files on the RTM host if the database is on the same host.
   Note: This step is necessary because RTM tunes the database configuration to optimize performance based on the specifications of your host. This includes the recreation of the InnoDB log file.

   Important: If you have any data on the existing databases, perform a back up of the database (for example, by using mysqldump) before proceeding. A restore is not necessary unless the data becomes corrupt.

   Run the following commands to remove the InnoDB log file from your host:

   For MariaDB

   systemctl stop mariadb
   #if you are using MariaDB, then use: service mariadb stop
   #find the InnoDB log file in my.cnf (your data directory) and go to it
   #remove the ib_log*
   rm -f /var/lib/mysql/ib_logfile*

   For MySQL

   systemctl stop mysqld
   #if you are using MariaDB, then use: service mariadb stop
   #find the InnoDB log file in my.cnf (your data directory) and go to it
   #remove the ib_log*
   rm -f /var/lib/mysql/ib_logfile*

4. If the RTM host is not registered with RHN, create a RHEL yum repository using the DVD media. Run the following commands as root:
   1. Mount a RHEL ISO:

      # mkdir -p /mnt/rhel-iso
      # mount -o loop rhel.dvd.iso /mnt/rhel-iso

   2. Create a repository for /etc/yum.repos.d/rhel.repo with the following content:

      [RHEL]
      name=RHEL
      baseurl=file:///mnt/rhel-iso
      enabled=1

      For RHEL 8.x, or starting in Fix Pack 14, also 9.x:

      [rhel-$releasever-baseos]
      name=RHEL $releasever BaseOS
      baseurl=file:///mnt/rhel-iso/BaseOS
      enabled=1
      [rhel-$releasever-appstream]
      name=RHEL $releasever AppStream
      baseurl=file:///mnt/rhel-iso/AppStream
      enabled=1

5. Verify and set the preferred enabled PHP module:

   For RHEL 8.x

   Ensure the current enabled PHP module is not 7.4. Run php -v to see your PHP version. If required, set to the version to 7.2 instead:

   dnf module -y reset php
   dnf module -y enable php:7.2
   dnf downgrade -y php

   For RHEL 9.x

   Ensure the current enabled PHP module is not 8.0. Run php -v to see your PHP version. If required, set the version to 8.1 instead:

   dnf module -y reset php
   dnf module -y enable php:8.1
   dnf upgrade -y php

6. As root, go to the RTM installation package directory (for example, /root/rtm), and extract the RTM poller and server packages:

   For RHEL and CentOS on x64

   For example:

   cd /root/rtm/
   tar zxvf rtm-poller-10.2.0-(version)-x64.tar.gz
   tar zxvf rtm-server-10.2.0-(version)-x64.tar.gz

   For RHEL on IBM Power LE systems

   For example:

   cd /root/rtm/
   tar zxvf rtm-poller-10.2.0-(version)-ppc64le.tar.gz
   tar zxvf rtm-server-10.2.0-(version)-ppc64le.tar.gz

7. Edit the install.config file (for example, in /root/rtm) and configure all the required parameters and note:
   • To configure any optional parameter, uncomment the line and specify the appropriate value. Blank spaces are not permitted in LSF_CLUSTERS or LIC_SERVICES names.
     Note: Once you download the RTM, configure all the required parameters in the install.config file. The RTM installer will copy, set up, and install the operating system and all dependent packages. It will also complete the post installation tasks, including configuring servers. For advanced settings, configure the parameters in the Advanced section of the install.config file.
   • If you previously secured your database (in step 2), then set the DB_PASSWORD and DB_USERNAME values.
   • Make sure that the user running Apache is a member of the DAEMON_GROUP that you specified in the install.config file.
8. You previously downloaded the latest RTM Fix Pack from IBM Fix Central (according to Obtaining the installation files). Fix Packs contain updates to support newer OS versions; add the Fix Pack files to the RTM installer so that newer OS version are supported. For example:

   cd /root/rtm-fix-pack
   tar zxf rtm10.2.0-build*
   cp lib/rtm_functions.sh /root/rtm/lib/rtm_functions.sh

   Additionally, for RHEL:

   1. (For RHEL 8.x and 9.x only) Copy the S01RtmDB directory from your RTM Fix Pack and replace the replace original files in the RTM_TOP/rtm.rc.d/ installation directory:

      cp rtm.rc.d/S01RtmDB rtm10.2.0-build*/rtm.rc.d/S01RtmDB

   2. (For RHEL 9.x only) From the /root/rtmd directory, update the installer to check the InnoDB data log file by running the following commands:

      cd /root/rtm
      sed -i -e 's^check_innodb_files$^#check_innodb_files^g' rtm_install.sh

9. Install RTM and the RTM Fix Pack:
   1. Run the rtm_install.sh script to install RTM.
      For example:

      cd /root/rtm
      sh rtm_install.sh -f install.config

      Tip: For silent installation, run the installer with the -s option:

      sh rtm_install.sh -f install.config -s 

   2. Run the rtm_patch.sh script to install the RTM Fix Pack.
      For example:

      cd /root/rtm-fix-pack
      ./rtm_patch.sh

10. Allow the RTM host to accept syslog messages that are forwarded from other hosts:
    1. Run the iptables command to create an iptables rule for accepting syslog messages from other hosts:

       iptables -A INPUT -i eth0 -p udp -m state --state NEW --dport 514 -j ACCEPT

    2. Save the current iptables rules to the /etc/sysconfig/iptables file:

       service iptables save

       Important: By default, the /etc/sysconfig/iptables file does not exist on a newly installed host. Run the iptables save command to save the current firewall policy to the /etc/sysconfig/iptables file. The /etc/sysconfig/iptables file can be saved only when the iptables service is running.
11. Optional: For RHEL 8.x, if want to upgrade PHP to 7.4, apply RTM Fix Pack 13 or later, and then run the following commands:

    dnf module -y reset php
    dnf module -y enable php:7.4
    dnf install -y php
    sed -i 's/lin_7.2.so/lin_7.4.so/g' /etc/php.d/05-aa_ioncube.ini
    systemctl restart httpd php-fpm

12. Optional: Install the RTM client for disk and system monitoring:

    cd /root/rtm-fix-pack
    rpm -i x86_64/rtm-client-10.2.0*