This guide has been written by a fellow IBMer, John Kyriazis (Kudos to him for his detailed document), in order to help us deploy Tivoli Monitoring Agents to several dozens of Linux VMs within a customer’s vInfrastructure. 

Before you begin to install any agent in RedHat Environment in a corporate environment you must first make sure that Subscription is active, else, you need to register the VM to the subscription manager.

After completing the above step, use your ssh client to connect to the Linux system (Putty is used in this guide).

Log in and proceed with the following steps:

Step 1: Disable Selinux

Before anything else, we need to disable selinux by typing the below:

Nano /etc/selinux/config
SELINUXTYPE=targeted

Save the edited file and type the below command, in order to grant the right permissions to continue:

setenforce 0 

Verify by typing: getenforce and grant the Permissive output.

Step 2: Create a directory

Create a directory called itm inside tmp by typing:

cd /tmp followed by mkdir itm

Step 3: Install cifs-utils

Upload agent to VM 

Due to the fact that the binaries are large in size, we created a shared folder located in //shared system/Tivoli

To mount the shared folder, first verify that cifs is installed; if not, run the following command:

yum install cifs-utils

Step 4: Mount the shared folder

Once you have installed cifs, mount  the shared folder with the following command:

[root@yourlinuxsystemhere tmp]# mount.cifs //shared system's IP address/Tivoli /tmp/itm/ -o username=youruserhere
Password for youruserhere@//shared system's IP address/Tivoli:  ********

To verify that everything is working, go to mounted directory: 

Cd /tmp/itm

Then, type ls in order to list the folders located in the share: 

[root@yourlinuxsystemhere itm]# ls

ITM_V6.3.0.7_AGT_MP_ML

cd to ITM_V6.3.0.7_AGT_MP_ML

Step 5:  Install the Agent

[root@yourlinuxsystemhere ITM_V6.3.0.7_AGT_MP_ML]# ls
[root@yourlinuxsystemhere ITM_V6.3.0.7_AGT_MP_ML]# ./install.sh

If you receive the following error:

-bash: ./install.sh: /bin/ksh: bad interpreter: No such file or directory

Then, install ksh: 

[root@yourlinuxsystemhere ITM_V6.3.0.7_AGT_MP_ML]# yum install ksh

After you install ksh run ./install again 

[root@yourlinuxsystemhere ITM_V6.3.0.7_AGT_MP_ML]# ./install.sh

The below menu sequence will be followed by your interaction:

INSTALL

KCI1373W: SELinux (Secure Enhanced Linux) is set to enforced or permissive mode. Enforced mode is not supported by IBM Tivoli Monitoring. Permissive mode  may require additional system configuration steps. Perform the following steps to set the mode to disabled or refer to IBM Tivoli Monitoring documentation for more details: 

1. Set SELinux disabled mode.
2. Reboot the system.
3. Execute the 'prelink -a' command before restarting the ITM installation.

Enter the name of the IBM Tivoli Monitoring installation directory.
[ default = /opt/IBM/ITM ]: press Enter
"/opt/IBM/ITM" does not exist
Try to create it [ 1-yes, 2-no; "1" is default ]? press Enter
Creating directory "/opt/IBM/ITM"...
Enter the name of the IBM Tivoli Monitoring local data directory.
[ default = /opt/IBM/ITM ]: press Enter
Installation directory and data directory are the same.
OK to share it [ 1-yes, 2-no; "1" is default ]? press Enter

KCI1362W: IBM Tivoli Monitoring version 6.3 introduces a number of platform improvements which may require operating system updates. It is important that you ensure this system meets these requirements prior to installing or updating your installation. Please refer to the following technote for more information: http://www.ibm.com/support/docview.wss?uid=swg21623341

Select one of the following:
1) Install products to the local host.
2) Install products to depot for remote deployment (requires TEMS).
3) Install TEMS support for remote seeding
4) Exit install.
Please enter a valid number:  Type 1 then press Enter

Initializing ...Prerequisite scanning for JRE failed:

FAIL   Tivoli Enterprise-supplied JRE  /opt/IBM/ITM/logs/pre   reqscan/20200403-192239/KJR/result.txt 

Property              Result          Found    Expected
os.SELinux          FAIL            Enabled       [source:Command]Disabled 

Continue with this installation [1-yes, 2-no; "2" is default ]?  Type 1 then press Enter

International Program License Agreement

1 Type 1 then press Enter

Enter a 32-character encryption key, or just press Enter to use the default
Default = IBMTivoliMonitoringEncryptionKey

....+....1....+....2....+....3..   Press Enter 

Product packages are available in /tmp/itm/ITM_V6.3.0.7_AGT_MP_ML/unix
All agents require that application support files that contain agent-specific information be installed on the Tivoli Enterprise Monitoring Server that the agents will connect to, Tivoli Enterprise Portal Server and Tivoli Enterprise Portal desktop and browser client. Install application support before starting to install any Tivoli Enterprise Monitoring Agents. The following products are available for installation:

1) Agentless Monitoring for AIX Operating Systems  V06.30.07.00
2) Agentless Monitoring for HP-UX Operating Systems  V06.30.07.00
3) Agentless Monitoring for Linux Operating Systems  V06.30.07.00
4) Agentless Monitoring for Solaris Operating Systems  V06.30.07.00
5) Agentless Monitoring for Windows Operating Systems  V06.30.07.00
6) Monitoring Agent for Linux OS  V06.30.07.00
7) Tivoli Enterprise Services User Interface Extensions  V06.30.07.00
8) all of the above

Type the numbers that correspond to the products that you want to install. Type "b" to change operating system, or type "q" to quit selection.

If you enter more than one number, separate the numbers by a comma or a space.
Type your selections here: Select 6 then press Enter 

The following products will be installed:
Monitoring Agent for Linux OS  V06.30.07.00
Are your selections correct [ 1=Yes, 2=No ; default is "1" ] ? Press Enter

Installing IBM Global Security Toolkit
GSkit encryption key has been set.
Key File directory: /opt/IBM/ITM/keyfiles
 ... installing "Monitoring Agent for Linux OS  V06.30.07.00 for Linux x86_64    R2.6, R3.0 (64 bit)"; please wait.
=> installed "Monitoring Agent for Linux OS  V06.30.07.00 for Linux x86_64 R   2.6, R3.0 (64 bit)".
... Initializing component Monitoring Agent for Linux OS  V06.30.07.00 for Linux x86_64 R2.6, R3.0 (64 bit).
... Monitoring Agent for Linux OS  V06.30.07.00 for Linux x86_64 R2.6, R3.0 (64 bit) initialized.

Do you want to install additional products or product support packages [ 1=Ye   s, 2=No ; default is "2" ] ? Press Enter 

... postprocessing; please wait.
... finished postprocessing.
Installation step complete.

You may now configure any locally installed IBM Tivoli Monitoring product via    the "/opt/IBM/ITM/bin/itmcmd config" command.

Automatic start at system initialization has been configured.
Automatic stop at system shutdown has been configured.

The install.sh command creates most of directories and files with world write permissions. IBM Tivoli Monitoring provides the secureMain utility to helps you keep the monitoring environment secured. You can secure this installation now or manually execute the secureMain utility later. For more information see Appendix G. Securing your IBM Tivoli Monitoring installation on Linux or UNIX in the IBM Tivoli Monitoring Installation and Setup Guide.

Do you want to secure this IBM Tivoli Monitoring installation [ 1-yes, 2-no;    "2" is default ]? Press enter

[root@yourlinuxsystemhere ITM_V6.3.0.7_AGT_MP_ML]# cd /opt/IBM/ITM/bin/

Step 6: Configuration

After installation, assuming everything has been done correctly, we have to proceed with client’s configuration; starting with the command below:

[root@yourlinuxsystemhere bin]# ./itmcmd config -A lz
Agent configuration started...
Will this agent connect to a TEMS? [1=YES, 2=NO] (Default is: 1): Press Enter
Network Protocol [ip, sna, ip.pipe, ip.spipe, ip6, ip6.pipe or ip6.spipe] (Defauis: ip.pipe): Press Enter

 Now choose the next protocol from one of these:
     - ip
     - sna
     - ip.spipe
     - ip6
     - ip6.pipe
     - ip6.spipe
     - 0 for none
Network Protocol 2 (Default is: 0): Press Enter

TEMS Host Name for IPv4 (Default is: yourlinuxsystemIPgoeshere): xxx.xxx.xxx.xxx
Type in the address of your Tivoli server 
IP.PIPE Port Number (Default is: 1918): Press Enter
Enter name of KDC_PARTITION (Default is: null): Press Enter
Configure connection for a secondary TEMS? [1=YES, 2=NO] (Default is: 2): Press Enter
Enter Optional Primary Network Name or 0 for "none" (Default is: 0): Press Enter
Disable HTTP? [1=YES, 2=NO] (Default is: 2): Press Enter
Agent configuration completed...

Step 7: Start the Agent

To start the agent: 

[root@yourlinuxsystemhere bin]# ./itmcmd agent start lz
Processing. Please wait...
Starting Monitoring Agent for Linux OS ...Monitoring Agent for Linux OS started
[root@yourlinuxsystemhere bin]# umount /tmp/itm/  

When done, unmount share from Step 2 as well.

Post-installation

Go to Tivoli portal and check to see if the newly installed agent is listed in the monitored VMs viee.

If the VM doesn’t show up in the Linux VMs list, you will need to add it by going through:

Object Editor > Managed Systems > Linux OS > Your List

Select your VM from the available members pane, then move it to the Assigned Members pane by clicking the left arrow in the middle of the panes.

Last modified: December 5, 2020

Author

Comments

Write a Reply or Comment