Chapter 8. IBM Tivoli Monitoring integration 261
transport.class.name =
com.tivoli.commonlistener.transport.mqe.client.ClientTransportMQe
transport.local.ip.address = 9.3.4.59
transport.request.address = 9.3.4.59.DM.QM+DM.Q
transport.request.port = 6969
transport.response.address = 9.3.4.59.DM.QM+DM.Q
transport.response.port = 6969
transport.mqe.local.queue.store = file
transport.mqe.remote.queue.store = file
transport.mqe.usefiller = false
transport.mqe.fileregistry = com.ibm.mqe.registry.MQeFileSession
transport.mqe.maxchannels = 1
transport.server.mqe.address = ServerQM+ServerQ
transport.server.mqe.port = 8082
transport.server.ip.address = 9.3.4.53
heartbeat.send_events_to_tbsm = false
heartbeat.send_events_to_tec = false
heartbeat.send_events_to_notice = true
heartbeat.tec_server = not-configured
tbsma.jre_root = c:\Java13\jre
We will show some of the recommended trace parameters in 8.4, Tracing an
event to the Common Listener on page 268.
8.3 Using the TBSM adapter
The discussion consists of the following:
򐂰 8.3.1, Discovery process on page 261
򐂰 8.3.2, Event forwarding to Tivoli Business Systems Manager on page 264
8.3.1 Discovery process
Once the IBM Tivoli Business Systems Manager adapter is installed onto the
gateway, you can run a discovery. This sends a listing and locations of endpoints
that are attached to the gateway to the IBM Tivoli Business Systems Manager
Common Listener. This information is entered into the IBM Tivoli Business
Systems Manager database.
262 Tivoli Business Systems Manager Version 2.1: End-to-End Business Impact Management
There are two ways to carry out a discovery:
򐂰 Bulk discovery
The wdmdiscovery command can be issued from the Tivoli desktop to carry
out a bulk discovery. The adapter sends details of all systems it has in its
cache to the IBM Tivoli Business Systems Manager Common Listener. The
bulk discovery process creates new instances of resources, deletes old ones,
and updates those that already exist. Bulk Discovery is an intensive process
and should be used judiciously to minimize performance degradation,
especially if you are dealing with many endpoints on a gateway.
򐂰 Delta discovery
The same wdmdiscovery command can be issued from the Tivoli desktop to
carry out a delta discovery. The adapter sends details of all changes since the
last discovery to the IBM Tivoli Business Systems Manager Common
Listener. The delta creates, deletes, and updates resources one at a time.
This is the primary method to discover new resources, as it has less impact
on performance. If a large number of resources is being created, updated, or
deleted, bulk discovery should be used instead of delta.
In our environment, the discovery is performed as shown in Example 8-4.
Example 8-4 The wdmdiscovery command
c:\> wdmdiscovery -m all -b
Processing ManagedNode ibmtiv9...
If you have a problem issuing the discovery, it usually will be a time-out problem
caused by incorrect port settings or a network problem. (By default the adapter
will allow 300 seconds for the Common Listener to respond.) We can enable a
trace and look at the IBM Tivoli Business Systems Manager log files to diagnose
the problem. More on this later in 8.4, Tracing an event to the Common Listener
on page 268.
After successfully running the wdmdiscovery command, we can run the
wdmmngcache command, as shown in Example 8-5, to check whether the
registration completed sucessfully.
Example 8-5 The wdmmngcache command
C:\>wdmmngcache -m all -l -v
Processing ManagedNode ibmtiv9...
Endpoint | HB status | TBSM status
ibmtiv8 HBOff Discovered
ibmtiv9 HBOff Discovered
Chapter 8. IBM Tivoli Monitoring integration 263
This shows that the discovery of the endpoint with IBM Tivoli Business Systems
Manager was successful. If an endpoint status does not show the TBSM status
as Discovered, it will be ignored by the Common Listener whenever an event is
send to IBM Tivoli Business Systems Manager from this endpoint because there
is no registered object to associate this change of state with. Also, on the
gateways $DBDIR\dmml\ directory, you will see a directory
<ip-address>.DM.QM created by the wdmdiscovery process.
If we open the IBM Tivoli Business Systems Manager console we can see the
discovered endpoints as shown in Figure 8-5.
Figure 8-5 IBM Tivoli Business Systems Manager console window
IBM Tivoli Business Systems Manager automatically populates the new
resources on a successful discovery. The object hierarchy for the IBM Tivoli
Monitoring is located as follows:
Enterprise - IP Network - Network Subnet - Network Segment - Computer -
resource
This hierarchy is based on the IP address of the endpoint. The mapping of the
enterprise is performed from the table CL_AutoPlacement. Our content in this
table is shown in Figure 8-6.

Get Tivoli Business Systems Manager V2.1 End-to-end Business Impact Management now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.