IBM Support

ISM 7.4.0.2 - Is it possible to distribute profiles by IP instead of hostname?

How To


Summary

This article shows you how to configure ISM agents so you can distribute profiles to the agents by IP instead of hostname. This solution may be necessary in scenarios where the ISM hostnames are identical on the primary and backup systems.

Steps

Here is a solution that allows you to distribute ISM profiles to agents by IP address instead of hostname.
 
The CTIRA_HOSTNAME and CTIRA_SYSTEM_NAME variables allow you to assign customized names to MSN’s (Managed System Names):
 
1.CTIRA_HOSTNAME - It changes the hostname displayed in the Managed System Status workspace, and also in the output of commands like 'tacmd listSystems'.

2.CTIRA_SYSTEM_NAME - It changes the hostname displayed in the Tivoli Enterprise Portal (TEP) Physical Navigator tree.
 
There are some changes required to update the values of these CTIRA variables. Please find the required steps for Windows and RHEL (Red Hat Enterprise Linux):
 
For Windows platform:
 
1) On the ISM host, change directory to '<ITM_HOME>\TMAITM6'.
 
2) Make a backup copy of kiscma.ini file.
 
3) Change the value of the following variables in the kiscma.ini file as follows:
 
CTIRA_HOSTNAME=<ISM_Host_IP_Address>
CTIRA_SYSTEM_NAME=<ISM_Host_IP_Address>

Note: In the following examples, please use the IP address for the local ISM agent host.

In the kiscma.ini file, preserve the string ' .TYPE=REG_EXPAND_SZ' at the end of the CTIRA_HOSTNAME variable, like this:

;CTIRA_HOSTNAME=%computername%      .TYPE=REG_EXPAND_SZ
;CTIRA_SYSTEM_NAME=%computername%
CTIRA_HOSTNAME=9.46.66.92  .TYPE=REG_EXPAND_SZ
CTIRA_SYSTEM_NAME=9.46.66.92

4) Verify there are no duplicate entries for these variables in these file. Add the CTIRA_SYSTEM_NAME variable if it is not present in these files.
 
5) Restart the ISM agent. Also restart TEMS and TEPS and open TEP client.
 
6) See that IP address for agent host is reflected in TEP navigator. Also verify that the IP address is reflected in 'tacmd listSystems' command output.

a) In the TEP Navigator, you will see a "ghost" entry for the ISM agent. You can right-click this "ghost" entry and select the command Clear offline entry.

Do not use the 'Remove' command.

 
image 3510
b) If the ISM agent looks "strange" in the TEP Navigator tree, start or restart the bridge process. Something like this:
image 3529
 
c) The 'tacmd listSystems' command output will show two entries for each ISM agent: one for the hostname, and one for the IP address, something like this. The status for the hostname instance will show the agent is offline.

C:\IBM\ITM\BIN>tacmd login -s <tems-ip-address> -u sysadmin -p <sysadmin-password>

Validating user...

KUIC00007I: User sysadmin logged into server on https://<tems-ip-address>:3661.

C:\IBM\ITM\BIN>tacmd listSystems -t IS
Managed System Name Product Code Version     Status
SURBASE1:IS         IS           07.40.02.03 N
9.46.66.92:IS       IS           07.40.02.03 Y

7) Deploy the profiles to the ISM agent host and see the test results in TEP.

The deployment panel will show two destinations: the IP instance, and the hostname instance. Undeploy the profile to the hostname instance, and deploy the profile to the IP instance. Click Apply.


image 3530
Also, note that the hostname instances will display as out of sync. Do not attempt to resync these instances.

image 3531

For RHEL platform:

1) On the ISM host, cd to <ITM_HOME>/config.

2) Make a backup copy of the is.ini file.
 
3) Use an ASCII text editor like vi to edit the is.ini file. Update the following variables in the is.ini file. If necessary, add the CTIRA_SYSTEM_NAME variable. Be sure to include the :IS string following the IP address in the CTIRA_HOSTNAME variable.
 
CTIRA_HOSTNAME=<ISM_Host_IP_Address>:IS
CTIRA_SYSTEM_NAME=<ISM_Host_IP_Address>

Example. Use the actual IP address for the local ISM agent host.

#CTIRA_HOSTNAME=$RUNNINGHOSTNAME$:IS   
CTIRA_HOSTNAME=9.102.56.188:IS
CTIRA_SYSTEM_NAME=9.102.56.188
 
4) Restart the ISM agent. After agent restart, values from <ITM_HOME>/config/is.ini are automatically reflected in the <ITM_HOME>/config/is.config file.
 
5) Restart TEMS and TEPS and open portal client. See that the IP address for the agent host is reflected in TEP navigator. Also verify that the IP address is reflected in 'tacmd listSystems' command output.
 
6) Deploy the profiles to the ISM agent host and see the test results in TEP.
 
Also see notes for deploying profiles and troubleshooting the appearance of the ISM agent in the TEP Navigator tree under Windows deployment.

Clearing Offline Entries

Consider using the 'tacmd cleanMS' command to clear offline entries. This approach prevents offline components from displaying in 'tacmd listSystems' command output and in the ITM GUI. These offline components are not deleted. Their status is simply hidden. The components will display again if or when they come back online.

After you have used the 'tacmd cleanMS' command, the ISM config GUI will only display agents by IP address in the 'Available Systems' and Deployed Systems' columns.

The ITM 6.3 Command Reference includes the following warning about using the 'tacmd cleanMS' command in large-scale environments:

Note: In large-scale environments with significant numbers of nodes registered (for
example, 10-20 thousand), using the tacmd cleanMS command or removing a node
through the TEPS console can take several seconds to complete. If the -a option is
used with the tacmd cleanMS command, and there are many offline nodes, the
tacmd cleanMS command might take a long time to complete (that is, hours).

Here is a sample session. Begin by logging onto your hub TEMS. The session is Windows centric, but the commands are the same on Unix/Linux systems.

1) Log onto the TEMS as the sysadmin user.

C:\IBM\ITM\BIN>tacmd login -s <tems-ip-address> -u sysadmin -p <sysadmin-password>
Validating user...
KUIC00007I: User sysadmin logged into server on https://<tems-ip-address>:3661.

2) List the active and offline ISM agents.

C:\IBM\ITM\BIN>tacmd listSystems -t is
Managed System Name Product Code Version    Status
SURBASE1:IS        IS          07.40.02.03 N
9.46.66.92:IS      IS          07.40.02.03 Y

3) List the offline components (ISM and other types of agents) that would be cleared.

C:\IBM\ITM\BIN>tacmd cleanMS -p
(Command displays list of offline entries that are eligible to be cleared.)
...

4) Clear all of the off-line components.

C:\IBM\ITM\BIN>tacmd cleanMS -a
(Command displays list of offline entries that have been cleared.)
...

5) Display the status of online ISM agents. Notice that offline ISM agents that were identified by hostname are omitted.

C:\IBM\ITM\BIN>tacmd listSystems -t is
Managed System Name Product Code Version    Status
9.46.66.92:IS      IS          07.40.02.03 Y

Log Filenames

The .LG0 log and the kisagent log were opened at the same time. Why is the .LG0 log identified by IP address, but the kisagent log is identified by the hostname?

9_46_66_92_IS.LG0
SURBASE1_is_kisagent_5e7cf410-01.log

The following entries are present in the C:\IBM\ITM\TMAITM6\kisenv file for the kisagent's .log filename and the .inv filename:

KBB_RAS1_LOG=C:\IBM\ITM\TMAITM6\logs\$(computername)_is_kisagent_$(sysutcstart)-.log
INVENTORY=C:\IBM\ITM\TMAITM6\logs\$(computername)_is_kisagent.inv COUNT=03 LIMIT=5 PRESERVE=1 MAXFILES=9

The kisagent log file is not using values from CTIRA variables. The computer name, which is the agent’s actual hostname, is getting used to generate the name of log files. Consequently, the kisagent log and .inv files are getting generated with the hostname as the filename instead of IP Address.

Document Location

Worldwide

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS2GQ5","label":"Tivoli Composite Application Manager for Internet Service Monitoring"},"ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]

Historical Number

TS003462996

Product Synonym

ISM, ITCAMfT

Document Information

Modified date:
14 May 2020

UID

ibm16209282