Installing IBM Spectrum LSF RTM on RHEL or CentOS

Perform this task to prepare to install IBM Spectrum LSF RTM.

1. On the RTM host, run the RHEL 7.2 or higher installation program.

   For more information, see your Red Hat Enterprise installation documentation.

2. Ensure that the following packages are selected:
   • mariadb-server
   • httpd
   • unixODBC
   • mysql-connector-odbc (for RHEL 7.x)
   • mariadb-connector-odbc (for RHEL 8.x, or starting in Fix Pack 14, also 9.x)
   • php-mbstring
   • php-process
   Example for RHEL 8.1:

   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 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.

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. (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 to a location on the RTM host.

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

   mkdir -p /mnt/rtm

3. Download the following RTM packages:

   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 example, rtm10.2.0-build601132-rhel8-x64.tar.gz for RTM 10.2 Fix Pack 13 on RHEL 8)

   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 (for example, rtm10.2.0-build601132-rhel8-ppc64le.tar.gz for RTM 10.2 Fix Pack 13 on RHEL 8)

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 IBM Spectrum LSF RTM packages on the host.

1. Log in to the RTM host as root.
2. Make sure that you downloaded all the installation packages as described in Obtaining the installation files (Required) 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, it is strongly recommended that you 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:

   service mysqld stop
   #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. Set to the preferred version 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. Set to the preferred version 8.1 instead:

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

6. Go to the RTM installation package directory:

   cd /mnt/rtm

7. Navigate to the /mnt/rtm directory and decompress the rtm-server-10.2.0-rhel(ver)-x64.tar.gz tar file.

   For RHEL and CentOS on x64

   tar -zxvf rtm-server-10.2.0-rhel(ver)-x64.tar.gz

   For RHEL on IBM Power LE systems

   tar -zxvf rtm-server-10.2.0-rhel(ver)-ppc64le.tar.gz

8. Edit the install.config file (in /mnt/rtm) and configure all the required parameters.
   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.

   Make sure that the user running apache is a member of the DAEMON_GROUP that you specified in the install.config file.

9. For RHEL 8.x, copy S01RtmDB from Fix Pack 13 or later, to replace original files under RTM_TOP/rtm.rc.d/ installation source directory:

   mkdir /mnt/rtm12fp13
   cd /mnt/rtm12fp13
   tar -xzf <path_to_fix_pack_13_package>/rtm10.2.0-build601132-rhel8-x64.tar.gz
   cp rtm.rc.d/S01RtmDB /mnt/rtm/rtm.rc.d/

10. Run the rtm_install.sh script to install RTM.
    For example:

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

    Note: For silent installation, run:

    sh rtm_install.sh -f install.config -s 

11. 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.
12. Optional: For RHEL 8.x, if want to upgrade PHP to 7.4, apply IBM Spectrum LSF RTM 10.2.0 Fix Pack 13 or later, , 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