Installing IBM Spectrum LSF RTM on RHEL or CentOS

This section refers to RHEL 7.2 or higher as the operating system on which IBM Spectrum LSF RTM is being installed. For CentOS, the same steps can be used.

Preparing to install IBM Spectrum LSF RTM on RHEL

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

Before you begin

Important:
  • If you want to enable the SNMP monitor feature in RTM, you must install the PHP-SNMP and NET-SNMP-UTILS packages. For correct installation on RHEL 7.x, 8.x, or (starting in Fix Pack 14) 9.x, download the packages from the Red Hat official site, using your Red Hat Network (RHN) account.
  • RTM should not be installed or run on NFS. It will cause stability issues and could lead to data corruption.
  • If there is no direct internet access on the RTM host, a local software repository can be used. Consult with your organization’s IT infrastructure team to set up a valid local software repository.

Procedure

  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

What to do next

Attention: RTM is supported only on the version of ODBC that is provided by the OS provider. Therefore, before installing RTM, perform the following, if applicable:
  1. If you do not have the have the supported unixODBC version installed, uninstall the version that is installed:
    For RHEL7.x
    rpm -e --allmatches --nodeps unixODBC mysql-connector-odbc
    For RHEL 8.x, or starting in Fix Pack 14, also 9.x
    rpm -e --allmatches --nodeps unixODBC mariadb-connector-odbc
  2. Install the correct version of unixODBC that is required for RTM:
    For RHEL 7.x
    • For x86_64:
      yum install unixODBC.x86_64 mysql-connector-odbc
    • For IBM Power LE systems:
      yum install unixODBC.ppc64le mysql-connector-odbc.ppc64le
    For RHEL 8.x, or starting in Fix Pack 14, also 9.x
    • For x86_64:
      yum install unixODBC.x86_64 mariadb-connector-odbc
    • For IBM Power LE systems:
      yum install unixODBC.ppc64le mariadb-connector-odbc.ppc64le

Obtaining the installation files (Required)

Download the necessary RTM installation files to a location on the RTM host.

Procedure

  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.

Installing the IBM Spectrum LSF RTM binaries on RHEL

Perform this task to install the IBM Spectrum LSF RTM packages on the host.

Procedure

  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