IBM Tivoli Composite Application Manager for Transactions, Version 7.4.0.0

Using self-describing agents (SDA)

ITCAM for Transactions V7.4 and later supports self-describing agents (SDA). This function enables you to install Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server support automatically for IBM Tivoli Monitoring V6.2.3 and later, when installing ITCAM for Transactions agents.

Before you can use SDA, it must be enabled for each agent that you want to install.

To enable SDA for all agents in systems where IBM Tivoli Monitoring V6.3 or later is installed, run the following command:

tacmd editSdaInstallOptions -t default -i on

To enable SDA for all agents in systems where IBM Tivoli Monitoring V6.2.3 is installed, set the variable KMS_SDA=Y in the following file:

install_dir/config/hostname_ms_temsname.config

To enable SDA for a particular agent and specified version, run the following command in the system where IBM Tivoli Monitoring V6.3 or later is installed:

tacmd addSdaInstallOptions -t product_code -v 07400000

where product_code is the product code of the agent, such as IS for Internet Service Monitoring

Now, when an SDA-enabled agent such as Transaction Tracking V7.4 connects to the Tivoli Enterprise Monitoring Server or Tivoli Enterprise Portal Server, it automatically pulls the Transaction Tracking support files from the computer on which the agent is installed and updates the Tivoli Enterprise Monitoring Server or Tivoli Enterprise Portal Server.

If you do use SDA to install Tivoli Enterprise Portal Server support automatically for the Application Management Console (T3) or Transaction Collector (TU) agents, restart the Tivoli Enterprise Portal Server to complete the installation.

Note: If you are using SDA with Transaction Reporter, reconfigure the Tivoli Enterprise Portal Server using the Manage Tivoli Enterprise Monitoring Services. This corrects some inconsistencies in the installation.

If you attempt to install Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server support automatically with an agent installation without enabling SDA, you will see an error similar to the following error in the agent log:

(518B678E.0004-10:kraaulog.cpp,755,"IRA_OutputLogMsg") Self-Describing Agent 
Register/Install failed with STATUS (1024/0x400) for PRODUCT "IS", with TEMS 
"HUB_TIVVM340", VERSION_INFO "product_vrmf=07400000;tms_package_vrmf=07400000;
tps_package_vrmf=07400000;tpw_package_vrmf=07400000;

Last updated: September 2014