User Tools

Site Tools


Installation of ITM Linux agent

For some strange reason IBM does not supply the 6.2.2 ITM Linux agent as RPM package(s).
Instead a tremendous number of files with a size of 2.7G is supplied!
If SE-Linux in enabled IBM suggests to disable SE-Linux! But hang on there is help in the darkness :-)

Make sure following packages is installed.


If these packages is missing you will get following error message:

runGSkit failure: Return error code: 99.
runGSkit failure: GSKit check failure, script: /opt/IBM/ITM/li6243/gs/bin/private_verifyinstall.
runGSkit failure: li6243 - GSK check error, verifyInstall test failed. failure: Return error code: 4.

Install agent (or rather do first round of installation as SE-Linux is turned on)
Dive into directory with ITM files.
Run install script

# ./

Choose default install values.
When prompted for Select one of the following:
Select 1) Install products to the local host.

You will be met with the IBM warning sign (rubbish):
WARNING: SELinux (Secure Enhanced Linux) is set to “enforced” or “permissive” mode. “Enforced” mode is not supported by IBM Tivoli Monitoring
1. Set SELinux “disabled” mode.
2. Reboot the system.
3. Execute the “prelink -a” command before restarting the ITM installation.

The install script will fail at some time with the messages:

JVMJ9VM011W Unable to load j9jit23: /opt/IBM/ITM/JRE/lx8266/bin/ cannot restore segment prot after reloc: Permission denied
JVMJ9VM011W Unable to load jclscar_23: /opt/IBM/ITM/JRE/lx8266/bin/ cannot restore segment prot after reloc: Permission denied
Could not create the Java virtual machine. failure: KCI1007E terminating … license declined.

Again IBM is showing their fantastic (cough) SE-Linux knowledge. According to the IBM web page (check link) one should run:

restorecon -R -v /opt/IBM/ITM/JRE/
semanage fcontext -a -t textrel_shlib_t "/opt/IBM/ITM/JRE/lx8266/bin/"
semanage fcontext -a -t textrel_shlib_t "/opt/IBM/ITM/JRE/lx8266/bin/"
chcon -R -t textrel_shlib_t /opt/IBM/ITM/JRE/lx8266/bin/
chcon -R -t textrel_shlib_t /opt/IBM/ITM/JRE/lx8266/bin/ 

Above IBM instructions is NOT correct.

restorecon should be ran after semanage & chcon will not survive relabelling of file systems……

Correct method that will survive relabelling of file systems:

# semanage fcontext -a -t textrel_shlib_t "/opt/IBM/ITM/JRE/lx8266/bin/"
# semanage fcontext -a -t textrel_shlib_t "/opt/IBM/ITM/JRE/lx8266/bin/"
# restorecon -R -v /opt/IBM/ITM/JRE/

Then do second of installation:
re-run and install ITM agent.
When prompted insert encryption key.

Next step is to configure the ITM agent.

# /opt/IBM/ITM/bin/itmcmd config -A lz

Select default options.
When prompted for TEMS Host Name insert IP of primary Remote TEMS

Configure connection for a secondary TEMS? [1=YES, 2=NO] (Default is: 2)
Select 1 and insert IP of secondary Remote TEMS

Edit /opt/IBM/ITM/config/lz.ini and add in bottom of file:

CTIRA_HOSTNAME=<customer abbreviation>.$RUNNINGHOSTNAME$

Check configured stuff:

# /opt/IBM/ITM/bin/itmcmd config -A -g lz

Only start Linux agent (lz) or start all ITM agents

Only start Linux agent (lz):

# /opt/IBM/ITM/bin/itmcmd agent start lz

Alternatively start all ITM agents:

# /etc/init.d/ITMAgents1 start

Check node is going online. Use IBM TEPS

Temporarily stopping ITM watchdog

You can temporarily disable the Agent Management Services Watchdog by using the InstallDir/bin/itmcmd execute lz command. This disables the Watchdog process for the OS Monitoring Agent and all Agent Management Services managed agents. If there is local administrative work to be performed, and you do not want the auto-restart of the agents to interfere with it, run the InstallDir/bin/itmcmd execute lz command before proceeding. When the work is complete, recycle the OS Monitoring Agent to reenable Agent Management Services, or use the InstallDir/bin/itmcmd execute lz command.


Permanently stopping ITM watchdog

Edit the < lz | ux >.ini and comment out the line the starts with KCA_CAP_DIR. (Note the value on the right might have a slightly different value based on the release).

  and add the line

Stop and restart the OS Agent


itm_agent.txt · Last modified: 2011/11/01 08:43 by root