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
-
Log in to the RTM host as
root.
- 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.
-
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*
-
If the RTM host is not
registered with RHN, create a RHEL yum repository using the DVD media. Run the following commands as
root:
- Mount a RHEL ISO:
# mkdir -p /mnt/rhel-iso
# mount -o loop rhel.dvd.iso /mnt/rhel-iso
- 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
- 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
-
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
-
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.
- 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:
- (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
- (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
-
Install
RTM and the
RTM Fix
Pack:
- 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
- Run the rtm_patch.sh script to install the RTM Fix Pack.
For example:
cd /root/rtm-fix-pack
./rtm_patch.sh
-
Allow the RTM host to accept
syslog messages that are forwarded from other hosts:
-
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
-
Save the current iptables rules to the
/etc/sysconfig/iptables file:
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.
- 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
- Optional: Install
the RTM
client for disk and system monitoring:
cd /root/rtm-fix-pack
rpm -i x86_64/rtm-client-10.2.0*