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