IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Installation Guides > High Availability Guide for Distributed Systems > Monitor functions and architecture
IBM Tivoli Monitoring, Version 6.3 Fix Pack 2
IBM Tivoli Monitoring portal navigation
The configuration of the Tivoli Enterprise Portal Server includes a new KFW_TOPOLOGY_CLUSTER_LIST environmental variable. Agents with affinities that are included in the KFW_TOPOLOGY_CLUSTER_LIST variable are displayed in the physical view of the navigation tree below the name specified by the CTIRA_HOSTNAME agent variable. By using this enhancement, you can group agents by a unique name in the physical view of the navigation tree. You must include the agent type (the affinity symbolic name) in the list for every agent you plan to use in the cluster.
Note that the default behavior for the CTIRA_HOSTNAME variable is to take on the value of the system host name and is displayed under the system host name in the portal Navigator pane. Setting the CTIRA_HOSTNAME variable for those agents that also appear in KFW_TOPOLOGY_CLUSTER_LIST causes the agents to appear in the physical view of the Navigator tree under the value specified in CTIRA_HOSTNAME. In this way, you can group all the agents from one cluster by setting all the CTIRA_HOSTNAME names to the cluster name. The clustered agents appear in the Navigator pane under the cluster name (SQLCLUSTER) while the Windows OS agents appear under the cluster node names (TIVVM13 and TIVVM14).
The following agent variables are used to modify the agents:
- CTIRA_HOSTNAME
- <Cluster host name>
- CTIRA_SYSTEM_NAME
- <Cluster host name>
- CTIRA_HIST_DIR
- Location for data collection in the Tivoli Data Warehouse (optional).
- CTIRA_SIT_PATH
- Path to situation files. Can point to shared disk.
- CTIRA_LOG_PATH
- Path to common log files.
If you have a subnode Agent, you will also want to add:
- CTIRA_SUBSYSTEM_ID
- <cluster name>
The KFW_TOPOLOGY_CLUSTER_LIST variable includes a number of agents, such as:
A complete list of the affinity names can be found in the following file:
- AFF_MS_CLUSTER,
- // Cluster agent
- AFF_MS_SQL_SERVER,
- // SQL Server
- AFF_NT_EXCHANGE,
- // Exchange Server
- AFF_ALL_ORACLE,
- // Oracle
- AFF_ALL_SYBASE,
- // Sybase
- AFF_SIEBEL
- // Siebel
- For the Windows Tivoli Enterprise Portal Server:
C:\ibm\ITM\CNPS\affinity.properties
- For the Unix/Linux Tivoli Enterprise Portal Server:
/opt/IBM/ITM/platform/cq/data/affinity.properties
You can add entries or remove entries. For example,
KFW_TOPOLOGY_CLUSTER_LIST=AFF_UDB_AGENT -AFF_MS_SQL_SERVERadds the affinity UDB agent (AFF_UDB_AGENT) to the list and removes the SQL Server (-AFF_MS_SQL_SERVER) from the list.
You can disable this new behavior (using CTIRA_HOSTNAME at the agent, not grouping by the IP address, and not using the operating system–assigned host name) using the following setting:
KFW_TOPOLOGY_CLUSTER_ENABLE=N
To enable this Navigator behavior in the portal on Windows, complete the following steps:
- Stop the Tivoli Enterprise Portal Server (TEPS).
- Right-click on the TEPS icon in the portal, and select Advanced->Edit Variables from the pop-up menu.
The Tivoli Enterprise Portal Server Override Local Variable Settings dialog box is displayed.
- Click on the Variable pull-down menu and locate the KFW_TOPOLOGY_CLUSTER_LIST variable.
- If the variable exists, ensure that it is set to the agent affinity (for example, for DB2, AFF_UNIVERSAL_DATABASE).
- If the variable does not exist, type the variable name, and set the value to the agent affinity (for example, for DB2, AFF_UNIVERSAL_DATABASE).
- To initiate the changes, start the Tivoli Enterprise Portal Server.
This portal behavior affects all agents with that affinity. To enable this Navigator behavior in the portal on Linux or AIX, you need to manually edit the environment file (cq.ini).
Parent topic:
Monitor functions and architecture