In the Transaction Reporter configuration, the Aggregation Agent List parameter specifies the Aggregation agents from which the Transaction Reporter collects aggregate data. If this field is blank, the reporter collects data from all available Aggregation agents. In addition to the TU (Transaction Collector) agent, the T5 (Web Response Time) agent can also be an Aggregation agent.
To specify Aggregation agents, enter the name of the agent, followed by :TU or :T5. Separate agent names with a space. For example:
host1:TU host2:TU host3:T5 host4:T5
See Transaction Reporter agent configuration parametershttps://www.ibm.com/support/knowledgecenter/en/SS5MD2_126.96.36.199/com.ibm.itcamt.doc/tt/dita/reference/kto_tools_datacoll_rep.html
IMPORTANT: Here, the use of the symbolic name ‘host’ is misleading. In the Aggregation Agent List, the references to the TU or T5 agents must be managed system names (MSN), not IP addresses or hostnames. Use the tacmd listSystems command to list the MSN for all TU and T5 agent hosts.
The tacmd listSystems command searches all of the managed systems connected directly to the hub TEMS and indirectly through remote TEMS servers.
Note that you have to log onto the hub TEMS and connect to the TEMS first.
a. Logon to the hub TEMS as root or as sysadmin.
b. Use the tacmd login command to log onto the hub TEMS service.
<ITM_HOME>\BIN\tacmd login -u sysadmin -p <sysadmin-password> -s <full-hub-tems-server-name>
<ITM_HOME>/bin/tacmd login -u sysadmin -p <sysadmin-password> -s <full-hub-tems-server-name>
The following messages should display:
KUIC00007I: User sysadmin logged into server on
c. After you have established a connection to the hub TEMS service, enter the following tacmd listSystems command. Here, we show how to surface MSN’s for the TU agents. You can use a similar command to search for T5 agents. Substitute ‘t5’ for ‘tu’ in the tacmd listSystems command.
ITM_HOME\BIN\tacmd listSystems -t tu
ITM_HOME/bin/tacmd listSystems -t tu
# ./tacmd listSystems -t tu
Managed System Name Product Code Version Status
NC048034:TU TU 07.40.01.00 Y
In this example, The MSN is 'NC048034'. You would enter the following string in the Transaction Reporter's Aggregation Agent List:
Note: When the Aggregation Agent List is blank or commented out, the Transaction Reporter accepts data from all TU and T5 agents.
If a T5 and TU agent reside on the same host, insert a reference to the TU agent only in the Aggregation Agent List. Avoid using two aggregation agents from the same host.
If you have installed multiple Transaction Reporter agents in the same ITM system, you use the Aggregation Agent List to assign a subset of the available Aggregation agents to each Transaction Reporter agent. Ensure that there is no overlap of Aggregation agents in these assignments.
Configuring Transaction Reporter
On Windows, use the MTEMS (Manage Tivoli Enterprise Monitoring Services) GUI to reconfigure the TO agent. The parameter you need to edit is actually identified as ‘Aggregation Agent List’.
On Unix/Linux platforms, edit the <ITM_HOME>/config/to.ini file on the Transaction Reporter agent host. Here, the configuration variable is called ‘TU_LIST’. Remember to uncomment the TU_LIST variable.
# By default the Reporter contacts all available Aggregation Agents to collect aggregate data
# uncomment and set the following to specify a whitespace seperated list of Aggregation Agent names
# TU_LIST=Host1:TU Host2:TU Host3:T5 Host4:T5