Body

IBM Tivoli Composite Application Manager for Transactions
~ How to do stuff ~
By Kevin Baldwin -

How to.....

Recover missing agent configuration options


This blog describes a problem seen when reconfiguring a Robotic Response Time (RRT / T6) agent. However, it could happen to any agent. 

After selecting the ITCAM for Robotic Response agent, right-clicking and selecting the "Reconfigure..." option in Managed Tivoli Monitoring Servces (MTEMS), the Agent Advanced Configuration panel is displayed where you configure Primary TEMS Connection and Advanced settings. 

When [OK] is clicked, the "Robotic Response Time" panel is displayed, but it is empty.
It should display the "Robotic Monitoring Configuration" options. 

In some cases the panel is not displayed at all.

The file [ITM_HOME]\kincfg.log may contain the following entries:

04-01-2016 08:58:11: Can not find instance name :  -Pt6 -CC:\IBM\ITM\TMAITM6 -V074001000  
04-01-2016 08:58:11: Can not find response file :  -Pt6 -CC:\IBM\ITM\TMAITM6 -V074001000  
04-01-2016 08:58:11: Trying to open xml file :  C:\IBM\ITM\TMAITM6\t6_dd_074001000.xml  
04-01-2016 08:58:11: Can not find <version> in the xml file  
04-01-2016 08:58:11: JAVA-less xmlConfig will be launched  
04-01-2016 08:58:11: java-less XML config dir is:  C:\IBM\ITM\installitm\xmlconfig\  
04-01-2016 08:58:11: command parameter is:  -p t6 -v 074001000 -a WIX64 -c C:\IBM\ITM\TMAITM6\t6_dd_074001000.xml  
04-01-2016 08:58:11: RunJavaLessXMLcfg
04-01-2016 08:58:11: current dir set to C:\IBM\ITM\installitm\xmlconfig\  
04-01-2016 08:58:11: executing application: RUNCON~1.BAT  
04-01-2016 08:58:11: executing application: cmd.exe /C runConfig.bat -pt6 -v 074001000 -a WIX64 -c C:\IBM\ITM\TMAITM6\t6_dd_074001000.xml
04-01-2016 08:58:12: RC=255 

This indicates a failure to display the configuration options using "javaless xmlConfig" processing. 

If an ITM embedded JVM is installed the agent can be configured to use "java xmlConfig" mode.

To check if a local ITM JVM is installed run: 
kincinfo -t JM

If it's installed, you'll see something like this:

...Product Inventory
PC  APPLICATION SUPPORT DESC      PLAT   APP VER      BUILD       
JM  KJM(32-bit) JVM/Embedded JVM  WINNT  07.04.02.00  201308061911
 

If not, install Tivoli Enterprise Services User Interface (UE). 
This an optional installable component of the agent. 

You now need to modify the file:
[ITM_HOME]\TMAITM6\t6_dd_074001000.xml  

The filename might be different on your system if you have a different version of RRT installed. 

The first 2 lines of the file should be:

<?xml version="1.0" encoding="UTF-8"?>
<AgentConfig:agent xmlns:AgentConfig="http://www.ibm.com&#34;

You need to insert the following line immediately after the first line:
<!--<event_listening>fake</event_listening> -->  

The first 3 lines of the file will now be: 
<?xml version="1.0" encoding="UTF-8"?>
<!--<event_listening>fake</event_listening> -->  
<AgentConfig:agent xmlns:AgentConfig="http://www.ibm.com&#34;

When reconfiguring the agent from MTEMS, you should be able to see the "Robotic Monitoring Configuration" options as a result of now using "java xmlConfig" mode.

Visit the ITCAM for Transactions ~ How to do stuff ~ Homepage for more blogs in this series