Installing IBM Spectrum LSF RTM on RHEL or CentOS

Perform this task to install IBM Spectrum LSF RTM for Red Hat Enterprise Linux® (RHEL) or CentOS.

Preparing to install RTM

Perform this task to prepare to install RTM.

Before you begin

  • The RTM operating system requirements outlines the supported versions of RHEL and CentOS. For installation details, see your operating system installation documentation.
  • If you have an existing version of RTM 10.2 on RHEL 8 installed, and are upgrading to RTM Fix Pack 15:
  • 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. 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

What to do next

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

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

Procedure

  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.

Installing the RTM binaries

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.

Procedure

  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*