Itm Install

Tivoli IBM Tivoli Monitoring
Version 6.2.2 Fix Pack 2 (Revised May 2010)
Installation and Setup Guide

GC32-9407-03
Tivoli IBM Tivoli Monitoring
Version 6.2.2 Fix Pack 2 (Revised May 2010)
Installation and Setup Guide

GC32-9407-03
Note
Before using this information and the product it supports, read the information in Appendix L, Notices, on page 607.
This edition applies to version 6.2.2 of IBM Tivoli Monitoring (product number 5724-C04) and to all subsequent
releases and modifications until otherwise indicated in new editions.
Copyright IBM Corporation 2005, 2010.
US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Part 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Chapter 1. Overview of IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . 3
Components of the monitoring architecture . . . . . . . . . . . . . . . . . . . . . . . 3
Tivoli Enterprise Monitoring Server . . . . . . . . . . . . . . . . . . . . . . . . . 5
Tivoli Enterprise Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Tivoli Enterprise Monitoring Agents . . . . . . . . . . . . . . . . . . . . . . . . . 6
Tivoli Data Warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Event synchronization component . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Tivoli Enterprise Portal Server extended services . . . . . . . . . . . . . . . . . . . . 9
New in release 6.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Changes to installation media . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Changes to runtime prerequisites and platform support. . . . . . . . . . . . . . . . . . 11
Changes to the Tivoli Data Warehouse . . . . . . . . . . . . . . . . . . . . . . . 11
Authentication using LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Help for the Tivoli Enterprise Portal presented by the Eclipse Help Server. . . . . . . . . . . 12
Event forwarding and synchronization for Tivoli Enterprise Console and Netcool/OMNIbus. . . . . 12
Support for /3GB boot option on 32-bit Windows . . . . . . . . . . . . . . . . . . . . 12
Common Event Console view for events from multiple event servers . . . . . . . . . . . . 12
Remote installation of application support files using Manage Tivoli Enterprise Monitoring Services
on Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Flexible scheduling of Summarization and Pruning agent . . . . . . . . . . . . . . . . . 13
Validation of monitoring server protocols and standby configuration . . . . . . . . . . . . . 13
Support for License Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Support for UNIX agents in Solaris local zones . . . . . . . . . . . . . . . . . . . . 13
New managed system groups offer advanced features over managed system lists . . . . . . . 13
New in release 6.2 fix pack 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Base DVD split . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Support for Sun Java Runtime Environment . . . . . . . . . . . . . . . . . . . . . 14
Support for the browser client on Linux . . . . . . . . . . . . . . . . . . . . . . 14
Support for single sign-on for launch to and from other Tivoli applications . . . . . . . . . . 14
New in release 6.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Reconfigured product media . . . . . . . . . . . . . . . . . . . . . . . . . . 15
New IBM Tivoli Monitoring High-Availability Guide provides resiliency information and instructions 15
IPv6 communications protocol now fully supported . . . . . . . . . . . . . . . . . . 15
RedHat Enterprise Linux 2.1 no longer supported on Intel platforms . . . . . . . . . . . . 16
SELinux now supported when executing IBM Tivoli Monitoring . . . . . . . . . . . . . 16
Asynchronous remote agent deployment and group deployment now supported . . . . . . . 16
Linux/UNIX users: 64-bit Tivoli Enterprise Portal Server now supported. . . . . . . . . . . 16
Support for 64-bit DB2 for the workstation . . . . . . . . . . . . . . . . . . . . . 16
Separate DB2 for the workstation licensing no longer required . . . . . . . . . . . . . 16
Tivoli Data Warehouse now supports DB2 on z/OS . . . . . . . . . . . . . . . . . . 16
New schema publication tool simplifies generation of SQL statements needed to create the Tivoli
Data Warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Tivoli Data Warehouse support for Solaris environments . . . . . . . . . . . . . . . . 16
Agentless monitoring of distributed operating systems now supported . . . . . . . . . . . 17
The tacmd createNode command need no longer be executed on the monitoring server node
17
Support for multiple remote Tivoli Enterprise Monitoring Servers on one Linux or UNIX computer 17
New in release 6.2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Copyright IBM Corp. 2005, 2010
iii
Contents of the Deployment Guide merged . . . . . . . . . . . . . . . . . . .

Additional online user information while the Windows installer is running . . . . . . . . .
Embedded Java Runtime Environment now supported for Windows sites . . . . . . . . .
Users of Sun Java 1.6 can improve the performance of the Tivoli Enterprise Portal browser
client on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . .
New installation process for language packs . . . . . . . . . . . . . . . . . . .
New System Monitor Agents provide autonomous-only monitoring of your operating system . .
Derby now supported as a portal server database . . . . . . . . . . . . . . . . .
More memory required to install and run the portal server . . . . . . . . . . . . .
Common agent environment variables listed . . . . . . . . . . . . . . . . . . .
tacmd CLI commands now optional . . . . . . . . . . . . . . . . . . . . . . .
Improved user control of agent or server restart after reconfiguration . . . . . . . . . .
Dynamic affinity affects agent coexistence with prior releases . . . . . . . . . . . . .
New installation parameters protect your customized configuration settings . . . . . . .
Higher versions of the Firefox browser supported for Windows customers. . . . . . . . .
Simplified operating system selection for Linux and UNIX systems . . . . . . . . . . .
New installation option allows you to retain your customized seeding files. . . . . . . . .
Automatic installation of application support for Linux/UNIX monitoring servers . . . . . . .
New silent-response files simplify agent installations and updates. . . . . . . . . . . .
Remote-deployment support extended to non-agent bundles . . . . . . . . . . . . .
Event integration of IBM Tivoli Monitoring with both IBM Tivoli Business Service Manager and
Netcool/OMNIbus now supported . . . . . . . . . . . . . . . . . . . . . . .
Upgrade procedure provided to Tivoli Event Synchronization V2.2.0.0 . . . . . . . . .
OMEGAMON data warehouse migration tool no longer provided . . . . . . . . . . . .
New in release 6.2.2 fix pack 1 . . . . . . . . . . . . . . . . . . . . . . . .
Native 64-bit operating system agents available for 64-bit Windows environments . . . . .
Event forwarding by autonomous agents . . . . . . . . . . . . . . . . . . . .
Support for DB2 Database for Linux, UNIX, and Windows version 9.7 . . . . . . . . .
New in release 6.2.2 fix pack 2 . . . . . . . . . . . . . . . . . . . . . . . .
64-bit System Monitor Agent now supported for Windows environments . . . . . . . .
Autonomous operation of the Warehouse Proxy agent and the Summarization and Pruning
agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IP.UDP protocol no longer supported for communications between the monitoring server and
the portal server . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32-bit DB2 for the workstation no longer required for the Tivoli Enterprise Portal Server . .
Further enhancements to the autostart scripts . . . . . . . . . . . . . . . . . .
Procedure for taking a snapshot of your Tivoli Enterprise Portal Server configuration settings
now documented . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Procedure for populating the data warehouse's ManagedSystem table now documented . .
. 17
. 18
. 20
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
20
20
20
20
21
21
21
21
22
22
22
22
22
23
23
23
.
.
.
.
.
.
.
.
.
23
23
23
23
23
23
24
24
24
. 24
. 24
. 24
. 24
. 24
. 24
Part 2. Planning your IBM Tivoli Monitoring deployment . . . . . . . . . . . . 25

Chapter 2. Pre-deployment phase. . . . . . . . . . .
Planning checklist . . . . . . . . . . . . . . . . .
Understanding Tivoli Monitoring and your network . . . . .
Determine if you require a firewall gateway . . . . . . .
Determine where to place your Tivoli Monitoring components
Tivoli Enterprise Monitoring Server . . . . . . . . .
Tivoli Enterprise Portal Server . . . . . . . . . . .
Tivoli Enterprise Portal client . . . . . . . . . . .
Tivoli Enterprise Monitoring Agents . . . . . . . . .
Warehouse Proxy agent . . . . . . . . . . . . .
Warehouse Summarization and Pruning agent . . . . .
Tivoli Data Warehouse . . . . . . . . . . . . .
Monitoring agent for IBM Tivoli Monitoring 5.x Endpoint .
Tivoli Enterprise Console integration . . . . . . . .
iv
IBM Tivoli Monitoring: Installation and Setup Guide
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
27
27
28
29
30
31
32
33
34
35
35
36
36
36
Netcool/OMNIbus integration . . . . . . . . . . . . . . . . . . . . . .
Firewall gateway . . . . . . . . . . . . . . . . . . . . . . . . . . .
IBM Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . . . .
IBM Tivoli Agent Builder . . . . . . . . . . . . . . . . . . . . . . . .
Additional ports used in the Tivoli Monitoring environment . . . . . . . . . . . .
Understanding COUNT and SKIP options . . . . . . . . . . . . . . . . .
Configuring your firewalls . . . . . . . . . . . . . . . . . . . . . . .
Sizing your Tivoli Monitoring hardware . . . . . . . . . . . . . . . . . . . . .
Locating and sizing the hub Tivoli Enterprise Monitoring Server . . . . . . . . . .
Locating and sizing the remote Tivoli Enterprise Monitoring Server . . . . . . . . .
Locating and sizing the remote deployment depot . . . . . . . . . . . . . . .
Locating and sizing the Tivoli Enterprise Portal Server . . . . . . . . . . . . . .
Locating and sizing the Warehouse Proxy agent . . . . . . . . . . . . . . . .
Locating and sizing the Summarization and Pruning agent . . . . . . . . . . . .
Locating and sizing the portal client . . . . . . . . . . . . . . . . . . . . .
Platform support matrix for Tivoli Monitoring . . . . . . . . . . . . . . . . . . .
Configuring for high availability and disaster recovery . . . . . . . . . . . . . . .
Configuring the hub monitoring server for high availability and disaster recovery . . . .
Configuring for portal server high availability and disaster recovery . . . . . . . . .
Configuring for agent and remote monitoring server high availability and disaster recovery
Configuring for warehouse high availability and disaster recovery . . . . . . . . . .
Configuring for Warehouse Proxy agent high availability and disaster recovery . . . . .
Configuring for Summarization and Pruning agent high availability and disaster recovery .
Agent deployments . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Background information about agent autonomy . . . . . . . . . . . . . . . .
Event forwarding from autonomous agents . . . . . . . . . . . . . . . . .
Agentless monitoring versus monitoring agents . . . . . . . . . . . . . . . .
Deployment options for agentless monitors . . . . . . . . . . . . . . . . .
Documentation resources for agentless monitoring . . . . . . . . . . . . . .
Problem-diagnosis tools available for agentless monitoring . . . . . . . . . . .
Tivoli Universal Agent deployments . . . . . . . . . . . . . . . . . . . . . .
Tivoli Universal Agent versioning considerations . . . . . . . . . . . . . . . .
Tivoli Universal Agent firewall considerations . . . . . . . . . . . . . . . . .
Large-scale deployment strategies . . . . . . . . . . . . . . . . . . . . .
Using Universal Agents with remote monitoring servers . . . . . . . . . . . . .
Mainframe users . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multi-hub environments . . . . . . . . . . . . . . . . . . . . . . . . . .
Accelerating your custom monitoring . . . . . . . . . . . . . . . . . . . . .
Planning and project management . . . . . . . . . . . . . . . . . . . . . .
Estimating deployment tasks . . . . . . . . . . . . . . . . . . . . . . . .
Install server components on Windows and UNIX. . . . . . . . . . . . . . . .
Install server components on z/OS . . . . . . . . . . . . . . . . . . . . .
Install data warehousing components . . . . . . . . . . . . . . . . . . . .
Install and configure event integration components . . . . . . . . . . . . . . .
Install and configure monitoring agents . . . . . . . . . . . . . . . . . . .
Setting up situation-based monitoring . . . . . . . . . . . . . . . . . . . .
Creating policies and workflows . . . . . . . . . . . . . . . . . . . . . .
Creating workspaces . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating and deploying Tivoli Universal Agent applications . . . . . . . . . . . .
Transferring skills . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scheduling the initial deployment. . . . . . . . . . . . . . . . . . . . . .
Scheduling for fix packs . . . . . . . . . . . . . . . . . . . . . . . . .
Staffing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
36
37
37
37
38
38
39
39
40
41
41
42
42
44
45
46
47
48
48
49
50
50
51
51
52
53
53
58
59
59
59
59
60
60
60
61
61
62
63
63
64
64
64
64
65
66
66
66
66
67
67
67
67
Chapter 3. Deployment phase . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Pre-installation checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Contents
Installing the infrastructure components . . . . . . . . . . .

Configuration checklist . . . . . . . . . . . . . . . .
Customizing your environment. . . . . . . . . . . . . .
Changing the default monitoring server configuration settings . .
Enabling historical collection of CandleNet Command Center logs
Installing your first 50 agents . . . . . . . . . . . . . . .
Post-installation checklist. . . . . . . . . . . . . . . . .
Configuring your warehouse agents . . . . . . . . . . . . .
Installing additional agents . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
69
70
71
71
72
72
73
73
74
Chapter 4. Post-deployment phase . . . .

Applying maintenance . . . . . . . . . .
Planning an upgrade . . . . . . . . .
Upgrade steps . . . . . . . . . . .
Post-upgrade health check . . . . . . .
Maintaining an efficient monitoring environment
Daily health checks . . . . . . . . . .
Weekly health checks . . . . . . . . .
Monthly health checks. . . . . . . . .
Quarterly health checks . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
75
75
75
75
76
77
78
78
78
79
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Part 3. Installation and initial configuration of base components and agents . . 81

Chapter 5. Preparing for installation. . . . . . . . . . . . . . . . . . .
Overview of the installation process . . . . . . . . . . . . . . . . . . . .
Specific information to have ready . . . . . . . . . . . . . . . . . . . .
Information to gather for event forwarding . . . . . . . . . . . . . . . .
Naming your monitoring server . . . . . . . . . . . . . . . . . . . .
Choose between IPv6 and IPv4 . . . . . . . . . . . . . . . . . . . .
Required order of installation or upgrade of IBM Tivoli Monitoring component products .
Windows installation considerations . . . . . . . . . . . . . . . . . . . .
User authority . . . . . . . . . . . . . . . . . . . . . . . . . . .
32 bit versus 64 bit . . . . . . . . . . . . . . . . . . . . . . . . .
Installation using a Citrix client . . . . . . . . . . . . . . . . . . . .
Linux or UNIX installation considerations . . . . . . . . . . . . . . . . . .
Changes in the behavior of the autostart scripts . . . . . . . . . . . . . .
Create an IBM Tivoli account for installing and maintaining the installation directory .
Host name for TCP/IP network services . . . . . . . . . . . . . . . . .
Use of fully qualified path names . . . . . . . . . . . . . . . . . . . .
Multiple network interface cards . . . . . . . . . . . . . . . . . . . .
Installing into an NFS environment . . . . . . . . . . . . . . . . . . .
Installing into Solaris zones . . . . . . . . . . . . . . . . . . . . . .
Architecture and product codes . . . . . . . . . . . . . . . . . . . .
File descriptor (maxfiles) limit on UNIX and Linux systems . . . . . . . . . .
Security options . . . . . . . . . . . . . . . . . . . . . . . . . . .
Communication between components . . . . . . . . . . . . . . . . . .
Authorization and authentication . . . . . . . . . . . . . . . . . . . .
Single sign-on capability . . . . . . . . . . . . . . . . . . . . . . .
SOAP server security . . . . . . . . . . . . . . . . . . . . . . . .
Global Security Toolkit. . . . . . . . . . . . . . . . . . . . . . . .
Hardware and software requirements . . . . . . . . . . . . . . . . . . .
Supported operating systems . . . . . . . . . . . . . . . . . . . . .
Supported databases for Tivoli Enterprise Portal Server and Tivoli Data Warehouse
Required hardware for distributed systems . . . . . . . . . . . . . . . .
Processor requirements. . . . . . . . . . . . . . . . . . . . . .
Memory and disk requirements . . . . . . . . . . . . . . . . . . .
vi
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 83
. 83
. 83
. 84
. 84
. 85
. 86
. 86
. 86
. 86
. 86
. 87
. 87
. 90
. 91
. 91
. 91
. 91
. 92
. 93
. 93
. 93
. 94
. 94
. 95
. 95
. 95
. 96
. 96
. 107
. 109
. 109
. 110
Additional requirements . . . . .
Required hardware for System z . .
Required software . . . . . . . .
Required software for event integration
. .
. .
. .
with
. . . . . . .
. . . . . . .
. . . . . . .
Netcool/OMNIbus
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
111
111
111
113
Chapter 6. Upgrading from a previous installation . . . . . . . . . . . . .

Upgrade scenarios . . . . . . . . . . . . . . . . . . . . . . . . .
Planning your upgrade . . . . . . . . . . . . . . . . . . . . . . . .
Platforms no longer supported for IBM Tivoli Monitoring V6.2/V6.2.2 . . . . . .
Prerequisites for IBM Tivoli Monitoring V6.2/V6.2.2 . . . . . . . . . . . . .
Upgrading and Migrating DB2 Database for Linux, UNIX, and Windows . . . .
Components to upgrade . . . . . . . . . . . . . . . . . . . . . .
Required order of upgrade. . . . . . . . . . . . . . . . . . . . . .
Migrated information when upgrading from a previous version. . . . . . . . .
Backing up IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . .
Backing up a Windows installation . . . . . . . . . . . . . . . . . .
Backing up a UNIX or Linux installation . . . . . . . . . . . . . . . .
Backing up your portal server and Tivoli Data Warehouse databases . . . . . .
Backing up your portal server database . . . . . . . . . . . . . . . .
DB2 Database for Linux, UNIX, and Windows . . . . . . . . . . . .
Derby . . . . . . . . . . . . . . . . . . . . . . . . . . .
Backing up your Tivoli Data Warehouse database . . . . . . . . . . . .
Upgrading the warehouse . . . . . . . . . . . . . . . . . . . . . .
IBM Tivoli Monitoring V6.2.x coexistence and interoperability . . . . . . . . . .
Tivoli Enterprise Monitoring Server. . . . . . . . . . . . . . . . . . .
Tivoli Enterprise Portal Server . . . . . . . . . . . . . . . . . . . .
Tivoli Data Warehouse . . . . . . . . . . . . . . . . . . . . . . .
Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tivoli Event Synchronization component . . . . . . . . . . . . . . . .
Upgrading from IBM Tivoli Monitoring V6.1 or V6.2. . . . . . . . . . . . . .
Overview of the upgrade process . . . . . . . . . . . . . . . . . . .
Linux and UNIX: Upgrading a portal server running as a nonroot process . . . .
Step 1: Verify the DB2 Database for Linux, UNIX, and Windows authorizations .
Step 2: Invoke the AIX slibclean command. . . . . . . . . . . . . . .
Required Java Runtime Environment . . . . . . . . . . . . . . . . . .
Upgrading from OMEGAMON Platform V350 and V360 . . . . . . . . . . . .
Overview of the upgrade process . . . . . . . . . . . . . . . . . . .
Considerations . . . . . . . . . . . . . . . . . . . . . . . . . .
Terminology changes . . . . . . . . . . . . . . . . . . . . . .
When to run the upgrade . . . . . . . . . . . . . . . . . . . . .
Installation directory for upgraded components . . . . . . . . . . . . .
Configuration settings for upgraded agents . . . . . . . . . . . . . .
Candle Management Workstation coexistence . . . . . . . . . . . . .
Additional unsupported OMEGAMON functions . . . . . . . . . . . . .
CandleNet Portal database . . . . . . . . . . . . . . . . . . . .
Required Java JRE . . . . . . . . . . . . . . . . . . . . . . .
Using existing OMEGAMON and other monitoring agents with IBM Tivoli Monitoring
Scenario: a rolling product upgrade . . . . . . . . . . . . . . . . . . .
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . .
Upgrading the Tivoli Monitoring environment . . . . . . . . . . . . . . .
Expected results . . . . . . . . . . . . . . . . . . . . . . . . .
Special instructions for reseeding a Hot Standby monitoring server . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
115
115
116
116
117
117
117
118
119
119
120
121
122
122
122
122
122
123
124
124
125
126
126
126
127
127
129
129
131
131
131
132
133
133
133
133
133
133
134
134
134
134
135
135
135
137
138
Chapter 7. Installing IBM Tivoli Monitoring on one computer . . . . . . . . . . . . . . 139

Prerequisites for the single-computer installation . . . . . . . . . . . . . . . . . . . . 139
Installation procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Contents
vii
Post-installation procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Chapter 8. Installing IBM Tivoli Monitoring. . . . . . . . . . . . .
Installing and configuring the hub Tivoli Enterprise Monitoring Server . . . .
Windows: Installing the hub monitoring server . . . . . . . . . . .
Linux or UNIX: Installing the hub monitoring server . . . . . . . . .
Installing the monitoring server . . . . . . . . . . . . . . . .
Configuring the hub monitoring server . . . . . . . . . . . . .
Adding application support to the hub monitoring server . . . . . . .
Command-line procedure . . . . . . . . . . . . . . . . .
GUI procedure . . . . . . . . . . . . . . . . . . . . .
Installing and configuring the remote monitoring servers . . . . . . . . .
Windows: Installing a remote monitoring server . . . . . . . . . . .
Linux or UNIX: Installing a remote monitoring server . . . . . . . . .
Configuring the remote monitoring server . . . . . . . . . . . .
Installing the Tivoli Enterprise Portal Server . . . . . . . . . . . . .
Windows: Installing the portal server . . . . . . . . . . . . . . .
Linux or AIX: Installing the portal server . . . . . . . . . . . . . .
Prerequisites for users installing on Linux on zSeries . . . . . . . .
Installing the portal server on Linux or AIX . . . . . . . . . . . .
Configuring the portal server on Linux or AIX: command-line procedure .
Configuring the portal server on Linux or AIX: GUI procedure . . . . .
Starting the portal server . . . . . . . . . . . . . . . . . .
Upgrading a 32-bit portal server to 64 bit . . . . . . . . . . . .
Installing monitoring agents . . . . . . . . . . . . . . . . . . .
Windows: Installing a monitoring agent . . . . . . . . . . . . . .
Installing the Agent Compatibility (AC) component . . . . . . . . .
When to install the AC component . . . . . . . . . . . . . .
When not to install the AC component . . . . . . . . . . . .
Installing the AC component using the Windows GUI . . . . . . .
Remotely deploying the AC components . . . . . . . . . . .
Installing the Embedded Java Runtime and the User Interface Extensions
Linux or UNIX: Installing a monitoring agent . . . . . . . . . . . .
Installing the monitoring agent . . . . . . . . . . . . . . . .
Configuring the monitoring agent . . . . . . . . . . . . . . .
Changing the file permissions for agents . . . . . . . . . . . .
Starting the monitoring agents . . . . . . . . . . . . . . . .
Populating the data warehouse's ManagedSystem table . . . . . . . .
Installing the Tivoli Enterprise Portal desktop client. . . . . . . . . . .
Windows: Installing the desktop client . . . . . . . . . . . . . .
Linux: Installing the desktop client . . . . . . . . . . . . . . . .
Linux: Configuring the desktop client . . . . . . . . . . . . . .
Installing and enabling application support . . . . . . . . . . . . . .
Selecting the correct support media . . . . . . . . . . . . . . .
Configuring application support for agents on the Base DVDs. . . . . .
Configuring application support for nonbase monitoring agents . . . . .
Installing application support on monitoring servers . . . . . . . .
Windows: Installing application support on a monitoring server . . .
Linux or UNIX: Installing application support on a monitoring server .
Installing application support on the Tivoli Enterprise Portal Server . . .
Windows: Installing application support on a portal server . . . . .
Linux or AIX: Installing application support on a portal server . . . .
Installing application support on the Tivoli Enterprise Portal desktop client
Windows: Installing application support on a desktop client. . . . .
Linux: Installing application support on a desktop client . . . . . .
Configuring application support on nonlocal monitoring servers . . . . .
viii
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
147
148
148
153
153
154
155
155
156
157
157
160
161
162
162
169
170
170
171
175
182
182
183
184
186
187
187
187
188
189
189
190
190
191
192
192
193
193
194
196
196
198
199
199
200
200
204
206
206
208
209
209
211
212
Configuring application support on a nonlocal monitoring server from a Windows system. . .

Copying the CAT and ATR files to the nonlocal monitoring server . . . . . . . . . .
Adding application support (SQL files) to a nonlocal hub. . . . . . . . . . . . . .
Configuring application support on a nonlocal monitoring server from a Linux or UNIX system
Copying the CAT and ATR files to the nonlocal monitoring server . . . . . . . . . .
Adding application support (SQL files) to a nonlocal hub. . . . . . . . . . . . . .
Installing application support files on a computer with no monitoring server . . . . . . .
Installing language packs . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstalling a language pack . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring clients, browsers, and JREs . . . . . . . . . . . . . . . . . . . . . .
Desktop clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Browser clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Registering the Java plug-in . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying runtime parameters for the plug-in. . . . . . . . . . . . . . . . . . .
Identifying the version of the Sun JRE the client should use . . . . . . . . . . . . .
Removing the Java plug-in on Windows. . . . . . . . . . . . . . . . . . . . .
Support for Sun Java 1.6.0_10 or higher with browser clients on Windows . . . . . . . .
Required maintenance . . . . . . . . . . . . . . . . . . . . . . . . . .
Java Web Start clients . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying the browser used for online help . . . . . . . . . . . . . . . . . . . . .
Windows: Specifying the browser location . . . . . . . . . . . . . . . . . . . . .
UNIX and Linux: Specifying the browser location . . . . . . . . . . . . . . . . . .
Web Start: Specifying the browser location. . . . . . . . . . . . . . . . . . . . .
Starting the Tivoli Enterprise Portal client . . . . . . . . . . . . . . . . . . . . . .
Starting the desktop client . . . . . . . . . . . . . . . . . . . . . . . . . . .
Starting the browser client . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Web Start to download and run the desktop client . . . . . . . . . . . . . . . .
Installing the IBM JRE . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Windows: Installing the IBM JRE . . . . . . . . . . . . . . . . . . . . . . .
Linux: Installing the IBM JRE . . . . . . . . . . . . . . . . . . . . . . . . .
Enabling tracing for the JRE . . . . . . . . . . . . . . . . . . . . . . . . . .
Downloading and running the desktop client . . . . . . . . . . . . . . . . . . . .
Manually creating a shortcut for the Web Start client . . . . . . . . . . . . . . . . .
Installing product maintenance . . . . . . . . . . . . . . . . . . . . . . . . . .
. 212
. 212
. 213
214
. 215
. 215
. 217
. 218
. 220
. 220
. 221
. 221
. 224
. 225
. 226
. 226
. 227
. 228
. 229
. 229
. 229
. 230
. 231
. 232
. 232
. 232
. 233
. 233
. 233
. 234
. 234
. 235
. 236
. 236
Chapter 9. Deploying monitoring agents across your environment

Populating your agent depot . . . . . . . . . . . . . . . .
Populating the agent depot from the installation image . . . . .
Windows: Populating the agent depot during installation . . . .
Base IBM Tivoli Monitoring installation image . . . . . . .
Application agent installation image . . . . . . . . . .
Linux and UNIX: Populating the agent depot during installation .
Populating the agent depot with the tacmd addBundles command .
Managing your agent depot . . . . . . . . . . . . . . . .
Sharing an agent depot across your environment . . . . . . . .
Deploying OS agents . . . . . . . . . . . . . . . . . .
Requirements for the tacmd createNode command . . . . . .
Using the tacmd createNode command . . . . . . . . . . .
Deploying non-OS agents . . . . . . . . . . . . . . . . .
Deploying through the portal . . . . . . . . . . . . . . .
Deploying through the command line . . . . . . . . . . . .
Deploying an instance of the Tivoli Universal Agent . . . . . .
Deploying Netcool/OMNIbus System Service Monitor (SSM) agents .
Installing an SSM agent . . . . . . . . . . . . . . . .
Uninstalling an SSM agent . . . . . . . . . . . . . . .
Installing an SSM patch. . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
237
237
238
238
238
239
239
240
240
241
242
242
243
244
244
244
245
246
246
246
246
Contents
ix
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Uninstalling an SSM patch. . . . . . . . .

Starting an SSM agent . . . . . . . . . .
Stopping an SSM agent . . . . . . . . .
Restarting an SSM agent . . . . . . . . .
Configuring an SSM agent. . . . . . . . .
Bulk deployment of NetCool SSM agents . . .
Query deployment status of Netcool SSM agents
Bulk agent deployment . . . . . . . . . . .
Deployment processing model . . . . . . .
Deploy status . . . . . . . . . . . . .
Deployment Status workspaces . . . . . .
Deployment attribute groups and situations .
Organizing deployments using groups . . . .
Deploy groups . . . . . . . . . . . .
Best practices . . . . . . . . . . .
Bundle groups . . . . . . . . . . . .
Best practices . . . . . . . . . . .
Group properties . . . . . . . . . . .
Best-practice deployment procedures. . . . .
Deployment planning and preparation . . .
Deployment . . . . . . . . . . . . .
Working with non-agent bundles . . . . . . .
Deploying a non-agent bundle . . . . . . .
Updating a non-agent bundle. . . . . . . .
Removing a non-agent bundle . . . . . . .
Running deployment in a Hot Standby environment
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
247
247
247
247
247
247
247
248
248
249
250
250
251
251
252
252
252
252
254
254
255
257
257
258
258
258
Part 4. Post-installation configuration and customization . . . . . . . . . . . 259

Chapter 10. Configuring IBM Tivoli Monitoring components . . . . . . . . .
Starting Manage Tivoli Enterprise Monitoring Services . . . . . . . . . . . .
Starting Manage Tivoli Enterprise Monitoring Services on Windows computers . .
Starting Manage Tivoli Enterprise Monitoring Services on Linux or UNIX computers
Changing the configuration of the Tivoli Enterprise Monitoring Server . . . . . . .
Configuring or changing the monitoring server connection for agents . . . . . . .
Starting and stopping components . . . . . . . . . . . . . . . . . . . .
Specifying network interfaces . . . . . . . . . . . . . . . . . . . . .
Controlling port number assignments . . . . . . . . . . . . . . . . . . .
Configuring port number assignments for the monitoring server . . . . . . . .
Configuring port number assignments for the portal server . . . . . . . . . .
Changing the port number for browser client connections to the portal server . .
Changing the port number for desktop client connections to the portal server . .
Configuring port number assignments for monitoring agents . . . . . . . . .
Example . . . . . . . . . . . . . . . . . . . . . . . . . . .
Adding the KDE_TRANSPORT environment variable . . . . . . . . . . .
Configuring the heartbeat interval . . . . . . . . . . . . . . . . . . . .
Restarting the Tivoli Enterprise Portal Server after reconfiguration . . . . . . . .
Switching to a different Tivoli Enterprise Portal Server database . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
261
261
261
261
262
264
265
266
266
266
266
267
268
268
269
269
270
271
272
Chapter 11. Additional Linux and UNIX configuration steps . . . . . .

Disabling fsync() calls . . . . . . . . . . . . . . . . . . . . .
Configuring permissions for a monitoring server on a non-NIS Solaris computer
Increasing virtual memory on AIX for large environments . . . . . . . .
Linux requirements for the localhost host name . . . . . . . . . . . .
Setting ulimit values for the Warehouse Proxy Agent . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
275
275
275
275
277
277
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Chapter 12. Additional Tivoli Enterprise Portal configurations . . . . . . . . . .

Connecting the Tivoli Enterprise Portal Server on Windows to a different monitoring server .
Using SSL between the portal server and the client . . . . . . . . . . . . . . .
Enabling and disabling SSL for the Tivoli Enterprise Portal Server . . . . . . . . .
Disabling SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring an external Web server to work with Tivoli Enterprise Portal . . . . . . . .
Configuring Internet Information Server V5.0 . . . . . . . . . . . . . . . . .
Configuring Internet Information Server V6.0 . . . . . . . . . . . . . . . . .
Configuring IBM HTTP Server and Apache HTTP Server . . . . . . . . . . . .
Configuring a portal client connection to an external Web server. . . . . . . . . . .
Browser client . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Desktop client . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Updating the IOR for Windows . . . . . . . . . . . . . . . . . . . . .
Updating the IOR for Linux . . . . . . . . . . . . . . . . . . . . . .
Web Start client . . . . . . . . . . . . . . . . . . . . . . . . . . .
Firewall network address translation (NAT) or multiple network interface cards . . . . .
Defining a Tivoli Enterprise Portal Server interface on Windows . . . . . . . . . .
Defining a Tivoli Enterprise Portal Server interface on Linux or UNIX . . . . . . . .
Firewall scenarios for Tivoli Enterprise Portal . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
279
279
280
281
281
282
282
282
283
284
284
284
285
285
285
286
286
287
287
Chapter 13. Configuring IBM Tivoli Monitoring Web

Defining hubs . . . . . . . . . . . . . . .
Windows: Defining hubs . . . . . . . . . .
UNIX and Linux: Defining hubs (GUI procedure). .
UNIX and Linux: Defining hubs (CLI procedure) . .
Adding users. . . . . . . . . . . . . . . .
Windows: Adding users . . . . . . . . . . .
UNIX or Linux: Adding users (GUI) . . . . . .
UNIX or Linux: Adding users (CLI) . . . . . . .
Verifying the configuration . . . . . . . . . . .
Services (the SOAP

. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
Server)
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
Chapter 14. Performance tuning . . . . . . . . . . . . . . . . . .

Tivoli Enterprise Monitoring Server. . . . . . . . . . . . . . . . . .
Tivoli Enterprise Monitoring agents . . . . . . . . . . . . . . . . .
Tivoli Enterprise Portal Server . . . . . . . . . . . . . . . . . . .
Configure an external Web server for large environments . . . . . . . .
Portal server parameter tuning . . . . . . . . . . . . . . . . . .
Tivoli Enterprise Portal client . . . . . . . . . . . . . . . . . . . .
Tuning the portal client JVM . . . . . . . . . . . . . . . . . . .
Portal client parameter tuning . . . . . . . . . . . . . . . . . .
Tivoli Data Warehouse . . . . . . . . . . . . . . . . . . . . . .
Historical data collection . . . . . . . . . . . . . . . . . . . .
Warehouse proxy agent. . . . . . . . . . . . . . . . . . . . .
Warehouse Proxy internals . . . . . . . . . . . . . . . . . .
Tuning the Warehouse Proxy agent on AIX and Linux systems . . . . .
Using multiple Warehouse Proxy agents . . . . . . . . . . . . .
Summarization and Pruning agent . . . . . . . . . . . . . . . . .
Number of worker threads . . . . . . . . . . . . . . . . . . .
Setting the maximum Java heap size . . . . . . . . . . . . . . .
Enabling more detailed trace in log files . . . . . . . . . . . . . .
Consider disabling shifts and vacations . . . . . . . . . . . . . .
Database tuning . . . . . . . . . . . . . . . . . . . . . . .
Relational database design and performance tuning for DB2 database servers
Terminology . . . . . . . . . . . . . . . . . . . . . . . .
Performance factors . . . . . . . . . . . . . . . . . . . . .
Database design details . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
293
293
293
294
295
296
296
297
297
298
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
299
299
301
301
302
302
304
304
306
307
307
309
309
309
310
310
311
311
312
312
312
313
313
314
314
Contents
xi
Table spaces. . . . . . . . . . . . . . . .
Buffer pools . . . . . . . . . . . . . . . .
Logging . . . . . . . . . . . . . . . . .
Database maintenance . . . . . . . . . . . .
Application design details . . . . . . . . . . . .
Hardware design and operating system usage . . . .
Memory . . . . . . . . . . . . . . . . .
CPU . . . . . . . . . . . . . . . . . . .
I/O . . . . . . . . . . . . . . . . . . .
Network . . . . . . . . . . . . . . . . .
Tuning . . . . . . . . . . . . . . . . . . .
Database manager configuration tuning . . . . . .
Database configuration tuning . . . . . . . . .
Buffer pools . . . . . . . . . . . . . . . .
Registry variables . . . . . . . . . . . . . .
Monitoring tools . . . . . . . . . . . . . . .
SNAPSHOT and EVENT monitors . . . . . . . .
DB2BATCH . . . . . . . . . . . . . . . .
Optimizing queries . . . . . . . . . . . . . . . .
Processing queries . . . . . . . . . . . . . . .
Defining custom queries . . . . . . . . . . . . .
Optimizing situations . . . . . . . . . . . . . . . .
Planning for platform-specific scenarios . . . . . . . . .
Disabling TCP-delayed acknowledgements on AIX systems
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
314
315
315
316
318
318
319
319
319
320
320
320
321
323
323
323
323
324
325
325
326
327
328
328
Part 5. Setting up data warehousing . . . . . . . . . . . . . . . . . . . . . 329

Chapter 15. Tivoli Data Warehouse solutions . . . . . . . . . . . . . . . .
New in Version 6.2 . . . . . . . . . . . . . . . . . . . . . . . . . .
New in V6.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . .
New in V6.2.2 fix pack 1 . . . . . . . . . . . . . . . . . . . . . . .
New in V6.2.2 fix pack 2 . . . . . . . . . . . . . . . . . . . . . . .
Planning considerations for the Tivoli Data Warehouse . . . . . . . . . . . . .
Estimating the required size of your database . . . . . . . . . . . . . . .
Step 1: Determine the number of detailed records per day for each attribute group .
Step 2: Determine the hard disk drive footprint for each attribute group . . . . .
Step 3: Determine the amount of detailed data for each attribute group . . . . .
Step 4: Calculate the amount of aggregate data for each attribute group. . . . .
Step 5: Determine the estimated size of your database . . . . . . . . . . .
Understanding the disk requirements for your database . . . . . . . . . . . .
Increasing the size of your database (DB2 for the workstation only) . . . . . . .
Planning assumptions . . . . . . . . . . . . . . . . . . . . . . . . .
Preliminary planning is complete . . . . . . . . . . . . . . . . . . . .
This need not be a multiple-computer installation . . . . . . . . . . . . . .
The data warehouse is remote from the portal server . . . . . . . . . . . . .
Agent warehouse database upgrade . . . . . . . . . . . . . . . . . . .
Firewall considerations for the Tivoli Data Warehouse . . . . . . . . . . . . .
Generating SQL statements for the Tivoli Data Warehouse: the schema publication tool .
Generating SQL for data warehouse tables . . . . . . . . . . . . . . . .
Using the schema publication tool in updated mode . . . . . . . . . . . .
Next steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of supported operating systems . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
331
331
331
332
332
333
333
333
333
334
334
335
337
338
338
339
339
339
340
340
340
340
342
343
344
Chapter 16. Tivoli Data Warehouse solution using DB2 for the workstation . . . . . . . . . 349
Supported components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Prerequisite installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
xii
Implementing a Tivoli Data Warehouse solution using DB2 for the workstation . . . . .
Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Solution steps . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1: Create the Tivoli Data Warehouse database . . . . . . . . . . . . . . .
Creating the warehouse database on DB2 for the workstation. . . . . . . . . . .
Creating a warehouse user on Windows . . . . . . . . . . . . . . . . . .
Creating a warehouse user on Linux or UNIX. . . . . . . . . . . . . . . . .
Limiting the authority of the warehouse user . . . . . . . . . . . . . . . . .
Setting database and instance configuration values . . . . . . . . . . . . . .
Activating the DB2 listeners on a UNIX DB2 server . . . . . . . . . . . . . .
Step 2: Install and configure communications for the Warehouse Proxy agent . . . . . .
Cataloging a remote data warehouse. . . . . . . . . . . . . . . . . . . .
Configuring an ODBC data source for a DB2 data warehouse . . . . . . . . . .
Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . .
Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring a Warehouse Proxy agent on Windows (ODBC connection) . . . . . . .
Configuring a Warehouse Proxy agent on Linux or UNIX (JDBC connection) . . . . .
Starting the Warehouse Proxy . . . . . . . . . . . . . . . . . . . . . .
Step 3: Configure communications between the Tivoli Enterprise Portal Server and the data
warehouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring a Windows portal server (ODBC connection) . . . . . . . . . . . .
Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . .
Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring a Linux or AIX portal server (DB2 for the workstation CLI connection) . . .
Starting the portal server . . . . . . . . . . . . . . . . . . . . . . . .
Step 4: Install and configure communications for the Summarization and Pruning agent . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
352
352
352
353
353
354
354
355
356
357
358
359
360
360
361
361
364
366
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
367
367
367
367
369
370
371
Chapter 17. Tivoli Data Warehouse solution using DB2 on z/OS . . .

Supported components . . . . . . . . . . . . . . . . . . . .
Prerequisite installation . . . . . . . . . . . . . . . . . . . .
Implementing a Tivoli Data Warehouse solution using DB2 on z/OS . . .
Requirements . . . . . . . . . . . . . . . . . . . . . .
Solution steps . . . . . . . . . . . . . . . . . . . . . .
Step 1: Connect the Warehouse Proxy node to your DB2 on z/OS database
Start defining the database connection . . . . . . . . . . . . .
Define the communications protocol . . . . . . . . . . . . . .
Define the TCP/IP communications parameters . . . . . . . . . .
Identify the DB2 on z/OS database . . . . . . . . . . . . . .
Register the database as an ODBC data source . . . . . . . . .
Identify the z/OS server containing the DB2 on z/OS database . . . .
Define the DB2 on z/OS system options . . . . . . . . . . . .
Define the DB2 on z/OS security options . . . . . . . . . . . .
Complete the DB2 on z/OS host connection . . . . . . . . . . .
Verify that the connection can be made . . . . . . . . . . . . .
Step 2: Configure the Tivoli Data Warehouse agents . . . . . . . . .
Testing your DB2 on z/OS database connection . . . . . . . . . . .
Testing the database connection using the DB2 Control Center . . . .
Testing the database connection using the DB2 command-line processor
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
373
374
375
376
376
377
378
379
380
381
382
383
384
385
386
387
388
391
391
391
395
Chapter 18. Tivoli Data Warehouse solution using Microsoft SQL Server .
Supported components . . . . . . . . . . . . . . . . . . . . .
Prerequisite installation . . . . . . . . . . . . . . . . . . . . .
Implementing a Tivoli Data Warehouse solution using Microsoft SQL Server .
Assumptions . . . . . . . . . . . . . . . . . . . . . . . .
Solution steps . . . . . . . . . . . . . . . . . . . . . . .
Step 1: Create the Tivoli Data Warehouse database . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
397
398
399
400
400
400
402
Contents
xiii
Configuring an ODBC data source for a Microsoft SQL data warehouse . . . . . . .
Starting the Warehouse Proxy agent . . . . . . . . . . . . . . . . . . . .
warehouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring the portal server (ODBC connection) . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
403
404
405
407
409
. . . . 410
. . . . 410
. . . . 412
Chapter 19. Tivoli Data Warehouse solution using Oracle . . . . . . . . . . . .

Supported components . . . . . . . . . . . . . . . . . . . . . . . . . .
Prerequisite installation . . . . . . . . . . . . . . . . . . . . . . . . . .
Implementing a Tivoli Data Warehouse solution using Oracle . . . . . . . . . . . .
Assumptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Solution steps . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Step 1: Create the Tivoli Data Warehouse database . . . . . . . . . . . . . . .
Creating the warehouse database on Oracle . . . . . . . . . . . . . . . . .
Creating a TNS Service Name . . . . . . . . . . . . . . . . . . . . . .
Configuring an ODBC data source for an Oracle data warehouse . . . . . . . . .
Starting the Warehouse Proxy . . . . . . . . . . . . . . . . . . . . . .
warehouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuring a Windows portal server (ODBC connection) . . . . . . . . . . . .
Configuring a Linux or AIX portal server (JDBC connection) . . . . . . . . . . .
Starting the portal server . . . . . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
415
415
417
418
418
418
419
419
421
422
423
424
426
428
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
429
429
431
432
433
Chapter 20. Tivoli Data Warehouse solutions: common procedures . . . . . .

Configuring the Summarization and Pruning agent (JDBC connection) . . . . . .
Starting the Summarization and Pruning agent . . . . . . . . . . . . . . .
Installing and configuring multiple Warehouse Proxy agents . . . . . . . . . .
Installing and configuring the proxy agents . . . . . . . . . . . . . . . .
Setting a permanent socket address for a proxy agent . . . . . . . . . . .
Verifying the configuration . . . . . . . . . . . . . . . . . . . . . .
Running the warehouse agents autonomously . . . . . . . . . . . . . . .
Configuring a Warehouse Proxy agent to run autonomously . . . . . . . . .
Configuring a Summarization and Pruning agent to run autonomously . . . . .
Configuring summarization and pruning without the Tivoli Enterprise Portal Server
Examples . . . . . . . . . . . . . . . . . . . . . . . . . .
Testing the connection between the portal server and the Tivoli Data Warehouse . .
Tuning the performance of the Warehouse Proxy . . . . . . . . . . . . . .
Database initialization . . . . . . . . . . . . . . . . . . . . . . .
Work queue . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connection pool . . . . . . . . . . . . . . . . . . . . . . . . .
RPC threads and export requests . . . . . . . . . . . . . . . . . . .
Timeout values . . . . . . . . . . . . . . . . . . . . . . . . . .
WAREHOUSELOG and WAREHOUSEAGGREGLOG tables . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
435
435
444
445
445
447
447
448
448
449
450
452
453
456
456
456
457
457
457
458
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Part 6. Integrating event management systems . . . . . . . . . . . . . . . . 461

Chapter 21. Setting up event forwarding to Tivoli Enterprise Console . . . . . . . . . . . 463
Event integration with Tivoli Enterprise Console . . . . . . . . . . . . . . . . . . . . . 463
xiv
One or more hub monitoring servers and a single event server . . . . . . . . . . .

A single hub monitoring server and multiple event servers . . . . . . . . . . . . .
Multiple hub monitoring servers and multiple event servers in a hub and spoke configuration
Determining when to use the IBM Tivoli Enterprise Console . . . . . . . . . . . .
Installing event synchronization on your event server . . . . . . . . . . . . . . . .
Installing from a wizard . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing from the command line . . . . . . . . . . . . . . . . . . . . . .
Installing from the command line using a silent installation . . . . . . . . . . . . .
Manually importing the event synchronization class files and rule set . . . . . . . . .
Creating a new rule base . . . . . . . . . . . . . . . . . . . . . . . .
Creating a new rule base and importing an existing rule base into it . . . . . . . .
Modifying an existing rule base . . . . . . . . . . . . . . . . . . . . . .
Installing monitoring agent .baroc files on the event server . . . . . . . . . . . . . .
Configuring your monitoring server to forward events . . . . . . . . . . . . . . . .
Controlling event forwarding . . . . . . . . . . . . . . . . . . . . . . . .
Starting and stopping the Situation Update Forwarder process . . . . . . . . . . . .
Changing the configuration of the event synchronization component on the event server . . .
Defining additional monitoring servers to the event server . . . . . . . . . . . . . .
Changing the TCP/IP timeout setting on your event server . . . . . . . . . . . . . .
Upgrading to Tivoli Event Synchronization version 2.2.0.0 . . . . . . . . . . . . . .
Upgrading from a wizard . . . . . . . . . . . . . . . . . . . . . . . . .
Upgrading from the command line . . . . . . . . . . . . . . . . . . . . . .
Upgrading from the command line using a silent installation . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
464
465
466
467
468
469
472
476
479
480
480
481
481
482
483
484
484
484
485
485
486
487
489
Chapter 22. Setting up event forwarding to Netcool/OMNIbus . . . . . . . . . . . . .

Event integration with Netcool/OMNIbus. . . . . . . . . . . . . . . . . . . . . . .
One or more hub monitoring servers and a single Object Server. . . . . . . . . . . . .
A single hub monitoring server and multiple Object Servers . . . . . . . . . . . . . .
Installing the event synchronization component . . . . . . . . . . . . . . . . . . . .
Installing from a wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing from the command line . . . . . . . . . . . . . . . . . . . . . . . .
Installing from the command line using a silent installation . . . . . . . . . . . . . . .
Configuring the Netcool/OMNIbus Object Server . . . . . . . . . . . . . . . . . . .
Configuring the OMNIbus server for program execution from scripts . . . . . . . . . . .
Updating the OMNIbus database schema . . . . . . . . . . . . . . . . . . . . .
Configuring the EIF probe . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrating with Tivoli Business Service Manager and Netcool/OMNIbus . . . . . . . . .
Configuring error event flow to OMNIbus (optional). . . . . . . . . . . . . . . . . .
Configuring the monitoring server to forward events . . . . . . . . . . . . . . . . . .
Controlling event forwarding . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing the OMNIbus configuration. . . . . . . . . . . . . . . . . . . . . . .
Defining additional monitoring servers to the Object Server. . . . . . . . . . . . . . . .
Verifying installation and configuration . . . . . . . . . . . . . . . . . . . . . . .
Starting and stopping the Situation Update Forwarder. . . . . . . . . . . . . . . . . .
Upgrading to Tivoli Event Synchronization version 2.2.0.0 . . . . . . . . . . . . . . . .
Upgrading from a wizard . . . . . . . . . . . . . . . . . . . . . . . . . . .
Updating the OMNIbus database schema . . . . . . . . . . . . . . . . . . . . .
Replacing the default deduplication trigger . . . . . . . . . . . . . . . . . . . . .
Updating the EIF probe . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integrating IBM Tivoli Monitoring with Tivoli Business Service Manager and Netcool/OMNIbus
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
491
492
492
493
494
495
497
500
502
502
503
505
507
508
508
508
509
510
511
511
512
512
512
514
515
516
Chapter 23. Monitoring your operating system via a System Monitor Agent .
Installing the System Monitor Agent on Windows systems . . . . . . . . .
Configuring the System Monitor Agents on Windows . . . . . . . . . .
Uninstalling the Windows System Monitor Agent. . . . . . . . . . . .
Installing the System Monitor Agent on Linux or UNIX systems . . . . . . .
.
.
.
.
.
517
517
520
521
522
Contents
xv
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Configuring the System Monitor Agents on Linux or UNIX . . . . . . . . . . . . . . . . 525

Uninstalling the Linux or UNIX System Monitor Agent . . . . . . . . . . . . . . . . . . 526
Defining common configuration parameters: accessing centralized configuration information . . . . 527
Appendix A. Installation worksheets . . . . . . . . .
Windows hub monitoring server worksheet. . . . . . . .
Linux or UNIX hub monitoring server installation worksheet .
Windows remote monitoring server worksheet . . . . . .
Linux or UNIX remote monitoring server installation worksheet
Windows portal server worksheet . . . . . . . . . . .
Linux portal server worksheet . . . . . . . . . . . .
Generic Windows monitoring agent worksheet . . . . . .
Generic Linux or UNIX monitoring agent worksheet . . . .
Windows portal desktop client worksheet . . . . . . . .
Linux portal desktop client worksheet. . . . . . . . . .
Monitoring server communications protocol details worksheet .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
529
530
531
532
533
534
535
536
537
538
539
540
Appendix B. Performing a silent installation of IBM Tivoli Monitoring

Creating and using a Windows response file . . . . . . . . . . .
Automatically creating agent response files on Windows. . . . . .
Running the silent installation from the command line with parameters
Running the silent installation using SMS . . . . . . . . . . .
Performing a silent installation on a Linux or UNIX computer . . . . .
Installing components with a response file . . . . . . . . . . .
Configuring components with a response file . . . . . . . . . .
Automatically creating agent response files on Linux or UNIX . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
541
541
542
544
544
544
545
547
548
Appendix C. Firewalls . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Determining which option to use . . . . . . . . . . . . . . . . . . . . . . . .
Flow of connection establishment . . . . . . . . . . . . . . . . . . . . . . .
Permission at the firewall . . . . . . . . . . . . . . . . . . . . . . . . . .
Server address continuity . . . . . . . . . . . . . . . . . . . . . . . . . .
Number of internet zones . . . . . . . . . . . . . . . . . . . . . . . . . .
Basic (automatic) implementation . . . . . . . . . . . . . . . . . . . . . . . .
Implementation with ephemeral pipe . . . . . . . . . . . . . . . . . . . . . . .
Implementation with partition files . . . . . . . . . . . . . . . . . . . . . . . .
Sample scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scenario 1: Hub monitoring server INSIDE and monitoring agents OUTSIDE . . . . . .
Scenario 2: Hub and remote monitoring servers INSIDE and monitoring agents OUTSIDE .
Scenario 3: Hub monitoring server INSIDE, remote monitoring server and agents OUTSIDE
Creating or modifying the partition file in Manage Tivoli Enterprise Monitoring Services . . .
Windows: Editing the partition file . . . . . . . . . . . . . . . . . . . . . .
UNIX and Linux: Editing the partition file . . . . . . . . . . . . . . . . . . .
Creating the partition file manually . . . . . . . . . . . . . . . . . . . . . . .
Sample partition file . . . . . . . . . . . . . . . . . . . . . . . . . . .
Implementation with firewall gateway . . . . . . . . . . . . . . . . . . . . . . .
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IPv4 Address Data . . . . . . . . . . . . . . . . . . . . . . . . . . .
IPv6 Address Data . . . . . . . . . . . . . . . . . . . . . . . . . . .
XML Document Structure . . . . . . . . . . . . . . . . . . . . . . . . .
Warehouse Proxy Configuration. . . . . . . . . . . . . . . . . . . . . . . .
Example gateway configuration scenario . . . . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
551
551
551
551
552
552
552
552
554
554
554
554
555
555
555
556
556
557
557
558
558
559
559
559
562
562
Appendix D. IBM Tivoli product, platform, and component codes . . . . . . . . . . . . . 567
xvi
Appendix E. Common agent environment variables . . . . . . . . . . . . . . . . . . 571

Appendix F. Maintaining the EIB on Linux or UNIX
Appendix G. Securing your IBM
Usage . . . . . . . . . .
Examples . . . . . . . . .
Scenario with secureMain . . .
Tivoli Monitoring
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . . . . . . . . . . . . . 577
installation
. . . . .
. . . . .
. . . . .
on
.
.
.
Linux
. . .
. . .
. . .
or
.
.
.
UNIX
. .
. .
. .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
579
579
580
580
Appendix H. Uninstalling IBM Tivoli Monitoring . . . . . . .

Uninstalling the entire IBM Tivoli Monitoring environment . . . .
Uninstalling the environment on Windows . . . . . . . . .
Uninstalling the environment on Linux or UNIX . . . . . . .
Uninstalling an individual IBM Tivoli Monitoring agent or component
Uninstalling a component on Windows . . . . . . . . . .
Uninstalling a component on Linux or UNIX . . . . . . . .
Uninstalling OMEGAMON Monitoring Agents . . . . . . . .
Removing an agent through the Tivoli Enterprise Portal . . . .
Uninstalling the Warehouse Proxy . . . . . . . . . . . . .
Removing the ODBC data source connection. . . . . . . .
Uninstalling components and agents silently . . . . . . . . .
Performing a silent uninstallation on a Windows computer . . .
Performing a silent uninstallation on a Linux or UNIX computer .
Uninstalling the event synchronization component . . . . . . .
Uninstalling event synchronization manually . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
581
581
581
583
584
584
585
585
587
587
587
587
588
589
590
591
Appendix I. Documentation library .

IBM Tivoli Monitoring library . . . .
Documentation for the base agents
Related publications . . . . . . .
Other sources of documentation . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
595
595
596
597
597
Appendix J. Additional resources . . .

IBM Tivoli Monitoring 6 Welcome Kit . . .
General education and support Web sites .
Product documentation and IBM Redbooks
Education offerings . . . . . . . . .
Service offerings . . . . . . . . . .
Other resources . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
599
599
599
599
600
600
601
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
603
603
604
604
605
605
606
606
Appendix K. Support for problem solving . .

Using IBM Support Assistant . . . . . . . .
Obtaining fixes . . . . . . . . . . . . .
Receiving weekly support updates . . . . . .
Contacting IBM Software Support . . . . . .
Determining the business impact . . . . .
Describing problems and gathering information
Submitting problems . . . . . . . . . .
Appendix L. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
Appendix M. Accessibility features for IBM Tivoli Monitoring . . . . . . . . . . . . . . 611
Accessibility features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
IBM and accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
Contents
xvii
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625
xviii
Figures
1. IBM Tivoli Monitoring environment . . . . . . . . . . . . . . . . . . . . . . . . . 4
2. Event synchronization overview . . . . . . . . . . . . . . . . . . . . . . . . . . 8
3. Help button on the IBM Tivoli Monitoring installer's Select Features panel . . . . . . . . . . 18
4. Help button on the installer's Hub TEMS Configuration panel . . . . . . . . . . . . . . 19
5. Status bar for the installer's software-installation phase . . . . . . . . . . . . . . . . . 19
6. Tivoli Monitoring V6.2.2 communications model . . . . . . . . . . . . . . . . . . . 29
7. Tivoli Monitoring component architecture including firewall gateway . . . . . . . . . . . . 30
8. Multiple data center environment . . . . . . . . . . . . . . . . . . . . . . . . . 33
9. Warehouse load projection spreadsheet . . . . . . . . . . . . . . . . . . . . . . 43
10. Tivoli supported platforms screen shot . . . . . . . . . . . . . . . . . . . . . . . 47
11. Architecture of agentless monitoring . . . . . . . . . . . . . . . . . . . . . . . . 55
12. Adding agentless monitors to the deployment depot . . . . . . . . . . . . . . . . . . 58
13. Configuration window for the portal server database using DB2 for the workstation . . . . . . 141
14. Configuration window for the Tivoli Data Warehouse database using DB2 for the workstation
143
15. Configuration window for the Tivoli Data Warehouse database using Microsoft SQL Server
143
16. Manage Tivoli Enterprise Monitoring Services window . . . . . . . . . . . . . . . . . 144
17. Progress bar for application seeding . . . . . . . . . . . . . . . . . . . . . . . 152
18. The Select Database for Tivoli Enterprise Portal window . . . . . . . . . . . . . . . . 163
19. Configuration window for the portal server database using DB2 for the workstation . . . . . . 166
20. Common Event Console Configuration window . . . . . . . . . . . . . . . . . . . 176
21. Registering the portal server with the Tivoli Enterprise Monitoring Server . . . . . . . . . . 177
22. Configuring database connections for the portal server . . . . . . . . . . . . . . . . 179
23. Configuration information for the Tivoli Data Warehouse using an Oracle database . . . . . . 181
24. Installing the Agent Compatibility Package (component code AC) . . . . . . . . . . . . 188
25. Java Runtime Environment Not Detected error . . . . . . . . . . . . . . . . . . . 189
26. IBM Tivoli Monitoring for Databases: application support packages . . . . . . . . . . . . 202
27. The Select the Application Support to Add to the TEMS window . . . . . . . . . . . . . 203
28. Application Support Addition Complete window . . . . . . . . . . . . . . . . . . . 204
29. Refresh Configuration menu option. . . . . . . . . . . . . . . . . . . . . . . . 206
30. Manage Tivoli Enterprise Monitoring Services Install Product Support window . . . . . . . . 216
31. Firefox Security Warning . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
32. Java memory error message . . . . . . . . . . . . . . . . . . . . . . . . . . 226
33. Java Control Panel window . . . . . . . . . . . . . . . . . . . . . . . . . . 227
34. Server connection error, Tivoli Enterprise Portal browser client . . . . . . . . . . . . . 228
35. Deployment Status Summary workspace showing the status of SSM deployments . . . . . . 248
36. Bulk deployment processing model. . . . . . . . . . . . . . . . . . . . . . . . 249
37. Restart Component window: Tivoli Enterprise Monitoring Server . . . . . . . . . . . . . 263
38. Restart of Monitoring Agent window . . . . . . . . . . . . . . . . . . . . . . . 265
39. Hierarchy for the heartbeat interval. . . . . . . . . . . . . . . . . . . . . . . . 270
40. Manage Tivoli Enterprise Monitoring Services Advanced Utilities window . . . . . . . . . . 272
41. The Manage Tivoli Enterprise Monitoring Services select the new portal server database window 273
42. The Manage Tivoli Enterprise Monitoring Services select the new portal server database window 273
43. Tivoli Enterprise Portal Server snapshot request screen . . . . . . . . . . . . . . . . 279
44. Tivoli Enterprise Portal Server snapshot verification screen . . . . . . . . . . . . . . . 280
45. Intranet with integral Web server . . . . . . . . . . . . . . . . . . . . . . . . 288
46. Intranet with external Web server . . . . . . . . . . . . . . . . . . . . . . . . 289
47. Intranet with integral Web server; Internet with external Web server. . . . . . . . . . . . 290
48. Intranet and Internet with integral and external Web servers . . . . . . . . . . . . . . 291
49. Two host addresses, intranet and Internet, with integral and external Web servers . . . . . . 292
50. Summary of support for the Tivoli Data Warehouse . . . . . . . . . . . . . . . . . . 345
51. Tivoli Data Warehouse solution using DB2 for the workstation . . . . . . . . . . . . . . 350
52. Warehouse Proxy Database Selection screen . . . . . . . . . . . . . . . . . . . . 362
53. Configure DB2 Data Source for Warehouse Proxy window . . . . . . . . . . . . . . . 363
xix
54. Configure Warehouse Proxy window (TEMS Connection tab) . . . . . . . . . . . .

55. Configure Warehouse Proxy window (Agent Parameters tab) . . . . . . . . . . . .
56. Configure DB2 Data Source for Warehouse window . . . . . . . . . . . . . . .
57. Configuring the connection to a DB2 for the workstation data warehouse. . . . . . . .
58. Tivoli Data Warehouse solution using DB2 on z/OS . . . . . . . . . . . . . . .
59. DB2 Client Configuration Assistant screen . . . . . . . . . . . . . . . . . . .
60. DB2 Add Database Wizard notebook, Source tab . . . . . . . . . . . . . . . .
61. DB2 Add Database Wizard notebook, Protocol tab . . . . . . . . . . . . . . . .
62. DB2 Add Database Wizard notebook, TCP/IP tab . . . . . . . . . . . . . . . .
63. DB2 Add Database Wizard notebook, Database tab . . . . . . . . . . . . . . .
64. DB2 Add Database Wizard notebook, Data Source tab . . . . . . . . . . . . . .
65. DB2 Add Database Wizard notebook, Node Options tab . . . . . . . . . . . . . .
66. DB2 Add Database Wizard notebook, System Options tab . . . . . . . . . . . . .
67. DB2 Add Database Wizard notebook, Security Options tab . . . . . . . . . . . . .
68. DB2 Add Database Wizard notebook, DCS Options tab . . . . . . . . . . . . . .
69. Connection-confirmation screen . . . . . . . . . . . . . . . . . . . . . . .
70. Connect to DB2 Database screen . . . . . . . . . . . . . . . . . . . . . .
71. DB2 Connection Confirmation screen . . . . . . . . . . . . . . . . . . . . .
72. DB2 Control Center . . . . . . . . . . . . . . . . . . . . . . . . . . .
73. DB2 Control Center right-click action menu. . . . . . . . . . . . . . . . . . .
74. Connect to named database window . . . . . . . . . . . . . . . . . . . . .
75. DB2 Command Line Processor window . . . . . . . . . . . . . . . . . . . .
76. Tivoli Data Warehouse solution using Microsoft SQL Server . . . . . . . . . . . .
77. Configure SQL Data Source for Warehouse Proxy window . . . . . . . . . . . . .
80. Configure SQL Data Source for Warehouse window . . . . . . . . . . . . . . .
81. Tivoli Data Warehouse solution using Oracle . . . . . . . . . . . . . . . . . .
82. Configure Oracle Data Source for Warehouse Proxy window . . . . . . . . . . . .
85. Configure Oracle Data Source for Warehouse window . . . . . . . . . . . . . .
86. Configuring the connection to an Oracle data warehouse . . . . . . . . . . . . .
87. Sources tab of Configure Summarization and Pruning Agent window . . . . . . . . .
88. Scheduling tab of Configure Summarization and Pruning Agent window . . . . . . . .
89. Work Days tab of Summarization and Pruning Agent configuration window . . . . . . .
90. Log Parameters tab of Summarization and Pruning Agent configuration window . . . . .
91. Additional Parameters tab of Summarization and Pruning Agent configuration window . . .
92. Create Query window . . . . . . . . . . . . . . . . . . . . . . . . . .
93. Assigning the WAREHOUSELOG query to a workspace . . . . . . . . . . . . . .
94. One or more hub monitoring servers connecting to a single event server . . . . . . . .
95. Single hub monitoring server and multiple event servers . . . . . . . . . . . . . .
96. Multiple hub monitoring servers and multiple event servers in a hub and spoke configuration
97. Window shown when no Tivoli Enterprise Console event server is found.. . . . . . . .
98. Upgrade data collection window . . . . . . . . . . . . . . . . . . . . . . .
99. Event flow and synchronization between Tivoli Monitoring and Netcool/OMNIbus . . . . .
100. One or more hub monitoring servers connecting to a single event server . . . . . . . .
101. Single hub monitoring server and multiple event servers . . . . . . . . . . . . . .
102. Installation of IBM Tivoli Monitoring and Tivoli Event Synchronization . . . . . . . . .
103. Output of the cinfo command . . . . . . . . . . . . . . . . . . . . . . . .
104. The Generate Response Files option . . . . . . . . . . . . . . . . . . . . .
105. Structure of firewall gateway XML configuration document . . . . . . . . . . . . .
106. Three-hop firewall scenario . . . . . . . . . . . . . . . . . . . . . . . .
107. Uninstalling IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . .
108. Confirming the uninstallation . . . . . . . . . . . . . . . . . . . . . . . .
109. Stopping Tivoli components before uninstallation. . . . . . . . . . . . . . . . .
xx
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
365
365
368
370
374
378
379
380
381
382
383
384
385
386
387
388
389
390
392
393
394
395
398
406
408
408
411
416
425
426
427
430
431
437
439
440
442
443
454
455
465
466
467
469
486
491
493
494
495
523
543
559
562
581
582
582
110.
111.
112.
113.
114.
Removing the portal database

Database information . . . .
Uninstallation progress window
GSKit uninstallation . . . .
Successful uninstallation . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Figures
.
.
.
.
.
582
582
583
583
583
xxi
xxii
Tables
1. IBM Tivoli Monitoring base monitoring agents . . . . . . . . . . . . . . . . . . . . . 3
2. Planning checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3. Warehouse database server considerations . . . . . . . . . . . . . . . . . . . . . 44
4. Portal client deployment advantages . . . . . . . . . . . . . . . . . . . . . . . 45
5. Data collectors usable with the various agentless monitors and releases supported . . . . . . 56
6. User's guides for the agentless monitors . . . . . . . . . . . . . . . . . . . . . . 59
7. Update history for the baroc files for IBM Tivoli Monitoring agents and components . . . . . . 65
8. Staffing estimates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
9. Commands for determining your system's kernel version . . . . . . . . . . . . . . . . 69
10. Installation and configuration steps . . . . . . . . . . . . . . . . . . . . . . . . 83
11. Supported IBM Tivoli Monitoring configurations using the IPv6 communications protocol . . . . 85
12. Supported Windows operating systems . . . . . . . . . . . . . . . . . . . . . . 96
13. Supported UNIX, i5/OS, and z/OS operating systems . . . . . . . . . . . . . . . . . 99
14. Supported Linux operating systems . . . . . . . . . . . . . . . . . . . . . . . 102
15. Operating system requirements for IBM GSKit . . . . . . . . . . . . . . . . . . . 106
16. Supported databases for the portal server . . . . . . . . . . . . . . . . . . . . . 107
17. Supported databases for the Tivoli Data Warehouse . . . . . . . . . . . . . . . . . 108
18. Estimated memory and disk storage for IBM Tivoli Monitoring components on distributed systems 110
19. Required software for IBM Tivoli Monitoring. . . . . . . . . . . . . . . . . . . . . 111
20. Agents requiring warehouse database migration . . . . . . . . . . . . . . . . . . . 119
21. Upgrading from IBM Tivoli Monitoring V6.1 or V6.2 to IBM Tivoli Monitoring V6.2.2 . . . . . . 127
22. Upgrading from OMEGAMON Platform 350 or 360 . . . . . . . . . . . . . . . . . . 132
23. OMEGAMON to IBM Tivoli Monitoring terminology . . . . . . . . . . . . . . . . . . 133
24. Unsupported OMEGAMON functions . . . . . . . . . . . . . . . . . . . . . . . 134
25. Configuration information for the portal server database . . . . . . . . . . . . . . . . 141
26. Configuration information for the Tivoli Data Warehouse database . . . . . . . . . . . . 143
27. IBM Tivoli Monitoring high-level installation steps . . . . . . . . . . . . . . . . . . 147
28. Communications protocol settings for the hub monitoring server . . . . . . . . . . . . . 150
29. Steps for installing a hub monitoring server on a Linux or UNIX computer . . . . . . . . . 153
30. UNIX monitoring server protocols and values . . . . . . . . . . . . . . . . . . . . 154
31. Parameters for the itmcmd manage command . . . . . . . . . . . . . . . . . . . 156
32. Remote monitoring server communications protocol settings . . . . . . . . . . . . . . 159
33. Steps for installing a remote monitoring server on a Linux or UNIX computer . . . . . . . . 160
35. Configuration information for the portal server database . . . . . . . . . . . . . . . . 166
36. Steps for installing a portal server on a Linux or AIX computer . . . . . . . . . . . . . 170
37. Hub monitoring server protocols and values . . . . . . . . . . . . . . . . . . . . 173
38. Parameters for the itmcmd manage command . . . . . . . . . . . . . . . . . . . 176
39. Configuration information for the Tivoli Enterprise Portal Server database . . . . . . . . . 180
40. Communications protocol settings . . . . . . . . . . . . . . . . . . . . . . . . 185
41. Steps for installing a monitoring agent on Linux or UNIX . . . . . . . . . . . . . . . . 189
43. Procedures for installing and enabling application support . . . . . . . . . . . . . . . 197
44. Product support on the Infrastructure and Agent DVDs . . . . . . . . . . . . . . . . 198
45. Installation media and instructions for installing application support for nonbase monitoring
agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
46. Locations of CAT and ATR files for the monitoring server . . . . . . . . . . . . . . . 213
47. Locations of application support files on a Linux or UNIX monitoring server . . . . . . . . . 214
48. Locations of CAT and ATR files for the monitoring server . . . . . . . . . . . . . . . 215
49. Language support included on IBM Tivoli Monitoring V6.2.2 Language Support DVDs . . . . . 218
50. File locations for changing application properties for UNIX and Linux . . . . . . . . . . . 230
51. Remote agent deployment tasks. . . . . . . . . . . . . . . . . . . . . . . . . 237
52. Agent depot management commands. . . . . . . . . . . . . . . . . . . . . . . 240
xxiii
53. Interaction between member properties and group properties . . . . . . . . . . . . .

54. Property precedence between deploy groups and bundle groups. . . . . . . . . . . .
55. Configuration tasks available through Manage Tivoli Enterprise Monitoring Services. . . . .
56. Parameters for the itmcmd manage command . . . . . . . . . . . . . . . . . .
57. Communications protocol settings . . . . . . . . . . . . . . . . . . . . . . .
58. Communications protocol settings . . . . . . . . . . . . . . . . . . . . . . .
59. Using COUNT and SKIP variables to assign port numbers . . . . . . . . . . . . . .
60. Overview of SOAP Server configuration steps. . . . . . . . . . . . . . . . . . .
61. TCP/IP Fields in Hub Specification dialog . . . . . . . . . . . . . . . . . . . .
62. SNA Fields in Hub Specification dialog . . . . . . . . . . . . . . . . . . . . .
63. SOAP hub configuration values . . . . . . . . . . . . . . . . . . . . . . . .
64. SOAP methods associated with access privileges . . . . . . . . . . . . . . . . .
65. Default Java heap size parameters by portal client type . . . . . . . . . . . . . . .
66. Tivoli Data Warehouse database size estimation worksheet. . . . . . . . . . . . . .
67. Database size examples . . . . . . . . . . . . . . . . . . . . . . . . . .
68. Goals for creating a Tivoli Data Warehouse solution using DB2 for the workstation . . . . .
69. Information topics related to installation of prerequisite software for a Tivoli Data Warehouse
solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
70. Tasks for creating the Tivoli Data Warehouse database . . . . . . . . . . . . . . .
71. Default values for Tivoli Data Warehouse parameters . . . . . . . . . . . . . . . .
72. Script for creating required bufferpool and tablespaces for the Tivoli Data Warehouse . . . .
73. Tasks for installing and configuring communications for the Warehouse Proxy agent . . . .
74. Configuration information for the Tivoli Data Warehouse database on DB2 for the workstation
75. Tasks for configuring communications between the portal server and a DB2 for the workstation
data warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
78. Tasks for installing and configuring communications for the Summarization and Pruning agent
79. Goals for creating a Tivoli Data Warehouse solution using DB2 on z/OS . . . . . . . . .
solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
81. Characteristics of implicitly created DB2 on z/OS database . . . . . . . . . . . . . .
82. Maximum DB2 on z/OS page sizes . . . . . . . . . . . . . . . . . . . . . .
83. Required parameters for accessing the DB2 on z/OS database . . . . . . . . . . . .
84. Goals for achieving a Tivoli Data Warehouse solution using Microsoft SQL Server . . . . .
solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
88. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server
89. Tasks for configuring communications between the portal server and a Microsoft SQL Server
data warehouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
90. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server
92. Goals for achieving a Tivoli Data Warehouse solution using Oracle . . . . . . . . . . .
solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
94. Tasks for creating the Tivoli Data Warehouse database . . . . . . . . . . . . . . .
97. Configuration information for the Tivoli Data Warehouse database on Oracle . . . . . . .
98. Tasks for configuring communications between the portal server and an Oracle data warehouse
99. Configuration information for the Tivoli Data Warehouse database on Oracle . . . . . . .
100. Configuration information for a Tivoli Data Warehouse database on Oracle . . . . . . . .
102. Where to obtain the JDBC driver files for the Summarization and Pruning agent . . . . . .
xxiv
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
253
254
261
261
262
264
269
293
294
294
295
296
305
336
337
349
.
.
.
.
.
352
353
354
355
358
364
. 367
369
370
371
. 373
.
.
.
.
.
375
376
376
377
397
. 400
. 402
. 403
406
. 410
411
412
. 415
.
.
.
.
.
417
419
419
421
425
429
. 430
. 431
433
. 435
103. Tivoli Data Warehouse URLs . . . . . . . . . . . . . . . . . . . . .

104. JDBC driver names . . . . . . . . . . . . . . . . . . . . . . . .
105. Descriptions of the columns in the WAREHOUSESUMPRUNE control settings table
106. Tivoli Enterprise Console event synchronization installation and configuration steps .
107. IBM Tivoli Enterprise Console event synchronization configuration fields . . . . .
108. IBM Tivoli Enterprise Console event synchronization configuration fields, continued .
109. Options for rule base modification . . . . . . . . . . . . . . . . . . .
110. IBM Tivoli Enterprise Console event synchronization configuration values . . . .
111. Netcool/OMNIbus event synchronization configuration fields . . . . . . . . .
112. Netcool/OMNIbus event synchronization configuration fields, continued . . . . .
113. Netcool/OMNIbus event synchronization configuration values . . . . . . . . .
114. Mapping of situation attributes to OMNIbus attributes . . . . . . . . . . . .
115. Windows hub monitoring server installation worksheet . . . . . . . . . . .
116. Linux or UNIX hub monitoring server installation worksheet . . . . . . . . . .
117. Windows remote monitoring server installation worksheet . . . . . . . . . .
118. Linux or UNIX remote monitoring server installation worksheet . . . . . . . .
119. Windows portal server worksheet . . . . . . . . . . . . . . . . . . .
120. Linux portal server worksheet. . . . . . . . . . . . . . . . . . . . .
121. Generic Windows monitoring agent worksheet . . . . . . . . . . . . . .
122. Generic monitoring agent for a Linux or UNIX computer worksheet . . . . . . .
123. Windows portal desktop client worksheet . . . . . . . . . . . . . . . .
124. Linux portal desktop client worksheet . . . . . . . . . . . . . . . . . .
125. Monitoring server communications protocol details worksheet . . . . . . . . .
126. Installation and configuration steps . . . . . . . . . . . . . . . . . . .
127. Silent installation parameters for UNIX . . . . . . . . . . . . . . . . .
128. Component product codes for infrastructure components and base monitoring agents
129. Platform codes required for remote agent deployment . . . . . . . . . . . .
130. Application support codes . . . . . . . . . . . . . . . . . . . . . .
131. EIB Files . . . . . . . . . . . . . . . . . . . . . . . . . . . .
132. Candle OMEGAMON Release 04R1 . . . . . . . . . . . . . . . . . .
133. Candle OMEGAMON Release BIV110 . . . . . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Tables
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
438
438
450
463
470
470
471
477
496
496
500
505
530
531
532
533
534
535
536
537
538
539
540
541
546
567
568
570
577
586
586
xxv
xxvi
Part 1. Introduction
The single chapter in this section, Chapter 1, Overview of IBM Tivoli Monitoring, on page 3, describes the
architecture of the IBM Tivoli Monitoring products and provides information to help you plan your
deployment and prepare to install, upgrade, or configure the product's base components.
Tivoli Monitoring products use a set of service components (known collectively as Tivoli Management
Services) that are shared by a number of other product suites, including IBM Tivoli OMEGAMON XE
monitoring products, IBM Tivoli Composite Application Manager products, System Automation for z/OS,
Web Access for Information Management, and others. The information in this section is also relevant to
these products.
Chapter 1. Overview of IBM Tivoli Monitoring

IBM Tivoli Monitoring products monitor the performance and availability of distributed operating systems
and applications. These products are based on a set of common service components, referred to
collectively as Tivoli Management Services. Tivoli Management Services components provide security,
data transfer and storage, notification mechanisms, user interface presentation, and communication
services in an agent-server-client architecture (Figure 1 on page 4). These services are shared by a
number of other products, including IBM Tivoli OMEGAMON XE mainframe monitoring products and IBM
Tivoli Composite Application Manager products, as well as other IBM Tivoli Monitoring products such as
Tivoli Monitoring for Applications, Tivoli Monitoring for Business Integration, Tivoli Monitoring for Cluster
Managers, Tivoli Monitoring for Databases, Tivoli Monitoring for Energy Management, Tivoli Monitoring for
Messaging and Collaboration, Tivoli Monitoring for Microsoft .NET, Tivoli Monitoring for Microsoft
Applications, Tivoli Monitoring for Transaction Performance, Tivoli Monitoring for Virtual Servers, and Tivoli
Monitoring for Web Infrastructure.
This book contains information on deploying, installing, and configuring the common services components
and the monitoring agents that comprise the base IBM Tivoli Monitoring product (Table 1) on distributed
systems. If you purchased a product other than IBM Tivoli Monitoring that uses Tivoli Management
Services, use this book to install and configure the common components. Do not install the base agents
unless you have also licensed IBM Tivoli Monitoring. If you purchased additional IBM Tivoli Monitoring
products, refer to their documentation for agent-specific installation and configuration information.
Table 1. IBM Tivoli Monitoring base monitoring agents
IBM Tivoli Monitoring 5.x Endpoint
Linux OS
UNIX Logs
UNIX OS
Windows OS
i5/OS
IBM Tivoli Universal Agent
Warehouse Proxy
Summarization and Pruning
IBM Tivoli Monitoring V6.2 products (including V6.2.2) are enabled for use with IBM Tivoli License
Manager. Tivoli Management Services components and Tivoli Monitoring agents provide inventory
signature files and usage definitions that allow License Manager to report installed products and product
usage by computer. License Manager support is an optional capability that requires License Manager
version 2.2 or later.
Components of the monitoring architecture

This section describes the architecture of the IBM Tivoli Monitoring products and provides information to
help you plan your deployment and prepare to install or upgrade the base components of the product.
Web Access for Information Management, and others. The information in this section is also relevant to
these products.
Tivoli Monitoring products, and other products that share Tivoli Management Services, participate in a
server-client-agent architecture. Monitoring agents for various operating systems, subsystems, databases,
and applications (known collectively as Tivoli Enterprise Monitoring Agents) collect data and send it to a
Tivoli Enterprise Monitoring Server. Data is accessed from the monitoring server by Tivoli Enterprise Portal
clients. A Tivoli Enterprise Portal Server provides presentation and communication services for these
clients. Several optional components such as an historical data warehouse extend the functionality of the
framework. Figure 1 shows the configuration of an IBM Tivoli Monitoring environment.
Before deciding where to deploy the components of the Tivoli Monitoring product in your environment, you
should understand the components of the product, the roles that they play, and what affects the load on
these components.
Figure 1. IBM Tivoli Monitoring environment
A typical IBM Tivoli Monitoring environment comprises the following components:

v One or more Tivoli Enterprise Monitoring Servers, which act as a collection and control point for alerts
received from the agents, and collect their performance and availability data. The monitoring server also
manages the connection status of the agents. One server in each environment must be designated as
the hub.
v A Tivoli Enterprise Portal Server, which provides the core presentation layer for retrieval, manipulation,
analysis, and pre-formatting of data. The portal server retrieves data from the hub monitoring server in
response to user actions at the portal client, and sends the data back to the portal client for
presentation. The portal server also provides presentation information to the portal client so that it can
render the user interface views suitably.
v One or more Tivoli Enterprise Portal clients, with a Java-based user interface for viewing and monitoring
your enterprise. Tivoli Enterprise Portal offers two modes of operation: desktop and browser.
v Tivoli Enterprise Monitoring Agents, installed on the systems or subsystems you want to monitor. These
agents collect data from monitored, or managed, systems and distribute this information either to a
monitoring server or to an SNMP Event Collector such as IBM Tivoli Netcool/OMNIbus.
v z/OS only: Tivoli Management Services:Engine (TMS:Engine) provides common functions, such as
communications, multithreaded runtime services, diagnosis (dumps), and logging (RKLVLOG), for the
Tivoli Enterprise Monitoring Server, monitoring agents, and OMEGAMON components of OMEGAMON
XE products running on z/OS.
v An Eclipse Help Server for presenting help for the portal and all monitoring agents for which support
has been installed.
An installation optionally includes the following components:
v Tivoli Data Warehouse for storing historical data collected from agents in your environment. The data
warehouse is located on an IBM DB2 for the workstation, DB2 on z/OS, Oracle, or Microsoft SQL
database. To store data in this database, you must install the Warehouse Proxy agent. To perform
aggregation and pruning functions on the data, you must also install the Summarization and Pruning
agent.
v Event synchronization component that sends updates to situation events that are forwarded to a Tivoli
Enterprise Console event server or a Netcool/OMNIbus Object Server back to the monitoring server.
The following sections describe each of these components in more detail.
Tivoli Enterprise Monitoring Server

The Tivoli Enterprise Monitoring Server (referred to as the monitoring server) is the first component to
install to begin building the Tivoli Management Services foundation. The monitoring server is the key
component on which all other architectural components directly depend.
The monitoring server is the collection and control point for performance and availability data and alerts
received from monitoring agents. It is also responsible for tracking the online or offline status of monitoring
agents.
Because of the number of functions the monitoring server performs, large-scale environments usually
include a number of monitoring servers to distribute the load. One of the monitoring servers is designated
the hub monitoring server, and the remaining servers are termed remote monitoring servers. Each remote
monitoring server must be located on its own computer and have a unique monitoring server name (node),
but the architectures of various remote monitoring servers might differ from each other and from the hub
monitoring server. In other words, a remote monitoring server running on UNIX can report to a hub
monitoring server running on Windows.
The portal server communicates with the hub, which in turn controls the remote servers, as well as any
monitoring agents that might be connected to it directly.
The monitoring server storage repository is a proprietary database format (referred to as the Enterprise
Information Base, or EIB). The hub holds the master copy of the EIB, while the remote servers maintain a
subset of the EIB relevant to them, which is synchronized with the hub.
Tivoli Enterprise Portal

Tivoli Enterprise Portal is the interface to your monitoring products. The Tivoli Enterprise Portal consists of
the Tivoli Enterprise Portal Server and one or more clients.
The Tivoli Enterprise Portal Server (referred to as the portal server) manages data access through user
workspace consoles (the portal clients). The portal server connects to a hub monitoring server; it retrieves
data from the hub in response to user actions at a portal client, and sends the data back to the portal
client for presentation. The portal server also provides presentation information to the portal client so that it
can render the user interface views suitably.
The portal server uses a DB2 for the workstation or Microsoft SQL database to store various artifacts
related to presentation at the portal client.
The portal client provides access to the Tivoli Enterprise Portal. There are two kinds of portal client:
v Browser client interface (automatically installed with Tivoli Enterprise Portal Server): The browser client
can be run using Microsoft Internet Explorer or Mozilla Firefox; it connects to a Web server running in
the Tivoli Enterprise Portal Server. Running the browser client is supported only on Windows, Linux, and
AIX computers.
v Desktop client interface: A Java-based graphical user interface on a Windows or Linux workstation. After
the desktop client is installed and configured, you can use it to start Tivoli Enterprise Portal in desktop
mode. You can also download and run the desktop client using Java Web Start, as discussed in Java
Web Start clients on page 229.
See Configuring clients, browsers, and JREs on page 220 for a discussion of the comparative
advantages of each type of portal client.
Tivoli Enterprise Monitoring Agents

Monitoring agents are data collectors. Agents monitor systems, subsystems, or applications, collect data,
and pass the data to Tivoli Enterprise Portal through the monitoring server. The agents pass commands
from the user to the system, subsystem, or application. An agent interacts with a single system or
application and, in most cases, is located on the same computer where the system or application is
running.
There are two types of monitoring agents:
v Operating system (OS) agents that monitor the availability and performance of the computers in your
monitoring environment. An example of an OS agent is the Monitoring Agent for Windows OS, which
monitors Windows XP, Windows 2000, and Windows 2003 operating systems.
As of version 6.2.1, a special type of operating system agent, the agentless monitor, is available. It
enables a remote node to monitor the health of nonessential desktop operating systems via a standard
monitoring API such as SNMP and thus is also called a remote OS agent.
In addition, as of Tivoli Monitoring V6.2.2, there is another class of operating-system agents, the System
Monitor Agent. These lighter-weight agents (they require a much smaller footprint than full-function Tivoli
Monitoring OS agents) are configured locally to the agent node. This configuration enables them to be
deployed autonomously (in other words, without the support of a Tivoli Enterprise Monitoring Server):
they send SNMP event information directly to an SNMP Event Collector such as IBM Tivoli
Netcool/OMNIbus. The System Monitor Agents are meant as a replacement for the OMNIbus System
Service Monitor agents.
v Other agents (referred to as application agents or non-OS agents) that monitor the availability and
performance of systems, subsystems, and applications. An example of a non-OS agent is IBM Tivoli
Monitoring for Microsoft Exchange, which monitors the Microsoft Exchange Server.
IBM Tivoli Monitoring also provides a customizable agent called the Tivoli Universal Agent. You can use
this agent to monitor most types of data that you can collect in your environment. For example, you can
use it to monitor the status of your company's Web site to ensure it is available. For more information
about the Tivoli Universal Agent, see the IBM Tivoli Universal Agent User's Guide.
You can also create your own IBM Tivoli Monitoring agent via the Agent Builder, a set of tools for creating
agents and adding value to existing agents. Using the Agent Builder, you can quickly create, modify, and
test an agent to collect and analyze data about the state and performance of different resources, such as
disks, memory, CPU, or applications. The builder creates a data provider that allows you to monitor three
types of data:
Availability
Process and service availability and functionality tests
Windows event log

Specific information from the Windows Event Log
External data sources
Data from external sources such as Windows Management Instrumentation (WMI), Performance
Monitor (PerfMon), Simple Network Management Protocol Version 1 (SNMP V1), external scripts,
and log files
With the Agent Builder's customizable Graphical User Interface installer, you can create agent-installation
packages for easy agent distribution. A key feature of the installer is its ability to package and distribute
extensions to existing agents. This lets you develop new situations, queries, and workspaces for an
existing IBM Tivoli Monitoring V6.x agent. For complete information about the Agent Builder, see the IBM
Tivoli Monitoring: Agent Builder User's Guide. Note that the Agent Builder is provided on its own
distribution CD for IBM Tivoli Monitoring version 6.2.1.
In most cases the recommended choice for customized agents is the Agent Builder.
The IBM Tivoli Monitoring Infrastructure DVD (in addition to providing the Tivoli Enterprise Monitoring
Server and its application support, the Tivoli Enterprise Portal Server and its application support, and the
Tivoli Enterprise Portal desktop and browser clients together with their application support) also contains
the Tivoli Data Warehouse agents: the Warehouse Proxy agent and the Summarization and Pruning agent.
This DVD is platform-specific (Windows, Linux, or UNIX). Use the Agents DVD to install the monitoring
agents in the following list (as well as application support for agentless monitoring). Note that this DVD,
however, is platform-nonspecific; that is, it applies to Windows, Linux, and UNIX environments.
i5/OS
Windows OS
Linux OS
UNIX OS
UNIX Logs
See Selecting the correct support media on page 198 for more information.
Note: For z/OS customers, IBM also provides a family of OMEGAMON Monitoring Agents that monitor
both the z/OS operating system (as well as its key subsystems: VTAM, CICS, IMS, DB2, and
storage subsystems) and the z/VM operating system (as well as any Linux guests running under
it). A complete suite of OMEGAMON product documentation is provided in the IBM Tivoli Monitoring
information center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/.
Tivoli Data Warehouse

With Tivoli Data Warehouse, you can analyze historical trends from monitoring agents. The Tivoli Data
Warehouse uses a DB2 for the workstation, DB2 on z/OS, Oracle, or Microsoft SQL Server database to
store historical data collected across your environment. You can generate warehouse reports for short-term
or long-term data through the Tivoli Enterprise Portal. Warehouse reports provide information about the
availability and performance of your monitoring environment over a period of time. You can also use
third-party warehouse reporting software, such as Crystal Reports or Brio, to generate reports.
Two specialized agents interact with the Tivoli Data Warehouse:
v The Warehouse Proxy agent receives data collected by monitoring agents and moves it to the Tivoli
Data Warehouse database.
v The Summarization and Pruning agent provides the ability to customize the length of time for which to
save data (pruning) and how often to aggregate granular data (summarization) in the Tivoli Data
Warehouse database.
The Warehouse Proxy and the Summarization and Pruning agents, and support for those agents, are
installed from the Infrastructure DVD.
See Part 5, Setting up data warehousing, on page 329 for information about setting up data
warehousing.
Event synchronization component

The event synchronization component, the Event Integration Facility or EIF, sends updates to situation
events that are forwarded to a Tivoli Enterprise Console event server or a Netcool/OMNIbus Object Server
back to the monitoring server. Figure 2 shows the flow of situation events from the monitoring server to the
event server as EIF events and the flow of updates to the situation events back to the monitoring server.
The Situation Event Console, the Common Event Console, and the Tivoli Enterprise Console event views
are synchronized with the updated status of the events.
If you are monitoring event data from a supported event management system in the Tivoli Enterprise
Console event view or the Common Event Console view, you can filter out forwarded events. See the IBM
Tivoli Monitoring: Administrator's Guide.
Figure 2. Event synchronization overview
For information about the various configurations of monitoring servers and event servers that you can have
in your environment, see Part 6, Integrating event management systems, on page 461.
Tivoli Enterprise Portal Server extended services

Tivoli Enterprise Portal Server extended services (TEPS/e) is an embedded, co-located extension of the
Tivoli Enterprise Portal Server that provides J2EE-based Application Server integration facilities. TEPS/e
supports a federated user repository. For more information, see the IBM Tivoli Monitoring: Administrator's
Guide.
New in release 6.2

The following sections describe changes in this release that affect installation or configuration. For a
complete list of new product features, see the IBM Tivoli Monitoring: Administrator's Guide.
Note: Some of these features were introduced in fix packs or as special solutions posted on the IBM
Tivoli Open Process Automation Library Web site.
The following items are new in IBM Tivoli Monitoring V6.2:
v Changes to installation media on page 11
v Changes to runtime prerequisites and platform support on page 11
v Changes to the Tivoli Data Warehouse on page 11
Authentication using LDAP on page 12
Help for the Tivoli Enterprise Portal presented by the Eclipse Help Server on page 12
Event forwarding and synchronization for Tivoli Enterprise Console and Netcool/OMNIbus on page 12
Support for /3GB boot option on 32-bit Windows on page 12
Common Event Console view for events from multiple event servers on page 12
Remote installation of application support files using Manage Tivoli Enterprise Monitoring Services on
Linux on page 13
v Flexible scheduling of Summarization and Pruning agent on page 13
v Validation of monitoring server protocols and standby configuration on page 13
v
v
v
v
v
v
v Support for License Manager on page 13

v Support for UNIX agents in Solaris local zones on page 13
v New managed system groups offer advanced features over managed system lists on page 13
The following items are new in IBM Tivoli Monitoring V6.2 Fix Pack 1:
v Base DVD split on page 13
v Support for Sun Java Runtime Environment on page 14
v Support for the browser client on Linux on page 14
v Support for single sign-on for launch to and from other Tivoli applications on page 14
The following items are new in Tivoli Monitoring V6.2.1:
v Reconfigured product media on page 15
v New IBM Tivoli Monitoring High-Availability Guide provides resiliency information and instructions on
page 15
v IPv6 communications protocol now fully supported on page 15
v RedHat Enterprise Linux 2.1 no longer supported on Intel platforms on page 16
v Asynchronous remote agent deployment and group deployment now supported on page 16
v Linux/UNIX users: 64-bit Tivoli Enterprise Portal Server now supported on page 16
v Support for 64-bit DB2 for the workstation on page 16
v Tivoli Data Warehouse now supports DB2 on z/OS on page 16
v New schema publication tool simplifies generation of SQL statements needed to create the Tivoli Data
Warehouse on page 16
v Tivoli Data Warehouse support for Solaris environments on page 16

v Agentless monitoring of distributed operating systems now supported on page 17
v The tacmd createNode command need no longer be executed on the monitoring server node on page
17
v Support for multiple remote Tivoli Enterprise Monitoring Servers on one Linux or UNIX computer on
page 17
The following items are new in Tivoli Monitoring V6.2.2:
v Contents of the Deployment Guide merged on page 17
v Additional online user information while the Windows installer is running on page 18
v Embedded Java Runtime Environment now supported for Windows sites on page 20
v New installation process for language packs on page 20
v New System Monitor Agents provide autonomous-only monitoring of your operating system on page
20
v Derby now supported as a portal server database on page 20
v More memory required to install and run the portal server on page 21
v Common agent environment variables listed on page 21
v tacmd CLI commands now optional on page 21
v Improved user control of agent or server restart after reconfiguration on page 21
v Dynamic affinity affects agent coexistence with prior releases on page 22
v New installation parameters protect your customized configuration settings on page 22
v Higher versions of the Firefox browser supported for Windows customers on page 22
v
v
v
v
Simplified operating system selection for Linux and UNIX systems on page 22
New installation option allows you to retain your customized seeding files on page 22
Automatic installation of application support for Linux/UNIX monitoring servers on page 23
New silent-response files simplify agent installations and updates on page 23
v Remote-deployment support extended to non-agent bundles on page 23

v Event integration of IBM Tivoli Monitoring with both IBM Tivoli Business Service Manager and
Netcool/OMNIbus now supported on page 23
v OMEGAMON data warehouse migration tool no longer provided on page 23
The following items are new in Tivoli Monitoring V6.2.2 fix pack 1:
v Native 64-bit operating system agents available for 64-bit Windows environments on page 23
v Event forwarding by autonomous agents on page 23
v Support for DB2 Database for Linux, UNIX, and Windows version 9.7 on page 24
The following items are new in Tivoli Monitoring V6.2.2 fix pack 2:
v 64-bit System Monitor Agent now supported for Windows environments on page 24
v Autonomous operation of the Warehouse Proxy agent and the Summarization and Pruning agent on
page 24
v IP.UDP protocol no longer supported for communications between the monitoring server and the portal
server on page 24
v 32-bit DB2 for the workstation no longer required for the Tivoli Enterprise Portal Server on page 24
v Further enhancements to the autostart scripts on page 24
v Procedure for taking a snapshot of your Tivoli Enterprise Portal Server configuration settings now
documented on page 24
v Procedure for populating the data warehouse's ManagedSystem table now documented on page 24
10
Changes to installation media

IBM Tivoli Monitoring distributed components and base agents are now supplied on two DVDs:
v IBM Tivoli Monitoring V6.2.2 Base DVD. This DVD contains the IBM Tivoli Monitoring base product
components, the operating system agents for both Windows and UNIX, as well as application support
for the operating system agents and a selected set of IBM Tivoli Monitoring 6.x based distributed
monitoring agents.
v IBM Tivoli Monitoring Tools DVD. This DVD contains the IBM Tivoli Monitoring 5.1.2 Migration Toolkit,
the Distributed Monitoring Upgrade Toolkit, the Agent Builder, and the Tivoli Event Integration event
synchronization component.
Application support for additional V6.x-based distributed monitoring agents is provided on three DVDs:
v IBM Tivoli Monitoring V6.2: Agent Support for Tivoli Enterprise Portal Server on AIX
v IBM Tivoli Monitoring V6.2: Agent Support for Tivoli Enterprise Management Server on HP-UX on
Itanium
v IBM Tivoli Monitoring V6.2: Agent Support for Tivoli Enterprise Portal Server for DB2 9.1
CDs are still available by request. See Installing and enabling application support on page 196 for
information on the products for which support is available on the Base DVD and the three Agent Support
DVDs. The IBM Tivoli Monitoring V6.2.0 Quick Start CD (C00YPML) contains a guide to help you get
started with IBM Tivoli Monitoring.
Language support for the agents on the Base DVD is provided on the following DVDs:
v IBM Tivoli Monitoring V6.2 Language Support 1 of 3. This DVD contains the national language versions
of the help and presentation files for the following languages: French, German, Italian, Portuguese
Brazilian, Spanish.
v IBM Tivoli Monitoring V6.2 Language Support 2 of 3. This DVD contains the language support for the
following languages: Japanese, Korean, Simplified Chinese, Traditional Chinese.
v IBM Tivoli Monitoring V6.2 Language Support 3 of 3. This DVD contains the language support for the
following languages: Czech, Hungarian, Polish, Russian
Language support for the Tools DVD is provided on the following DVDs:
v IBM Tivoli Monitoring V6.2 DM Upgrade Toolkit Language Support
v IBM Tivoli Monitoring V6.2 ITM 5.1.2 Migration Toolkit Language Support
v IBM Tivoli Monitoring V6.2 Agent Builder Toolkit Language Support
Note: IBM reminds sites to ensure all their product media are at the current release before beginning the
installation process. Installation of back-level agents and other IBM Tivoli Monitoring components
alongside a current Tivoli Enterprise Monitoring Server or Tivoli Enterprise Portal Server can
introduce errors.
Changes to runtime prerequisites and platform support

Runtime prerequisites have changed in several environments, especially AIX. Support for some platforms
has been added, and support for others dropped. Carefully review the information in Hardware and
software requirements on page 96, especially the table footnotes, for V6.2 requirements and support.
Changes to the Tivoli Data Warehouse

For a list of changes to the Tivoli Data Warehouse, see New in Version 6.2 on page 331. If you are
upgrading from IBM Tivoli Monitoring V6.1, and you use the Tivoli Data Warehouse, you must migrate
warehoused data. See Upgrading the warehouse on page 123.
11
Authentication using LDAP

Support has been added to enable external authentication of Tivoli Enterprise Portal users with
standards-based Lightweight Directory Access Protocol (LDAP) to shared registries. The hub monitoring
server can now be configured to validate user IDs and passwords using either the local system registry or
a central LDAP authentication and authorization system. This enhancement permits the sharing of user
authentication information among products. For more information, see Security options on page 93 and
the IBM Tivoli Monitoring: Administrator's Guide. See also Support for single sign-on for launch to and
from other Tivoli applications on page 14.
Note: The sysadmin administrative account initially defined for the Tivoli Enterprise Portal Server does not
need to be added to LDAP. However, you can use the sysadmin ID to create another administration
account known only to LDAP; you can then configure the portal server with LDAP and, from that
point forward, use this alternate administrative account instead of sysadmin.
Help for the Tivoli Enterprise Portal presented by the Eclipse Help
Server
The online Help for the Tivoli Enterprise Portal is now presented using the Eclipse Help Server. The Help
Server is installed with the Tivoli Enterprise Portal Server and can be started and stopped only by starting
and stopping the portal server.
Event forwarding and synchronization for Tivoli Enterprise Console

and Netcool/OMNIbus
You can now forward events generated by Tivoli Enterprise Portal based agents to both Tivoli Enterprise
Console and Netcool/OMNIbus event servers. Event forwarding is implemented using the Tivoli Event
Integration Event Facility (EIF). Reverse synchronization for forwarded events (changes at the event server
returned to the originating monitoring server) is provided by an event synchronization component
(SitUpdateForwarder). If you want to forward events to either Tivoli Enterprise Console or
Netcool/OMNIbus, you must enable event forwarding on the hub Tivoli Enterprise Monitoring Server and
configure a default target event server. For more information, see 461 and Part 6, Integrating event
management systems, on page 461.
Support for /3GB boot option on 32-bit Windows

Typically, Windows 32-bit supports only 2 GB of virtual memory. The /3GB boot option, available on
Windows 2000 Advanced Server and later, allows you to allocate 3 GB of virtual memory. The Tivoli
Enterprise Monitoring Server and the Tivoli Enterprise Portal Server now support this option. For more
details on this option and supported Windows versions, see http://technet.microsoft.com/en-us/library/
e834e9c7-708c-43bf-b877-e14ae443ecbf.aspx.
Common Event Console view for events from multiple event servers
The Common Event Console enables you to view and manage events from the Tivoli Enterprise
Monitoring Server in the same way as the situation event console. In addition, however, it incorporates
events from the Tivoli Enterprise Console Event Server and the Tivoli Netcool/OMNIbus Object Server if
your managed environment is configured for those servers.
Event data is retrieved from an event system by a common event connector, which also sends
user-initiated actions to be run in that event system. To have the events from a specific event system
displayed in the Common Event Console, you must configure a connector for that event system. During
configuration of the Tivoli Enterprise Portal Server you can edit the default connector for the Tivoli
Enterprise Monitoring Server and you can configure additional connectors for other event systems.
12
Remote installation of application support files using Manage Tivoli

Enterprise Monitoring Services on Linux
In previous versions, the Manage Tivoli Enterprise Monitoring Services utility on Windows could be used to
send application catalog and attribute files via FTP to nonlocal monitoring servers. The utility can also be
used to transfer the .sql files required for application support on a nonlocal hub to a nonlocal monitoring
server. In V6.2, these functions have been extended to Linux.
Flexible scheduling of Summarization and Pruning agent

The Summarization and Pruning agent has been enhanced to allow for flexible scheduling and to have the
warehouse and warehouse aggregation logs trimmed automatically after a specified number of days,
months, or years.
Validation of monitoring server protocols and standby configuration

In previous versions, there was no validation of hub and remote monitoring server protocols and standby
configuration. In V6.2, the installer validates configuration values such as the local host name of address,
the port number, and the communications protocols for hub, remote, and standby monitoring servers. You
may see warnings if you enter incorrect values during configuration.
Support for License Manager

IBM Tivoli Monitoring V6.2 products are enabled for use with IBM Tivoli License Manager. Base
components and Monitoring agents provide inventory signature files and usage definitions that allow
License Manager to report installed products and product usage by computer. License Manager support is
an optional capability that requires License Manager version 2.2 or later.
Support for UNIX agents in Solaris local zones

On Solaris, the UNIX OS monitoring agent running in a local zone and remote deployment to a local zone
are now supported. See Installing into Solaris zones on page 92 for more information.
New managed system groups offer advanced features over managed

system lists
Managed system groups are an expansion of the managed system lists known in prior releases. A
managed system group comprises a named, heterogeneous list of similar or dissimilar managed systems
for the distribution of historical collections, situations, and policies, and for assignment to queries and items
in custom Navigator views. If a managed system group is updated (usually when a constituent managed
system is added or deleted), then all the historical collections, situations, and policies that use that group
are redistributed to all managed systems in the group. Managed system groups are created, modified, or
deleted either by the Tivoli Enterprise Portal's Object Group editor or via the tacmd CLI command with the
createsystemlist, editsystemlist, or deletesystemlist keywords.
New in release 6.2 fix pack 1

The following items are new in IBM Tivoli Monitoring V6.2 fix pack 1:
Base DVD split

For Fix Pack 1, the Base DVD has been split into two DVDs, one for Windows and one for UNIX and
Linux:
v IBM Tivoli Monitoring V6.2 FP1 Windows Base DVD. This DVD contains the IBM Tivoli Monitoring
base product components, the operating system agents for Windows, as well as application support for
the operating system agents and a selected set of IBM Tivoli Monitoring 6.x based distributed
monitoring agents.
13
v IBM Tivoli Monitoring V6.2 FP1 UNIX/Linux Base DVD. This DVD contains the IBM Tivoli Monitoring
base product components, the operating system agents for UNIX and Linux,, as well as application
support for the operating system agents and a selected set of IBM Tivoli Monitoring 6.x based
distributed monitoring agents.
Support for Sun Java Runtime Environment

The Tivoli Enterprise Portal client included with V6.2 FP1 and subsequent releases has been enhanced to
support the Sun Java runtime environment, versions 1.5.0_xx through 1.6.0_xx. All client deployment
modes are supported (desktop, browser, and Java Web Start). Both Internet Explorer and Mozilla Firefox
browsers are supported using the Sun JRE and the IBM JRE. However, neither the IBM nor Sun JRE 1.6
is supported for Firefox on Linux.
Installer support for the Sun JRE is not available with FP1. The packaging, installation, and servicing of
the Sun JRE is not provided by IBM. The Sun JRE must already be installed on the machines where the
portal client will run, and in most cases some manual configuration is required to enable this feature. See
Configuring clients, browsers, and JREs on page 220.
Notes:
1. Support for the Sun JRE in FP1 is a Tivoli Enterprise Portal client feature only; installation and use of
the IBM JRE is still required for the Tivoli Enterprise Portal Server and other IBM Tivoli Monitoring
components.
2. When running the browser client with Sun JRE 1.6.0_10 or higher, you may need to clear your
browser's cache to ensure the updated applet.html is loaded.
Support for the browser client on Linux

Fix Pack 1 introduces support for the browser client on Linux computers running Mozilla Firefox. See
Browser clients on page 221 for more information.
Support for single sign-on for launch to and from other Tivoli applications
Fix Pack 1 introduces support for a single sign-on capability between Tivoli applications. You can now
launch from the Tivoli Enterprise Portal to other Tivoli web-based and web-enabled applications, and from
those applications into the portal without re-entering your log-on credentials. This single sign-on solution
uses a central LDAP-based user registry to authenticate sign-on credentials. For more information, see
Security options on page 93 and the IBM Tivoli Monitoring: Administrator's Guide.
New in release 6.2.1

The following items are new in IBM Tivoli Monitoring V6.2.1:
v The 64-bit operating environments are now supported in the following IBM Tivoli Monitoring components
for AIX versions 5.3 and 6.1:
Tivoli Enterprise Portal Server
Warehouse Proxy
Summarization and Pruning agent
v The 64-bit operating environments are now supported in the following IBM Tivoli Monitoring components
for SuSE Linux Enterprise Server versions 9 and 10 on zSeries:
Warehouse Proxy
14
Reconfigured product media

The IBM Tivoli Monitoring product media have changed again for version 6.2.1. There are now two Base
DVDs:
v The Infrastructure DVD contains:
The Tivoli Enterprise Monitoring Server and its application support
The Tivoli Enterprise Portal Server and its application support
The Tivoli Enterprise Portal desktop and browser clients and their application support
The two Tivoli Data Warehouse agents: the Warehouse Proxy agent and the Summarization and
Pruning agent
This DVD is provided in platform-specific versions: one each for Windows, Linux, and UNIX.
v The Agents DVD contains these Base monitoring agents:
Windows OS
Linux OS
UNIX OS
UNIX Logs
This DVD is platform-nonspecific: the same DVD applies to Windows, Linux, and UNIX.
New IBM Tivoli Monitoring High-Availability Guide provides resiliency information

and instructions
All information about IBM Tivoli Monitoring's resiliency features, is now covered in a separate book, the
IBM Tivoli Monitoring: High-Availability Guide for Distributed Systems. These features include:
v your ability to assign Hot Standby monitoring servers (that is, backup, or secondary, monitoring servers).
v the clustering of Tivoli Monitoring components using standard clustering software such as the
High-Availability Cluster Multiprocessing software provided for pSeries AIX environments, IBM Tivoli's
System AutomationMultiplatform, and Microsoft Cluster Server.
v agent autonomous mode, which ensures event information is not lost when communications are lost
between an agent and its monitoring server. Agent autonomy comprises the following two running
modes:
Managed Mode
These agents come in either of the following two flavors: a fully connected agent to the Tivoli
Enterprise Monitoring Server. While in this mode, the agent behaves as agents traditionally do.
But a partially connected agent runs in a semi-autonomous mode; that is, it is disconnected for
some time from the monitoring server.
Unmanaged Mode
Such agents are fully autonomous and need not be connected to a monitoring server at all.
The information provided includes instructions for implementing these resiliency features and scenarios
that lay out how and when they can best be used.
For z/OS customers, information about your options for configuring a Hot Standby hub monitoring server
on z/OS (sometimes called a Movable Hub) is now provided in the IBM Tivoli Management Services on
z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS guide; this manual also includes
implementation instructions.
IPv6 communications protocol now fully supported

IP version 6 (IPv6) communication can now be enabled between any two IBM Tivoli Monitoring
components, such as the portal server and the hub monitoring server, a remote monitoring server and the
hub, or an agent and a hub. Both components need to be at version 6.2.x with the exception of agents,
which can remain at version 6.1.
15
Note: Upgrading your Tivoli Enterprise Monitoring Server to IPv6 overwrites any customizations you may
have made and written to the monitoring server's ms.ini file.
RedHat Enterprise Linux 2.1 no longer supported on Intel platforms

IBM Tivoli Monitoring support for 32-bit RedHat Enterprise Linux 2.1 on Intel servers has been dropped.
SELinux now supported when executing IBM Tivoli Monitoring: You can now run IBM Tivoli
Monitoring with security-enhanced Linux (SELinux) active (although you still cannot install or configure IBM
Tivoli Monitoring with SELinux active). See usage note 7 on page 105 for Table 14 on page 102.
Asynchronous remote agent deployment and group deployment now supported

Agents can now be remotely deployed asynchronously as well as synchronously. With asynchronous
deployment, you can request that a second remote agent be deployed, even if the previously deployed
agent has not initialized fully.
IBM Tivoli Monitoring also allows you to group agents for bulk remote deployment. The deployment
commands have been modified to accept two new grouping parameters: the g parameter lets you specify
a deployment group and the b parameter lets you specify a bundle group. For detailed information, see
Bulk agent deployment on page 248; also see the IBM Tivoli Monitoring: Command Reference.
This enhancement also provides support for the deployment, upgrading, and configuration of
Netcool/OMNIbus System Service Monitor (SSM) agents.
Linux/UNIX users: 64-bit Tivoli Enterprise Portal Server now supported

You can now install and configure a 64-bit portal server on Linux or UNIX. In addition, a procedure has
been added that enables you to convert your 32-bit portal server to 64 bit; see Upgrading a 32-bit portal
server to 64 bit on page 182.
Support for 64-bit DB2 for the workstation

IBM DB2 Database for Linux, UNIX, and Windows (hereafter called DB2 for the workstation) V9.5 is
supported in 64-bit mode.
Separate DB2 for the workstation licensing no longer required: Since IBM Tivoli Monitoring now
includes an edition of DB2 for the workstation that does not require an activation CD or a separate product
registration, the separate DB2 licensing step is no longer required. The DB2 license file, db2ese_o.lic.txt,
has been removed from the distribution media.
Tivoli Data Warehouse now supports DB2 on z/OS

You can now create your Tivoli Data Warehouse repository using DB2 running on z/OS. While the
Warehouse Proxy agent still runs only on Windows, Linux, or UNIX, the data warehouse itself is stored in
DB2 on z/OS databases. Data communication is supported using either an ODBC or a JDBC connection.
Instructions for setting up your Tivoli Data Warehouse environment to run with a DB2 on z/OS repository
are provided in Chapter 17, Tivoli Data Warehouse solution using DB2 on z/OS, on page 373.
New schema publication tool simplifies generation of SQL statements needed to

create the Tivoli Data Warehouse
With the new schema publication tool, you can now generate the SQL statements needed to create the
database objects (data warehouse tables, indexes, functions, views, and ID table inserts) required for
initial setup of the Tivoli Data Warehouse. See Generating SQL statements for the Tivoli Data Warehouse:
the schema publication tool on page 340.
Tivoli Data Warehouse support for Solaris environments

The Warehouse Proxy agent now supports Solaris versions 9 and 10, along with support for Solaris zones.
16
Agentless monitoring of distributed operating systems now supported

IBM Tivoli Monitoring version 6.2.1 supports agentless monitoring of the distributed operating systems
(Windows, Linux, UNIX). The agentless monitoring software identifies and notifies you of common
problems with the operating system that it monitors, and includes monitoring, data-gathering, and
event-management capabilities for Windows, Linux, AIX, HP-UX, and Solaris.
Agentless monitoring versus monitoring agents on page 53 introduces the concept of agentless
monitoring and compares its advantages to the those of standard OS monitoring agents.
The tacmd createNode command need no longer be executed on the monitoring

server node
The command was changed in this release to execute through the remote-deployment infrastructure on
the Tivoli Enterprise Monitoring Server instead of executing locally. Thus you need no longer execute the
tacmd createNode command on the machine running the monitoring server.
Support for multiple remote Tivoli Enterprise Monitoring Servers on one Linux or
UNIX computer
You can now install and run multiple remote monitoring servers on a single Linux and UNIX node or LPAR;
see Linux or UNIX: Installing a remote monitoring server on page 160. Note, however, that you are still
restricted to a single hub monitoring server per computer or LPAR.
This enhancement does not apply to Windows nodes.
New in release 6.2.2

Contents of the Deployment Guide merged
The contents of the version 6.2 IBM Tivoli Monitoring: Deployment Guide have been merged into this
guide and the Deployment Guide eliminated.
v A new section, Part 2, Planning your IBM Tivoli Monitoring deployment, on page 25, has been created
to contain the Deployment Guide's three deployment chapters:
Chapter 2, Pre-deployment phase, on page 27
Chapter 3, Deployment phase, on page 69
Chapter 4, Post-deployment phase, on page 75
These chapters replace the single deployment chapter (Chapter 2, Planning your deployment) that this
guide used to contain, as they are more current and more complete.
v The Deployment Guide's tuning chapter, Chapter 14, Performance tuning, on page 299, has been
added to the end of Part 4, Post-installation configuration and customization, on page 259.
v The Deployment Guide's resources appendix, Appendix J, Additional resources, on page 599, has
been placed with the rest of the appendixes in this guide, after Appendix I, Documentation library, on
page 595.
Readers should find that this additional material provides vastly more-detailed information about deploying
and tuning their site's IBM Tivoli Monitoring environment.
Certain information unique to the former Chapter 2, Planning your deployment, has been moved to other,
relevant locations in this guide.
v The Tivoli Data Warehouse planning information, Planning considerations for the Tivoli Data
Warehouse on page 333, has been moved to the data warehousing section, in Chapter 15, Tivoli Data
Warehouse solutions, on page 331.
v The explanatory information about the agentless monitors, Agentless monitoring versus monitoring
agents on page 53, has been moved to the Agent deployments on page 51 discussion.
v Likewise, the event-integration scenarios for Tivoli Enterprise Console and Netcool/OMNIbus sites have
been moved near the tops of Event integration with Tivoli Enterprise Console on page 463 and
Chapter 22, Setting up event forwarding to Netcool/OMNIbus, on page 491.
17
Additional online user information while the Windows installer is running

Many of the installation tool's panels have been enhanced with a help facility that provides users with
additional information about the panel's purpose and parameters; see Figure 3 and Figure 4 on page 19.
Figure 3. Help button on the IBM Tivoli Monitoring installer's Select Features panel
18
Figure 4. Help button on the installer's Hub TEMS Configuration panel
In addition, progress bars have been added to many long-running processes (such as software installation
and the installation of language support) so users can see visually how these processes are progressing;
for an example, see Figure 5.
Figure 5. Status bar for the installer's software-installation phase
19
Embedded Java Runtime Environment now supported for Windows sites

The IBM Tivoli Monitoring installer no longer modifies the system JRE. It now installs its own local copy of
Java, one that is private to Tivoli Monitoring. This change applies to all Java-dependent Tivoli Monitoring
components, including those at a pre-6.2.2 level.
Users of Sun Java 1.6 can improve the performance of the Tivoli Enterprise Portal browser client
on Windows: A new plug-in architecture was introduced and established as the default plug-in for users
of Sun Java versions 1.6.0_10 or higher on Windows systems. This support enables an applet-caching
feature called legacy lifecycle that, coupled with use of the Sun 1.6 JRE, significantly increases
performance of the Tivoli Enterprise Portal browser client. Performance measurements using this
configuration show that, with legacy lifecycle, performance of the browser client is virtually identical to that
of the desktop and Java Web Start deployment modes.
Configuration changes are required to take advantage of this enhancement; see Support for Sun Java
1.6.0_10 or higher with browser clients on Windows on page 227.
New installation process for language packs

IBM Tivoli Monitoring Version 6.2.2 includes a new installer for the language packs; thus the instructions in
Installing language packs on page 218 have all been replaced.
New System Monitor Agents provide autonomous-only monitoring of your

operating system
In addition to the traditional operating system agents (the knt, klz, and kux agents that monitor the
Windows, Linux, and UNIX operating environments), IBM Tivoli Monitoring now includes System Monitor
Agents for customers who want fully autonomous monitoring of their operating systems in environments
where disk space or image transmission bandwidth is in short supply. Specifically, IBM Netcool System
Service Monitor customers may find these agents appropriate as an upgrade path. These new OS agents,
which offer a significant reduction in bundle size and installed footprint, provide SNMP event information
directly to an SNMP Event Collector such as IBM Tivoli Netcool/OMNIbus and are intended as
replacements for the OMNIbus System Service Monitor agents.
No other agents should be installed alongside these new System Monitor Agents, nor should they be
installed on nodes where there is already a Tivoli Monitoring agent in operation. Agents created with
version 6.2.2 (or subsequent) of the Agent Builder tool are the only exception to this rule.
To support these new System Monitor Agents, there is a new silent installation process; see Installing the
System Monitor Agent on Windows systems on page 517 and Installing the System Monitor Agent on
Linux or UNIX systems on page 522. There is also a new uninstallation process for the autonomous OS
agents; see Uninstalling the Windows System Monitor Agent on page 521 and Uninstalling the Linux or
UNIX System Monitor Agent on page 526.
Background information about agent autonomy on page 52 introduces the concept of agents that operate
autonomously (that is, without a connection to a Tivoli Enterprise Monitoring Server). For additional
information, see the IBM Tivoli Monitoring: Administrator's Guide.
Derby now supported as a portal server database

Version 6.2.2 includes an embedded version of the Apache Derby database server for default use as the
Tivoli Enterprise Portal Server database. (Note, however, that you can still use either DB2 Database for
Linux, UNIX, and Windows or Microsoft SQL Server as your portal server database if you choose and
have already installed them.) IBM Tivoli Monitoring implements Derby as an embedded database with its
portal server; in other words, the database is installed when installing the portal server, and it runs within
the portal server's Java virtual machine.
The embedded Derby database is intended for use only by small to medium-size businesses. It is not
intended for large IBM Tivoli Monitoring environments or for sites running a large number of Tivoli
20
Enterprise Portal clients. Derby has been tested with up to 20 portal clients, and it does require higher
CPU and memory usage than DB2 for the workstation.
The Tivoli Enterprise Portal Server uses the implementation of Derby that comes with eWAS; hence it is
supported on all platforms that support eWAS.
Note: If you transition from one supported database system to another for the Tivoli Enterprise Portal
Server, your existing portal server data is not copied from the first system to the new one.
More memory required to install and run the portal server: As a result of support for both an
embedded database and the eWAS server, the Tivoli Enterprise Portal Server's memory requirements
have increased substantially. The portal server now requires 650 MB if your site does not use the
embedded database, 1 GB if it does.
Common agent environment variables listed

A new appendix, Appendix E, Common agent environment variables, on page 571, lists all the variables
that define configuration parameters common to all IBM Tivoli Monitoring monitoring agents, including the
new environment variables that enable and control agent autonomy. (For complete information about agent
autonomy, see theIBM Tivoli Monitoring: Administrator's Guide.)
tacmd CLI commands now optional

The tacmd CLI commands (the KUI component of IBM Tivoli Monitoring) is being deprecated in favor of
the new Tivoli Enterprise Services User Interface Extensions (the new KUE component), as documented in
the IBM Tivoli Monitoring: Command Reference. These new user interface extensions are automatically
installed when you install the Tivoli Enterprise Portal Server after invoking the GUI installer.
Notes:
1. Though the tacmd commands have moved to a different component, KUE, and their packaging and the
means for installing them have both changed, the tacmd commands themselves have not changed.
2. When installing an OS agent using the silent-installation response file, you must explicitly install the
KUE component as well. This minimizes the size of the OS agent installation bundles.
Improved user control of agent or server restart after reconfiguration

After reconfiguring a running monitoring agent or Tivoli Enterprise Monitoring Server, you are now asked if
you want the agent or server restarted so your changes can take effect. Because it is not possible to
reconfigure a Tivoli Enterprise Portal Server while running, before reconfiguring it you are asked if you
want the portal server stopped; if you reply Yes, when the reconfiguration has completed, you are asked if
you want the portal server restarted.
Note: These restart options do not apply to either multi-instance agents or silent agent/server
reconfigurations.
A new column has been added to the Manage Tivoli Enterprise Monitoring Services main window:
Configuration. With this column you can keep track of agents whose configuration has changed but has
not yet been restarted. The Configuration column has the following possible values:
up-to-date
The agent is using the most recent configuration. In other words, either the agent was restarted after
the last reconfiguration or it is not running.
out-of-sync
The agent is not using the most recent configuration. In other words, the agent was not restarted after
the last reconfiguration.
N/A
Applies either to multi-instance agents (the restart options do not support multi-instance agents) or in
cases where IBM Tivoli Monitoring cannot determine the configuration state.
21
Note: When you install a multi-instance Agent Builder agent, you don't need to run a command to
configure it. You just need to provide the necessary .cfg file (if needed) and run the start
command: %CANDLE_HOME%\InstallITM\itmcmd.cmd agent start -o instance product_code
Dynamic affinity affects agent coexistence with prior releases

The introduction of dynamic affinity for operating system agents affects your ability to use newly installed
V6.2.2 agents with hub and remote Tivoli Enterprise Monitoring Servers and Tivoli Enterprise Portal
Servers built for prior releases. Before your site implements a V6.2.2 monitoring agent, you need to ensure
the monitoring server and the portal server (including the portal server's desktop clients) have been
upgraded to the V6.2.2 level.
The supported configurations are:
v Tivoli Monitoring V6.2.2 agents require a V6.2.2 hub monitoring server and portal server. The V6.2.1
hub monitoring server and portal server do not support V6.2.2 agents.
v The V6.2.2 CLI can connect only to a V6.2.2 hub monitoring server.
Notes:
1. If your site does not update its desktop clients, they will exhibit problems when using the Query and
Situation editors to modify the upgraded monitoring agents. In addition, the use of any V6.2.2
monitoring agents with a pre-V6.2.2 portal server means that workspaces will not be rendered
correctly.
2. V6.2.1 agents work with both V6.2.1 and V6.2.2 monitoring servers and portal servers.
New installation parameters protect your customized configuration settings: When adding an
agent's application support to the Tivoli Enterprise Monitoring Server, you are now asked to specify if you
want to add the default managed system groups to its situations. The All, New, and None selections allow
you to add the default managed system groups to all applicable situations, to only the ones being newly
seeded, or to none of them.
Higher versions of the Firefox browser supported for Windows customers

If your site uses Mozilla's Firefox browser to run the Tivoli Enterprise Portal browser client, you can now
use version 3.0.x as well as Firefox version 2.x. However, version 3.5.x is still not supported.
Simplified operating system selection for Linux and UNIX systems

Installers on Linux and UNIX systems are now presented the following selection screen when choosing the
IBM Tivoli Monitoring operating system components to install:
Product packages are available for this operating system and component support categlories:
1) IBM Tivoli Monitoring components for this operating system
2) Tivoli Enterprise Portal Browser Client support
3) Tivoli Enterprise Portal Desktop Client support
4) Tivoli Enterprise Portal Server support
5) Tivoli Enterprise Monitoring Server support
6) Other operating systems
Type the number of type "q" to quit selection
(Number "1" or "IBM Tivoli Monitoring components for this operating system" is the default value.)
This new screen makes it easier and less error-prone to install the appropriate components for the
operating system your current node is running.
To retrieve a list of other operating systems and releases, type 6.
New installation option allows you to retain your customized seeding files
As part of the conversion of the operating system monitoring agents to dynamically assigned affinities, you
now have the option, when adding their application support to the Tivoli Enterprise Monitoring Server, of
either using the supplied files or retaining and using the ones you have modified.
Also, remote seeding is now supported.
22
Automatic installation of application support for Linux/UNIX monitoring servers

You now have the option to seed the monitoring server's application support during agent installation. In
such cases, it is no longer necessary to manually seed the Tivoli Enterprise Monitoring Server after
installation or upgrade.
New silent-response files simplify agent installations and updates

You now have the option of generating a silent response file when you successfully configure an agent.
This response file can be used to install or deploy similar agents across the environment. This new option
significantly speeds up the creation of silent response files and reduces the chances of including incorrect
user input in a response file.
The response file can be generated from any successfully installed and configured agent.
Remote-deployment support extended to non-agent bundles

You can use new non-agent bundles to deploy components that need not connect to the Tivoli Enterprise
Monitoring Server. Using V6.2.2, you can remotely deploy these new non-agent bundles, similar to the
deployment of the agent bundles supported in prior releases.
Event integration of IBM Tivoli Monitoring with both IBM Tivoli Business Service
Manager and Netcool/OMNIbus now supported
For users of both Tivoli Business Service Manager and Netcool/OMNIbus, integration of Tivoli Monitoring
events is now supported for both products.
Upgrade procedure provided to Tivoli Event Synchronization V2.2.0.0: For users of Tivoli Event
Synchronization version 2.0.0.0, an upgrade procedure has been added that converts your existing
environment to V2.2.0.0.
OMEGAMON data warehouse migration tool no longer provided

OMEGAMON V350 and V360 customers who want to migrate their data warehouse to the new Tivoli Data
Warehouse can use the migration tool provided with prior versions of IBM Tivoli Monitoring. Version 6.2.2
no longer includes that migration tool.
New in release 6.2.2 fix pack 1

Native 64-bit operating system agents available for 64-bit Windows environments: A new OS
monitoring agent built as a native 64-bit binary is now available for sites that run 64-bit Windows Server
2003 or 2008 on x86-64 CPUs. If your site runs a 64-bit Windows operating system on such computers,
you may want to install the new 64-bit agent from the Agents DVD using the standard agent installation
process, via either the interactive installer or remote deployment. Their configuration is the same as the
32-bit Windows agent's.
To support mixed (that is, both 32-bit and 64-bit) agent environments on the same machine, you must
install the agent compatibility (AC) component, which contains both the 32- and 64-bit agent frameworks
and both the 32- and 64-bit GSKit libraries. The AC component is installed automatically when the installer
detects it is running in an environment that contains both 32-bit and 64-bit IBM Tivoli Monitoring
components. If the AC component is not installed, the installer will block the installation of either a 32-bit
agent into a 64-bit Tivoli Monitoring environment or a 64-bit agent into a 32-bit Tivoli Monitoring
environment.
Note: Installation of both the 32-bit and the 64-bit Windows agents on the same machine is not supported
and will be blocked.
Event forwarding by autonomous agents: Since Tivoli Enterprise Monitoring Agents and Tivoli System
Monitor Agents can now run completely independently of the IBM Tivoli Monitoring base servers (the Tivoli
Enterprise Monitoring Server and the Tivoli Enterprise Portal Server), these agents have now been
23
enhanced to enable them to directly forward events to either the Tivoli Enterprise Console or
Netcool/OMNIbus. This ensures events trapped by these monitoring agents do not get lost when you elect
to run them autonomously.
Support for DB2 Database for Linux, UNIX, and Windows version 9.7: Both the Tivoli Data
Warehouse and the Tivoli Enterprise Portal Server now support V9.7 of DB2 for the workstation.
Note: IBM Tivoli Monitoring V6.2.x still includes DB2 Workstation Server Edition V9.5 for use with the
portal server and the data warehouse.
New in release 6.2.2 fix pack 2

64-bit System Monitor Agent now supported for Windows environments: IBM Tivoli Monitoring now
provides native support for Windows-based (Windows 2003, Vista, 2008) System Monitor Agents running
on x86_64 CPUs in 64-bit mode.
Note: If you take advantage of this new feature, note that any agents built with the Agent Builder that you
install alongside the Windows System Monitor Agent must run in the same mode: a 32-bit Windows
agent requires Agent Builder-built agents that run in 32-bit mode, and a 64-bit Windows agent
requires Agent Builder-built agents that run in 64-bit mode.
Autonomous operation of the Warehouse Proxy agent and the Summarization and Pruning agent:
To enable autonomous agents to write out their accumulated historical data to the Tivoli Data Warehouse
without the intervention of the Tivoli Enterprise Monitoring Server and thereby prevent loss of such data,
the warehouse agents have been enhanced to allow them to run autonomously as well.
IP.UDP protocol no longer supported for communications between the monitoring server and the
portal server: IBM now discourages use of the User Datagram Protocol as a supported communications
protocol for the Tivoli Enterprise Portal Server.
32-bit DB2 for the workstation no longer required for the Tivoli Enterprise Portal Server: The portal
server's requirement for a 32-bit implementation of DB2 Database for Linux, UNIX, and Windows even
when running on a 64-bit Windows computer has been removed. The portal server now can use either a
32-bit or a 64-bit implementation of DB2 for the workstation.
Further enhancements to the autostart scripts: The behavior of the autostart scripts generated during
installation and configuration on UNIX platforms has evolved; see Changes in the behavior of the
autostart scripts on page 87.
Procedure for taking a snapshot of your Tivoli Enterprise Portal Server configuration settings now
documented: If your site runs multiple hub Tivoli Enterprise Monitoring Servers and thus needs to switch
the portal server from one hub to another, it is recommended you first take a snapshot of your site's
current portal server customizations. The procedure for creating this snapshot and for restoring it later,
Connecting the Tivoli Enterprise Portal Server on Windows to a different monitoring server on page 279,
has been added to Chapter 12, Additional Tivoli Enterprise Portal configurations.
Procedure for populating the data warehouse's ManagedSystem table now documented: If your
site runs the Tivoli Data Warehouse, you must update its ManagedSystem table each time you add one or
more monitoring agents to your site's Tivoli Monitoring environment; this is accomplished via the
populate_agents.sql script. The procedures for invoking this script in a DB2 for the workstation, SQL
Server, or Oracle environment have been added to Chapter 8, Installing IBM Tivoli Monitoring in a new
subsection, Populating the data warehouse's ManagedSystem table on page 192.
24
Part 2. Planning your IBM Tivoli Monitoring deployment

This section contains information that assists you in assessing your environment and planning the
deployment of product components. The successful use and availability of your IBM Tivoli Monitoring
environment is the result of a well-planned and executed deployment. This section guides you through the
deployment process for Tivoli Monitoring; it is divided into the following chapters:
v Chapter 2, Pre-deployment phase, on page 27 helps you plan for your installation. This chapter also
provides you with an overview of the Tivoli Monitoring components, network considerations, sizing
scenarios, platform support, as well as task and staffing estimates.
v Chapter 3, Deployment phase, on page 69 contains information, procedures, configuration, and
reference documents to ensure a successful deployment of your Tivoli Monitoring environment.
v Chapter 4, Post-deployment phase, on page 75 provides you with the maintenance steps needed to
ensure that your Tivoli Monitoring environment stays up and running. This chapter also provides you
with daily, weekly, monthly, and quarterly health check procedures.
Web Access for Information Management, and others. Much of the information in this guide is also
relevant to these products.
25
26
Chapter 2. Pre-deployment phase

Correctly planning your installation is probably the most important thing that you can do to achieve a
smoothly running environment. By carefully planning the size of your servers, understanding your network
topology, and understanding your key requirements, you can create a monitoring environment that meets
your needs.
Careful planning is a team effort. Engage the networking team to ensure you understand all of the network
firewall configurations and to open ports in the firewall. Understand the key requirements such as fault
tolerance, executive dashboards, and reporting. The following sections outline the key planning items that
you must complete to have a successful deployment.
Planning checklist
Use the Planning checklist in Table 2 to ensure that all important planning tasks are accomplished.
Perform all of these tasks before starting your Tivoli Monitoring installation. The following sections of this
guide provide the necessary information to complete this checklist.
Table 2. Planning checklist
Planning activity
Comments
Status
Attend IBM Tivoli Monitoring

Administrator Training.
Sample: 2 people attended Administrator class
Sample: Complete
Determine the desired platforms for

Tivoli Monitoring infrastructure
components.
See Hardware and software requirements on page

96.
Identify the number of Tivoli Monitoring

agents (typically 3 monitoring agents
per monitoring server).
Determine high availability and disaster
recovery requirements. Map those
requirements to your Tivoli Monitoring
deployment.
Determine whether a firewall gateway is
required and between which
components.
Determine the location of any remote
monitoring servers.
Determine that an adequate number of
Warehouse Proxy agents are planned.
Provide Network administrators with a
list of ports to open.
Complete the Warehouse load
projection spreadsheet. See Locating
and sizing the Warehouse Proxy agent
on page 42.
Determine the hardware required for
your Tivoli Monitoring components.
Download all the required software for
your supported operating systems
including all monitoring agents.
Complete your deployment Verification
Test Plan.
27
Table 2. Planning checklist (continued)

Planning activity
Comments
Status
Review the Readme and

Documentation Addendum and
determine the installation steps based
on your platform.
Determine the method of user
authentication. See paragraphs below.
Tivoli Monitoring V6.2.2 supports integration with LDAP user registries for authentication. See Security
options on page 93 for more information.
LDAP SSL requires some actions by an LDAP administrator that are not covered by the Tivoli Monitoring
V6.2.2 documentation. Here are some LDAP SSL Web pages for working with LDAP servers:
v Configuring Microsoft Active Directory for SSL access
v Configuring Sun Java System Directory Server for SSL access
v Configuring the Tivoli Directory Server client for SSL access
v LDAP SSL will also require creating a GSKit keystore; see the IBM Global Security Kit Secure Sockets
Layer and iKeyman User's Guide
Understanding Tivoli Monitoring and your network

For all successful deployments, you must understand the network infrastructure. When planning your Tivoli
Monitoring deployment, take into account each of the following important factors, which are discussed in
further detail in this guide:
v Locations of firewalls
v Whether you have NAT (network address translation)
v Network bandwidth between WAN (wide area network) links
v Number of agents that are located across WAN links
Tivoli Monitoring has several options for the communication protocols that are used by the product
components. The IP PIPE and IP SPIPE are the protocols used when firewalls are used in the
environment. Unlike the IP UDP (TCP) protocol, the communications for IP PIPE and IP SPIPE can be
restricted to a single port.
28
Figure 6. Tivoli Monitoring V6.2.2 communications model
The default port for SSL communication is 3660/TCP. (For non-SSL communication the default port is
1918/TCP.)
Determine if you require a firewall gateway

For most environments, using the firewall gateway is not required when deploying the Tivoli Monitoring
software. However, in some cases, the firewall gateway is the only way to traverse the complex firewalls in
a network. The following section describes the scenarios when the firewall gateway is required. In addition,
the section outlines the optimal locations for the firewall gateway.
Use the firewall gateway for any of the following scenarios:
v A single TCP connection cannot be made to span between Tivoli Monitoring components. One example
is when there are multiple firewalls between these components and a policy that does not allow a single
connection to traverse multiple firewalls.
v Connection requirements do not allow the Tivoli Monitoring default pattern of connections to the hub
Tivoli Enterprise Monitoring Server. One example is when agents that are located in a less-secure zone
connect to the monitoring server located in a more-secure zone. Security policy allows a connection to
be established only from a more-secure zone to a less-secure zone, but not the other way round.
v You must reduce open firewall ports to a single port or connection. For example, rather than opening
the port for every system being monitored, consolidate the ports into a single concentrator.
v You must manage agent failover and Tivoli Enterprise Monitoring Server assignment symbolically at the
hub monitoring server end of the gateway. Because gateway connections are made between matching
service names, an administrator can change the failover and monitoring server assignment of
downstream gateway agents by changing the client proxy bindings next to the hub monitoring server.
Network address translation (NAT) alone is not a reason to use the firewall gateway, which is
content-neutral and can proxy any TCP connection. In most cases, NAT processing can be handled by the
PIPE protocol (IP.PIPE or IP.SPIPE) without the firewall gateway.
For detailed information on installing and configuring the firewall gateway, see Appendix C, Firewalls, on
page 551.
29
Determine where to place your Tivoli Monitoring components

There are a few factors to consider when determining the location of your Tivoli Monitoring components.
The primary factors are firewalls and slow network connections. Before discussing the locations of these
components in the data center, you must understand these components, the roles that they play, and what
affects the load on these components.
The Tivoli Monitoring components and data paths to the Tivoli event management products are illustrated
in Figure 7.
Figure 7. Tivoli Monitoring component architecture including firewall gateway
Tivoli Monitoring installation requires the following optional and mandatory components:
v Tivoli Enterprise Monitoring Server on page 31
v Tivoli Enterprise Portal Server on page 32
v Tivoli Enterprise Portal client on page 33
v Warehouse Proxy agent on page 35
v
v
v
v
v
v
v
Warehouse Summarization and Pruning agent on page 35

Tivoli Data Warehouse on page 36
Monitoring agent for IBM Tivoli Monitoring 5.x Endpoint on page 36
Tivoli Enterprise Console integration on page 36
Netcool/OMNIbus integration on page 36
Firewall gateway on page 37
IBM Tivoli Universal Agent on page 37
The specific hardware and software prerequisites for each of these components are listed in Hardware
and software requirements on page 96.
30

The Tivoli Enterprise Monitoring Server, referred to as the monitoring server, is the first component
installed to begin building the IBM Tivoli Monitoring Services foundation. The monitoring server is the key
component on which all other architectural components directly depend. The monitoring server is the
collection and control point for alerts received from agents. The monitoring server collects the performance
and availability data of the agents.
The monitoring server is also responsible for processing heartbeats to track the online or offline status of
monitoring agents. A monitoring agent sends a heartbeat every 10 minutes (this is configurable). If a
heartbeat signal is not received from an agent within the heartbeat interval (plus a 3-minute grace period),
the monitoring server considers the monitoring agent to be offline. The online or offline status of the
monitoring agent is also called the managed system status.
In addition to the roles described in the previous paragraphs, the hub monitoring server also provides the
following functions:
v Distributes situations down to the monitoring agents.
v Used for remote deployment and remote configuration and control of monitoring agents.
v Responsible for the processing of CLI and SOAP requests that can be used by users for automation of
their Tivoli Monitoring environment.
There are two types of monitoring servers: the hub monitoring server and the remote monitoring server.
The hub monitoring server is the focal point for the entire Tivoli Monitoring environment. The hub
monitoring server is under a significant load. Work on the hub includes connections from the remote
monitoring server, authentication, situations, policies, and workflows.
The hub monitoring server stores, initiates, and tracks all situations and policies and is the central
repository for storing all active conditions and short-term data on every Tivoli Enterprise Monitoring Agent
(monitoring agent). The hub monitoring server is also responsible for initiating and tracking all generated
Take Action commands.
The monitoring server storage repository is a proprietary database format, referred to as the Enterprise
Information Base (EIB), that is grouped as a collection of files located on the monitoring server. These files
start with a file name prefix qa1 and are located in the following directories:
v On Windows: installation_dir/cms
v On UNIX and Linux: installation_dir/tables/tems_name
where installation_dir specifies the Tivoli Monitoring installation directory and tems_name specifies the
Tivoli Enrerprise Monitoring Server name.
Note: You can use the CANDLEHOME command on UNIX or Linux and CANDLE_HOME on Windows
system to locate the home directory for Tivoli Monitoring.
Place the hub monitoring server inside the data center on a high-performance network (100 Megabits per
second or higher). Connectivity between the Tivoli Enterprise Portal Server and hub monitoring server as
well as between the hub monitoring server and most of the remote monitoring server must be fast and
reliable. For large environments, use a multi-processor server. Some hardware configuration guidance is
identified in Sizing your Tivoli Monitoring hardware on page 39.
The remote monitoring server is a collection point for the agents that are connected to that remote
monitoring server. Certain types of situations run on the remote monitoring server. The load on the remote
monitoring server is typically low. Load is driven higher if historical data is collected at the remote
monitoring server instead of at the agents.
31
Placement of the remote monitoring server depends on a few factors. Plan your firewalls early to ensure
that communications can be established between the Tivoli Monitoring components with only a modest
number of holes in the firewall.
By locating the Warehouse Proxy agent on the same computer as the remote monitoring server, you can
negotiate NAT environments with their historical data collection. For remote locations connected over a
slow network, place the remote monitoring server at the remote location if there are significant numbers of
computers. For remote locations with just a few computers, it doesnt make sense to place a remote
monitoring server at the remote location.

The Tivoli Enterprise Portal Server, referred to as the portal server, is a repository for all graphical
presentation of monitoring data. The portal server database consists of all user IDs and user access
controls for the monitoring workspaces. The portal server provides the core presentation layer, which
allows for retrieval, manipulation, analysis, and pre-formatting of data. The portal server manages data
access through user workspace consoles.
The portal server keeps a persistent connection to the hub monitoring server, and can be considered a
logical gateway between the hub monitoring server and the Tivoli Enterprise Portal client (portal client).
Any disconnection between the two components immediately disables access to the monitoring data used
by the portal client.
Locating the portal server in the same LAN segment as the hub monitoring server provides optimal
performance when using the Tivoli Enterprise Portal graphical user interface (GUI). For users with multiple
data centers, if the network connectivity is good, then one portal server is sufficient. If the network
connection between data centers has significant latency, then additional portal servers can be placed at
each data center.
Caution must be taken when using this approach because there can be only one read-write master portal
server. Other portal servers must be used in a read-only manner. Read-only means that users must not
create and edit objects like situations, workspaces, and policies. Customization must be replicated from
the master portal server to the read-only portal server.
When you install the portal server, a proprietary integrated Web server is installed for use with the portal
client in browser mode. Depending on the network topology and possible security implications, this can
affect the construction of the solution. To avoid security issues, you may install an external Web server on
the same computer where you installed the portal server. If there will be more than ten concurrent portal
clients connected to the portal server, an external Web server can improve scalability of the portal server.
For additional details, refer to Configuring an external Web server to work with Tivoli Enterprise Portal on
page 282.
32
Figure 8. Multiple data center environment
Tivoli Enterprise Portal client

The Tivoli Enterprise Portal client, also known as the portal client, is a Java-based user interface that
connects to the portal server to view all monitoring data collections. The portal client is the user interaction
component of the presentation layer. The portal client brings all of these views together in a single window
so you can see when any component is not working as expected. The client offers three modes of
operation, that all work with Java:
v Browser client
v Desktop client
v Java Web Start client
See Table 4 on page 45 for more information.
The browser client is automatically installed with the Tivoli Enterprise Portal Server (on the Web server
that is integrated with the portal server). The desktop client is supported on Windows and Linux operating
systems. You can install the desktop client from the IBM Tivoli Monitoring installation media or you can use
IBM Web Start for Java to download the desktop client from the Tivoli Enterprise Portal Server. To find out
what browsers are supported see the Platform support matrix.
33
Using browser mode or Web Start clients allow you to perform maintenance updates in a single location. If
the desktop client is installed from installation media, maintenance must be installed on each computer. If
Web Start for Java is used to download and run the desktop client, you gain the performance advantage
of the desktop client along with the convenience of centralized administration from the server. Additional
performance gains can be made by modifying the Java heap settings. (For more details on the heap
settings see Locating and sizing the portal client on page 45.) Unless you want a very secure
environment where there are no downloads, use IBM Web Start for Java for obtaining the desktop client.
Note: To use Java Web Start to download the desktop client from the Tivoli Enterprise Portal Server, IBM
Runtime Environment for Java 2, version 5.0 (also referred to as IBM JRE version 1.5) must be
installed on the system to which you are downloading the client.
Many customers install the desktop client on Citrix for the following reasons. Citrix allows for better GUI
performance for users at remote locations. In addition, some users do not allow the Tivoli Enterprise Portal
client's prerequisite Java version to be installed on desktop computers. By using Citrix, users do not have
to install Java on the user's desktop systems.

Monitoring agents are installed on the system or subsystem that requires data collection and monitoring.
Monitoring agents are responsible for gathering data on various properties, or attributes, of a monitored
system, subsystem, application, or database, the managed system, and for sending that data to the
monitoring servers. Monitoring agents test for specified conditions, or situations, by periodically comparing
attribute values against specified thresholds. When the tested values match or exceed the thresholds,
monitoring agents notify the monitoring server, and alert are displayed in the portal client.
The following scenarios prompt the monitoring server to gather data samples from the agents:
v Opening or refreshing a workspace that has data views (table or chart views):
When a Tivoli Enterprise Portal workspace is opened or refreshed, the portal server sends a sampling
request to the hub monitoring server. The request is passed directly to the monitoring agent, if there is a
direct connection, or indirectly through the remote monitoring server to which the monitoring agent
connects. The monitoring agent takes a data sampling and returns the results through the monitoring
server and portal server to the portal workspace.
v The sampling interval for a situation (a test taken at your monitored systems):
A situation can have a sampling interval as frequent as once every 30 seconds or as seldom as once
every three months. When the interval expires, data samples are requested from the agent in which the
returned values are compared with the condition described in the situation. If the values meet the
condition, an event is generated and corresponding alerts or automation are initiated.
v Monitoring agents are configured to collect historical data:
The collection of historical data can be configured to send the data to the remote monitoring server at
regular intervals or, transfer data collections from the agent to the Warehouse Proxy agent at hourly or
daily intervals. If firewall restrictions are disabled or minimal, configure all of the agents to transfer
directly to Warehouse Proxy agent. If firewall security is an issue, you can either use the firewall
gateway or place the Warehouse Proxy agent on the remote monitoring server where a network
connection is already established.
Typically, there are no unique considerations regarding the placement of monitoring agents. The main
consideration is whether to store historical data on the agent or on the remote monitoring server. For
environments with slow network connections between the agent and the remote monitoring server, storing
the data on the monitoring server spreads out the network load of transmitting the historical data. Doing
this places a higher demand on the remote monitoring server, and effectively lowers the number of agents
that can be managed from the remote monitoring server.
For short-term historical requests of agent data less than 24 hours, the request does not have to cross the
slow link, but this savings is offset by the remote monitoring server having to read a larger amount of data
from disk (from all agents of that agent type connected to the remote monitoring server) to find the results
34
for the desired agent. For environments with network events that cause agents to failover to a secondary
monitoring server, this option may be a poor choice. When an agent fails over, it loses access to the
short-term historical data because the data is located on the primary remote monitoring server and the
agent is connected to the backup remote monitoring server.
By installing the operating system agent on the system first, the remaining agents can be deployed
remotely using the Add agent capabilities.
Warehouse Proxy agent

The Warehouse Proxy agent is a unique agent that performs only one task: collecting and consolidating all
historical data from the individual agents to store in the Tivoli Data Warehouse. If you are using the Tivoli
Data Warehouse, at least one Warehouse Proxy agent is required for each Tivoli Monitoring installation.
The Warehouse Proxy agent uses ODBC (open database connectivity) on Windows and JDBC (Java
Database Connectivity) on AIX and Linux to write the historical data to a supported relational database.
The Warehouse Proxy agent is typically placed on the same LAN segment as the warehouse database,
which allows for the best throughput to the database. You can also place the Warehouse Proxy agent on
the same server as the warehouse database.
For larger environments or deployments with multiple data centers, use multiple Warehouse Proxy agents.
You can have as many as one Warehouse Proxy agent per monitoring server in your monitoring
environment. Placing the Warehouse Proxy agent on the same server as the remote monitoring server
reduces the number of servers running Tivoli Monitoring components. This placement also simplifies the
configuration because the Warehouse Proxy agent can be configured to service agents connected to the
local monitoring server. If the server running the remote monitoring server goes down and the agent fails
over to a secondary monitoring server, the agent should be able to upload historical data through the
Warehouse Proxy agent on the secondary monitoring server. This placement also has the advantage of
limiting the number of agents that upload historical data through a single Warehouse Proxy agent.
NAT environments require specific considerations. The agents receive the IP address of the Warehouse
Proxy agent from the monitoring server. In a NAT network, you must ensure that the agents receive the
correct IP address of the Warehouse Proxy agent. To ensure that the agents can communicate with the
Warehouse Proxy agent, place the Warehouse Proxy agent on the same servers as the remote monitoring
server. This placement is required only for the agents that are connected to a NAT network.
For information on configuring the historical collection, see the IBM Tivoli Monitoring: Tivoli Enterprise
Portal User's Guide.
Warehouse Summarization and Pruning agent

The Summarization and Pruning agent is a unique agent that performs the aggregation and pruning
functions for the historical detailed data on the Tivoli Data Warehouse. The Summarization and Pruning
agent has advanced configuration options that enable customization of the historical data storage. One
Summarization and Pruning agent manages the historical data in the Tivoli Data Warehouse.
The Summarization and Pruning agent can be placed on the Tivoli Data Warehouse database server to
minimize network transmission delay during its processing. If the Summarization and Pruning agent is
placed on a separate server, ensure that it connects to the database server with a high-speed network
connection of 100 Megabits per second or higher. For large environments, the database server must have
at least four processors and a large number of disks, with maintenance by a skilled database
administrator.
Performance enhancements were added into the Summarization and Pruning agent for the IBM Tivoli
Monitoring V6.2.1 release. Some of the enhancements require a new database schema. The warehouse
will function without the schema changes, but will not take advantage of some of the performance
improvements. For the enhancements that do not require a new schema, there are minor database
changes that are documented in Generating SQL statements for the Tivoli Data Warehouse: the schema
35
publication tool on page 340. In a new Tivoli Monitoring environment, the warehouse database schema
will be created using the new schema. If the Tivoli Monitoring V6.2.2 environment was updated, the
database will continue to use the old schema and will not benefit from the improvements. If you want to
take advantage of the performance improvements in an upgraded environment, you will need to create a
new warehouse database with a new schema. If desired, you can migrate the data from your old
warehouse database into your new warehouse database.

The Tivoli Data Warehouse is the storage database that contains all of the warehoused (long-term)
historical data. A Warehouse Proxy agent must be installed to leverage the Tivoli Data Warehouse function
within the environment. In large-scale deployments, a Tivoli Data Warehouse can be shared among
monitoring installations.
Monitoring agent for IBM Tivoli Monitoring 5.x Endpoint

Also called IBM Tivoli Monitoring 5.x Endpoint Agent, this integration agent enables the collection and
visualization of IBM Tivoli Monitoring 5.x resource models in the Tivoli Enterprise Portal. The visualization
is the direct replacement for the Web Health Console.
Additionally, the agent provides the roll-up function of IBM Tivoli Monitoring 5.x metrics into the Tivoli Data
Warehouse.
Tivoli Enterprise Console integration

Tivoli Enterprise Console events can be forwarded from Tivoli Monitoring V6.2.2 to Tivoli Enterprise
Console Version 3.9. The events are forwarded from the hub monitoring server to the Tivoli Enterprise
Console server or Tivoli Enterprise Console gateway. Make sure that firewall ports are opened between
the hub monitoring server and Tivoli Enterprise Console servers. By default, the Tivoli Enterprise Console
uses port 5529.
The Tivoli Enterprise Console event synchronization component sends updates to situation events back to
the monitoring server and are then forwarded to the portal server. Actions performed at the Tivoli
Enterprise Console for Tivoli Monitoring situations are reflected in the Tivoli Enterprise Portal Server, this is
an optional component that must be installed on your Tivoli Enterprise Console server.
For information on forwarding events to Tivoli Enterprise Console and installing the event synchronization
component, see Chapter 21, Setting up event forwarding to Tivoli Enterprise Console, on page 463..
Netcool/OMNIbus integration
If you are already using Netcool/OMNIbus to monitor events from other sources in your enterprise, you
can also view and manage situation events from a Tivoli Enterprise Monitoring Server in the
Netcool/OMNIbus console. Event integration requires Netcool/OMNIbus V7.x and Netcool/OMNIbus V7.x
Probe for Tivoli EIF.
Situation events are sent to Netcool/OMNIbus Probe for Tivoli EIF using the Tivoli Event Integration Facility
(EIF) interface. The Netcool/OMNIbus EIF Probe receives events, maps them to the Netcool/OMNIbus
events format, and then inserts into Netcool/OMNIbus ObjectServer. When an Netcool/OMNIbus user
acknowledges, closes, or reopens a situation event, Netcool/OMNIbus sends those changes to the
originating monitoring server through the event synchronization component.
For information on forwarding events to Netcool/OMNIbus and installing the event synchronization
component, see Chapter 22, Setting up event forwarding to Netcool/OMNIbus, on page 491.
By default, the EIF Probe listens on the default port (5529).
36
Firewall gateway
Using the firewall gateway, you can traverse even the most complex firewalls. Using the IP PIPE or IP
SPIPE protocols, the Tivoli Monitoring software can traverse most firewall configurations. In most cases,
the firewall gateway is not necessary.
For detailed information on installing and configuring the firewall gateway, go to Appendix C, Firewalls, on
page 551.

The Tivoli Universal Agent is a customizable agent that allows you to monitor many different types of
hardware, operating systems, and applications. The Tivoli Universal Agent has several different data
providers that collect metric data. Some of the data providers gather data from a source running locally on
the server (Script, File) while others (ODBC, SNMP, Socket, API, Post) collect data either locally or
remotely.
From a networking and connection perspective, there are two aspects to the placement of a Tivoli
Universal Agent. The Tivoli Universal Agent connects into a monitoring server just like any monitoring
agent. You can use any of the supported protocols such as IP.UDP and IP.PIPE. In addition, for the data
providers with remote monitoring capabilities, you must consider the network connection between the Tivoli
Universal Agent and the monitored system. Each data provider uses a different access method, so you
must consider different ports and protocols.
For optimal performance, place the Tivoli Universal Agent in close LAN proximity to the computer that is
gathering the data. Some Universal Agents are very lightweight and can be configured to remotely monitor
over slower WAN links. Other Universal Agents gather large volumes of data and can be run only on a
LAN environment. As you create your custom monitoring solution, calculate the expected network traffic by
examining the metrics being collected and the data collection interval.
For more information about the Tivoli Universal Agent, refer to the IBM Tivoli Monitoring: Agent Builder
User's Guide.
IBM Tivoli Agent Builder

The Agent Builder, introduced in IBM Tivoli Monitoring V6.2, is a wizard that makes it easier to build
custom monitoring solutions. Using mostly point and click capabilities, the Agent Builder allows you to
create a monitoring agent using multiple data providers such as WMI, Perfmon, Log scraping, scripts, and
process monitoring. Over time additional data providers will be added to the Agent Builder.
Monitoring agents created using the Agent Builder have two advantages over agents based on the Tivoli
Universal Agent. First, the Agent Builder monitoring agents tend to run with lower CPU utilization than an
equivalent Tivoli Universal Agent. Second, you do not need to worry about Tivoli Universal Agent
versioning.
However, the Agent Builder is not a complete replacement for the Tivoli Universal Agent. The Tivoli
Universal Agent has some key capabilities that Agent Builder monitoring agents do not have. For example,
the Tivoli Universal Agent has an ODBC data provider; the Agent Builder does not. A single Tivoli Universal
Agent can be configured to monitor multiple remote systems, using several types of data providers. The
Agent Builder can be configured to monitor multiple remote systems, but you must create one agent
instance for each remotely monitored server.
For more information about Agent Builder, refer to the IBM Tivoli Monitoring: Agent Builder User's Guide.
Note to Windows users: Since the introduction of the Embedded Java Runtime and the Tivoli Enterprise
Services User Interface Extensions (the KUE component) at IBM Tivoli
Monitoring V6.2.2, the possibility has existed that, on nodes where only the
Windows OS agent was installed, the Embedded Java Runtime and the User
Interface Extensions were not also installed. If you later attempt to install an
37
Agent Builder agent on such nodes, you may receive the error shown in
Figure 25 on page 189. If this happens, complete the procedure outlined in
Installing the Embedded Java Runtime and the User Interface Extensions on
page 189, and retry the agent installation.
Additional ports used in the Tivoli Monitoring environment

If multiple components are installed on the same server, they may not share the same port number for IP
PIPE or IP SPIPE communications. A scheme has been created to use additional ports for
communications. The following section identifies the additional ports that are used.
In a typical environment, a user might have three monitoring agents that are located on a system. Each
monitoring agent must use a unique port to ensure there are no communications conflicts. Tivoli Monitoring
uses a methodology involving SKIP and COUNT to assign the ports. On a typical server with three
monitoring agents, Tivoli Monitoring assigns ports 1918, 6014, 10110 to the three monitoring agents. The
first monitoring agent to start uses port 1918, the second will use 6014, and the third will use 10110. If
additional monitoring agents are installed and started, there will be additional ports assigned to those
monitoring agents. A detailed explanation of the port assignments is described in the following paragraphs.
In environments behind firewalls it is critical that the Warehouse Proxy agent listens on the same port
every time the monitoring agent is started. This setup allows you to specify a port such as 6014 for
communications between the monitoring agents and the Warehouse Proxy agent. To guarantee that port
6014 is available for the Warehouse Proxy agent, all monitoring agents running on the same server must
use the Skip Count mechanism to specify a specific port. This ensures that port 6014 is available to the
Warehouse Proxy agent no matter what order the monitoring agents start.
Note: You are not required to use port 6014 for the Warehouse Proxy agent, but this is the most
commonly used port.
Understanding COUNT and SKIP options

COUNT:N is the mechanism for reserving IP.PIPE ports, where N is the number of IP.PIPE ports to
reserve on a host, in addition to the monitoring server well-known port. COUNT:N accommodates multiple
Monitored components on a single host in addition to the monitoring server. Monitoring servers with
COUNT:N configured are assumed to require one of the N reserved ports. Monitoring components with
SKIP:N+1 are assumed to not require one of the N reserved ports.
Note: When the IP.PIPE is referenced in this guide, the component uses TCP. If your site is using
IP.PIPE, be aware of the following limitations:
v There can be at most 16 IP.PIPE processes per host.
v IP.PIPE uses one, and only one, physical port per process. Port numbers are allocated using a
well-known port allocation algorithm. The first process for a host is assigned port 1918, which is
the default.
v KDC_PORTS is not supported for IP.PIPE.
If KDC_FAMILIES=IP.PIPE COUNT:1, then you expect to allocate port (the Well-known-port + (4096 * (1)))
or fail.
If KDC_FAMILIES=IP.PIPE COUNT:2, then you expect to allocate port (the Well-known-port + (4096 * (1)))
or (the Well-known-port + (4096 * (2))) or fail.
If you need to reserve N ports (in addition to the well-known monitoring server port), then all servers on
this host that are not permitted in the reserved range should specify SKIP:N+1 and all the servers on this
host permitted in the reserved range should specify COUNT:N.
If you have KDC_FAMILIES=IP.PIPE SKIP:1, then the first port you want to use is (Well-known-port +
4096 * (1)) and you continue to try until you contact one or run out of ports to try.
38
If you have KDC_FAMILIES=IP.PIPE SKIP:2, then the first port you want to use is (Well-known-port +
4096 * (2)) and you continue to try until you contact one or run out of ports to try.
As an example, assume that you have the following scenario:
v A Windows system inside a firewall.
v You expect to run a monitoring server, monitoring agent, and a Warehouse Proxy agent on this system.
v The monitoring server and the Warehouse Proxy agent must be accessible from outside the firewall.
Accessibility from outside the firewall means that you require IP.PIPE ports that must be permitted at the
firewall, thus, these ports must be predictable.
Given this scenario, and to allow for the accessibility, one IP.PIPE port requires reservation and firewall
permission in addition to the monitoring server. The monitoring server always receives the well-known port
by default. The Warehouse Proxy agent requires KDC_FAMILIES=IP.PIPE COUNT:1 and the monitoring
agent requires KDC_FAMILIES=IP.PIPE SKIP:2 to make the necessary reservations for the Warehouse
Proxy agent. And if the monitoring server's well-known port is 1918, then the Warehouse Proxy agent is
assigned port (1918 + (4096 *(1)) 6014. The monitoring agent attempts to listen on port (1918 + (4096
*(2)) 10110.
The Warehouse Proxy agent port is reserved only on 6014 if keyword KDC_FAMILIES is used in
conjunction with the following COUNT option:
v COUNT specifies the number of offsets that the agent can use to retrieve a reserved port number.
v COUNT:N means that all offset ports calculated by the following formula starting from 1 up to N are
allowed and the first free one is used:
Well-known port 1918 + (X * 4096) for X ` {1,..,N}
v COUNT:1 means that only 1918+(1*4096)=6014 is used, thus the proxy port is fixed. For example:
KDC_FAMILIES=IP.PIPE COUNT:1 PORT:1918 IP use:n SNA use:n IP.SPIPE use:n
If other Tivoli Monitoring components, such as the Tivoli Universal Agent, portal server, and other
components, are running on the same system, the SKIP option must be used to instruct these components
to skip some reserved ports:
v SKIP:N+1 means that only offset ports starting from multiplier N+1 are allowed:
Well-known port 1918 + (X * 4096) for X ` {N+1,N+2,..,max_port_high}
v SKIP:2 allocates 1918+(2*4096)=10110 as the first port and there is no proxy port conflict. For example:
KDC_FAMILIES=IP.PIPE SKIP:2 PORT:1918 IP use:n SNA use:n IP.SPIPE use:n
Configuring your firewalls

IBM Tivoli Monitoring has a firewall gateway component that allows you to traverse even the most complex
firewalls. Figure 6 on page 29 outlines the ports and communications that must occur between the various
Tivoli Monitoring components, and shows an example for a typical environment using IP.PIPE. If you are
using IP.SPIPE, the diagram would look similar, but port 3660 would be used instead of 1918. The same
skip counts apply as described in Additional ports used in the Tivoli Monitoring environment on page 38,
but the initial port number is 3660.
Sizing your Tivoli Monitoring hardware

The following section outlines hardware scenarios for Tivoli Monitoring environments of various sizes.
These are rough guidelines based on typical deployments. Because Tivoli Monitoring is highly
customizable, this section also outlines some usage scenarios that drive additional load and might indicate
different hardware requirements.
Part 3, Installation and initial configuration of base components and agents, on page 81 has a section
describing the hardware requirements for the Tivoli Monitoring infrastructure components, including the
39
processor, memory and disk requirements. The guidelines below are based on typical deployments, and
supplement the hardware requirements described in Hardware and software requirements on page 96.
Locating and sizing the hub Tivoli Enterprise Monitoring Server

Always locate the hub monitoring server in a data center with good network reliability and throughput.
Network connection speeds of 100 Megabits per second or higher are typically sufficient.
Except where noted, the server sizings assume that the hub monitoring server is installed on a separate
server with no additional Tivoli components. Below are some basic guidelines. For detailed guidelines, see
Hardware and software requirements on page 96.
Sizing your hub monitoring server hardware
Large environments (>2000 agents)
Run the hub monitoring server on its own fast dual-processor server. The server requires a
minimum of 1 GB of total system memory. Intel processors should be 3 GHz or higher; RISC
processors should be 1.5 GHz or higher.
Medium-sized environments (500-2000 agents)
Although the steady-state CPU utilization is usually low, the hub monitoring server uses a
significant amount of system resources in processing transient workloads, such as startup, agent
login, and situation distribution. A single processor system is adequate for the hub monitoring
server, but a dual processor server can help during peak transient loads. It is reasonable to run
other Tivoli Monitoring components on the same server such as the portal server, but allocate
additional CPUs for the additional components. Assign a minimum of 1 GB of total system memory
to the hub monitoring server.
Small environments (200-500 agents)
It is reasonable to combine components such as the monitoring server and portal server on a
dual-processor server. With more than 200 agents, install one or more remote monitoring servers
and offload some of the work of the hub monitoring server. When combining monitoring
components on a single server, the different components' process memory requirements should be
added together. See Memory and disk requirements on page 110 for more information.
Very small environments (<200 agents)
For environments with 200 or fewer agents, most of the components can be combined onto a
single server. If you are going to use a small monitoring environment, choose a multiprocessor (2
or 4-way) for the monitoring server with at least 2 GB of total system memory. Configure the
software and begin monitoring CPU and memory usage during periods of both normal and high
volumes of situation events. If CPU or memory usage is constrained, consider deploying a
separate server for the Tivoli Data Warehouse, the Warehouse Proxy agent, and the
Summarization and Pruning agent. For more information see Memory and disk requirements on
page 110.
When to use multiple hub monitoring servers
As environments grow in size, you must run multiple hub monitoring servers. The maximum limit for the
number of agents for each hub monitoring server environment is 10000.
There are many factors that affect the scalability of a hub environment. The primary factors are network
latency, number of situations running at the hub, the number of concurrent active users, and historical data
collection. For environments approaching 10000 agents, review with the Application, Availability, and
Business Service Management Solutions Enablement Best Practices team or the Tivoli Performance team
by sending an e-mail to absmenbl@us.ibm.com.
Note: When multiple hub monitoring servers are used, correlation of events can be performed by using
either Tivoli Enterprise Console or Netcool/OMNIbus.
40
Locating and sizing the remote Tivoli Enterprise Monitoring Server

When determining the location of your remote monitoring server, you must consider the number of
connected agents, existence, number, and placement of firewalls, and network bandwidth. With the Tivoli
Monitoring V6.2.2 release, a single remote monitoring server can support up to 1500 agents.
Although the steady state CPU utilization is usually low, a remote monitoring server uses a significant
amount of system resources in processing transient workloads, such as startup, agent login, and situation
distribution. A single processor system is adequate for a remote monitoring server, but a dual processor
server can help during peak transient loads. To support 1500 agents, a server with 1.5 GB of memory is
typically sufficient. If a Warehouse Proxy agent will be running on the same server as the remote
monitoring server, a dual-processor server with 2GB of memory should be used.
If the remote deployment capability is used, ensure that the remote monitoring server has sufficient
network capabilities (100 Megabits per second or higher is typically sufficient). Because the remote
deployment packages are large, in some cases hundreds of megabytes, you must ensure that you do not
have a network bottleneck.
The network connection speed between the monitoring server and the monitoring agent will affect the
elapsed time for remote deployment operations. One way to deal with slow network links is to deploy a
remote monitoring server near the monitored servers. By co-locating the remote monitoring server with the
agents, the Remote Deploy bundles need to be transferred across the slow link only once. Distribution to
the agents can then be done on a high speed LAN segment.
If you use the Warehouse Proxy agent with the remote monitoring server, ensure that you have sufficient
network bandwidth, memory, and CPU capacity for both loads. The network load from the Warehouse
Proxy agent is described in Locating and sizing the Warehouse Proxy agent on page 42.
Locating and sizing the remote deployment depot

Note: Remote deployment is possible only for monitoring agents that run on distributed platforms
(Windows, UNIX, and Linux computers).
When you use the remote deployment for agents and patches, place the remote deployment depot on a
separate directory from your Tivoli Monitoring installation directory. This allows for cleaner backup and
restore operations. The remote deployment depot requires significant disk space, which varies depending
on the number of agents and the number of platforms you use. Typically, allocate at least 2 GB of disk
space for the depot.
Note: If you create a shared deployment repository named depot on the server hosting the deployment
depot and you create this repository in a subdirectory of the depot directory, the monitoring server
will not be able to find your deployment depot. Instead:
1. Create the repository at the C:\IBM\ITM\CMS level of the directory structure, not at the
C:\IBM\ITM\CMS\depot level.
2. Then set the DEPOTHOME keyword to DEPOTHOME=\\hubtems\centralrepository\depot in the
KBBENV file.
Otherwise you will get this error message:
KDY2077E: The specified agent bundle depot \\hubtems\depot is not a directory.
Either the agent bundle depot directory does not exist or it is not a directory.
The agent bundle depot directory does not exist because no bundles have been added.
One of the most important aspects of using remote deployment is ensuring that the files that are
distributed are at the correct version. In large environments, there might be several remote monitoring
41
servers that require maintenance to ensure that all of the depots are updated. To avoid the necessity of
installing updates and maintenance on multiple computers, consider creating one depot and making it
available using NFS or Windows shares.
If you decide to use a shared depot, make sure that the remote monitoring server is upgraded before you
upgrade the agents that are connected to that remote monitoring server. When you deploy monitoring
agents, make sure that you configure them to connect to the desired remote monitoring server.
Notes:
1. In addition to remotely deploying monitoring agents, as of V6.2.2, IBM Tivoli Monitoring lets you
remotely deploy non-agent bundles (with which your site can employ Tivoli Monitoring components that
need not connect to a Tivoli Enterprise Monitoring Server).
2. Remote deployment is not available for z/OS-based OMEGAMON agents, nor is it supported on nodes
running the Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, or the Tivoli Enterprise
Portal desktop or browser client.
Locating and sizing the Tivoli Enterprise Portal Server

Install the portal server on a very fast (at least 3 GHz for Intel, 1.5 GHz for RISC) server that has 2 to 4
GB of total system memory. For small environments with fewer than five concurrent users, a
single-processor server is sufficient. With more than five users, use a dual-processor server. The Tivoli
Monitoring V6.2.2 release has been tested with 50 concurrent users. For environments with more than ten
concurrent portal clients, consider using an external Web server to increase the scalability of the portal
server. See the Tivoli Enterprise Portal Server on page 301 for more details. For information on
configuring the portal server to work with an external Web server, see Configuring an external Web server
to work with Tivoli Enterprise Portal on page 282.
For optimal performance, place the portal server on the same LAN segment as the majority of your portal
clients. Depending on firewall restrictions the location of the portal server has to be verified. If clients are
not allowed to connect to a central segment they are not able to use the portal server.
If you have multiple large data centers you might need to install a second read-only portal server. If you
choose to use this option, be aware that only one portal server can be used to make customization
changes such as editing workspaces and situations. See the section on high availability for details on how
to configure multiple portal servers.
For more information see Memory and disk requirements on page 110.
Locating and sizing the Warehouse Proxy agent

The Warehouse Proxy agent is driven by the amount of historical data being collected. The Warehouse
load projection spreadsheet can help you estimate both the number of database inserts and the volume of
data being collected in the warehouse database.
You can find the Warehouse load projection spreadsheet in the Tivoli Open Process Automation Library
(OPAL) by searching for "warehouse load projections" or the navigation code "1TW10TM1Y" at
http://www.ibm.com/software/tivoli/opal.
42
Figure 9. Warehouse load projection spreadsheet
Figure 9 shows a sample spreadsheet summary created using the tool downloaded from the OPAL site.
The amount of network traffic closely matches the amount of data collected in the Warehouse. The key
planning numbers, highlighted in red, are based on sample data. Each Tivoli Monitoring environment is
different, so fill out the spreadsheet based on your warehousing needs.
For some high-volume metrics, consider collecting only short-term historical data. For example, if you want
to collect process data, there is one row of data per monitored process for every collection interval, which
generates a significant amount of data. By retaining only 24 hours of short-term historical data, you do not
overload your Warehouse server or network, but you can still perform trending analysis.
If historical data collection is started but a warehousing interval is not set, care must be taken to ensure
that the local historical files do not grow indefinitely. This is only for distributed systems. For z/OS, Tivoli
Management Services provides automatic maintenance for the data sets in the persistent data store (the
dataset in which the short-term historical data is stored).
The key information in the spreadsheet includes the following data:
v Total Tivoli Data Warehouse Inserts per hour
In this example, there are 185,600 inserts per hour. Most reasonable database servers can handle this
rate without any problem.
v Total megabytes of new data inserted into Tivoli Data Warehouse per hour
In the example, 137 MB of data per hour are inserted. This amount roughly translates to 137 MB of
network traffic per hour coming into the Warehouse Proxy agent from the connected agents, and
roughly 137 MB per hour of network traffic from the Warehouse Proxy agent to the warehouse database
server.
v Total gigabytes of data in Tivoli Data Warehouse (based on retention settings)
43
In this example, you expect the Tivoli Data Warehouse database to grow to 143 GB of data. Additional
space must be allocated for the database logs. The database does not grow beyond 143 GB because
you are summarizing the raw (detailed) metrics and pruning both the detailed and summarized data.
The planning spreadsheet helps you determine your warehouse size based on your retention needs.
This warehouse database must be carefully planned and tuned. Where possible separate the largest
tables into separate table spaces or data files. By filling in the Warehouse load projection spreadsheet,
most users will find that 3 to 5 tables make up the majority of their warehouse data. These tables should
be isolated from each other as much as possible so that they have optimal performance.
Multiple Warehouse Proxy agents are required when the number of agents collecting historical data
increases above approximately 1500 (to ensure that limits for the number of concurrent connections are
not reached). If you use multiple Warehouse Proxy agents, consider running them on the same servers
running the remote monitoring servers, and configuring them to support agents connected to this
monitoring server. This approach consolidates the Tivoli Monitoring infrastructure components, and limits
the number of agents that connect to each Warehouse Proxy agent.
For server sizing, see Locating and sizing the Summarization and Pruning agent.
Locating and sizing the Summarization and Pruning agent

The Summarization and Pruning agent provides the ability to customize the length of time for which to
save data (pruning) and how often to aggregate detailed data (summarization) in the Tivoli Data
Warehouse database. Configuration of the Summarization and Pruning agent can have a significant impact
on the performance of your Warehouse. Install the Summarization and Pruning agent on the warehouse
database server. If that is not possible, ensure that low latency and high network bandwidth exists
between your Summarization and Pruning agent and the warehouse database.
Table 3 shows guidance for setting up the Summarization and Pruning agent based on the amount of data
inserted into the warehouse database per day. The server sizing is based on the warehouse database and
Summarization and Pruning agent running on the same server, and the Warehouse Proxy agent running
on a separate server. The assumption is that you have new and fast server-class hardware because the
warehouse database server is a high-performing server.
For smaller environments, use a minimum of three dedicated disks because of the high disk I/O
requirements of the warehouse database server.
Table 3. Warehouse database server considerations
Data inserted per day
Number of CPUs
Memory
Hard disk storage
0 to 100 K inserts per day
1 CPU
2 GB
3 or more dedicated SCSI drives
100 K to 500 K inserts per day
2 CPUs
2 GB
4 or more dedicated SCSI drives
0.5 to 2 Million inserts per day
2 CPUs
4 GB
RAID Array with 4 or more disks
2 to 10 Million inserts per day
4 CPUs
4 GB
Multiple RAID Arrays with 5 or

more disks. Or, SAN storage
10 to 20 Million inserts per day
4 CPUs
8 GB
RAID Arrays with 15 to 20

dedicated disk drives or
high-performance SAN storage
> 20 Million inserts per day
4 CPUs
8 GB
Multiple RAID Arrays with 20 to 25

dedicated disks or
high-performance SAN storage
If your Summarization and Pruning agent is installed on the warehouse database server, configure the
agent so that it leaves some processing power for others to perform Warehouse queries and for the
Warehouse Proxy agent to insert data. Set the number of worker threads to 2 to 4 times the number of
44
CPUs on the system where the Summarization and Pruning agent is running. Start with 2 times the
number of CPUs and then increase the number to see if it continues to improve your performance.
To set the number of worker threads, edit the Summarization and Pruning agent configuration file (KSYENV
on Windows, sy.ini on UNIX or Linux) and set the KSY_MAX_WORKER_THREADS to the number of
desired threads. This parameter can also be set using the configuration dialog panels.
To assess the performance and throughput of the Summarization and Pruning agent for your environment,
you can use the following approach:
1. Start by enabling historical data collection for a small set of attribute groups which do not generate a
large number of rows per data collection interval
2. Examine the Summarization and Pruning agent Java log to see how many detailed records were read
and pruned in a processing cycle, and the elapsed time for the processing cycle. Dividing the number
of records read and pruned by the elapsed time will give you a rough measurement of the
Summarization and Pruning agent throughput (records read and pruned per second).
3. As long as the elapsed time for the Summarization and Pruning agent processing cycle is acceptable,
considering enabling historical data collection for additional attribute groups and repeat step 2.
The processing throughput as determined in step 2 is a rough and easily calculated measurement of the
Summarization and Pruning agent performance. Database tuning or additional worker threads can improve
the throughput. See the Tivoli Data Warehouse on page 307 for more tuning information.
Locating and sizing the portal client

The portal client has three different deployment alternatives which are described in Table 4 below.
Table 4. Portal client deployment advantages
Portal client
Advantages
Disadvantages
Browser client
v Does not need to be installed on

client machine.
v Slow initial download.
v No need to for maintenance to be

applied for each client user.
v Only available on Windows using

IE browser.
v Requires tuning of Java settings.
v Workspaces can be referenced

using URLs.
Desktop client
v Faster startup and performance

over browser client.
v Needs to be installed on each

client machine.
v Supported on Linux and Windows.
v Requires maintenance to be
installed individually on each client
machine.
v Mismatch of versions between
portal server and the client is not
permitted.
Java Web Start client
v Similar performance to desktop

client.
v Faster download startup time than
Browser client.
v Supports multiple JREs.
v Centralized administration for
maintenance.
v Try using the browser client first to see if it meets your response time needs. If you are using the
browser client, it is imperative that you increase the Java heap size parameters for the Java Plug-in.
v Using the desktop client with Java Web Start may reduce response time for new workspace requests by
about one second. If this additional response time reduction is important to you, then consider using
45
Java Web Start with the desktop client. Refer to Using Web Start to download and run the desktop
client on page 233 for instructions on how to set this up.
The memory required by the portal client depends on the size of the monitoring environment and on the
Java heap size parameters. The default maximum Java heap size is 256 MB for the desktop client. Using
this default heap size and a medium to large monitoring environment, the portal client can be expected to
use approximately 350 MB of memory.
For the browser client, it is imperative that the default Java plug-in parameters be increased. The preferred
starting value for small to medium environments is Xms128m Xmx256m and Xms256m Xmx512m
for larger environments. When modifying the maximum Java heap size, make sure there is adequate
physical memory for the entire Java heap to be contained in memory. For more information see Tuning
the portal client JVM on page 304.
You can also use the portal desktop client and leverage Java Web Start to minimize your maintenance
costs. The portal desktop client requires less memory and offers better performance characteristics.
Platform support matrix for Tivoli Monitoring

When planning an installation, it is important to review the list of supported platforms to ensure that you
are running on a supported operating system and database version. The platform support matrix that
contains the current list of supported platforms can be found at http://www.ibm.com/software/sysmgmt/
products/support/Tivoli_Supported_Platforms.html.
The easiest way to use this tool is to open the spreadsheet in Microsoft Excel. If you open the
spreadsheet with an Internet browser, you cannot use the macros. After you open the spreadsheet, you
must enable the macros to see the menu as shown in Figure 10.
46
Figure 10. Tivoli supported platforms screen shot
Select the product and product components that you are interested in, and then click Display Selection.
You see a listing of the operating systems and database versions, and the product that you selected.
Information is displayed in the cells might look like C(32,64T) or S(32,64T). The C and S refer to either
client or server support respectively. The 32 and 64T mean that 32-bit kernel and 64-bit kernel systems
were tested in toleration mode. For 64-bit toleration, the application is a 32-bit application, but can also run
on a 64-bit system.
If you do not allow macros to run within Excel, you can still use the Support Matrix spreadsheet, but you
might not see the menus as shown above. You can select either the OS Support or the Database
Support tab at the bottom of the window, and then search through the spreadsheet for the Tivoli
Monitoring products and components.
The platform support matrix refers to the most recently supported versions of the product. In most cases,
you need to apply the latest fix pack to your Tivoli Monitoring environment to obtain support for some of
the newer operating system and database versions. If you have any questions, the Readme file for each
fix pack clearly documents the supported platforms.
Configuring for high availability and disaster recovery

Among the most important considerations in setting up your Tivoli Monitoring environment is ensuring high
availability of the product components and being able to recover quickly from failures. There are multiple
components to consider when discussing high availability. In the following sections, each of the Tivoli
Monitoring components is discussed, along with a strategy for achieving the desired level of high
47
availability and disaster recovery. Ensuring high availability involves achieving redundancy for every
Monitoring component. Disaster recovery means being able to recover from a major outage such as a data
center going offline or losing its WAN link.
Configuring the hub monitoring server for high availability and

disaster recovery
The hub monitoring server is a highly reliable component, and many users choose to run with a single hub
monitoring server and use backup and restore operations to ensure that they have minimum downtime in
case of a hardware failure. Other users require higher availability and less downtime and employ multiple
hub monitoring servers to achieve either a high availability (HA) environment, disaster recovery (DR)
environment, or a combination (high availability and disaster recovery) environment. The following section
describes some of the strategies used to achieve the desired level of availability and downtime.
If you have a smaller environment and do not want to invest in additional hardware, you can set up a
single hub monitoring server. Because the hub monitoring server is very reliable, there is no need to
purchase any additional hardware. You can expect some downtime when patching the hub monitoring
server. There are times when the monitoring server must be recycled. If you use one hub, it is important
that you use a good backup and restore strategy. You can install the hub in a virtualized environment such
as VMWare so that you can quickly bring up an identical virtual operating system to replace the original. In
addition, there is a VMWare HA option with release 3.0.x that automates the start of a failing image on a
different node.
If you want to achieve high availability, you have two options. The first option is to implement the Hot
Standby feature that is built into the monitoring server. Extensive large scale testing has taken place to
ensure that Hot Standby is a robust solution. The second option is to implement an operating system
cluster. Extensive testing has been performed with some operating system clusters. The first two
supported clustering options are Windows Cluster and High Availability Cluster Multi-Processing
(HACMP).
The main difference between the clustering options is the scripts to control the automated control of
resources within the cluster. In this sense, Tivoli Monitoring is cluster-ready for other clustering solutions.
For detailed steps for configuring Clustering, including a detailed clustering scenario, see the IBM Tivoli
Monitoring: High-Availability Guide for Distributed Systems. Also see this guide for instructions on
configuring the Hot Standby option.
You can find more information about using a high availability z/OS hub monitoring server in the IBM Tivoli
Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS.
Configuring for portal server high availability and disaster recovery

It is important to have multiple portal servers available in case of a hardware failure. While the hub
monitoring server tracks the state of your Tivoli Monitoring environment it is not as critical to ensure that
data is synchronized in real-time between multiple portal servers. The primary data that you want to
protect is the customization that is stored in the portal server database, such as user-defined workspaces.
Because this data does not change frequently, a good backup and restore strategy ensures a highly
available environment.
Here are two different ways of achieving both high availability and disaster recovery with the portal server,
depending on the amount of hardware you are willing to dedicate to your solution:
48
OS Cluster:
Many users set up an OS Cluster for their portal server. Depending on the clustering software used, the
cluster can be set up across a WAN to achieve disaster recovery. For detailed information on setting up
the monitoring server and portal server in an OS Cluster, see the IBM Tivoli Monitoring: High-Availability
Guide for Distributed Systems.
Cold backup:
Some smaller users do not want to dedicate CPU cycles and memory to a live backup portal server. If that
is the case in your environment, install a second portal server on another computer that serves as a
production server. The backup portal server is typically shut down so that it does not use any CPU or
memory. If the primary portal server goes down, the cold backup can be brought online. The key for a cold
backup portal server is to periodically export the portal server database content and import it into the cold
backup. In addition, ensure that the cold backup portal server is patched with the same software levels as
the primary portal server.
Consider using a tool like the Tivoli System Automation for Multiplatforms to automate the process of
backing up the resources.
As discussed previously, some users choose to implement a master read-write portal server and one or
more read-only portal servers. When you implement multiple read-only portal servers, you can place a
load balancer or edge server in front of the portal server and have users connect to the edge server. By
doing this, you minimize the complexity and maximize the availability for the end user.
The strategy for backup and restore is to have one master Tivoli Enterprise Portal Server database where
all customization is done. Then, periodically export the content from the master portal server and import
the content into any other portal server. The import replaces the Tivoli Monitoring content in the portal
server database, so be aware that any customization made in the secondary portal server environments
will be overwritten during the import. The export and import of the portal server database can be done in
two ways:
v Using RDBMS backup utilities such as DB2s db2 backup and db2 restore commands
v Using the migrate-export and migrate-import command provided by the Tivoli Monitoring product
If the various portal server databases are not running on the same OS version, then the RDBMS backup
and restore utilities will probably not work. In those cases, use the Tivoli Monitoring migrate-export and
migrate-import commands as described in the product documentation.
Configuring for agent and remote monitoring server high availability

and disaster recovery
All agents can be defined with a primary and secondary monitoring server, which allows the agent to
connect to the secondary monitoring server if the primary is unavailable. Failover to the secondary
monitoring server occurs automatically if the agent fails to communicate with the primary monitoring server.
If no other communication occurs between the agent and the monitoring server, the longest interval it
should take for the failover to occur is the heartbeat interval, which defaults to 10 minutes.
The primary concern when building a high availability and disaster recovery configuration for the agents
and remote monitoring servers is to determine how many agents to connect to each remote monitoring
server. For Tivoli Monitoring V6.2.2, no more than 1500 monitoring agents should connect to each remote
monitoring server.
The following information is important when planning your agents and remote monitoring servers:
v Ensure that failover does not result in many more than 1500 monitoring agents reporting to a single
remote monitoring server. There are two strategies users typically take to avoid this situation.
49
The first and preferred strategy involves having a spare remote monitoring server. By default, the
spare remote monitoring server has no agents connected. When the monitoring agents that report to
the primary monitoring server are configured, they are configured to use the spare remote
monitoring server for their secondary monitoring server. Over time, network and server anomalies
cause the agents to migrate.
To manage this environment, write a situation to monitor how many agents are connect to the spare
remote monitoring server. You can then use the situation to trigger a Take Action command that
forces the agents back to their primary remote monitoring server by restarting them. Restarting the
agents cause them to connect to their primary monitoring server. Ideally, migrate the agents back to
their primary remote monitoring server when the number of agents connect to the spare monitoring
server is greater than 20.
The disadvantage to using a spare remote monitoring server is that you must dedicate a spare
server to be the spare remote monitoring server. Some users choose to co-locate this server with
the Warehouse Proxy agent or run in a virtualized environment to minimize the extra hardware
required.
The second strategy is to evenly distribute the agents so that they failover to different remote
monitoring servers to ensure that no remote monitoring server becomes overloaded. In the example
below, there are four remote monitoring servers. In this example, configure one-third of the agents
on each remote monitoring server to failover to a different remote monitoring server. Review the
following scenario:
RTEMS_1 has 1125 agents, RTEMS_2 has 1125 agents, RTEMS_3 and RTEMS_4 have 1125
agents.
A third of RTEMS_1s agents failover to RTEMS_2, a third failover to RTEMS_3, and a third failover
to RTEMS_4.
This strategy ensures that none of the remote monitoring servers become overloaded. The problem
with this strategy is that it requires a lot of planning and tracking to ensure that all of the remote
monitoring servers are well-balanced.
v If you want your agent to failover to a remote monitoring server in another data center, ensure that you
have good network throughput and low latency between the data centers.
Note: Connect a very small number of agents to the hub monitoring server. Typically, only the Warehouse
Proxy agent, Summarization and Pruning agent, and any OS agents that are monitoring the
monitoring server are connected to the hub monitoring server.
Use the Tivoli Monitoring V6.2.2 heartbeat capabilities to ensure that agents are running and accessible.
The default heartbeat interval is 10 minutes. If an agent does not contact the monitoring server, a status of
MS_Offline is seen at the monitoring server. An event can be generated when an agent goes offline. An
administrator can evaluate whether the agent is having problems or whether there is another root cause.
In addition, there is a solution posted on the OPAL Web site that leverages the MS_Offline status and
attempts to ping the server to determine if the server is down or whether the agent is offline. You can find
more information by searching for "Perl Ping Monitoring Solution" or navigation code "1TW10TM0F" in the
Tivoli Open Process Automation Library (OPAL).
Configuring for warehouse high availability and disaster recovery

When setting up the Warehouse for high availability and disaster recovery, the primary concern is backing
up the data. The warehouse database can grow rapidly and has significant change, with many gigabytes
of new data inserted per day plus summarization and pruning. Use the native database replication tools to
achieve a high availability solution. All of the major database vendors provide data replication tools.
Configuring for Warehouse Proxy agent high availability and disaster

recovery
You need to achieve redundancy with the Warehouse Proxy agent. Only one Warehouse Proxy agent can
be receiving historical data from a specific agent. You can encounter problems if two Warehouse Proxy
50
agents are configured to receive historical data from the same agent. To avoid problems, ensure that only
one Warehouse Proxy agent is responsible for collecting the historical data from a remote monitoring
server.
To ensure that your Warehouse server performs optimally, ensure that the WAREHOUSELOG and
WAREHOUSEAGGREGLOG tables are pruned on a regular basis. Pruning for these tables can be
configured by specifying retention intervals in the configuration dialog for the Summarization and Pruning
agent or in the configuration file (KSYENV on Windows, sy.ini on UNIX or Linux). Refer to Historical data
collection on page 307 for more details.
Configuring for Summarization and Pruning agent high availability and

disaster recovery
Connect the Summarization and Pruning agent to the hub monitoring servers. When the Hot Standby
option is used, the Summarization and Pruning agent must be configured with the standby hub as the
secondary monitoring server. However, there are some additional considerations for achieving high
availability with the Summarization and Pruning agent.
Only one Summarization and Pruning agent may be running against a warehouse database. Thus, it is
important to ensure that there is data integrity within the database and that there is no database deadlock
between two competing agents. So, by default, only one Summarization and Pruning agent must be
installed and running.
As in the Warehouse Proxy agent set up, you want to install a second Summarization and Pruning agent
that serves as a cold backup to the primary Summarization and Pruning agent. By default, the backup
Summarization and Pruning agent is disabled. Write a situation that detects when the primary
Summarization and Pruning agent is down and automatically starts up the backup Summarization and
Pruning agent through a Take Action command.
Care must be taken in writing the Take Action command to ensure that only one Summarization and
Pruning agent is running at any given time. To ensure the two Summarization and Pruning agents are not
running at the same time, perform the following steps:
1. Have the situation trigger only after the second or third missed heartbeat. Occasionally, there are
temporary outages triggered by network problems or routine maintenance. You do not want the
automated Take Action to occur during a temporary outage.
2. When starting up the backup Summarization and Pruning agent using a Take Action command, the
primary Summarization and Pruning agent must be disabled so that it does not accidentally restart until
an administrator manually corrects the problem.
3. Write up a documented procedure to ensure that only one of the Summarization and Pruning agents is
brought back online following a failover.
Agent deployments
When planning your installation, you need to determine how you want to deploy your agents. For very
small environments, some users manually install agents on each server. For larger environments,
automation tools must be used to deploy the agents and agent patches. A key decision point is to
determine which deployment software to use. The Tivoli Monitoring V6.2.2 product has a remote
deployment capability that allows you to initially deploy your operating system agents remotely, and then
remotely add agents to your systems.
Each product and fix pack includes a remote deployment bundle that can be placed in the remote
deployment depot for future agent distributions and patching. However, the remote deployment capability is
not as efficient at distributing software as some purchasable distribution products. If you already have an
enterprise-class software distribution product like Tivoli Configuration Manager or Tivoli Provisioning
51
Manager, you might find it more efficient to distribute the agents and patches. Tivoli Monitoring V6.2.2
agents provide software package blocks that can be used by Tivoli Configuration Manager and Tivoli
Provisioning Manager to distribute the agents.
The main advantage of using products such as Tivoli Configuration Manager and Tivoli Provisioning
Manager are:
v Faster distribution times to speed large-scale deployments.
v Tivoli Configuration Manager and Tivoli Provisioning Manager can be tuned to utilize only a portion of
the network bandwidth.
v Tivoli Configuration Manager and Tivoli Provisioning Manager can easily be configured for retries and
tracking of success and failure.
Here is the location of the Software Packages for the IBM Tivoli Monitoring V6.1 monitoring agents:
ftp://www.redbooks.ibm.com/redbooks/SG247143/.
The advantage of using remote deployment is no additional work is required to create and deploy agent
patches.
If you have an enterprise-class software distribution product, use it for the initial software distribution and
for the deployment of larger fix packs. For interim fixes and small fix packs, the remote deployment
capability might require less time to configure and utilize.
One of the most important aspects of agent deployment is the agent prerequisite preparation. Ensure that
the servers are prepared with the appropriate filesystems including adequate space. In addition to disk
space, you must determine the user account to be used for the agent installation. By using an
administrative account (administrator or root), you ease your agent deployment tasks.
If administrator or root are not allowed, then using sudo on a UNIX system is the next best choice.
Without administrative authority, the installation becomes a multi-step process where the systems
administrators need to be brought in to run commands such as setperm to setup the permissions. For
planning purposes, plan for roughly 500 MB of disk space to allow space for the agent and historical logs.
Background information about agent autonomy

By default, agents are configured for autonomous operation (in other words, the default value for
configuration parameter IRA_AUTONOMOUS_MODE is Y). This means that when the connection to the Tivoli
Enterprise Monitoring Server is lost or the monitoring server otherwise becomes unavailable, the agent
continues to run all situations that can be evaluated exclusively at the agent. Situations that become true
while disconnected from the monitoring server are stored persistently and are uploaded to the monitoring
server when reconnected. If the agent was starting up when the communications break occurred, startup
processing continues.
If you do not want autonomous agent operation, you can disable it by setting environment variable
IRA_AUTONOMOUS_MODE to N in the agent configuration. In this case you must also ensure variable
CT_CMSLIST is both specified and not blank; otherwise the agent will not start.
To configure an agent for fully autonomous operation (in other words, it runs without a connection to a
monitoring server), the following agent configuration is required:
1. The CT_CMSLIST variable must not be set (that is, it should have no value).
2. At least one protocol must be defined in the KDC_FAMILIES variable.
3. The IRA_AUTONOMOUS_MODE variable does not need to be set, as its default value is Y. If
IRA_AUTONOMOUS_MODE is currently set to N, it must be either changed to Y or removed completely.
52
Notes:
1. If you respond NO to question Will this agent connect to a TEMS? when running the UNIX installer,
these parameters get set correctly for you.
2. In all cases, including fully autonomous mode, at least one active protocol must be defined by using
the KDC_FAMILIES environment variable. If no protocols are defined, the agent will not start.
Event forwarding from autonomous agents

By incorporating the Event Integration Facility (EIF) into the autonomous agents, they can forward events
directly to either Tivoli Enterprise Console or Netcool/OMNIbus via the Secure Sockets Layer (SSL)
protocol. Available for the Windows, Linux, UNIX, and z/OS platforms, this integration provides another
event emitter (similar to the SNMP trap emitter) that can emit EIF-format events directly from an
autonomous agent to the event-management facility your site uses.
Currently, EIF event notification is supported only for locally defined private situationsthose defined via a
private configuration file local to the monitoring agent. (Events for enterprise situations must still be
forwarded from the hub Tivoli Enterprise Monitoring Server.) These EIF events provide similar function and
format to those provided by the event forwarder on the hub monitoring server, including the ability to send
situation status. There is no support for dynamic refresh of changed EIF events (that is, event maps and
event destinations); for such changes to be effective, you must recycle the agent.
You can customize agent-generated EIF events via a product-provided or user-defined event mapping file,
which specifies these elements:
v The attributes included in the event.
v Custom message slot text with variable substitution.
v Mapping by situation name.
v Mapping by attribute group used in the situation.
Events generated will have a source slot value of ITM Agent:Private Situation to distinguish them from
events originated at the monitoring server, which have a source slot value of ITM.
You can enable or disable event forwarding by setting IRA_EVENT_EXPORT_EIF to either Y or N in the event
mapping file. Event forwarding is disabled automatically when no valid EIF event destination is defined.
Note that a single event can be sent to up to five different destinations; these can be a mixture of both
TEC and non-TEC event receivers.
A heartbeat function lets you use the event-forwarding feature to send events to either Tivoli Enterprise
Console or Netcool/OMNIbus that notify you if the agent is online and running. The heartbeat interval
determines how often the agent generates this event; it is configurable via the event mapping file. These
EIF events, whose classname is ITM_Heartbeat, contain a slot called interval whose value is the
heartbeat interval. You can customize the IBM-provided heartbeat rules or write your own to handle
heartbeat events as your site's needs dictate.
For complete information about defining your own event mapping file, see the IBM Tivoli Monitoring:
Administrator's Guide.
Note: Existing TEC and OMNIbus event-synchronization rules function as usual, but bidirectional
interactions with IBM Tivoli Monitoring are not possible, as the events do not originate with the Tivoli
Enterprise Monitoring Server. However, the TEC and OMNIbus event receivers will still be able to
update event status for events sent from autonomous agents.
Agentless monitoring versus monitoring agents

IBM Tivoli Monitoring provides operating system (OS) agents that monitor the availability and performance
of the computers in your monitoring environment. An example of an OS agent is the monitoring agent for
Windows, which can monitor Windows XP, Windows 2000, Windows 2003, and Windows 2008 operating
systems. These full-function OS agents must reside on the same computers they are monitoring.
53
As of version 6.2.1, IBM Tivoli Monitoring also provides agentless monitors. An agentless monitor is a
standard Tivoli Monitoring agent that can monitor the operating system running on multiple remote nodes
that do not have the full-function OS agents running on them. An agentless monitor obtains data from
nodes it is monitoring via a remote application programming interface, or APIin this case, SNMP, CIM, or
WMIrunning on the node being monitored. Since these interfaces provide information about either
operating system functions or base application functions, no IBM Tivoli Monitoring component need be
installed or deployed on the monitored node.
API
Function
SNMP The Simple Network Management Protocol is a TCP/IP transport protocol for exchanging network
management data and controlling the monitoring and operation of network nodes in a TCP/IP
environment.
CIM
The Common Information Model is an XML-based standard for defining device and application
characteristics so system administrators and management programs can monitor and control them
using the same set of tools, regardless of their differing architectures. CIM provides a more
comprehensive toolkit for such management functions than the Simple Network Management
Protocol.
WMI
Microsoft's Windows Management Instrumentation API provides a toolkit for managing devices and
applications in a network of Windows-based computers. WMI provides data about the status of
local or remote computer systems as well as the tools for controlling them. WMI is included with
the Windows XP and Windows Server 2003 and 2008 operating systems.
These APIs are supported by the Agent Builder, which enables you to build custom agentless monitoring
solutions that are separate from the agentless monitors available on the Tivoli Monitoring installation media
and that provide additional function.
Since an agentless monitor is a standard Tivoli Monitoring agent, it collects data and distributes it to a
Tivoli Enterprise Monitoring Server and then on to a Tivoli Enterprise Portal Server. It also takes advantage
of the various features of the IBM Tivoli Monitoring product, such as Tivoli Enterprise Portal workspace
views, situations, remote deployment of the agentless monitors, policies, and so on. Detailed information
can be found in the user's guide for each agentless monitor; see Table 6 on page 59.
Agentless monitoring does not provide the kind of deep-dive information your site may need for its core
business servers; however, it does allow a small set of centralized servers to supervise the health of the
operating nodes in your environment. There are five types of agentless monitors: Windows, AIX, Linux,
HP-UX, and Solaris environments.
The agentless monitors are multi-instance agents. After installing or deploying an agentless monitor on a
machine, additional instances can be created via configuration. Each instance can communicate with up to
100 remote nodes.
Each type of agentless monitor can run on additional platforms beyond the type of platform it monitors. For
example, the agentless monitor for Windows (which monitors only Windows operating systems) can run on
any of the supported platforms: Windows, AIX, Solaris, HP-UX, Linux.
Specific operating system releases that a particular agentless monitor can monitor are detailed in Table 5
on page 56. Check the user's guide for each agentless monitor regarding platform-specific requirements
for the operating systems that agentless monitors can run with.
A computer that has one or more agentless monitors running on it is referred to as an agentless
monitoring server. Each server node can support up to 10 active agentless monitor instances, in any
combination of agentless monitor types; for example, 2 AIX, 2 HP-UX, 2 Linux, 2 Solaris, 2 Windows; or 4
Windows, 3 AIX, 3 Linux; or 5 Windows, 5 Solaris; or 10 HP-UX. Each instance can communicate with up
to 100 remote nodes, which means a single agentless monitoring server can support as many as 1000
54
monitored systems (10 instances * 100 remote nodes per instance). By adding more server nodes, the
number of monitored nodes increases into the thousands.
Figure 11 illustrates the architecture of an IBM Tivoli Monitoring environment that employs agentless
monitoring.
Figure 11. Architecture of agentless monitoring
Agentless technology provides lightweight OS monitoring that targets key metrics along with basic
situations meant to satisfy simple monitoring needs. Agentless monitoring provides speedy implementation
and minimum agent deployment, including the deployment of updates; however, the need to poll the
monitored node to retrieve its monitoring data increases network traffic, and real-time data availability is
impacted both by the network delay and the reliance on polling. In addition, the implementation of Take
Action commands for command and control is more powerful with the full-function agents than for
agentless technology.
Key operating system metrics returned:
v Logical and physical disk utilization.
v Network utilization
v Virtual and physical memory
v System-level information
v Aggregate processor utilization
v Process availability
Default situations are provided for:
v Disk utilization
v Memory utilization
v CPU utilization
v Network utilization
You can use these situations as is or as models for custom situations that meet your site's specific needs.
The agentless monitors monitor the distributed operating systems listed in Table 5 on page 56. You can
configure different data collectors for these environments, as shown.
55
Table 5. Data collectors usable with the various agentless monitors and releases supported
Agentless monitor
Agentless Monitoring
for Windows OS
Product
code
R2
Data collectors
supported
1
v WMI
v Performance Monitor
(PerfMon)1
v Windows event log1
v SNMP V1, V2c, V3
Operating system releases monitored

Monitors the following Windows releases:
v Windows 2000 Professional Windows 2000 Server
v Windows 2000 Advanced Server Windows XP
Professional (32 bit) with SP1 or higher
v Windows Server 2003 Standard Edition (32 bit)
with SP1 or higher
with R2 SP1 or higher
v Windows Server 2003 Enterprise Edition (32 bit)
with SP1 or higher
v Windows Server 2003 Datacenter Edition (32 bit)
with SP1 or higher
v Windows 2003 Standard Edition (64 bit) with R2
SP2 or higher
v Windows 2003 Enterprise Edition (64 bit) with R2
SP2 or higher
v Windows 2003 Server Enterprise Edition on
Itanium2 (IA64) with R2 SP2 or higher
v Windows Server 2008 Enterprise Edition (32
bit)Windows Server 2008 Standard Edition (64 bit)
v Windows 2008 Enterprise Edition on Itanium2
(IA64)
v Windows Vista Enterprise, Business, and Ultimate
(32 bit)
v Windows Vista Enterprise, Business, and Ultimate
(64 bit)
Note: IA64 machines running Windows are not
supported.
for AIX OS
56
R3
SNMP V1, V2c, V3
Monitors the following AIX releases:

v AIX V5.2 (32 bit) with ML07 or later
v AIX V6.x (64 bit)
Table 5. Data collectors usable with the various agentless monitors and releases supported (continued)
Product
code
Data collectors
supported
for Linux OS
R4
SNMP V1, V2c, V3
Monitors the following Linux releases running on

xSeries, pSeries, and zSeries machines:
v RedHat Enterprise Linux 4 Intel (32 bit)
v RedHat Enterprise Linux 4 on x86-64 (64 bit)
v RedHat Enterprise Linux 4 on Itanium (64 bit)
v RedHat Enterprise Linux 4 on iSeries and pSeries
v RedHat Enterprise Linux 4 on zSeries (31 bit)
v RedHat Enterprise Linux 5 Intel (32 bit)
v RedHat Enterprise Linux 5 on x86-64
v RedHat Enterprise Linux 5 on Itanium 64 bit
v RedHat Enterprise Linux 5 on iSeries and pSeries
v SuSE Linux Enterprise Server 9 Intel (32 bit) with
SP3 or later
v SuSE Linux Enterprise Server 9 on x86-64 (64 bit)
with SP3 or later
v SuSE Linux Enterprise Server 9 on Itanium (64 bit)
with SP3 or later
v SuSE Linux Enterprise Server 9 for iSeries and
pSeries with SP3 or later
v SuSE Linux Enterprise Server 9 for zSeries (31
bit) with SP3 or later
bit) with SP3 or later
v SuSE Linux Enterprise Server 10 Intel (32 bit)
v SuSE Linux Enterprise Server 10 on x86-64 (64
bit)
v SuSE Linux Enterprise Server 10 on Itanium (64
bit)
v SuSE Linux Enterprise Server 10 for iSeries and
pSeries (64 bit)
bit)
for HP-UX OS
R5
SNMP V1, V2c, V3
Monitors the following HP-UX releases:

v HP-UX 11i v1 (B.11.11) (32/64) on PA-RISC
v HP-UX 11i v2 (B.11.23) (64 bit) on PA-RISC
v HP-UX 11i v3 (B.11.31) (64 bit) on PA-RISC
v HP-UX 11i v2 (B.11.23) on Integrity (IA64)
v HP-UX 11i v3 (B.11.31) on Integrity (IA64)
for Solaris OS
R6
v CIM-XML
v SNMP V1, V2c, V3
Monitors the following Solaris releases:

v Solaris V8 (SPARC) (32/64bit)
v Solaris V9 (SPARC) (32/64bit)
v Solaris V10 (SPARC) (32/64 bit)
v Solaris V10 (x86-64) (64 bit)
v Solaris V10 (Opteron) (64 bit)
Agentless monitor
Operating system releases monitored
Notes:
1. To use one of the native Windows data collectors (WMI, PerfMon, the event log), the agentless monitoring server
must run under Windows.
IBM recommends that you deploy a full-feature operating system agent to each agentless monitoring
server to watch the CPU, memory, and network consumption of the agentless monitors themselves.
57
Deployment options for agentless monitors

As with other IBM Tivoli Monitoring agents, you can either install agentless monitors or deploy them from
your site's deployment depot. When installing Tivoli Monitoring, you can add the agentless monitors to
your site's deployment depot, as shown in .Figure 12
Figure 12. Adding agentless monitors to the deployment depot
You also have the full range of remote-deployment options, as explained in Chapter 3, Deployment
phase, on page 69, at your disposal when planning how best to deploy agentless monitors across your
environment. These include:
v The Tivoli Enterprise Portal's deployment features.
v The tacmd CLI commands.
As required for the deployment of any IBM Tivoli Monitoring agent, remote deployment of an agentless
monitor to an agentless monitoring server requires that an OS agent be running on that machine. For
example, if the agentless monitor runs on an AIX operating system, the IBM Tivoli Monitoring AIX agent
must first be running on it to remotely deploy that agentless monitor. In addition, the OS agent is required
to configure a server's agentless monitors via the Tivoli Enterprise Portal.
The agentless monitors are included on the same Agents DVD as the traditional OS agents and the
Universal Agent.
58
Documentation resources for agentless monitoring

Table 6 lists the IBM Tivoli Monitoring manuals that detail the configuration and usage of the agentless
monitors.
Table 6. User's guides for the agentless monitors
Title
Document number
IBM Tivoli Monitoring: Agentless Monitoring for Windows Operating Systems User's Guide SC23-9765
IBM Tivoli Monitoring: Agentless Monitoring for AIX Operating Systems User's Guide
SC23-9761
IBM Tivoli Monitoring: Agentless Monitoring for Linux Operating Systems User's Guide
SC23-9762
IBM Tivoli Monitoring: Agentless Monitoring for HP-UX Operating Systems User's Guide
SC23-9763
IBM Tivoli Monitoring: Agentless Monitoring for Solaris Operating Systems User's Guide
SC23-9764
Problem-diagnosis tools available for agentless monitoring

Log files are available on both the remote system being monitored and the agentless monitoring server
that is doing the polling. The following agent log files are available in these locations on the monitoring
server:
v Windows: C:\IBM\ITM\TMAITM6\logs
v Linux and UNIX: /opt/IBM/ITM/logs
On the remote system, the following log resources are at your disposal, depending on the type of system
being monitored and the monitoring API used:
v Windows: event logs
v Linux and UNIX: SNMPD or CIM log
Tivoli Universal Agent deployments

There are some special considerations for deploying the Tivoli Universal Agent. This section describes
some strategies and techniques for ensuring a successful deployment of the Tivoli Universal Agent.
This section does not attempt to address the creation of Tivoli Universal Agents. Detailed information is
available in the IBM Tivoli Universal Agent User's Guide and the IBM Tivoli Universal Agent API and
Command Programming Reference Guide.
Tivoli Universal Agent versioning considerations

One of the unique challenges of deploying Tivoli Universal Agent solutions is the Tivoli Universal Agent
versioning. As schema changes are made to the Tivoli Universal Agent, the Tivoli Universal Agent version
is incremented. Not all changes cause the version to be incremented: for example, adding one ore more
new attributes to the end of an existing attribute group does not trigger a version change. But when you do
things like rename, resize, or delete an attribute, the version is updated.
A typical Tivoli Universal Agent looks like AGENT00 in the portal client. If the Tivoli Universal Agent is
updated, the Tivoli Universal Agent name is changed to AGENT01 and then if updated again, to AGENT02. As
the agent version is updated, the situations and workspaces must be modified to work with the new agent
name. A custom workspace written for AGENT00 does not work with AGENT01. Therefore, use the
following strategy:
Create and thoroughly test your Tivoli Universal Agent solutions in your test environment. After your Tivoli
Universal Agent solution has been completed, reviewed, and signed off by the stakeholders, you can begin
the process of moving it into production. If the Tivoli Universal Agent is finalized, you can install a duplicate
Tivoli Universal Agent into production. If you want to have identical Tivoli Universal Agent versions in test
and production, you can reset your test version to 00 using the steps documented in the IBM Tivoli
Universal Agent User's Guide.
59
A solution used by many users to handle the complexities of versioning is to develop your agent using a
different agent name during your development phase. Develop the agent using a different name and after
the agent is working and optimized, rename the agent in your test environment before promoting it to
production.
To avoid issues with Tivoli Universal Agent versioning entirely, consider developing your custom monitoring
solution with the Agent Builder.
Tivoli Universal Agent firewall considerations

The Tivoli Universal Agent is similar to any other agent. The Tivoli Universal Agent connects to the
monitoring server using your selected protocol (IP.PIPE, IP.UDP, or IP.SPIPE). However, in addition to
communication between the Tivoli Universal Agent and the monitoring server, there can also be
communications from the Tivoli Universal Agent to the monitored system.
There are three data providers that frequently have remote connections (ODBC, SNMP, and Socket). You
can have remote connections with other data providers like the API data provider as well. When you are in
an environment with firewalls, you must ensure that you can establish communications between the
monitored system and the Tivoli Universal Agent.
v For SNMP, the default port is 161. The Tivoli Universal Agent contacts the managed system on this port.
v For SNMP traps, the Tivoli Universal Agent listens on port 162.
v For ODBC, the default port varies depending on the database server. For example, the port for DB2 is
50000.
v For the Socket Data Provider, the data collection program writes to a socket on the Tivoli Universal
Agent using default port of 7500.
Large-scale deployment strategies

When deploying large numbers of similar Universal Agents you need to consider strategies so that you do
not have to manually install a Tivoli Universal Agent on dozens or hundreds of servers. There are a couple
of solutions to large scale deployments.
One strategy is to use Tivoli Monitoring remote deployment to distribute Universal Agents to multiple
servers. When distributing the Tivoli Universal Agent, remote deployment distributes the Tivoli Universal
Agent MDL file and associated scripts and files.
There are challenges to MDL file updates and control of the file rights. Additionally deploying version 05 to a
new server creates version 00 on the new server. This challenge can be controlled by using your own
packages which have a target version and verifies the agent is at the correct version level. Additionally, the
default permissions on the scripts associated with the Tivoli Universal Agent are 777. Perform testing in
your environment and change the permissions to reduce the filesystem permissions.
Another strategy to use in large scale environments is to create one or more metafile servers, using the
KUMP_META_SERVER parameter. By specifying KUMP_META_SERVER, you tell the Tivoli Universal
Agent which server is the Metafile Server. Then, when updates are made to the MDL file, only the Metafile
Server needs to be updated. When using Metafile Servers, the Tivoli Universal Agent opens a socket to
the Metafile Server. So, when using the Metafile Server in environments with firewalls, it is sometimes
necessary to create multiple Metafile Servers (typically one for each network zone). Metafile Servers are
well documented in the IBM Tivoli Universal Agent User's Guide.
Using Universal Agents with remote monitoring servers

There is a known limitation when using the Tivoli Universal Agent with both hub and remote monitoring
servers. If you connect your Tivoli Universal Agent to remote monitoring servers, certain required files
(kum.cat and kum.atr) are not automatically propagated to the hub monitoring servers. There are two
options to address this limitation.
60
v The preferred approach is to connect your Tivoli Universal Agent to the hub prior to performing the
kumpcon import and um_console import command. This approach causes the required files to be
created on the hub monitoring servers. For monitoring to work as desired, move the Tivoli Universal
Agent to the remote monitoring server.
v You can also leave the Universal Agent connected to a remote monitoring server and copy the required
files from the monitoring server to the hub monitoring server. Because this approach requires a recycle
of the hub monitoring server, it is the less desirable approach.
Mainframe users
Mainframe environments have some unique considerations. There are features that are available only
when running a z/OS hub monitoring server and features that are available only when running a distributed
hub monitoring server. This section outlines those considerations so that you can make the best choice for
your environment.
Unique z/OS hub monitoring server features
The z/OS hub monitoring server allows you to take advantage of RACF authentication. However,
the OMEGAMON for MQ Configuration product has some specific integration with RACF that
requires a z/OS hub in order to take advantage of RACF authentication within the OMEGAMON
for MQ Configuration product.
The z/OS hub does not provide the Hot Standby feature. High availability is achieved using a
movable hub solution as described in the IBM Tivoli Management Services on z/OS: Configuring
the Tivoli Enterprise Monitoring Server on z/OS.
Note: The z/OS environment does not support the Tivoli Universal Agent.
Unique distributed hub monitoring server features
Two features that are provided on a distributed hub monitoring server environment are not
available on z/OS hub monitoring server environments.
v Remote deployment
v Hot Standby
The distributed hub monitoring server has a feature called Hot Standby to assist with high
availability and disaster recovery scenarios. Many users choose not to use the Hot Standby
feature and instead deploy OS Clusters for high availability and disaster recovery.
Linux on z/VM systems
Many mainframe users run Linux on their z/VM systems. Many different Tivoli Monitoring
components can be installed in Linux on z/VM environments, including the monitoring server,
portal server, monitoring agent and warehouse-related components. Each Linux environment can
be configured with monitoring server or portal server software, or both.
Multi-hub environments
Large users who go beyond the limits of a single hub monitoring server environment must consider
additional factors. Tivoli Monitoring V6.2.2 has been tested with environments with as many as 10000
agents. Some users need multiple hub monitoring servers to handle the tens of thousands of agents in
their environment. Following are some considerations to take into account when deploying multiple hub
monitoring servers.
Sharing a warehouse database:
You can share a single warehouse database with multiple hub monitoring servers, but there are additional
considerations when choosing this deployment option. First, you must take into account scalability of the
Warehouse Proxy and Summarization and Pruning agents. Use the Warehouse load projection
spreadsheet, which can be found in the Tivoli Open Process Automation Library (OPAL) by searching for
"warehouse load projections" or the navigation code "1TW10TM1Y."
61
With multiple hubs and more than 10000 agents, you increase the likelihood of exceeding the capacity of
the Warehouse. Be aware of how much data you are collecting to ensure that you do not exceed the
capacity of the warehouse database. To get an idea of the capacity of the Summarization Pruning agent
with your warehouse database, consider using the measurement approach discussed in Locating and
sizing the Summarization and Pruning agent on page 44.
In addition to scalability, there are specific deployment requirements when a warehouse database is
shared between hub monitoring servers. First, you can run only one Summarization and Pruning agent in
only one of the two monitoring server environments. The single Summarization and Pruning agent is
responsible for summarizing and pruning the data for all of the data in the Warehouse. The summarization
and pruning configuration settings are maintained by the portal server that is specified in the
Summarization and Pruning agent configuration dialog.
Due to the complexity and potential scalability issues of sharing a warehouse database across multiple
hub monitoring servers, you might want to maintain multiple warehouse databases. To build reports across
the databases, use Federation capabilities or create a data mart that merges that content from multiple
warehouse databases.
You cannot set up different summarization and pruning schedules for each of the hub monitoring server
environments. In addition, you must also ensure that the hub with the Summarization and Pruning agent is
patched and maintained so that it is a superset of the two monitoring servers. If you install the database
agents in one hub, then you must install the application support for the database agents on the hub
monitoring server and portal server in the hub environment with the Summarization and Pruning agent. If
you install a fix pack on one hub, then you must ensure that it is also installed on the hub with the
Summarization and Pruning agent, which ensures that the Summarization and Pruning agent is aware of
all attribute groups and attributes that can be collected.
Sharing customization:
When using multiple hubs, most customization can be shared between the two hub environments.
Customization includes situations, policies, workspaces, managed systems lists, and Tivoli Universal Agent
solutions. In the Tivoli Monitoring V6.2.2 release a number of CLIs were added to the product to do bulk
imports and exports of situations, policies, and workspaces. For details on the new CLIs, see the IBM
Tivoli Monitoring: Command Reference. Most of the customization can be cleanly exported from one
monitoring server environment to another monitoring server environment using tools that are identified in
Maintaining an efficient monitoring environment on page 77.
Accelerating your custom monitoring

There are ways of accelerating the creation and deployment of custom monitoring solutions. First, you can
access many solutions already available in the Tivoli Open Process Automation Library (OPAL). Check
OPAL before creating any custom solutions. Even if the OPAL solution does not meet all of your needs, it
is probably easier to extend the capabilities of an existing solution rather than create a new one. If you
need to create a custom monitoring solution, the following search criteria for the Tivoli Open Process
Automation Library (OPAL) might provide solutions that can help you:
v "SNMP MIB to Universal Agent utility" or navigation code "1TW10TM3P"
v "Uses of the Universal Agent" or navigation code "1TW10TM25"
62
Planning and project management

Before you begin the implementation phase of your deployment, you must develop a detailed project plan.
Chapter 3, Deployment phase, on page 69 helps you understand the detailed steps required to
successfully install and configure your Tivoli Monitoring V6.2.2 environment. This section describes some
additional tasks that must take place before the initial implementation takes place.
The Project Management and Planning phase must be led by a certified project manager working with a
deployment architect. The project manager ensures that all required tasks are identified and documented.
Thus, providing a framework for tracking the progress of the deployment.
The most important task to complete before proceeding to the implementation phase is to identify and
document the key requirements. These requirements are typically business objectives that have been
identified by senior management. After the business objectives have been identified, the Tivoli Monitoring
requirements and implementation details can be created by architect. These details include the following:
v High-level design for the Tivoli Monitoring components.
v Naming conventions for situation, workspaces, queries, managed systems lists, and Take Actions
commands.
v Any changes to existing production environments such as firewall changes, and server prerequisites.
v Monitoring strategy
The monitoring strategy should specify exactly what will be monitored, and how; what situations and
automation policies will be created; what events will be forwarded to other event management systems;
and similar details. Working out the specifics of the monitoring strategy is perhaps the most challenging
aspect of planning.
The details provided in this guide are intended to help the architect design the right solutions to meet the
needs of all Tivoli Monitoring stake holders, given the constraints of the environment and the business
objectives.
Estimating deployment tasks

The following estimating approach provides details of each logical task so that the estimates can be
applied to any piece of work. No distinction is made between the tasks carried out in test and the tasks
carried out in production in terms of how long the tasks take to complete. The only difference is that in
production there are more barriers to starting the work because of the need for access to user IDs,
firewalls, and change control.
In each section a description of the tasks necessary to deploy those components is provided.
v
v
v
v
v
Install
Install
Install
Install
Install
server components on Windows and UNIX on page 64

server components on z/OS on page 64
data warehousing components on page 64
and configure event integration components on page 64
and configure monitoring agents on page 65
v Setting up situation-based monitoring on page 66

v Creating policies and workflows on page 66
v
v
v
v
v
Creating workspaces on page 66

Creating and deploying Tivoli Universal Agent applications on page 66
Transferring skills on page 67
Scheduling the initial deployment on page 67
Scheduling for fix packs on page 67
63
Install server components on Windows and UNIX

The first step is to install the Tivoli Monitoring server components. In general, for planning purposes, allow
one day for this task. In some cases, installing the server components takes longer than one day due to
change control processes or lack of access to key personnel such as database administrators and network
administrators. By arranging for key personnel to be available before beginning the installation, you ensure
a timely deployment.
Tivoli Monitoring includes the following server components:
v DB2
v Monitoring server
v Portal server
v Local operating system agent
Note: Although IBM Java is included with the Tivoli Monitoring V6.2.2 distribution, special considerations
might need to be made if there are existing versions of Java required on the server where Tivoli
Monitoring V6.2.2 is to be installed. Thus, Java might be a specific component that also needs to
be addressed as part of your planning process.
Install server components on z/OS

Most users with a z/OS monitoring server deploy both z/OS agents and a monitoring server. The estimates
in the following paragraph include the time requirements for installing both the agents and the monitoring
server components.
In general, you need to allow a day for loading the software off tape and performing the receive, apply,
and accept processing. The elapsed time depends on the number of products and the amount of
processing power allocated to the installation LPAR, typically a test environment. If you have more than
two products, then allow more time. As a rule of thumb allow half a day per product with a minimum of one
day.
For more information search for "SMP/E installation on z/OS" or navigation code "1TW10TM3M" at the
Install data warehousing components

In general, allow a day to install and configure the Warehouse Proxy agent and the Summarization and
Pruning agent. The installation is straightforward but then you need to verify that data is being collected
and summarized successfully, which has inherent delays because the minimum warehouse interval is one
hour and there is no way to force the warehousing of data.
Install and configure event integration components

Allow one day to install the event synchronization component and configure event forwarding to either
Tivoli Enterprise Console or Netcool/OMNIbus. This estimate includes time to confirm that events are
being forwarded to Tivoli Enterprise Console or Netcool/OMNIbus and synchronized back to Tivoli
Monitoring.
Because this step requires the installation of new baroc files for the Tivoli Monitoring V6.2.2 events
(Table 7 on page 65 lists the update history for these files), you must plan for at least one recycle of your
Tivoli Enterprise Console server. Since the installation of new baroc files for Tivoli Monitoring V6.2.2
requires that the Tivoli Enterprise Console Server be recycled, users must plan for an outage in their Tivoli
Enterprise Console Server. This means you must use your normal change control processes to schedule a
change window. The estimated one-day duration to implement the Tivoli Enterprise Console changes does
not include creating any custom rules or baroc files. The one day includes implementing the default baroc
files included with Tivoli Monitoring V6.2.2.
64
When using the Tivoli Enterprise Console, you need a baroc file for each type of agent. For the packaged
agents, a baroc file is automatically installed on your monitoring server. The baroc files are placed in the
CANDLE_HOME\cms\TECLIB directory. For Tivoli Universal Agent solutions, it is necessary to create a baroc
file for each Tivoli Universal Agent solution. A tool available on OPAL generates the baroc file for the Tivoli
Universal Agent solutions. To find this tool search for "BAROC file generator" or navigation code
"1TW10TM43" at the Tivoli Open Process Automation Library (OPAL).
Table 7. Update history for the baroc files for IBM Tivoli Monitoring agents and components
IBM Tivoli Monitoring agent/component
Last updated for which release?
Tivoli Enterprise Monitoring Server (kib.baroc)
V6.2.0 interim feature 3
Remote deployment (kdy.baroc)
v6.2.1
Warehouse Proxy agent (khd.baroc)
V6.2 fix pack 1
Summarization and Pruning agent (ksy.baroc)
V6.2 fix pack 1
Windows agent (knt.baroc)
V6.2.2 fix pack 2
Linux agent (klz.baroc)
V6.2.2 fix pack 2
UNIX agent (kux.baroc)
V6.2.2 fix pack 2
Unix Log Alert agent (kul.baroc)
V6.2.1
i5/OS agent (ka4.baroc)
V6.2.2 fix pack 2
Note: File omegamon.baroc contains the base event class definitions for all Tivoli Monitoring events; it is
automatically installed on Tivoli Enterprise Console when event synchronization is installed.
Install and configure monitoring agents

Windows and UNIX systems:
The time required to install and configure an agent differs depending on the agent. Using operating system
agents as a baseline, you should be able to install a monitoring agent in 10 minutes. Taking operating
system agents as a baseline, then in theory for UNIX and Windows you can install them in 10 minutes.
However, when planning, allow time to debug some failures. Ideally, in an 8-hour day you should be able
to install 48 error-free agents. If scripts are allowed to run overnight, nearly 150 agents can be installed
per day. Even so this is probably not realistic for a couple of reasons.
First, you must spend time debugging problems and due to issues with access to user IDs that have
sufficient authority to perform the installation and access to the installation image. In most environments a
single person can reasonably aim for 50 agents per day if user access is provided in a timely manner.
Even if there are multiple agents to be installed per computer, then this is still a reasonable estimate for
installing an operating system agent, a Tivoli Universal Agent, and a database agent.
Note: If software distribution is being used, then after a package has been built, the number of agents
that can be deployed in a given time frame increase.
z/OS systems:
If you take CICS, DB2, and z/OS agents as an example, in general allow one day to configure each agent,
assuming one CICS region and one DB2 subsystem. For additional CICS regions, this means more CICS
table changes. Additional DB2 subsystems are defined in ICAT and you can estimate one hour per
subsystem.
Upgrading your environment to allow for additional LPARs is typically quicker because you can use batch
mode replication. Allow one day per LPAR.
65
For more information search for "SMP/E installation on z/OS" or navigation code "1TW10TM3M" at the
Setting up situation-based monitoring

It is difficult to estimate the time required to set up situation-based monitoring. It is easy to turn on various
predefined situations if they are not already running, but not always practical. Before starting or turning off
predefined situations, you need to review them to determine which ones are appropriate for your
environment. Moreover, you need to review the default thresholds for the situations that you decide to use
and adjust them to suit your site policies and requirements.
Note: Any changes made to predefined situations are overwritten when application support is updated. If
you modify predefined situations, save them with a new name, and use them instead of the original
predefined situation for your monitoring.
For creating new situations, allow for 20 situations per day, including testing.
You may also want to create managed system groups, which are lists of managed systems to which you
want to distribute the same situations.
When creating situations and managed systems lists, it is extremely important to choose a naming
convention that is meaningful. A similar naming convention must be used for situations, managed systems
lists, workspaces, and queries. Customizing your environment on page 71 describes some options when
considering the situation and managed system group naming conventions.
Creating policies and workflows

Policies can be used to perform complex monitoring and automation. Time must be allocated to determine
when situations are inadequate to provide complex thresholding and Take Actions. When you have
determined which complex monitoring and automation cannot be accomplished, put proper plans in place
to ensure effective policies are created. When planning policies, choose a naming convention that is
similar to your convention for naming situations. Plan enough time to adequately develop and test your
policies.
Creating workspaces
Again this is difficult to estimate. Typically, you not know exactly what you want to monitor. Be careful not
to create something that will be hard to maintain in the future. Workspaces vary in complexity a great deal,
so a graphic view with icons does not take long, but a workspace with links using variables takes quite a
while to set up and test. On balance, aim for ten workspaces per day along with associated custom
navigator items.
Creating and deploying Tivoli Universal Agent applications

Installing Tivoli Universal Agent applications is almost impossible to estimate because of the varied nature
of what the Tivoli Universal Agent can monitor. If you are using user-provided scripts, for instance, then
you can create an application in half an hour. If you have to create your own scripts then that can take
days depending on your skill level with scripting and the complexity of the script. Likewise, log file
monitoring can be straightforward or complex depending on the format of the log file.
Adjust the time estimates on a case-by-case basis. Be very careful in moving metafiles from development
and test to production because of the versioning nature of the Tivoli Universal Agent. Depending on how
they are implemented, changes to the metrics being collected can cause the version of Tivoli Universal
Agent to increment, resulting in loss of all customization done to the Tivoli Universal Agent.
Make sure that all the desired metrics are added to metafile and maybe two or three placeholder generic
metrics can be added to accommodate future modifications without needing a version change. Another
option is to use two very generic metrics such as MetricName and MetricValue and write situations such
66
as scan for string with in a string to catch the data. When the metafiles are imported, make sure the
Tivoli Universal Agent is connected to the hub monitoring server first and then later it can be moved to any
desire remote monitoring server.
Transferring skills
Much of the skills transfer can occur during the installation and configuration process if you are working
closely with key staff. You can still factor in an additional three days to cover the same subjects as in the
IBM Tivoli Monitoring Administration course. Also add one to two days for the Tivoli Universal Agent
depending on the complexity of the monitoring requirements. Other skills transfer can be estimated at one
day per agent type. For some of the z/OS-based agents this can be a bit longer because of the two
different 3270 mainframe and the portal client interfaces, so allow two days for CICS and DB2 agents.
These time estimates correspond roughly to the number of days it takes to deliver formal training.
Scheduling the initial deployment

The initial deployment of the Tivoli Monitoring environment is the most time-consuming. The majority of the
customization is performed during or immediately after the initial deployment. Customization includes
modifying workspaces, modifying situation thresholds, building managed systems lists, and defining Take
Action commands.
Scheduling for fix packs

In a typical user environment, allocate one day to upgrade the Tivoli Monitoring infrastructure components
(hub monitoring server, portal server, Warehouse Proxy agent, Summarization and Pruning agent). In a
multi-hub environment, allow one day for each hub. Then, time must be allocated to upgrade the agents.
Typically, the schedule is driven largely by Change Control windows and not by the time it takes to deploy
the fix pack to the agents. However, for planning purposes use the following time estimates.
These times assume that there is adequate network bandwidth between the remote monitoring server
deployment depot and the agents. In environments with slow network links between the remote monitoring
server and the agents, evaluate the size of the fix pack files to calculate the rate of transfer. Because each
fix pack is a different size and each network has unique characteristics, calculate this for your environment
before starting the upgrade.
Performing agent upgrades in parallel can be done with the itmpatchagents tool. For environments with
adequate network bandwidth and two people performing upgrades in parallel, plan to upgrade
approximately 500 agents per day.
Finally, following the installation of a fix pack, plan time to test your environment. For Tivoli Monitoring
infrastructure fix packs, spend two person days thoroughly testing your environment. For application
agents, there is little risk that the Tivoli Monitoring infrastructure components were affected by the fix pack.
Therefore, no more than one person day need be allocated to test the environment following the
installation of an application fix pack.
Staffing
The table below lists the staffing and time estimates for various Tivoli Monitoring tasks.
Table 8. Staffing estimates
Tivoli Monitoring tasks
Discussing the project plan including implementation and support in

place by IBM
Downloading the correct media for installation
Hours
required
Number of
people
required
Skills
required
16
Medium
8 hours
Medium
67
Table 8. Staffing estimates (continued)

Tivoli Monitoring tasks
Hours
required
Number of
people
required
Skills
required
4 hours
Medium
Creating the warehouse database with sufficient space, user IDs

and tuning parameters
High (DBA)
Configuring firewall for ports
High (Network
Team)
Installing core components (portal server, monitoring server,

Warehouse Proxy agent, and Summarization and Pruning agent).
20
High
Disabling the default situations
Medium
Creating the managed systems list
Medium
Creating the custom situations
32
Medium
Deploying first 50 mix of Windows OS, UNIX and Linux OS and

different application agents
40
High
Deploying situations to appropriate managed systems lists
Medium
Verifying all agents and core components are active and working
correctly
40
High
Verifying events flowing to Tivoli Enterprise Console server
Medium
Backing up the environment (core components)
High
Deploying agents in chunks of 100 agents, depending upon the

requirement. Sizing includes adding computers to the managed
systems lists.
24
Medium
Enabling only required attribute groups for warehousing as

mentioned in the project plan
Medium
Verifying warehouse data is flowing from agents to warehouse

database
High
Performing frequent health checks of the environment, more

frequent in first few months and then later less frequent checks
High
Creating and deploying custom monitoring solutions with the

Universal Agents - simple agents
Medium
Creating and deploying custom monitoring solutions with the

Universal Agents - complex agents
40
High
Completing the hardware check
Note: Installing core components depends on the size of the

environment and the complexity regarding multiple Warehouse
Proxy agents.
Use the following Project Plan as a template to ensure that all tasks are planned during your installation.
This Project Plan is located on the SAPM Technical Exchange wiki at http://www.ibm.com/developerworks/
wikis/pages/viewpageattachments.action?pageId=9595.
68
Chapter 3. Deployment phase

Proper planning ensures that the deployment phase goes smoothly. The following section documents the
steps necessary to deploy and configure your Tivoli Monitoring V6.2.2 environment. During the initial
installation, use a phased approach. Perform these steps in development and test environments before
applying them in the production environment.
Pre-installation checklist
Use the following checklist for your pre-installation:
v Verify that your hardware meets the requirements for Tivoli Monitoring V6.2.2 core components.
v Verify that the correct media is downloaded (not the upgrade install media).
v Verify that you have the correct media for your hardware architecture. Some operating systems support
both 32-bit and 64-bit kernels. To check which kernel version your system is running, use the following
commands:
Table 9. Commands for determining your system's kernel version
System
Command
AIX
bootinfo -K get 64 or bootinfo -K get 32
HP
getconf KERNEL_BITS
Linux
rpm -q libstdc++ | grep libstdc++-2.9
Solaris
isainfo -b
v Verify prerequisites are met for the databases.

v Confirm you have the appropriate authority on the system to be installed.
v Confirm the network team is contacted for required ports to be opened between the portal server,
monitoring server, monitoring agents, and Warehouse Proxy agents.
v Ensure the team responsible to deploy and implement Tivoli Monitoring solution is equipped with
sufficient skills to complete the tasks successfully.
Give special consideration to Windows installations where you are using terminal services or some other
remote control software to access hosts. In a perfect world, install this software while you are physically
sitting at and logged in to the system console. As this might be impractical, you need to have LOCAL
ADMINISTRATOR authority (domain administrator authority itself does not suffice).
If using something like terminal services, you need to be a member of the local user security policy called
Allow Logon Locally as well as Allow Logon through Terminal Services. In some cases, you might need to
work with the Windows engineers to help you maneuver through local and AD security issues. Security
problems can initially manifest themselves as subtle inconsistencies but ultimately can inhibit a successful
installation.
Installing the infrastructure components

Before installing any Tivoli Monitoring agents, you must first install the Tivoli Monitoring infrastructure
components, which include the hub monitoring server, portal server, remote monitoring server, Warehouse
Proxy agents, and Summarization and Pruning agent.
For the first phase of your deployment, deploy a relatively small environment, which provides you with the
opportunity to test your production environment and ensure that it is running smoothly. Deploy the hub
monitoring server and only two remote monitoring servers initially. The remote monitoring servers can
69
successfully monitor up to 1500 agents, so using two remote monitoring servers during your initial
deployment is not a problem. Firewall considerations might necessitate additional remote monitoring
servers.
If you plan to use clustering to achieve a high availability configuration, configure the cluster before
connecting any agents. Otherwise, it is necessary to reconfigure the agents to connect to the cluster rather
than connecting to one of the nodes in the cluster. For information on setting up the hub monitoring server
and portal server in an OS, see the IBM Tivoli Monitoring: High-Availability Guide for Distributed Systems.
Because the installation of application agent support on the monitoring server and portal server requires
them to be recycled, install the application support on the monitoring server, portal server, and portal client
for all agents that you expect to deploy in the next six to nine months. This likely includes the IBM Tivoli
Monitoring for Databases, IBM Tivoli Monitoring for Messaging and Collaboration, ITCAM for SOA and any
other products you plan to implement.
During the initial installation phase, install the Warehouse Proxy agent and Summarization and Pruning
agent, but do not begin using them until after you have successfully deployed your first 50 agents.
Installing in this way gives you an opportunity to assess the health of your environment before adding to
the complexity of your environment.
Configuration checklist
Use the following checklist for your configuration:
v Install all Tivoli Monitoring V6.2.2 core components (portal server, monitoring server, Warehouse Proxy
agent, and Summarization and Pruning agent) so there can be a section for each component.
v Verify the correct protocols are selected. If SPIPE is chosen, make sure the encryption key string used
is the same across the Tivoli Monitoring V6.2.2 enterprise environment.
v Verify the correct configurations are performed regarding data warehousing.
After installing the hub and remote monitoring server, ensure that you do not attempt to start a second
kdsmain instance, which can corrupt your environment. Modify the monitoring server startup CandleServer
script so that it looks as follows:
#
#Local change to check for another running kdsmain
#
if [ "$action" = "start" ]
then
if ps -ef | grep -v grep | grep kdsmain
then
echo "There is a KDSMAIN running already"
exit
fi
fi
Some users run multi-hub monitoring servers on a single server for the development and test
environments using different ports. If that is the case, then the previous script cannot work because
kdsmain is running for the other hub. If that is the case, use extreme care to ensure that you do not
accidentally start a second kdsmain for a given hub.
Do not enable warehousing at this time. Wait until all the agents for phase one have been installed and
started, and the situations have been distributed.
Disable all the default situations by unassigning the managed system group and any agents present in the
Assigned check box.
Create the managed system groups before creating the situations.
70
Distribute all newly created situations with naming conventions to the customized managed system group
and not to *NT_SYSTEM, *ALL_UNIX. You must customize your situation thresholds before forwarding your
events to Tivoli Enterprise Console or OMNIbus, which ensures that you do not cause any event storms.
You can enable Tivoli Enterprise Console forwarding at this time. Install your first 50 agents.
Using the installation method of your choice, install several OS monitoring agents. These can be installed
locally on the server or through the remote deployment mechanism. Detailed steps on remote deployment
are included in the following sections.
Note: Because the remote deployment of application agents depends on having an OS agent running on
the server, always deploy the OS agents first.
Customizing your environment

Before progressing any further, you must perform customization to your environment. The following
sections describe this customization.
Customizing situations, workspaces, and queries:
Perform some customizations of your situations to ensure that this first set of agents do not generate
event storms. Many users choose to disable the default situations and then create their own situations.
Careful thought must be put into the naming conventions of your situations. Many users include the
following elements in their situation names.
v
v
v
v
OS type
Agent name or type, or both
Business unit
Physical location
v Severity
When choosing a name, keep in mind that the situations are sorted alphabetically in the Situation Editor. A
typical situation might look like:
v East_UNIX_High_CPU_Crit
For more information on disabling the default situations and performing bulk work on situations see the
IBM Tivoli Monitoring: Command Reference.
Choose similar naming conventions for any custom queries, managed system groups, and workspaces.
Choose the same criteria such as physical location, business unit, agent type, and so on that you used for
situations.
Another important consideration when creating situations is the Display Item, which by default, is not
enabled. If you want to generate a unique Tivoli Enterprise Console Event for each item that triggered a
situation or want to run a Take Action command against each item that triggered the situation, then you
want to select the Display Item and choose the appropriate attribute.
Changing the default monitoring server configuration settings

There are a few monitoring server configuration settings that you might want to change from the default
values. Consider changing the following settings to ensure a smooth running environment even as your
environment scales.
v KDCFC_RXLIMIT
This is the buffer used for return queries, specified in KB. The default value is 2048 KB (equivalent
to 2 MB). A value of 8192 KB (equivalent to 8 MB) seems to work well for most users.
Recommendation: 8192 KB
71
v DEPOTHOME
The location of the depot. The default location is
Windows: %CANDLE_HOME%\CMS\Depot
Linux and UNIX: $CANDLEHOME/tables/hub_tems_name/depot
Relocating the depot directory enables you to backup your Tivoli Monitoring environment without
having to backup the very large depot directory. In addition, relocating the depot directory ensures
that the depot will not fill up the filesystem where Tivoli Monitoring is running.
The target directories listed below are examples:
If CANDLE_HOME on Windows is located at C:\IBM\ITM, then relocate the depot to D:\ITM\depot
If CANDLE_HOME on Linux and UNIX is located at /opt/IBM/ITM, then relocate the depot to
/data/ITM/depot
By setting the variable in the env.config file, it remains unchanged when maintenance is applied to
your monitoring server. If you put this into your KBBENV file, it is overwritten when maintenance is
applied.
v Bind a specific IP address
KDEB_INTERFACELIST=192.100.100.100
Note: Use this option only if the monitoring server and portal server are on separate servers. If they are
on the same computer, there are going to be problems due to the multiplexed port 1920: The
tacmd command will not be able to find the monitoring server, and portal server clients will not be
able to find the portal server.
v Bind a specific host name
KDEB_INTERFACELIST=caps001
v Bind the first IPV4 address associated with the current host name to be the default interface.
KDEB_INTERFACELIST=!*
v Use an IPV4 symbolic name
KDEB_INTERFACELIST=!en0
There are many other optional parameters documented in the IBM Tivoli Monitoring: Administrator's Guide.
Review those parameters and determine whether any are required for your environment. See Tivoli
Enterprise Monitoring Server on page 299 for information on monitoring server parameters for
performance tuning.
Enabling historical collection of CandleNet Command Center logs

Some users choose to enable the historical data collection of the CandleNet Command Center logs for the
Tivoli Data Warehouse so that you can collect historical information about your situations, which can be
very useful when debugging your environment. The CandleNet Command Center logs track status of
internal Tivoli Monitoring components such as situations. Keep in mind that this requires warehouse space
and adds load to your Tivoli Monitoring environment.
Installing your first 50 agents

Using the installation method of your choice, install several OS monitoring agents. These agents can be
installed locally on the server or through the remote deployment mechanism. Because the remote
deployment of application agents depends on having an OS agent running on the server, always deploy
the OS agents first.
Remote deployment of OS agents
Tivoli Monitoring V6.2.2 provides default CreateNode and AddSystem flags using the tacmd
command to deploy OS agents as well as application agent remotely from a central location. It is
very important that the depots are created on each monitoring server (hub and remote) and that
72
you make sure the level of code, bundles and packages, in those installation depots are
consistent. You can also use the shared depot. If a shared directory is accessible to all monitoring
servers, it can be mounted across the monitoring server environment. This reduces the
maintenance workload, since you have only one directory to maintain in a shared location, rather
than maintaining depot directories on each monitoring server.
Post-installation checklist
Use this post-installation checklist to ensure the following items have been completed:
v Monitoring server (situations created)
v Portal server (check all aspects of portal server functionality such as workspaces)
v Perform a complete backup of all Tivoli Monitoring components
Configuring your warehouse agents

Now that you have your first 50 agents up and running smoothly, it is time to configure your Warehouse
Proxy agent and Summarization and Pruning agent. There are the two major components to configuring
your warehousing.
v First, configure the two agents and specify all of the steps necessary for the agents to communicate
with the database server. These steps are done through the configuration panels that appear when you
reconfigure the agents. Follow the steps in the install guide when performing this configuration. Choose
the summarization and shift options that you chose during the planning phase.
v The second aspect to warehousing is to decide which attribute groups you are going to collect and at
what intervals. Always use the Warehouse load projection spreadsheet before enabling additional
historical collection. Thus, ensuring that you do not overload your warehouse environment. Start slowly
and incrementally add attribute groups to your historical collection. This allows you to confirm that
everything is working properly before you add more data to your warehouse.
Enable one attribute group at a time and verify that the data is being collected, summarized and pruned
properly. At this point, you can also see how many rows are getting written per data collection interval
for the attribute group, by examining the entries in the WAREHOUSELOG table. The number rows
written per interval is an important input parameter for the Warehouse load projection spreadsheet.
At this point, install the warehouse monitoring solution that is available at the Tivoli Open Process
Automation Library (OPAL) by searching for "Data Warehouse DB activity" or navigation code
"1TW10TM1X."
In addition, you must create a critical situation that monitors both your Warehouse Proxy agent and
Summarization and Pruning agent to ensure that they are running. If they are not running, the situation
must run a Take Action to automatically restart those agents.
When configuring and starting your Summarization and Pruning agent, do not forget to set the
KSY_MAX_WORKER_THREADS to the appropriate number for your environment. See Locating and
sizing the Summarization and Pruning agent on page 44 for recommendations on the number of worker
threads.
If you have configured some or all of your monitoring agents to run autonomously, you might want to
configure the Warehouse Proxy and Summarization and Pruning agents to run autonomously as well. See
Running the warehouse agents autonomously on page 448 for more information.
73
Installing additional agents

At this point in your deployment, keep things simple by deploying a single hub monitoring server, a portal
server, the warehouse components, and a couple of remote monitoring servers. If warehousing is critical, it
can be enabled at this point. The environment must be evaluated thoroughly before moving beyond the
initial 50 agents.
After the first 50 agents are deployed, deploy additional agents in groups of approximately 200, which
allows you to verify all of the agents before progressing to the next step. As you scale up your
environment and become comfortable with the deployment and validation of agents, you can increase the
number of agents being deployed to 400 or 500 at a time.
74
Chapter 4. Post-deployment phase

Now that you have your Tivoli Monitoring V6.2.2 environment in production, there are some important
steps that need to be taken to ensure your environment stays up and running and healthy. This includes
applying routine maintenance and performing periodic health checks. The post-deployment phase is
divided into two sections: Applying maintenance and Maintaining an efficient monitoring environment on
page 77.
Applying maintenance
This section outlines the planning and implementation steps necessary to install maintenance in your Tivoli
Monitoring V6.2.2 environment. Routine maintenance is outlined in the following sections:
v Planning an upgrade
v Upgrade steps
v Post-upgrade health check on page 76
Planning an upgrade
Use the following checklist to plan your upgrade:
v Check that the plan is in place for upgrading the environment (upgrade the environment incrementally).
Follow a formal change management plan for Tivoli Monitoring upgrades and include, at minimum, both
a deployment and tested backout plan.
v Download the correct upgrade media, not the fresh installation media.
v Back up all Tivoli Monitoring core components such as monitoring server and portal server.
v Carefully review the appropriate Fix Pack Readme and Documentation Addendum for any prerequisites.
Attention: Before upgrading your infrastructure components and beginning the upgrade process, perform
a cold backup of your hub monitoring server, portal server, portal client, Warehouse Proxy
agents, Summarization and Pruning agents, and remote monitoring server. Back up the
following key components:
v Portal server database
v Warehouse database
v Full system backups and file system backups for installed Tivoli Monitoring components
Upgrade steps
When performing upgrades read this Installation and Setup Guide or the supplied fix pack readme
carefully. Perform your install in the following order:
Note: This order might vary depending on the content of the release and the fix pack.
1.
2.
3.
4.
5.
6.
7.
Event Synchronization
Warehouse including Warehouse Proxy agent and Summarization and Pruning agent
Hub Tivoli Enterprise Monitoring Server
Remote Tivoli Enterprise Monitoring Server
Run any scripts necessary to update the Warehouse schema
Tivoli Enterprise Portal desktop client
8. Update monitoring agents

In some cases, when you upgrade the infrastructure components you will also be upgrading the
monitoring agents on those servers. It is okay to upgrade those monitoring agents at that time.
75
For more information about installing fix packs, see Installing product maintenance on page 236.
Post-upgrade health check

Use the following checklist for your post-upgrade health check:
v Check if the predefined and user-created workspaces that were present prior to the upgrade are still in
place.
Log in to the portal server using the portal browser or desktop client and browse through the different
workspaces for each product type.
v Check if the predefined and user-created situations that were present prior to the upgrade are still in
place.
Log in to the portal server using the portal browser or desktop client and browse through different
situations in the Situation Editor or run the tacmd listsit command.
v Check if all the catalogs are the same on each monitoring server (hub and remote). Try one of the
following two approaches:
Run grep on each monitoring server (hub and remote). For example:
grep @ * | awk {print $2, $3, $4, $5} | sort
Run the following SQL against each monitoring server in a portal server view:
"SELECT APPL_NAME, TIMESTAMP FROM SYSTEM.SYSAPPLS AT (REMOTE_TEMS) ORDER BY APPL_NAME"
v Check if the depots populated on each monitoring server (hub and remote) are the same.
Run these commands from the hub monitoring server.
tacmd viewdepot
tacmd viewdepot -j remote_tems
v Check if the warehouse data is visible through the workspace views, meaning the portal server still has
the correct connection to the warehouse database.
Select the attribute group for which history collection is enabled by checking that view and making sure
the data can be pulled for more than 24 hours.
v Check if the agents are online and connected to the expected remote monitoring server.
Run the tacmd listSystems command.
v Check if the situations are firing and events are being forwarded to Tivoli Enterprise Console or
OMNIbus.
Run the command on the Tivoli Enterprise Console server using wtdumprl or drag the Tivoli Enterprise
Console icon to any view to view the events.
v Check if the historical configuration is active.
Log in to the portal server using the portal browser or desktop client and click History Configuration.
Browse through the desired attribute groups to see if they are still active.
Or you can run this query: "SELECT NODEL, OBJNAME, LSTDATE FROM O4SRV.TOBJACCL WHERE OBJNAME
LIKE 'UADVISOR*'"
v Check if the Warehouse Proxy agent and Summarization Pruning agents correctly started, meaning the
agents made successful connections to warehouse database.
You can examine the WAREHOUSELOG table to see the last updates by each attribute group. See
sample below:
SELECT ORIGINNODE AS "Agent Hostname", OBJECT AS "Attribute Group",
EXPORTTIME AS "Export Time", ROWSRECEIVED AS "Received Rows",
ROWSINSERTED AS "Inserted Rows", ROWSSKIPPED AS "Skipped Rows",
ERRORMSG AS "Error Message" FROM WAREHOUSELOG
Note to Windows users: If you attempt to run a tacmd CLI command and either the Embedded Java
Runtime or the User Interface Extensions are not available on the node where
you invoke the command, you will receive the error shown in Figure 25 on page
189
76
189. If this happen, complete the procedure outlined in Installing the

Embedded Java Runtime and the User Interface Extensions on page 189, and
retry the tacmd command.
Maintaining an efficient monitoring environment

This section covers the daily, weekly, monthly, and quarterly routine health checks on the Tivoli Monitoring
V6.2.2 enterprise environment.
v Daily health checks on page 78
v Weekly health checks on page 78
v Monthly health checks on page 78
v Quarterly health checks on page 79
By performing these routine procedures in addition to your daily, weekly, monthly and quarterly health
checks, you ensure that your Tivoli Monitoring environment continues to run smoothly.
v Run the taudit.js tool which can be found in the Tivoli Open Process Automation Library (OPAL) by
searching for "Web SOAP scheduled reporting tools" or navigation code "1TW10TM0U." This tool
provides an overall status of the environment. Run this tool every day.
v Take a monitoring server backup every 24 hours in early stages and then move to weekly backups. If
you have snapshot software, you can take backups with the monitoring server or portal server, or both
online. Otherwise, shutdown the monitoring server and portal server before taking a backup. Test these
backups after you first develop the process and at least twice a year thereafter by restoring to a
monitoring server in your test environment to ensure the backups are successfully backing up the data
you need to restore your production monitoring server in the event of an outage or need for rolling back
to a previous state.
v Make sure the portal server database backup is in the plan and is being made daily as the environment
is being rolled out and then weekly as the environment matures and less frequent changes are made to
the environment. Test these backups after you first develop the process and at least twice a year
thereafter by restoring to a portal server in your test environment to ensure the backups are
successfully backing up the data you need to restore your production portal server in the event of an
outage or need to rollback to previous state.
v Make sure the DB2 warehouse backup is in the plan and is being made weekly. The reason you need
to do this weekly is because of huge database size.
v Check daily that the warehouse agent is performing by looking at the warehouse logs
(hostname_hd_timestamp-nn.log).
v Check daily that the Summarization and Pruning agent is performing by looking at the
(hostname_sy_timestamp-nn.log) logs.
v Check the monitoring server (hostname_ms_timestamp-nn.log) and portal server logs
(hostname_cq_timestamp-nn.log) for any obvious errors and exceptions.
v Check that there are no monitoring servers overloaded with agents. One way to do this is by checking
the "Self-Monitoring Topology" workspace, which has a "Managed Systems per TEMS" view showing
the number of agents reporting to each monitoring server.
v For DB2, run the REORGCHK and RUNSTATS on the warehouse database daily.
v For DB2, run the REORGCHK and RUNSTATS on the portal server database weekly.
v Check that events are reaching the Tivoli Enterprise Console server or OMNIbus. It is also important to
check that events from custom Universal Agents reach the event server.
v Check that all the fired situations are answered with a response and are not in open state for a long
period of time.
v Check that the Tivoli Enterprise Monitoring Server can communicate to each of the monitoring agents.
The easiest way to test this is to run the taudit.js tool (mentioned above).
77
v Check the core components process memory and CPU usage and that you have situations created to
monitor them.
Daily health checks

Use the following list to perform daily health checks.
Tasks
v Make sure all of the systems from the day before are still online. A quick look at the Managed System
Status workspace shows the status of each managed system. If you encounter managed systems that
are offline investigate them individually.
There are several reasons why a managed system can go offline. The agent might have gone offline for
some reason, there may be communication problems between the agent and the monitoring server that
it is connected to or the agent was decommissioned. In any case the cause of the problem must be
found and addressed. Run a script every morning that provides a report on ONLINE and OFFLINE
systems, Taudit.js can be used for this purpose.
v You might find situations that are in open status that have not been addressed (acknowledged).
Determine if the problem reported by the situation is valid. Determine if there is really a problem or is it
a case where the situation does not have the correct thresholds and is producing a false positive that is
being ignored by the monitoring staff. Make sure your situations are reflecting real events, which helps
train the monitoring staff to react to each event that goes true in the Tivoli Monitoring environment.
v If you have decided to collect historical data and are using the Tivoli Data Warehouse, make sure the
Warehouse Proxy agent and Summarization and Pruning agents are up and running. Check the logs for
both to make sure the agents are collecting and summarizing data on the intervals you have set. To find
a solution that allows you to monitor the warehouse activity to ensure that it is functioning properly,
search for "Data Warehouse DB activity" or navigation code "1TW10TM1X" in the Tivoli Open Process
Automation Library (OPAL).
v Spot-check the workspaces for several different monitoring agent types to make sure report data is
being returned.
Weekly health checks

Use the following list to perform weekly health checks.
Tasks
v Include all of the items in the daily health check.
v Check system backups. Have a mechanism in place for backing up your core Tivoli Monitoring
components in the event of recovery. The portal server, monitoring server, and warehouse must be
backed up on a regular interval. That interval must be decided by you, but make it no less than a
weekly backup. Daily backups of the portal server and monitoring server databases are highly
recommended because of their constant change.
v Check warehouse data. Make sure you are collecting the last weeks worth of data and it is correct. You
can accomplish this by using the portal client to run the weekly summarization reports. The summarized
data returned must accurately reflect the past weeks worth of summarized data.
Monthly health checks

Use the following list to perform monthly health checks.
Tasks
v Include all of the checks from the daily and weekly item checklist.
v If you are collecting historical data and storing it in the warehouse make sure your monthly
summarization is correct. Validate this by running reports from the portal client to ensure you have the
correct monthly summarized data.
78
v Check the list of managed systems deployed in your Tivoli Monitoring environment. Take note of their
maintenance levels. Check with IBM Software Support or your IBM account representative to see if new
fix packs and interim fixes are available. If so, determine what has been fixed so you can decide if you
want to deploy the patches to your environment or just wait until the next major fix pack.
v Once again check your situation thresholds to make sure you dont have false positive events. In large
user environments there are many factors that can have an affect on how a system performs. The
change in performance in any system can change the way Tivoli Monitoring V6.2.2 reports status for
any given system. Make sure the events active in Tivoli Monitoring are real.
v Take inventory of the systems being managed by Tivoli Monitoring. There might be a need to deploy
additional agents on new systems or systems where new applications have been added.
v Assess the capacity of the infrastructure systems for resource CPU, memory and disk utilization to
continually plan for overall workload balancing. As new versions of applications are introduced into the
environment, their affect on resources typically change. This ongoing effort helps ensure the correct
hardware is in place. Confirm the number of agents connected to each remote monitoring server to
ensure that you have not exceeded the recommended limit of 1500 agents.
Quarterly health checks

Use the following list to perform quarterly health checks.
Tasks
v Include all of the checks from the daily, weekly, and monthly checklist.
v Discuss the usage of the historical data with the end users who rely on the data for various reasons.
You might find they are not looking at some of the data being collected and no longer need it. In this
case, turn off the collection so you are not using unnecessary resources. The same holds true for the
reverse. There might be data missing that is needed and historical collection can then be activated for
the necessary information.
v Check with IBM Software Support or your IBM account representative for fix packs on all IT
components. Regular maintenance fix packs for each component are typically delivered on a quarterly
basis. Look through the Readme files and decide if you feel it is necessary to install the fix pack. Install
the latest fixes for any of the components.
79
80
Part 3. Installation and initial configuration of base

components and agents
The chapters in this section provide instructions for installing and configuring base components and
agents. If you are installing Tivoli Monitoring for the first time, review the chapters in the preceding section
before you use the chapters in this section.
Chapter 5, Preparing for installation, on page 83, helps you collect the information you will need during
installation and configuration and details the hardware and software requirements for various components
and configuration.Supported databases
Chapter 6, Upgrading from a previous installation, on page 115, provides instructions for upgrading an
existing installation of OMEGAMON Platform 350/360 or IBM Tivoli Monitoring version 6.1 to version 6.2.
Chapter 7, Installing IBM Tivoli Monitoring on one computer, on page 139, contains instructions for
installing the base components on a single Windows computer. This scenario is useful for creating a test
or teaching environment or for monitoring a small environment.
Chapter 8, Installing IBM Tivoli Monitoring, on page 147, contains instructions for installing each of the
base components on Windows, UNIX and Linux (command and GUI installations) computers and for
completing the initial configuration of those components. It also contain procedures for installing and
configuring the base agents and for installing support for those agents on the Tivoli Enterprise Portal and
the Tivoli Enterprise Monitoring Server.
Chapter 9, Deploying monitoring agents across your environment, on page 237, provides instructions for
deploying distributed monitoring agents from a monitoring server.
81
82
Chapter 5. Preparing for installation

The following sections provide information to help you prepare to install your IBM Tivoli Monitoring
environment.
Overview of the installation process

The following table provides an overview of the steps required to fully install and deploy an IBM Tivoli
Monitoring environment.
Table 10. Installation and configuration steps
Step
Where to find detailed information
Assess your monitoring needs to determine the best

deployment of IBM Tivoli Monitoring components.
Chapter 2, Pre-deployment phase, on page 27
Ensure you have the required hardware and software.
Hardware and software requirements on page 96
Gather any information required for successful installation Specific information to have ready
(such as DB2 user information and security
Appendix A, Installation worksheets, on page 529
specifications).
Install the Tivoli Enterprise Monitoring Server.
Installing and configuring the hub Tivoli Enterprise

Monitoring Server on page 148
Install the Tivoli Enterprise Portal Server.
Installing the Tivoli Enterprise Portal Server on page 162
Install the management agent software.
Installing monitoring agents on page 183
Install support for IBM Tivoli Enterprise Console.
Chapter 21, Setting up event forwarding to Tivoli

Enterprise Console, on page 463
Install the portal desktop client on any system where you

want to use it.
Installing the Tivoli Enterprise Portal desktop client on

page 193
Start the portal client to verify that you can view the
monitoring data.
Starting the Tivoli Enterprise Portal client on page 232
If you are upgrading from IBM Tivoli Monitoring V6.1 or OMEGAMON Platform 350 or 360 and CandleNet
Portal 195, see Chapter 6, Upgrading from a previous installation, on page 115 before installing any IBM
Tivoli Monitoring components.
If you are upgrading from Tivoli Distributed Monitoring to IBM Tivoli Monitoring, see the IBM Tivoli
Monitoring: Upgrading from Tivoli Distributed Monitoring guide.
If you are upgrading from IBM Tivoli Monitoring V5.x to V6.2, see IBM Tivoli Monitoring: Upgrading from
V5.1.2.
If you plan to use firewalls in your environment, see Appendix C, Firewalls, on page 551 for an overview
of the IBM Tivoli Monitoring implementation of firewalls.
Specific information to have ready

During installation, you must supply the following information:
v Name of the monitoring server you are installing or to which the agent will connect
v Host name for the computer where you are installing the product (a monitoring server or one instance of
an agent)
v Whether the monitoring server being installed or being connected to is configured as a hub or remote
monitoring server
83
v Hub monitoring server host name

v Port number
Use the worksheets in Appendix A, Installation worksheets, on page 529 to collect this information for
each component that you want to install.
Information to gather for event forwarding

You need the following additional information to successfully install and configure event forwarding and
synchronization between a hub Tivoli Enterprise Monitoring Server and either IBM Tivoli Enterprise
Console or Netcool/OMNIbus:
v Host names, user IDs, and passwords for the monitoring servers that you want to receive events from.
v The amount of free space in your temporary directory. The installation requires 200 MB of temporary
space.
v Simple Object Access Protocol (SOAP or Web Services) information to send events to a monitoring
server (the URL, the rate to send requests to the server).
By default, all monitoring servers are configured as SOAP servers. If you did not change this
configuration to make it unique for your environment, you can accept the default values during the
installation.
If you did change this configuration, use the SOAP information unique to your configuration.
v For TEC, the host of the event server or servers to which events are being forwarded and the port on
which it is listening. For Netcool/OMNIbus, the host of the EIF probe and the port on which it is
listening.
v For TEC, event rule base information (either the name of a new rule base to create or the name of an
existing rule base to use)
Notes:
1. For a Windows event server, any existing rule base that you use must indicate a relative drive letter
(such as C:\) as part of its associated path. To verify that your existing rule base contains a relative
drive letter, run the following command from a bash environment on your event server:
wrb -lsrb -path
If the returned path includes something like hostname:\Rulebase_directory, with no drive letter (such
as C:\), copy the ESync2200Win32.exe file from the \TEC subdirectory of the IBM Tivoli Monitoring
installation image to the drive where the rule base exists and run the installation from that file.
2. If you are using a Windows event server, if you have any rule base with an associated path that
does not contain a relative drive letter and that has the Sentry2_0_Base class imported, copy the
ESync2200Win32.exe file from the \TEC subdirectory of the IBM Tivoli Monitoring installation image to
the drive where the rule base exists and run the installation from that file.
To verify if you have any rule bases that have an associated path containing no relative drive letter,
run the wrb -lsrb -path command as described in the previous note.
To determine if your rule bases have the Sentry2_0_Base class imported, run the following
command against all of your rule bases:
wrb -lsrbclass rule_base
where rule_base is the name of the rule base.
Naming your monitoring server

You must decide how the monitoring servers are to be named. In general, create names that are short but
meaningful within your environment. Use the following guidelines:
v Each name must be unique. One name cannot match another monitoring server name for its entire
length. (For example, "ibm" and "ibmremote" are unique and permitted.)
v Each name must begin with an alpha character. No blanks or special characters ("$#@") can be used.
84
v Each name must be between 2 and 32 characters in length.

v Monitoring server naming is case-sensitive on all platforms.
Choose between IPv6 and IPv4

IP version 6 (IPv6) communication can now be enabled between any two IBM Tivoli Monitoring
components; possible configurations include communications between the portal server and the hub
monitoring server, a remote monitoring server and the hub, or an agent and a hub. Both components need
to be at version 6.2, with the exception of agents, which can be at version 6.1.
To use this capability, your IBM Tivoli Monitoring environment must be configured and enabled for IPv6
communication. IPv6 communication over IPv4-only networks is not supported.
Before components can be enabled for IPv6 communication, the following requirements must be met:
1. The host on which the components are located must be enabled for IPv6.
2. If the component needs to communicate using IPv6 with some components and IPv4 with others, the
host must be enabled for dual-stack operation.
Note: A dual-stack host provides two discrete network layers. The term stack here refers to the
protocol stack, a suite of protocols used in computer networking software.
3. The host must have DNS or hosts file entries for both IPv4 and IPv6 addresses. The host must also be
configured to resolve host names and IP addresses from the DNS or from the hosts file.
4. The network path between the two components must be enabled for IPv6 traffic. Tunneling of IPv6
traffic over IPv4 networks is not supported.
Table 11 shows the supports combinations of IPv6 with IPv4 across the various IBM Tivoli Monitoring
components.
Table 11. Supported IBM Tivoli Monitoring configurations using the IPv6 communications protocol
Valid
configurations Portal client
IPv6 only
IPv6 with IPv4
IPv6
IPv4
Portal server
Hub
monitoring
server
IPv6
IPv6
IPv4 or IPv6
IPv4 or IPv6
Agents
Remote
monitoring
server
Agents
IPv6
IPv6
IPv6
IPv4 or IPv6
IPv41
IPv4
Notes:
1. All agents running on a computer must be configured to use the same protocol, either IPv4 or IPv6.
2. In scenarios where some agents are on IPv4-only computers or the network between the agents and
the monitoring servers they report to is IPv4 only, these agents need to communicate with the
monitoring servers over IPv4. The monitoring servers therefore may communicate with some agents
over IPv4 and with others over IPv6.
3. The portal server does not support IPv6 on the Windows platform. If the portal server is on Windows,
the browser and desktop clients need to communicate with it using IPv4.
4. Components do not operate in dual-stack mode on the Solaris platform. Components can be
configured to communicate using either IPv4 or IPv6. Thus, if a hub server on a Solaris host is
configured to use IPv6, the portal server, all remote servers, and all agents connecting to the hub must
be configured to use IPv6 for communicating with the hub.
5. On HP-UX, patch PHNE_29445 is required for IPv6 support.
6. Components do not operate in dual-stack mode on the HP-UX HP9000 platform (although dual-stack
mode is supported on the HP-UX Integrity platform). Components can be configured to communicate
using either IPv4 or IPv6. Thus, if a hub server on an HP9000 host is configured to use IPv6, the
portal server, all remote servers, and all agents connecting to the hub must be configured to use IPv6
for communicating with the hub
85
7. On Linux computers, a minimum kernel level of 2.6 is required for IPv6 support.
Monitoring components, when installed and configured using the appropriate platform-specific configuration
tools, are initially configured only for IPv4 communication on all platforms except z/OS (where your ICAT
settings govern the protocol used). On all other platforms, you must perform supplemental configuration
steps to reconfigure Tivoli Monitoring components to communicate using IPv6.
Required order of installation or upgrade of IBM Tivoli Monitoring

component products
If any of the following products will be installed on the same computer as monitoring agents, they must be
installed before the agent is installed:
v Hub Tivoli Enterprise Monitoring Server
v Remote monitoring server (if necessary)
v Tivoli Enterprise Management Agent Framework
v Tivoli Enterprise Portal Server
v Tivoli Enterprise Portal desktop client
In addition, these products must be installed on at least one computer before the agent can be properly
configured. The appropriate Tivoli Enterprise Management Agent Framework is installed when an agent is
installed.
Windows installation considerations

The following sections provide information about issues unique to Windows installations.
User authority
To install IBM Tivoli Monitoring on a Windows computer, you must have Administrator privileges on that
computer. You must also run the IBM Tivoli Monitoring components as a user with Administrator privileges.
32 bit versus 64 bit

If your site runs either Windows 2003 or 2008 on 64-bit x86-64 CPUs, you must decide whether to install
the 32-bit operating system agent or the 64-bit agent. The new 64-bit agent supports 64-bit operations and
can coexist with other 32-bit agents in your Tivoli Monitoring environment.
Notes:
1. Direct upgrade of the 32-bit Windows agent to the 64-bit agent is not supported. When upgrading a
32-bit agent from a prior release to the current release, you can upgrade only to the current 32-bit
agent.
2. This new support does not extend to native 64-bit applications (including the operating system) running
on the Itanium IA64 architecture.
3. This 64-bit support has not been extended to either the IBM Tivoli Monitoring servers (the Tivoli
Enterprise Monitoring Server and the Tivoli Enterprise Portal Server) or the Tivoli Data Warehouse
agents (the Warehouse Proxy agent and the Summarization and Pruning agent).
Installation using a Citrix client

If you are using a Citrix client to access the IBM Tivoli Monitoring installation program for Windows through
Microsoft Windows Terminal Services, you must manually change Terminal Services to install mode before
running the installation. To change Terminal Services to install mode, run the change user /install
command before starting the installation. After installation, run the change user /execute command to
return Terminal Services to normal mode.
86
Linux or UNIX installation considerations

The following sections provide information about issues unique to Linux and UNIX installations:
v Changes in the behavior of the autostart scripts
v Create an IBM Tivoli account for installing and maintaining the installation directory on page 90
v Host name for TCP/IP network services on page 91
v
v
v
v
v
Use of fully qualified path names on page 91

Multiple network interface cards on page 91
Installing into an NFS environment on page 91
Installing into Solaris zones on page 92
File descriptor (maxfiles) limit on UNIX and Linux systems on page 93
Changes in the behavior of the autostart scripts

The behavior of the autostart scripts generated during installation and configuration on UNIX platforms has
evolved.
v In V6.1 fix pack 3, the installation process produced an autostart script with only one entry using a
generic CandleAgent start all command. Users modified this file as needed.
v In V6.1 fix pack 4, the installation process generated individual entries for each application in a
particular installation, but the values captured in the file could not be overridden.
v In V6.1 fix pack 5, the multiple entries remain, and an override capability has been added.
v In V6.2.2 fix pack 2, the multiple entries remain, and the override capability has been significantly
enhanced.
The autostart script generated by an installation, upgrade, or configuration and named ITMAgentsN or
rc.itmN (depending on the UNIX platform) contains an entry for each application in a particular installation.
The entries look similar to this:
su - USER -c "ITM_Install_Home/bin/itmcmd agent start product_code"
Or:
su - USER -c "ITM_Install_Home/bin/itmcmd agent o Instance start product_code"
Where:
USER
Is the ID that the application will be started as. By default, USER is the owner of the bin directory for
the application. For the UNIX Log Alert agent, USER is the owner of the ITM_Install_Home/PLAT/ul/bin
directory.
N
Is an integer specific to each installation on a system.
ITM_Install_Home
Is the full path to the IBM Tivoli Monitoring version 6.x installation directory.
product_code
Is the two-character code for this application. Refer to Appendix D, IBM Tivoli product, platform, and
component codes, on page 567 for a list of the codes for the common components and the base
agents. See the product documentation for other product codes.
instance
Is the instance name required to start this application.
PLAT
Is the platform directory where the application is installed.
87
Components are started in the order listed in the autostart script. This order is based on the dependencies
between components, rather than any logical sequence.
The kcirunas.cfg file was added to allow overrides to the default processing. The kcirunas.cfg file is
delivered in the root directory of the installation media, in the same location as install.sh. During
installation, this file is copied to the ITM_Install_Home/config directory (but is not overwritten if this file
already exists). This file is provided as a sample file with each section commented out. You do not have to
modify this file if you want the autostart script to be generated with the default processing.
For local installation usage, you may modify the kcirunas.cfg file in the root directory of the media if you
want to use the same set of values for multiple installations on similar systems from this image. You may
also modify the kcirunas.cfg file in the ITM_Install_Home/config directory if you want to use a specific
set of values for each individual installation from this image.
For remote deployment usage, you can modify the kcirunas.cfg file in the root directory of the media. You
can also modify the kcirunas.cfg file in the Tivoli Enterprise Monitoring Server depot after populating the
depot from this image. If you have set the DEPOTHOME variable in the tables/TEMS_NAME/KBBENV file, you
must use that value as the base when searching for the depot location. To determine if you have set
DEPOTHOME, run the following commands:
cd ITM_Install_Home
DEPOTHOME=`find tables -name KBBENV -exec grep DEPOTHOME {} \; 2> /dev/null | cut -d= -f2`
echo $DEPOTHOME
If DEPOTHOME is not empty, run the following commands to locate kcirunas.cfg in the monitoring server
depot:
cd ITM_Install_Home
DEPOTHOME=`find tables -name KBBENV -exec grep DEPOTHOME {} \; 2> /dev/null | cut -d= -f2`
find $DEPOTHOME -name kcirunas.cfg -print
If DEPOTHOME is empty, run the following commands instead:

cd ITM_Install_Home
find tables -name kcirunas.cfg -print
The file kcirunas.cfg contains a superset of the XML syntax and structure in the ITM_Install_Home/
config/HOST_kdyrunas.cfg file (where HOST is the short hostname for this system) produced by remote
configurations, such as remote deployment or Tivoli Enterprise Portal-based agent configuration.
The entries in kcirunas.cfg do not affect the actions performed for remote deployment, remote
configuration, remote starting or stopping, or any Tivoli Enterprise Portal-initiated agent action. The entries
in HOST_kdyrunas.cfg affect the generation of the reboot script. The entries in kcirunas.cfg also affect the
generation of the reboot script, and they override any entries for the same component in
HOST_kdyrunas.cfg.
The following is the default kcirunas.cfg file with all <productCode> entries commented:
<agent>
<!productCode>ux</productCode>
<instance>
<user>itmuser</user>
</instance>
<!productCode>ul</productCode>
<instance>
<user>root</user>
</instance>
<!productCode>lz</productCode>
<instance>
88
</instance>
<!productCode>ud</productCode>
<instance>
<name>db2inst1</name>
<user>db2inst1</user>
</instance>
<instance>
<user>root</user>
</instance>
<!productCode>ms</productCode>
<instance>
<name>HUB17</name>
</instance>
<!productCode>cq</productCode>
<instance>
</instance>
<!productCode>cj</productCode>
<instance>
</instance>
</agent>
By default, each <productCode> section in the kcirunas.cfg file is disabled by making the product code
a comment, such as <!productCode>. To activate a section, do the following:
1. Remove the comment indicator (the exclamation point, !) so that the <!productCode> item looks like
<productCode>.
2. Copy a <productCode> section.
3. Rather than creating new sections from scratch, customize each <productCode> section, and activate
it.
Commented, or deactivated, sections are ignored. Uncommented, or activated, sections for applications
that are not installed are ignored. For agents that do not require an instance value, specify only:
<productCode>product_code</productCode>
<instance>
<user>USER</user>
</instance>
For agents that do require an instance value, like the DB2 monitoring agent (product code ud), specify the
product_code, instance, user, and name:
<productCode>ud</productCode>
<instance>
</instance>
<instance>
<user>root</user>
</instance>
Two items that are supported in the kcirunas.cfg file that are not supported in the HOST_kdyrunas.cfg file
are the <default> section and the <autoStart> flag. The <autoStart> flag can be used in the <default>
section and in the <instance> section. The <default> section is specified as follows:
89
<default>
</default>
<default>
<autoStart>no</autoStart>
</default>
<default>
</default>
The <autoStart> flag is specified as follows:

<default>
</default>
<instance>
</instance>
A section similar to the following can be used to not automatically start the default MQ Monitoring instance
and to automatically start all other instances as the mqm user:
<productCode>mq</productCode>
<default>
<user>mqm</user>
</default>
<instance>
<name>None</name>
</instance>
A set of sections similar to the following can be used to avoid automatically starting the set of installed
agents and servers. You need one section for each agent or server component installed:
<default>
</default>
Where product_code is the two-character product code for the individual agent or server component (refer
to Appendix D, IBM Tivoli product, platform, and component codes, on page 567).
Notes:
1. Any changes made directly to the autostart script (ITMAgentsN or rc.itmN, depending on the platform)
will not be preserved and will be overwritten the next time you install, configure, or upgrade an
application.
2. Any changes made to the AutoRun.sh script will not be preserved and will be overwritten the next time
you apply higher maintenance.
Create an IBM Tivoli account for installing and maintaining the

installation directory
Create an IBM Tivoli account for installing and maintaining the installation directory. For best performance,
follow these guidelines:
90
Note: This option does not apply to configuring the portal server on Linux systems where you may use a
nonroot IBM Tivoli Monitoring user ID to install the portal server. If you do, you must then use the
root user ID to configure the portal server because the DB2 installation or administrator ID may lack
the necessary privileges.
v
v
v
If, however, you use either the root user ID, the DB2 installation ID, or the DB2 administrator ID to
install the portal server, you must use that same user ID to configure it. You can then use your
nonroot Tivoli Monitoring user ID to run the portal server
You can use any valid name.
You can install the IBM Tivoli Monitoring software as the root user, but you do not have to. If you do not
install as a root user, you must follow the steps outlined in Changing the file permissions for agents on
page 191 after you install any monitoring agents.
Use the same user to install all components.
If you are using NFS or a local file system, establish your installation directory according to the
guidelines used in your environment.
Only the Korn shell is supported for the execution of the installation and runtime scripts. Consider using
the Korn shell as the default environment for your IBM Tivoli login account.
Host name for TCP/IP network services

TCP/IP network services such as NIS, DNS, and the /etc/hosts file must be configured to return the fully
qualified host name (for example: HostName.ibm.com). Define the fully qualified host name after the
dotted decimal host address value and before the short host name in the /etc/hosts.
Use of fully qualified path names

Because of the wide variety of UNIX operating systems and possible user environments, use fully qualified
path names when entering a directory during the installation process (do not use pattern-matching
characters). IBM scripts use the Korn shell. When a new process or shell is invoked, use of symbolic links,
environmental variables, or aliases can potentially cause unexpected results.
Multiple network interface cards

When more than one network interface card (NIC) exists in the computer on which the monitoring server is
installed, you need to identify which NIC to use when specifying the monitoring server name and host
name. Additionally, the host name of the system might not match the interface name, even when only one
NIC exists. In either of these cases, to establish connectivity between the monitoring server and agents,
you must specify an additional variable when configuring the monitoring server or agents. This variable is
listed under the Optional Primary Network Name option in the configuration windows or during the
installation.
If the host of the Tivoli Enterprise Portal Server has more than one NIC, you need to configure an
additional interface for each one.
Installing into an NFS environment

IBM supports installing IBM Tivoli Monitoring in NFS environments. Using NFS, you can concentrate your
software and data in a specific location, minimizing maintenance, administrative overhead, and disk space.
Although using NFS to support multiple hosts simplifies the maintenance of installed IBM Tivoli products,
its use can impact performance. If you are installing into an NFS environment, consider the administrative
savings to the possible impact on the performance of your network.
Consider the number of hosts that share a single installation directory, as well as the effects of network
congestion and file system performance on the overall response time of your IBM Tivoli products.
91
NFS also has some trade-offs in how you manage your environment. While you can have your entire IBM
Tivoli Monitoring in one place, there might be additional configuration required to define the use of specific
products or processes in your installation directory. Will every product on every host system execute using
the same configuration; or will you tailor the configuration to the particular environment?
Note: If installing from images on an NFS mount, the NFS mount needs world execute permissions to be
accessible by the installation processes.
Installing into Solaris zones

There are limitations that must be taken into consideration when installing into zones that share resources.
Big local zones share no resources with other zones, so there are no limitations on installing into a Big
Local zone. For local zones that share resources, there are the following limitations:
v Anything installed outside of $CandleHome must:
Be installed in the global zone, OR
Grant local zone write access to the global zone directory tree
v Any devices used by an agent to obtain statistics must be linked to the Local zone.
v During installation of the Tivoli Enterprise Monitoring Server, the GSKit library can be installed from an
alternate directory within the local zone. To accomplish this, edit the ms.ini file for the monitoring server,
and add the extra library path to the LD_LIBRARY_PATH concatenation.
GSKit, the Global Security Toolkit, provides SSL (Secure Sockets Layer) processing within protocols
such as SPIPE and HTTPS.
The following sections describe the types of zones and the installation possibilities for each.
Global Zone:
The main administration zone. Both local and remote installation is possible. GSKit installs into the
standard location for Solaris, and the links are created in the standard location for Solaris.
Big Local Zone:
A local zone with no shared file system resources. Local and remote installation is possible. GSKit installs
into the standard location for Solaris, and the links are created in the standard location for Solaris. These
locations are local to this zone and not shared with any other zone.
Small Local Zone:
A local zone with some shared file system resources. Local and remote installation is possible if /opt is not
a shared resource. GSKit installs into the standard location for Solaris, but the links are created in the new
default location of $CANDLEHOME/gsklinks. These locations are local to this zone and not shared with
any other zone.
Default Small Local Zone:
A local zone with the default set of shared file system resources. This is a Small Local Zone with /sbin /lib
/usr and /export directories shared with global zone. These directories are read-only file systems in local
zone. Local and remote installation is possible. GSKit installs into the standard location for Solaris, but the
links are created in the new default location of $CANDLEHOME/gsklinks. These locations are local to this
zone and not shared with any other zone.
Small Local Zone with /opt directory shared:
92
Local and remote installation is not possible. Tivoli Monitoring installation always requires read-write
access to the /opt directory. This is not only a GSKit issue. Even if CANDLEHOME is specified as the
nondefault directory, read-write access to /opt/IBM/ITM/tmaitm6/links is still needed.
Note: In all supported Small Local Zone configurations, the Tivoli monitoring interactive command line
installation prompts you for the parent directory where the links will be created. For example, if you
enter /tmp for the directory, the links will be created in the /tmp/usr/lib and /tmp/usr/bin directories.
The default directory for this prompt is $CANDLEHOME/gsklinks. During remote installation, the
default directory is always used.
It is very difficult to predict all the possible shared-resource policies for small local zones and the possible
side effects. It is the responsibility of the system administrator to create these policies without causing
unintentional side effects between different zones and software installed.
Architecture and product codes

On UNIX and Linux operating systems, some IBM Tivoli Monitoring files are placed in directories whose
paths include a code for the platform architecture. You can find the codes for the supported architectures
in the registry directory. archdsc.tbl contains the architecture codes and descriptions. You can find the
product codes and descriptions for supported components and products in the same directory, in
proddsc.tbl.
File descriptor (maxfiles) limit on UNIX and Linux systems

The monitoring server and Warehouse Proxy agent can use a large number of file descriptors, especially
in a large environment. On UNIX and Linux systems, the maximum number of file descriptors available to
a process is controlled by user limit parameters. To display the user limits, run the following command:
ulimit -a
The "nofiles" parameter is the number of file descriptors available to a process. For the monitoring server
process (kdsmain), the "nofiles" parameter should be set larger than the maximum number of agents that
will be connecting to the monitoring server. If the monitoring server is unable to get file descriptors when
needed, unexpected behavior can occur, including program failures. Consider increasing the value to 8000
file descriptors or more.
There are other user limit parameters that control how much data, stack and memory are available to a
process. For large environments, consider increasing these memory-related user limit parameters for the
monitoring server (kdsmain) process. Configuring the user limit parameters usually requires root access,
and involves changing system startup files which are operating system specific. Consult the operating
system manuals for information on how to configure the user limit parameters.
Security options
User IDs and passwords sent between Tivoli Management Services components are encrypted by default.
Other communication between components can be secured by configuring the components to use secure
protocols. See Communication between components on page 94.
Access to the Tivoli Enterprise Portal (authorization) is controlled by user accounts (IDs) defined to the
Tivoli Enterprise Portal Server. The hub Tivoli Enterprise Monitoring Server can be configured to validate,
or authenticate, user IDs through either the local system registry or an external LDAP-enabled registry.
Alternatively, authentication by an external LDAP registry can be configured through the Tivoli Enterprise
Portal Server. If authentication is not configured through either the monitoring server or the portal server,
no password is required to log on to the Tivoli Enterprise Portal. See Authorization and authentication on
page 94.
User IDs that require access to the SOAP Server, including user IDs that issue commands that invoke
SOAP methods, must be authenticated through the hub monitoring server. If user authentication is not
93
enabled on the hub monitoring server, anyone can make requests to the SOAP Server. If user
authentication is enabled on the hub, the SOAP Server honors only requests from user IDs and passwords
authenticated by the local or external registry. If type of access is specified for specific users, only
requests from those users for which access is specified are honored. See SOAP server security on page
95.
User IDs that require the ability to share credentials with other Web-enabled Tivoli applications must be
authenticated through the Tivoli Enterprise Portal Server, which must be configured for single sign-on. See
Single sign-on capability on page 95. If you have previously enabled authentication through the hub
monitoring server and want to change to the portal server, see the IBM Tivoli Monitoring: Administrator's
Guide.
User passwords are limited to 16 characters or fewer.
Notes:
1. The Tivoli Directory Server (TDS) LDAP client used by the Tivoli Enterprise Monitoring Server does not
support LDAP referrals, such as those supported by Microsoft Active Directory.
2. The IBM Tivoli Monitoring Service Console enables you to read logs and turn on traces for remote
product diagnostics and configuration. The Service Console performs user authentication using the
native operating system security facility. This means that if you use the Service Console on z/OS, your
user ID and password are checked by the z/OS security facility (such as RACF/SAF). If you use the
Service Console on Windows, you must pass the Windows workstation user ID and password prompt.
A password is always required to access the Service Console. Even if a user ID is allowed to log into
the operating system without a password, access to the Service Console will be denied. If necessary,
you must create a password for the user ID that is being used to log in to the Service Console. For
more information about the Service Console, see the IBM Tivoli Monitoring: Troubleshooting Guide.
Communication between components

To secure communication between agents, monitoring servers, and the Tivoli Enterprise Portal, use SPIPE
as the protocol when you configure communications between the Tivoli Enterprise Portal Server and the
hub Tivoli Enterprise Monitoring Server, between hub and remote monitoring servers, and between agents
and monitoring servers.
Two additional protocols are used to secure communication between clients and the portal server:
v Secure Hypertext Transport Protocol (HTTPS) to retrieve files and Interoperable Object Reference
(IOR). The integrated browser in the client provides HTTPS support on the client side; for the server,
consider using a third party Web server that supports HTTPS, such as the IBM HTTP Server. See
Configuring an external Web server to work with Tivoli Enterprise Portal on page 282 for more
information.
v Internet Inter-ORB Protocol (IIOP) to secure the communications between the portal server and client.
This uses Secure Sockets Layer (SSL) provided by VisiBroker. This secure communication uses public
key cryptography. See Using SSL between the portal server and the client on page 280 for more
information.
Authorization and authentication

Access to the Tivoli Enterprise Portal is controlled by user accounts defined to the portal server. In addition
to defining the user IDs that are authorized to log on to the Tivoli Enterprise Portal, these accounts define
the permissions that determine the Tivoli Enterprise Portal features a user is authorized to see and use,
the monitored applications the user is authorized to see, and the Navigator views (and the highest level
within a view) the user can access. An initial sysadmin user ID with full administrator authority is provided
during installation so you can log in to the Tivoli Enterprise Portal and add more user accounts. (For
information on creating user accounts and setting user permissions, see the IBM Tivoli Monitoring:
Administrator's Guide.) No password is required to log on to the Tivoli Enterprise Portal, unless user
authentication is enabled.
94
User authentication may be enabled through either the hub Tivoli Enterprise Monitoring Server, or the
Tivoli Enterprise Portal Server.
If authentication is enabled through the hub monitoring server, user IDs can be authenticated either by the
local system registry or by an external LDAP-enabled central registry. User IDs that need to make SOAP
Server requests (including user IDs that issue CLI commands that invoke SOAP server methods) can be
authenticated only through the hub monitoring server.
If authentication is enabled through the Tivoli Enterprise Portal, user IDs are authenticated against an
external LDAP-enabled registry. User IDs that require single sign-on (SSO) capability must be
authenticated through the portal server and mapped to unique user identifiers in an LDAP registry shared
by all SSO-eligible Tivoli applications.
User authentication should not be enabled until at least a basic installation of Tivoli Management Services
components and IBM Tivoli Monitoring base agents has been completed and tested. For instructions on
enabling authentication, see the IBM Tivoli Monitoring: Administrator's Guide.
Single sign-on capability

The Tivoli Enterprise Portal single sign-on (SSO) feature provides users the ability to launch out of the
portal to other Tivoli Web-based or Web-enabled applications, or to launch into the portal from those
applications, without having to re-enter their user IDs and passwords. For SSO to be enabled,
authentication must be configured through the Tivoli Enterprise Portal Server and the LDAP registry
defined to the portal server must be a central registry shared by all participating Tivoli applications. All the
participating applications must be configured for SSO and must belong to the same security domain and
realm.
For instructions on using SSO, see the IBM Tivoli Monitoring: Administrator's Guide.
Note: User passwords are limited to 16 characters or fewer.
SOAP server security

You can control access to the SOAP server in two ways:
v You can control who is permitted to make requests by enabling user authentication on the hub
monitoring server.
If the Security: Validate User option is not enabled, the SOAP server honors all requests regardless of
the sender. If the Security: Validate User option on the hub monitoring server is enabled, the SOAP
server honors requests only from users defined to the operating system or security authorization facility
of the host of the monitoring server.
v You can control what type of requests users are permitted to make by configuring the SOAP server.
If you specify a specific type of access for any users, the SOAP server honors requests only from those
users, regardless of whether Security: Validate User is enabled.
For information on configuring the security on the SOAP server, see Chapter 13, Configuring IBM Tivoli
Monitoring Web Services (the SOAP Server), on page 293.
Global Security Toolkit

IBM Tivoli Monitoring includes the Global Security Toolkit (GSKit) for SSL processing as used in SPIPE
and HTTPS. GSKit is installed by default on all distributed components, and its utilities are used to create
and manage the encryption of data between components through the use of digital certificates.
Note: Do not uninstall or manipulate the GSKit during installation. This may cause functional regression in
other products or make them inoperable. The GSKit will automatically install the most recent build if
another version GSKit already exists.
95
On z/OS, GSKit is known as the Integrated Cryptographic Service Facility, or ICSF. If ICSF is not installed
on the z/OS system, the monitoring server uses an alternative, less secure encryption scheme. Since both
components must be using the same scheme, if the hub system does not use ICSF, you must configure
the Tivoli Enterprise Portal to use the less secure scheme (EGG1) as well. For more information, see IBM
Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS.
A default certificate and key are provided with GSKit at installation. A stash file provides the database
password for unattended operation. You can also use the key management facilities in GSKit to generate
your own certificates. For more information regarding GSKit and iKeyMan, including information about
creating and using security certificates, see the GSKit product documentation located at
http://www-128.ibm.com/developerworks/java/jdk/security/50/.
Notes:
1. The IBM Tivoli Monitoring installer no longer modifies the system GSKit. If necessary, it installs a local
copy of GSKit that is private to Tivoli Monitoring.
2. In 64-bit environments, both the 64-bit and the 32-bit GSKit are installed, to support both 64-bit and
32-bit Tivoli Monitoring components.
Hardware and software requirements

The following sections provide specific information about the memory, software, and hardware
requirements for installing IBM Tivoli Monitoring.
Note: This section does not show agent-specific requirements (such as supported application levels or
any hardware requirements unique to a certain agent). For this information, see the user's guide
(for agents on distributed system) or configuration guide (for agents on mainframe systems) for the
agent that you are installing.
Supported operating systems

The following tables show which operating systems are supported for the different IBM Tivoli Monitoring
components: monitoring server, portal server, portal client, monitoring agent, Warehouse Proxy, and
Warehouse Proxy Summarization and Pruning agent.
For the latest information about the supported operating systems, see http://www-306.ibm.com/software/
sysmgmt/products/support/Tivoli_Supported_Platforms.html.
Note: In the following tables, an X indicates a supported component on the platform. If the platform being
discussed supports 64-bit applications but only a 32-bit version of the Tivoli Monitoring component
is supported on that platform, the X is replaced by "32 bit."
Table 12 shows the support for monitoring components on Windows computers.
Table 12. Supported Windows operating systems
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2
Windows 2000 Server on Intel

x86-32 (32 bit)
Windows 2000 Advanced Server

on Intel x86-32 (32 bit)
Windows XP Professional on Intel

x86-32 (32 bit)3
Windows XP Professional with

FDCC on Intel x86-32 (32 bit)
Operating system
96
Warehouse Summarization
Proxy
and Pruning
agent
agent
Table 12. Supported Windows operating systems (continued)
Operating system
Windows Server 2003 Standard
Edition R2 on Intel x86-32 (32 bit)
Edition R2 on x86-64 (64 bit)
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2
32 bit
32 bit
32 bit
32 bit
32 bit

Edition R2 on Itanium IA64 (64 bit)
Proxy
and Pruning
agent
agent
32 bit
Windows Server 2003 Enterprise


Edition R2 on x86-64 (64 bit)
32 bit
32 bit
32 bit
32 bit
32 bit

32 bit
Windows Server 2003 Datacenter



32 bit
Windows Vista Enterprise Edition

Windows Vista Enterprise Edition

32 bit

Edition on Intel x86-32 (32 bit)1,4,5

Edition on Intel x86-64 (64 bit)1,5
32 bit
32 bit
32 bit
32 bit
32 bit

Edition on Itanium IA64 (64 bit)1,5
32 bit

Edition on Intel x86-32 (32 bit)1,4,5
X5

Edition on Intel x86-64 (64 bit)1,5
32 bit
32 bit
32 bit
32 bit
32 bit5

Edition on Itanium2 (IA64)
32 bit

Edition on Intel x86-32 (32 bit)1

Edition on Intel x86-64 (64 bit)1

Edition on Itanium IA64 (64 bit)1
32 bit
Windows 7 Enterprise Edition on

Intel x86-32 (32 bit)
Windows 7 Enterprise Edition on

32 bit
Windows 7 Professional Edition on

97
Table 12. Supported Windows operating systems (continued)

Portal
client1
OS
monitoring
agent2
32 bit
Windows 7 Ultimate Edition on

Windows 7 Ultimate Edition on

32 bit
32 bit
Operating system
Monitoring
server
Portal
server
Windows 7 Professional Edition on

Windows Server 2008 R2

Standard Edition on Intel x86-64
(64 bit)1,5
32 bit
32 bit

Standard Edition on Itanium IA64
(64 bit)1,5
Enterprise Edition on Intel x86-64
(64 bit)1,5
Proxy
and Pruning
agent
agent
32 bit
32 bit
32 bit
32 bit5
32 bit
32 bit

Enterprise Edition on Itanium2
(IA64)
Datacenter Edition on Intel x86-64
(64 bit)1
Datacenter Edition on Itanium
IA64 (64 bit)1
32 bit
32 bit
32 bit
32 bit
Notes:
1. The Tivoli Enterprise Portal desktop client is supported on marked platforms. However, the browser client can be
accessed only from Windows computers running Internet Explorer 6 or 7 or either Firefox 2.x or 3.0.x (but not
3.5.x). Note that the Firefox browser is not supported on Windows Server 2008.
2. The OS monitoring agent column indicates the platforms on which an operating system monitoring agent is
supported. This column does not indicate that any agent runs on any operating system. For example, to monitor
a Linux computer, you must use a Linux monitoring agent, not a Windows monitoring agent.
For information about the operating systems supported for non-OS agents, see the documentation for the specific
agents you are using in your environment.
3. For the Windows XP and Windows Vista operating systems, the Microsoft End User License Agreement (EULA)
does not license these operating systems to function as a server. Tivoli products that function as a server on
these operating systems are supported for demonstration purposes only.
4. Windows Server 2008 (32-bit) is supported for these Tivoli Management Services components:
v The monitoring server
v The portal server
v The agent infrastructure and the OS agent
v The portal desktop client and the browser client but only under Internet Explorer (Mozilla Firefox is not
supported)
v The Warehouse Proxy agent
5. The Summarization and Pruning agent is supported on Windows 2008, but only with the necessary workaround.
98
Table 13 shows the support for monitoring components on UNIX (non-Linux), i5/OS, and z/OS computers.
Table 13. Supported UNIX, i5/OS, and z/OS operating systems
Operating system
Monitoring
server
Portal
server
AIX V5.2 (32 bit)4
Portal
client
OS
monitoring
agent1,2
Warehouse
Proxy
agent3
Summarization
and Pruning
agent
(browser
client
only)
32 bit
(browser
client
only)
32 bit
32 bit
AIX V5.2 (64 bit)4
AIX V5.3 (32 bit)4

X
(browser
client
only)
(browser
client
only)
(browser
client
only)
(browser
client
only)
32 bit
(browser
client
only)
32 bit
32 bit
32 bit
(browser
client
only)
32 bit
32 bit
32 bit
(browser
client
only)
Solaris Zones (SPARC) (32/64

bit)8
32 bit
(browser
client
only)
32 bit
32 bit
Solaris Zones (Intel x86-64) (64

bit)8
32 bit
(browser
client
only)
HP-UX 11i v1 (32/64) on

PA-RISC13,14
(browser
client
only)
HP-UX 11i v2 (64 bit) on

PA-RISC14
(browser
client
only)
HP-UX 11i v3 (64 bit) on

PA-RISC14
(browser
client
only)
(browser
client
only)
32 bit
32 bit
AIX V5.3 (64 bit)4
AIX V6.x (64 bit)5
Solaris V8 (SPARC) (32/64bit)6
Solaris V9 (SPARC) (32/64bit)7
Solaris V10 (SPARC) (32/64 bit)
Solaris V10 (Intel x86-64) (64 bit)
HP-UX 11i v2 on Integrity

(IA64)12,14
32 bit
99
Table 13. Supported UNIX, i5/OS, and z/OS operating systems (continued)
Operating system
HP-UX 11i v3 on Integrity
(IA64)12,14
Monitoring
server
Portal
server
32 bit
Portal
client
(browser
client
only)
OS
monitoring
agent1,2
Warehouse
Proxy
agent3
Summarization
and Pruning
agent
32 bit
32 bit
i5/OS 5.3 (64 bit)9
i5/OS 5.4 (64 bit)
i5/OS 6.1 (64 bit)
z/OS 1.6 (31/64 bit)
10,11
31 bit
z/OS 1.7 (31/64 bit)
10,11
31 bit
z/OS 1.8 (31/64 bit)
10,11
31 bit
z/OS 1.9 (31/64 bit)
10,11
31 bit
31 bit
z/OS 1.10 (31/64 bit)
10,11
Notes :
1. The OS monitoring agent column indicates the platforms on which an operating system monitoring agent is
supported. This column does not indicate that any agent runs on any operating system. For example, to monitor
a Linux computer, you must use a Linux monitoring agent, not a Windows monitoring agent.
For information about the operating systems supported for non-OS agents, see the documentation for the specific
agents you are using in your environment.
2. If you are installing the OMEGAMON XE for Messaging agent on a 64-bit operating system, you must install the
32-bit version of the agent framework.
3. Configuration of the Warehouse Proxy agent requires an X Window System (also known as the X11 GUI) on the
computer where you are configuring it. Alternatively, you can run the following command to use an X terminal
emulation program (such as Cygwin) that is running on another computer:
export DISPLAY=my_windows_pc_IP_addr:0.0
where my_windows_pc_IP_addr is the IP address of a computer that is running an X terminal emulation program.
4. Supported AIX systems must be at the required maintenance level for IBM Java 1.5. See the following Web site
for the Java 5 AIX maintenance level matrix: http://www-128.ibm.com/developerworks/java/jdk/aix/service.html
Component xlC.aix50.rte must be at level 8.0.0.4. See the following Web site for installation instructions:
http://www-1.ibm.com/support/docview.wss?uid=swg1IY84212
The Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server require AIX 5.3 TL5 SP3 or newer. The
other components need AIX 5.3 TL3 or newer, but if they are at AIX 5.3 TL5, they too require SP3.
Version 8 of the AIX XL C/C++ runtime must be installed. To determine the current level, run the following AIX
command:
lslpp -l | grep -i xlc
100
Table 13. Supported UNIX, i5/OS, and z/OS operating systems (continued)
Operating system
Monitoring
server
Portal
server
Portal
client
OS
monitoring
agent1,2
Warehouse
Proxy
agent3
Summarization
and Pruning
agent
5. Component xlC.aix61.rte must be at level 10.1.0.2 or higher. See the following Web site for installation
instructions: http://www-1.ibm.com/support/docview.wss?uid=swg1IY84212
Version 10 of the AIX XL C/C++ runtime must be installed. Additionally on AIX 6.1, the xlC supplemental runtime
for aix50 (xlC.sup.aix50.rte at level 9.0.0.1 or higher) must be installed. To determine the current level, run the
following AIX command:
lslpp -l | grep -i xlc
The output should be something similar to the following:
xlC.aix61.rte
10.1.0.2
xlC.cpp
9.0.0.0
xlC.msg.en_US.cpp
9.0.0.0
xlC.msg.en_US.rte
10.1.0.2
xlC.rte
10.1.0.2
xlC.sup.aix50.rte
9.0.0.1
6. Solaris V8 32 bit requires patches 108434-17 and 109147-07. Solaris V8 64 bit requires 108435-17 and
108434-17. Both 32-bit and 64-bit versions require 111721-04.
7. Solaris V9 32 bit requires patch 111711-11. Solaris V9 64 bit requires 111712-11 and 111711-11. Both 32-bit and
64-bit versions require 111722-04.
8. There are some limitations on installing into Solaris 10 when zones are configured. See Installing into Solaris
zones on page 92.
9. SNMP version 3 is not supported on i5/OS.
10. For information about installing the monitoring server on z/OS, refer to the program directory that comes with
that product.
11. The OS monitoring agent for z/OS computers is part of the IBM Tivoli OMEGAMON for z/OS product.
12. You cannot upgrade either the OS or Log Alert agents that you currently have running on an HP-UX 11i v2
(B.11.23) on an Integrity (IA64) computer in PA-RISC mode prior to fix pack 4. Fix packs prior to fix pack 4 did
not run in native 64-bit mode by default. You must first uninstall the agent if the version is previous to the fix
pack 4 version.
13. The 32-bit kernel still requires a 64-bit processor. Ensure that any HP-UX managed system is based on
PA-RISC2 architecture. From the native kernel mode (for example, 64 bit if the system is 64-bit based), run the
following command:
file /stand/vmunix
This returns the native architecture type. For example:
/stand/vmunix:
PA-RISC1.1 executable -not stripped
Verify the architecture is at least PA-RISC2.

14. Prerequisite patches for HP-UX R11: PHSS_26945 and PHSS_33032. For HP-UX R11.11, they are
PHSS_26946, PHSS_33033, and PHCO_34275 or later.
15. Desktop client deployed using Java Web Start 32-bit mode only.
16. Users of AIX 5.3 (32 bit or 64 bit) or AIX 6.1 should refer to this Web site for the minimum maintenance level
required to install and run the current Tivoli Enterprise Portal Server in those environments:
http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg27007624.
101
Table 14 shows the monitoring components supported on Linux operating systems.

Table 14. Supported Linux operating systems
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2,5
Asianux 2.0 for Intel x86-32 (32

bit)
Asianux 2.0 on Intel x86-64 (64

bit)
browser
client only
browser
client only
Operating system
Asianux 2.0 on Itanium IA64 (64

bit)
Proxy
and Pruning
agent3
agent
Asianux 3.0 for Intel x86-32 (32

bit)
Asianux 3.0 on Intel x86-64 (64

bit)
browser
client only
browser
client only
Asianux 3.0 on Itanium IA64 (64

bit)
Red Flag 4.1 for Intel x86-32 (32
bit)
Red Flag 5.0 for Intel x86-32 (32

bit)
RedHat Enterprise Linux 3 on


zSeries (31 bit)
browser
client only
RedHat Enterprise Linux 4 Intel

x86-32 (32 bit)

browser
client only
browser
client only

Itanium IA64 (64 bit)6
iSeries and pSeries (64 bit)

zSeries (31 bit)
browser
client only

zSeries (64 bit)
X8
browser
client only

x86-32 (32 bit)7

Intel x86-64 (64 bit)7
browser
client only
browser
client only

Itanium IA64 (64 bit)6
iSeries and pSeries (64 bit)7

zSeries (31 bit)7
browser
client only

zSeries (64 bit)7
X8
browser
client only
102
Table 14. Supported Linux operating systems (continued)
Operating system
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2,5
SuSE Linux Enterprise Server 8

browser
client only

for zSeries (31 bit)
browser
client only

for zSeries (64 bit)
browser
client only
Proxy
and Pruning
agent3
agent


on Intel x86-64 (64 bit)4
browser
client only
browser
client only

on Itanium IA64 (64 bit)4,6
for iSeries and pSeries (64 bit)4

for zSeries (31 bit)4
browser
client only

X8
browser
client only


on Intel x86-64 (64 bit) 44
browser
client only
browser
client only


X8
browser
client only

on Intel x86-32 (32 bit)4

on Intel x86-64 (64 bit) 46
browser
client only
browser
client only

X
X
X8
browser
client only
VMWare ESX Server 3.0.1 on

native Linux
OS agent
VMWare ESX Server 3.0.1 on

native Linux
OS agent
VMWare ESX Server 3.5 on Intel

x86-32 (32 bit)
native Linux
OS agent
103
Operating system
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2,5

x86-64 (64 bit)
native Linux
OS agent

x86-32 (32 bit)
native Linux
OS agent

x86-64 (64 bit)
native Linux
OS agent
104
Proxy
and Pruning
agent3
agent
Operating system
Monitoring
server
Portal
server
Portal
client1
OS
monitoring
agent2,5
Proxy
and Pruning
agent3
agent
Notes:
1. Both the Tivoli Enterprise Portal desktop and browser clients are supported on the marked platforms. The
browser client may work with Firefox 2.x on other Linux platforms that have not yet been certified by IBM.
2. The OS monitoring agent column indicates the platforms on which an agent is supported. This column does not
indicate that any agent runs on any operating system. For example, to monitor a Linux computer, you must use a
Linux monitoring agent, not a Windows monitoring agent. An "X" symbol in the column indicates that an operating
system agent is available for the specific operating system that is named in the row where the "X" is located.
3. Configuration of the Warehouse Proxy agent requires an X Window System (also known as the X11 GUI) on the
computer where you are configuring it. Alternatively, you can run the following command to utilize an X terminal
emulation program (such as Cygwin) that is running on another computer:
where my_windows_pc_IP_addr is the IP address of a computer that is running an X terminal emulation program.
4. SuSE Linux Enterprise Server 9 must be at SP3 or higher. SuSE 10 must be at pdksh-5.2.14 or higher.
5. The Linux OS Monitoring Agent requires the installation of the latest versions of the following libraries:
libstdc++
libgcc
compat-libstdc++
libXp
These libraries are available on the Linux operating system installation media and Service Packs. Each library
can have multiple packages, and each should be installed.
6. The following rpm files are prerequisites when running IBM Tivoli Monitoring V6.2.1/6.2.2 under Linux on Itanium:
ia32el-1.1-20.ia64.rpm
glibc-2.3.4-2.36.i686.rpm
glibc-common-2.3.4-2.36.i386.rpm
libgcc-3.4.6-8.i386.rpm
7. RedHat Enterprise Linux V5 now enables SELinux (security-enhanced Linux) by default, which interferes with the
installation, configuration, and operation of IBM Tivoli Monitoring. To ensure the proper operation of the V6.1.x
and V6.2.x releases, the SELinux setting must be changed from enforcing mode to either permissive or
disabled mode. When the permissive mode is chosen, the system log will contain entries regarding which Tivoli
Monitoring binaries have triggered the SELinux security condition. However, under the permissive mode, these
entries are for auditing purpose only, and will operate normally.
As of V6.2.1 and V6.2.2, SELinux can be enabled again after installation and configuration; however, it must still
be set to either permissive or disabled mode when installing and configuring IBM Tivoli Monitoring. The
appropriate command is either:
setenforce Permissive
or:
setenforce Enforcing
After switching the SELinux mode, issue the prelink -a command. If you skip this command, the IBM Tivoli
Monitoring installer may fail with error message KCI1235E terminating ... problem with starting Java Virtual
Machine.
8. On zSeries systems running a 32-bit DB2 V9 instance under Linux, you must install a 32-bit Tivoli Enterprise
Portal Server. On zSeries systems running a 64-bit DB2 V9 instance under Linux, you can install either:
v A 64-bit Tivoli Enterprise Portal Server.
v A 32-bit Tivoli Enterprise Portal Server if the 32-bit DB2 V9 client libraries are also installed.
105
The following table lists the operating system patches required for the IBM Global Security Toolkit (GSKit),
which is used to provide security between monitoring components. GSKit is installed automatically when
you install Tivoli Management Services components.
Table 15. Operating system requirements for IBM GSKit
Operating system
Patch required
Solaris V8
108434-14, 111327-05, 108991, 108993-31, 108528-29,

113648-03, 116602-01, 111317-05, 111023-03, 115827-01
Solaris V9
111711-08
Solaris V10
none
HP-UX V11i
PHSS_26946, PHSS_33033, PHCO_34275
AIX V5.x
xlC.aix50.rte.6.0.0.3 or later
AIX V6.x
xlC.aix61.rte 10.1.0.2 or later
Windows Server 2003
none
RedHat Enterprise Linux 2.1 Intel
pdksh-5.2.14-13.i386.rpm
compat-gcc-32-c++-3.2.3-46.1.i386.rpm
compat-gcc-32-3.2.3-46.1.i386.rpm
compat-libstdc++-33-3.2.3-46.1.i386.rpm
SuSE Linux Enterprise Server 8 Intel
none
SuSE Linux Enterprise Server 9 Intel
none
106
Supported databases for Tivoli Enterprise Portal Server and Tivoli Data
Warehouse
The following tables show the supported databases for the portal server and the Tivoli Data Warehouse.
Table 16 shows the supported databases for the portal server. Note that the database and the portal
server must be installed on the same computer.
Note: IBM Tivoli Monitoring V6.2.x includes DB2 Workstation Server Edition V9.5 for use with the portal
server and the Tivoli Data Warehouse. (Version 6.2 and its fix packs provided a restricted-use
version of DB2 Database for Linux, UNIX, and Windows V9.1.)
Table 16. Supported databases for the portal server
Portal server
operating
system
Portal server database ("TEPS")1,2

IBM DB2 for the workstation3
AIX
v
v
v
v
v
V8.1
V8.2
V9.1
V9.5
V9.7
Linux4
v
v
v
v
v
V8.1 with fix pack 10 or higher

V8.2 with fix pack 3 or higher
V9.1 and fix packsnote 8 for Table 14
Windows
v
v
v
v
v
V8.1
V8.2
V9.1
V9.5
V9.7
MS SQL Server
with fix pack 16 or higher

and fix packs
and fix packs

and fix packs
and fix packs
and fix packs
v MS SQL Server 2000 SP35

v MS SQL Server 20056
v MS SQL Server 2008
Notes:
1. "TEPS" is the default database name for the database used by the portal server.
2. Your portal server database must be located on the computer where the portal server is installed.
3. If, in your environment, you are using products whose licenses require you to collect software use information
and report it to IBM using IBM Tivoli License Manager, you must ensure that use of this instance of IBM DB2 for
the workstation is not included in the report. To do this, create a Tivoli License Manager license, select a license
type that does not involve reporting to IBM, and associate this instance of the product with it.
4. On Linux, the portal server database must be installed with the operating system language set to UTF-8.
5. IBM Tivoli Monitoring supports Microsoft SQL Server 2000 only if the data is limited to codepoints inside the
Basic Multilingual Plane (range U+0000 to U+FFFF). This restriction does not apply to IBM DB2 for the
workstation.
6. This assumes the portal server runs on Windows. See Technote 1240452 for further information on support for
this application.
7. The base installation CD includes, among its Tivoli Enterprise Portal Server files, a version of the embedded
Derby database that you can use instead of either DB2 for the workstation or SQL Server (but note the limitations
listed in Derby now supported as a portal server database on page 20). This version of Derby is the one
supported by and included with the version of eWAS required for the portal server.
8. If you transition from one supported database system to another for the Tivoli Enterprise Portal Server, your
existing portal server data is not copied from the first system to the new one.
107
Table 17 shows the supported databases for the Tivoli Data Warehouse. Note that if you run the database
for the Tivoli Enterprise Portal Server and the database for the warehouse in the same instance of IBM
DB2 for the workstation, you must follow the support requirements in Table 16 on page 107.
Table 17. Supported databases for the Tivoli Data Warehouse
Tivoli Data Warehouse database ("WAREHOUS")1
IBM DB2 for the workstation
IBM DB2 on z/OS6
MS SQL Server
Supported versions:
v V8.1 with fix pack 10 or higher
v V8.2 with fix pack 3 or higher
v V9.1 and fix packs
v V9.5 and fix packs5
v V9.7 and fix packs
Supported versions:
version 9.1 or
subsequent.
Support applies to
any Windows,
Linux, or UNIX
platform that can
run the Warehouse
Proxy agent. DB2
Connect Server
Edition is also
required on the
workstation.
Supported versions:
v MS SQL Server
2000 Enterprise
Edition4
v MS SQL Server
2005 Enterprise
Edition
v MS SQL Server
2008 Enterprise
Edition
Support applies to the following

operating systems:3
v AIX V5.3
v HP-UX 11iv3
v Solaris 10
v RedHat Enterprise Linux 4 for
Intel and zSeries
Intel and zSeries
v SuSE Linux Enterprise Server 9
for Intel and zSeries
for Intel and zSeries
v Windows 2003 Server
Support applies to
the Windows
operating
environment only.
Oracle
Supported versions:
v 9.2
v 10g Release 1
v 10g Release 2
v 11g Release 1
v 11g Release 2
Support applies to the following
operating systems:
v AIX V5.3
v HP-UX 11iv3
v Solaris 102
Intel
v RedHat Enterprise Linux 5 on
Intel and zSeries
for Intel
v SuSE Linux Enterprise Server
10 for Intel
Notes:
1. "WAREHOUS" is the default database name for the database used by Tivoli Data Warehouse. Support is for
32-bit or 64-bit databases. Your Tivoli Data Warehouse database can be located on the same computer as your
monitoring server or on a remote computer.
2. See the Oracle company support Web site (www.oracle.com) for information about installing and configuring
Oracle on Solaris V10.
3. Do not use DB2 for the workstation V9.1 fix pack 2 for the Tivoli Data Warehouse. Use of DB2 for the workstation
V9.1 FP2 can cause the Warehouse Proxy agent and the Summarization and Pruning agent not to function
properly. Use an earlier version, such as DB2 for the workstation V9.1 fix pack 1, or upgrade to a level that
contains the fix for APAR JR26744, such as DB2 for the workstation V9.1 fix pack 3.
4. IBM Tivoli Monitoring supports Microsoft SQL Server 2000 only if the data is limited to code points inside the
Basic Multilingual Plane (range U+0000 to U+FFFF).
5. Users of DB2 Database for Linux, UNIX, and Windows V9.5 fix pack 1 must update their JDBC driver to version
3.57.82. You can download this updated driver here:
http://www-01.ibm.com/support/docview.wss?rs=4020&uid=swg21385217
6. DB2 on z/OS is not supported for the Tivoli Enterprise Portal Server.
108
Required hardware for distributed systems

The following sections describe the processor, disk, memory, and other hardware requirements for the IBM
Tivoli Monitoring infrastructure components on distributed systems. A distributed system is defined here as
any hardware that is not zSeries.
Following is a list of the IBM Tivoli Monitoring components covered in this section:
v Hub monitoring server
v Remote monitoring server
v Portal server
v Portal client
v Tivoli Data Warehouse
v Warehouse Proxy agent
v Summarization and Pruning agent
Processor requirements
For best performance, processor speeds should be at least 1.5 GHz for RISC architectures and 3 GHz for
Intel architectures. Choosing faster processors should result in improved response time, greater
throughput, and lower CPU utilization.
Except for the Tivoli Data Warehouse, single-processor systems are suitable when an IBM Tivoli
Monitoring infrastructure component is installed on a separate computer from the other components. The
infrastructure components (monitoring server, portal server, portal client) run as multithreaded processes
and are able to run threads concurrently across multiple processors if they are available. CPU utilization
for most components is bursty, and steady-state CPU utilization is expected to be low in most cases. For
components supporting large environments, using multiprocessor systems can improve throughput.
You should also consider using multiprocessor systems in the following scenarios:
v You want to run the Tivoli Enterprise Portal client on a computer that is also running one of the server
components.
v You have a monitoring environment of 1000 or more monitored agents, and you want to install multiple
server components on the same computer. For example:
Portal server and hub monitoring server
Monitoring server (hub or remote) and Warehouse Proxy agent
Warehouse Proxy and Summarization and Pruning agents
v You have a small environment and you want to include all of the server components (monitoring server,
portal server, Warehouse Proxy agent, and Summarization and Pruning agent) on a single computer.
v Except in very small environments, use a multiprocessor system for the Tivoli Data Warehouse
database server. You can run the Warehouse Proxy agent and the Summarization and Pruning agent on
the Warehouse database server to eliminate network transfer from the database processing path:
If you install the Warehouse Proxy agent on the Warehouse database server, consider using a
two-way or four-way processor.
If you install the Summarization and Pruning agent on the Warehouse database server (with or
without the Warehouse Proxy agent), consider using a four-way processor. For large environments
where more CPU resources might be needed, you can run the Summarization and Pruning agent on
a computer separate from the Warehouse database server. In this case, ensure that a high-speed
network connection exists (100 Mbps or faster) between the Summarization and Pruning agent and
the database server.
109
Memory and disk requirements

The following table shows estimated memory and disk storage for IBM Tivoli Monitoring components on
distributed systems.
Table 18. Estimated memory and disk storage for IBM Tivoli Monitoring components on distributed systems
Process memory requirements1
Component
Small environment2
Hub monitoring server
70 MB
Large environment3
400 MB
Disk storage
requirements4
Windows: 1.1 GB
Linux and UNIX: 1.3 GB
plus 300 MB free in the
/tmp directory5
Remote monitoring server
100 MB
400 MB
900 MB5
Portal server
650 MB without the

embedded Derby
database6
650 MB without the

embedded Derby
database6
1.2 GB plus an
additional 1.2 GB in
your computer's
temporary directory to
install the eWAS server
and the Eclipse Help
Server
Portal client (browser or desktop)
150 MB
300 MB
150 MB
2 - 4 GB depending on
database configuration
parameters
4 - 8 GB depending on
database configuration
parameters
See Estimating the

required size of your
database on page 333.
100 MB
200 MB
150 MB
100 MB
200 MB
150 MB
Notes:
1. The memory and disk sizings shown in this table are the amounts required for the individual component beyond
the needs of the operating system and any concurrently running applications. For the total system memory
required by small, medium-size, and large environments, see Sizing your Tivoli Monitoring hardware on page
39.
2. A small environment is considered to be a monitoring environment with 500 to 1000 agents, with 100 to 200
monitored agents per remote monitoring server and 20 clients or fewer per portal server.
3. A large environment is considered to be a monitoring environment with 10,000 agents or more monitored agents,
with 500 to 1500 monitored agents per remote monitoring server, and with 50 clients or more per portal server.
4. The disk storage estimates apply to any size monitoring environment and are considered high estimates. The
size of log files affect the amount of storage required.
5. The storage requirements for the hub and remote monitoring servers do not include storage for the agent depot,
which can require an additional 1 GB or more.
6. The memory requirement for the portal server does not include database processes for the portal server
database, which require up to 400 MB of additional memory, depending on configuration settings.
Add the sizings for individual components to calculate a total for more than one component installed on
the same computer.
For example, if the hub monitoring server and portal server are installed on the same computer in a small
monitoring environment, the initial requirement is 170 MB of memory and 900 MB of disk space beyond
the needs of the operating system and other applications. If you add 400 MB of memory for the portal
server database and 1 GB of storage for the agent depot, the total requirement for IBM Tivoli Monitoring
components comes to 570 MB of memory and 1.9 GB of storage.
110
Additional requirements
v The best network connection possible is needed between the hub monitoring server and portal server
and also between the Tivoli Data Warehouse, Warehouse Proxy agent, and Summarization and Pruning
agent.
v A video card supporting 64,000 colors and 1024 x 768 resolution is required for the portal client.
Required hardware for System z

The Tivoli Enterprise Monitoring Server can be installed on either a z/OS or Linux operating system
running on System z hardware. The Tivoli Enterprise Portal Server is supported on Linux for zSeries, but
not z/OS. The supported product versions for z/OS and Linux for zSeries are listed in Table 13 on page
99.
The following paragraphs summarize the hardware requirements for IBM Tivoli Monitoring components that
run on zSeries:
v Tivoli Enterprise Monitoring Server on z/OS
The Tivoli Enterprise Monitoring Server can run natively on any zSeries hardware under z/OS V1.6 or
later. A detailed description of the hardware requirements for a monitoring server on z/OS, including
storage requirements, is documented in the IBM Tivoli Management Services on z/OS: Program
Directory for IBM Tivoli Management Services on z/OS.
v Tivoli Enterprise Monitoring Server or Tivoli Enterprise Portal Server on Linux for zSeries
Any zSeries hardware provides adequate processing capability for a monitoring server or portal server
running under Linux for zSeries. The memory and disk requirements for the Tivoli Monitoring
components on Linux for zSeries are similar to those for Linux running on distributed systems; these are
documented in Table 18 on page 110.
Required software
The following table lists the software required for IBM Tivoli Monitoring.
Table 19. Required software for IBM Tivoli Monitoring
Component where the software is required
Product
Supported version
IBM Runtime
Environment for
Java
JRE V1.5
Sun Java SE
Runtime
Environment
JRE V1.5.0.xx and

1.6.0.xx
For Linux
computers: a Korn
shell interpreter
pdksh-5.2.14
For RedHat
Enterprise Linux
4.0 computers:
libXp.so.6
(available in
xorg-x11deprecated-libs)
Monitoring
server
Portal
server
Portal
desktop
client
Portal
browser
client
X1
Monitoring
agent
X2
111
Table 19. Required software for IBM Tivoli Monitoring (continued)

Product
Supported version
Monitoring
server
Portal
server
Portal
desktop
client
Portal
browser
client
Monitoring
agent
AIX only: xlC

Runtime
Environment
(required for GSkit).
Component
xlC.aix50.rte must
be at 8.0.0.4.
AIX only: Version 8

of the XL C/C++
runtime
Microsoft Internet
Explorer
V6.0 or V7.0 with all

critical Microsoft
updates applied
Mozilla Firefox
V2.x or V3.0.x (but not

V3.5.x)
Database1
A supported RDBMS is required for the Tivoli Enterprise Portal Server and the Tivoli Data
Warehouse. Supported database platforms for the portal server are listed in Table 16 on page
107. Supported database platforms for the Tivoli Data Warehouse are listed in Table 17 on page
108.
Each database requires a driver. For detailed information, see Chapter 15, Tivoli Data
Warehouse solutions, on page 331 and subsequent chapters about the Tivoli Data Warehouse.
IBM Tivoli
Enterprise Console
Version 3.9 with Fix

Pack 06
For TCP/IP
communication on
Windows:
v Windows 2000
Professional or
Server with
Service Pack 3
or above
v Microsoft
Winsock v1.1 or
later
v Microsoft TCP/IP
protocol stack
112
Table 19. Required software for IBM Tivoli Monitoring (continued)

Product
Supported version
For SNA
communication on
Windows:
Microsoft SNA Server

V4.0 requires Service
Pack 1.
v Windows 2000
Professional or
Server with
Service Pack 3
or above
IBM Communications
Server V5.0 requires
fixes JR10466 and
JR10368.
Monitoring
server
Portal
server
Portal
desktop
client
Portal
browser
client
Monitoring
agent
v Microsoft SNA
Server V3.0 or
later
v IBM
Communications
Server V5.0 or
5.2
Notes:
1. If the JRE is not installed on the computer on which the browser is launched, you are prompted to download and
install it. The Windows user account must have local administrator authority to download and install the JRE.
2. The Korn shell (any version) is also required when installing the monitoring agent on AIX, HP-UX, or Solaris
systems.
Required software for event integration with Netcool/OMNIbus

The following products must be installed and configured before you install event synchronization and
configure event forwarding for Netcool/OMNIbus:
v Netcool/OMNIbus V7.x
v Netcool/OMNIbus V7.x probe for Tivoli EIF
v IBM Tivoli Monitoring V6.2 or subsequent
113
114
Chapter 6. Upgrading from a previous installation

This chapter provides information to help you upgrade from a previous installation.
v Upgrade scenarios helps you identify the scenario to use as a guide when you upgrade and where to
find information about it.
v Planning your upgrade on page 116 identifies the platforms no longer supported, describes two
methods for components need to be upgraded, provides instructions for backing up your existing
environment, and specifies the required order for upgrading components.
v Upgrading from IBM Tivoli Monitoring V6.1 or V6.2 on page 127 provides an overview of the process
of upgrading from V6.1 to V6.2 of IBM Tivoli Monitoring.
v Upgrading from OMEGAMON Platform V350 and V360 on page 131 provides an overview of the
process of upgrading from OMEGAMON Platform 350 or 360 to IBM Tivoli Monitoring V6.2.
Upgrade scenarios
Use one of the following scenarios as a guide when you upgrade from a previous installation:
Upgrading from Tivoli Distributed Monitoring: The new IBM Tivoli Monitoring is not dependent on the
Tivoli Management Framework. An upgrade toolkit is provided to facilitate your move from a Tivoli
Distributed Monitoring environment to the new IBM Tivoli Monitoring. For information, see IBM Tivoli
Monitoring: Upgrading from Tivoli Distributed Monitoring, document number GC32-9462.
Upgrading from IBM Tivoli Monitoring V5.1.2: An upgrade toolkit is provided to facilitate your move from
IBM Tivoli Monitoring V5.1.2 to IBM Tivoli Monitoring V6.2.
The IBM Tivoli Monitoring version 5 to version 6 Migration Toolkit provides a starting point for migrating
your IBM Tivoli Monitoring version 5 environment to IBM Tivoli Monitoring version 6. This tool assesses a
Tivoli Monitoring V5 environment and produces an inventory of your site's current monitoring architecture
and its monitors. In addition, a draft Tivoli Monitoring V6 configuration is produced for your review and
modification. While the tool migrates what it can from IBM Tivoli Monitoring V5 to IBM Tivoli Monitoring V6,
optimizations and improvements might be available that would greatly improve your new Tivoli Monitoring
V6 performance and scale, but you must perform these manually.
For information about using the toolkit and some best-practices guidelines, see IBM Tivoli Monitoring:
Upgrading from V5.1.2.
IBM Tivoli Monitoring V5.x interoperability: Using the IBM Tivoli Monitoring 5.x Endpoint agent, you can
view data from IBM Tivoli Monitoring 5.x resource models in the Tivoli Enterprise Portal and warehouse
granular data in the Tivoli Data Warehouse. You can use this visualization to replace the Web Health
Console used in IBM Tivoli Monitoring V5.1. For information about using this visualization, see the
Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint User's Guide (document number SC32-9490).
Upgrading from IBM Tivoli Monitoring V6.1: To upgrade from a previous installation of IBM Tivoli
Monitoring V6.1, use the planning, upgrading, and post-installation configuration instructions provided in
this chapter (see Planning your upgrade on page 116 and Upgrading from IBM Tivoli Monitoring V6.1 or
V6.2 on page 127).
Upgrading from OMEGAMON Platform V350 and V360: Migration tools are provided to facilitate the
upgrade process for your site's custom situations, policies, and queries to the formats used by IBM Tivoli
Monitoring V6.1 and V6.2.
Many of the existing OMEGAMON Platform V350 and V360 agents have equivalent IBM Tivoli Monitoring
agents. For any that do not yet have an IBM Tivoli Monitoring counterpart, you can continue to monitor
115
those agents in your new IBM Tivoli Monitoring environment. Use the planning and upgrade instructions in
this chapter (see Planning your upgrade and Upgrading from OMEGAMON Platform V350 and V360 on
page 131).
OMEGAMON V350/V360 users upgrading to IBM Tivoli Monitoring V6.2.2

There is no direct upgrade path from the OMEGAMON V350 or V360 platform to Tivoli Monitoring
V6.2.2. You must first upgrade to either Tivoli Monitoring V6.1 (with any fix pack), V6.2, or V6.2 with
fix pack 1, then upgrade to V6.2.2. The recommended upgrade path is OMEGAMON V350/V360
Tivoli Monitoring V6.1 FP5 Tivoli Monitoring 6.2.2. Although the IBM Tivoli Monitoring V6.2 images
are not included with the V6.2.2 media, you can install the V6.1 fix pack 5 distribution provided with
previous releases of the OMEGAMON, NetView, and ITCAM products. If during installation you find
you need OMEGAMON V350/V360, Tivoli Monitoring, or DB2 Database for Linux, UNIX, and
Windows images, go to this IBM Web Membership (IWM) site:
https://www14.software.ibm.com/webapp/iwm/web/preLogin.do?source=swg-migrate-itm.
This restriction applies only to these distributed OMEGAMON V350/V360 components:
v the CandleNet Portal desktop and browser clients
v the CandleNet Portal Server
v the Candle Management Server running on a distributed platform
v the OMEGAMON Monitoring Agents
v the Candle Data Warehouse proxy agent
The z/OS Installation and Configuration Tool does migrate z/OS-based Tivoli Management Services
processes from OMEGAMON V350/V360 to IBM Tivoli Monitoring V6.2.2; thus this two-step upgrade
process does not apply to a z/OS-based Candle Management Server nor to any z/OS monitoring
agent.
Planning your upgrade

The following sections provide planning information for upgrading to IBM Tivoli Monitoring V6.2/V6.2.2:
v Platforms no longer supported for IBM Tivoli Monitoring V6.2/V6.2.2
v Prerequisites for IBM Tivoli Monitoring V6.2/V6.2.2 on page 117
v IBM Tivoli Monitoring V6.2.x coexistence and interoperability on page 124
v Components to upgrade on page 117
v Required order of upgrade on page 118
v Migrated information when upgrading from a previous version on page 119
v Backing up IBM Tivoli Monitoring on page 119
Note: In previous versions there was no validation on hub and remote monitoring server protocols and
stand-by configuration, so it is possible that your configuration has incorrect entries. Consider
reconfiguring all monitoring servers, both hub and remote. During this reconfiguration you will be
warned about incorrect entries. Reconfiguration may be particularly useful if you are experiencing
long startup and stopping times for monitoring servers. You can reconfigure a hub monitoring server
as a remote, but reconfiguring a remote monitoring server from a remote to a hub is currently not
supported. In this case you must reinstall the monitoring server.
Platforms no longer supported for IBM Tivoli Monitoring V6.2/V6.2.2

The following platforms are no longer supported for IBM Tivoli Monitoring V6.2, V6.2.1, or V6.2.2:
v Windows 2000 Professional
v AIX V5.1
v i5/OS V5.2
116
v
v
v
v
v
z/OS V1.4
z/OS V1.5
RedHat Enterprise Linux V2.1 x86 Summarization and Pruning agent
RedHat Enterprise Linux V3 x86 Warehouse Proxy agent and Summarization and Pruning agent
RedHat Enterprise Linux V3 zSeries Warehouse Proxy agent and Summarization and Pruning agent
v SuSE Linux Enterprise V8 x86 Tivoli Enterprise Monitoring Server, Warehouse Proxy agent and
v SuSE Linux Enterprise V8 zSeries Warehouse Proxy agent and Summarization and Pruning agent
For a complete description of the supported platforms for IBM Tivoli Monitoring V6.2, see Hardware and
software requirements on page 96.
Prerequisites for IBM Tivoli Monitoring V6.2/V6.2.2

Some of the prerequisites have changed for the current version of IBM Tivoli Monitoring. Review the
Hardware and software requirements on page 96 for each component and platform and apply all
necessary upgrades and fix packs before you begin your upgrade.
Upgrading and Migrating DB2 Database for Linux, UNIX, and Windows
IBM Tivoli Monitoring V6.2.x includes a limited-use version of IBM DB2 Workgroup Server Edition V9.5 for
use with the Tivoli Enterprise Portal Server and the Tivoli Data Warehouse. IBM Tivoli Monitoring V6.2 and
its fix packs included a limited-use version of IBM DB2 Enterprise Server Edition V9.1.
As long as you're using a supported version of DB2 Database for Linux, UNIX, and Windows, upgrading
and migrating to IBM DB2 Workstation Server Edition V9.5 is not required. See Supported databases for
Tivoli Enterprise Portal Server and Tivoli Data Warehouse on page 107 for supported database versions.
If you elect to upgrade and migrate from an earlier version of DB2 for the workstation, you may receive a
warning during instance migration that the new edition of DB2 is different from the edition prior to upgrade
(Workgroup Edition versus Enterprise Server Edition). As a result, certain DB2 GUI utilities such as db2cc
may fail to start after migration, possibly due to the DB2 jdk_path parameter being restored to its default
value during the migration. To resolve this, jdk_path may need to be reset: as the db2inst1 user, run the
following DB2 command:
db2 update dbm cfg using jdk_path /home/db2inst1/sqllib/java/jdk32
See the DB2 Version 9.5 for Linux, UNIX, and Windows Migration Guide for more information on the
jdk_path parameter.
Components to upgrade
You can determine what components to upgrade by using either of two methods. Use the Enterprise level
of the Managed Systems Status list to display the version of any connected agent, as well as its status
(online/offline). Identifying an agent's status is especially important as you plan remote deployments. An
alternative method, available at the Enterprise level of the Navigator, is to use the Tivoli Management
Services Infrastructure view. This topology view visually expresses the relationships and linking of
monitoring agents and other components to the hub monitoring server. Use hover-help (help flyovers) in
the Tivoli Enterprise Portal topology view to determine the current version of your installed monitoring
agents and other components.
1. Access the Tivoli Enterprise Portal through the desktop client or the browser client:
v Desktop client:
a. In the Windows Start menu, select Programs IBM Tivoli Monitoring Tivoli Enterprise
Portal. The login message is displayed.
b. Type the name (sysadmin) and password of the account that you created during installation.
c. Click OK.
117
v Browser client:
a. Start the browser.
b. Type the following URL for the Tivoli Enterprise Portal into the Address field of the browser:
http://systemname:1920///cnp/client
where the systemname is the host name of the computer where the Tivoli Enterprise Portal Server
is installed, and 1920 is the port number for the browser client. 1920 is the default port number
for the browser client. Your portal server might have a different port number assigned.
c. Click Yes in response to any security prompts.
d. In the login prompt, type the user name and password of the sysadmin account that you
created during installation.
e. Click OK.
f. Click Yes to accept Java Security certificates for this browser session.
2. Click the Navigator, the view that is located by default in the upper-left corner of the portal. The first
display that you see in the Navigator view is Enterprise Status workspace.
3. Select the Enterprise node at the top of the navigation tree, if it is not already selected.
4. Right-click the node and select Workspace > Self-Monitoring Topology to display the default
topology view.
5. Click on the TMS Infrastructure - Base view. This view contains the topology display.
6. Click on the Maximize icon in the upper-right corner of the portal. The topology view occupies the
entire display area of the workspace.
Required order of upgrade

Upgrade the products that comprise your configuration in the order described below. If multiple
components are being installed within a single installation directory, upgrade all components at once rather
than running the upgrade multiple times.
1. Event synchronization component
If you use event synchronization, upgrade the event synchronization component first (see Upgrading
to Tivoli Event Synchronization version 2.2.0.0 on page 485).
2. Tivoli Data Warehouse
a. Stop all instances of the Warehouse Proxy agent and the Summarization and Pruning agent.
b. If you are upgrading from V6.1.x and are collecting warehouse data from any of the agents listed in
Table 20 on page 119, you must migrate your warehouse database before you upgrade other
components. Refer to Upgrading the warehouse on page 123 and the user's guide for each agent
for details.
Install the Tivoli Enterprise Portal Server (step 5 on page 119) before you upgrade the warehouse
components to ensure the SQL scripts needed for the warehouse upgrade are available. Ensure
you upgrade all your site's Warehouse Proxy agents and Summarization and Pruning agents
before performing step 7 on page 119.
Note: Running the upgrade scripts a second time may cause loss of warehouse data.
If you are upgrading from V6.2.x, you do not need to perform these migration steps.
3. Hub Tivoli Enterprise Monitoring Server
Upgrading the hub monitoring server is not required, but if the hub is not upgraded, new features of
upgraded agents will not be available. If the hub is upgraded, it must be upgraded first. If the Hot
Standby feature is used, the primary and secondary hub monitoring servers must be upgraded in that
order before the remote monitoring servers are upgraded.
Note: Installing a back-level OS agent into an existing V6.2.2 environment is not supported. If this is
the desired configuration, install the back-level OS agent first.
4. Remote monitoring servers (if necessary)
118
5. Tivoli Enterprise Portal Server

6. Tivoli Enterprise Portal desktop client
The client and the portal server must be at the same level for the client to connect successfully.
7. Monitoring agents
Note: The appropriate level of the Tivoli Enterprise Management Agent Framework is installed when
an agent is installed.
Table 20. Agents requiring warehouse database migration
v Windows OS agent
v Unix OS agent
v Monitoring for Databases: DB2 Database for Linux, UNIX, and Windows agent
v Monitoring for Databases: Sybase agent
v Monitoring for Databases: mySAP agent
v Monitoring for Databases: Oracle agent
Note: Agents created with the Agent Builder require that the entire path from the agent, through the
remote monitoring server it connects to, to the hub monitoring server, to the portal server, and the
data warehouse be upgraded to V6.2. Agents released after IBM Tivoli Monitoring V6.2 may also
require a complete V6.2 path. Check your agent documentation.
Migrated information when upgrading from a previous version

When installing over a previous release (into the same installation directory) the following information is
migrated into the new version:
v Windows:
Port number and communication protocol settings
Situations
v UNIX: situations
Backing up IBM Tivoli Monitoring

Before upgrading, make a backup copy of your current IBM Tivoli Monitoring installation in case you need
to revert to it. You should always contact IBM Software Support before attempting to use the files
generated by the following procedures to restore the IBM Tivoli Monitoring environment. The support staff
can help ensure success of the restoration. Otherwise, errors made during the modification of the
Windows registry could lead to a corrupted operating system or other problems.
The following procedures describe valid methods for creating a backup. However, an enterprise typically
has a standard process for preserving a backup image of all computer systems, including the IBM Tivoli
Monitoring environment. In most cases, the standard process for your enterprise is preferable to the
processes described in this section. Use the instructions in this section only when a standard backup
process is not available.
You must perform the following instructions when no other activity is running on the system. The user
accounts that you use to perform these activities must have root or Administrator privileges:
v Backing up a Windows installation on page 120
v Backing up a UNIX or Linux installation on page 121
119
Backing up a Windows installation

Follow these steps to back up a Windows installation. In Step 4 of this procedure, you record the current
configuration settings. In Step 9 on page 121, you apply these settings again.
Note: Typically an enterprise has a standard process for preserving a backup image of all computer
systems, including the IBM Tivoli Monitoring environment. In most cases, the standard process for
your enterprise is preferable to the processes described in this section. Use the instructions in this
section only when a standard backup process is not available.
1. Close any browser or desktop clients for the Tivoli Enterprise Portal.
2. Launch the Manage Tivoli Enterprise Monitoring Services (KinConfg.exe) utility.
3. On the computer where you are backing up an installation, stop the Tivoli Enterprise Portal Server, the
Tivoli Enterprise Monitoring Server, the Eclipse Help Server, and all the monitoring agents running on
the system.
4. Perform the following steps to record the current configuration settings for IBM Tivoli Monitoring. (For
example, you can make a record on a sheet of paper or in a buffer file.)
a. Right-click in the row of the component that you want to configure.
b. Select Reconfigure.
Note: You make no changes in the series of windows that are displayed.
c. Record the settings for the component in the series of configuration windows.
You record details such as port numbers, host names, protocols for communication, firewall
settings, and settings for the data warehouse.
d. Click OK in each window and accept all prompts, without making changes.
Note: If you click Cancel at any point, the Reconfigure process fails to display all configuration
windows. You must start the Reconfigure process again.
You must unconfigure the monitoring environment in the next step. This action restores the Windows
registry to a known state that ensures success, if you restore the environment later.
5. Perform the following steps to unconfigure each IBM Tivoli Monitoring component, except the Tivoli
Enterprise Portal desktop client. Do not perform the following steps for the desktop client.
a. Right-click in the row of a component in the Manage Tivoli Enterprise Monitoring Services
window.
b. Select Advanced >> Unconfigure in the popup menu.
When you are finished, all components except the Tivoli Enterprise Portal desktop show No in
Configured column of the Manage Tivoli Enterprise Monitoring Services window.
6. Use a compression command to compress the contents of the directory where IBM Tivoli Monitoring is
installed.
7. Use the appropriate database commands to back up the Tivoli Enterprise Portal Server and Tivoli Data
Warehouse databases.
For more information, see Backing up your portal server and Tivoli Data Warehouse databases on
page 122.
8. Export the entire Windows registry to a backup file as follows:
a. Select Run in the Windows Start menu.
b. Type regedit in the Open field.
c. Click OK. The Registry Editor is displayed.
d. Ensure that the MyComputer node at the top of the registry is selected, so that all values in the
registry are exported.
e. Select Export in the File menu.
f. Save the copy of the registry to the following path and filename: C:\WinRegistryBeforeInstall.reg
120
At this time, the backup process is complete.

9. Perform the following steps to return IBM Tivoli Monitoring to its normal configuration and status:
a. Right-click in the row of each unconfigured component.
"Unconfigured" components show No in the Configured column of the Manage Tivoli Enterprise
Monitoring Services window.
b. Select Advanced >> Configure Advanced in the popup menu.
c. In the series of dialog boxes that is displayed, enter the original parameter settings that you
recorded in Step 4 on page 120.
d. Click OK in each configuration window and accept other prompts to save your changes.
When you are finished, all components show Yes in Configured column and Stopped in the Status
column.
You are ready to proceed with the upgrade on this computer.
Always contact IBM Software Support before attempting to use the files generated in this procedure to
restore the IBM Tivoli Monitoring environment. The support staff can help ensure success of the
restoration. Otherwise, errors made during the modification of the Windows registry could lead to a
corrupted operating system.
Backing up a UNIX or Linux installation

Follow these steps to back up a UNIX or Linux installation.
Note: Normally an enterprise has a standard process for preserving a backup image of all computer
systems, including the IBM Tivoli Monitoring environment. In most cases, the standard process for
your enterprise is preferable to the processes described in this section. Use the instructions in this
section only when a standard backup process is not available.
1. Close the Tivoli Enterprise Portal browser and desktop clients.
2. Stop the Tivoli Enterprise Portal Server, the Tivoli Enterprise Monitoring Server, the Eclipse Help
Server, and all the monitoring agents running on the system.
3. If the Tivoli Enterprise Portal Server is installed, run the following command:
./itmcmd execute cq "runscript.sh migrate-export.sh"
4. Use the tar command to compress the contents of ITM_Install_dir (the directory where IBM Tivoli
Monitoring is installed), using a command that is similar to the following:
tar -cvf /tmp/ITM_Install_dir.backup.tar ITM_Install_dir
5. Add the following files to the tar file created in step 4 above:
v On AIX:
/etc/rc.itm*
tar -uvf /tmp/ITM_Install_dir.backup.tar /etc/rc.itm*
v On HP-UX:
/sbin/init.d/ITMAgents*
tar -uvf /tmp/ITMinstall_dir.backup.tar /etc/init.d/ITMAgents*
v On other UNIX or Linux systems:

/etc/initd/ITMAgents*
tar -uvf /tmp/ITM_Install_dir.backup.tar /etc/init.d/ITMAgents*
6. Use the appropriate database commands to back up the Tivoli Data Warehouse databases.
For more information, see Backing up your portal server and Tivoli Data Warehouse databases on
page 122.
You are now ready to proceed with the upgrade.
121
Always contact IBM Software Support before attempting to use the files generated in this procedure to
restore the IBM Tivoli Monitoring environment. The support staff can help ensure success of the
restoration. Otherwise, errors made during the modification of the Windows registry could lead to a
corrupted operating system.
Backing up your portal server and Tivoli Data Warehouse databases

When backing up your IBM Tivoli Monitoring V6.1 environment, you must also back up your portal server
database and Tivoli Data Warehouse database. The following sections contains procedures for backup up
DB2 for the workstation databases, which are provided as examples. If you use Microsoft SQL Server for
your portal server database, or Oracle for your Tivoli Data Warehouse database, use the corresponding
commands.
v Backing up your portal server database
v Backing up your Tivoli Data Warehouse database
Note: These steps are not necessary if you are updating a Tivoli Monitoring V6.2 environment to a later
release of V6.2 (such as V6.2.2).
Backing up your portal server database

DB2 Database for Linux, UNIX, and Windows: Use the following command to backup your portal
server database where DB2 Database for Linux, UNIX, and Windows is the relational database
management system of choice.
db2 backup database yourtepsdatabase to /yourbackuplocation
If an existing connection prevents you from backing up the database, use the following commands.
1.
2.
3.
4.
5.
6.
db2
db2
db2
db2
db2
db2
connect to yourtepsdatabase
quiesce database immediate force connections
connect reset
backup database yourtepsdatabase to /yourbackuplocation
connect to yourtepsdatabase
unquiesce database
7. db2 connect reset

Derby: Use the following procedure to back up your portal server database where the embedded
database, Derby, is the relational database management system of choice.
1. Shut down the Tivoli Enterprise Portal Server.
2. To back up the Derby database, you can have the portal server export the IBM Tivoli Monitoring
records stored in the Derby database, or you can manually back up the entire Derby database.
v To export the Tivoli Monitoring data in the Derby database, use the migrate-export script, as
documented in the IBM Tivoli Monitoring: Administrator's Guide.
v To manually back up the entire Derby database, copy the database directory to a backup location.
This database is stored in either of these locations:
Windows: ITMHOME\CNPSJ\derby\TEPS0
Linux/UNIX: ITMHOME/platform/iw/derby/TEPS0
3. Restart the portal server.
Backing up your Tivoli Data Warehouse database

Use the following command to back up your Tivoli Data Warehouse database where DB2 Database for
Linux, UNIX, and Windows is the relational database management system of choice.
db2 backup database yourwarehousedatabase to /yourbackuplocation
122
If an existing connection prevents you from backing up the database, use the following commands.
1. db2 connect to yourwarehousedatabase
2. db2 quiesce database immediate force connections
4. db2 backup database yourwarehousedatabase to /yourbackuplocation
5. db2 connect to yourwarehousedatabase
6. db2 unquiesce database
Sites using the Summarization and Pruning agent with DB2 for the workstation
Your migrated Tivoli Data Warehouse database requires subsequent checking to ensure it is set up
so the Summarization and Pruning agent can perform multiple system batching. Complete these
steps:
1. Back up the database, if necessary.
2. Edit the KSY_DB2_WAREHOUSEMARKER.sql script. If using archive logging, modify it as
suggested in the script to avoid the need for extra backup at the end.
3. Execute the script:
db2 -tvf KSY_DB2_WAREHOUSEMARKER.sql
The code will detect if the table is correctly migrated. If not, a single managed system will be
enforced independent of the setting to prevent database deadlocks.
This procedure affects only the WAREHOUSEMARKER table. If you do not complete it, the
Summarization and Pruning agent will do single system batching only.
Upgrading the warehouse

Note:
Complete these steps only if you are upgrading from IBM Tivoli Monitoring V6.1.x levels. They do not
apply to any level after and including V6.2.0. Running the upgrade scripts again may lead to loss of
some data.
Some of the monitoring agents have made changes to the warehouse tables. There are three types of
changes, two of these types of changes require performing upgrade procedures before running the 6.2
Warehouse Proxy and Summarization and Pruning agents. The procedure for the other change can be
performed before or after you upgrade IBM Tivoli Monitoring. These procedures are accomplished using
product-provided scripts.
Case 1 changes affect the table structure, and Case 3 changes affect the table location. Both Case 1 and
Case 3 changes must be completed before running the 6.2 Warehouse Proxy and Summarization and
Pruning agents. These changes and procedures are documented comprehensively in the following user's
guide appendix for each monitoring agent that is affected: "Upgrade: upgrading for warehouse
summarization."
v Case 1 changes add a new column to a raw table, and assign a default value to the column. If the 6.2
Warehouse Proxy agent is started before these scripts are run, a NULL default value is assigned, and
that default value cannot be changed. The following monitoring agents have Case 1 changes:
Monitoring for Databases: DB2 for the workstation Agent
Monitoring for Applications: mySAP Agent
Monitoring: UNIX OS Agent
123
Monitoring: Windows OS Agent

v Case 2 changes affect how agent data is summarized because of changes in primary key definitions.
The Case 2 changes can be done before or after you upgrade IBM Tivoli Monitoring.The following
monitoring agents have Case 2 changes:
Monitoring for Applications: mySAP Agent
Monitoring for Databases: Sybase Server Agent
Monitoring: Windows OS Agent
v Case 3 changes are only applicable if you are using DB2 for the workstation as your warehouse
database. These changes move a summary table from the 4K table space to the 8K table space. If the
6.2 Summarization and Pruning agent is started before these scripts are run, you receive DB2 for the
workstation errors, because the row size of the upgraded table is longer than what can fit into the 4K
table space. The following monitoring agents have Case 3 changes:
IBM Tivoli Monitoring for Databases: DB2 for the workstation Agent
IBM Tivoli Monitoring for Databases: Oracle Agent
IBM Tivoli Monitoring: UNIX OS Agent
To ensure that you can make the table upgrades required by Case 1 and Case 3 before installing the 6.2
monitoring agents, do the following:
1. Stop the Warehouse Proxy and the Summarization and Pruning agents prior to upgrading to IBM Tivoli
Monitoring V6.2 or V6.2FP1.
2. Change the default startup of these monitoring agents to "Manual" so they do not start automatically
during any restart of host computer. This prevents these agents from starting automatically during the
upgrade process.
3. Perform the IBM Tivoli Monitoring upgrades.
4. Make the warehouse updates for the monitoring agents with Case 1 and Case 3 changes as described
in the user's guide for the affected agent.
5. Re-enable the automatic startup of the Warehouse Proxy and the Summarization and Pruning agents,
and start these agents.
Several monitoring agents made changes to the warehouse collection and summarization characteristics
for some agent attribute groups. These changes correct and improve the way warehouse data is
summarized, producing more meaningful historical reports. For an explanation of these changes and the
implications to your warehouse collection and reporting, see the "Upgrading for warehouse summarization"
appendix of the user's guide for your specific monitoring agent.
IBM Tivoli Monitoring V6.2.x coexistence and interoperability

The following statements specify the level of interoperability for IBM Tivoli Monitoring V6.2 in support of
existing agents and staged upgrade scenarios. Special interoperability notes for Tivoli Monitoring V6.2.1
and V6.2.2 are provided where appropriate.

v V6.1 remote monitoring servers can connect to V6.2, V6.2.1, or V6.2.2 hub monitoring servers.
v V6.2, V6.2.1, or V6.2.2 remote monitoring servers can connect to V6.1 hub monitoring servers as long
as no agents require dynamic-affinity support.
Note: Agents created with the Agent Builder require that the entire path from the agent, through the
remote monitoring server to which it connects, to the hub monitoring server, to the portal server
and the data warehouse be upgraded to V6.2, V6.2.1, or V6.2.2. Agents released after IBM Tivoli
Monitoring V6.2 may also require the V6.2 path. Check your agent documentation.
124
Also, agents built with the V6.2.1.x Agent Builder (or previous) cannot be installed into an
environment where a System Monitor Agent is also running.
v If your site uses IP.SPIPE for Tivoli Enterprise Monitoring Server communication:
A V6.2.2 remote monitoring server not running in FIPS mode can connect to a V6.1 hub.
Connectivity will default to the Triple DES standard.To enable AES encryption on the hub, customers
may set parameter GSK_V3_CIPHER_SPECS="352F0A" on the V6.1 monitoring system.
A V6.2 or V6.2.1 remote monitoring server can connect to a V6.2.2 hub not running in FIPS mode.
Connectivity will default to the Triple DES standard. To enable AES encryption, customers may set
parameter GSK_V3_CIPHER_SPECS="352F0A" on the remote monitoring systems.
A pre-V6.2.2 agent can select IP.SPIPE to connect to a V6.2.2 monitoring server defined with
FIPS=N.
A pre-V6.2.2 agent cannot select IP.SPIPE to connect to a V6.2.2 monitoring server defined with
FIPS=Y.
A V6.2.2 agent defined with FIPS=N can select IP.SPIPE to connect to a V6.2.1 monitoring server.
A V6.2.2 agent defined with FIPS=Y cannot select IP.SPIPE to connect to a V6.2.1 monitoring
server.
A V6.2.2 agent defined with either FIPS=N or FIPS=Y can select IP.SPIPE to connect to a V6.2.2
monitoring server defined with either FIPS=N or FIPS=Y.
v A V6.2, V6.2.1, or V6.2.2 remote monitoring server can connect to a V6.2, V6.2.1, or V6.2.2 hub
monitoring server.
v If you are running a hub monitoring server at release 6.2 or earlier, the CLI commands for situation
groups, situation long names, and adaptive monitoring cannot be used.
v Agents that use dynamic affinity cannot connect or fail over to a pre-V6.2.1 remote monitoring server.
v V6.2.2 interoperability with OMEGAMON Platform V350/360 remains the same as for IBM Tivoli
Monitoring V6.1; see Upgrading from OMEGAMON Platform V350 and V360 on page 131.

v The Tivoli Enterprise Portal Server can interoperate with older hub Tivoli Enterprise Monitoring Servers
back to V350.
v A Tivoli Enterprise Portal Server upgrade-in-place is supported from CandleNet Portal Server V196 or
IBM Tivoli Monitoring V6.1 portal server to the IBM Tivoli Monitoring V6.2 or V6.2.1 portal server on the
same platform.
v A Tivoli Enterprise Portal Server upgrade to a new platform is accomplished with database export and
import.
Portal server upgrades to the new release are accomplished with the export/import feature. For
information about migrating the database, see the description of the migrate-export and migrate-import
scripts in the IBM Tivoli Monitoring: Administrator's Guide.
v IBM Tivoli Monitoring V6.2 supports importing an IBM Tivoli Monitoring V6.1 database and then
upgrading it by running buildpresentation.bat (for Windows platforms) or InstallPresentation.sh (for
UNIX/Linux platforms).
Special interoperability requirements for IBM Tivoli Monitoring V6.2.2:
v The V6.2.2 Tivoli Enterprise Portal Server can interoperate with older hub Tivoli Enterprise Monitoring
Servers as far back as version 6.1.
v Portal server upgrade-in-place is supported from V6.1 to either V6.2, V6.2.1, or V6.2.2 on the same
platform. To upgrade your portal server to a new platform, use database export/import.
v When upgrading from a prior portal server to the current version, it is important that your machine's
temporary directory have sufficient space to accommodate the download of the eWAS server code and
the Eclipse server code. See the memory and disk space requirements for V6.2.2 documented in
Table 18 on page 110.
125

v All Warehouse Proxy and Summarization and Pruning agents must be at the same level to avoid
inconsistencies in presentation.
v Warehouse Proxy and Summarization and Pruning V6.1, V6.2, or V6.2.1 agents can interoperate with
either V6.1, V6.2, or V6.2.1 monitoring servers.
v The V6.2.1 Warehouse Proxy agent and Summarization and Pruning agent are required for correct
functioning of any V6.2.1 agent requiring 64-bit integer support.
Special interoperability requirements for IBM Tivoli Monitoring V6.2.2:
v The V6.2.2 Warehouse Proxy and Summarization and Pruning agents are required for correct
functioning of any V6.2.x agent.
v 64-bit integer data support requires either the V6.2.1 or V6.2.2 Warehouse Proxy and Summarization
and Pruning agents.
Agents
IBM Tivoli Monitoring V6.2.2 agents require a V6.2.2 hub Tivoli Enterprise Monitoring Server and Tivoli
Enterprise Portal Server. In other words, the V6.2.1 (and earlier) monitoring server and portal server do not
support V6.2.2 agents.
Back-level agents can connect through up-level monitoring servers. In particular, V6.2.1 agents will work
with both the V6.2.1 and V6.2.2 Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server.
Agents that use dynamic affinity cannot connect or fail over to a pre-V6.2.1 remote monitoring server.
An agent upgrade elevates the user credentials of agents that have been set at deployment time to run
with reduced (nonroot) credentials. Use one of the following steps to stop the agent and restart it with the
appropriate user credentials:
v After stopping the agent, log in (or invoke su) as the desired user, and then run the itmcmd command to
start the agent in that user's context.
v Edit the startup file, and add the following line to change the default user context for starting agents:
/usr/bin/su - dbinstancename-c "itmhome/bin/itmcmd agent -h itmhome
-o dbinstancename start product_code
where:
product_code
is the two-character product code for the agent (for example, ud for DB2 for the workstation).
Special interoperability note for IBM Tivoli Monitoring V6.2.1 and V6.2.2:
Java Runtime Environment changes were introduced in the V6.2.1 agents but only to update the service
level. No impact is expected.
Tivoli Event Synchronization component

IBM Tivoli Monitoring and Tivoli Event Synchronization version 1.x installed on a Tivoli Enterprise Console
event server do not operate with a V6.2 hub monitoring server. If you have already installed a previous
version of Tivoli Event Synchronization, you must upgrade to version 2.2.0.0. (see Upgrading to Tivoli
Event Synchronization version 2.2.0.0 on page 485). The upgrade is required for the event server to
correctly parse events coming from the V6.2 hub monitoring server.
126
Upgrading from IBM Tivoli Monitoring V6.1 or V6.2

The following sections provide information for upgrading from IBM Tivoli Monitoring V6.1 or V6.2 to IBM
Tivoli Monitoring V6.2.2:
v Overview of the upgrade process
v Required Java Runtime Environment on page 131
Overview of the upgrade process

Upgrading from IBM Tivoli Monitoring V6.1 to IBM Tivoli Monitoring V6.2 involves the following steps:
Table 21. Upgrading from IBM Tivoli Monitoring V6.1 or V6.2 to IBM Tivoli Monitoring V6.2.2
Task
Before upgrading your
monitoring environment
Where to find information
Review the upgrade planning information

to identify what you can and cannot
upgrade, as well as the required upgrade
order.
Planning your upgrade on page 116
Linux and UNIX sites: If your Tivoli

Enterprise Portal Server is running as a
nonroot process and you plan to upgrade
it using a nonroot userid, then a special
procedure must be performed prior to
upgrade.
Linux and UNIX: Upgrading a portal

server running as a nonroot process on
page 129
Starting and stopping components on

Stop all components that you are
page 265
upgrading and change their startup from
Automatic to Manual. Stop Manage Tivoli
Enterprise Monitoring Services, and do not
start any other Tivoli Management
Services components while you complete
this upgrade.
Restart the computer on which you are
installing IBM Tivoli Monitoring.
Upgrading your monitoring
environment
Run the IBM Tivoli Monitoring installation

program on all components that you want
to upgrade. Use your existing installation
directory as your IBM Tivoli Monitoring
directory.
Chapter 8, Installing IBM Tivoli

Monitoring, on page 147
127
Table 21. Upgrading from IBM Tivoli Monitoring V6.1 or V6.2 to IBM Tivoli Monitoring V6.2.2 (continued)
Task
After upgrading your
Chapter 10, Configuring IBM Tivoli

On platforms other than Windows, you
Monitoring components, on page 261
must reconfigure the Tivoli Enterprise
Monitoring Server and the Tivoli Enterprise
Portal Server.2
Note: On Windows platforms, the installer
manages the reconfiguration process.
On Windows platforms, if you chose
upgrade seeding, support for base agents
is upgraded automatically, but you must
add application support for any other
monitoring agents you are upgrading.
Configuring application support for

nonbase monitoring agents on page 199
After upgrading your Tivoli Enterprise

Monitoring Server, you must add
application support to it.2 This step
updates existing situation definitions and
installs new situations provided with Tivoli
Monitoring V6.2.2.
Installing and enabling application

support on page 196
Application support is contained in the ms

component.
v On Windows, you are automatically
prompted to add application support to
the monitoring server using the
kms_upg.sql file.
v On Linux or UNIX, you must initiate
upgrade reseeding using the itmcmd
support command and specifying the
ms component:
./itmcmd support -t tems_name ms
When reseeding completes, recycle
your monitoring server:
./itmcmd server stop tems_name
./itmcmd server start tems_name
Notes:
1. The installation instructions sometimes reference the default path for the installation of IBM Tivoli Monitoring. If
you did not install the product in the default path, you must specify the correct path whenever the upgrade
procedures require a path specification.
2. After you upgrade a UNIX monitoring server, you must run the itmcmd config -S command to configure the
upgraded monitoring server. During this upgrade you are asked if you want to update application support files as
well.
If a silent upgrade is performed by default, all installed support files are updated.
3. You can use the tacmd updateAgent command to install an agent update on a specified managed system. For
reference information about this command and related commands, see the IBM Tivoli Monitoring: Command
Reference.
4. You must recycle (stop and restart) the portal server to use upgraded workspaces for your monitoring agents.
128
Linux and UNIX: Upgrading a portal server running as a nonroot

process
If the Tivoli Enterprise Portal Server is running as nonroot on either Linux or AIX and you plan to upgrade
it to IBM Tivoli Monitoring V6.2.2 using a nonroot user ID, then you must perform the following procedure
prior to upgrading.
On Linux, you need perform only Step 1: Verify the DB2 Database for Linux, UNIX, and Windows
authorizations; on AIX, perform both Step 1: Verify the DB2 Database for Linux, UNIX, and Windows
authorizations and Step 2: Invoke the AIX slibclean command on page 131.
Step 1: Verify the DB2 Database for Linux, UNIX, and Windows authorizations
In the following example the portal server database is called TEPS, the DB2 for the workstation userid is
itmuser, and the DB2 administrative userid is db2inst1. Both Linux and AIX sites must complete this step.
1. Log in as the DB2 administrator:
su - db2inst1
2. Connect to the portal server database using the portal server's DB2 userid:
db2 connect to TEPS user itmuser using TEPSpw
where TEPSpw is the password for userid itmuser.

3. Get the authorizations for the portal server's DB2 userid:
db2 get authorizations
Example output:
Administrative Authorizations for Current User
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
SYSADM authority
SYSCTRL authority
SYSMAINT authority
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
CREATE_NOT_FENC authority
IMPLICIT_SCHEMA authority
LOAD authority
QUIESCE_CONNECT authority
CREATE_EXTERNAL_ROUTINE authority
SYSMON authority
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
SYSADM authority
SYSCTRL authority
SYSMAINT authority
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
LOAD authority
SYSMON authority
=
=
=
=
=
=
=
=
=
=
=
=
=
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
NO
=
=
=
=
=
=
=
=
=
=
=
=
=
NO
NO
NO
NO
YES
YES
YES
NO
YES
NO
NO
NO
NO
4. Ensure the settings listed below are set to YES, as shown.

Direct
Direct
Direct
Direct
Direct
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
=
=
=
=
=
YES
YES
YES
YES
YES
129
Direct
Direct
Direct
Direct
LOAD authority
=
=
=
=
YES
YES
YES
YES
If they are all set to YES, you are finished. Otherwise continue with steps 5 through 7 below.
5. Connect to the Tivoli Enterprise Portal Server database as the DB2 administrator:
db2 connect to TEPS user db2inst1 using db2pw
where db2pw is the password for userid db2inst1.

6. Grant the appropriate authorizations to the portal server's DB2 userid:
db2 GRANT DBADM,CREATETAB,BINDADD,CONNECT,CREATE_NOT_FENCED_ROUTINE,IMPLICIT_SCHEMA,LOAD,
CREATE_EXTERNAL_ROUTINE,QUIESCE_CONNECT ON DATABASE to user itmuser
7. Reconnect to the portal server database using the portal server's DB2 userid, and recheck its
authorizations:
db2 connect to TEPS user itmuser using TEPSpw
Database Connection Information
Database server
SQL authorization ID
Local database alias
= DB2/LINUX 8.2.8
= ITMUSER
= TEPS
db2 get authorizations

Administrative Authorizations for Current User
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
Direct
SYSADM authority
SYSCTRL authority
SYSMAINT authority
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
LOAD authority
SYSMON authority
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
Indirect
SYSADM authority
SYSCTRL authority
SYSMAINT authority
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
LOAD authority
SYSMON authority
=
=
=
=
=
=
=
=
=
=
=
=
=
NO
NO
NO
YES
YES
YES
YES
YES
YES
YES
YES
YES
NO
=
=
=
=
=
=
=
=
=
=
=
=
=
NO
NO
NO
NO
YES
YES
YES
NO
YES
NO
NO
NO
NO
You should now see the authorizations for the following items set to YES:
Direct
Direct
Direct
Direct
Direct
130
DBADM authority
CREATETAB authority
BINDADD authority
CONNECT authority
=
=
=
=
=
YES
YES
YES
YES
YES
Direct
Direct
Direct
Direct
LOAD authority
=
=
=
=
YES
YES
YES
YES
Step 2: Invoke the AIX slibclean command

This step applies only to AIX sites, not to Linux sites.
As the root user, invoke the AIX slibclean command:
su -c "/usr/sbin/slibclean"
Required Java Runtime Environment

IBM Tivoli Monitoring V6.2 requires Java 1.5. However, running both IBM Tivoli Monitoring V6.1 agents
and IBM Tivoli Monitoring V6.2 agents on the same computer requires both Java 1.4.2 and 1.5 on that
computer.
Upgrading from OMEGAMON Platform V350 and V360

The following sections provide information for upgrading from OMEGAMON Platform 350 or 360 and
CandleNet Portal 195 to IBM Tivoli Monitoring 6.2.2.
Notes:
1. You cannot upgrade directly to IBM Tivoli Monitoring from a version of OMEGAMON Platform prior to
350 or 360. If you are using an older version of OMEGAMON Platform, you must first upgrade to
OMEGAMON Platform 350 or 360 before upgrading to IBM Tivoli Monitoring.
2. There is no direct upgrade path from the OMEGAMON V350 or V360 platform to IBM Tivoli Monitoring
V6.2.2. You must first upgrade to either Tivoli Monitoring V6.1 (with any fix pack), V6.2, or V6.2 with fix
pack 1, then upgrade to V6.2.2. The recommended upgrade path is OMEGAMON V350/V360 Tivoli
Monitoring V6.1 FP5 Tivoli Monitoring 6.2.2. Although the IBM Tivoli Monitoring V6.2 images are not
included with the V6.2.2 media, you can install the V6.1 fix pack 5 distribution provided with previous
releases of the OMEGAMON, NetView, and ITCAM products.
This two-step upgrade process applies to distributed components only; direct upgrade of z/OS-based
Candle Management Servers and monitoring agents continues to be supported using the z/OS
Installation and Configuration Tool.
v Overview of the upgrade process on page 132
v Considerations on page 133
v Using existing OMEGAMON and other monitoring agents with IBM Tivoli Monitoring on page 134
131
Overview of the upgrade process

Upgrading from Candle OMEGAMON Platform 350 or 360 involves the following steps:
Table 22. Upgrading from OMEGAMON Platform 350 or 360
Task
Before installing IBM Tivoli
Monitoring
Review the new terminology. Although the

same components exist in IBM Tivoli
Monitoring, many have new names.
Terminology changes on page 133
Review the upgrade planning information

to identify what you can and cannot
upgrade.
Considerations on page 133
Starting and stopping components on

Stop all components that you are
upgrading and change their startup from
page 265
Automatic to Manual. Stop Manage Tivoli
Enterprise Monitoring Services, and do not
start any other Tivoli Management
Services components while you complete
this upgrade.
Restart the computer on which you are
installing IBM Tivoli Monitoring.
Upgrade your monitoring
environment to Tivoli
Monitoring V6.1 (fix pack 5),
included with your
OMEGAMON, NetView, or
ITCAM media
Run the installation program for IBM Tivoli Chapter 8, Installing IBM Tivoli
Monitoring V6.1 (fix pack 5) on all
components that you want to upgrade.
Use your existing installation directory as
your IBM Tivoli Monitoring directory.
After installing IBM Tivoli

Monitoring V6.1 (fix pack 5)
For any existing OMEGAMON Monitoring

Agents that you want to use with the IBM
Tivoli Monitoring monitoring server,
change their configuration to point to the
new monitoring server.
Upgrade your monitoring

environment to Tivoli
Monitoring V6.2.1 (or
subsequent)
Run the installation program for IBM Tivoli Chapter 8, Installing IBM Tivoli
Monitoring V6.2.1 (or subsequent) on all
components that you want to upgrade.
Use your existing installation directory as
your IBM Tivoli Monitoring directory.
Using existing OMEGAMON and other

monitoring agents with IBM Tivoli
Monitoring on page 134
Notes:
1. After you upgrade a UNIX monitoring server, you must run the itmcmd config -S command to configure the
upgraded monitoring server and the itmcmd support command to update application support files.
2. You must recycle (stop and restart) the portal server to use upgraded workspaces for your monitoring agents.
3. You cannot use the agent deployment function in IBM Tivoli Monitoring to upgrade OMEGAMON agents.
132
Considerations
Consider the following issues when upgrading from OMEGAMON Platform 350 or 360 and CandleNet
Portal 195 to IBM Tivoli Monitoring 6.2.x.
Terminology changes
The following terms have changed with the move from Candle OMEGAMON to IBM Tivoli Monitoring:
Table 23. OMEGAMON to IBM Tivoli Monitoring terminology
OMEGAMON term
IBM Tivoli Monitoring term
Candle Management Server (CMS)
CandleNet Portal (CNP)
CandleNet Portal Server (CNPS)
OMEGAMON Monitoring Agent
Tivoli Enterprise Monitoring Agent (monitoring agent)
OMEGAMON Platform
Tivoli Management Services
Manage Candle Services
Manage Tivoli Enterprise Monitoring Services
Event
Situation event
Seeding
Adding application support
OMEGAMON Web Services
Tivoli Monitoring Web Services
Candle Customer Support
IBM Software Support
When to run the upgrade

Run the upgrade to IBM Tivoli Monitoring immediately after you have restarted the computer that you are
upgrading. IBM Tivoli Monitoring does not install if the computer has any locked files.
If your OMEGAMON components are currently set to start automatically, change the startup to Manual in
Manage Tivoli Enterprise Monitoring Services before you restart the components.
Installation directory for upgraded components

When you upgrade an existing OMEGAMON component to the IBM Tivoli Monitoring level, the installation
process installs all new files in your existing installation directory (instead of the new default installation
directory for IBM Tivoli Monitoring: C:\IBM\ITM on Windows and /opt/IBM/ITM on Linux and UNIX). Your
existing files are overwritten.
If you have applied fixes or patches to the OMEGAMON product component, those fixes and patches that
were available when IBM Tivoli Monitoring was released are included in the upgraded version.
Configuration settings for upgraded agents

When OMEGAMON Platform V350 or 360 agents are upgraded to IBM Tivoli Monitoring, agent-specific
configuration settings regarding the connection to the monitoring server are not maintained. The IBM Tivoli
Monitoring installation uses the default settings for all agents (not the one change that you made for one
agent). To ensure that your upgraded agents can immediately connect to a monitoring server, determine
whether the default settings for all agents point to the new monitoring server prior to upgrading. To change
the default settings for all agents, right-click an agent in Manage Candle Services and click Set defaults
for all agents.
Candle Management Workstation coexistence

If you currently use Candle Management Workstation in your OMEGAMON monitoring environment, you
are migrated to IBM Tivoli Monitoring automatically when you migrate the rest of your environment.
However, the installed Candle Management Workstation continues to function after the migration, although
it is not officially part of IBM Tivoli Monitoring and no new function has been added.
133
If you use the OMEGAMON XE for CICS 3.1.0 product, you must continue to use Candle Management
Workstation to configure workloads for Service Level Analysis. After you have configured the workloads,
you can use the Tivoli Enterprise Portal for all other tasks. If you do not currently have Candle
Management Workstation (for example, if you are installing OMEGAMON XE for CICS 3.1.0 into an IBM
Tivoli Monitoring environment), you must install the Candle Management Workstation that is included with
the OMEGAMON XE for CICS 3.1.0 product. Install Candle Management Workstation on a different
computer than the Tivoli Enterprise Portal; otherwise the Candle Management Workstation installer
attempts to uninstall the Tivoli Enterprise Portal.
Note: As of OMEGAMON XE for CICS 4.1.0, the Candle Management Workstation is no longer required.
A new view, CICS SLA, is provided with Tivoli Enterprise Portal V6.2 (and subsequent) that
replaces the Service Level Analysis feature of the old Candle Management Workstation.
Additional unsupported OMEGAMON functions

The following functions are no longer supported as part of IBM Tivoli Monitoring:
Table 24. Unsupported OMEGAMON functions
Function
IBM Tivoli Monitoring equivalent function
CandleClone
Agent deployment, as described in Chapter 9, Deploying

monitoring agents across your environment, on page 237
CandleRemote
Event emitters
Event adapters
Event forwarding using the Tivoli Enterprise Console

event synchronization, as described in Chapter 21,
Setting up event forwarding to Tivoli Enterprise Console,
on page 463
GUI installation wizard on UNIX
Use the command line installation option, as described in

Chapter 8, Installing IBM Tivoli Monitoring, on page 147
Silent installation on UNIX using the multi-platform

installation program
Silent installation using custom response files, as

described in Performing a silent installation on a Linux or
UNIX computer on page 544.
CandleNet Portal database

If you use a DB2 for the workstation database for the CandleNet Portal, the database is converted to
UTF-8 format during the upgrade. This might take several minutes, depending on the size of your
database. If you used the default database password when you created the CandleNet Portal database
(TEPS), you are prompted for a new password to comply with the more stringent security provisions in
IBM Tivoli Monitoring.
Required Java JRE

The CandleNet Portal requires the Sun Java JRE; however Tivoli Enterprise Portal requires the IBM Java
JRE 1.5. You do not need to install this JRE prior to the upgrade: it is installed automatically when you
choose to install an IBM Tivoli Monitoring component that requires it.
Using existing OMEGAMON and other monitoring agents with IBM

Tivoli Monitoring
Existing installed OMEGAMON Platform 350 and 360 agents and new IBM Tivoli Composite Application
Management and AF/Operator agents can be supported using the Tivoli Enterprise Monitoring Server;
however, the following restrictions apply:
v New features in IBM Tivoli Monitoring (such as remote deployment) are not supported on OMEGAMON
Platform 350 and 360 agents.
v Agents must use one of the following protocols to communicate with the monitoring server:
IP.UDP (formerly TCP/IP)
IP.PIPE
134
SNA
The IP.SPIPE protocol is not supported for OMEGAMON XE agents.
v You cannot install an OMEGAMON agent on the same computer as a Tivoli Enterprise Portal Server. If
you want to monitor something on the same computer as the portal server, install an IBM Tivoli
Monitoring agent, if one is available.
v IBM Tivoli OMEGAMON XE for Messaging V6.0 requires that the hub Tivoli Enterprise Monitoring
Server, the Tivoli Enterprise Portal Server, and the Tivoli Enterprise Portal client be at the IBM Tivoli
Monitoring V6.2 level.
After you upgrade the infrastructure components to IBM Tivoli Monitoring V6.2, install application
support files for this monitoring agent on the monitoring server, the portal server, and the portal desktop
client. To install and enable application support, follow the instructions in the IBM Tivoli OMEGAMON
XE for Messaging Version 6.0 Installation Guide.
v To enable the Tivoli Data Warehouse to collect data from OMEGAMON Platform 350 and 360 agents
(through the Warehouse Proxy), copy the product attribute file to the itm_installdir/TMAITM6/ATTRLIB
directory on the Warehouse Proxy agent (where itm_installdir is the IBM Tivoli Monitoring installation
directory).
For full interoperability between OMEGAMON Platform 350 and 360 and AF/Operator agents and IBM
Tivoli Monitoring, you need to install the application support files for these agents on the monitoring server,
portal server, and portal desktop client. See the "Agent interoperability" document in the IBM Tivoli
Monitoring information center for information about downloading and installing these support files.
Scenario: a rolling product upgrade

Here is an example of a possible scenario for rolling out the upgrade of an installed IBM Tivoli Monitoring
environment from one release to a later release.
Configuration
Your existing Tivoli Monitoring environment includes these five distributed servers:
v The primary (acting) hub Tivoli Enterprise Monitoring Server runs on server #1, an AIX 5.3, 64-bit node.
v The secondary (backup) hub monitoring server runs on server #2, a Solaris 10, 32-bit node.
v A remote Tivoli Enterprise Monitoring Server runs on server #3, an RHEL Linux 2.6, 32-bit node.
v A second remote monitoring server runs on server #4, a Windows 2000 node.
v The Tivoli Enterprise Portal Server running on server #5, another RHEL Linux 2.6, 32-bit node,
communicates with the acting (primary) hub monitoring server running on server #1. server #5 also runs
the Warehouse Proxy agent and the Summarization and Pruning agent.
Each system runs an OS agent and the Tivoli Universal Agent. All 14 nodes in this example configuration
are connected to one remote monitoring server as its primary and the other as its secondary, to
accommodate agent switching when upgrading the remote Tivoli Enterprise Monitoring Servers. Half of the
agents point to each remote monitoring server as its primary monitoring server.
Upgrading the Tivoli Monitoring environment

Install a given level of IBM Tivoli Monitoring on the primary and secondary hub monitoring server, on the
remote monitoring servers, and on the portal server. Install agents (simple agents, subnode agents,
SYSPLEX agents), including the Warehouse Proxy agent and the Summarization and Pruning agent, at
the same level of IBM Tivoli Monitoring. Configure the Warehouse Proxy and Summarization and Pruning
agents to report directly into both hubs, configured as primary and secondary. You can optionally configure
a second Warehouse Proxy agent, to serve as a backup.
Other agents report to at least one of the remote monitoring servers.
135
1. Begin historical collection of agent attributes. Assume the historical collection is being done at the
agents and not at the Tivoli Enterprise Monitoring Server; otherwise data collection may be
interrupted when agents switch from the acting monitoring server to the backup.
2. Cause situations to fire, for example, by varying thresholds. For nodes running the Tivoli Universal
Agent, include always-true situations.
3. Ensure the acting (primary) and backup (secondary) monitoring servers are connected by examining
their log/trace records and process state for these messages:
v KQM0001 "FPO started at ..."
v KQM0003 "FTO connected to ..."
v KQM0009 "FTO promoted primary as the acting HUB"
v KQM0009 "FTO promoted SITMON*secondary(Mirror) as the acting HUB"
4. If you have integrated your IBM Tivoli Monitoring events with either Tivoli Enterprise Console or
Netcool/OMNIbus (see 461):
a. First upgrade your event synchronization.
b. Then restart Tivoli Enterprise Console or OMNIbus, as appropriate.
c. Finally, restart the monitoring server to which Tivoli Enterprise Console or OMNIbus is connected.
This must be the acting monitoring server.
5. Confirm that both the acting and backup hub monitoring servers are operational, so that during this
upgrade process, when the acting hub is shut down, the backup will be able to assume the role of
acting Tivoli Enterprise Monitoring Server.
6. Upgrade the primary hub Tivoli Enterprise Monitoring Server and all other Tivoli Management
Services infrastructure components in that $ITM_HOME installation (in other words, select ALL when
asked what to upgrade).
v If working on a Windows platform, apply support to upgraded agents as part of this upgrade step.
v If working on a UNIX or Linux platform, apply support for the upgraded infrastructure agents on the
primary hub monitoring server:
./itmcmd support -t primary_TEMS_name lz nt ul um ux hd sy
Note: All Tivoli Management Services processes running within the same IBM Tivoli Monitoring
environment are temporarily shut down when upgrading a monitoring server.
7. Upgrade the secondary hub Tivoli Enterprise Monitoring Server and all other Tivoli Management
Services infrastructure components in that $ITM_HOME installation (in other words, select ALL when
asked what to upgrade).
v If working on a Windows platform, apply support to upgraded agents as part of this upgrade step.
v If working on a UNIX or Linux platform, apply support for the upgraded infrastructure agents on the
secondary hub monitoring server:
./itmcmd support -t secondary_TEMS_name lz nt ul um ux hd sy
8. Restart both the primary (backup) and secondary (acting) Tivoli Enterprise Monitoring Servers.
9. Upgrade the Tivoli Enterprise Portal Server.
10. Confirm that all remote Tivoli Enterprise Monitoring Servers are operational, so that during this
upgrade process, when the acting hub monitoring server is shut down, the backup will be able to
assume the role of acting Tivoli Enterprise Monitoring Server.
11. Upgrade each remote monitoring server, one at a time.
v If working on a Windows platform, apply support to upgraded agents when upgrading the
monitoring server.
v If working on a UNIX or Linux platform, immediately after a remote monitoring server is upgraded,
apply support for the upgraded infrastructure agents on the same node. Then restart the remote
monitoring server to make the upgraded support effective.
12. Upgrade the remaining infrastructure agents.
13. At a time when no history records will be uploaded to it, upgrade the Warehouse Proxy agent.
136
Expected results
1. When the primary hub monitoring server is down while completing step 6 on page 136:
a. Configure the portal server to point to the newly acting hub monitoring server, and verify that
expected agents and situations show up on the Tivoli Enterprise Portal client.
b. Verify that the secondary monitoring server has taken over as acting hub, in other words, that
these messages appear in its log:
v KQM0004 "FTO detected lost parent connection"
v KQM0009 "FTO promoted secondary as the acting HUB"
c. Verify that the event handler your site is using (either Tivoli Enterprise Console or
Netcool/OMNIbus) is still being updated, now by the secondary hub, by causing an event state to
change and validating the state of all events on the remote console.
d. Verify that attribute collection was uninterrupted by examining the history data, by varying attribute
values at the agent, and by observing the change in the portal client.
e. Ensure that the primary hub Tivoli Enterprise Monitoring Server is not restarted by the upgrade
process until all remote monitoring servers and directly connected agents have successfully failed
over to the secondary hub.
2. After completing step 6 on page 136, verify that the primary hub Tivoli Enterprise Monitoring Server
has taken on the role of standby monitoring server: ensure its log contains these messages:
v KQM0001 "FPO started at ..."
v KQM0003 "FTO connected to ..."
v KQM0009 "FTO promoted primary(Mirror) as the acting HUB"
The log for the secondary hub monitoring server should contain these messages:
v KQM0005 "FTO has recovered parent connection ..."
Use the sitpad and taudit tools for assistance. These tools can be downloaded from the IBM Tivoli
Open Process Automation Library (OPAL) Web site at http://www.ibm.com/software/tivoli/opal.
3. When the secondary hub Tivoli Enterprise Monitoring Server is stopped while completing step 7 on
page 136:
a. Configure the Tivoli Enterprise Portal Server to point to the acting hub, the primary.
b. Verify that the primary monitoring server has taken over as the acting hub; its log should contain
these messages:
v KQM0004 "FTO detected lost parent connection"
c. Verify that either Tivoli Enterprise Console or Netcool/OMNIbus is still being updated with event
information.
d. Verify that attribute history is still being collected as in substep 1d.
e. Ensure that the secondary hub Tivoli Enterprise Monitoring Server is not restarted by the upgrade
process until all remote monitoring servers and directly connected agents have successfully failed
over to the primary hub.
4. After completing step 7 on page 136, verify that the secondary hub Tivoli Enterprise Monitoring Server
is functional by examining the log/trace records of both hub monitoring servers for these messages.
In the primary hub's log:
v KQM0005 "FTO has recovered parent connection ..."
In
v
v
v
v
the secondary hub's log:

KQM0001 "FPO started at ..."
KQM0003 "FTO connected to ..."
KQM0009 "FTO promoted primary as the acting HUB"
KQM0009 "FTO promoted secondary(Mirror) as the acting HUB"
137
Use the sitpad and taudit tools for assistance.

5. When the Tivoli Enterprise Monitoring Server is stopped while completing step 11 on page 136 for a
given remote monitoring server, verify that either Tivoli Enterprise Console or Netcool/OMNIbus is still
being updated, now by the remote monitoring server configured for each agent, and that attribute
collection was uninterrupted, as in substep 1d on page 137. Examine the log/trace records of each
remote Tivoli Enterprise Monitoring Server to verify agent reporting; use the sitpad and taudit tools for
assistance.
6. After completing step 11 on page 136 for a given remote Tivoli Enterprise Monitoring Server, verify that
the monitoring server is operational by examining its log/trace records.
Note: Agents do not automatically switch back to their primary monitoring server unless the secondary
server fails or the agents are manually restarted.
7. Ensure the historical collection of attributes is unbroken, in both short-term and long-term history.
8. Ensure situations are reported to Tivoli Enterprise Console and to Netcool/OMNIbus without
interruption. Verify that always-true situations are still true after agent switching.
9. Verify that the Tivoli Enterprise Portal client for the acting hub Tivoli Enterprise Monitoring Server
shows attribute and situation data at all times.
Notes:
1. Pure events are lost when failover occurs from the primary hub to the secondary and back, as events
are not replicated across the two hubs.
2. All situations are restarted during failover, so a situation that was already raised at the primary hub will
be raised once again if the situation is still true when failover occurs.
3. A master reset is issued to Tivoli Enterprise Console when the failover occurs, with this event:
"Hotstandby TEMS switched. New Primary TEMS hostname_of_newly_active_TEMS." Events raised after
the failover will be resent.
4. When a failing monitoring server is restarted, Tivoli Enterprise Console receives this event: "TEMS
hostname_of_restarted_TEMS restarted."
Special instructions for reseeding a Hot Standby monitoring server

Note: This procedure assumes your site needs to keep a Hot Standby Tivoli Enterprise Monitoring Server
running at all times. If that is not necessary, it is simpler to shut down the standby monitoring server
until after seeding takes place, then start it back up.
If your site has implemented a Hot Standby monitoring server with agent switching (as explained in the
IBM Tivoli Monitoring: High-Availability Guide for Distributed Systems) and you want to ensure a
monitoring server remains active at all times, even while upgrading its application support (remember that
upgrading any IBM Tivoli Monitoring process shuts down all local Tivoli Management Services components
while the upgrade takes place), follow these steps:
1. Upgrade one of the two hubs, either the active one or the backup. During this process, the other hub
monitors your IBM Tivoli Monitoring environment.
2. Upgrade the other hub, during which time the newly upgraded hub monitors your environment.
3. With both upgraded hubs running, one in active mode and the other in backup mode, reseed the active
hub without restarting it.
4. Reseed the backup hub.
5. Restart the hub you want to be active, during which time the other hub monitors your IBM Tivoli
6. Restart the hub you want to be in backup mode, which puts the other hub in active mode and this hub
in backup mode.
138
Chapter 7. Installing IBM Tivoli Monitoring on one computer

This chapter describes how to deploy a small IBM Tivoli Monitoring environment on a single Windows
computer. Installation on one computer might be useful for a test environment, a teaching environment, or
for monitoring a small server environment.
The single-computer installation supports between 100 and 200 monitoring agents and can perform
minimal historical data collection. See Sizing your Tivoli Monitoring hardware on page 39 for further
discussion of the capabilities of a small monitoring environment.
The single-computer installation includes the following components:
The hub Tivoli Enterprise Monitoring Server (hub monitoring server)
The Tivoli Enterprise Portal Server (portal server)
The Tivoli Enterprise Portal Client (portal client)
The Tivoli Enterprise Portal Server database (portal server database)
The Tivoli Data Warehouse database (warehouse database)
The Warehouse Proxy agent
The Summarization and Pruning agent
The single-computer installation does not include event forwarding to either IBM Tivoli Enterprise Console
or IBM Tivoli Netcool/OMNIbus. There is no user authentication.
Prerequisites for the single-computer installation

The software prerequisites for the single-computer installation described in this chapter are as follows:
v A supported Windows operating system
v If your site does not plan to use or cannot use (due to capacity limitations) the embedded Derby
database, you will also need one of the following RDBMS servers for the portal server:
IBM DB2 Database for Linux, UNIX, and Windows (DB2 for the workstation)
Microsoft SQL Server 2000, 2005, or 2008
Note: If you plan to use these either of the listed RDBMSes with the portal server, it must already have
been installed and be running when you begin this installation. If you plan to use the Derby
database, it is not necessary that you preinstall it; this embedded RDBMS is installed, if
necessary, with IBM Tivoli Monitoring.
For the Tivoli Data Warehouse, you can also use Microsoft SQL Server 2005. IBM DB2 for the workstation
V9.1 is included with IBM Tivoli Monitoring. This version should be used for new installations to minimize
the need to upgrade DB2 for the workstation in the future.
While it is possible to install Tivoli Monitoring on a single Linux or UNIX computer, additional manual
configuration is required. When you install Tivoli Monitoring on a Windows computer with IBM DB2 for the
workstation or Microsoft SQL Server, much of the configuration required to set up the Tivoli Data
Warehouse is automated. (An extra configuration step is required after installation if you use Microsoft
SQL Server 2005 for the Tivoli Data Warehouse database.)
In a single-computer installation, the RDBMS server is used for both of the databases required by Tivoli
Monitoring:
v The Tivoli Enterprise Portal Server database (or portal server database) stores user data and
information required for graphical presentation on the user interface. The portal server database is
created automatically during configuration of the portal server. It is always located on the same
computer as the portal server.
v The Tivoli Data Warehouse database (also called the warehouse database or data warehouse) stores
historical data for presentation in historical data views. In a single-computer installation, the warehouse
139
database is created on the same relational database management server (RDBMS) used for the portal
server database. In larger environments, it is best to create the warehouse database on a different
computer from the portal server.
Installation procedure
Complete the following steps to install IBM Tivoli monitoring on one Windows computer:
1. Launch the installation wizard by double-clicking the setup.exe file in the WINDOWS subdirectory of
the installation media.
2. Click Next on the Welcome window.
3. Click Accept to accept the license agreement.
4. Choose the directory where you want to install the product. The default directory is C:\IBM\ITM. Click
Next.
Note: If you specify an incorrect directory name, you will receive the following error:
The IBM Tivoli Monitoring installation directory cannot exceed 80 characters
or contain non-ASCII, special or double-byte characters.
The directory name can contain only these characters:
"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ _\:0123456789()~-./".
5. Click Next to accept the default encryption key and then click OK on the popup window to confirm
the encryption key.
6. On the Select Features window, select the check boxes for the components you want to install. Select
all components for a complete installation on one computer.
For additional information about these components, press the Help button.
Note: The agent support comprises additional support files for the Tivoli Enterprise Monitoring
Server, Tivoli Enterprise Portal Server, and the Tivoli Enterprise Portal desktop client; these are
automatically installed whenever you install the agent support. Also, the Eclipse Help Server
selection is no longer provided; the Eclipse Help Server is automatically installed whenever
you install a Tivoli Enterprise Portal Server.
7. Click Next.
The Agent Deployment window is displayed. This window lists monitoring agents that you can deploy
to remote computers. For this installation, do not select any agents for remote deployment.
8. Click Next.
9. If the TEPS Desktop and Browser Signon ID and Password window is displayed, enter and confirm
the password to be used for logging on to the Tivoli Enterprise Portal. The default logon user ID,
sysadmin, cannot be changed on this window.
This password is required only when Security: Validate User has been enabled on the hub monitoring
server. This window is not displayed if the sysadmin user ID has already been defined in the
operating system.
10. Review the installation summary details. The summary identifies the components you are installing.
Click Next to begin the installation. The status bar indicates the progress of your installation.
After the components are installed, a configuration window is displayed.
11. Click Next to start configuring all selected components. (Leave all check boxes selected for this
installation.)
12. Configure communications for the Tivoli Enterprise Portal Server:
a. Click Next to confirm that you are installing the portal server on this computer. (The host name of
this computer is displayed by default.)
b. If no relational database manager can be found in this computer, the embedded Derby RDBMS is
used by default. However, if at least one RDBMS product is installed on this computer, a window
140
is displayed for you to choose the RDBMS product you want to use. Choose either Embedded
TEPS database (that is, Derby), IBM DB2 Universal Database Server, or Microsoft SQL
Server, and click Next.
c. A window is displayed for you to configure the connection between the portal server and the portal
server database (TEPS database).
The installation program uses the information on this window to automatically perform the
following tasks:
v Create the portal server database.
v Create a database user for the portal server to use to access the database.
v Configure the ODBC connection between the portal server and the database.
Figure 13. Configuration window for the portal server database using DB2 for the workstation
Figure 13 shows the configuration window for a portal server database using DB2 for the
workstation. The configuration window for a Derby or Microsoft SQL Server database is similar.
The fields on the configuration window are described in the following table:
Table 25. Configuration information for the portal server database
Field
DB2 for the

workstation
default
MS SQL
default
Description
Admin User ID
db2admin
sa
The database administrator ID.
Admin Password
(no default)
(no default)
The password for the database administrator ID.
Database User ID
TEPS
TEPS
The login name of the database user that the

portal server will use to access the database.
141
Table 25. Configuration information for the portal server database (continued)
Field
DB2 for the

workstation
default
MS SQL
default
Database Password
(no default)
(no default)
The password for the database login user. If your

environment requires complex passwords
(passwords that require both alpha and numeric
characters), specify a password that complies with
these requirements.
Reenter password
(no default)
(no default)
Confirm the password by entering it again.
Select database instance

name
(no default)
(no default)
Pull down the drop-down list, and select the

appropriate database instance.
Description
d. Optionally change the default values for the administrator ID and database user ID. Enter
passwords for the administrator and database user. Click OK.
e. Click OK on the message that tells you that the portal server configuration was successful.
f. Click Next to accept the default Tivoli Data Warehouse user ID and password. (You can change
these values in a later step.)
g. In the TEP Server Configuration window, click OK to accept the default communications protocol,
IP.PIPE. IP.PIPE is the protocol that the portal server will use to communicate with the Tivoli
Enterprise Monitoring Server.
A second TEP Server Configuration window is displayed. The IP.PIPE area of this window
displays the host name of this computer and the default port number, 1918.
h. Click OK to accept the default host name and port number.
i. Click Yes on the message asking if you want to reconfigure the warehouse connection information
for the portal server.
j. Select DB2 or SQL Server from the list of RDBMS platforms and click OK.
A window is displayed for you to configure the connection between the portal server and the Tivoli
Data Warehouse database. (The Tivoli Data Warehouse database is referred to in the title of this
window as the data source for the Warehouse Proxy. The Warehouse Proxy agent sends
information collected from monitoring agents to the Tivoli Data Warehouse.)
The installation program uses the information on this window to automatically perform the following
tasks:
v Create the Tivoli Data Warehouse database.
v Create a database user (called the warehouse user) for the portal server, Warehouse Proxy
agent, and Summarization and Pruning agent to use to access the warehouse database.
v Configure the ODBC connection between the portal server and the warehouse database.
142
Figure 15. Configuration window for the Tivoli Data

Warehouse database using Microsoft SQL Server
Figure 14. Configuration window for the Tivoli Data
Warehouse database using DB2 for the workstation
The fields on this window are described in the following table:

Table 26. Configuration information for the Tivoli Data Warehouse database
Field
DB2 for the

workstation
default
MS SQL default
Description
Data Source Name
ITM Warehouse
ITM Warehouse
The name of the data source.
Database Name
WAREHOUS
WAREHOUS
The name of the database.
Admin User ID
db2admin
sa
Admin Password
(no default)
(no default)
Database User ID
ITMUser
ITMUser

portal server, Warehouse Proxy agent, and
Summarization and Pruning agent will use to
access the Tivoli Data Warehouse database.
Database Password
itmpswd1
itmpswd1

characters), specify a password that complies
with these requirements.
Reenter password
itmpswd1
itmpswd1
k. Optionally change the default values on this window. Enter the password of the database
administrator. Click OK.
l. Click OK on the message that tells you that the portal server configuration was successful.
13. If your monitoring server is not local, you must configure communications for the hub Tivoli Enterprise
Monitoring Server:
a. Remove the check mark from Security: Validate User; then click OK to accept the other defaults
on the Tivoli Enterprise Monitoring Server Configuration window:
143
v The type of server you are configuring is Hub.

v The default name of the hub monitoring server is HUB_host_name, for example,
HUB_ITMSERV16.
v The default communications protocol is IP.PIPE. IP.PIPE is the protocol that the monitoring
server will use to communicate with the portal server.
Note: If your site uses the IP.PIPE protocol for communications, be aware of the following
limitations:
There can be at most 16 IP.PIPE processes per host.
IP.PIPE uses one, and only one, physical port per process. Port numbers are
allocated using a well-known port allocation algorithm. The first process for a host is
assigned port 1918, which is the default.
KDC_PORTS is not supported for IP.PIPE.
If you need to have more than 16 processes per host, use IP.UDP (User Datagram
Protocol) for connections.
v Do not enable user authentication until you have completed all installation and configuration
and verified that the product is working. If you want to enable user authentication, see the IBM
The Hub TEMS Configuration window is displayed. The IP.PIPE area of this window displays the
host name of this computer and the default port number, 1918.
b. Click OK to accept the default host name and port number.
14. If your monitoring server is not local, you must configure the default communication between any IBM
Tivoli Monitoring component and the hub Tivoli Enterprise Monitoring Server:
a. On the configuration window, click OK to accept the default communications protocol, IP.PIPE.
A second configuration window is displayed. The IP.PIPE area of this window displays the host
name of this computer and the default port number, 1918.
b. Click OK to accept the default host name and port number.
15. Click Finish to complete the installation.
When the installation is complete, the Manage Tivoli Enterprise Monitoring Services window is displayed.
This window is used for starting, stopping, and configuring installed components. This window can be
displayed at any time from the Windows Start menu by clicking Start Programs IBM Tivoli
Monitoring Manage Tivoli Monitoring Services.
Figure 16. Manage Tivoli Enterprise Monitoring Services window
The symbol next to a component indicates its current state:

A blue running figure indicates the component is started.
A green check mark indicates that the component is configured and can be started.
144
A red exclamation mark indicates that the component needs to be configured before it can be
started.
Post-installation procedures
Complete the following tasks after you finish the installation procedure:
v Start the Eclipse Help Server and the Tivoli Enterprise Portal Server, if not started. Right-click the
component in the Manage Tivoli Enterprise Monitoring Services window and select Start.
To log on to the Tivoli Enterprise Portal using the desktop client, double-click the Tivoli Enterprise Portal
icon on your Windows desktop. Use the sysadmin password that you specified in Step 9 on page 140.
(For more information about logging on to the Tivoli Enterprise Portal, see Starting the Tivoli Enterprise
Portal client on page 232.)
v Configure the Summarization and Pruning agent.
The installation procedure automatically starts and configures all the monitoring agents that you installed
except for the Summarization and Pruning agent. The Summarization and Pruning agent is not
configured and started during installation to give you an opportunity to configure history collection in
advance for all installed monitoring agents, a task that must be performed prior to starting the
Summarization and Pruning agent for the first time.
To configure and start the Summarization and Pruning agent, refer to the following procedures:
Configuring the Summarization and Pruning agent (JDBC connection) on page 435
Starting the Summarization and Pruning agent on page 444
v If you are using Microsoft SQL Server 2005 for the Tivoli Data Warehouse database, perform the
following additional steps:
Create a schema with the same name (and owner) as the database user ID for accessing the Tivoli
Data Warehouse. (The default user ID is ITMUser.) Change the default schema from dbo to this
database user ID.
You specified the database user ID on the Configure SQL Data Source for Warehouse Proxy window
during installation. See Step 12j of the installation procedure.
Ensure that the database is set up to support inbound network TCP/IP connections.
v Enable authentication of user credentials.
Enable user authentication through either the portal server (for LDAP authentication and single sign-on
capability) or the monitoring server (for LDAP or local registry authentication and for SOAP Server
commands). See the IBM Tivoli Monitoring: Administrator's Guide.
145
146
Chapter 8. Installing IBM Tivoli Monitoring

You install the Tivoli Monitoring distributed components and base agents using the Base DVDs or DVD
images. The installation and initial configuration of your environment consists of the steps described in
Table 27.
Before you begin, take note of the following information concerning the installation procedures in this
chapter:
v The installation procedures provide information for installing a single component (such as the monitoring
server) on one computer. If you want to install multiple components (such as the monitoring server and
the portal server) on the same computer and you want to install them simultaneously, the actual steps
might vary. Refer to the individual sections for required configuration information during your installation.
v The installer now validates configuration values for hub, remote, and standby monitoring servers. During
configuration, the installer may prompt you to verify values that it considers suspect.
v The installation procedures in this chapter contain instructions for new installations. Follow the same
procedures for upgrading or updating your installation. An upgrade is an installation that replaces a
previous release or fix pack level of the product or component with a later release or fix pack level. An
update is a modification to an existing installation at the same release or fix pack level.
For more information on fix pack installation, see Installing product maintenance on page 236.
v See Appendix A, Installation worksheets, on page 529 for a set of worksheets that you can use to
gather the information required for installation.
v The following sections contain Windows, Linux, and UNIX procedures for installing the various
components. Use the procedure that best applies to your environment layout. For example, you can
install a monitoring server on UNIX, a portal server on Linux, and a portal desktop client on Windows.
To install a monitoring server or monitoring agents on a z/OS system, refer to the appropriate z/OS
documentation as described in Table 27.
v If your site uses the IP.PIPE protocol for communications, be aware of the following limitations:
There can be at most 16 IP.PIPE processes per host.
IP.PIPE uses one, and only one, physical port per process. Port numbers are allocated using a
well-known port allocation algorithm. The first process for a host is assigned port 1918, which is the
default.
KDC_PORTS is not supported for IP.PIPE.
If you need to have more than 16 processes per host, use IP.UDP (User Datagram Protocol) for
connections between IBM Tivoli Monitoring components except the Tivoli Enterprise Portal Server. The
use of the User Datagram Protocol is not recommended for the portal server.
Table 27. IBM Tivoli Monitoring high-level installation steps
Step
Install the hub Tivoli Enterprise Monitoring

Server.
v To install a hub monitoring server on a Windows, Linux, or

UNIX system, see Installing and configuring the hub Tivoli
Enterprise Monitoring Server on page 148.
v To install a hub monitoring server on a z/OS system, refer to
the IBM Tivoli Monitoring publication entitled Configuring Tivoli
Enterprise Monitoring Server on z/OS.
Install any remote monitoring servers.
v To install a remote monitoring server on a Windows, Linux, or

UNIX system, see Installing and configuring the remote
monitoring servers on page 157.
v To install a remote monitoring server on a z/OS system, refer to
the IBM Tivoli Monitoring publication entitled Configuring Tivoli
Enterprise Monitoring Server on z/OS.
147
Table 27. IBM Tivoli Monitoring high-level installation steps (continued)

Step
Install the Tivoli Enterprise Portal Server.
Installing the Tivoli Enterprise Portal Server on page 162
Install monitoring agents.
v To install monitoring agents on Windows, Linux, or UNIX

systems, see Installing monitoring agents on page 183.
v To install monitoring agents on a z/OS system, refer to the
configuration guides for your z/OS agent product.
If you plan to use the remote deployment function in IBM Tivoli
Monitoring to install distributed monitoring agents across your
environment, see Chapter 9, Deploying monitoring agents across
your environment, on page 237 for the required steps. (You
cannot use the remote deployment function to install z/OS
monitoring agents.)
Install non-agent bundles (optional).
Working with non-agent bundles on page 257
Install the portal desktop client (optional).
Installing the Tivoli Enterprise Portal desktop client on page 193
If you want to use only the browser client, you do

not need to install the desktop client.
Install required application support on the
monitoring server, portal server, and portal
desktop client.
Installing and enabling application support on page 196
Install the language packs for all languages other Installing language packs on page 218
than English.
Configure the clients, browser and Java runtime
environment.
Configuring clients, browsers, and JREs on page 220
Specify what browser to use to display the online Specifying the browser used for online help on page 229
help.
Start the Tivoli Enterprise Portal to verify your
installation.
Use Web Start to download the run the desktop

client.
Using Web Start to download and run the desktop client on page
233
Enable user authentication.
See the IBM Tivoli Monitoring: Administrator's Guide
Installing and configuring the hub Tivoli Enterprise Monitoring Server

The following sections provide detailed information for installing and initially configuring the hub monitoring
server:
v Windows: Installing the hub monitoring server
v Linux or UNIX: Installing the hub monitoring server on page 153
Note: IBM Tivoli Monitoring does not support multiple hub monitoring servers on a single Windows, Linux,
or UNIX computer or LPAR.
Windows: Installing the hub monitoring server

Use the following steps to install the hub monitoring server on a Windows computer:
1. Launch the installation wizard by double-clicking the setup.exe file on the Base Infrastructure DVD or
DVD image.
148
Note: If you are running Windows 2003 or Windows XP and have security set to check the software
publisher of applications, you might receive an error stating that the setup.exe file is from an
unknown publisher. Click Run to disregard this error message.
Note: If you have another IBM Tivoli Monitoring component already installed on this computer, select
Modify on the Welcome window to indicate that you are updating an existing installation. Click
OK on the message telling you about preselected items. Then skip to Step 6.
Next.
5. Type a 32-character encryption key. You can use the default key.
Notes:
a. Do not
&
|
'
=
$
use any of the following characters in your key:

ampersand
pipe
single quote
equal sign
dollar sign
In addition, do not specify double-byte (DBCS) characters.

b. Ensure that you document the value you use for the key. Use this key during the installation of
any components that communicate with this monitoring server.
Click Next and then click OK to confirm the encryption key.
6. On the Select Features window, select the check box for Tivoli Enterprise Monitoring Server.
When you select the Tivoli Enterprise Monitoring Server check box, all of the check boxes in the
attached subtree are automatically selected. The support check boxes in the subtree are for installing
application support files for monitoring agents to the monitoring server. You can leave all of the
support check boxes selected so you do not need to reconfigure application support as new agent
types are added to your environment, but adding support for many agents can extend the installation
time considerably. If you do not intend to install a particular type of agent, remove the check mark
from the selection box. For detailed information about application support, see Installing and enabling
application support on page 196.
For additional information about these components, press the Help button.
Notes:
a. If you have purchased monitoring agents that run on z/OS, but have not purchased IBM Tivoli
Monitoring as a separate product, expand the Tivoli Enterprise Monitoring Server node. Clear
the check boxes in the subtree for the base agents except for the Warehouse Proxy and
Summarization and Pruning agents. (The base monitoring agents are included with the base IBM
Tivoli Monitoring installation package: see Installing monitoring agents on page 183.)
b. If you are updating an existing installation (you selected Modify on the Welcome window), all
check boxes on the Select Features window reflect your choices during the initial installation.
Clearing a check box has the effect of uninstalling the component. Clear a check box only if you
want to remove a component.
7. Click Next to display the Agent Deployment window.
The Agent Deployment window lists monitoring agents on this installation image that you can add to
the agent depot. The agent depot contains agents that you can deploy to remote computers. For
information about how to deploy agents in the agent depot to remote computers, see Chapter 9,
Deploying monitoring agents across your environment, on page 237.
For additional information about agent deployment, press the Help button.
149
Note: By default, the agent depot is located in the itm_installdir/CMS/depot directory on Windows.
If you want to use a different directory, create the directory (if it does not exist) and specify the
directory using the DEPOTHOME key in the KBBENV file.
Select the agents, if any, that you want to add to the agent depot. (You can add agents to the agent
depot at a later time by updating your installation.) Click Next.
8. If no IBM Tivoli Monitoring component has been previously installed on this computer, a window is
displayed for you to select a program folder for the Windows Start menu. Select a program folder,
and click Next. The default program folder name is IBM Tivoli Monitoring.
sysadmin, cannot be changed on this window.
This password is required only when Security: Validate Users is enabled on the hub monitoring
server. This window is not displayed if the sysadmin user ID has already been defined in the
operating system.
Click Next to begin the installation.
After the components are installed, a configuration window (called the Setup Type window) is
displayed.
11. Clear the check boxes for any components that have already been installed and configured (at the
current release level) on this computer, unless you want to modify the configuration. Click Next to
start configuring all selected components.
12. Configure the Tivoli Enterprise Monitoring Server:
a. Select the type of monitoring server you are configuring: Hub or Remote. For this procedure,
select Hub.
b. Verify that the name of this monitoring server is correct in the TEMS Name field. If it is not,
change it.
The default name is HUB_host_name, for example, HUB_itmserv16. This name must be unique in
the enterprise.
c. Identify the communications protocol for the monitoring server. You have four choices: IP.UDP,
IP.PIPE, IP.SPIPE, or SNA. You can specify up to three methods for communication. If the method
you identify as Protocol 1 fails, Protocol 2 is used as a backup. If Protocol 2 fails, Protocol 3 is
used as a backup.
Do not select any of the other options on this window (for example Address Translation, Tivoli
Event Integration Facility or the option to configure Hot Standby). You can configure these
options after installation is complete.
Important: Remove the check mark from the box for Security: Validate Users. Use the
procedures in the IBM Tivoli Monitoring: Administrator's Guide to configure security
after installation is complete. If you decide to leave security enabled, and you want to
use LDAP to authenticate users instead of the hub security system, use the
information in the IBM Tivoli Monitoring: Administrator's Guide to complete the
configuration.
d. Click OK.
e. Complete the following fields for the communications protocol for the monitoring server.
Table 28. Communications protocol settings for the hub monitoring server
Field
Description
IP.UDP Settings
Hostname or IP Address
150
The host name or IP address for the hub monitoring

server.
Table 28. Communications protocol settings for the hub monitoring server (continued)
Field
Description
Port # or Port Pools
The listening port for the hub monitoring server. The

default port is 1918.
IP.PIPE Settings

server.
Port Number
The listening port for the monitoring server. The default

number is 1918.
IP.SPIPE Settings

server.
Port number

default value is 3660.
SNA Settings
Network Name
The SNA network identifier for your location.
LU Name
The LU name for the monitoring server. This LU name

corresponds to the Local LU Alias in your SNA
communications software.
LU 6.2 LOGMODE
The name of the LU6.2 LOGMODE. The default value is

CANCTDCS.
TP Name
The transaction program name for the monitoring server.
f. If you are certain that you have typed the values for all of these fields with exactly the correct
casing (upper and lower cases), you can select Use case as typed. However, because IBM Tivoli
Monitoring is case-sensitive, consider selecting Convert to upper case to reduce the chance of
user error.
g. Click OK to continue.
For additional information about the monitoring server's configuration parameters, press the Help
button.
13. If you selected Tivoli Event Integration Facility, provide the host name and port number for the
TEC event server or Netcool/OMNIbus EIF probe to which you want to forward events and click OK.
14. Enable application support on the monitoring server.
In Step 6 on page 149, you selected the base monitoring agents for which you wanted to install
application support files on the monitoring server. In this step, you activate the application support
through a process known as seeding the monitoring server.
Note: If you are running in a Hot Standby environment, shut down your Hot Standby (that is, mirror)
monitoring server before completing this procedure. You may restart the Hot Standby
monitoring server only after you have seeded the hub server.
a. Specify the location of the monitoring server to which to add application support. You have two
choices:
v On this computer
v On a different computer
Click OK.
For additional information about these parameters, press the Help button.
b. Click OK on the Select the application support to add to the TEMS window.
This window lists the monitoring agents that you selected in Step 6 on page 149. Click OK to
begin seeding the monitoring server (using the SQL files listed on this window).
151
This process can take up to 20 minutes. As the seeding process completes, a progress bar is
displayed, showing the progress of seeding, in turn, the application support for the agents you
selected.
Figure 17. Progress bar for application seeding
Once seeding completes, if support could not be added, a window is displayed showing all
seeding results.
c. Click Next on the message that provides results for the process of adding application support
(see Figure 28 on page 204). A return code of 0 (rc: 0) indicates that the process succeeded.
Note: If the Application Support Addition Complete window is not displayed after 20 minutes, look
in the IBM\ITM\CNPS\Logs\seedkpc.log files (where pc is the two-character product code
for each monitoring agent) for diagnostic messages that help you determine the cause of
the problem. For a list of product codes, see Appendix D, IBM Tivoli product, platform, and
component codes, on page 567.
15. Configure the communication between any IBM Tivoli Monitoring component and the hub monitoring
server:
a. Specify the default values for IBM Tivoli Monitoring components to use when they communicate
with the monitoring server.
1) If agents must cross a firewall to access the monitoring server, select Connection must pass
through firewall.
2) Identify the type of protocol that the agents use to communicate with the hub monitoring
server. You have four choices: IP.UDP, IP.PIPE, IP.SPIPE, or SNA. You can specify up to three
methods for communication. If the method you identify as Protocol 1 fails, Protocol 2 is used
as a backup. If Protocol 2 fails, Protocol 3 is used as a backup.
Click OK.
b. Complete the communication protocol fields for the monitoring server. See Table 28 on page 150
for definitions of these fields. Click OK.
17. Click Finish on the Maintenance Complete window if you are updating an existing installation.
The Manage Tivoli Enterprise Monitoring Services utility is opened. (This might take a few minutes.) You
can start, stop, and configure IBM Tivoli Monitoring components with this utility.
152
Linux or UNIX: Installing the hub monitoring server

Use the following steps to install and configure the hub monitoring server on a Linux or UNIX computer.
Table 29. Steps for installing a hub monitoring server on a Linux or UNIX computer
Steps
Install the hub monitoring server.
Installing the monitoring server
Configure the hub monitoring server.
Configuring the hub monitoring server on page 154
Add application support to the hub monitoring server.
Adding application support to the hub monitoring server

on page 155
Installing the monitoring server

Use the following steps to install the monitoring server on a Linux or UNIX computer:
1. In the directory where you extracted the installation files, run the following command:
./install.sh
2. When prompted for the IBM Tivoli Monitoring home directory, press Enter to accept the default
(/opt/IBM/ITM). If you want to use a different installation directory, type the full path to that directory
and press Enter.
3. If the directory you specified does not exist, you are asked whether to create it. Type 1 to create this
directory.
4. The following prompt is displayed:
Select one of the following:
1) Install products to the local host.
2) Install products to depot for remote deployment (requires TEMS).
3) Install TEMS support for remote seeding
4) Exit install.
Please enter a valid number:
Type 1 to start the installation and press Enter.

The end user license agreement is displayed. Press Enter to read through the agreement.
5. Type 1 to accept the agreement and press Enter.
6. Type a 32-character encryption key and press Enter. If you want to use the default key, press Enter
without typing any characters.
Notes:
a. Do not
&
|
'
=
$

ampersand
pipe
single quote
equal sign
dollar sign

The product packages available for this operating system and component support categories are
listed.
7. Type the number that corresponds to your operating environment. For a new installation, type 1.
A numbered list of available operating systems is displayed.
8. Type 5 to install the monitoring server for your current operating system. Press Enter.
A list of the components to install is displayed.
9. Type 1 to confirm the installation.
153
The installation begins.

10. When prompted, type a name for your monitoring server. For example: HUB_hostname. Do not use
the fully qualified host name. Press Enter.
11. When you finish installing the monitoring server, you are asked if you want to add application support
to it.
12. After all of the components are installed, you are asked whether you want to install components for a
different operating system. Type 2 and press Enter.
Installation is complete. The next step is to configure your monitoring server.
Configuring the hub monitoring server

Use the following steps to configure the hub monitoring server:
Note: If you will be configuring user security, you should use root login ID to configure.
1. At the command line, change to the /opt/IBM/ITM/bin directory (or the directory where you installed
IBM Tivoli Monitoring).
2. Run the following command:
./itmcmd config -S -t tems_name
where tems_name is the name of your monitoring server (for example, HUB_itmdev17).
3. Press Enter to indicate that this is a hub monitoring server (indicated by the *LOCAL default).
4. Press Enter to accept the default host name for the monitoring server. This should be the host name
for your computer. If it is not, type the correct host name and then press Enter.
5. Enter the type of protocol to use for communication with the monitoring server. You have four choices:
ip.udp, ip.pipe, ip.spipe, or sna. Press Enter to use the default communications protocol (IP.PIPE).
6. If you want to set up a backup protocol, enter that protocol and press Enter. If you do not want to use
backup protocol, press Enter without specifying a protocol.
7. Depending on the type of protocol you specified, provide the following information when prompted:
Table 30. UNIX monitoring server protocols and values
Protocol
Value
Definition
IP.UDP
IP Port Number
The port number for the monitoring server. The default is 1918.
SNA
Net Name
LU Name
The LU name for the monitoring server. This LU name corresponds to

the Local LU Alias in your SNA communications software.
Log Mode
The name of the LU6.2 LOGMODE. The default value is "CANCTDCS."
IP.PIPE
IP.PIPE Port
Number
IP.SPIPE
IP.SPIPE Port
Number
8. Press Enter to not specify the name of the KDC_PARTITION. You can configure the partition file at a
later time, as described in Appendix C, Firewalls, on page 551.
9. Press Enter when prompted for the path and name of the KDC_PARTITION.
10. If you want to use Configuration Auditing, press Enter. If you do not want to use this feature, type 2
and press Enter.
11. Press Enter to accept the default setting for the Hot Standby feature (none).
For best results, wait until after you have fully deployed your environment to configure the Hot
Standby feature for your monitoring server. See the IBM Tivoli Monitoring: High-Availability Guide for
Distributed Systems for information about configuring Hot Standby.
12. Press Enter to accept the default value for the Optional Primary Network Name (none).
154
13. Press Enter for the default Security: Validate User setting (NO).
Important: Do not change this to set Security: Validate User. You can configure security after
configuring the monitoring server, as described in the IBM Tivoli Monitoring:
14. If you want to forward situation events to either IBM Tivoli Enterprise Console (TEC) or the IBM Tivoli
Netcool/OMNIbus console, type 1 and press Enter to enable the Tivoli Event Integration Facility.
Complete the following additional steps:
a. For EIF Server, type the hostname of the TEC event server or the hostname of the
Netcool/OMNIbus EIF probe and press Enter.
b. For EIF Port, type the EIF reception port number for the TEC event server or the
Netcool/OMNIbus EIF probe and press Enter.
15. To disable Workflow Policy Activity event forwarding, type 1 and press Enter. Otherwise, press Enter
to accept the default value (2=NO). See the note in Event integration with Tivoli Enterprise Console
on page 463 for more information.
16. Type 6 to accept the default SOAP configuration and exit the configuration.
Note: You can configure any SOAP information at a later time. See Chapter 13, Configuring IBM
Tivoli Monitoring Web Services (the SOAP Server), on page 293 for information.
The monitoring server is now configured.
A configuration file is generated in the install_dir/config directory with the format
host_name_ms_tems_name.config (for example, itmdev17_ms_HUBitmdev17.config).

All monitoring agents require that application support files be installed on the monitoring servers (hub and
remote), portal server, and portal desktop clients in your environment. Application support files contain the
information required for agent-specific workspaces, helps, predefined situations, and other data.
When you installed the monitoring server on Linux or UNIX, following the instructions in Installing the
monitoring server on page 153, the application support files for all base monitoring agents and other
supported agents were automatically installed on the monitoring server. (The base monitoring agents are
the monitoring agents included on the IBM Tivoli Monitoring installation media. Now you must enable the
application support for those agents. The process of enabling application support is also referred to as
activating or adding application support, and in the case of the monitoring server, as seeding the
monitoring server.
Follow the instructions in this section to add application support for agents to a monitoring server on Linux
or UNIX. For detailed information about application support, and for instructions to install and enable
application support for nonbase agents, refer to Installing and enabling application support on page 196
and Configuring application support for nonbase monitoring agents on page 199.
monitoring server before completing this procedure. You may restart the Hot Standby monitoring
server only after you have seeded the hub server.
Use one of the following procedures to add application support for Base monitoring agents to a monitoring
server:
Command-line procedure: Complete the following steps to enable application support on the monitoring
server for base monitoring agents, using the Linux or UNIX command line:
1. Start the monitoring server by running the following command:
2. Run the following command to add the application support:

155
./itmcmd support -t tems_name pc pc pc
where tems_name is the name of the monitoring server (for example, HUB_itmserv16) and pc is the
product code for each agent for which you want to enable application support.
To view the product codes for the applications installed on this computer, run the following command:
./cinfo
Type 1 when prompted to display the product codes for the components installed on this computer.
See your product documentation for the product code for other agents.
Activate support only for the monitoring agents for which you installed support. For example, if you
installed support for the DB2 agent, you would enter the following command:
./itmcmd support -t tems_name ud
3. Stop the monitoring server by running the following command:

4. Restart the monitoring server by running the following command:

GUI procedure: This section describes how to use the Manage Tivoli Enterprise Monitoring Services
window on a Linux Intel or UNIX computer to enable application support on a monitoring server that is
located on the local computer. You can use this procedure as an alternative to the itmcmd support
command. (This command applies only to monitoring servers that are installed on the local computer. To
enable application support on a monitoring server that is located on a remote computer, see Configuring
application support on a nonlocal monitoring server from a Linux or UNIX system on page 214.)
This procedure assumes that you have installed the support files on this computer, and that X Windows is
enabled on this computer.
Complete the following steps to enable application support from the Manage Tivoli Enterprise Monitoring
Services window on the local Linux or UNIX monitoring server:
1. Log on to the computer where the Tivoli Enterprise Portal Server is installed.
2. Start the Manage Tivoli Enterprise Monitoring Services utility:
a. Change to the bin directory:
cd install_dir/bin
b. Run the following command using the parameters described in Table 31:
./itmcmd manage [-h ITMinstall_dir]
where:
Table 31. Parameters for the itmcmd manage command
-h
(optional) An option used to specify the installation

directory.
ITMinstall_dir
The directory where the monitoring server is installed.

The default installation directory is /opt/IBM/ITM.
The Manage Tivoli Enterprise Monitoring Services window is displayed.

3. Start the monitoring server if it is not already started: Right-click Tivoli Enterprise Monitoring Server
and click Start.
4. Right-click Tivoli Enterprise Monitoring Server, and select one of the following options:
v To enable all application support packages installed on this computer, click Quick (all available
support).
v To select which application support packages you want to enable, click Advanced . . .
156
5. If you selected the Advanced option, the Install Product Support window is displayed. Select the
application support packages you want to install and click Install.
6. Stop and restart the monitoring server:
a. Right-click Tivoli Enterprise Monitoring Server and click Stop.
b. Right-click Tivoli Enterprise Monitoring Server and click Start.
Installing and configuring the remote monitoring servers

The following sections provide detailed information for installing and configuring a remote monitoring
server:
v Windows: Installing a remote monitoring server
v Linux or UNIX: Installing a remote monitoring server on page 160
Windows: Installing a remote monitoring server

Use the following steps to install a remote monitoring server on a Windows computer:
1. Launch the installation wizard by double-clicking the setup.exe file in the Infrastructure DVD or DVD
image.
Note: If you are running Windows 2003 or Windows XP and have security set to check the software
publisher of applications, you might receive an error stating that the setup.exe file is from an
unknown publisher. Click Run to disregard this error message.
Next.
5. Type a 32-character encryption key. You can use the default key.
Notes:
a. Do not
&
|
'
=
$

ampersand
pipe
single quote
equal sign
dollar sign

6. On the Select Features window, select the check box for Tivoli Enterprise Monitoring Server.
157
When you select the Tivoli Enterprise Monitoring Server checkbox, all of the check boxes in the
attached subtree are automatically selected. These check boxes are for installing application support
files for base monitoring agents and other to the monitoring server. (The base monitoring agents are
included with the base IBM Tivoli Monitoring installation package.) If you leave all of the application
support check boxes selected, you do not need to reconfigure application support as new agent types
are added to your environment. However, installing support for many agents at a time can increase
the installation time and you may still have to add support for an agent later if it has been updated.
For detailed information about application support, see Installing and enabling application support on
page 196.
Notes:
Monitoring as a separate product, expand the Tivoli Enterprise Monitoring Server node. Clear
all check boxes in the subtree except the check boxes labeled Tivoli Enterprise Monitoring
Server and Summarization and Pruning agent.
7. If you want to install any agents on this remote monitoring server, expand Tivoli Enterprise
Monitoring Agents and select the agents you want to install.
8. Click Next to display the Agent Deployment window.
displayed for you to select a program folder for the Windows Start menu. Select a program folder and
click Next. The default program folder name is IBM Tivoli Monitoring.
sysadmin, cannot be changed on this window. The logon password must match the password that you
specified for sysadmin when you configured the hub monitoring server.
This window is not displayed if the sysadmin user ID has already been defined in the operating
system.
Click Next to begin the installation.
After the components are installed, a configuration window (called the Setup Type window) is
displayed.
current release level) on this computer, unless you want to modify the configuration. Click Next to
start configuring all selected components.
13. Configure the Tivoli Enterprise Monitoring Server:
a. Select the type of monitoring server you are configuring: Hub or Remote. For this procedure,
select Remote.
b. Verify that the name of this monitoring server is correct in the TEMS Name field. If it is not,
change it.
158
The default name is REMOTE_host_name, for example, REMOTE_itmserv16. This name must be
unique in the enterprise.
c. Identify the communications protocol for the monitoring server. You have four choices: IP.UDP,
IP.PIPE, IP.SPIPE, or SNA. You can specify up to three methods for communication. If the method
you identify as Protocol 1 fails, Protocol 2 is used as a backup. If Protocol 2 fails, Protocol 3 is
used as a backup.
d. Click OK.
e. Complete the following fields for the communications protocol for the monitoring server.
Table 32. Remote monitoring server communications protocol settings
Field
Description
IP.UDP Settings: Primary Hub TEMS

Host name or IP Address

server.

default port is 1918.
IP.PIPE Settings: Primary Hub TEMS


server.
Port Number

value is 1918.
IP.SPIPE Settings: Primary Hub TEMS


server.
Port Number

value is 3660.
SNA Settings: Remote TEMS

Local LU Alias
The LU alias.
TP Name
The transaction program name for this monitoring server.
SNA Settings: Primary Hub TEMS

Network Name
LU Name

LU 6.2 LOGMODE

"CANCTDCS."
TP Name
f. If you are certain that you have typed the values for all of these fields with exactly the correct
casing (upper and lower cases), you can select Use case as typed. However, because IBM Tivoli
Monitoring is case-sensitive, consider selecting Convert to upper case to reduce the chance of
user error.
g. Click OK to continue.
14. Enable application support on the monitoring server.
In Step 6 on page 157, you selected the base monitoring agents for which you wanted to install
application support files on the monitoring server. In this step, you activate the application support
through a process known as seeding the monitoring server.
choices:
159
v On this computer
Click OK.
b. Click OK on the Select the application support to add to the TEMS window.
This window lists the monitoring agents that you selected in Step 6 on page 157. Click OK to
begin seeding the monitoring server (using the SQL files listed on this window).
This process can take up to 20 minutes. As the seeding process completes, a progress bar is
displayed, showing the progress of seeding, in turn, the application support for the agents you
selected. Once seeding completes, if support could not be added, a window is displayed showing
all seeding results.
c. Click Next on the message that provides results for the process of adding application support
(see Figure 28 on page 204). A return code of 0 (rc: 0) indicates that the process succeeded.
in the IBM\ITM\CNPS\Logs\seedkpc.log files (where pc is the two-character product code
for each monitoring agent) for diagnostic messages that help you determine the cause of
the problem. For a list of product codes, see Appendix D, IBM Tivoli product, platform, and
15. Configure the communication between any IBM Tivoli Monitoring component and the monitoring
server:
a. Specify the default values for IBM Tivoli Monitoring components to use when they communicate
with the monitoring server.
1) If agents must cross a firewall to access the monitoring server, select Connection must pass
through firewall.
2) Identify the type of protocol that the agents use to communicate with the hub monitoring
server. You have four choices: IP.UDP, IP.PIPE, IP.SPIPE, or SNA. You can specify up to three
methods for communication. If the method you identify as Protocol 1 fails, Protocol 2 is used
as a backup. If Protocol 2 fails, Protocol 3 is used as a backup.
Click OK.
b. Complete the communication protocol fields for the monitoring server. See Table 32 on page 159
for definitions of these fields. Click OK.
Note: IBM Tivoli Monitoring does not support multiple remote monitoring servers on the same Windows
computer.
Linux or UNIX: Installing a remote monitoring server

Use the following steps to install and configure the remote monitoring server on a Linux or UNIX computer.
Table 33. Steps for installing a remote monitoring server on a Linux or UNIX computer
Steps
Install the remote monitoring server. Use the same

instructions as for installing the hub monitoring server.
Installing the monitoring server on page 153
Configure the remote monitoring server.
Configuring the remote monitoring server on page 161
Add application support to the remote monitoring server.

Use the same instructions as for adding application
support to the hub monitoring server.

on page 155
160
Note: Under both Linux and UNIX, IBM Tivoli Monitoring (version 6.1 fix pack 6 and subsequent) supports
multiple remote monitoring servers on the same LPAR or computer (however, it does not support
multiple hub monitoring servers on the same computer). Note that each instance of a remote
monitoring server must have its own network interface card and its own unique IP address; in
addition, each monitoring server must be installed on its own disk. These limitations isolate each
remote monitoring server instance so you can service each one independently: you can upgrade a
remote Tivoli Enterprise Monitoring Server without affecting another server's code base and shared
libraries.
Configuring the remote monitoring server

Use the following steps to configure the remote monitoring server:
1. At the command line change to the /opt/IBM/ITM/bin directory (or the directory where you installed
IBM Tivoli Monitoring).
where tems_name is the name of your monitoring server (for example, remote_itmdev17).
3. Type remote to indicate that this is a remote monitoring server.
4. Press Enter to accept the default host name for the hub monitoring server. This should be the host
name for hub computer. If it is not, type the correct host name and then press Enter.
5. Enter the type of protocol to use for communication with the monitoring server. You have four choices:
ip.udp, ip.pipe, ip.spipe, or sna. Press Enter to use the default communications protocol (IP.PIPE).
Protocol
Value
Definition
IP.UDP
IP Port Number
The port number for the monitoring

server. The default is 1918.
SNA
Net Name
The SNA network identifier for your

location.
LU Name
The LU name for the monitoring

server. This LU name corresponds to
the Local LU Alias in your SNA
Log Mode
The name of the LU6.2 LOGMODE.

The default value is "CANCTDCS."
IP.PIPE
IP.PIPE Port Number

IP.SPIPE
IP.SPIPE Port Number

8. Press Enter to not specify the name of the KDC_PARTITION.

Note: You can configure the partition file at a later time, as described in Appendix C, Firewalls, on
page 551.
9. Press Enter when prompted for the path and name of the KDC_PARTITION.
10. If you want to use Configuration Auditing, press Enter. If you do not want to use this feature, type n
and press Enter.
161
11. Press Enter to accept the default setting for the Hot Standby feature (none).
For best results, wait until after you have fully deployed your environment to configure the Hot
Standby feature for your monitoring server. See the IBM Tivoli Monitoring: High-Availability Guide for
Distributed Systems for information about configuring Hot Standby.
12. Press Enter to accept the default value for the Optional Primary Network Name (none).
13. Press Enter for the default Security: Validate User setting (NO).
Note: This option is valid only for a hub monitoring server.
14. For Tivoli Event Integration, type 2 and press Enter.
15. At the prompt asking if you want to disable Workflow Policy/Tivoli Emitter Agent event forwarding,
press Enter to accept the default (2=NO).
16. At the prompt asking if you want to configure the SOAP hubs, press Enter to save the default settings
and exit the installer.
The monitoring server is now configured.
A configuration file is generated in the install_dir/config directory with the format
host_name_ms_tems_name.config (for example, itmdev17_ms_HUBitmdev17.config).
Installing the Tivoli Enterprise Portal Server

You can install the Tivoli Enterprise Portal Server on Windows, Linux or AIX. Follow the instructions for
your operating system:
v Windows: Installing the portal server
v Linux or AIX: Installing the portal server on page 169
Note: When you install or upgrade the Tivoli Enterprise Portal Server, the Tivoli Enterprise Services User
Interface Extensions software is automatically installed in the same directory. The portal server
extensions are required for some products that use the Tivoli Enterprise Portal (for example, IBM
Tivoli Composite Application Manager for Service Oriented Architecture).
The Tivoli Enterprise Services User Interface Extensions software is supported on the same
operating systems as the Tivoli Enterprise Portal Server.
Windows: Installing the portal server

The installation procedure for a portal server on Windows includes steps for configuring the connection
between the portal server and the following components:
v The hub monitoring server
v The portal server database
v The Tivoli Data Warehouse database
Notes:
1. If you have not set up the Tivoli Data Warehouse, complete this procedure but click No when asked if
you want to configure the connection to the data warehouse. You can reconfigure the connection after
you set up the warehouse. See Step 15 on page 167 for more information.
2. The Windows userid you use when creating the portal server database must be a local ID with
Administrator privileges. In other words, it cannot be a domain ID.
162
Complete the following steps to install the Tivoli Enterprise Portal Server and portal client on a Windows
computer:
1. Launch the installation wizard by double-clicking the setup.exe file in the Infrastructure DVD or DVD
image.
OK on the message telling you about preselected items. Then skip to Step 7 on page 164.
3. Read and accept the software license agreement by clicking Accept.
4. You are asked to choose the database management system you want to use for your portal server
database, Derby, DB2 Database for Linux, UNIX, and Windows, or Microsoft SQL Server, as shown in
Figure 18. Note that if a particular RDBMS is uninstalled on this computer or if it installed but not at
the necessary release level, the radio button is grayed out.
Figure 18. The Select Database for Tivoli Enterprise Portal window
5. Specify the directory where you want to install the portal server software and accompanying files. The
default location is C:\IBM\ITM. Click Next.
163
6. Type an encryption key to use. This key should be the same as what was used during the installation
of the hub monitoring server to which this portal server will connect. Click Next and then OK to
confirm the encryption key.
7. On the Select Features window, select Tivoli Enterprise Portal Server from the list of components
to install.
When you select the Tivoli Enterprise Portal Server check box, all of the check boxes in the
attached subtree are automatically selected. The support check boxes in the subtree are for installing
application support files for base monitoring agents to the monitoring server. (The base monitoring
agents are included with the base IBM Tivoli Monitoring installation package.) It is best to leave all of
the support check boxes selected so you do not need to reconfigure application support as new agent
types are added to your environment. For detailed information about application support, see
Installing and enabling application support on page 196.
Notes:
Monitoring as a separate product, expand the Tivoli Enterprise Portal Server node. Clear all
check boxes in the subtree except the check boxes labeled Tivoli Enterprise Portal Server and,
optionally, TEC GUI Integration. (See Step 8a.)
c. The Eclipse Help Server is automatically selected when you select the Tivoli Enterprise Portal
Server.
8. Optionally select the following additional components to install:
a. If you want to view events on the IBM Tivoli Enterprise Console event server through the Tivoli
Enterprise Portal, expand Tivoli Enterprise Portal Server and ensure that TEC GUI Integration
is selected.
b. If you want to install a portal desktop client on this computer, select Tivoli Enterprise Portal
Desktop Client.
When you select the Tivoli Enterprise Portal Desktop Client check box, all of the check boxes
in the attached subtree are automatically selected. These check boxes are for installing
application support files for base monitoring agents to the portal desktop client. Leave these
check boxes selected as you did for the portal server in Step 7.
Note: If you have purchased monitoring agents that run on z/OS, but have not purchased IBM
Tivoli Monitoring as a separate product, expand the Tivoli Enterprise Portal Desktop
Client node. Clear all check boxes in the subtree except the check boxes labeled Tivoli
Enterprise Portal Desktop Client and, optionally, TEC GUI Integration.
9. Click Next.
10. If a monitoring server is not installed on this computer, go to Step 11 on page 165.
If you are installing the portal server on a computer that already has a monitoring server installed, the
Agent Deployment window is displayed.
164
12. Review the installation summary details. The summary identifies what you are installing and where
you chose to install it. Click Next to start the installation.
After installation is complete, a configuration window (called the Setup Type window) is displayed.
current release level) on this computer, unless you want to modify the configuration. (For example,
clear the check box for the Tivoli Enterprise Monitoring Server if it has already been installed and
configured on this computer.) Click Next to start configuring all selected components.
14. Configure communications for the Tivoli Enterprise Portal Server:
a. Type the host name of the computer where you are installing the portal server. (The host name of
this computer is displayed by default.) Click Next.
b. If more than one RDBMS product is installed on this computer, a window is displayed for you to
choose the RDBMS product you want to use. Choose IBM DB2 or SQL Server and click Next.
c. A window is displayed for you to configure the connection between the portal server and the portal
server database (TEPS database).
The installation program uses the information on this window to automatically perform the
following tasks:
v Create the portal server database.
v Create a database user for the portal server to use to access the database.
v Configure the ODBC connection between the portal server and the database.
165
Figure 19. Configuration window for the portal server database using DB2 for the workstation
Figure 19 shows the configuration window for a portal server database using DB2 for the
workstation. The configuration window for a Microsoft SQL Server database is similar. The fields
on the configuration window are described in the following table:
Table 35. Configuration information for the portal server database
Field
DB2 for the

workstation
default
MS SQL
default
Description
Admin User ID
db2admin
sa
Admin Password
(no default)
(no default)
Database User ID
TEPS
TEPS

portal server will use to access the database.
Database Password
(no default)
(no default)

characters), specify a password that complies with
these requirements.
Reenter password
(no default)
(no default)
Select database instance

name
(no default)
(no default)
Pull down the drop-down list, and select the

appropriate database instance.
d. Optionally change the default values for the administrator ID and database user ID. Enter
passwords for the administrator and database user. Click OK.
166
e. Click OK on the message that tells you that the portal server configuration was successful.
f. Click Next to accept the default Tivoli Data Warehouse user ID and password. (You can change
these values in a later step.)
This is the warehouse user ID. The same ID and password must be used by all components
connecting to the Tivoli Data Warehouse, including the Tivoli Enterprise Portal Server, Warehouse
Proxy Agents and the Summarization and Pruning agent.
g. Configure the connection between the portal server and the hub Tivoli Enterprise Monitoring
Server:
1) Select the communications protocol that the monitoring server uses from the Protocol
drop-down list. You can also specify whether the connection between the portal server and the
hub monitoring server passes through a firewall. Click OK.
2) Enter the host name or IP address and the port number for the hub monitoring server. Click
OK.
15. A message is displayed asking if you want to reconfigure the warehouse connection for the portal
server. Do one of the following:
v Click No if you have not set up a Tivoli Data Warehouse.
Follow the instructions later in this book for implementing a Tivoli Data Warehouse solution,
beginning with Chapter 15, Tivoli Data Warehouse solutions, on page 331. These instructions will
direct you to reconfigure the connection between the portal server and the warehouse database
after you have completed all preliminary setup tasks.
If you select No, go to Step 20 on page 169.
v Click Yes if you have completed the tasks for setting up a Tivoli Data Warehouse and want to
configure the connection between the portal server and the Tivoli Data Warehouse database at this
time. (You can choose to configure the connection later.) The prerequisite tasks and the information
you need to configure the connection for each database type are described in the following steps.
For additional information about warehouse configuration, press the Help button.
16. To configure a connection between the portal server and a DB2 for the workstation data warehouse,
complete the following steps:
a. Verify that you have completed the following tasks:
v Created a warehouse database using DB2 for the workstation
v Created a warehouse user on the computer where you created the warehouse database.
The warehouse user is the user account (user ID and password) used by the portal server and
other warehousing components to access the warehouse database.
v Activated the UNIX listeners on the computer where the warehouse database is located if the
warehouse database is installed on UNIX systems.
v Installed a DB2 for the workstation client on the portal server if the data warehouse is remote
and the portal server database does not use DB2 for the workstation.
v Cataloged the warehouse database on the computer where you are installing the portal server
if the warehouse database is remote from the portal server.
These tasks are described in Chapter 16, Tivoli Data Warehouse solution using DB2 for the
workstation, on page 349.
b. Gather the following information: data source name, database name, database administrator ID
and password, warehouse user ID and password. The warehouse user ID is the one declared in
the configuration panel of the Warehouse Proxy Agent. This user ID serves as the first part of the
name of all the tables created in the Warehouse database. If you do not declare the same user ID
when configuring the Tivoli Enterprise Portal server you will not be able to see the Warehouse
tables with the portal client even if they exist in the database.
c. Complete the Configuring a Windows portal server (ODBC connection) procedure, starting from
Step 4 on page 368.
167
17. To configure a connection between the portal server and a Microsoft SQL Server data warehouse,
v Created a warehouse database using Microsoft SQL Server.
v Installed a Microsoft SQL Server client on the portal server if the data warehouse is remote and
the portal server database does not use Microsoft SQL Server.
v Configured a remote client connection on the computer where you are installing the portal
server if the warehouse database is remote from the portal server.
These tasks are described in Chapter 18, Tivoli Data Warehouse solution using Microsoft SQL
Server, on page 397.
b. Gather the following information: data source name, database name, database administrator ID
and password, warehouse user ID and password. The warehouse user ID is the one declared in
the configuration panel of the Warehouse Proxy Agent. This user ID serves as the first part of the
name of all the tables created in the Warehouse database. If you do not declare the same user ID
when configuring the Tivoli Enterprise Portal server you will not be able to see the Warehouse
c. Complete the procedure Configuring the portal server (ODBC connection), starting from Step 4 on
page 410.
18. To configure a connection between the portal server and an Oracle data warehouse, complete the
following steps:
v Created a warehouse database using Oracle
v Activated the Oracle listener on the computer where the warehouse database is located
v Installed an Oracle client on the portal server
v Created a TNS Service Name on the computer where you are installing the portal server if the
warehouse database is remote from the portal server.
These tasks are described in Chapter 19, Tivoli Data Warehouse solution using Oracle, on page
415.
b. Gather the following information: the data source name, database name, database administrator
ID and password, and the warehouse user ID and password. The warehouse user ID is the one
declared in the configuration panel of the Warehouse Proxy Agent. This user ID serves as the first
part of the name of all the tables created in the Warehouse database. If you do not declare the
same user ID when configuring the Tivoli Enterprise Portal server you will not be able to see the
Warehouse tables with the portal client even if they exist in the database.
c. Complete the procedure Configuring a Windows portal server (ODBC connection), starting from
Step 4 on page 430.
19. Configure the default connector for the Common Event Console.
168
The default connector retrieves situation events reported to Tivoli Enterprise Monitoring Servers for
display in the Common Event Console. You can configure connectors for other event management
systems after you have completed the product installation. For configuration instructions, see the IBM
Click OK to accept the default values or specify values for the following fields, then click OK:
Enable this connector
Select Yes to enable the connector to collect and display situation events in the Common Event
Console, or No to configure the connector without enabling it. The connector is enabled by
default.
Connector name
The name that is to be displayed in the Common Event Console for this connector. The default
name is ITM1.
Maximum number of events for this connector
The maximum number of events that are to be available in the Common Event Console for this
connector. The default value is 100 events.
View closed events
Select No to display only active events in the Common Event Console for this connector. Select
Yes to view both active and closed events. By default, only active events are displayed.
20. Configure the default communication between any monitoring agents installed on this computer and
the hub Tivoli Enterprise Monitoring Server:
a. Click OK to accept the default communications protocol.
b. Ensure that the host name and port number of the Tivoli Enterprise Monitoring Server are correct.
Click OK.
Linux or AIX: Installing the portal server

Complete the procedures in this section to install and configure the Tivoli Enterprise Portal Server and
portal client on a Linux or AIX computer.
Important: Run these installation and configuration procedures as either the root user or as the DB2 for
the workstation administrator. If you are configuring the Tivoli Enterprise Portal Server using the DB2 for
the workstation administrator ID, then:
v The configuration ID must be the same as the ID used to install the Tivoli Enterprise Portal Server.
v The configuration ID must be the same as the ID specified during the configuration dialog for the DB2
Admin ID.
v The configuration ID must have the proper DB2 for the workstation authority/rights to attach to the DB2
Instance Name specified during the configuration dialog.
v The ID specified during the configuration dialog for the DB2 User ID must be an already existing ID. You
may not allow the configuration dialog to attempt to create the user. For the GUI dialog, ensure that the
check box for Create the user is cleared. For the CLI dialog, ensure that the response for Create New
User is NO. After you have installed and configured the portal server, you can use a different user to
run the portal server, as long as that user has access to the binaries used by the portal server.
Note: Security policies for newly created users usually auto-expire the password after the first use and
require the user to set a new password as part of the initial logon process. Until this is done, the
installer always fails because the user password is expired and must be reset. Before running
the installer, the user must invoke a process like ssh or telnet to log onto the target user ID and
set the password appropriately.
169
Table 36. Steps for installing a portal server on a Linux or AIX computer
Steps
Install the portal server.
Installing the portal server on Linux or AIX
Configure the portal server.
Configuring the portal server on Linux or AIX:

command-line procedure on page 171
OR
Configuring the portal server on Linux or AIX: GUI
procedure on page 175
Start the portal server.
Starting the portal server on page 182
Prerequisites for users installing on Linux on zSeries

If you plan to install the Tivoli Enterprise Portal Server on Linux for zSeries, make sure you complete these
steps before beginning your installation:
v Ensure your Linux environment provides at least 10 gigabytes of free disk space.
v Turn off the Just-In-Time Java compiler.
v Users of RHEL version 5: set security-enhanced Linux (SELinux) to permissive.
Installing the portal server on Linux or AIX

Complete the following steps to install the portal server:
./install.sh
directory (/opt/IBM/ITM) or type the full path to a different directory.
3. If the installation directory does not already exist, you are asked if you want to create it. Type y to
create this directory and press Enter.
4) Exit install.
Type 1 to start the installation and display the software license agreement.
5. Press Enter to read through the agreement.
7. Enter a 32-character encryption key or press Enter to accept the default key. This key should be the
one used during the installation of the monitoring server to which this portal server will connect.
8. Type 4 to install the portal server for your current operating system. Press Enter.
A message is displayed indicating that the Tivoli Enterprise Portal Server is about to be installed.
170
Note: The Eclipse Help Server is automatically installed when you install the Tivoli Enterprise Portal
Server.
10. After the Tivoli Enterprise Portal Server is installed, you are asked whether you want to install
additional products or product support packages. Type 1 and press Enter.
The installer presents a numbered list of products and application support packages.
11. Install the required application support packages.
All monitoring agents require that application support files be installed on the monitoring servers (hub
and remote), portal server, and portal desktop clients in your environment. Application support files
contain the information required for agent-specific workspaces, helps, predefined situations, and other
data.
This step installs the application support files for base monitoring agents. The base monitoring agents
are included with the base IBM Tivoli Monitoring installation package. For detailed information about
application support, see Installing and enabling application support on page 196.
When you entered 1 in the preceding step, the installer presents a numbered list of items, including
the following application support packages:
Tivoli Enterprise Portal Browser Client support
Tivoli Enterprise Portal Server support
Note: The Tivoli Enterprise Portal Browser Client support package is portal server code that supports
the browser clients. You must install the browser client support package on the computer
where you install the portal server if you want to connect to it using a browser client.
Complete the following steps to install the portal server and browser client support packages for the
base monitoring agents:
a. Type the number that corresponds to Tivoli Enterprise Portal Browser Client support and
press Enter.
A numbered list of base monitoring agents is displayed.
b. Type the numbers that correspond to the base monitoring agents for which you want to install the
application support package, or type the number that corresponds to All of the above. Type the
numbers on the same line separated by spaces or commas (,). Press Enter.
It is best to select all of the base monitoring agents (All of the above) so you do not need to
reconfigure application support as new agent types are added to your environment.
c. Type 1 to confirm the installation and press Enter.
d. After the support package is installed, you are asked whether you want to install additional
products or product support packages. Enter 1 and repeat the preceding steps for the Tivoli
Enterprise Portal Server support package.
Note: This step installs the application support files. However, you must enable the application
support by configuring the portal server. The next two sections show you how to configure the
portal server.
12. After you are finished installing the portal server and browser client packages, you are asked whether
you want to install additional products or product support packages. Type 2 and press Enter.
Configuring the portal server on Linux or AIX: command-line procedure

Configure the portal server using either the command line procedure in this section or the GUI procedure
in Configuring the portal server on Linux or AIX: GUI procedure on page 175.
Either of these configuration procedures accomplishes the following tasks:
v Automatically enables application support on the portal server for the base monitoring agents. (See Step
11 of the installation procedure.)
171
v Includes steps for configuring the connection between the portal server and the following components:
The hub monitoring server
The portal server database
The Tivoli Data Warehouse database
Note: If you have not set up the Tivoli Data Warehouse, complete this procedure but accept the default
values at the prompts for configuring the connection to the data warehouse. You can reconfigure
the connection after you set up the warehouse. See Step 9 on page 173 for more information.
Complete the following steps to configure the Tivoli Enterprise Portal Server from the command line on
Linux or AIX:
2. At the command line change to the ITMinstall_dir/bin directory, where ITMinstall_dir is the directory
where you installed the product.
3. Run the following command to start configuring the Tivoli Enterprise Portal Server:
./itmcmd config -A cq
where cq is the product code for the portal server.

4. Edit the ITM Connector settings.
The ITM Connector retrieves situation events reported to Tivoli Enterprise Monitoring Servers for
display in the Common Event Console. If you do not enable the connector, you will not see any
events in the Common Event Console. You can configure connectors for other event management
To enable the connector:
a. Press Enter to accept the default value for the following prompt:
Edit 'ITM Connector' settings? [ 1=Yes, 2=No ] (default is: 1):
b. Press Enter to enable the connector.

c. Press Enter to accept the default name of ITM1 or type your preferred name and press Enter.
This is the name that is to be displayed in the Common Event Console for this connector.
d. Press Enter to accept the default number of events (100) that are to be available in the Common
Event Console for this connector, or type the number of events you would like to see displayed
and press Enter.
e. Type 2 and press Enter to display only active events in the Common Event Console for this
connector. Type 1 and press Enter to view both active and closed events. By default, only active
events are displayed.
f. Type 2 and press Enter to skip defining data for extra columns in the Common Event Console.
When you define a Tivoli Enterprise Console or Tivoli Netcool/OMNIbus connector, you can define
the information that is to be mapped to each of these customizable columns. See the IBM Tivoli
Monitoring: Administrator's Guide for information on configuring these connectors.
5. Press Enter when you are asked if the agent connects to a monitoring server. (Although the prompt
refers to an agent, this command is used to configure the portal server.)
6. Configure the connection between the portal server and the hub monitoring server:
a. Type the host name for the hub monitoring server and press Enter.
b. Type the protocol that the hub monitoring server uses to communicate with the portal server. You
have these choices: SNA, IP.PIPE, or IP.SPIPE.
c. If you want to set up a backup protocol, enter that protocol and press Enter. If you do not want to
use a backup protocol, press Enter without specifying a protocol.
d. Depending on the type of protocol you specified, provide the following information as described in
Table 37 on page 173 when prompted:
172
Table 37. Hub monitoring server protocols and values

Protocol
Value
Definition
SNA
Net Name

location.
LU Name

Log Mode

The default value is CANCTDCS.
IP.PIPE
IP.PIPE Port Number

IP.SPIPE

e. Press Enter when you are asked if you want to configure the connection to a secondary
monitoring server. The default value is none.
f. Press Enter to accept the default value for the Optional Primary Network Name (none).
g. Press Enter to accept the default setting for SSL between the portal server and clients (N). By
default, SSL is disabled. To enable SSL, type 1 and press Enter.
7. Configure the connection between the portal server and the portal server database:
a. Type 1 if your site is using the embedded Derby database, 2 if you're using DB2 for the
workstation.
b. Type the DB2 for the workstation instance name. The default value is db2inst1. Press Enter.
c. Type the DB2 for the workstation administrator ID. The default value is db2inst1. Press Enter.
Note: The DB2 for the workstation administrator account was created during DB2 for the
workstation installation.
d. Type the password for the DB2 for the workstation administrator ID, and press Enter.
e. Confirm the password for the DB2 for the workstation administrator ID by typing it again. Press
Enter.
8. If you are configuring DB2 for the workstation for the portal server (instead of the embedded Derby
database), complete the following parameters as well:
a. Type the name of the portal server database. The default value is TEPS. Press Enter.
b. Type the login name of the database user that the portal server will use to access the database.
The default value is itmuser. Press Enter.
c. Type the password for the database user and press Enter.
d. Confirm the password for the database user by typing it again. Press Enter.
e. You are asked if you want to create the DB2 for the workstation login user if it does not exist.
Type 1 and press Enter.
9. You are asked for the database parameters for either DB2 for the workstation or Oracle for the Tivoli
Data Warehouse. Enter D for DB2 for the workstation, J for Oracle (JDBC). DB2 for the workstation is
the default.
Note: This prompt and all remaining prompts ask for information to configure the connection between
the portal server and the Tivoli Data Warehouse database. If you have not set up a Tivoli Data
Warehouse, accept the default values at these prompts. Follow the instructions later in this
book for implementing a Tivoli Data Warehouse solution, beginning with Chapter 15, Tivoli
Data Warehouse solutions, on page 331. These instructions will direct you to reconfigure the
connection between the portal server and the warehouse database after you have completed
all preliminary setup tasks.
173
10. Do one of the following:

v If you have not set up a Tivoli Data Warehouse:
a. Press Enter to accept the DB2 for the workstation default (even if you are going to create the
Tivoli Data Warehouse using Oracle).
b. Press Enter at all remaining prompts to accept the default values.
or
v Configure a connection between the portal server and a DB2 for the workstation warehouse
database.
Before you configure the connection, verify that you have already completed the following tasks:
Created a warehouse database using DB2 for the workstation
Created a warehouse user on the computer where you created the warehouse database.
Cataloged the warehouse database on the computer where you are installing the portal server if
the warehouse database is remote from the portal server
Activated the UNIX listeners on the computer where the warehouse database is located if the
warehouse database is installed on UNIX.
workstation.
To perform the steps for configuring the connection between the portal server and the DB2 for the
workstation data warehouse, you will need the name of the warehouse database and the user ID
and password of the warehouse user. Press Enter after answering each prompt:
a. Press Enter to accept the DB2 for the workstation default.
b. Enter the name of the Tivoli Data Warehouse database. The default value is WAREHOUS.
c. Enter the user ID of the warehouse user. The default value is itmuser.
Note: The warehouse user ID must be the one declared in the configuration panel of the
Warehouse Proxy Agent. This user ID serves as the first part of the name of all the
tables created in the Warehouse database. If you do not declare the same user ID when
configuring the Tivoli Enterprise Portal server you will not be able to see the Warehouse
d. Enter the password of the warehouse user.
e. Confirm the password by entering it again.
OR
v Configure a connection between the portal server and an Oracle warehouse database.
Created a warehouse database using Oracle
Activated the Oracle listener on the computer where the warehouse database is located
Installed an Oracle JDBC Type 4 driver on the portal server.
These tasks are described in Chapter 19, Tivoli Data Warehouse solution using Oracle.
To perform the steps for configuring the connection between the portal server and the Oracle data
warehouse, you will need:
The name of the warehouse database and the user ID and password of the warehouse user
The location, name, and URL of the JDBC driver
174
Press Enter after answering each prompt:

a. Enter oracle at the prompt asking if you are using DB2 for the workstation or Oracle for the
Warehouse.
b. Enter the name of the Tivoli Data Warehouse database. The default value is WAREHOUS.
c. Enter the user ID of the warehouse user. The default value is itmuser.
Note: The warehouse user ID must be the one declared in the configuration panel of the
Warehouse Proxy Agent. This user ID serves as the first part of the name of all the
tables created in the Warehouse database. If you do not declare the same user ID when
configuring the Tivoli Enterprise Portal server you will not be able to see the Warehouse
d. Enter the password of the warehouse user.
e. Confirm the password by entering it again.
f. Enter the full path name of the Oracle Type 4 JDBC driver JAR file as follows:
oracleinstalldir/jdbc/lib/ojdbc14.jar
where oracleinstalldir is the directory location of the JDBC driver JAR file on this computer.
g. Enter the following JDBC driver name:
oracle.jdbc.driver.OracleDriver
h. Enter the JDBC driver URL. This is the Oracle-defined URL that identifies the locally or
remotely installed Oracle instance used for the Tivoli Data Warehouse. The following entry is an
example:
jdbc:oracle:thin:@localhost:1521:WAREHOUS
If the warehouse database is located on a remote computer, replace localhost with the host
name of the remote computer.
Change the default port number (1521) and Tivoli Data Warehouse name (WAREHOUS) if they
are different.
i. Enter any user-defined attributes that are used to customize the behavior of the driver
connection. Use semi-colons (;) to delimit the attributes. Press Enter to finish the configuration.
A message is displayed telling you that InstallPresentation is running, and then a message telling you
that the installation has completed.
Configuring the portal server on Linux or AIX: GUI procedure

Configure the portal server using either the GUI procedure in this section or the command line procedure
in Configuring the portal server on Linux or AIX: command-line procedure on page 171.
Either of these configuration procedures accomplishes the following tasks:
v Automatically enables application support on the portal server for the base monitoring agents.
v Includes steps for configuring the connection between the portal server and the following components:
The portal server database
The Tivoli Data Warehouse database
Note: If you have not set up the Tivoli Data Warehouse, complete this procedure but accept the default
values at the prompts for configuring the connection to the data warehouse. You can reconfigure
the connection after you set up the warehouse. See Step 9 on page 173 for more information.
Complete the following steps to configure the Tivoli Enterprise Portal Server from the Tivoli Enterprise
Monitoring Services window on Linux or AIX:
2. Start the Manage Tivoli Enterprise Monitoring Services utility:
175
a. Change to the bin directory:

cd install_dir/bin
b. Run the following command using the parameters described in Table 38:
./itmcmd manage [-h ITMinstall_dir]
where:
-h

directory.
ITMinstall_dir
The directory where the portal server is installed. The

default installation directory is /opt/IBM/ITM.

3. Right-click Tivoli Enterprise Portal Server and click Configure.
The Common Event Console Configuration window is displayed.
Figure 20. Common Event Console Configuration window
4. Click OK to accept the default values for the ITM Connector, or specify your preferred values and then
click OK.
176
The ITM Connector retrieves situation events reported to Tivoli Enterprise Monitoring Servers for
display in the Common Event Console. You can configure connectors for other event management
The Configure Tivoli Enterprise Portal Server window is displayed.
Figure 21. Registering the portal server with the Tivoli Enterprise Monitoring Server
177
5. On the TEMS Connection page, enter information about the Tivoli Enterprise Monitoring Server to
which the Tivoli Enterprise Portal Server connects:
v Enter the host name of the monitoring server in the TEMS Hostname field. (If the field is not active,
clear the No TEMS check box.)
v Select the communications protocol that the monitoring server uses from the Protocol drop-down
list.
If you select SNA, enter information in the Net Name, LU Name, and LOG Mode fields.
If you select IP.PIPE or IP.SPIPE, enter the port number of the monitoring server in the Port
Number field.
For information about these fields, refer to Table 37 on page 173.
6. Click the Agent Parameters tab.
178
Figure 22. Configuring database connections for the portal server
7. Configure the connection between the portal server and the portal server database by entering
information in the fields described in the following table:
179
Table 39. Configuration information for the Tivoli Enterprise Portal Server database
Field
Default value
Description
DB2 instance name
db2inst1
The DB2 for the workstation instance name.

Not required if the embedded Derby database is used for
the portal server and Oracle is selected for the warehouse
database.
DB2 admin ID
db2inst1
The DB2 for the workstation administrator ID. The DB2 for
the workstation administrator account was created during
DB2 for the workstation installation.
database.
DB2 admin password
(no default)
The password for the DB2 for the workstation administrator

ID.
database.
Re-type DB2 admin password
(no default)
The password for the DB2 for the workstation administrator

ID.
database.
TEPS DB2 database name
TEPS
The Tivoli Enterprise Portal Server database name.

Disabled if the embedded Derby database is chosen for
the portal server database.
TEPS DB user ID
itmuser
The login name of the warehouse user that the portal

server will use to access the database.
TEPS DB user password
(no default)
The password for the warehouse user ID.

Re-type TEPS DB user password
(no default)
The password for the warehouse user ID.

Create TEPS DB user ID if not

found?
yes
This check box is selected by default. If the database login

account (user ID and password) that you specified in the
preceding fields does not exist, it is created.
8. Optionally configure the connection between the portal server and the Tivoli Data Warehouse
database.
Note: If you have not set up a Tivoli Data Warehouse, accept the default values for these fields.
Follow the instructions later in this book for implementing a Tivoli Data Warehouse solution,
beginning with Chapter 15, Tivoli Data Warehouse solutions, on page 331. These instructions
180
will direct you to reconfigure the connection between the portal server and the warehouse
database after you have completed all preliminary setup tasks.
The bottom section of the Agent Parameters tab contains fields for configuring the connection
between the portal server and a Tivoli Data Warehouse database using DB2 for the workstation
or Oracle. (See Figure 23.)
Figure 23. Configuration information for the Tivoli Data Warehouse using an Oracle database
181
Do one of the following:

v If you have not set up the Tivoli Data Warehouse, click Save to save your settings and close the
window.
OR
v Configure a connection between the portal server and a DB2 for the workstation warehouse
database.
Created a warehouse database using DB2 for the workstation
Cataloged the warehouse database on the computer where you are installing the portal server if
the warehouse database is remote from the portal server
Activated the UNIX listeners on the computer where the warehouse database is located if the
warehouse database is installed on UNIX.
workstation.
To configure the connection between the portal server and the DB2 for the workstation data
warehouse, you will need the name of the warehouse database and the user ID and password of
the warehouse user.
To perform the configuration, complete the procedure Configuring a Linux or AIX portal server (DB2
for the workstation CLI connection), starting from Step 4 on page 369.
OR
v Configure a connection between the portal server and an Oracle warehouse database.
Created a warehouse database using Oracle
Activated the Oracle listener on the computer where the warehouse database is located
Installed an Oracle JDBC Type 4 driver on the portal server.
These tasks are described in Chapter 19, Tivoli Data Warehouse solution using Oracle.
To configure the connection between the portal server and the Oracle data warehouse, you will
need:
The name of the warehouse database and the user ID and password of the warehouse user
The location, name, and URL of the JDBC driver
To perform the configuration, complete the procedure Configuring a Linux or AIX portal server
(JDBC connection), starting from Step 4 on page 431.
Starting the portal server

From the bin directory of /opt/IBM/ITM (or where you installed IBM Tivoli Monitoring), run the following
command to start the portal server:
./itmcmd agent start cq
Upgrading a 32-bit portal server to 64 bit

The installation process does not convert an existing 32-bit Tivoli Enterprise Portal Server running on Linux
or UNIX to 64 bit (although it does convert an existing 32-bit portal server from a prior release to a 32-bit
portal server for the current release). The following procedure allows you to manually perform this
conversion from 32 bit to 64 bit.
182
1. Using the product media for the current release, install and configure the 32-bit Tivoli Enterprise Portal
Server for IBM Tivoli Monitoring V6.2.x.
Before proceeding to step 2, ensure that the portal server is either completely initialized or completely
stopped.
2. Invoke tepsBackup from the /ITM_installdir/bin directory:
cd /ITM_installdir/bin
./tepsBackup
where:
ITM_installdir
is the root location of your IBM Tivoli Monitoring V6.2.x environment.
This process creates a compressed tar file with default and customized application data in the
/ITM_installdir/tmp directory.
3. Uninstall the 32-bit portal server. If asked to completely remove the Tivoli Monitoring installation
directories, answer no; otherwise the backup tar file will be lost.
4. Again using the product media for the current release, install and configure the 64-bit Tivoli Enterprise
Portal Server.
Before proceeding to step 5, ensure that the portal server is either completely initialized or completely
stopped.
5. Invoke tepsRestore from the /ITM_installdir/bin directory:
cd /ITM_installdir/bin
./tepsRestore
Installing monitoring agents

This section describes how to install distributed monitoring agents. A distributed monitoring agent is one
that is installed on a distributed (not z/OS) operating system. These instructions also apply to the
Warehouse Proxy and Summarization and Pruning agents. For instructions on how to install a z/OS
monitoring agent, refer to the agent documentation for your z/OS agent product.
To install a distributed monitoring agent, use the appropriate installation media:
v Use the IBM Tivoli Monitoring Base Agent DVD or DVD image to install the agents in the following list
Linux OS
UNIX Logs
UNIX OS
Windows OS
v You can also use the IBM Tivoli Monitoring Base Agent DVD to install application support for any IBM
Tivoli Monitoring V6.x-based distributed monitoring agent you intend to install. Installing and configuring
application support on base components (monitoring servers, portal server, desktop clients) when you
install them means that you do not have to stop and restart those components later when you install the
agent. However, if the monitoring agents you install have been updated since the DVD was issued, you
must install the application support files from the monitoring agent product CD.
v Use the agent product CDs to install distributed monitoring agents that are delivered separately from the
IBM Tivoli Monitoring base installation package. For example, use the IBM Tivoli Monitoring for
Databases product CDs to install a monitoring agent for DB2 Database for Linux, UNIX, and Windows
or for Oracle. Depending on the agent that you are installing, there might be additional configuration
steps required. See the agent documentation for more information.
183
All monitoring agents require that agent-specific application support be installed on the monitoring servers,
portal server, and portal desktop clients. See Installing and enabling application support on page 196 for
information.
The following sections provide instructions for installing a monitoring agent:
v Windows: Installing a monitoring agent
v Linux or UNIX: Installing a monitoring agent on page 189
Windows: Installing a monitoring agent

Use the following steps to install a distributed monitoring agent on a Windows computer:
1. If you are installing on either an x86-32 CPU or an x86-64 CPU, launch the installation wizard by
double-clicking the setup.exe file in the \WINDOWS subdirectory on the installation media. However, if
you are installing on an Itanium CPU, launch the wizard by double-clicking on the setup.exe file in
the \WIA64 directory.
Use either the IBM Tivoli Monitoring Base Agent DVD or a distributed agent product CD for Windows.
Do not use a Data Files for z/OS CD.
4. Choose the directory where you want to install the product. Click Next.
Notes:
a. This step applies only to those agents that you install from the IBM Tivoli Monitoring installation
image. Agents installed from the agent installation image do not have this step. If you are
installing an agent from an agent installation image, skip to step 6.
b. If you specify an incorrect directory name, you will receive the following error:
5. Type a 32-character encryption key. This key must be the same as the key that was used during the
installation of the monitoring server to which this monitoring agent connects.
6. On the Select Features window, expand Tivoli Enterprise Monitoring Agents.
7. Select the names of the agents that you want to install and click Next.
Notes:
a. Agents available on the IBM Tivoli Monitoring installation image include the Warehouse Proxy
agent and the Summarization and Pruning agent. Before you install these agents, follow the
instructions later in this book for setting up a Tivoli Data Warehouse solution, beginning with
Chapter 15, Tivoli Data Warehouse solutions, on page 331. On Windows Itanium CPUs, only the
Windows agent, the Tivoli Universal Agent, and the agent framework are available for installation.
b. If both of these conditions are met:
v The components you selected for installation would result in a mixed 32-bit and 64-bit
environment.
v No Agent Compatibility Package (see Installing the Agent Compatibility (AC) component on
page 186) can be found on the installation DVD, or the package found is not at the appropriate
level.
184
then this error message is display:

The Agent Compatibility Package in version ver_num is required but unavailable.
8. If a monitoring server is not installed on this computer, go to Step 9.

If you are installing monitoring agents on a computer that already has a monitoring server installed,
the Agent Deployment window is displayed.
Note: By default, the agent depot is located in the itm_installdir\CMS\depot directory on Windows.
If you want to use a different directory, create the directory (if it does not exist), and specify the
depot at a later time by updating your installation.) IBM strongly recommends you also add the agent
compatibility (AC) package at this time. Click Next.
9. This step applies only to agents that you install from the IBM Tivoli Monitoring installation image. If
you are installing agents from an agent product installation image, go to Step 10.
If no IBM Tivoli Monitoring component has been previously installed on this computer, a window is
configured on this computer.) Click Next to start configuring all selected components.
12. Define the communications between the monitoring agents and the monitoring server:
a. If the agents must cross a firewall to access the monitoring server, select Connection must pass
through firewall.
b. Identify the type of protocol that the agents use to communicate with the monitoring server.
You have four choices: IP.UDP, IP.PIPE, IP.SPIPE, or SNA. You can specify up to three methods
for communication. If the method you have identified as Protocol 1 fails, Protocol 2 is used. If
Protocol 2 fails, Protocol 3 is used. When you configure the protocol for the Warehouse Proxy
agent, configure the same protocols used by the application agents and by the hub monitoring. If
the proxy agent does not have the same protocol as the hub monitoring server, it cannot register
with the hub. If the proxy does not have the same protocol as the application agents, then the
application agents cannot communicate with the proxy when they to create a route to it.
Note: Do not select Optional Secondary TEMS Connection. You can set up the failover support
for agents after installation, as described in the IBM Tivoli Monitoring: High-Availability
Guide for Distributed Systems.
c. Click OK. A second configuration window is displayed.
d. Complete the fields shown in the following tableTable 40 for the protocol that you specified.
Table 40. Communications protocol settings
Field
Description
IP.UDP Settings

server.
185
Table 40. Communications protocol settings (continued)

Field
Description

default number is 1918.
IP.PIPE Settings

server.
Port Number

number is 1918.
IP.SPIPE Settings

server.
Port number

SNA Settings
Network Name
LU Name

LU 6.2 LOGMODE

"CANCTDCS."
TP Name
Local LU Alias
The LU alias.
e. Click OK to exit the Configuration Defaults for Connecting to a TEMS window.

15. Open the Manage Tivoli Enterprise Monitoring Services utility (if it does not open automatically) to see
if the monitoring agents that you installed have been configured and started. If Yes is displayed in the
Configured column, the agent has been configured and started during the installation process.
16. If the value in the Configured column is blank and Template is displayed in the Task/Subsystem
column, right-click the Template agent and complete the following steps:
a. Click Configure Using Defaults.
b. Complete any windows requiring information by using the agent-specific configuration settings in
the user's guide for your agent.
Note: Do not type non-ASCII characters on any of these windows. Typing characters from other
character sets has unpredictable results.
c. Repeat this step as necessary to create monitoring agent instances for each application instance
you want to monitor.
Installing the Agent Compatibility (AC) component

With the introduction of a native 64-bit OS agent for Windows at IBM Tivoli Monitoring V6.2.2 fix pack 1, it
is likely that mixed environments of both 32-bit and 64-bit Tivoli Monitoring agents will be found on the
same machine. To provide a runtime environment capable of supporting such mixed 32- and 64-bit
executables, as well as to provide backward compatibility between native 64-bit agents and existing 32-bit
agents, a new component, the 32/64 Bit Agent Compatibility Package (component code AC), was also
introduced at IBM Tivoli Monitoring V6.2.2 fix pack 1. The AC package comprises the following pieces:
v 32-bit and 64-bit agent frameworks
186
v 32-bit and 64-bit versions of the IBM Global Security Toolkit (GSKit), component KGS
v The Tivoli Monitoring configuration utilities, component KGL
Note: The AC component is a Windows component only. There is no equivalent for Linux or UNIX
systems.
When to install the AC component: You need to install the AC component in these situations:
v When adding a native 64-bit agent into preexisting IBM Tivoli Monitoring installations comprising only
32-bit components.
v When adding a 32-bit agent into preexisting Tivoli Monitoring installations comprising only 64-bit
components.
v The Tivoli Monitoring installer has detected a situation where proceeding without the AC component
would result in incompatibility either between the 32-bit and the 64-bit agent frameworks or between the
32-bit and the 64-bit GSKit libraries.
The IBM Tivoli Monitoring installer will automatically detect any of the above situations and then stop the
installation with this error:
The version ver_num or newer of the Agent Compatibility Package must be installed in order to ensure
the correct cooperation between 32bit and 64bit components. Exiting installation.
When not to install the AC component: The AC component can be installed with any 32-bit or 64-bit
agent where a mixed 32/64 bit environment is anticipated. There is no need to install the AC component if
only 32-bit or only 64-bit IBM Tivoli Monitoring agents are planned for this machine.
Installing the AC component using the Windows GUI: The AC component can be found on the
Agents DVD. IBM recommends you install the AC component at the same version as the Windows OS
agent (component code NT). Since the AC is a standard Tivoli Monitoring component, it can be installed
using the standard interactive IBM Tivoli Monitoring installer by selecting the 32/64 Bit Agent
Compatibility Package feature for installation, as shown in Figure 24 on page 188.
187
Figure 24. Installing the Agent Compatibility Package (component code AC)
Remotely deploying the AC components: There are special considerations for deploying native 64-bit
agents as well as the AC component. When deploying an agent to a Windows machine running an x86-64
CPU, checks are automatically made to verify whether the AC component is required. If the checks report
the AC component is needed and it is available in the depot, it is sent automatically with no action required
on your part. However, if the checks report the AC component is needed but the component is not
available in the depot, an error is reported, and the deployment request fails. Therefore, it is highly
recommended that you populate the deployment depot with the AC component.
Sample tacmd addBundles command to add the AC component to the deploy depot:
tacmd addBundles -i C:\ITM_6.2.2FP1_Agents_Image\WINDOWS\Deploy -t ac
For more details on managing the agent depot, refer to Chapter 9, Deploying monitoring agents across
your environment, on page 237.
Note: Once you have added the AC bundle to the remote-deployment depot, it is listed among the
available packages in the Tivoli Enterprise Portal. Thus your interactive users can select it when
invoking the tacmd AddSystem command for a particular 64-bit node. However, if they do this,
your users will receive this error:
KFWITM291E an Agent Configuration schema not found
When it becomes necessary to invoke the remote deployment of the Agent Compatibility package,
instead use the CLI.
188
Installing the Embedded Java Runtime and the User Interface Extensions
On nodes where only the Windows OS agent has been installed, either locally or remotely, the Embedded
Java Runtime and the Tivoli Enterprise Services User Interface Extensions (the KUE component) are not
also installed by default. If you later decide to install an Agent Builder agent on this node, you may not be
able to reconfigure this factory agent, and you may receive the error shown in Figure 25.
Figure 25. Java Runtime Environment Not Detected error
This error also may occur when you attempt to run a tacmd CLI command on nodes where either the
Embedded Java Runtime or the User Interface Extensions are unavailable.
If this happens, you must install the Embedded Java Runtime and the KUE component. Complete one of
the following procedures, depending on the installation method you're following:
local GUI installation
Select Tivoli Enterprise Services User Interface Extensions from the list of features to install.
local silent installation
Uncomment this line in the silent response file:
;KUEWICMA=Tivoli Enterprise Services User Interface Extensions
remote installation
First ensure that component UE has been added to the server depot. Once the UE component is
available, from the command line, perform a tacmd addsystem command, specifying -t UE as the
component to install.
Once you have completed one of the above procedures, the Embedded Java Runtime and the Tivoli
Enterprise Services User Interface Extensions are installed and can be accessed on this node.
Linux or UNIX: Installing a monitoring agent

Use the following steps to install and configure a distributed monitoring agent on a Linux or UNIX
computer.
Table 41. Steps for installing a monitoring agent on Linux or UNIX
Steps
Install the monitoring agent.
Installing the monitoring agent on page 190
Configure the monitoring agent.
Configuring the monitoring agent on page 190

Some agents require additional, agent-specific
configuration parameters. See the agent documentation
for the specific agents that you are configuring.
Change the file permissions for files on the computer

where you installed the agent.
Changing the file permissions for agents on page 191
Start the monitoring agent.
Starting the monitoring agents on page 192
189
Installing the monitoring agent

Use the following steps to install a monitoring agent on a Linux or UNIX computer:
./install.sh
3. If the installation directory does not already exist, you are asked if you want to create it. Type y to
4) Exit install.
Note: This prompt might vary depending on the installation image from which you are installing.
7. Type a 32 character encryption key and press Enter. This key should be the same as the key that
was used during the installation of the monitoring server to which this monitoring agent connects.
Note: This step applies only to those agents that you install from the IBM Tivoli Monitoring
installation image. Agents installed from the agent installation image do not need to provide the
encryption key.
8. Type 1 to install the IBM Tivoli Monitoring support for your current operating system. Press Enter.
A numbered list of available components is displayed.
9. Type the number that corresponds to the monitoring agent or agents that you want to install. If you
want to install more than one agent, use a comma (,) or a space to separate the numbers for each
agent. Press Enter.
Note: Before you install the Warehouse Proxy agent or Summarization and Pruning agent, follow the
instructions later in this book for setting up a Tivoli Data Warehouse solution, beginning with
Chapter 15, Tivoli Data Warehouse solutions, on page 331.
A list of the components to be installed is displayed.
11. After all of the components are installed, you are asked whether you want to install additional
products or product support packages. Type 2 and press Enter. Continue with Configuring the
monitoring agent.
Configuring the monitoring agent

Use the following steps to configure your monitoring agent:
./itmcmd config -A pc
where pc is the product code for your agent. For the UNIX agent, use the product code "ux"; for Linux,
use "lz". See Appendix D, IBM Tivoli product, platform, and component codes, on page 567 for a list
of agent product codes.
190
2. Press Enter when you are asked if the agent connects to a monitoring server.
3. Type the host name for the monitoring server.
4. Type the protocol that you want to use to communicate with the monitoring server. You have four
choices: ip.udp, sna, ip.spipe, or ip.pipe. Press Enter to accept the default protocol (IP.PIPE).
Protocol
Value
Definition
IP.UDP
IP Port Number

SNA
Net Name

location.
LU Name

Log Mode

The default value is "CANCTDCS."
IP.PIPE
IP.PIPE Port Number

IP.SPIPE

7. Press Enter to not specify the name of the KDC_PARTITION.

8. Press Enter when you are asked if you want to configure the connection to a secondary monitoring
server. The default value is no.
9. Press Enter to accept the default for the Optional Primary Network Name (none).
You must complete the configuration of the Warehouse Proxy agent using the Manage Tivoli Enterprise
Monitoring Services graphical user interface (GUI), which requires an X11 GUI interface. See the
instructions for configuring the Warehouse Proxy for the appropriate Data Warehouse:
v DB2 for the workstation: Configuring a Warehouse Proxy agent on Linux or UNIX (JDBC connection)
on page 364
v SQL Server: Configuring a Warehouse Proxy agent on Linux or UNIX (JDBC connection) on page 407
v Oracle: Configuring a Warehouse Proxy agent on Linux or UNIX (JDBC connection) on page 426
If you used a nonroot user to install a monitoring agent on a UNIX computer, the file permissions are
initially set to a low level. Use the procedure in Changing the file permissions for agents to change these
file permissions:
Changing the file permissions for agents

If you used a nonroot user to install a monitoring agent on a UNIX computer, the file permissions are
initially set to a low level. Run the following procedure to change these file permissions:
1. Log in to the computer as root, or become the root user by running the su command.
2. Create a new group (such as "itmusers") to own all of the files in the IBM Tivoli Monitoring installation
directory.
For Linux, Solaris, and HP-UX computers, run the following command:
groupadd itmusers
For an AIX computer, run the following command:

191
mkgroup itmusers
3. Run the following command to ensure that the CANDLEHOME environment variable correctly
identifies IBM Tivoli Monitoring installation directory:
echo $CANDLEHOME
If you run the following steps in the wrong directory, you can change the permissions on every file in
every file system on the computer.
4. Change to the directory returned by the previous step:
cd $CANDLEHOME
5. Run the following command to ensure that you are in the correct directory:
pwd
6. Run the following commands:

chgrp -R itmusers .
chmod -R o-rwx .
7. Run the following command to change the ownership of additional agent files:
bin/SetPerm
8. If you want to run the agent as a particular user, add the user to the itmusers group. To do this, edit
the /etc/group file and ensure that the user is in the list of users for the itmusers group.
For example, if you want to run the agent as user test1, ensure that the following line is in the
/etc/group file:
itmusers:x:504:test1
9. Run the su command to switch to the user that you want to run the agent as or log in as that user.
10. Start the agent as described in Starting the monitoring agents.
Starting the monitoring agents

You can either start all agents running on a computer or start individual agents by using the product
codes.
To start all monitoring agents, run the following command:
./itmcmd agent start all
To start specific agents, run the following command:

./itmcmd agent start pc pc pc
where pc is the product code for the agent that you want to start. See Appendix D, IBM Tivoli product,
platform, and component codes, on page 567 for a list of agent product codes.
To start multi-instance agents (agents that may run more than one instance on a computer, like Seibel or
Domino agents), run the following command:
./itmcmd agent -o instance_name start pc
where pc is the product code for the agent that you want to start and instance_name is the name that
uniquely identifies the instance you want to start. See Appendix D, IBM Tivoli product, platform, and
component codes, on page 567 for a list of agent product codes.
Populating the data warehouse's ManagedSystem table

If your site runs the Tivoli Data Warehouse, each time you install one or more monitoring agents, you must
update the warehouse's ManagedSystem table; the populate_agents.sql script is provided for this
purpose.
v If your site uses DB2 Database for Linux, UNIX, and Windows to manage its Tivoli Data Warehouse,
call this stored procedure:
db2 call ITMUSER.POPULATE_OSAGENTS();
192
v If your site uses Microsoft SQL Server to manage its Tivoli Data Warehouse, run this script at the MS
SQL command line:
sqlcmd -i populate_agents.sql [-U my_username -P my_password] [-H my_host])
v If your site uses Oracle to manage its Tivoli Data Warehouse, start this procedure:
POPULATE_OSAGENTS('ITMUSER');
Installing the Tivoli Enterprise Portal desktop client

There are two methods of deploying the desktop client: You can install the desktop client from the
installation media and run and maintain it on the local system. You can also use IBM Web Start for Java to
download and run the desktop client from the Tivoli Enterprise Portal Server. See Tivoli Enterprise Portal
client on page 33 for a discussion of the advantages and disadvantages of each type of portal server
client available with IBM Tivoli Monitoring.
This section describes how to install the desktop client from the installation media on Windows and Linux
computers. When you install the desktop client from the installation media, you must also install support
for all the applications that you will be using.
v Windows: Installing the desktop client
v Linux: Installing the desktop client on page 194
See Using Web Start to download and run the desktop client on page 233 for instructions on
downloading and running the desktop client from the portal server.
Windows: Installing the desktop client

Complete the following steps to install the Tivoli Enterprise Portal desktop client from the Base
Infrastructure DVD or DVD image.
1. On the computer where you want to install the desktop client, start the installation wizard by
launching the setup.exe file in the \WINDOWS subdirectory on the installation media.
4. Specify the directory where you want to install the portal desktop client software and accompanying
files. The default location is C:\IBM\ITM. Click Next.
5. Type an encryption key to use. This key must be the same as what was used during the installation
of the hub monitoring server to which the client will connect. Click Next and then OK to confirm the
encryption key.
6. On the Select Features window, select Tivoli Enterprise Portal Desktop Client from the list of
components to install.
When you select the Tivoli Enterprise Portal Desktop Client check box, all of the check boxes in
the attached subtree are automatically selected. The support check boxes in the subtree are for
installing application support files for distributed monitoring agents to the portal desktop client. It is
best to leave all of the support check boxes selected so you do not need to reconfigure application
support as new agent types are added to your environment. However, if you purchased an
193
OMEGAMON XE monitoring product and you did not separately purchase IBM Tivoli Monitoring, you
should not install support for the distributed operating system monitoring agents nor the Tivoli
Universal Agent. If you are installing from the Base DVD, you may see application support for
components that are not supported on the operating system. For detailed information about
Note: If you are updating an existing installation (you selected Modify on the Welcome window), all
Clearing a check box has the effect of uninstalling the component. Clear a check box only if
you want to remove a component.
7. If you want to view IBM Tivoli Enterprise Console events through the Tivoli Enterprise Portal, expand
Tivoli Enterprise Portal Desktop Client and ensure that TEC GUI Integration is selected.
8. Click Next.
9. If a monitoring server is not installed on this computer, go to Step 10.
If you are installing the desktop client on a computer that already has a monitoring server installed,
the Agent Deployment window is displayed.
Note: By default, the agent depot is located in the itm_installdir\CMS\depot directory on Windows. If
you want to use a different directory, create the directory (if it does not exist) and specify the
configured on this computer.) If the desktop client is being installed on the same host as the portal
server but as part of a separate installation process, you must reconfigure the portal server.
Click Next to start configuring all selected components.
13. Type the host name of the portal server and click OK.
Linux: Installing the desktop client

Use the following steps to install the Tivoli Enterprise Portal desktop client:
./install.sh
3. If the installation directory does not already exist, you are asked if you want to create it. Type 1 to
194

4) Exit install.
7. Type an 32-character encryption key to use and press Enter. This key should be the same key as
that used during the installation of the portal server to which the client will connect.
8. Type 3 to install the desktop client support for your current operating system. Press Enter.
A message is displayed indicating that the Tivoli Enterprise Portal Desktop Client is about to be
installed.
10. After the portal desktop client is installed, you are asked whether you want to install additional
products or product support packages. Type 1 and press Enter.
A numbered list is displayed, including the following application support package:
Tivoli Enterprise Portal Desktop Client support
11. Install the application support package for the portal desktop client.
All monitoring agents require that application support files be installed on the monitoring servers (hub
and remote), portal server, and portal desktop clients in your environment. Application support files
contain the information required for agent-specific workspaces, helps, predefined situations, and other
data.
This step installs the application support files for base monitoring agents. The base monitoring agents
are included with the base IBM Tivoli Monitoring installation package. For detailed information about
a. Type the number that corresponds to Tivoli Enterprise Portal Desktop Client support and
press Enter.
A numbered list of base monitoring agents is displayed.
b. Type the numbers of the base monitoring agents for which you want to install application support,
or type the number that corresponds to All of the above. Type the numbers on the same line
separated by spaces or commas. Press Enter.
It is best to select all of the base monitoring agents (All of the above) so you do not need to
reconfigure application support as new agent types are added to your environment.
c. Type 1 to confirm the installation and press Enter.
Note: This step installs the application support files. However, you must enable the application
support by configuring the portal desktop client. The next sections shows you how to
configure the portal desktop client.
12. After application support for the monitoring agents is installed, you are asked whether you want to
install additional products or product support packages. Type 2 and press Enter.
The next step is to configure the desktop client. Use the instructions in Linux: Configuring the desktop
client on page 196.
195
Linux: Configuring the desktop client

Complete the following steps to configure the desktop client if you installed the client from the IBM Tivoli
Monitoring installation media. You do not need to complete this procedure if you obtained the desktop
client by using IBM Web Start for Java to download it from the Tivoli Enterprise Portal Server.
1. At the command line /opt/IBM/ITM/bin directory (or the /bin subdirectory where you installed the
product), run the following command:
./itmcmd config -A cj
2.
3.
4.
5.
Press Enter to use the default instance name.

Type the host name for the portal server and press Enter.
Press Enter when you are asked if you want to use HTTP Proxy support. The default value is no.
Start the desktop client:
/itmcmd agent start cj
Installing and enabling application support

Before you can view data collected by monitoring agents, you must install and enable application support
for those agents. Application support files provide agent-specific information for workspaces, helps,
situations, templates, and other data. Application support for a monitoring agent includes two types of files:
v SQL files are required for adding product-provided situations, templates, and policies to the Enterprise
Information Base (EIB) tables maintained by the hub monitoring server. These SQL files are also called
seed data, and installing them on a monitoring server is also called seeding the monitoring server.
v Catalog and attribute (cat and atr) files are required for presenting workspaces, online help, and
expert advice for the agent in Tivoli Enterprise Portal.
All monitoring agents require that application support be configured on all instances of the following
infrastructure components:
v Tivoli Enterprise Monitoring Server (both hub and remote monitoring servers)
v Tivoli Enterprise Portal desktop client, if the desktop client was installed from the installation media.
You do not need to configure application support for desktop clients downloaded from the Tivoli
Enterprise Portal Server using IBM Web Start for Java.
Application support for monitoring agents is installed independently of where and when the monitoring
agents themselves are installed:
v Install application support for a particular type of monitoring agent on the monitoring servers, portal
server, and portal desktop clients. Install agents of that type on any managed system in the environment
that is compatible with the agent.
v Install application support for a type of monitoring agent before or after any monitoring agents of that
type are installed. After you install application support for a particular type of monitoring agent, you can
add any number of agents of that type to your environment without having to install application support
again.
For example, you can install application support for a Linux OS monitoring agent (the agent type) to a
Windows monitoring server (using the IBM Tivoli Monitoring installation media for Windows). Later, you can
install any number of Linux OS monitoring agents to Linux computers in your environment (using the IBM
Tivoli Monitoring installation media for Linux).
Important:
1. If you are installing a non-OS agent remotely through the Tivoli Enterprise Portal (see Deploying
non-OS agents on page 244), application support for the agent must be installed on the Tivoli
Enterprise Portal Server before the agent is deployed.
2. When you install application support for an IBM Tivoli Composite Application Manager agent on the
V6.2.2 fix pack 2 (or subsequent) version of the Tivoli Enterprise Monitoring Server, do not select for
196
installation the File Transfer Enablement component. If you do, the File Transfer Enablement
component shipped with the V6.2.2 fix pack 2 (or subsequent) monitoring server will be replaced, and
the tacmd getfile, tacmd putfile, and tacmd executecommand commands will become inoperative.
Because application support for some IBM Tivoli Monitoring 6.x-based distributed agents is included on the
Base Infrastructure DVD, you may see application support files that do not apply to all systems.
Configuring application support is a two-step process:
1. Installing the application support files (from installation media).
2. Enabling the application support (sometimes referred to as adding or activating the application
support).
On the portal server and portal desktop clients, application support is enabled when the component is
configured. On monitoring servers, application support is enabled by seeding the database with
agent-specific information.
The procedures for configuring application support differ by operating system, as summarized in Table 43.
On Windows, both installation and enablement of application support are accomplished during the
installation of the monitoring servers, portal server, and desktop clients. On Linux or UNIX, this two-step
process is more visible, with the enablement step done separately from the installation.
Table 43. Procedures for installing and enabling application support
Operating system Monitoring servers
Portal server
Desktop clients1
Windows
Install and enable application

support using installation
media.

media.

media.
Linux or UNIX
1. Install application support

files from installation
media.

media.

media.
2. Seed the monitoring server 2. Configure the portal server

using:
using:
z/OS
2. Configure the desktop

client using:
v itmcmd support2
command, OR
v itmcmd config
command, OR
v itmcmd config
command, OR
v Manage Tivoli Enterprise

Monitoring Services
window

Monitoring Services
window

Monitoring Services
window
This book does not describe configuring application support for a monitoring server installed on
a z/OS system. See Configuring the Tivoli Enterprise Monitoring Server on z/OS for information
and instructions.
The portal server and desktop client are not supported on z/OS. If you have a monitoring server
on z/OS, use the procedures in this book to configure application support on the portal server
and desktop clients.
1. You need to configure application support for desktop clients that are installed from the installation media. You do
not need to configure application support for desktop clients that are installed by using IBM Java Web Start to
download the client from the Tivoli Enterprise Portal Server.
2. You can seed a nonlocal monitoring server, even if one is not installed on the local computer, by installing the
support using option 3, Install TEMS support for remote seeding, then using Manage Tivoli Enterprise
Monitoring Services to seed the nonlocal monitoring server. You cannot use itmcmd support to seed a nonlocal
monitoring server.
3.
There is no way to uninstall the application support files laid down without uninstalling the Tivoli Enterprise
Monitoring Server.
197
Selecting the correct support media

Application support for IBM Tivoli Monitoring V6.2.2 distributed agents is found on the following Base
DVDs:
v IBM Tivoli Monitoring V6.2.2 Infrastructure DVD contains the Tivoli Enterprise Monitoring Server and its
application support, the Tivoli Enterprise Portal Server and its application support, and the Tivoli
Enterprise Portal desktop and browser clients together with their application support, along with the
Warehouse Proxy agent and the Summarization and Pruning agent. This DVD is platform-specific:
Windows, Linux, or UNIX.
v IBM Tivoli Monitoring V6.2.2 Agents DVD contains the monitoring agents listed in Table 44. This DVD is
platform-nonspecific: the same DVD is used for installing on Windows, Linux, and UNIX.
The Infrastructure DVD contains application support files for the monitoring server (hub and remote), the
portal server and its client, the Warehouse Proxy agent, the Summarization and Pruning agent; the Agents
DVD contains the application support files for the monitoring agents. To install application support for all
IBM Tivoli Monitoring components and agents on distributed nodes, use the procedures documented in
this chapter for installing the monitoring servers, the Tivoli Enterprise Portal, and the portal desktop client.
See Configuring application support for agents on the Base DVDs on page 199 for more information. For
instructions on installing application support for the monitoring agents on a monitoring server on z/OS, see
IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS.
Table 44. Product support on the Infrastructure and Agent DVDs
Product
Code
Product Name
R3
agentless monitor for AIX operating systems
R5
agentless monitor for HP-UX operating systems
R4
agentless monitor for Linux operating systems
R6
agentless monitor for Solaris operating systems
R2
agentless monitor for Windows operating systems
LZ
monitoring agent for Linux OS
UL
monitoring agent for UNIX Logs
UX
monitoring agent for UNIX OS
NT
monitoring agent for Windows OS
A4
monitoring agent for i5/OS
SY
HD
UM
The Agent DVD delivered with IBM Tivoli Monitoring V6.2.2 must be used instead of the agent installation
CDs if you are installing support for the agents listed in the following tables on the component specified.
The installer on the agent installation CDs does not support these components on these platforms. To
install application support for these agents on distributed components, see Configuring application support
for nonbase monitoring agents on page 199. To install application support for the monitoring agents on a
z/OS monitoring server, see IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise
Monitoring Server on z/OS.
For all other distributed agents, install application support from the product installation CDs. See
Configuring application support for nonbase monitoring agents on page 199 for instructions.
198
Configuring application support for agents on the Base DVDs

You install and configure application support for the agents on the Base DVDs when you install and
configure distributed monitoring servers, the portal server, and the portal desktop clients using the
instructions in this chapter.
v When you install a monitoring server on Linux or UNIX, support files for all agent types on the Base are
installed automatically. When you install the portal server and portal desktop client, you can specify
which agent types to support.
v When you install a monitoring server, portal server, or portal desktop client on Windows, you can select
the Base monitoring agents for which you want to install application support on the Select Features
window. By default, all the agents are selected.
In both cases, it is best to install and enable application support for all agent types on the Base DVDs
during the initial installation to avoid having to reconfigure application support on all monitoring servers, the
portal server, and portal desktop clients as new agent types are added to your environment.
If you need to reconfigure application support, restart the installation from the IBM Tivoli Monitoring
installation media. Update the installation by installing application support for additional Base monitoring
agents. When you update an installation, keep in mind the following considerations:
v Following an installation update on Linux or UNIX, you must reseed the monitoring server and
reconfigure the portal server and desktop clients.
v When you update an installation on Windows, proceed through the installation as you did for the initial
installation except as follows:
All check boxes on the Select Features window reflect your choices during the initial installation. Do
not clear any check boxes. Clearing a check box has the effect of uninstalling the component.
For example, if you are updating the installation to add application support for the i5/OS agent, select
only the application support check box for the i5/OS agent. Do not clear any application support
check boxes that are already checked unless you want to remove support for those agents.
You do not need to reconfigure any components (such as the monitoring server or portal server) that
have already been configured.
v You must update the installation on all computers where a monitoring server, portal server, or desktop
client is installed.
Before seeding actually begins, as part of the installation process, you will be asked if you want to use the
seeding files that are included with the installation media or if you want to use the ones you customized
during a previous installation.
Important: Do not install agent application support for the current release on a Tivoli Enterprise
Monitoring Server for a prior release (for example, do not install V6.2.2 agent application
support on a V6.2 monitoring server). Doing so can cause agents to fail.
Configuring application support for nonbase monitoring agents

The term nonbase is used here to refer to distributed monitoring agents for which support is included on
the current Agents DVD, and to other products such as IBM Tivoli Monitoring for Applications,
OMEGAMON XE monitoring agents, and IBM Tivoli Composite Application Manager monitoring agents that
provide their own support files.
Some monitoring agents that run on z/OS or z/VM are packaged with their own CD that contains the data
files for adding application support to distributed components. Other monitoring agents that run on z/OS
are packaged with a CD that contains data files for a number of agents. If in doubt, refer to the
configuration guide for each of your monitoring agents to find the exact name of the CD to use.
199
The following table shows you which installation media to use and where to find instructions for installing
application support, according to the type of agent (distributed or z/OS) and whether the agent reports to a
distributed or z/OS monitoring server.
Table 45. Installation media and instructions for installing application support for nonbase monitoring agents
Agent
Monitoring
server
Distributed
Distributed
Installation media
Instructions for installing application support
IBM Tivoli Monitoring

V6.2: Agents DVD
Follow the instructions in this section to install application

support on the monitoring server, portal server, and
desktop client.
Agent product installation

CDs
Distributed
z/OS

V6.2: Agents DVD
v Follow the instructions in this section to install

application support on the portal server and desktop
clients.
Agent product installation

v Follow the instructions in Configuring the Tivoli
CDs
Enterprise Monitoring Server on z/OS to install
application support on the monitoring servers.
z/OS
Distributed
Data Files CD
Follow the instructions in this section to install application

support on the monitoring server, portal server, and
desktop client.
z/OS
z/OS
Data Files CD
v Follow the instructions in this section to install

application support on the portal server and desktop
clients.
v Follow the instructions in Configuring the Tivoli
Enterprise Monitoring Server on z/OS to install
application support on the monitoring servers.
Use the instructions in the following sections to install application support for nonbase distributed or z/OS
monitoring agents on the distributed monitoring servers, portal server, and portal desktop clients in your
environment:
v Installing application support on monitoring servers
v Installing application support on the Tivoli Enterprise Portal Server on page 206
v Installing application support on the Tivoli Enterprise Portal desktop client on page 209
Each of these sections provides information for installing application support files to a single component,
such as the monitoring server. If you have multiple components on the same computer (such as the
monitoring server and the portal server), combine steps from the individual sections to install application
support to all components.
Installing application support on monitoring servers

Use the following procedures to install application support for nonbase monitoring agents on distributed
monitoring servers (hub or remote) in your environment:
v Windows: Installing application support on a monitoring server
v Linux or UNIX: Installing application support on a monitoring server on page 204
Windows: Installing application support on a monitoring server: Complete the following steps to
install application support for monitoring agents on Windows monitoring servers.
Notes:
1. The monitoring server is stopped during this process.
2. If you are running in a Hot Standby environment, shut down your Hot Standby (that is, mirror)
monitoring server before completing this procedure. Restart the Hot Standby monitoring server only
after you have seeded the hub server.
200
1. In the \WINDOWS subdirectory on the agent product CD (for distributed products) or data files CD
(for z/OS products), double-click the setup.exe file to launch the installation.
Note: If a monitoring agent is already installed on this computer, select Modify on the Welcome
window to indicate that you are updating an existing installation. Click OK on the message
telling you about preselected items. Then skip to Step 6.
3. On the Install Prerequisites window, read the information about the required levels of IBM Global
Security Toolkit (GSKit) and IBM Java.
The check box for each prerequisite is cleared if the correct level of the software is already installed.
Otherwise, the check box is selected to indicated that the software is to be installed. If you are
installing support from the data files CD for z/OS agent products, you might be prompted to install
Sun Java Runtime Environment (JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the
distributed components of Tivoli Management Services. The two versions can coexist, and installation
of application support for some monitoring agents requires Sun Java 1.4.2. You might also see a
message indicating that you can decline the installation of JRE 1.4.2 and that accepting installation of
JRE 1.4.2 results in uninstallation of other Java versions. Ignore this message, because you cannot
proceed without accepting the installation of Sun Java 1.4.2, and accepting the installation does not
uninstall IBM Java 1.5.
4. Click Next. The prerequisite software is installed if necessary.
If the installation program installs IBM GSKit or IBM JRE, you might be prompted to restart the
computer when the installation is complete. If so, you receive an abort message with a Severe error
heading. This is normal and does not indicate a problem.
If you are prompted to reboot, do the following:
a. Click OK on the window prompting you to reboot.
b. Click No on the window asking whether you want to view the abort log.
c. Restart the computer.
d. Restart the installation program.
6. If you see a message regarding installed versions being newer than the agent installation, click OK to
ignore this message.
7. Select the application support packages that you want to install:
a. On the Select Features window, select Tivoli Enterprise Monitoring Server.
b. Expand the Tivoli Enterprise Monitoring Server node to display a list of application support
packages that you can install on the monitoring server.
The following example shows the application support packages available with the IBM Tivoli
Monitoring for Databases product:
201
Figure 26. IBM Tivoli Monitoring for Databases: application support packages
Initially, all application support packages are selected.

c. Clear the check boxes for application support packages that you do not want to install.
Note: If you are updating an existing installation (you selected Modify on the Welcome window),
all check boxes on the Select Features window reflect your choices during the initial
installation. Clearing a check box has the effect of uninstalling the component (for example,
the Tivoli Enterprise Monitoring Server) or product package. Clear a checkbox for an
application support package only if you want to remove the application support.
d. If you have other components installed on the same computer, such as the desktop client, also
select those components to install the component-specific application support.
e. Click Next.
8. (Distributed agents only) If you want to add the agent to the deployment depot, select the agent and
click Next.
This step does not occur for z/OS agents. z/OS agents cannot be added to the deployment depot.
9. On the Start Copying Files window, read the list of actions to be performed and click Next to start the
installation.
The application support packages that you selected are installed.
10. On the Setup Type window, do the following:
a. Select Install application support for a local/remote Tivoli Enterprise Monitoring Server.
b. Optionally, select the check box for launching the Manage Tivoli Enterprise Monitoring Services
window. (If selected, this window is displayed when the installation procedure is finished.)
c. Clear the check boxes for any components that you have already installed on this computer, such
as the monitoring server.
d. Click Next.
11. On the two Tivoli Enterprise Monitoring Server configuration windows that are displayed, make sure
the information is correct and click either Next or OK.
12. Enable application support on the monitoring server:
202
In Step 7 on page 201, you selected the application support packages that you wanted to install on
the monitoring server. In this step, you activate the application support through a process known as
seeding the monitoring server.
choices:
v On this computer
Click OK.
b. If you are updating a hub Tivoli Enterprise Monitoring Server, you are asked to choose whether
you want to add the default managed system groups when you process the application-support
files:
All
Add the default managed system groups to all applicable situations.
New
Add the default managed system groups to all applicable situations from the product
support packages being seeded for the first time. Modifications are not made to managed
system groups in previously upgraded product support packages.
None
The default managed system group is not added to any situation.
Note: Not all situations support the default managed group setting. For some, you might need to
manually define the distribution using the Tivoli Enterprise Portal due to the specific content
of the agent support package.
Figure 27. The Select the Application Support to Add to the TEMS window
c. Click OK on the Select the Application Support to Add to the TEMS window.
This window lists the application support packages that you selected in Step 7 on page 201. Click
OK to begin seeding the monitoring server (using the SQL files listed on this window). This
process can take up to 20 minutes.
203
d. Click Next on the message that provides results for the process of adding application support
(see Figure 28).
Figure 28. Application Support Addition Complete window
A return code of 0 (rc=0) indicates that the process succeeded.

in the IBM\ITM\CNPS\Logs\seedkpp.log files (where pp is the two-character code for each
monitoring agent) for diagnostic messages that help you determine the cause of the
problem.
13. Click Finish to close the installation wizard.
Linux or UNIX: Installing application support on a monitoring server: Complete the following steps
to install application support for monitoring agents on a UNIX or Linux monitoring server:
1. Stop the monitoring server by running the following command:
2. Run the following command from the installation media (the agent product CD for distributed agent
products or the data files CD for z/OS agent products):
./install.sh
directory (/opt/IBM/ITM) or type the full path to the installation directory you used.
204

2) Exit install.
Enter 1 to start the installation.

The software license agreement is displayed.
5. Read through the agreement, then type 1 and press Enter to accept it.
The installer presents a list of installable components for the operating system you are currently
running.
6. (Distributed agent products only, optional) If you are using a distributed agent product CD, optionally
install monitoring agents to this computer. For example, you can install an OS monitoring agent to
monitor the operating system. Complete the following steps if you want to install monitoring agents. If
you do not want to install monitoring agents, skip to Step 8.
a. Enter 1 to install the IBM Tivoli Monitoring components for your current operating system.
b. Enter 1 to confirm your selection.
The installer presents a numbered list of monitoring agents that you can install.
c. Enter the numbers of the monitoring agents that you want to install or enter the number that
corresponds to All of the above. Enter more than one number on the same line separated by
spaces or commas (,).
A list of the monitoring agents to be installed is displayed.
d. Enter 1 to confirm the installation.
e. After the monitoring agents are installed, the installer asks if you want to install additional
products or support packages. Enter 1 and go to Step 8.
7. (z/OS agent products only, required) If you are using a data files CD, complete the following steps to
install required metaprobes. (helper programs) for the monitoring agents that you want to support.
a. Enter the number of the operating system. The default value is the current operating system.
b. Enter y to confirm your selection.
The installer presents a numbered list of monitoring agents.
c. Enter the numbers of the monitoring agents for which you want to install application support, or
enter the number that corresponds to All of the above. Enter more than one number on the
same line separated by spaces or commas (,).
The installer displays the list of monitoring agents that you selected. For example:
The following products will be installed:
OMEGAMON
OMEGAMON
OMEGAMON
OMEGAMON
XE
XE
XE
XE
for CICS on z/OS v 4.1.0

for DB2 PE and PM on z/OS v 4.1.0
for IMS on z/OS v 4.1.0
on z/OS v 4.1.0
Note: The prompt (The following products will be installed) seems to indicate that the
installer is about to install the listed monitoring agents, which is true for distributed agents.
However, for z/OS agents, only metaprobes for the monitoring agents are installed. You
cannot install z/OS agents on a monitoring server on Linux or UNIX (and you cannot install
monitoring agents from a data files CD).
e. After the metaprobes are installed, the installer asks if you want to install additional products or
support packages. Enter y.
8. Install the application support package for the Tivoli Enterprise Monitoring Server:
a. Enter the number for Tivoli Enterprise Monitoring Server support.
205
A list of the monitoring agents for which you can install application support is displayed.
b. Enter the numbers of the monitoring agents for which you want to install application support, or
enter the number that corresponds to All of the above. Enter the numbers on the same line
separated by spaces or commas (,).
c. Enter 1 to confirm the installation.
9. You are asked if you want to install application support on the Tivoli Enterprise Monitoring Server. If
you reply yes, application support is automatically added.
If you disagree, you can manually add application support later; see Installing and enabling
application support on page 196.
10. If you are updating a hub Tivoli Enterprise Monitoring Server, you are asked to choose whether you
want to add the default managed system groups when you process the application-support files, as
shown in Figure 27 on page 203:
All
Add the default managed system groups to all applicable situations.
New
Add the default managed system groups to all applicable situations from the product support
packages being seeded for the first time. Modifications are not made to managed system
groups in previously upgraded product support packages.
None
The default managed system group is not added to any situation.
Note: Not all situations support the default managed group setting. For some, you might need to
manually define the distribution using the Tivoli Enterprise Portal due to the specific content of
the agent support package.
11. After you have added application support for one or more agents, you must refresh the monitoring
server configuration:
a. Start Manage Tivoli Enterprise Monitoring Services.
b. Pull down the Actions menu, and select the Refresh Configuration option (see Figure 29).
Figure 29. Refresh Configuration menu option
Installing application support on the Tivoli Enterprise Portal Server

Use the following procedures to install application support for nonbase monitoring agents on your portal
server:
v Windows: Installing application support on a portal server
v Linux or AIX: Installing application support on a portal server on page 208
Windows: Installing application support on a portal server: Complete the following steps to install
application support for monitoring agents on a Windows portal server:
206
1. Stop the portal server:

a. Open Manage Tivoli Enterprise Monitoring Services.
b. Right-click Tivoli Enterprise Portal Server and click Stop.
2. In the /WINDOWS subdirectory on the agent product CD (for distributed products) or data files CD
Otherwise, the check box is selected to indicated that the software is to be installed. If you are
installing support from the data files CD for z/OS agent products, you might be prompted to install
Sun Java Runtime Environment (JRE) 1.4.2, even if you have already installed IBM JRE 1.5 with the
distributed components of Tivoli Management Services. The two versions can coexist, and installation
of application support for some monitoring agents requires Sun Java 1.4.2. You might also see a
message indicating that you can decline the installation of JRE 1.4.2 and that accepting installation of
JRE 1.4.2 results in uninstallation of other Java versions. Ignore this message, because you cannot
proceed without accepting the installation of Sun Java 1.4.2, and accepting the installation does not
uninstall IBM Java 1.5.
5. Click Next. The prerequisite software is installed if necessary.
a. On the Select Features window, select Tivoli Enterprise Portal Server.
b. Expand the Tivoli Enterprise Portal Server node to display a list of application support packages
that you can install on the portal server.
installation. Clearing a check box has the effect of uninstalling the component (for example,
the Tivoli Enterprise Portal Server) or product package. Clear a checkbox for an application
support package only if you want to remove the application support.
d. If you have other components installed on the same computer, such as the desktop client, also
select those components to install the component-specific application support.
e. Click Next.
207
9. On the Start Copying Files window, read the list of actions to be performed and click Next to start the
installation.
10. On the Setup Type window, clear any components that you have already installed and configured on
this computer. Click Next.
11. Type the host name for the portal server and click Next.
12. Click Finish to complete the installation wizard.
13. Restart the portal server.
Linux or AIX: Installing application support on a portal server: Complete the following steps to install
application support for monitoring agents on a Linux or AIX portal server:
1. Stop the portal server by running the following command:
./itmcmd agent stop cq
./install.sh
directory (/opt/IBM/ITM) or enter the full path to the installation directory you used.
2) Exit install.

5. Read through the agreement, then type 1 and press Enter to accept it.
The installer presents a list of installable products for the operating systems you are currently running.
you do not want to install monitoring agents, skip to Step 7.
a. Enter 1 for your current operating system.
products or support packages. Enter 1.
7. Install the application support packages for the portal server and browser client. Install application
support packages for the portal desktop client if a desktop client is installed on this computer.
The numbered list of items presented by the installer includes the following application support
packages. (The numbers might vary from this example.)
28) Tivoli Enterprise Portal Browser Client support
29) Tivoli Enterprise Portal Desktop Client support
30) Tivoli Enterprise Portal Server support
208
Note: The Tivoli Enterprise Portal Browser Client support package is portal server code that supports
the browser clients. You must install the browser client support package on the computer
where you install the portal server.
Repeat the following steps for each support package:
a. Enter the number that corresponds to the support package (for example, 28).
A numbered list of monitoring agents is displayed.
b. Enter the numbers that correspond to the monitoring agents for which you want to install the
application support package, or enter the number that corresponds to All of the above. Type the
numbers on the same line separated by spaces or commas (,).
d. After the support package is installed, you are asked whether you want to install additional
products or product support packages. Enter 1 to install an additional package and repeat the
preceding steps. Enter 2 if you are finished installing support packages.
8. Stop the portal server by running the following command:
./itmcmd agent stop cq
9. Run the following command to configure the portal server with the new agent information:
Complete the configuration as prompted. For information about configuring the portal server, see
Configuring the portal server on Linux or AIX: command-line procedure on page 171.
10. Restart the portal server by running the following command:
Installing application support on the Tivoli Enterprise Portal desktop client

Use the following procedures to install application support for nonbase monitoring agents on each
computer where you are running a desktop client.
Note: You must install application support on desktop clients that were installed from the installation
media. You do not need to install application support on desktop clients that were obtained by using
IBM Web Start for Java to download the client from the Tivoli Enterprise Portal Server.
v Windows: Installing application support on a desktop client
v Linux: Installing application support on a desktop client on page 211
Windows: Installing application support on a desktop client: Complete the following steps to install
application support for monitoring agents on a Windows desktop client:
1. Stop the portal desktop client:
a. Open Manage Tivoli Enterprise Monitoring Services.
b. Right-click Tivoli Enterprise Portal Desktop Client and click Stop.
2. In the /WINDOWS subdirectory on the agent product CD (for distributed products) or data files CD
Otherwise, the check box is selected to indicated that the software is to be installed. You might be
prompted to install Sun Java Runtime Environment (JRE) 1.4.2, even if you have already installed
209
IBM JRE 1.5 with the distributed components of Tivoli Management Services. The two versions can
coexist, and installation of application support for some monitoring agents requires Sun Java 1.4.2.
You might also see a message indicating that you can decline the installation of JRE 1.4.2 and that
accepting installation of JRE 1.4.2 results in uninstallation of other Java versions. Ignore this
message, because you cannot proceed without accepting the installation of Sun Java 1.4.2, and
accepting the installation does not uninstall IBM Java 1.5.
Tip
If you are installing support from the data files CD for z/OS agent products, you might be
prompted to install Java Runtime Environment (JRE) 1.4.2, even if you have already installed
IBM JRE 1.5 with the distributed components of Tivoli Management Services. You might also
see a message indicating that you can decline the installation of JRE 1.4.2 and that accepting
installation of JRE 1.4.2 results in uninstallation of other Java versions. Ignore this message,
because you cannot proceed without accepting the installation of Java 1.4.2, and accepting the
installation of Java 1.4.2 does not uninstall IBM Java 1.5. The two versions can coexist.
However, the most recently installed version of Java becomes the active version, and the
distributed components of Tivoli Management Services V6.2.0 require that JRE 1.5 be the active
version.
To change the active version back to JRE 1.5 after you complete installation of application
support, follow these steps:
a. Open the Windows Control Panel by selecting Start > Settings > Control Panel.
b. From the Windows Control Panel, select IBM Control Panel for Java.
c. On the Java tab of the Java Control Panel, click the View button in the Java Application
Runtime Settings section.
d. On the JNLP Runtime Settings window, select version 1.5, and make sure the Enabled
checkbox is selected.
e. Click OK twice to save your settings and exit the Java Control Panel.
f. From the Windows Control Panel, select Java Plug-in.
g. On the Advanced tab of the Java Plug-in Control Panel, make sure that JRE 1.5.0 is
selected. If you change the setting, click Apply.
h. Close the Java Plug-in Control Panel window and the Windows Control Panel.
5. Click Next to continue. The prerequisite software is installed if necessary.
6. Read the software license agreement and click Accept.
a. On the Select Features window, select Tivoli Enterprise Portal Desktop Client.
b. Expand the Tivoli Enterprise Portal Desktop Client node to display a list of application support
packages that you can install on the portal server.
210
9.
10.
11.
12.
installation. Clearing a check box has the effect of uninstalling the component or product
package. Clear a check box for an application support package only if you want to remove
the application support.
d. Click Next.
On the Start Copying Files window, read the list of actions to be performed and click Next to start the
installation.
On the Setup Type window, clear any components that you have already installed and configured on
this computer. Click Next.
Type the host name for the portal server and click Next.
Click Finish to complete the installation wizard.
Linux: Installing application support on a desktop client: Complete the following steps to install
application support for monitoring agents on a Linux desktop client:
Note: Stop the desktop client before performing this procedure.
1. Stop the desktop client by running the following command:
./itmcmd agent stop cj
./install.sh
2) Exit install.

5. Read the software license agreement; then type 1 and press Enter to accept it.
The installer presents a list of installable components for your current operating system.
you do not want to install monitoring agents, skip to Step 7 on page 212.
a. Enter 1 for your current operating system.
211
products or support packages. Enter 1.
7. Install the application support package for the portal desktop client:
a. Enter the number that corresponds to Tivoli Enterprise Portal Desktop Client support.
A numbered list of monitoring agents is displayed.
b. Enter the numbers that correspond to the monitoring agents for which you want to install the
application support package, or enter the number that corresponds to All of the above. Type the
numbers on the same line separated by spaces or commas (,).
8. After application support for all monitoring agents is installed, you are asked whether you want to
install additional products or product support packages. Enter 2.
9. Run the following command to configure the desktop client with the new agent information:
Complete the configuration as prompted. For information about configuring the desktop client, see
Linux: Configuring the desktop client on page 196.
10. Restart the desktop client by running the following command:
./itmcmd agent start cj
Configuring application support on nonlocal monitoring servers

The following sections contain procedures for installing and enabling application support on a monitoring
server (hub or remote) that is located on a remote computer. For example, you might need to install
application support on a hub monitoring server on z/OS for a monitoring agent running on Windows or a
Linux operating system. Or you might want to install application support on a monitoring server or client on
a different computer than the one on which you are installing an agent or a portal server. If you are using
a z/OS hub and you want to aggregate and prune historical data for any agent, you must transfer the
catalog and attribute files for the Summarization and Pruning agent to the hub.
The procedures in this section require that either a Tivoli Enterprise Portal Server or a Tivoli Enterprise
Monitoring Server be installed on the Windows, Linux, or UNIX computer and configured to communicate
with the monitoring server on the nonlocal computer.
v Configuring application support on a nonlocal monitoring server from a Windows system
v Configuring application support on a nonlocal monitoring server from a Linux or UNIX system on page
214
Configuring application support on a nonlocal monitoring server from a Windows

system
This section describes how you can install and enable application support on a nonlocal monitoring server
from your local Windows system. The nonlocal monitoring server can be a hub or remote monitoring
server installed on a Windows, Linux, UNIX, or z/OS computer. A monitoring server or a portal server must
be installed on the local computer and application support for the agent or agents must be installed on it.
You add support to a nonlocal monitoring server by copying the kpp.cat and kpp.atr files for each from the
local computer to the nonlocal computer. If you are adding support to a nonlocal hub monitoring server,
you use Manage Tivoli Enterprise Monitoring Services to transfer the kpp.sql files for each agent.
Copying the CAT and ATR files to the nonlocal monitoring server: Copy the .cat and .atr files for the
agents you want to support from the local Windows monitoring server to the nonlocal monitoring server. If
you use ftp, copy the files in ASCII format. The .cat and .atr files are located in the following directories on
the local monitoring server:
v .cat files are located in install_dir\cms\RKDSCATL
212
v .atr files are located in install_dir\cms\ATTRIB

Copy the files to the following directories on the remote computer:
Table 46. Locations of CAT and ATR files for the monitoring server
Remote computer on: File type
Directory
Windows
.cat
install_dir\cms\RKDSCATL
.atr
install_dir\cms\ATTRIB
.cat
install_dir/tables/cicatrsq/RKDSCATL
.atr
install_dir/tables/cicatrsq/ATTRIB
Linux or UNIX
where install_dir specifies the IBM Tivoli Monitoring installation directory. The IBM Tivoli Monitoring
installation directory is represented by the %CANDLE_HOME% (Windows) or $CANDLEHOME (Linux and
UNIX) environment variable. The default installation directory on Windows is \IBM\ITM. The default
installation directory on Linux and UNIX is /opt/IBM/ITM.
Notes:
1. If you export the CANDLEHOME environment variable to your current session, many of the installation
and configuration commands do not require that CANDLEHOME be passed to them (usually via the -h
CLI parameter).
2. If you are adding support to a monitoring server on z/OS, you can use the FTP utility provided with
Manage Tivoli Enterprise Monitoring Services. See IBM Tivoli Management Services on z/OS:
Configuring the Tivoli Enterprise Monitoring Server on z/OS for instructions.
3. If you specify an incorrect directory name, you will receive the following error:
Adding application support (SQL files) to a nonlocal hub: If you are adding application support to a
nonlocal hub monitoring server, you must add the SQL files used by the EIB, in addition to the catalog and
attribute files. Use the following procedure to seed the hub with SQL files using the Manage Tivoli
Enterprise Monitoring Services utility on your local Windows system:
1. Ensure that the hub monitoring server is started.
2. In the Manage Tivoli Enterprise Monitoring Services window, select Actions > Advanced > Add
TEMS application support.
3. On the Add Application Support to the TEMS window, Select On a different computer and click OK.
4. When you are prompted to ensure that the hub monitoring server is configured and running, click OK.
5. On the Non-Resident TEMS Connection window, provide the hub monitoring server TEMS name
(node ID) and select the communication protocol to use in sending the application support SQL files
to the hub monitoring server.
6. On the next window, provide any values required by the communication protocol.
For example, if the protocol is IP.PIPE, you are prompted for the fully qualified TCP/IP host name and
port number of the z/OS system where the monitoring server is installed. See for the values you
recorded during installation planning.
7. On the Select the Application Support to Add to the TEMS window, select the products for which you
want to add application support or click Select All to choose all available products. Click OK.
213
The SQL application support files are added to the hub monitoring server. This might take several
minutes.
8. The Application Support Addition Complete window shown in Figure 28 on page 204 gives you
information about the status and location of the application support SQL files. Click Save As if you
want to save the information in a text file. Click Close to close the window.
If the Application Support Addition Complete window is not displayed after 20 minutes, look in the
IBM\ITM\CNPS\Logs\seedkpp.log files (where pp is the two-character code for each monitoring agent)
for diagnostic messages that help you determine the cause of the problem.
9. If the monitoring server is not already stopped, stop it.
10. Restart the monitoring server.
Configuring application support on a nonlocal monitoring server from a Linux or

UNIX system
This section describes how you can install and enable application support on a nonlocal monitoring server
from your local Linux or UNIX system. The nonlocal monitoring server can be a hub or remote monitoring
server installed on a Windows, Linux, or UNIX system.
Before you begin:
v As a prerequisite, you must install a monitoring server, a portal server or a monitoring agent on the local
Linux or UNIX computer. This step is necessary to make the Manage Tivoli Enterprise Monitoring
Services available on the local computer. If you do not have a monitoring server, you must install the
support files on the local computer using the procedure described in Installing application support files
on a computer with no monitoring server on page 217.
v Determine which monitoring agents you want to support on the nonlocal monitoring server. Ensure that
the application support files (.cat, .atr, and .sql files) for those agents are available on the local
monitoring server:
Application support files are located in the following directories on a Linux or UNIX monitoring server:
Table 47. Locations of application support files on a Linux or UNIX monitoring server
File type
Directory
.cat
.atr
.sql
install_dir/tables/cicatrsq/SQLLIB
The file names of the application support files have the following format:
kpc.ext
where pc is the product code for the agent and ext is the file extension.
For example, kud.sql is the SQL support file for the DB2 for the workstation monitoring agent. See
Appendix D, IBM Tivoli product, platform, and component codes, on page 567 for a list of product
codes.
If you cannot find application support files for some agents for which you want to install application
support, install the missing files on this computer.
- To install missing support files for base monitoring agents, follow the installation steps described in
Installing the monitoring server on page 153.
- To install missing files for nonbase monitoring agents, follow the installation steps described in
Linux or UNIX: Installing application support on a monitoring server on page 204.
- If no monitoring server is installed on this computer, use the procedure in Installing application
support files on a computer with no monitoring server on page 217.
v Gather the following information about the monitoring server on the remote computer:
The host name or IP address
214
v
v
v
The protocol and port number that was specified when the monitoring server was configured
The monitoring server on the remote computer must be configured to use the IP.UDP, IP.PIPE, or
IP.SPIPE communications protocol. This procedure does not support a monitoring server that was
configured to use SNA.
Verify that the monitoring server on the remote computer is running.
Verify that the hub monitoring server to which this remote server sends its data is running.
In these instructions, install_dir specifies the IBM Tivoli Monitoring installation directory. You can enter
either $CANDLEHOME or the name of the directory. The default installation directory on Linux and
UNIX is /opt/IBM/ITM.
If you are running in a Hot Standby environment, shut down your Hot Standby (that is, mirror)
monitoring server before completing this procedure. You may restart the Hot Standby monitoring server
only after you have seeded the hub server.
Copying the CAT and ATR files to the nonlocal monitoring server: Copy the .cat and .atr files for the
agents you want to support from the local Linux or UNIX monitoring server to the nonlocal monitoring
server. If you use FTP, copy the files in ASCII format. The .cat and .atr files are located in the following
directories on the local monitoring server:
v CAT files are located in install_dir/tables/cicatrsq/RKDSCATL
v ATR files are located in install_dir/tables/cicatrsq/ATTRIB
Copy the files to the directory shown in Table 48 on the remote computer:
Table 48. Locations of CAT and ATR files for the monitoring server
Remote computer on: File type
Directory
Windows
.cat
install_dir\cms\RKDSCATL
.atr
install_dir\cms\ATTRIB
.cat
.atr
Linux or UNIX
where install_dir specifies the IBM Tivoli Monitoring installation directory. The IBM Tivoli Monitoring
installation directory is represented by the %CANDLE_HOME% (Windows) or $CANDLEHOME (Linux and
UNIX) environment variable. The default installation directory on Windows is \IBM\ITM. The default
installation directory on Linux and UNIX is /opt/IBM/ITM.
Notes:
1. If you are installing support on a z/OS monitoring server, you can use the FTP utility provided by
Manage Tivoli Enterprise Monitoring Services to copy the .cat and .atr files. See IBM Tivoli
Management Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS for
instructions.
2. If you specify an incorrect directory name, you will receive the following error:
If the nonlocal monitoring server to which you are adding application support is a hub, you must also
install the SQL files used by the EIB. See Adding application support (SQL files) to a nonlocal hub.
Adding application support (SQL files) to a nonlocal hub: To add application support SQL files to a
hub monitoring server on a nonlocal system, complete this procedure.
215
1. Enable the GUI interface.

Your Linux or UNIX environment might already have a GUI interface enabled. Otherwise, perform the
following tasks to enable it:
a. Enable X11.
b. Make sure you have access to a native X-term monitor or an X-Window emulator.
c. If using an X-Window emulator, enable X11 access to the X-Window server (command example:
xhost +).
d. If using an X-Window emulator, set the display environment variable to point to the X-Window
server:
export DISPLAY=pc_ip_address:0
2. Ensure that the hub monitoring server is running.

3. To start Manage Tivoli Enterprise Monitoring Services, go to the $CANDLEHOME bin directory
(example: /opt/IBM/ITM/bin ) and run this command:
./itmcmd manage &
A GUI window opens for Manage Tivoli Enterprise Monitoring Services.

4. Select Actions > Install Product Support.
Figure 30. Manage Tivoli Enterprise Monitoring Services Install Product Support window
5. On the Add Application Support to the TEMS window, select On a different computer and click OK.
6. When you are prompted to ensure that the hub monitoring server is configured and running, click OK.
216
7. On the Non-Resident TEMS Connection window, provide the hub monitoring server name (node ID)
and select the communication protocol to use in sending the application support SQL files to the hub
monitoring server.
8. Select the appropriate communications protocol and click OK.
9. On the next window, supply any values required by the selected communication protocol and click
OK.
10. On the Install Product Support window, select the monitoring agents for which you want to add
application support to the hub monitoring server, and click Install.
11. In Manage Tivoli Enterprise Monitoring Services, look for this message:
Remote seeding complete!
12. Stop and restart the hub monitoring server.

Installing application support files on a computer with no monitoring server: You can install
application support files for a monitoring server on a UNIX or Linux computer where no monitoring server
is installed and then use the files to configure support on a nonlocal monitoring server. Use the following
procedure to install application support files on computer on which no monitoring server is installed for use
on a monitoring server on another computer:
1. Run the following command from the installation media, either the IBM Tivoli Monitoring base media,
the agent product CD for distributed agent products or the data files CD for z/OS agent products:
./install.sh
The following prompt is displayed:
1)
2)
3)
4)
Install products to the local host.

Install products to depot for remote deployment (requires TEMS).
Install TEMS support for remote seeding
Exit install.
3. Type 3 and press Enter.

4. Read through the software license agreement, then type 1 and press Enter to accept the agreement.
The installer presents a list of currently installed products, the operating systems for which product
packages are available, and component support categories.
5. Type the 32-character encryption key to use and press Enter, or press enter to use the default key.
This key must be the same key as that used during the installation of the portal server to which the
client will connect.
The installer presents a list of products for which support packages are available.
6. Enter the numbers of the monitoring agents that you want to install or enter the number that
corresponds to All of the above. Enter more than one number on the same line separated by spaces
or commas (,).
7. Confirm the selection by pressing Enter.
The installer asks if you want to install additional products or support packages.
8. Type 2 and press Enter.
The support packages are installed. When installation is complete, you will see the message
... finished postprocessing.
Installation step complete.
217
Installing language packs

Language support for products for which application support is provided with IBM Tivoli Monitoring appears
on the following media:
v IBM Tivoli Monitoring V6.2.2 Language Support 1 of 3 DVD: French, German, Italian, Portuguese
Brazilian, Spanish.
v IBM Tivoli Monitoring V6.2.2 Language Support 2 of 3 DVD: Japanese, Korean, Simplified Chinese,
Traditional Chinese.
v
v
v
v
v
v
IBM Tivoli Monitoring V6.2.2 Language Support 3 of 3 DVD: Czech, Hungarian, Polish, Russian
IBM Tivoli Monitoring V6.2.2 DM Upgrade Toolkit Language Support CD
IBM Tivoli Monitoring V6.2.2 ITM 5.1.2 Migration Toolkit Language Support CD
IBM Tivoli Monitoring V6.2.2 Agent Builder Toolkit Language Support CD
IBM Tivoli Monitoring Agents for System P Language Support CD
Agent product installation CDs
The IBM Tivoli Monitoring V6.2.2 Language Support DVDs contain the national language versions of the
help and presentation files for the components and agents listed in Table 49.
Table 49. Language support included on IBM Tivoli Monitoring V6.2.2 Language Support DVDs
Product code
Component or product name
HD
Warehouse Proxy Agent
SY
Warehouse Summarization and Pruning Agent
NT
Monitoring Agent for Windows OS
LZ
Monitoring Agent for Linux OS
UX
Monitoring Agent for UNIX OS
UL
Monitoring Agent for UNIX Logs
UM
TM
Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint
P5
IBM Tivoli Monitoring for AIX Base Agent
PX
Premium Monitoring Agent for AIX
PH
Base Monitoring Agent for HMC
PK
Base Monitoring Agent for CEC
PV
IBM Tivoli Monitoring for VIOS Base Agent
VA
Premium Monitoring Agent for VIOS
Language support for the products found on the IBM Tivoli Monitoring V6.2.2 Tools DVD is available on
the following CDs:
v IBM Tivoli Monitoring V6.2.2: Language Support for Distributed Monitoring Toolkit CD
v IBM Tivoli Monitoring V6.2.2: Language Support for Migration Toolkit CD
v IBM Tivoli Monitoring V6.2.2: Language Support for Agent Builder CD
Language support for all other distributed agents, including those agents for which application support is
included on the Base DVD, is included with the installation media for the individual agent. For the
OMEGAMON XE monitoring agents on z/OS, the installation media for the agents are mainframe tapes,
which don't include the language packs; as with the distributed agents, language support is provided on a
separate CD or DVD.
218
Install the language packs on any system where you have installed the Tivoli Enterprise Portal or where
you have installed a desktop client. (If you download and run a desktop client using Web Start, you do not
need to install the language packs on the local system. They are downloaded from the portal server.)
Before you can install a language pack, you must install the component in English.
Before installing a language pack, first install the component in English. Also ensure that Java Runtime
Environment version 1.5 or above is installed and set in the system path. The follow the following steps to
install a language pack on any system where you have installed either the Tivoli Enterprise Portal Server
or the Tivoli Enterprise Portal desktop client:
1. In the directory where you extracted the language pack installation image, launch the installation
program as follows:
v On Windows, double-click the lpinstaller.bat file.
v On Linux and UNIX, run the following command:
./lpinstaller.sh -c install_dir
where:
install_dir
is the directory where you installed IBM Tivoli Monitoring (usually /opt/IBM/ITM).
To perform a console installation on Linux or UNIX (instead of a GUI installation), add the -i
console parameter to the above command.
2. Select the language you want installed, and click OK.
3. On the Introduction panel, click Next.
4. On the Select Action Set panel, click Add/Update, and click Next.
5. Select the folder in which the Language Support package files (win*.jar and unix*.jar) are located,
and click Next. The default folder is the directory where the installer is launched.
6. Select the languages that you want to install, and click Next.
For multiple selections, hold down the Ctrl key.
7. Review the installation summary, and, if correct, click Next.
The installation's progress is displayed.
8. On the Post Install Message panel, click Next.
9. Click Done once the installation is complete.
10. Reconfigure and restart the Tivoli Enterprise Portal Server and the Eclipse Help Server. See below.
After installing a Tivoli Monitoring V6.2.2 Language Pack, reconfigure the portal server and the desktop
client using either the Manage Tivoli Enterprise Monitoring Services utility or the itmcmd config command.
Use one of the following methods to reconfigure the affected components:
v Launch Manage Tivoli Enterprise Monitoring Services, right-click the affected component, and select
Reconfigure. (See Starting Manage Tivoli Enterprise Monitoring Services on page 261.)
v Change to the install_dir/bin directory, and enter the following commands:
Accept the default values, which reflect the decisions made when the component was installed or last
configured. For instructions on specifying your users' language environment, see the IBM Tivoli Monitoring:
After you have reconfigured these components, you need to stop and restart these components:
v Tivoli Enterprise Portal desktop or browser client
219
For SuSE Linux Enterprise Server (SLES) 10 computers only: On the SLES 10 platform, the Tivoli
Enterprise Portal displays corrupted text resources in the Japanese locale. Download the Kochi fonts
contained in the kochi-substitute-20030809.tar package from the following Web site: http://sourceforge.jp/
projects/efont/files/.
The downloaded tar file includes the truetype fonts (ttf files), which need to be installed on your system.
Complete the following steps to install the files:
1. Extract the tar file.
2. Copy the font files (ttf) to X11 font path (for example, /usr/X11R6/lib/X11/fonts/truetype).
3. Run SuSEconfig -module fonts.
Refer to the following Web site for detailed instructions for installing the additional fonts to SuSE Linux:
http://www.suse.de/~mfabian/suse-cjk/installing-fonts.html .
Uninstalling a language pack

To uninstall a language pack:
1. In the directory where you extracted the language pack installation image, launch the installation
program as follows:
v On Windows, double-click the lpinstaller.bat file.
v On Linux and UNIX, run the following command:
./lpinstaller.sh -c install_dir
where:
install_dir
is the directory where you installed IBM Tivoli Monitoring (usually /opt/IBM/ITM).
To perform a console installation on Linux or UNIX (instead of a GUI installation), add the -i
console parameter to the above command.
2. Select the language to be uninstalled, and click OK.
3. On the Introduction panel, click Next.
4. On the Select Action Set panel, click Remove, and click Next.
5. Select the languages that you want to uninstall, and click Next.
For multiple selections, hold down the Ctrl key.
6. Review the installation summary, and, if correct, click Next.
7. On the Post Install Message panel, click Next.
8. Click Done once the uninstallation is complete.
9. Reconfigure and restart the Tivoli Enterprise Portal Server and the Eclipse Help Server, as described
above.
Configuring clients, browsers, and JREs

The configuration required for Tivoli Enterprise Portal clients depends upon the client deployment mode
being used, the browser being used, the Java runtime environment (JRE) being used, and the operating
system the client is being used on.
The following sections discuss the configuration for clients by mode of deployment:
v Desktop clients on page 221
v Browser clients on page 221
v Java Web Start clients on page 229
220
The version of IBM JRE required by Tivoli Enterprise Portal clients is installed with Tivoli Management
Services components. If you want to run a client on a machine where no other components are installed,
you can download the IBM JRE installer from the Tivoli Enterprise Portal Server (see Installing the IBM
JRE on page 233). The IBM JRE must be installed as the system JVM.
The packaging, installation, and servicing of the Sun JRE is not provided by IBM. The Sun JRE at version
1.5.0_xx or 1.6.0.xx must already be installed on the machines where the Tivoli Enterprise Portal client will
run. The Sun JRE can be downloaded from the following Web site: http://www.java.com/getjava. For
help installing the Sun JRE and enabling and configuring its Java plug-in on Linux, visit the following Web
site: http://www.java.com/en/download/help/5000010500.xml.
Support for the Sun JRE is a feature of the Tivoli Enterprise Portal client only; installation and use of the
IBM JRE is still required for the Tivoli Enterprise Portal Server and some other Tivoli Management
Services components.
As of IBM Tivoli Monitoring 6.2.2, the installer no longer modifies the system JRE. Instead it installs a local
copy of Java, one that is private to Tivoli Monitoring. This applies to all Java-dependent Tivoli Monitoring
components, including those at a pre-6.2.2 level.
This embedded JRE is installed in the %CANDLE_HOME%\java directory. The system Java is untouched by the
IBM Tivoli Monitoring installer; you can remove it yourself if you desire.
The exceptions are the Tivoli Enterprise Portal Server and the eWAS server, which use the embedded
JVM delivered as part of the eWAS component. Also, the browser client and Java Web Start still use the
system JRE. For your convenience, the system JRE installation image is still distributed as part of the
browser client package.
The desktop client uses the new, embedded JVM.
The IBM Tivoli Monitoring installer does not install an embedded JVM if none of the components selected
for installation has a Java dependency.
Desktop clients
You do not need to configure the desktop client if:
v You want the client to use the IBM JRE, or
v The SUN JRE is the only JRE installed on the computer
You must configure the client start-up script with the location of the JRE if:
v Both IBM and Sun JREs are installed on the computer and you want to use the Sun JRE, or
v You have multiple versions of the Sun JRE installed and you want to specify a particular version
On Windows computers, add a user-level environment variable named TEP_JAVA_HOME whose value is
the fully qualified directory location of the Sun JRE you want to use. For example, TEP_JAVA_HOME=C:\
Program Files\Java\jre1.5.0_15\bin\. On UNIX and Linux computers, define the same environment
variable with the fully qualified location of the Sun JRE you want to use for the Tivoli Enterprise Portal
desktop client.
Browser clients
Configuration for browser clients involves the following steps:
v Registering the Java plug-in on page 224
When the browser client connects to the Tivoli Enterprise Portal Server, it downloads a Java applet.
Java applets that run in a browser environment use Java plug-in technology. The applet plug-in must be
registered with the browser to establish and initialize an appropriate Java runtime environment for the
applet to execute in.
221
On Linux and UNIX, the plug-in must be manually registered with the browsers; on Windows, the Java
installer automatically registers the associated Java plug-in with both Internet Explorer and Firefox. After
installation, a plug-in can be de-registered from a given browser selectively using the Java control panel
(see Removing the Java plug-in on Windows on page 226).
v Specifying runtime parameters for the plug-in on page 225
Several runtime parameters should be specified before the browser client is started to allocate enough
memory for the Tivoli Enterprise Portal applet and decrease the startup time.
If you are using Internet Explorer under Windows, you must complete an additional step to use the Sun
JRE:
v Identifying the version of the Sun JRE the client should use on page 226
Conflicts in plug-in registration can sometimes occur if both IBM and Sun JREs are installed on Windows.
You can resolve such problems by de-registering the plug-in in the browsers:
v Removing the Java plug-in on Windows on page 226
222
Firefox tips
v Unlike Internet Explorer, Firefox does not automatically load the current URL into a new window.
If you want to invoke multiple copies of the Tivoli Enterprise Portal browser client, copy the full
URL from the first window to the second window. Do not load the initial http://
hostname:1920///cnp/kdh/lib/cnp.html URL, because that will not work.
v To use the browser's tab support when opening workspaces in the browser client, you may
need to configure the browser to force links that otherwise open in new windows to open
instead in new tabs. Refer to your browser's instructions for customizing tab preferences. This is
true for Internet Explorer version 7 (and subsequent) as well as Mozilla Firefox.
Reuse of existing tabs is supported only with the Firefox browser. This means if you have a
workspace open in an unfocused tab and from your currently focused tab you select the same
workspace to open in a new tab, the unfocused tab is refocused, and the workspace is reloaded
there. To allow this support:
1. Enter about:config in the address bar, and press Enter.
2. Find the preference signed.applets.codebase_principal_support, and change the value to
true. (Or double-click the preference name to toggle its value.)
3. The first time you attempt to reuse an existing tab, the menu shown in Figure 31 on page
224 might display. If so, add a checkmark to the box Remember this decision, and press
Allow.
If you do not allow this tab reuse, a new tab is opened each time you open a new workspace.
Tip: To open a workspace in a new tab using either Firefox or Internet Explorer, press
Shift+Ctrl while selecting the workspace. This always opens a new tab whether or not your
browser is set to reuse existing tabs.
v If the Firefox process dies unexpectedly on Linux, you may need to also kill the Java process
that is spawned when the Java plug-in is started. If you do not kill the Java process,
subsequent startups of the Tivoli Enterprise Portal client in a new Firefox browser may be very
slow.
If you are running the browser client with the IBM JRE, issue the following command to find the
errant Java process:
ps aef | grep plugin
If you find a process similar to the following, kill it:

java -Dmozilla.workaround=true
-Xbootclasspath/a:/opt/candlehome/7277c/JRE/li6263/lib/javaplugin.jar
:/opt/candlehome/7277c/JRE/li6263/lib/deploy.jar -Djavaplugin.lib=
/opt/candlehome/7277c/JRE/li6263/bin/libjavaplugin_jni.so
-Djavaplugin.nodotversion=150 -Djavaplugin.version=1.5.0
-DtrustProxy=true -Xverify:remote -Djava.class.path=/opt/candlehome/7277c
/JRE/li6263/lib/applet sun.plugin.navig.motif.Plugin
If running the browser client with the Sun JRE, the errant Java process is called java_vm.
223
Figure 31. Firefox Security Warning
Registering the Java plug-in

Under Linux, you register the Java plug-in by creating a symbolic link to the Java plug-in in the browser
plugins directory. On Windows, you can use the Java control panel to ensure that the plug-in is
associated with the appropriate browser.
To create and test the symbolic link to the plug-in on Linux, take the following steps:
1. Find the path to the Java plug-in file:
cd jre_install_dir
find -name "libjavaplugin_oji.so" -print
Note: For the Sun JRE, you may find two plugin files. For example:
./plugin/i386/ns7/libjavaplugin_oji.so
./plugin/i386/ns7-gcc29/libjavaplugin_oji.so
Use only ns7-gcc29 if the browser was compiled with gcc2.9.

2. Change to the plugins subdirectory under the browser installation directory:
cd browser_install_dir/plugins
3. Create a soft link to the Java plug-in file:

ln -s jre_install_dir/java_plugin_file_path
4. Verify that the soft link has been set up correctly:

a. Start the browser.
b. Type about:plugins in the Location bar to confirm that the Java plug-in has been correctly
installed.
To show the full path to the plug-in instead of just the file name, type about:config in the address
bar and press Enter. Find the preference plugin.expose_full_path and change the value to true.
(Double-clicking the preference name toggles the setting.)
On Windows, to verify that the desired plug-in is registered, complete the following steps:
1. Launch the appropriate Control Panel from the Windows Control Panel folder (either IBM Control Panel
for Java or Java Control Panel).
2. Select the Advanced tab.
3. Expand the branch labeled APPLET tag support.
4. Ensure that the appropriate browser option box is checked.
224
5. If you make any changes, press Apply and exit the panel.
Specifying runtime parameters for the plug-in

You specify the runtime parameters for the Java applet using the control panel for the appropriate JRE.
Use the same user ID from which the browser will be launched to launch the control panel and specify
these parameters, or the user-level deployment.properties file for the correct user ID will not be updated.
To specify the runtime parameters, take the following steps:
1. Launch the Java control panel:
v On Windows, launch the IBM Control Panel for Java, or the Java Control Panel.
v On Linux, Find the Java ControlPanel executable under your jre_install_dir and launch it. For
example:
/opt/IBM/ibm-java2-i386-50/jre/bin/ControlPanel
2. If you have multiple Java versions, verify that you have the correct control panel open by confirming
the Java Runtime and that the JRE is in the correct path (for example, c:\program
files\IBM\Java50\jre\bin for IBM Java on Windows). To verify, click on the Java(TM) tab and check
the Location column for the JRE.
3. Set the Java Runtime Parameters:
a. Click the Java tab.
b. Click the Java Applet Runtime Settings View button.
c. Click in the Java Runtime Parameters field and set the following parameters:
v IBM JRE: -Xms128m -Xmx256m -Xverify:none
-Djava.protocol.handler.pkgs=sun.plugin.net.protocol
v Sun JRE: -Xms128m -Xmx256m -Xverify:none
The -Xms128m specifies the starting size of the Java heap (128 MB) and -Xmx256m specifies the
maximum size. The -Xverify:none parameter disables Java class verification, which can
increase startup time.
The Djava.protocol.handler.pkgs option required only for the IBM JRE on Linux due to a
problem with the plug-in not caching jar files. If the parameter is left off, the Tivoli Enterprise
Portal applet jar files will not be cached, making subsequent start ups of the applet slow.
d. Click OK.
4. Confirm that the Temporary Files settings are set to Unlimited:
a. Click the General tab.
b. Click Settings.
c. Select Unlimited for the Amount of disk space to use.
d. Click OK.
5. Clear the browser cache:
a. In the General tab, click Delete Files.
b. In the window that opens, select Downloaded Applets and click OK.
The Sun JRE does not always support the same maximum heap values as the IBM JRE. The true
maximum is calculated based on the resources available on the particular machine being configured, and
the algorithm that is involved is different between the two JREs. The symptom of a memory problem is
that the applet fails to load in the browser, and you receive a message similar to the following:
225
Figure 32. Java memory error message
To resolve this problem, reduce the value of the maximum heap setting in the Java Control panel in 32m
or 64m increments until the error goes away. For example, if you start with the recommended value of
-Xmx256m try reducing it to -Xmx224m or -Xmx192m. Eventually you will reach a value that is appropriate for
the particular machine involved.
Identifying the version of the Sun JRE the client should use
If you are using Internet Explorer for the Tivoli Enterprise Portal browser client, and you want to use the
Sun JRE, you must identify to the Tivoli Enterprise Portal Server the version of the JRE you want the client
to use.
To identify the version, update the file jrelevel.js found in the \itm_install_dir\CNB directory (Windows)
or itm_install_dir/arch/cw (Linux) on the computer where the portal server is installed. Assign a valid
value to the following declared variable:
var jreLevel = "1.5.0"
The supported values are:

*
The browser client will use the default JRE for the computer.
1.5.0
The browser client will use the IBM 1.5 JRE (the default as shipped).
5.0
The browser client will use the latest Sun 1.5.0_xx JRE installed.
6.0
The browser client will use the latest Sun 1.6.0_xx JRE installed.
Removing the Java plug-in on Windows

When either the IBM JRE or the Sun JRE is installed on Windows, the Java installer automatically
registers the associated Java plug-in with both Internet Explorer and Firefox. Plug-in registration conflicts
sometimes occur on Windows when both JREs are installed. The symptoms usually involve one of the
following messages being displayed when you launch the Tivoli Enterprise Portal client:
Java Plug-in detected JRE collision
or
Applet(s) in this HTML page requires a version of java different from the one
the browser is currently using. In order to run the applet(s) in this HTML page,
a new browser session is required.
Press 'Yes to start a new browser session.
The solution is to de-register the plug-in.

To de-register the Java plug-in take the following steps:
1. Launch the IBM Control Panel for Java or the Sun Java Control Panel from the Windows Control Panel
folder.
3. Expand the branch entitled APPLET tag support.
There should be two entries, one for "Internet Explorer" and one for "Mozilla and Netscape". Normally,
after installation of Java, both of these boxes will be checked, meaning that the associated Java
plug-ins for those browsers have been registered. Figure 33 on page 227 shows the IBM Control Panel
226
for Java; the Sun version is almost identical.
Figure 33. Java Control Panel window
If you encounter problems loading Tivoli Enterprise Portal using Firefox, this is one of the first panels
you should look at to ensure that the Java plug-in has indeed been registered. Often, a quick way to
resolve any registration problems is to simply remove the check mark (if already on), press Apply,
then check the box again, and again press Apply. This action will switch the option off and on so that
the plug-in registration is reset and the correct Windows registry entries get re-established.
4. Remove the check mark from the box for the browser or browsers you want to unregister.
Support for Sun Java 1.6.0_10 or higher with browser clients on Windows
With Sun Java versions 1.6.0_10 and higher, a new plug-in architecture was introduced and established as
the default plug-in. This support enables an applet-caching feature called legacy lifecycle that, coupled
with use of the Sun 1.6 JRE, significantly increases performance of the Tivoli Enterprise Portal browser
client after it has been downloaded. Performance measurements using this configuration show that, with
legacy lifecycle, performance of the browser client is virtually identical to that of the desktop and Java Web
Start deployment modes.
IBM Tivoli Monitoring browser clients do not automatically run with this new plug-in architecture. To use the
Sun 1.6.0_10 (or higher) JRE, before launching the browser you must enable the legacy_lifecycle
parameter in the applet.html file on the computer where the Tivoli Enterprise Portal Server is installed.
v On Windows, launch Manage Tivoli Enterprise Monitoring Services.
1. Right-click Browser Task/SubSystem, and select Reconfigure.
2. Locate the legacy_lifecycle parameter, and double-click the line to bring up the edit dialog.
3. Change the value to true, and check the In Use box.
4. Click OK.
5. Click OK again to save your changes.
v On Linux and AIX, edit the applet.html file in the itm_home/platform/cw branch, where platform is a
string that represents your current operating system.
1. Locate this line:
document.writeln( '<PARAM NAME= "legacy_lifecycle" VALUE="false">' );
2. Change the parameter value to true.

227
3. Save and close applet.html.

Note: Browser clients are supported on Windows only for Internet Explorer 6.x or higher.
If you do not change the configuration correctly, the browser client will terminate, and you may see the
server-connection error shown in Figure 34.
Figure 34. Server connection error, Tivoli Enterprise Portal browser client
Required maintenance: To use Sun Java 1.6.0_10 or higher with any IBM Tivoli Monitoring V6.2,
V6.2.1, or V6.2.2 portal client (browser, Java Web Start, desktop), the following APAR is required:
IZ41252. APAR IZ41252 is included in the following maintenance deliveries:
ITM6.2 fixpack 3 and subsequent
ITM6.2.1 interim fix 3 and subsequent
ITM6.2.2 (GA release) and subsequent maintenance
Note: At this time Mozilla Firefox is not officially supported for the portal client running in browser (applet)
mode if Sun Java 1.6.0_10 or higher is used. Mozilla Firefox is supported with both Sun Java
1.6.0_07 or lower and IBM Java 1.5.0, which is currently shipped with IBM Tivoli Monitoring
versions 6.2, 6.2.1, and 6.2.2.
228
Java Web Start clients

No configuration is required if the correct Java Web Start loader is used.
The Tivoli Enterprise Portal client is typically deployed via Java Web Start by entering the following
address in the browsers location field:
http://teps_host:1920///cnp/kdh/lib/tep.jnlp
Under Windows, the last JRE installed on the machine usually controls which Java Web Start loader is
associated with the Java Web Start deployment files, which have the extension .jnlp. If the Sun JRE was
the last JRE installed, the Sun Java Web Start loader and associated JRE will be used for the Tivoli
Enterprise Portal client. If both IBM and Sun Java are installed on the same machine and the IBM JRE
was installed last, it may be necessary to manually re-associate the .jnlp extension with the Sun JRE.
To verify that the loader is associated with the correct JRE:
1. Launch Folder Options from Windows Control Panel folder.
2. Select the File Types tab.
3. Find and select the JNLP file type in the list of registered file types.
4. Click the Advanced button, select the Launch action, and click the Edit... button.
5. If the javaws.exe (the Java Web Start loader) is not associated with the correct JRE installation path,
use the Browse button to locate and select the correct path.
Note to users of the single sign-on feature: If you have enabled single sign-on and your users start the
portal's browser client via Java Web Start, a special URL is
required:
http://tep_host:15200/LICServletWeb/LICServlet
Note that the servlet that supports single sign-on for the
enterprise portal's Java Web Start client requires that port
15200 be open on the portal server.
For further information about single sign-on, see either
Support for single sign-on for launch to and from other
Tivoli applications on page 14 or the IBM Tivoli Monitoring:
For more information on using and configuring Java Web Start client and setting up its environment, see
Using Web Start to download and run the desktop client on page 233.
Specifying the browser used for online help

If you are running the desktop client on Linux, or you want to view the online help with some browser
other than Internet Explorer on Windows, you must specify to the portal server the location of the browser
you want to use.
v Windows: Specifying the browser location
v UNIX and Linux: Specifying the browser location on page 230
v Web Start: Specifying the browser location on page 231
Windows: Specifying the browser location

Use the Manage Tivoli Enterprise Monitoring Services utility to change the location of the browser that the
browser or desktop client uses.
1. Launch Manage Tivoli Enterprise Monitoring Services (Start > (All) Programs > IBM Tivoli
Monitoring > Manage Tivoli Monitoring Services).
229
2. In the Manage Tivoli Enterprise Monitoring Services window, right-click the browser or desktop client
and select Reconfigure.
The Configure the Tivoli Enterprise Portal Browser window is displayed. (If you are configuring the
desktop client, the Configure Application Instance window is displayed.)
3. Scroll down in the list of variables until you see the kjr.browser.default variable.
4. Double-click kjr.browser.default.
The Edit Tivoli Enterprise Portal Browser Parm window is displayed.
5. In the Value field, type the path and the application name of the alternative browser application. For
example:
C:\Program Files\Mozilla Firefox\firefox.exe
6. Check the In Use box.

7. Click OK to close the editing window and save the change.
8. Click OK to close the reconfiguration window.
UNIX and Linux: Specifying the browser location

To change a property such as the location of the Web browser that the Tivoli Enterprise Portal browser
client launches in UNIX, update the shell script file or files that are run and the template that is used when
the browser client is configured to create the script file or files that are run. You might have to update one
or more of the files list in Table 50:
Note: All file paths are relative to your install_dir directory where you installed IBM Tivoli Monitoring.
Table 50. File locations for changing application properties for UNIX and Linux
File location
Purpose of file
bin/cnp.sh
The default shell script that launches the Tivoli Enterprise

Portal browser client.
bin/cnp_instance.sh
The shell script for a specific instance you have created,

where instance is the name of the instance that launches
the Tivoli Enterprise Portal browser client.
platform/cj/original/cnp.sh_template
The template from which the bin/cnp.sh and

bin/cnp_instance.sh shell scripts are generated during
configuration, where platform is the code for the operating
system platform on which IBM Tivoli Monitoring is
installed. For example: li6243 for Linux 2.4 on a 32-bit
Intel CPU).
If you change only bin/cnp.sh or bin/cnp_instance.sh
and do not change this template, the next time you
configure the client, a new version of the script is created
without the changes you made to bin/cnp.sh or
bin/cnp_instance.sh.
To change the location of the Web browser you must change the above file or files to include a new
property:
1. Go to the install_dir/bin/cnp.sh and edit the cnp.sh shell script.
2. Add your Web browser location to the last line of the file. In the example below, the Web browser
location is /opt/foo/bin/launcher. -Dkjr.browser.default=/opt/foo/bin/launcher
Important: The line is very long and has various options on it, including several other D options to
define other properties. It is very important to add the option in the correct place.
If the last line of your bin/cnp.sh originally looked like the following:
230
${JAVA_HOME}/bin/java -showversion -noverify -classpath ${CLASSPATH}

-Dkjr.trace.mode=LOCAL -Dkjr.trace.file=/opt/IBM/ITM/logs/kcjras1.log
-Dkjr.trace.params=ERROR -DORBtcpNoDelay=true -Dcnp.http.url.host=
-Dvbroker.agent.enableLocator=false
-Dhttp.proxyHost=
-Dhttp.proxyPort=candle.fw.pres.CMWApplet 2>& 1 >> ${LOGFILENAME}.log
To set the browser location to /opt/foo/bin/launcher, change the line to look like the following:
-Dkjr.browser.default=/opt/foo/bin/launcher
-Dhttp.proxyHost=
Web Start: Specifying the browser location

Java Web Start deployed applications are described in jnlp deployment files. For IBM Tivoli Monitoring,
there is one deployment file that describes the core Tivoli Enterprise Portal framework component and
associated jar files, and one deployment file for each and every Tivoli Enterprise Portal-based monitoring
solution that is installed. The core Tivoli Enterprise Portal Server deployment file is named tep.jnlp. The
application deployment file is typically called kxx_resources.jnlp or kxx.jnlp, where xx is the application
identifier (a product code, such as nt, ux, or lz).
v On a Windows computer where the Tivoli Enterprise Portal Server is installed, the file is located in
itminstall_dir\CNB (for example, c:\IBM\ITM\CNB).
v On a Linux computer where the Tivoli Enterprise Portal Server is installed, the file is located in
itminstall_dir/arch/cw (for example, /opt/IBM/ITM/li6263/cw).
The deployment file instances are generated whenever the Tivoli Enterprise Portal Server is installed or
reconfigured (for example, when adding a new monitoring solution to the environment). The contents of
these files are based upon two template deployment files (.jnlpt). The core Tivoli Enterprise Portal template
deployment file is called tep.jnlpt. The application template deployment file is named component.jnlpt.
v On a Windows computer where the Tivoli Enterprise Portal is installed, the file is located in
itminstall_dir\Config (for example: c:\IBM\ITM\Config).
v On a UNIX computer where the Tivoli Enterprise Portal is installed, the file is located in
itminstall_dir/config (for example, /opt/IBM/ITM/config).
1. To add or modify JVM arguments (such as maximum heap size) or other Tivoli Enterprise Portal-based
properties (such as RAS1 trace options), you must edit either the tep.jnlp deployment file or the
tep.jnlpt deployment template file. The deployment file is nothing more than XML syntax that
describes the Web Start application being deployed. The <resources> element is used to define the
JVM arguments, the Tivoli Enterprise Portal properties, jar files, and references to component
deployment files.
v Modify the tep.jnlp file if the change will be temporary (for example, setting a trace option for
gathering further diagnostics).
v Modify the tep.jnlpt template file if the change will be long-term (for example, increasing the
maximum heap size to accommodate a larger monitored environment or increased event load).
If you modify the deployment template file, make sure you then reconfigure the Tivoli Enterprise
Portal Server in order to regenerate the instance-level .jnlp deployment files with your changes.
Note: Changes to tep.jnlpt are not preserved when you migrate to a new release. A backup of the
tep.jnlpt file will be made during migration; you must manually compare this backup to the
new version installed during migration to determine what changes need to be manually
incorporated into the new tep.jnlpt.
2. To specify the location of the browser to use to display the online help, add the following property to
the <resources> section of the appropriate file:
231
<property name="kjr.browser.default" value="path_where_browser_is_located>"
Windows example:
<resources os="Windows">
<jar href="classes/browser-winnt.jar"/>
<jar href="classes/browser-core-winnt.jar"/>
<property name="kjr.browser.default" value="C:\Program Files\Internet Explorer\iexplore.exe"/>
</resources>
Linux example:
<resources os="Linux">
<jar href="classes/browser-li.jar"/>
<jar href="classes/browser-core-li.jar"/>
<property name="kjr.browser.default" value="/usr/bin/firefox"/>
</resources>
Note: kjr.browser.default is not the only property you can specify using the <property> keyword.
You can include any client parameters that are specific to your operating system.
Starting the Tivoli Enterprise Portal client

After you have successfully installed and configured all the components of your IBM Tivoli Monitoring
environment, you can verify the installation and configuration by launching the Tivoli Enterprise Portal to
view monitoring data. You can access the Tivoli Enterprise Portal using either the desktop client or the
browser client.
Your monitoring server and portal server must be running for the portal client to start successfully.
Starting the desktop client

Follow these steps to start the desktop client:
On Windows:
1. Click Start Programs IBM Tivoli Monitoring Tivoli Enterprise Portal.
2. Type your user ID and password in the logon window. The default user ID is sysadmin.
3. Click OK.
On Linux, run the following command to start the portal desktop client:
./itmcmd agent start cj
Starting the browser client

Follow these steps to start the browser client:
1. Start the browser.
2. Type the URL for the Tivoli Enterprise Portal into the Address field of the browser:
http://systemname:1920///cnp/client
where the systemname is the host name of the computer where the Tivoli Enterprise Portal Server is
installed, and 1920 is the port number for the browser client. 1920 is the default port number for the
browser client. Your portal server might have a different port number assigned.
3. Click Yes on the Warning - Security window.
4. Type your user ID and password in the logon window. The default user ID is sysadmin.
5. Click OK.
232
Using Web Start to download and run the desktop client

A desktop client obtained from the Tivoli Enterprise Portal Server through IBM Web Start for Java benefits
from centralized administration from the server. Like the browser client, it is automatically configured with
the latest updates each time you start the client, and there is no need to configure application support.
Before you use IBM Web Start for Java to download the desktop client from the Tivoli Enterprise Portal
Server:
v The Tivoli Enterprise Portal Server must be installed. (See Installing the Tivoli Enterprise Portal Server
on page 162.)
v IBM 32-bit Runtime Environment for Windows, Java 2, version 5.0 must be installed on the computer to
which you want to download the desktop client.
You can download the IBM JRE installer from the Tivoli Enterprise Portal Server (see Installing the IBM
JRE). The IBM JRE must be installed as the system JVM.
If you want to run the desktop client on a system that already has a Tivoli Management Services base
component installed (such as a monitoring server or the portal server), there is no need to install the
IBM JRE. The correct version of the IBM JRE is installed with the Tivoli Management Services
component.
If you run the desktop client using Web Start instead of installing it from the installation media, you must
configure the JRE to enable tracing for the desktop client (see Enabling tracing for the JRE on page
234).
Installing the IBM JRE

If you intend to download and run the desktop client using Web Start on a computer where no IBM Tivoli
Monitoring base component is installed, you must first install IBM Java 1.5. You download an installer from
the computer where the Tivoli Enterprise Portal Server is installed:
v Windows: Installing the IBM JRE
v Linux: Installing the IBM JRE on page 234
Windows: Installing the IBM JRE

Complete the following steps to download the IBM JRE installer from the Tivoli Enterprise Portal Server
and install the JRE on a Windows computer:
1. Start the browser on the computer to which you want to download the installer.
2. Enter the following URL in the Address field of the browser:
http://TEPS_host_name:1920///cnp/kdh/lib/java/ibm-java2.exe
where TEPS_host_name is the fully qualified host name of the computer where the portal server is
installed (for example, myteps.itmlab.company.com).
3. When prompted, save the java/ibm-java2.exe file to a directory on your hard drive.
4. Change to the directory where you saved the java/ibm-java2.exe file and double-click the file to
launch the JRE installer to start the installation program.
5. On the pop-up window, select the language from the drop-down list and click OK.
6. Click Next on the Welcome page.
7. Click Yes to accept the license agreement.
8. Accept the default location for installing the JRE or browse to a different directory. Click Next.
9. Click NO on the message asking if you want to install this JRE as the system JVM.
Make Java 1.5 the system JVM only if there are no other JREs installed on the computer.
10. If another JRE is currently installed as the system JVM and you are prompted to overwrite the current
system JVM, click NO.
Overwriting the current system JVM may cause applications depending on the current JVM to fail.
233
11. Click Next on the Start Copying Files window to start installing the JRE.
12. On the Browser Registration window, select the browsers that you want the IBM JRE to be
associated with. These would normally be the browsers that you want to use with the browser client.
13. Click Next.
Linux: Installing the IBM JRE

Complete the following steps to download the IBM JRE installer from the Tivoli Enterprise Portal Server
and install the JRE on a Linux computer.
1. Start the browser on the computer to which you want to download the installer.
http://teps_hostname:1920///cnp/kdh/lib/java
/ibm-java2-i386-jre-5.0-7.0.i386.rpm
where teps_hostname is the fully qualified host name of the computer where the portal server is
installed (for example, myteps.itmlab.company.com).
3. When prompted, save the installer to disk.
4. Change to the directory where you saved the ibm-java2-i386-jre-5.0-7.0.i386.rpm file and launch the
installer to start the installation program using the following command:
rpm -ivh ibm-java2-i386-jre-5.0-7.0.i386.rpm
You can also install the JRE without downloading the installer by supplying the URL to the rpm in the
command:
rpm -ivh http://teps_hostname:1920///cnp/kdh/lib/java
/ibm-java2-i386-jre-5.0-7.0.i386.rpm
Enabling tracing for the JRE

Log files are not created for the desktop client launched through Web Start unless you enable tracing for
the JRE.
The logs for a desktop client run using Web Start are located in a different place than logs for the browser
client and the desktop client installed from the media. On Windows computers, the logs for the Web Start
client are located in the C:\Documents and Settings\Administrator\Application Data\IBM\Java\
Deployment\log directory. On Linux computers, the logs are located in the .java/deployment directory of
the home directory of the user ID under which the Java JRE was installed. Java Web Start will create a
uniquely named trace file for every independent launch of the application. The files are named
javawsnnnnn.trace, where nnnnn is an arbitrary five-digit identifier.
Complete the following steps to enable tracing:
1. Launch the IBM Control Panel for Java.
v On Windows, select Start > Control Panel, then double-click IBM Control Panel for Java.
You must switch to the Classic view to see and select the Control Panel. Alternatively, you can
launch the Control Panel by selecting Start > Run > "C:\Program Files\IBM\Java50\jre\bin\
javacpl.exe".
v On Linux, change to install_dir/jre/platform/bin and run Control Panel:
./Control Panel

3. Expand the Debugging node in the Settings tree and check Enable Tracing.
4. Click OK to save the setting and close the Java Control Panel.
234
Downloading and running the desktop client

You can use any of the following three methods to download and run the desktop client using Web Start:
v Entering the URL of the portal server in a browser
v Launching the client from the IBM Java Control Panel
v Entering a URL from the command line
The first time you launch the desktop client, you are prompted to create a shortcut. After that, you can
launch the client using the shortcut.
Entering the URL of the portal server in a browser:
Use the following procedure to launch the desktop client from a browser:
1. Start the browser on the computer on which you want to use the desktop client.
http://TEPS_host_name:1920///cnp/kdh/lib/tep.jnlp
where TEPS_host_name is the fully qualified host name of the computer where the Tivoli Enterprise
Portal Server is installed (for example, myteps.itmlab.company.com).
3. Click Run on the security message.
4. You are asked if you want to create a shortcut on your desktop for the Tivoli Enterprise Portal. Click
Yes if you want to create the shortcut.
The desktop client starts and displays the logon window.
Note: If IBM Java 1.5 is not the system JVM, you cannot use this shortcut. You must create your own.
See Manually creating a shortcut for the Web Start client on page 236.
5. Enter the user ID and password to log on to the Tivoli Enterprise Portal or click Cancel if you do not
want to log on at this time. (The default user ID is sysadmin.)
Note: If you set the RAS trace option for the Tivoli Enterprise Portal client as documented in IBM Tivoli
Monitoring: Troubleshooting Guide, when you recycle the client the kcjras1.log should be created in
the location from which the client was launched. On Windows this defaults to \Documents and
Settings\userid\Desktop.
Launching the desktop client from the IBM Java Control Panel:
IBM Java 1.5 introduces a new control panel for managing both Java applets deployed via the Java
plug-in, and Java applications deployed via Web Start. Complete the following steps to launch the desktop
client using the control panel:
1. Launch the IBM Java Control Panel:
v Windows: In the Windows control panel, double-click IBM Java Control Panel.
Note: You must be in the Classic view to see IBM Java Control Panel.
v Linux: Change to install_dir/jre/platform/bin directory (the default directory is
/opt/IBM/ITM/jre/platform/bin and enter ./Control Panel.
2. On the General tab, in the Temporary Internet Files section, click Settings. The Temporary Files
Settings window is displayed.
3. Click View Applications.
4. On the User tab, select Tivoli Enterprise Portal, and then click Launch Online.
Web Start downloads and starts the desktop client. When the application is launched, you can close
the Control Panel windows.
235
Launching the desktop client from the command line:

Complete the following steps to launch the desktop client using Web Start from the command line:
1. Open a command prompt and change to the directory where Web Start is installed.
On Windows, the default directory is C:\Program Files\IBM\Java50\jre\bin. On Linux, the default
directory is install_dir/jre/platform/bin.
2. Enter the following command:
javaws http://TEPS_host_name:1920///cnp/kdh/lib/tep.jnlp (Windows)
./javaws http://TEPS_host_name:1920///cnp/kdh/lib/tep.jnlp (Linux)
where TEPS_host_name is the fully qualified host name of the computer where the Tivoli Enterprise
Portal Server is installed (for example, myteps.itmlab.company.com).
Web Start downloads and launches the desktop client.
Manually creating a shortcut for the Web Start client

On Windows, the Web Start executable file for the default Java JVM is copied to the Windows\System32
directory. When you let Web Start create a short cut for launching the desktop client, it uses the file in the
System32 directory as the target. If the default JVM is not IBM Java 1.5, the shortcut will not launch the
desktop client. You must create a shortcut manually.
To create a shortcut to use to launch the desktop client using Web Start:
1. Right-click on the Windows desktop and select New > Shortcut from the popup menu.
2. In the Create Shortcut window, type the following path or click Browse and navigate to the executable
as shown:
C:\Program Files\IBM\Java50\jre\bin\javaws.exe
3. Click Next and type a name for the shortcut in the Select a Title for the Program window. For example:
ITM Web Start client
4. Click Finish.
The shortcut appears on your desktop.
Installing product maintenance

The installation procedures in this chapter contain instructions for new installations. Follow the same
procedures for upgrading or updating an existing installation. Fix packs (that is, product maintenance) use
the same installer as a pristine installation except that in this case, the installer runs only on a system that
is already installed and configured. This is true when installing both generally available fix packs and
interim fixes.
An upgrade is an installation that replaces a previous release or fix pack level of the product or component
with a later release or fix pack level. An update is a modification to an existing installation at the same
release or fix pack level.
Note that, when you upgrade or update an installation, configuration windows for components that are
already configured might not be displayed. Skip those steps that do not apply; there is no need to rerun
any configuration step unless specifically called for in the fix pack's documentation.
The instructions sometimes reference the default path for the installation of IBM Tivoli Monitoring. If you
did not install the product in the default path, you must specify the correct path whenever the upgrade
procedures require a path specification.
236
Chapter 9. Deploying monitoring agents across your

environment
IBM Tivoli Monitoring provides the ability to deploy monitoring agents from a central location, the
monitoring server. Just as there are two types of monitoring agents, there are two types of agent
deployment:
v OS agent deployment from the installation image or using the tacmd createNode command
v Non-OS agent (such as the DB2 for the workstation agent) deployment using the Tivoli Enterprise Portal
GUI (for other non-OS agents) or the tacmd addSystem command
Table 51 describes the steps required to set up and manage remote agent deployment:
Table 51. Remote agent deployment tasks
Goal
Where to find this information
Create and populate the agent deploy depot with

installable agent images.
Populating your agent depot
View and change the contents of the agent depot.
Managing your agent depot on page 240
Use one agent depot for all the monitoring servers in your Sharing an agent depot across your environment on
monitoring environment.
page 241
Deploy an OS agent.
Deploying OS agents on page 242
Deploy a non-OS agent.
Deploying non-OS agents on page 244
Deploy a group of agents simultaneously.
Bulk agent deployment on page 248
You can also use the remote agent deployment function to configure deployed agents and install
maintenance on your agents. For information, see the IBM Tivoli Monitoring: Administrator's Guide. See
the IBM Tivoli Monitoring: Command Reference for commands that you can use to perform these tasks.
Important: Run the tacmd login command before executing commands from the tacmd library. This
requirement does not apply to the addBundles command. Run the tacmd logoff command
after you finish using the tacmd command library."
Populating your agent depot

The agent depot is an installation directory on the monitoring server from which you deploy agents and
maintenance packages across your environment. Before you can deploy any agents from a monitoring
server, you must first populate the agent depot with bundles. A bundle is the agent installation image and
any prerequisites.
When you add a bundle to the agent depot, you need to add the bundle that supports the operating
system to which you want to deploy the bundle. For example, if you want to deploy a DB2 for the
workstation agent bundle to a computer running HP-UX, add the HP-UX-specific agent bundle to the
depot. If your depot directory is on Windows and you want to deploy the DB2 for the workstation agent to
HP-UX, load the HP-UX bundle from the DB2 for the workstation agent installation media for HP-UX. (If
you are installing from different media for each platform type, for example, Windows, AIX and Solaris,
HP-UX, Linux, you need to add the bundle from the specific platform media for the component.)
You can have an agent depot on each monitoring server in your environment or share an agent depot, as
described in Sharing an agent depot across your environment on page 241. If you choose to have an
agent depot for each monitoring server, you can customize the agent depot based on the types of bundles
that you want to deploy and manage from that monitoring server. For example, if you have a monitoring
server dedicated to monitoring the DB2 for the workstation agents in your environment, populate the depot
237
with DB2-related agent bundles. If you deploy an agent from a remote monitoring server, you must have a
agent bundle in the depot available to the monitoring server.
Note: Agent depots cannot be located on a z/OS monitoring server.
There are two methods to populate the agent depot:
v Populating the agent depot from the installation image
v Populating the agent depot with the tacmd addBundles command on page 240
Populating the agent depot from the installation image

Use the following sections to populate your agent depot from the installation image:
v Windows: Populating the agent depot during installation
v Linux and UNIX: Populating the agent depot during installation on page 239
You can use the installation image to populate the agent depot only when you are populating the depot
with bundles for the same operating system as your monitoring server. For example, you can use the
installation image to add a bundle for a Windows agent to a Windows monitoring server, but you cannot
use the Linux installation image to add a Linux bundle to a Windows monitoring server. If you need to add
bundles for operating systems other than that used by your monitoring server, use the tacmd addBundles
command, as described in Populating the agent depot with the tacmd addBundles command on page
240.
Attention: Load only Tivoli-provided product agent bundles into the IBM Tivoli Monitoring deployment
depot. User-provided or customized bundles are not supported. Use only Tivoli-provided tacmd
commands to process bundles and to execute agent deployments. Manual manipulation of the
depot directory structure or the bundles and files within it is not supported and may void your
warranty.
Windows: Populating the agent depot during installation

The procedure to populate the agent depot from the Windows installation image differs based on the
installation image (base IBM Tivoli Monitoring or application agent) that you are using. Use the procedure
in this section that applies to the image you are using:
v Base IBM Tivoli Monitoring installation image
v Application agent installation image on page 239
Base IBM Tivoli Monitoring installation image: Use the following steps to populate the agent depot
from the IBM Tivoli Monitoring installation image:
1. Launch the installation wizard by double-clicking the setup.exe file in the \Windows subdirectory of the
installation image.
2. Select Modify on the Welcome window and click Next.
3. Click OK the warning message regarding existing components on this computer.
4. Click OK on the Add or Remove Features window without making any changes. (Do not clear any
selected items because this removes them from the computer.)
5. On the Agent Deployment window, select the agents that you want to add to the depot and click Next.
6. Review the installation summary and click Next to begin the installation.
After the agents are added to the agent depot, a configuration window (called the Setup Type window)
is displayed.
7. Clear all selected components. You have already configured all components on this computer and do
not need to reconfigure any now. Click Next.
9. Click Finish on the Maintenance Complete window.
238
Application agent installation image: Use the following steps to populate the agent depot from an
application agent installation image:
1. Launch the installation wizard by double-clicking the setup.exe file in the \Windows subdirectory of the
installation image.
2. Select Next on the Welcome window.
3. Click Next on the Select Features window without making any changes.
4. On the Agent Deployment window, select the agents that you want to add to the depot and click Next.
5. Review the installation summary and click Next to begin the installation.
After the agents are added to the agent depot, a configuration window (called the Setup Type window)
is displayed.
6. Clear all selected components. You have already configured all components on this computer and do
not need to reconfigure any now. Click Next.
Linux and UNIX: Populating the agent depot during installation

Use the following steps to populate the agent depot from the Linux or UNIX installation image:
./install.sh
directory (/opt/IBM/ITM). If you want to use a different installation directory, type the full path to that
directory and press Enter.
3. If the directory you specified does not exist, you are asked whether to create it. Type y to create this
directory.
4) Exit install.
Type 2 to start the installation and press Enter.

The end user license agreement is displayed. Press Enter to read through the agreement.
6. Type the number that corresponds to the agent or agents that you want to add to the agent depot and
press Enter. If you are going to add more than one agent, use a comma (,) to separate the numbers.
To select all available agents, type all.
You can select multiple agents with consecutive corresponding numbers by typing the first and last
numbers for the agents, separated by a hyphen (-). For example, to add all of the agents between 8
and 12, type 8-12.
To clear an agent that you previously selected, type the number for the agent again.
Note: Use the following keys to navigate the list of agents:
U
Moves up a line in the list.
Moves down a line in the list.
Moves forward one page in the list.
B
Moves back one page in the list.
7. When you have specified all the agents that you want to add to the agent depot, type E and press
Enter to exit.
239
Populating the agent depot with the tacmd addBundles command

To populate the agent depot using the tacmd addBundles command, run the following command:
tacmd addBundles [-i IMAGE_PATH]
[-t PRODUCT_CODE]
[-p OPERATING_SYSTEM]
[-v VERSION]
[-n]
[-f]
For the full syntax, including parameter descriptions, see the IBM Tivoli Monitoring: Command Reference.
Examples:
v The following example copies every agent bundle, including its prerequisites, into the agent depot on a
UNIX computer from the installation media (CD image) located at /mnt/cdrom/:
tacmd addbundles -i /mnt/cdrom/unix
v The following example copies all agent bundles for the Oracle agent into the agent depot on a UNIX
computer from the installation media (CD image) located at /mnt/cdrom/:
tacmd addbundles -i /mnt/cdrom/unix -t or
v The following example copies all agent bundles for the Oracle agent into the agent depot on a Windows
computer from the installation media (CD image) located at D:\WINDOWS\Deploy:
tacmd addbundles -i D:\WINDOWS\Deploy -t or
v The following example copies the agent bundle for the Oracle agent that runs on the AIX version 5.1.3
operating system into the agent depot on a UNIX computer from the installation media (CD image)
located at /mnt/cdrom/:
tacmd addbundles -i /mnt/cdrom/unix -t or -p aix513
By default, the agent depot is located in the itm_installdir/CMS/depot directory on Windows and
itm_installdir/tables/tems_name/depot directory on UNIX. The tacmd addBundles command puts the
agent bundle in that location unless another location is defined in the monitoring server configuration file
for DEPOTHOME.
If you want to change this location, do the following before you run the tacmd addBundles command:
1. Open the KBBENV monitoring server configuration file located in the itm_installdir\CMS directory on
Windows and the itm_installdir/tables/tems_name directory on Linux and UNIX.
2. Locate the DEPOTHOME variable. If it does not exist, add it to the file.
3. Type the path to the directory that you want to use for the agent depot.
4. Save and close the file.
5. On UNIX or Linux only, add the same variable and location to the kbbenv.ini file located in
itm_installdir/config/kbbenv.ini.
If you do not add the variable to the kbbenv.ini file, it will be deleted from the KBBENV file the next
time the monitoring server is reconfigured.
Managing your agent depot

Use the following commands to manage your agent depot:
Table 52. Agent depot management commands
Command
Description
tacmd listbundles
Lists the details for one or more bundles available to be

added to the local agent depot.
tacmd removebundles
Deletes one or more bundles from the local agent depot.
240
Table 52. Agent depot management commands (continued)

Command
Description
tacmd viewdepot
Lists the types of bundles available in either the local or

remote agent depot.
See the IBM Tivoli Monitoring: Command Reference for the full syntax of these commands.
Note: Only Tivoli-provided product agent bundles should be loaded into the IBM Tivoli Monitoring
deployment depot. User-provided or customized bundles are not supported. Use only Tivoli
provided tacmd commands to process bundles and to execute agent deployments. Manual
manipulation of the depot directory structure or the bundles and files within it is not supported and
may void your warranty.
Sharing an agent depot across your environment

If your monitoring environment includes multiple monitoring servers (a hub monitoring server and remote
monitoring servers), you can put your agent depot in a central location, such as a shared file system, and
access the depot from all of the monitoring servers.
After populating your agent depot with either of the methods described in Populating your agent depot on
page 237, use the following steps to share the agent depot:
1. Open the KBBENV monitoring server configuration file located in the itm_installdir\CMS directory on
Windows and the itm_installdir/tables/tems_name directory on Linux and UNIX.
2. Locate the DEPOTHOME variable. By default, the agent depot is located in the itm_installdir/CMS/
depot directory on Windows and itm_installdir/tables/tems_name/depot directory on UNIX.
3. Type the path to the shared agent depot for the DEPOTHOME variable.
5. On UNIX or Linux only, add the same variable and location to the kbbenv.ini file located in
itm_installdir/config/kbbenv.ini.
If you do not add the variable to the kbbenv.ini file, it will be deleted from the KBBENV file the next
time the monitoring server is reconfigured.
If you are using a Windows monitoring server connecting to a depot on another Windows computer, you
must set the service ID for the Windows monitoring server to "Administrator." Also, instead of specifying a
mapped drive letter for the path to the depot directory, use the UNC path (such as \\server\share).
Use the following steps to change the service ID:
1. From the Control Panel, double-click Administrative Tools.
2. Double-click Services.
3. Right-click Tivoli Enterprise Monitoring Svcs and click Properties.
4. On the Log On tab, select This Account.
5. Type Administrator in the This Account field.
6. Type the password for the administrator in the Password field. Confirm the password by typing it again
in the Confirm password field.
7. Click Enable.
If the Administrator user does not have Logon as a service right, you are prompted to add it.
241
Deploying OS agents
Before you can deploy any non-OS agent, you must first install an OS agent on the computer where you
want the non-OS agent to be deployed. In addition to monitoring base OS performance, the OS agent also
installs the required infrastructure for remote deployment and maintenance.
Note: Ensure that you have populated your agent depot, as described in Populating your agent depot on
page 237, before attempting to deploy any agents.
You can install the OS agent locally, as described in Installing monitoring agents on page 183 or remotely
using the tacmd createNode command.
The tacmd createNode command creates a directory on the target computer called the node. The OS
and non-OS agents are deployed in this directory. Agent application support is also added at this time (see
Installing and enabling application support on page 196).
The tacmd createNode command uses one of the following protocols to connect to the computers on
which you want to install the OS agent:
v Server Message Block (SMB), used primarily for Windows servers
v Secure Shell (SSH), used primarily by UNIX servers, but also available on Windows
Note: Only SSH version 2 is supported.
v Remote Execution (REXEC), used primarily by UNIX servers, but not very secure
v Remote Shell (RSH), used primarily by UNIX servers, but not very secure
You can specify a protocol to use; if you do not, the tacmd createNode command selects the appropriate
protocol dynamically.
Requirements for the tacmd createNode command

Before you can use the tacmd createNode command to deploy OS agents, ensure the following
requirements are met:
v The createNode command no longer has to be executed locally to the Tivoli Enterprise Monitoring
Server.
v On both Windows, Linux, and UNIX, you must issue a tacmd login command prior to executing the
tacmd createNode command.
v On Windows, the user ID that you specify using the -u parameter must have administrator privileges on
the target computer. On UNIX and Linux, you must specify the "root" user ID using the -u parameter
and the root password using the -p parameter for the tacmd createNode command to execute
correctly. No other user ID may be specified.
v Any computer to which you want to deploy the OS agent must have a supported protocol installed.
v Security in your environment must be configured to permit createNode to pass through the firewall,
using the protocol that you specify in the command parameters.
v On Windows computers:
SMB requires that the default, hidden, and administrative shares be available on the drive being
accessed and on the drive that hosts the System temporary directory.
SMB signing is not supported when connecting using SMB. The computer to which you are
deploying an OS agent cannot require SMB signing.
For Windows XP, disable Simple File Sharing. Simple File Sharing requires that all users
authenticate with guest privileges, which createNode does not support. To disable Simple File
Sharing, perform the following steps:
1. Open the Windows Explorer.
2. Click Tools Folder Options.
242
3. Click the View tab.

4. Scroll through the list of settings to Use Simple File Sharing.
5. Clear the check box next to Use Simple File Sharing and click OK.
For Windows XP computers with Service Pack 2, disable the Internet Connection Firewall.
For Windows XP computers, set Network Access Sharing and Security to "Classic - local users
authenticate as themselves." Use the following steps:
1. From the Control Panel, double-click Administrative Tools.
2. Double-click Local Security Policy.
3. Expand Local Policies and click Security Options.
4. Right-click Network access: Sharing and security for local accounts and click Properties.
5. Select Classic - local users authenticate as themselves from the list and click OK.
For all Windows computers, enable remote registry administration. (This is enabled by default.)
v On UNIX systems, if you are using the RSH protocol, run the tacmd createNode command as root on
the monitoring server.
v If you are deploying the OS agent to a UNIX or Linux computer, that computer must have the ksh shell.
Only the Korn shell is supported for the execution of the installation and runtime scripts.
v If you are using SSH V2 (for either Windows or UNIX), configure SSH on the target computers to permit
the use of password authentication. To permit this, do the following:
1. Edit the /etc/ss/sshd_config file on the target computer.
2. Locate the following line:
PasswordAuthentication no
3. Change the no to yes and save the file.

4. Restart the daemon.
Note: If you are using private key authentication in your environment, you do not need to set SSH to
permit password authentication.
Using the tacmd createNode command

To deploy an OS agent from the command line interface, use tacmd createNode command. For the full
syntax, including parameter descriptions, see the IBM Tivoli Monitoring: Command Reference.
For example, the following command deploys the UNIX OS monitoring agent on the server1.ibm.com
computer in the /opt/IBM/ITM directory. The installation is done as the root user.
tacmd createNode -h server1.ibm.com -d /opt/IBM/ITM -u root
Important: Unless you specifically indicate otherwise, the agent that you deploy using this command
assumes that the monitoring server to which it connects is the monitoring server from which
you run the command. The agent also uses the default settings for the communications
protocol (IP.PIPE for protocol type and 1918 for the port). To change these default values
(especially if you are not using the IP.PIPE protocol), use the following property (specified with
the -p parameter) when running the command: SERVER=[PROTOCOL://][HOST|IP][:PORT].
For example, SERVER=IP.PIPE://server1.ibm.com:1918.
243
Deploying non-OS agents

You can deploy non-OS agents through the Tivoli Enterprise Portal or from the command line.
Notes:
1. The deployment and configuration of agents varies depending on the specific agent. The following
procedures provide generic deployment information. For the exact values required for your agent, see
the configuration information in the user's guide for the agent.
2. Ensure that you have populated your agent depot, as described in Populating your agent depot on
page 237, before attempting to deploy any agents.
3. You must have already installed or deployed an OS agent on the computer where you are now
deploying the non-OS agent and the agent must be running.
Deploying through the portal

Before you deploy an agent through the Tivoli Enterprise Portal, application support for that agent must be
installed on the portal server (see Installing and enabling application support on page 196).
Use the following steps to deploy an agent through the portal GUI:
1. Open the Tivoli Enterprise Portal.
2. In the Navigation tree, navigate to the computer where you want to deploy the agent.
3. Right-click the computer and click Add Managed System.
4. Select the agent that you want to deploy and click OK.
5. Complete the configuration fields required for the agent. For information about these fields, see the
configuration documentation for the agent that you are deploying.
6. Click Finish.
7. If the computer where you are deploying the agent already has a version of that agent installed, you
can stop the deployment, add a new instance of the agent, if possible, or reconfigure the existing
agent.
A message will tell you when the deployment finishes successfully.
Deploying through the command line

To deploy non-OS agents from the command line, use the tacmd addSystem command. See the IBM
Tivoli Monitoring: Command Reference for the full syntax of this command, including parameter
descriptions. You can run the cinfo command (UNIX) or the kincinfo -i command (Windows) to list the
product codes for agents installed on the current computer.
For example, the following command deploys the Tivoli Universal Agent (type um) to the stone.ibm.com
computer and specifies the UA.CONFIG property:
tacmd addSystem -t um -n stone.ibm.com:LZ -p UA.CONFIG="file_unix.mdl"
Each agent bundle has its own unique configuration parameters that you may need to specify using this
command. If you have installed the agent bundle that you want to deploy to the deployment depot, you
can view the configuration parameters by running the following command from the monitoring server
where that agent bundle is installed:
tacmd describeSystemType -t pc -p platform
An agent of the same type and platform must be deployed into the depot available to the monitoring server
from which the command is run. You can also get more information about agent-specific parameters in the
agent user's guide for the agent that you want to deploy.
Note: The tacmd command has been updated to support two new features, the asynchronous remote
deployment (which allows you to request the deployment of another remote agent, even if the
244
previously deployed agent has not initialized fully) and the grouping of agents to be remotely
deployed. The deployment commands have been modified to accept two new grouping parameters:
the g parameter lets you specify a deployment group and the b parameter lets you specify a
bundle group. For detailed information, including usage examples, see the IBM Tivoli Monitoring:
Command Reference.
With asynchronous remote deployment, CLI requests are queued, and the tacmd command returns
control immediately to the process that invoked them along with a transaction ID that can be used
to monitor the status of the request via either the tacmd getDeployStatus command or the
Deployment Status Summary By Transaction workspace in the Tivoli Enterprise Portal.
Asynchronous remote agent deployment applies both to agents started via the tacmd command and
to those started using the portal client. Workspace reports regarding asynchronous agent
deployment are also available; for information, see the IBM Tivoli Monitoring online help.
Deploying an instance of the Tivoli Universal Agent

You can use both of the deployment methods described in the previous sections to deploy a Tivoli
Universal Agent instance.
Before you can deploy a Tivoli Universal Agent instance, you must create directory named UACONFIG at
the top level of the deploy depot, at the same level as the PACKAGES directory. (For example, if you
installed your monitoring server at /opt/IBM/ITM, and named it hub_core, then your depot directory is
/opt/IBM/ITM/tables/hub_core/depot and that is where you should create the UACONFIG directory.) If you
are deploying a Script Data Provider, you must also create a UASCRIPT directory at the same level as the
UACONFIG directory.
After you create the directories, you must copy your . mdl files to the UACONFIG directory, and any script
metafiles to the UASCRIPT directory. Use the agent depot on the monitoring server to which the Tivoli
Universal Agent connects.
To deploy the Tivoli Universal Agent, add the following parameter to the addSystem command:
-p UA.CONFIG=metafile.mdl
where metafile is the name of the .mdl file that you want the Tivoli Universal Agent to use.
To deploy the Tivoli Universal Agent and its referenced script, add the following parameter to the
addSystem command:
-p UA.CONFIG=metafile.mdl. UA.SCRIPT=script-filename
where metafile is the name of the .mdl file and script-filename is the name of the script that the Tivoli
Universal Agent uses.
If a metafile belonging to a nondefault type of Data Provider type is remotely deployed (the four default
Data Providers are API, Socket, File, and Script), there is no automatic mechanism to activate the
appropriate Data Provider. For example, if you deploy an ODBC metafile to a remote Tivoli Universal
Agent and that agent has not already been configured to start the ODBC DP, the Data Provider
configuration will not happen automatically as a result of the deployment. You must manually configure the
ODBC Data Provider on that Tivoli Universal Agent for the metafile to be usable. For instructions on
configuring the Data Provider, see the IBM Tivoli Universal Agent User's Guide.
Note to Linux/UNIX users: The instance name is converted to uppercase when the agent registers with
the Tivoli Enterprise Monitoring Server. If the name you specify contains
lowercase letters, this will cause problems when stopping or starting the
agent remotely, as the instance name you specified will not match the actual
instance name. Thus, the universal agent, when used on Linux or UNIX, must
be named with all uppercase letters for the Tivoli Enterprise Portal to start or
245
stop the agent.
Deploying Netcool/OMNIbus System Service Monitor (SSM) agents

Deploying Netcool/OMNIbus SSM agents is very similar to deploying IBM Tivoli Monitoring OS agents: You
first need to populate your agent depot with SSM bundles. Once this is done, you can use the tacmd
createNode command to deploy the SSM agent; see the IBM Tivoli Monitoring: Command Reference for
complete information on this command.
To populate the SSM bundles, download the SSM image from the Passport Advantage Web site,
http://www-01.ibm.com/software/howtobuy/passportadvantage/, and use the tacmd addBundles
command:
tacmd addBundles
-t ssm
-p li6213 -i c:\SSM40_Bundle
This example adds the SSM bundle for the Linux platform to the depot.
Once you have populated the depot with SSM bundles, you can use the tacmd viewDepot command to
see the bundles. Each SSM bundle consists of the installer files and the corresponding descriptor file.
The tacmd commands for installing, patching, starting, stopping, and configuring the Tivoli Monitoring
agents have been expanded to support operations with Netcool SSM agents as well.
Installing an SSM agent

Use the tacmd createNode command to install an SSM agent. The mechanism for pushing the SSM
image to the agent machine is the same as that used to deploy a Tivoli Monitoring OS agent. Example:
tacmd createNode -h smb://achan1.raleigh.ibm.com -t SSM -u achan -d c:\SSMAgent\ssm -p SNMPPORT=16002
This example deploys an SSM agent to the Windows machine achan1 using the Server Message Block.
The installation directory for the agent is specified by the d option, and the SNMP port to be used by the
SSM agent is specified using the p SNMPPORT property.
Uninstalling an SSM agent

To uninstall an SSM agent, use the tacmd removeSystem command to remove it. Example:
tacmd removeSystem -h smb://achan1.raleigh.ibm.com -t SSM -u achan-d c:\SSMAgent\ssm
The above command uninstalls the SSM agent on Windows machine achan1.
Installing an SSM patch

Use the tacmd updateAgent command to patch an SSM agent.
1. Just like installing an SSM image, first run the tacmd addBundles command to add the patch images
to the IBM Tivoli Monitoring depot.
2. Once this is done, run the tacmd updateAgent command to install the patch on the agent. The
transfer of the patch image to the agent is done through the Tivoli Enterprise Monitoring Server's HTTP
server.
Here is an example of an HTTP request for agent http://TEMS_SERVER:1920//ms/kdh/lib/depot/
PACKAGES/WINNT\ssm\040000001\ssm40-fixpack1-win32-x86.exe:
tacmd updateAgent -h achan1.raleigh.ibm.com -t SSM -l "Fixpack 1"
This installs SSM 4.0 agent fixpack 1 to the achan1 agent machine. The agent must be up and running; if
not, the request fails.
To start the agent, use the tacmd startAgent command, as explained in Starting an SSM agent on page
247.
246
Uninstalling an SSM patch

To uninstall an SSM patch, you also use the tacmd removeSystem command, with the l option to
remove the patch. Example:
tacmd removeSystem -h achan1.raleigh.ibm.com -t SSM -l "Fixpack 1" -p SNMPPORT=16002
Starting an SSM agent

To start an SSM agent from ITM, use the tacmd startAgent command. Example:
tacmd startAgent -h achan1.raleigh.ibm.com -p SNMPPORT=16002
Stopping an SSM agent

To stop an SSM agent from ITM, use the tacmd stopAgent command. Example:
tacmd stopAgent -h achan1.raleigh.ibm.com -p SNMPPORT=16002
Restarting an SSM agent

To restart an SSM agent from ITM, use the tacmd restartAgent command. Example:
tacmd restartAgent -h achan1.raleigh.ibm.com -p SNMPPORT=16002
Configuring an SSM agent

There are several configuration functions you can perform with SSM agents using the tacmd
configureSystem command.
v Change the logging file and level on the agent and perform a silent reboot of the agent. Example:
tacmd configureSystem -h achan1.raleigh.ibm.com
-p SNMPPORT=16002 LogFile=test.log LogLevel=debug -r
v Transfer files, including executable files, to the agent machine. Example:

tacmd configureSystem -h achan1.raleigh.ibm.com -p SNMPPORT=16002 -l test1.exe
test2.exe
v Transfer configuration files to the agent machine. Example:

tacmd configureSystem -h achan1.raleigh.ibm.com -p SNMPPORT=16002 -c test1.cfg test2.cfg
Notes:
1. The files specified in the configfile (c) option or the filelist (l) option must be stored in the ssmconfig
subdirectory of the depot directory.
v On Windows, if your depot directory is c:\IBM\ITM\CMS\depot, you must put the files specified in the
configfile option or the filelist option into the c:\IBM\ITM\CMS\depot\ssmconfig directory.
v On Linux or UNIX, if your depot directory is /opt/IBM/ITM/tables/TEMS_NAME/depot, put the files into
the /opt/IBM/ITM/tables/TEMS_NAME/depot/ssmconfig directory.
2. The files are pulled from the agent through the Tivoli Enterprise Monitoring Server's HTTP server. Here
is an example of an HTTP request:
http://tems_host_name:1920//ms/kdh/lib/depot/ssmconfig/test1.cfg
Bulk deployment of NetCool SSM agents

The bulk deployment of SSM agents is very similar to the bulk deployment of IBM Tivoli Monitoring agents.
See Bulk agent deployment on page 248 for more information.
Query deployment status of Netcool SSM agents

The same tools for checking the status of your IBM Tivoli Monitoring agent deployments also apply to SSM
agents; see Deploy status on page 249 for more information. Figure 35 on page 248 shows an example
using the Tivoli Enterprise Portal's Deployment Status Summary workspace.
247
Figure 35. Deployment Status Summary workspace showing the status of SSM deployments
Bulk agent deployment

Bulk deployment of IBM Tivoli Monitoring agents into moderate to large environments is made possible by
a set of capabilities and best practices coming together to achieve rapid rollout with ease. The capabilities
that enable bulk deployment in larger environments fall into two main categories:
v The components involved in deployment.
v The processing model associated with deployment.
The best practices described in this section are recommended or common ways that you can use these
capabilities to successfully deploy agents in larger environments.
Deployment processing model

The processing model used during deployment is critical to the success and timeliness of deployments.
The two critical aspects of deployment processing are:
v Asynchronous transaction submission on the front end.
v Parallel transaction handling on the back end.
The asynchronous nature of the IBM Tivoli Monitoring deployment model allows you to submit deployment
transactions into the environment quickly without having to wait for the deployment request to complete.
248
Instead of the deployment command returning after some period of time with a message saying that the
deployment completed with a success or a failure, the CLI returns immediately with a transaction identifier
(ID). This frees your user environment (be it the Tivoli Enterprise Portal, the command line, or an
automation script) to continue normal processing:
C:\>tacmd createnode -g Targets -b Agents
KUICCN022I: Request has been successfully queued to the deploy controller.
The transaction ID is 1224009912765000000000041, use the getDeployStatus CLI to view the status.
You can then monitor the status of your deployment requests using the command interface or Tivoli
Enterprise Portal workspaces or situations to check for failures.
Once a set of deployment transactions has been submitted into the IBM Tivoli Monitoring infrastructure,
they are routed to the appropriate remote Tivoli Enterprise Monitoring Server for processing. Each remote
monitoring server can process deployment transactions independently of every other monitoring server,
whether remote or hub. This allows for a large degree of parallelism, which increases with each remote
monitoring server added to your environment. Additionally, each remote Tivoli Enterprise Monitoring Server
can process multiple deployment transactions concurrently, further increasing the level of parallelism
applied to bulk deployments.
The default number of concurrent deployments per monitoring server is 10, but this is configurable using
the DEPLOYTHREADPOOLSIZE setting in the Tivoli Enterprise Monitoring Server configuration file
(KBBENV).
Figure 36 illustrates the processing model for bulk deployment.
Figure 36. Bulk deployment processing model
Deploy status
Because deployment transactions are asynchronous (that is, they run in the background), monitoring the
status of deployments is an important activity to ensure they complete successfully. There are three
mechanisms for monitoring deployment status, as follows.
v The tacmd getDeployStatus CLI command.
249
For more information about this command, refer to the IBM Tivoli Monitoring: Command Reference.
v The Tivoli Enterprise Portal's Deployment Status workspaces.
v Deployment attribute groups, and situations created using the Tivoli Enterprise Portal that are based on
these groups.
Using these features, you can display and monitor the progress of deployments running in your
environment. You can track the status of your deployments either by individual transaction or by group
transaction. A group transaction represents a deployment using groups of agents deployed to groups of
targets; this is discussed in the succeeding sections. Each transaction possesses a status that indicates
the progress the transaction has made in the deployment process. The valid status values for a
deployment transaction are listed below.
Status Description
Pending
The transaction is waiting in the queue to begin processing.
In-Progress
The transaction has begun the deployment process but has not yet finished.
Success
The transaction has completed successfully.
Failed Retrying
The transaction experienced a recoverable error during the deployment process and will be
restarted periodically at the point of failure for a predefined number of iterations. The number of
retry iterations is defined by configurable property ERRORRETRYLIMIT. The time between each
successive attempt is defined by the RETRYTIMEINTERVAL property. Both of these properties
can be set in the monitoring server's configuration file, KBBENV, and take effect when the
monitoring server is restarted. The default value for ERRORRETRYLIMIT is 3 retries, and the
default value for RETRYTIMEINTERVAL is 7 minutes. These default values are based on a typical
bulk deployment scenario using the createNode command. A smaller RETRYTIMEINTERVAL
value (for example, 20 seconds) might be better suited if you perform more bulk upgrade
scenarios than deployments.
If an error persists after all retry iterations are exhausted, the transaction moves to Failed status.
Failed The transaction has completed with an unrecoverable failure, or the number of retry attempts has
been exhausted. Consult the status message included with the transaction status for more
information about the failure.
Deployment Status workspaces

There are six workspaces related to bulk deployment. Three can be accessed directly from the
Workspaces menu of the Navigator tree's Enterprise item. The remaining three can be accessed by
selecting links. These workspaces are:
v Deploy Depot Package List
v Deployment Status Summary
v Deployment Status Summary by Transaction ID
v Deployment Status Summary by Product
v Deployment Status Summary by Deploy Group
v Installation Logs
For more information about these workspaces, refer to the IBM Tivoli Monitoring: Tivoli Enterprise Portal
User's Guide or the Tivoli Enterprise Portal online help.
Deployment attribute groups and situations

The hub Tivoli Enterprise Monitoring Server provides two attribute groups that you can use to monitor the
status of bulk deployments within your IBM Tivoli Monitoring environment: Deploy Status and Deploy
Summary. You can use these attribute groups to create situations that notify you in the event of a failure or
250
exceptional circumstance related to a deployment. For more information about these deployment status
attribute groups, refer to the IBM Tivoli Monitoring: Tivoli Enterprise Portal User's Guide or the Tivoli
Enterprise Portal online help.
IBM Tivoli Monitoring provides two deployment situations that monitor the Deploy Status attribute group,
which you can use directly or as samples for creating your own situations. These situations are as follows.
Situation
Description
Deploy_Failed
Triggers a critical event when a deployment transaction fails.
Deploy_Retrying
Triggers a minor event when a deployment transaction enters the failed_retry state.
Organizing deployments using groups

There are three primary components that come into play when performing bulk deployments. These are
1) the components being deployed, 2) the recipients (targets) of the deployment, and 3) properties that
specify, clarify, or alter key details used during the deployment. Planning and organizing these components
in a manner that reflects the current condition of your environment as well as the desired outcome for your
environment will result in successful bulk deployments.
Organization of deployment targets and deployable components is achieved using groups. There are two
types of groups used in bulk deployment, as follows.
Type
Function
Deploy groups
Organize deployment targets, which are the systems or agents to which a deployment is targeted.
Bundle groups
Organize the deployable components that will be used during deployment operations.
In addition to the obvious role these groups play in organizing the participants of deployment, the grouping
facilities perform another very important role: Groups and group members can also hold and organize
properties that the deployment process uses; this is discussed in the following sections.
Deploy and Bundle groups are created using tacmd commands. For detailed information about creating
such groups, see the IBM Tivoli Monitoring: Command Reference.
Deploy groups
Deploy groups organize the targets of deployment operations. Deploy targets are specified as members
within the deploy group. These deploy targets can represent unmanaged systems, which could be targets
of a createNode deployment operation. Deploy targets can also represent managed systems where a
Tivoli Monitoring or Netcool System Service Monitor (SSM) agent is already installed. Both of these types
of deploy targets can be added as members to deploy groups. This dual representation of targets within
deploy groups allows a group to specify:
v Targets of an initial OS agent or SSM deployment using the tacmd createNode command.
v Targets of an application agent deployment using the tacmd addSystem command.
v Targets of an agent or SSM upgrade using the tacmd updateAgent command.
v Targets of an agent or SSM configuration deployment using the tacmd configureSystem command.
Once you create the necessary deploy groups to represent logical groupings of systems within your
enterprise, these groups can be used repeatedly during the lifecycle of your monitoring infrastructure to
deploy, update, start, stop, configure, and eventually remove agents.
251
Best practices: There are a number of best practices associated with deploy groups. The following are
suggested.
v Segment your systems by geographic location. In this case, it is likely that you would want all agents
deployed to a deploy group to connect with the same primary Tivoli Enterprise Monitoring Server.
v Segment your systems according to their role within the enterprise. You might create a group of
database servers, a group of application servers, a group of Web servers. This allows you to deploy
and administer agents to the systems within a group the same way but differently from how you might
deploy and administer agents in a different group.
v Segment your systems according to the monitoring infrastructure being used. You might create a set of
groups for monitoring using Tivoli Monitoring agents and another group or set of groups for monitoring
using SSM agents.
v Segment your systems into smaller groups representing a percentage of total systems. This allows you
to perform deployments into more easily consumable sets of activities.
Bundle groups
Bundle groups organize and represent the components that you deploy. These include IBM Tivoli
Monitoring agents and Netcool SSM agents. Deployable bundles are added as members to bundle groups
using the tacmd command by specifying the agent's product code and optionally the platform and version
for the bundle.
To enable bulk deployment of more than one agent at a time, you add multiple members to the bundle
group representing multiple agents to deploy. For example, you might create a bundle group to deploy a
Windows OS agent and a DB2 application agent by adding a member with product code NT and a
member with product code UD. Since one of these members is an OS agent, you use the tacmd
createNode command to deploy this bundle group.
If you had created a bundle group containing only application agents, such as DB2, Domino, or SAP
agents, you deploy them using the tacmd addSystem command. Each bundle group member represents
a deployment bundle that must be added to the appropriate agent depot using the tacmd addBundles
command before a bulk deployment command is executed involving the bundle group. To avoid the
complexity of managing multiple depots, consider using a shared agent depot; see Sharing an agent
depot across your environment on page 241.
Best practices: There are a number of best practices associated with bundle groups. The following are
suggested.
Grouping
Definition
Grouped by platform type
A group used to specify one or more agent bundles for a specific platform type.
Grouped by system role
A group used to specify a standard set of agents being deployed for a specific machine type or
role within your enterprise. For example, a group deployed to database servers could contain an
OS agent and a database agent.
Grouped for latest update
A group containing various agents where the version specification for agent member bundles is
omitted. This causes initial deployment and upgrades to always deploy the most current available
version in the depot. By managing the version of agents in the depot, this type of group always
deploys the latest versions to target systems.
Group properties
When using the tacmd command for deployment (createNode, addSystem, etc.), you can use the p
option to specify properties that modify parameters of the deployment or to specify configuration
parameters to the agent installation process. When using the command interface with deploy and bundle
252
groups, properties previously specified on the deploy command line can be attached to the groups
themselves or to group members. Attaching properties to groups and group members means that they are
available for reuse each time the group is referenced in a deployment command without your needing to
specify properties again on the command line. This creates a very powerful mechanism for defining
behaviors around your deployments and reusing them each time you specify a group as part of a
deployment.
When creating your deploy and bundle groups for bulk deployment, you can assign properties to these
groups. Properties at the group level apply to all members of the group. Additionally, properties can be
assigned to individual group members. Any property assigned to a member applies to that member only
and overrides a similar property specified at the group level. This allows you to build a hierarchy of
properties that is consolidated during deployments to create a complete deployment request. Properties
specified on the groups and group members can include any combination of OS agent, application agent,
and deployment properties. Refer to the IBM Tivoli Monitoring: Command Reference for more information
about specific properties.
Consider the following example where you want to deploy the UNIX OS agent to five AIX systems with the
following hostnames.
aix1.mycompany.com
aix2.mycompany.com
aix3.mycompany.com
aix4.mycompany.com
aix5.mycompany.com
To do this, you must provide login credentials. All five systems share the same root userid and password.
When creating the group, you can assign the userid and password to the group so it applies to all
members. This way, you need specify the login credentials only once.
# KDYRXA.RXAPASSWORD=mypass
# tacmd addgroupmember
...
-t deploy -g Targets -m aix1.mycompany.com

-t deploy -g Targets -m aix2.mycompany.com
By attaching the userid and password to the deploy group at the group level, the properties apply to all
members without having to repeat them for each member.
Suppose that one of the systems was on the far side of a slow link and required more time to complete a
deployment. By adding a property to that member, you can change the behavior associated with that
member without affecting the behavior of the others.
-t deploy -g Targets -m aix3.mycompany.com -p KDYRXA.TIMEOUT=3600
But suppose that one of the members had a different root password. By attaching this password to the
member for that system, you override the value at the group level and replace it with the member-specific
value.
-t deploy -g Targets -m aix5.mycompany.com -p KDYRXA.RXAPASSWORD=yourpass
Table 53 illustrates how the properties from the above example combine to build a useful set of
consolidated properties.
Table 53. Interaction between member properties and group properties
Member
Group properties
Member properties
Consolidated properties
aix1
KDYRXA.RXAUSERNAME=root
KDYRXA.RXAPASSWORD=mypass
aix2
253
Table 53. Interaction between member properties and group properties (continued)
Member
Group properties
Member properties
Consolidated properties
aix3
KDYRXA.TIMEOUT=3600
KDYRXA.TIMEOUT=3600
aix4
aix5
KDYRXA.RXAPASSWORD=yourpass
KDYRXA.RXAPASSWORD=yourpass
As you can see in the above example, group and member properties are joined during deployment to
create a consolidate set of properties that are used for the deployment. Notice, however, that the deploy
group member properties take precedence over and can actually override those at the deploy group level.
This is visible with aix5.mycompany.com where the member value for KDYRXA.RXAPASSWORD overrode
the group value.
This same property mechanism applies to bundle groups as well. There might be a property that you want
to apply to an agent bundle in a group regardless of where they are deployed. In this case you would
attach the property to the bundle group. Likewise, you might want to specify a property that applies to a
single agent type within a bundle group. In this case you attach the property to the bundle member.
During a deployment operation where you deploy a bundle group to a deploy group, property consolidation
occurs across all properties at the group and member level for both groups. Table 54 lays out the
precedence of group/ member properties.
Table 54. Property precedence between deploy groups and bundle groups
Precedence
Property location
What goes here
highest
Deploy group members
Properties specific to the individual member target.
Deploy group
Properties common to all targets of the group. For example, if

agents deployed to every target member of the group will
connect to the same remote monitoring server, then you can
specify the server's connection properties here.
Bundle group member
Properties common to all deployments of the specific member

bundle of the group. For example, if the bundle group contains
the DB2 agent for Windows and you want all installations of DB2
agents on Windows to use a specific property, specify it here.
Bundle group
Properties common to all deployments of every bundle within the

group, regardless of target.
lowest
Best-practice deployment procedures

The following sections provide some best-practice procedures to assist you in planning and implementing
your bulk deployment. For more information about the commands listed in the sections below, refer to the
IBM Tivoli Monitoring: Command Reference.
Deployment planning and preparation

Employ the following best practices in advance of actual deployments. They represent the setup steps
necessary to prepare for actual deployment operations.
1. Add bundles to the deploy depot.
# tacmd addbundles -I imagepath ...
2. Create deploy groups.
254
Create a deploy group for any collection of deployment targets. Group properties can be applied to the
group during creation or afterward. Use any of the best practices described above in Deploy groups
on page 251.
# tacmd creategroup -t DEPLOY -g DBServers ...
3. Add deploy group members.

After creating your deploy groups, add the appropriate systems hostnames as group members
(targets) according the best practice chosen for the group. Member properties can be applied during
member creation or afterward.
# tacmd addgroupmember -t DEPLOY -g DBServers -m hostname
# ...
...
4. Create bundle groups.

Create a bundle group for any collection of agent bundles you wish to deploy. Group properties can be
applied to the group during creation or afterward. Use any of the best practices described above in
Bundle groups on page 252.
# tacmd creategroup -t BUNDLE -g DBAgentBundles ...
5. Add bundle group members.

After creating your bundle groups, add the appropriate agent bundles as members to the groups
according the best practice chosen for the group. Member properties can be applied during member
creation or afterward.
# tacmd addgroupmember -t BUNDLE -g DBAgentBundles -m UnixOSAgent -y UX ...
# tacmd addgroupmember -t BUNDLE -g DBAgentBundles -m DB2Agent -y UD ...
# ...
Deployment
The following best practices are employed to initiate and perform actual deployments. These best
practices apply regardless of whether the deployment is an initial agent installation, an agent upgrade, or
an agent configuration update. In fact, it is important to recognize that the groups created for deployment
are applicable to all agent maintenance operations throughout the agent lifecycle.
1. Submit deployment.
Submitting the deployment differs slightly depending on the type of deployment activity you desire, but
they are all very similar.
v createNode
Use the tacmd createNode command when performing initial deployments of OS and SSM agents.
This includes deploying bundle groups that contain OS agents grouped together with application
agents.
# tacmd createnode -g DBServers -b OS_DBAgentBundles
v addSystem
Use the tacmd addSystem command when initially deploying application agents.
# tacmd addsystem -g AppServers -b AppAgentBundles
v updateAgent
Use the tacmd updateAgent command when performing agent or SSM upgrades.
# tacmd updateagent -g DBServers -b LatestAgentFixpacks
# tacmd updateagent -g AppServers -b LatestAppAgentFixpacks
Note: The KUIWINNT.dsc file on Windows systems and the uiplatform.dsc files (where platform is
the platform name) on Linux and UNIX systems have been added or updated so that the KUI
package (the tacmd commands) can be remotely deployed. Use the following command:
tacmd updateAgent -t ui -n node
where:
255
node
is the IBM Tivoli Monitoring node on which the KUI package is to be remotely deployed.
v configureSystem
Use the tacmd configureSystem command when performing configuration updates to agents or
SSMs.
# tacmd configuresystem -g DBServers -b DBServerAgentConfig
v removeSystem
Use the tacmd removeSystem command when removing application agents or SSM patches from
a system.
# tacmd removesystem -g AppServers -b AppAgentBundles
2. Monitor deployment.
There are many mechanisms that you can use for monitoring deployment status. These include:
v Using the CLI.
The tacmd getDeployStatus command returns the complete status of requested deployment
transactions.
# tacmd getdeploystatus -g group_transactionID
v Using portal workspaces.

The Tivoli Enterprise Portal provides a number of workspaces that display the status of
deployments. These provide an easy mechanism to rapidly visualize deployment status summaries
as well as detailed status. See the IBM Tivoli Monitoring: Tivoli Enterprise Portal User's Guide or the
portal online help for more information.
v Using automation.
Automation can be driven in two ways. Situations can be created to indicate deployment failures to
initiate corrective activities. Also, automation scripts can use the tacmd getDeployStatus command
to retrieve and parse status information and initiate corrective activities. Situations and automation
scripts can be used in tandem to monitor deployment status.
Regardless of the specific mechanism for monitoring deployment status, the best practice involves the
following steps.
a. Check the transaction status to ensure it is queued properly.
b. Wait some period of time for the deployments to proceed.
c. Check the transaction status for successful completions and failures. This involves either using the
command interface or the portal interface or checking for situation events that indicate deployment
failures.
d. Perform any necessary corrective actions.
e. Repeat starting with step 2b until all transactions have completed.
3. Correct problems.
When a deployment transaction fails, some corrective action is usually required before reinitiating the
deployment. Consult the return message portion of the transaction status to identify the problem and
possible resolutions. Rerun the deployment once errors are corrected. For example, when using a
deploy group with the addSystem or updateAgent commands, remote deployment may fail to locate
the existing managed-system name for some hosts. The message received is KDY0012E The target
target_host_name is incorrect or is offline. The command did not complete because the value for the
target is incorrect or the target is offline.
This message normally indicates that the OS agent is not online. If the agent is, in fact, online, cancel
current operations to this node:
# tacmd cleardeploystatus
-h hostname
Then issue the operation directly by using the managed system name parameter instead of the deploy
group:
# tacmd updateAgent
256
-t product_code -n managed_OS
4. Purge status.
When all deployment transactions have completed or the deployment status is no longer required,
clear the transaction's deployment status from the systems.
# tacmd clearDeployStatus -g group_transactionID
While the steps above describe the complete process of deployment, it is common to perform deployments
in small sets of consumable transactions. That is, perform an initial deployment on a smaller group of
systems to ensure that there are no issues that would inhibit the successful completion of deployment.
Once that deployment is complete, continue with one or more larger deployments using target deploy
groups with more members. Work through each deploy group representing some portion of your enterprise
until you have completed all deployments for your enterprise.
Working with non-agent bundles

This chapter describes how to deploy, update, and remove non-agent bundles. Traditionally, remote
deployment supported remote installation of deployable agents to a connected monitoring server. Now you
can use remote deployment to install custom bundles or bundles for other components. This non-agent
bundle capability is a way to deploy components that are not required to connect to the monitoring server.
This enhancement includes the following:
v The allowable length for a product code for non-agent bundles is restricted to be between 3 to 32
characters in order to distinguish it from the agent product codes.
v The following tacmd commands were enhanced to support product codes up to 32 characters:
addBundles, addSystem, getDeployStatus, listBundles, removeSystem, updateAgent, and viewDepot.
Notes:
1. Avoid non-agent bundle product codes that start with K as this name might conflict with IBM Tivoli
Monitoring agent bundles.
2. Non-agent bundles do not support the following tacmd commands: startAgent, stopAgent,
restartAgent, viewAgent, and configureSystem.
Deploying a non-agent bundle

Complete the following steps to deploy a non-agent bundle:
1. Run the tacmd listBundles command to view the agent bundles.
2. Add the agent bundle to the depot using the tacmd addBundles command.
3. Run the tacmd viewDepot command to display the contents of the agent depot. Verify the non-agent
bundles were added to the depot.
4. Run the tacmd addSystem command with appropriate configuration information. If you want to specify
an installation path, run this command with the KDY.installPath property set to CANDLEHOME/productcode
if you want the location to be within the CANDLEHOME directory, or set to /productcode if you do not
want the location to be within the CANDLEHOME directory, for example:
tacmd addSystem -p KDY.installPath=/IBM/ITM/Uxxx -n managed_os -t Uxxx
5. Check to ensure the status of transactions is queued or InProgress.

Monitor the workspace or use the tacmd getDeployStatus command to verify the result. When the
deployment completes successfully, verify that the bundle was installed at the default location if you did
not specify the installation path, or to the location that you chose if you did specify an installation path.
Notes:
1. The OS agent must already be installed on the system before deploying the non-agent bundle.
2. The non-agent bundle must exist in the depot of the monitoring server to which the OS agent is
connected.
3. For more information about each of these commands, see the table below that links to a description of
each command, including syntax and option information, along with examples.
257
Updating a non-agent bundle

Complete the following steps to update a non-agent bundle:
1. Run the tacmd listBundles command to view the agent bundles.
2. Add the agent bundle to the depot using the tacmd addBundles command.
3. Run the tacmd viewDepot command to display the contents of the agent depot. Verify the non-agent
bundles were added to the depot.
4. Run the tacmd updateAgent command with appropriate parameters. If the non-agent bundle was
installed in a directory other than the default, run this command with the KDY.installPath property set to
CANDLEHOME/productcode if the location is within the CANDLEHOME directory, or run this command
with the KDY.installPath property set to /productcode if the location is not within the CANDLEHOME
directory, for example:
tacmd updateAgent -p KDY.installPath=/IBM/ITM/Uxxx -n managed_os -t Uxxx

Monitor the workspace or use the tacmd getDeployStatus to verify the result. When the deployment
completes successfully, verify that the agent bundles were updated on the target system.
Notes:
1. Ensure that the installation path is the same one that was used when the non-agent bundle was added
initially.
connected.
3. For more information about each of these commands, see the table below that links to a description of
each command, including syntax and option information, along with examples.
Removing a non-agent bundle

1. Run the tacmd removeSystem command with appropriate parameters, including the KDY.installPath
property if the agent was installed at a user specified location, for example:
tacmd removesystem -p KDY.installPath=/IBM/ITM/Uxxx -n managed_os -t Uxxx

Notes:
1. The non-agent bundle must already be in the depot in order to remove it. If it is not, add it to the depot
using the tacmd addBundles command.
2. Ensure that the installation path is the same one that was used when the non-agent bundle was added
initially.
connected.
Monitor the workspace or use the tacmd getDeployStatus command to verify the result. When the
removal completes, verify that the non-agent bundle files are removed from the target system and none of
the IBM Tivoli Monitoring system files were inadvertently removed.
Running deployment in a Hot Standby environment

The IBM Tivoli Monitoring Hot Standby capability allows your monitoring environment to continue operating
in the event of environmental or operational issues with the primary hub Tivoli Enterprise Monitoring Server
(for detailed information about Tivoli Monitoring's Hot Standby feature, see the IBM Tivoli Monitoring:
High-Availability Guide for Distributed Systems). You should refrain from deploying or updating agents
when IBM Tivoli Monitoring is converting to a mirror monitoring server. No agent deployments or remote
deployment operations should be executed from a Hot Standby mirror hub, as this may cause your
deployment transactions to get stuck in a queued state, and you may not be able to clear them.
258
Part 4. Post-installation configuration and customization

The chapters in this section cover configuration procedures that you can perform at any time after you
complete the installation and basic configuration.
Chapter 10, Configuring IBM Tivoli Monitoring components, on page 261, introduces Manage Tivoli
Enterprise Monitoring Services, a utility you can use to start and stop components and to configure or
reconfigure components. It includes instructions for starting and stopping Manage Tivoli Enterprise
Monitoring Services and for using the utility to reconfigure a Tivoli Enterprise Monitoring Server, to
configure or change connections between agents and monitoring servers, to configure user authentication,
and to configure failover support. This chapter also contains instructions for specifying network interfaces
for the portal server to use when the monitoring server has multiple TCP/IP interfaces, controlling port
number assignments, and configuring the heartbeat interval for agents and monitoring servers.
Chapter 11, Additional Linux and UNIX configuration steps, on page 275 contains instructions for
disabling fsync() calls, configuring permissions for a monitoring server on non-NIS Solaris computers, and
increasing virtual memory on AIX for large environments.
Chapter 12, Additional Tivoli Enterprise Portal configurations, on page 279 contains instructions for
securing communication between clients and the portal server, creating a connection between a portal
client and an external Web server, using network address translation (NAT) with a firewall, defining an
interface for multiple network interface cards. It also provides several firewall scenarios.
Chapter 13, Configuring IBM Tivoli Monitoring Web Services (the SOAP Server), on page 293 provides
instructions on controlling access to the SOAP server installed on hub monitoring servers and for
configuring connections between hubs.
Chapter 14, Performance tuning, on page 299 discusses considerations for optimizing components within
your Tivoli Monitoring environment.
259
260
Chapter 10. Configuring IBM Tivoli Monitoring components

Although the majority of configuration is done during the product installation, you can use the Manage
Tivoli Enterprise Monitoring Services tool to configure components at any time. You can also use the
Manage Tivoli Enterprise Monitoring Services tool to start and stop components.
Note: You can also perform many of these configuration and start and stop procedures from the
command line. Where this is possible, the command is included. See the IBM Tivoli Monitoring:
Command Reference for a complete description, including parameters, of the commands that you
can use in the installation and configuration of IBM Tivoli Monitoring.
You can perform the tasks in Table 55 with the Manage Tivoli Enterprise Monitoring Services tool:
Table 55. Configuration tasks available through Manage Tivoli Enterprise Monitoring Services
Task
Start Manage Tivoli Enterprise Monitoring Services
Starting Manage Tivoli Enterprise Monitoring Services
Change the configuration of the monitoring server
Changing the configuration of the Tivoli Enterprise

Monitoring Server on page 262
Configure agents and other monitoring components
Configuring or changing the monitoring server connection

for agents on page 264
Start and stop components
Starting and stopping components on page 265
Monitor the status of remote monitoring servers and

agents by configuring heartbeat monitoring.
Configuring the heartbeat interval on page 270
Starting Manage Tivoli Enterprise Monitoring Services

Depending on the operating system you are using, the procedure for starting Manage Tivoli Enterprise
Monitoring Services is different.
Starting Manage Tivoli Enterprise Monitoring Services on Windows

computers
Use the following steps to start Manage Tivoli Enterprise Monitoring Services on a computer running
Windows:
1. Click Start Programs IBM Tivoli Monitoring Manage Tivoli Monitoring Services.
Starting Manage Tivoli Enterprise Monitoring Services on Linux or

UNIX computers
Use the following steps to start Manage Tivoli Enterprise Monitoring Services on a computer running Linux
or UNIX:
1. Change to the bin directory:
cd install_dir/bin
2. Run the following command using the parameters described in Table 56:
./itmcmd manage [-h install_dir] [-s]
-h

directory.
install_dir
The installation directory for IBM Tivoli Monitoring.
261
Table 56. Parameters for the itmcmd manage command (continued)

-s
(optional) Option to specify safe mode operation.

Safe mode invokes the JRE with the -nojit option (no
just-in-time compiler). If you encounter a Java failure
error, try running the command as before, but also
specifying the -s option.
Entering the above commands with -? displays the syntax
for using the -s option.
The Manage Tivoli Enterprise Monitoring Services utility is displayed.

Note: Note that the Platform column for agents lists the platform that the binary code was built on, not
the platform that you are running on.
Changing the configuration of the Tivoli Enterprise Monitoring Server

You can change the basic configuration of the monitoring server through Manage Tivoli Enterprise
Monitoring Services. Use the following steps:
1. In the Manage Tivoli Enterprise Monitoring Services window, right-click the monitoring server.
2. Click Reconfigure (on Windows) or Configure (on UNIX).
3. Identify the communications protocol for the monitoring server. You have four choices: IP.UDP, IP.PIPE,
IP.SPIPE, or SNA. You can specify three methods for communication - this enables you to set up
backup communication methods. If the method you've identified as Protocol 1 fails, Protocol 2 is used.
4. Click OK.
5. Complete the fields settings listed in Table 57 for the communications protocol for the monitoring server
and click OK.
Field
Description
IP.UDP Settings

server. Note that the Tivoli Enterprise Monitoring Server
supports both IPV4 and IPV6 addressing formats.
The listening port for the hub monitoring server.
IP.PIPE Settings

Port Number

number is 1918.
IP.SPIPE Settings

Port number

SNA Settings
Network Name
262
Table 57. Communications protocol settings (continued)

Field
Description
LU Name

LU 6.2 LOGMODE

"CANCTDCS."
TP Name
6. If the monitoring server was running when you began the configuration process, after the
reconfiguration is complete, you are asked if you want it restarted.
Figure 37. Restart Component window: Tivoli Enterprise Monitoring Server
Reply Yes or No.

On Linux and UNIX, you can also use the itmcmd config -S command to change the configuration of a
monitoring server. When the CLI completes the reconfiguration, if the monitoring server was running when
you began this process, you are asked if you want it restarted:
Would you like to restart the component to allow new configuration to take effect [1=Yes, 2=No]
(Default is: 2):
Reply 1 or 2, as appropriate.
If you choose the restart, the monitoring server is stopped and then started again. These actions are
necessary to force the server to read your changed configuration (which is always read at server startup).
On UNIX platforms the component should be restarted with the same user that it previously ran on. If the
monitoring server was not running when reconfigured, no action is performed, and the server remains
stopped.
Notes:
1. Use caution when starting, stopping, or restarting the Tivoli Enterprise Monitoring Server, as it is a key
component.
2. You cannot configure a hub monitoring server and a remote monitoring server on the same system
because you cannot have two processes listen to the same IP port on the same system.
v You can configure any number of remote monitoring servers on the same system as long as each
reports to a different hub and uses a different port number.
v You can configure any number of hub monitoring servers on the same system as long as each uses
a different port number.
v If a hub monitoring server and a remote monitoring server are configured on the same system, the
remote monitoring server must report to a hub on another system using a port other than the one
used by the hub running on the same system.
263
v You cannot have two monitoring servers talking to each other over IP from the same system unless
one of them is a high-availability hub monitoring server, because a high-availability hub is isolated to
a private IP address. See the IBM Tivoli Monitoring: High-Availability Guide for Distributed Systems.
Configuring or changing the monitoring server connection for agents

To configure or change the monitoring server connection to the agents, use the following procedure.
1. In the Manage Tivoli Enterprise Monitoring Services window, select the agent whose connection you
want to configure. You can select multiple agents by holding down the Shift key or Control key and
selecting agents.
2. Click Actions Reconfigure.
3. Identify the communications protocol for communication with the monitoring server. You have four
choices: IP.UDP, IP.PIPE, IP.SPIPE, or SNA. You can specify three methods for communication - this
enables you to set up backup communication methods. If the method you've identified as Protocol 1
fails, Protocol 2 is used.
4. Click OK.
5. Complete the following fields and click OK:
Field
Description
IP.UDP Settings

The listening port for the hub monitoring server.
IP.PIPE Settings

Port Number

number is 1918.
IP.SPIPE Settings

Port number

SNA Settings
Network Name
LU Name

LU 6.2 LOGMODE

"CANCTDCS."
TP Name
6. If the agent was running when you began the configuration process, after the reconfiguration is
complete, you are asked if you want the agent restarted.
264
Figure 38. Restart of Monitoring Agent window
Reply Yes or No.

On Linux and UNIX, you can also use the itmcmd config -A command to change the configuration of a
monitoring agent. When the CLI completes the reconfiguration, if the agent was running when you began
this process, you are asked if you want the agent restarted:
Would you like to restart the component to allow new configuration to take effect [1=Yes, 2=No]
(Default is: 1):
Reply 1 or 2, as appropriate.
If you choose the restart, the agent is stopped and then started again. These actions are necessary to
force the agent to read your changed configuration (which is always read at agent startup). On UNIX
platforms the component should be restarted with the same user that it previously ran on. If the agent was
not running when reconfigured, no action is performed, and the agent remains stopped.
Starting and stopping components

You can start and stop the IBM Tivoli Monitoring components from Manage Tivoli Enterprise Monitoring
Services. Use the following steps:
1. Right-click the component (such as a specific agent or the Tivoli Enterprise Portal Server) that you
want to start or stop.
2. Click Start, Stop, or Recycle (Windows only) from the menu.
Note: When a hub Tivoli Enterprise Monitoring Server is recycled, all current events are recycled.
You can also use the following commands to start and stop components, including agents built by the
Agent Builder and System Monitor Agents:
itmcmd server
Starts and stops a UNIX monitoring server.
itmcmd agent
Starts and stops a UNIX monitoring agent.
tacmd startAgent
Starts both Windows, Linux, and UNIX monitoring agents.
265
tacmd stopAgent
Stops both Windows, Linux, and UNIX monitoring agents.
See the IBM Tivoli Monitoring: Command Reference for the syntax of these commands.
Specifying network interfaces

If there are multiple TCP/IP interfaces on the computer on which a monitoring server is running, you need
to identify which interfaces monitoring agents or the Tivoli Enterprise Portal Server should use when
connecting to the monitoring server. Setting network interfaces affects all the components installed on the
local computer.
To specify the network interfaces to be used by the portal to connect to a hub monitoring server, or by a
monitoring agent to connect to a hub or remote, complete these steps:
Note: For instructions on configuring a network interface list on z/OS, see the IBM Tivoli Management
Services on z/OS: Configuring the Tivoli Enterprise Monitoring Server on z/OS.
1. In the Manage Tivoli Enterprise Monitoring Services window, select Actions > Advanced > Set
Network Interface.
2. On the Set Desired Network Interface window specify the network interface or interface you want to
use.
Specify each network adapter by the host name or IP address to be used for input and output. Use a
blank space to separate the entries. If your site supports DNS, you can specify IP addresses or short
host names. If your site does not support DNS, you must specify fully qualified host names.
3. Click OK to close save the settings and close the window.
Controlling port number assignments

IBM Tivoli Monitoring assigns port numbers to each component in an installation to be used for
communication with other components. Default well-known ports are reserved for major components such
as monitoring servers and the portal server. For all other components, an algorithm calculates the listening
port to reserve.
You might want to change or add to the default assignments under some conditions, for example, when
the default port assigned to a monitoring agent has already been reserved by another application, or the
portal server requires a second port number for communication through a firewall with Network Address
Translation (NAT).
Configuring port number assignments for the monitoring server

The default IP.UDP and IP.PIPE listening port setting for the Tivoli Enterprise Monitoring Server is 1918.
For IP.SPIPE, it is 3660. For SNA, it is 135. While you can specify a different port during or after
installation, it is best to use the default setting. To reconfigure the port after installation, see Configuring or
changing the monitoring server connection for agents on page 264.
Configuring port number assignments for the portal server

Communications between Tivoli Enterprise Portal clients and the Tivoli Enterprise Portal Server are
controlled by a portal server interface definition. The default interface definition assigns port 15001 to the
Tivoli Enterprise Portal Server and ports 1920 (for HTTP requests) and 3661 (for HTTPS) to the integrated
Web server that is installed with the portal server. You can define additional interfaces to allow access
through a firewall with NAT or through a secondary Network Interface Card (NIC). See Firewall network
address translation (NAT) or multiple network interface cards on page 286.
The following sections describe how to change port number assignments on the portal server for
connections to Tivoli Enterprise Portal clients (browser clients and desktop clients).
266
Changing the port number for browser client connections to the portal server
A portal server on Windows, Linux, or UNIX uses port 1920 for HTTP connections and 3661 for HTTPS
connections from portal browser clients.
Do not change the default port settings, especially on multifunction UNIX and Linux systems, since many
components might be located on the same system and some of these components might depend on the
default values being used for HTTP and HTTPS ports.
If you need to change the default settings, you can change them by using the KDE_TRANSPORT
environment variable:
On Windows:
1. In the Manage Tivoli Enterprise Monitoring Services window, right-click Tivoli Enterprise Portal
Server, point to Advanced, and select Edit ENV File to open the KFWENV file.
2. Add the following line to the file:
KDE_TRANSPORT=HTTP:1920 HTTPS:3661
Substitute the port numbers you want to use.

3. If a KDC_FAMILIES environment variable exists in the file, copy the settings from that variable to
KDE_TRANSPORT (except the ones you want to override). KDE_TRANSPORT supersedes and
overrides KDC_FAMILIES.
4. Save the file.
5. Recycle the portal server. (Right-click Tivoli Enterprise Portal Server and select Recycle.)
On Linux or AIX:
1. Change to the install_dir/config directory (where install_dir is the IBM Tivoli Monitoring installation
directory).
2. Add the following line to the cq.ini file:
KDE_TRANSPORT=HTTP:1920 HTTPS:3661
Substitute the port numbers you want to use.

3. If a KDC_FAMILIES environment variable exists in the file, copy the settings from that variable to
KDE_TRANSPORT (except the ones you want to override). KDE_TRANSPORT supersedes and
overrides KDC_FAMILIES.
4. Recycle the portal server.
Special settings:
The KDE_TRANSPORT environment variable keyword redefines the ports to be use by the HTTP and
HTTPS daemons. Certain special settings are also provided to meet special needs.
HTTPS:0
Eliminates error messages when the HTTPS daemon server is active and failing to obtain or bind
to family ip.ssl (ip.ssl.https:3661).
HTTP:0, HTTPS:0
These settings disable port allocation and port bind errors for the HTTP (1920) and HTTPS (3661)
default ports.
HTTP_SERVER:n
This KDE_TRANSPORT environment variable keyword disables HTTP and HTTPS daemon
services. Do not specify this for a hub monitoring server or for the portal server.
HTTP_CONSOLE:n
This KDE_TRANSPORT environment variable keyword disables the CT/Service Console facility of
the HTTP daemon service. HTTP_CONSOLE:N removes the process from the published Tivoli
service index; this makes the process inaccessible from the CT/Service Console.
267
Changing the port number for desktop client connections to the portal server
Use the following procedure for each desktop client instance you want to change:
1. In the Manage Tivoli Enterprise Monitoring Services window, right-click the Tivoli Enterprise Portal
Desktop instance that you want to change, and select Reconfigure.
The Configure Application Instance window opens.
2. In the Parms list, scroll down to cnp.http.url.port and double-click.
3. On the Edit window, perform the following steps:
a. Change the port number value to the port number you want.
b. Select the In Use check box.
Note: If you fail to select this check box, the port number value that you entered will revert to the
original value.
c. Click OK.
4. On the Configure Application Instance window, verify that the port number value (in the Value column)
for cnp.http.url.port has changed.
5. Click OK.
Configuring port number assignments for monitoring agents

IBM Tivoli monitoring uses the following algorithm to allocate port numbers for monitoring agents to reach
the monitoring server:
reserved port = well-known port + (N*4096)
where:
v well-known port is the port number assigned to the monitoring server, for example, 1918.
v N indicates the position of the monitoring agent in the startup sequence for agents.
For example, if there are two monitoring agents on a system, and the monitoring server uses port 1918,
the first monitoring agent in the startup sequence is assigned port 6014 (1918 + 1*4096) and the second
agent to start is assigned port 10110 (1918 + 2*4096).
For "piped" protocols such as IP.PIPE and IP.SPIPE (but not IP or SNA), you can control the way port
numbers are assigned to a monitoring agent by using the SKIP and COUNT parameters on the
KDE_TRANSPORT environment variable for agents running on Windows or the KDC_FAMILIES
environment variable for agents running on Linux/UNIX. See the following example:
KDE_TRANSPORT=IP.PIPE PORT:1918 COUNT:1 SKIP:2 IP use:n SNA use:n IP.SPIPE use:n
See also the following information about using the IP.PIPE and IP.SPIPE protocols and parameters:
v The PORT parameter specifies the well-known port for the monitoring server.
v The COUNT:N parameter is the mechanism for reserving IP.PIPE ports for components that connect to
the monitoring server. N is the number of IP.PIPE ports to reserve on a host in addition to the
well-known port for the monitoring server. Use the COUNT parameter to reserve ports for components
that must be accessible from outside a firewall. Accessibility from outside the firewall requires IP.PIPE
ports and because these ports must be permitted at the firewall, the ports must be predictable.
For example, if the well-known port is 1918, COUNT:3 starts the search at port 6014 (1918 + 1*4096). If
the agent process cannot bind to port 6014, the algorithm tries port 10110 (1918 + 2*4096). If port
10110 is not available, the search goes to port 14206 (1918 + 3*4096).
The agent is assigned to the first available port encountered in the search. The process fails to start if
the search reaches the highest port without a successful binding (port 14206 in this example).
268
v The SKIP:N parameter specifies the number of ports to skip when starting the search for an available
port using the port assignment algorithm. Use the SKIP parameter for components that do not need
access across a firewall.
For example, if the well-known port is 1918, SKIP:2 specifies to start the search at port 10110 (1918 +
2*4096), skipping ports 1918 and 6014 (1918 + 1*4096). The algorithm continues searching until it finds
an available port.
v The USE parameter enables or disables a protocol. To disable a protocol, specify use:n. To enable a
protocol, specify use:y. This parameter has no default.
Note: Tivoli Monitoring agents allocate ports 1920 and 3661 as HTTP and HTTPS listener ports.
Example
The example in Table 59 shows the coding to use on a system that contains the components shown:
Table 59. Using COUNT and SKIP variables to assign port numbers
Component
Coding
The monitoring server uses port 1918.
KDE_TRANSPORT=IP.PIPE COUNT:1
Requires firewall access
Windows OS agent
Does not require firewall access
This coding reserves port 6014 (1918 + 1*4096) for the

Warehouse Proxy agent.
KDE_TRANSPORT=IP.PIPE SKIP:2
With this coding, the port assignment algorithm skips
ports 1918 and 6014 (reserved for the monitoring server
and Warehouse Proxy agent), and starts at port 10110
(1918 + 2*4096). If the Windows OS agent fails to open
port 10110, the agent tries port 14206 and so on, until it
finds an available port or exhausts all possibilities.
Adding the KDE_TRANSPORT environment variable

The KDE_TRANSPORT environment variable must be added to the appropriate file (*ENV file on
Windows).
Note: The KDE_TRANSPORT variable supersedes and overrides the KDC_FAMILIES variable. If a
KDC_FAMILIES variable exists in the file, merge the KDC_FAMILIES settings with the
KDE_TRANSPORT settings. Copy the KDC_FAMILIES settings that you want to keep to the new
KDE_TRANSPORT variable.
Use the following procedures to add the KDE_TRANSPORT environment variable to the appropriate file:
On Windows:
Add the KDE_TRANSPORT environment variable to the ENV file for the component.
For example, the ENV file for the Windows OS agent is named KNTENV, where NT is the product code for
the Windows OS agent. For a list of product codes, see Appendix D, IBM Tivoli product, platform, and
Edit the ENV file:
1. In the Manage Tivoli Enterprise Monitoring Services window, right-click the component that you want to
change, point to Advanced, and select Edit ENV File.
2. Add a line similar to the following example:
269
KDE_TRANSPORT=IP.PIPE PORT:1918 COUNT:N SKIP:N

IP use:n SNA use:n IP.SPIPE use:n
where N is the number of ports to reserve (COUNT:N) or the number of ports to skip (SKIP:N). This
example uses the IP.PIPE protocol. It also applies to IP.SPIPE.
3. Search the file for a KDC_FAMILIES environment variable. If a KDC_FAMILIES variable exists in the
file, merge its settings with the new KDE_TRANSPORT variable. The KDE_TRANSPORT variable
supersedes and overrides the KDC_FAMILIES variable.
4. Save the file.
5. Recycle the component. (Right-click the component and select Recycle.)
Configuring the heartbeat interval

IBM Tivoli Monitoring uses a heartbeat mechanism to monitor the status of remote monitoring servers and
monitoring agents. The different monitoring components in the monitoring architecture form a hierarchy
(shown in Figure 39) across which the heartbeat information is propagated.
The hub monitoring server maintains status for all monitoring agents. Remote monitoring servers offload
processing from the hub monitoring server by receiving and processing heartbeat requests from monitoring
agents, and communicating only status changes to the hub monitoring server.
Figure 39. Hierarchy for the heartbeat interval
At the highest level, the hub monitoring server receives heartbeat requests from remote monitoring servers
and from any monitoring agents that are configured to access the hub monitoring server directly (rather
than through a remote monitoring server). The default heartbeat interval used by remote monitoring
servers to communicate their status to the hub monitoring server is 3 minutes. The default heartbeat
interval of 3 minutes for monitoring servers is suitable for most environments, and should not need to be
changed. If you decide to modify this value, carefully monitor the system behavior before and after making
the change.
270
At the next level, remote monitoring servers receive heartbeat requests from monitoring agents that are
configured to access them. The default heartbeat interval used by monitoring agents to communicate their
status to the monitoring server is 10 minutes.
You can specify the heartbeat interval for a node (either a remote monitoring server or a remote
monitoring agent) by setting the CTIRA_HEARTBEAT environment variable. For example, specifying
CTIRA_HEARTBEAT=5 sets the heartbeat interval to 5 minutes. The minimum heartbeat interval that can
be configured is 1 minute.
v For monitoring servers on Windows computers, you can set this variable by adding the entry to the
KBBENV file. You can access this file from the Manage Tivoli Enterprise Monitoring Services utility by
right-clicking Windows OS Monitoring Agent and clicking Advanced -> Edit ENV File. Note that you
must stop and restart the monitoring server for the changes to the KBBENV file to take effect.
v For monitoring servers on Linux and UNIX computers, you can set the CTIRA_HEARTBEAT variable by
adding the entry to the monitoring server configuration file. The name of the monitoring server
configuration file is of the form hostname_ms_temsname.config. For example, a remote monitoring
server named REMOTE_PPERF06 running on host pperf06 has a configuration filename of
pperf06_ms_REMOTE_PPERF06.config. Note that you must stop and restart the monitoring server for the
configuration changes to take effect.
v For remote monitoring servers, you can set this variable by adding an entry to the KBBENV file. You
can access this file from Manage Tivoli Enterprise Monitoring Services by right-clicking Tivoli
Enterprise Monitoring Server and clicking Advanced Edit ENV File. You must stop and restart the
monitoring server for changes to the KBBENV file to take effect.
v For Windows OS agents, you can set this variable by adding the entry to the KNTENV file. You can
access this file from Manage Tivoli Enterprise Monitoring Services by right-clicking Windows OS
Monitoring Agent and clicking Advanced Edit ENV File. You must stop and restart the monitoring
agent for the changes to the KNTENV file to take effect.
v For agents on Linux and UNIX computers, you can set the CTIRA_HEARTBEAT variable by adding an
entry to the agent .ini file (for example, lz.ini, ux.ini, ua.ini). When the agent is stopped and restarted,
the agent configuration file is recreated using settings in the .ini file.
When a monitoring agent becomes active and sends an initial heartbeat request to the monitoring server, it
communicates the desired heartbeat interval for the agent in the request. The monitoring server stores the
time the heartbeat request was received and sets the expected time for the next heartbeat request based
on the agent heartbeat interval. If no heartbeat interval was set at the agent, the default value is used.
Changes to offline status typically require two missed heartbeat requests for the status to change. Offline
status is indicated by the node being disabled in the portal client's Navigator View. If the heartbeat interval
is set to 10 minutes, an offline status change would be expected to take between 10 and 20 minutes
before it is reflected on the portal client's Navigator View.
Attention: Lower heartbeat intervals increase CPU utilization on the monitoring servers processing the
heartbeat requests. CPU utilization is also affected by the number of agents being monitored. A low
heartbeat interval and a high number of monitored agents could cause the CPU utilization on the
monitoring server to increase to the point that performance related problems occur. If you reduce the
heartbeat interval, you must monitor the resource usage on your servers. A heartbeat interval lower than 3
minutes is not supported.
Restarting the Tivoli Enterprise Portal Server after reconfiguration

The Tivoli Enterprise Portal Server must be stopped before it can be reconfigured.
v If the portal server is running and you ask to reconfigure it, a warning is first displayed informing you
that the server must be stopped and asking if you want to continue.
v If the portal server is running and you allow it to be stopped for reconfiguration, you are asked when the
configuration process ends if you want the server restarted.
271
Switching to a different Tivoli Enterprise Portal Server database

You can change to a different RDBMS after you have installed the Tivoli Enterprise Portal Server. To do
this:
1. Bring up the Manage Tivoli Enterprise Monitoring Services main screen, and right-click the Tivoli
Enterprise Portal Server entry. See Figure 40.
Figure 40. Manage Tivoli Enterprise Monitoring Services Advanced Utilities window
2. From the pop-up menu, select Advanced Utilities Build TEPS Database.
v If the only RDBMSes installed on this computer are DB2 Database for Linux, UNIX, and Windows
and the portal server's embedded Derby database, select the appropriate database manager, as
shown in Figure 41 on page 273.
272
Figure 41. The Manage Tivoli Enterprise Monitoring Services select the new portal server database window. Only
available databases DB2 for the workstation and Derby
v If this computer is running both DB2 Database for Linux, UNIX, and Windows, Microsoft SQL
Server, and embedded Derby, select the appropriate database manager, as shown in Figure 42.
Figure 42. The Manage Tivoli Enterprise Monitoring Services select the new portal server database window. The
available databases are DB2 for the workstation, SQL Server, and Derby
Note: Changing to a different database does not migrate the portal server data stored in it.
3. Continue with the database configuration, as explained in number 12 on page 140 under Prerequisites
for the single-computer installation on page 139.
273
274
Chapter 11. Additional Linux and UNIX configuration steps

The following sections provide information about additional configuration that may be required for Linux
and UNIX systems:
v Disabling fsync() calls
v Configuring permissions for a monitoring server on a non-NIS Solaris computer
v Increasing virtual memory on AIX for large environments
v Linux requirements for the localhost host name on page 277
v Setting ulimit values for the Warehouse Proxy Agent on page 277
Disabling fsync() calls

The KGLCB_FSYNC_ENABLED parameter was introduced in V6.2 for the Tivoli Enterprise Monitoring
Server on UNIX and Linux operating systems. This variable can be used to specify whether the fsync()
system call should be invoked after writes to the filesystem. This configuration variable may be set in the
standard configuration file for the monitoring server.
For maximum reliability, by default fsync() is called. The fsync() system call flushes the filesystem's dirty
pages to disk and protects against loss of data in the event of an operating system crash, hardware crash,
or power failure. However, the call can have a significant negative effect on performance, because in many
cases it defeats the caching mechanisms of the platform filesystem. On many UNIX platforms, the
operating system itself syncs the entire filesystem on a regular basis. For example, by default the syncd
daemon that runs on AIX syncs the filesystem every 60 seconds, which limits the benefit of fsync() calls
by application programs to protecting against database corruption in the most recent 60-second window.
If the following line is added to the monitoring server configuration file, fsync() calls are omitted:
KGLCB_FSYNC_ENABLED='0'
Configuring permissions for a monitoring server on a non-NIS Solaris

computer
If your monitoring server is installed on a non-NIS Solaris computer, you must set the permissions. You do
not need to do this for monitoring servers running on AIX or Linux.
Set permissions for a monitoring server on a non-NIS Solaris system as follows:
1. Go to the /bin directory where file kdsvlunx is located (install_dir/arch/ms/bin, where arch is the
operating system on which the monitoring agent was installed).
2. Move the file to the root user ID if you have the root password; otherwise obtain the password from an
administrator:
su root
chown root kdsvlunx
chmod u+s kdsvlunx
3. Return to your regular ID after you have moved the user ID to root.
Increasing virtual memory on AIX for large environments

The Tivoli Enterprise Portal Server process (KfwServices) is linked with the default memory model, which
allows for data and stack of only 256 MB. In large environments, this can cause the portal server to crash
at startup. In smaller environments, this may not cause a problem at startup, but may become one at
some later point as more virtual storage is required. The problem can be predicted if the topas command
shows KfwServices with a PgSp value of 180-250 MB. If a smaller environment is close to that value, it
275
may occur when large queries are being handled. If the topas output shows that KfwServices is nearing
these values, the memory model should be changed in smaller environments as well as large ones.
Note: This section applies only to a 32-bit portal server running on AIX. When installed for the first time
on an AIX system with a 64-bit kernel, a 64-bit portal server is installed, and this procedure is not
needed. When upgrading from previous versions, the 32-bit portal server will be rebuilt, so you
must re-enable the large-memory model for the KfwServices process.
Changing the memory model requires that the KfwServices load header be modified. Also, changes must
be made to your DB2 for the workstation configuration. Complete the following steps to make these
changes. These steps use the default directory. Use the directory locations appropriate to your system.
Important:: You must run the ldedit command below each time new Tivoli Enterprise Portal Server
maintenance has been applied.
To make the required memory model and DB2 for the workstation configuration changes:
1. Stop the Tivoli Enterprise Portal Server:
cd /opt/IBM/ITM/bin ./itmcmd agent stop cq
2.
Issue the following commands:

cd /opt/IBM/ITM/aix533/cq/bin
cp KfwServices KfwServices.orig
/usr/ccs/bin/ldedit -bmaxdata:0x80000000 KfwServices
3. To verify that the maxdata value has been set issue the following command:
dump -ov KfwServices
This command displays the maxdata value in KfwServices. Maxdata should show as:
maxSTACK maxDATA SNbss magic modtype 0x00000000 0x80000000 0x0003 0x010b 1L
4. Issue the following command:

cd /opt/IBM/ITM/config
5. Using your preferred editor add the following line to file cq.ini:
EXTSHM=ON
6. Using the DB2 for the workstation installation user ID (the default value is db2inst1), make the DB2 for
the workstation configuration changes as follows:
a. Stop the DB2 for the workstation server if not already stopped:
cd /db2inst1/sqllib/adm db2stop
b. Issue the following configuration changes:

export EXTSHM=ON
db2set DB2ENVLIST=EXTSHM
db2set -all
c. Using your preferred editor add the following lines to /db2inst1/sqllib/db2profile:

EXTSHM=ON
export EXTSHM
d. Restart DB2 for the workstation:

cd /db2inst1/sqllib/adm db2start
7. Restart the portal server:

cd /opt/IBM/ITM/bin ./itmcmd agent start cq
For more information about using the large and very large address-space models to accommodate
programs requiring data areas that are larger than those provided by the default address-space model,
see http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.genprogc/doc/
genprogc/lrg_prg_support.htm. For more information about using the EXTSHM environment variable to
276
increate the number of share memory segments to which a single process can be attached, see
http://publib.boulder.ibm.com/infocenter/db2luw/v8/index.jsp?topic.
Linux requirements for the localhost host name

KDH servicepoint manipulation and the kdh (http/https) port-sharing code requires the availability of
localhost: the localhost host name must exist and be resolvable to an address on the local system.
Typically, localhost resolves to the loopback device with IP address 127.0.0.1. If localhost does not exist
or cannot be resolved to an IP address, http-based servers (the SOAP server, the IBM Tivoli Monitoring
Service Console, the Tivoli Enterprise Portal Server) will fail to initialize.
When localhost resolves to an address other than 127.0.0.1, a network interface must be locally
available and configured to IP with that localhost network address.
Setting ulimit values for the Warehouse Proxy Agent

There is a limit on the number of open file descriptors that can be opened by the Warehouse Proxy
process when it is running on UNIX and Linux systems. When a Tivoli Monitoring operating system
monitoring agent connects to the Warehouse Proxy Agent, it uses a set of file descriptors for
communication. When the number of operating system agent connections exceeds the file descriptor limit,
the agent process consumes high amounts of CPU as it is unable to send data.
To correct this high CPU situation, the ulimit value must be set to a value higher than the maximum
number of file descriptors that could be opened to the Warehouse Proxy Agent. The value that should be
used is based upon the following conditions:
The minimum number of file descriptors used by the Warehouse Proxy Agent process is X + Y + 10,
where:
X
Is the number of agents warehousing to the Warehouse Proxy Agent
Is the number of database connections between Warehouse Proxy Agent and the database
server. (The default number of database connections is 10; you can change this number.)
10
Is the number of log and configuration files used by the Warehouse Proxy Agent.
The value used for the file descriptor ulimit should be high enough so that the limit is not met. A simpler
formula is X + 1000, where X is the number of agents warehousing.
After you determine the value for the file descriptor ulimit, modify the ulimit as appropriate for the
operating system. Refer to the system documentation for the command (usually ulimit) and procedures to
make this change permanently across system restarts, or contact your UNIX or Linux System
Administrator.
Chapter 11. Additional Linux and UNIX configuration steps
277
278
Chapter 12. Additional Tivoli Enterprise Portal configurations

This chapter discusses how to perform the following advanced configuration of Tivoli Enterprise Portal
components:
v Connecting the Tivoli Enterprise Portal Server on Windows to a different monitoring server
v Using SSL between the portal server and the client on page 280
v Configuring an external Web server to work with Tivoli Enterprise Portal on page 282
v Configuring a portal client connection to an external Web server on page 284
v Firewall network address translation (NAT) or multiple network interface cards on page 286
v Firewall scenarios for Tivoli Enterprise Portal on page 287
It also includes illustrations of firewall scenarios that can help in defining the Tivoli Enterprise Portal Server
interface.
Connecting the Tivoli Enterprise Portal Server on Windows to a

different monitoring server
When reconfiguring the portal server on Windows for a different Tivoli Enterprise Monitoring Server, a
pop-up window is displayed asking if a snapshot of the current Tivoli Enterprise Portal Server data should
first be taken (see Figure 43).
Figure 43. Tivoli Enterprise Portal Server snapshot request screen
The default response is Yes.

Note: When reconfiguring the portal server to communicate with a Hot Standby monitoring server, the
correct response is No, as the same portal server data should be used for both the primary
monitoring server and the secondary monitoring server. See the IBM Tivoli Monitoring:
High-Availability Guide for Distributed Systems.
When Yes is selected, a snapshot of the portal server data is taken via the migrate-export process. The
data is saved in a file named saveexport.sql and is placed in %CANDLE_HOME%\CNPS\CMS\hostname:port,
where hostname:port is the current monitoring server's hostname and connection port number.
When this process completes, the verification screen shown in Figure 44 on page 280 is shown.
279
Figure 44. Tivoli Enterprise Portal Server snapshot verification screen
If no existing snapshot can be found for the monitoring server that is being switched to, a new set of portal
server data is created, which means all existing customizations will not be included. To restore these for
use with the new monitoring server (if needed), invoke the migrate-import process using as input the
saveexport.sql file created during the previous snapshot request.
When reconfiguring the Tivoli Enterprise Portal Server to switch back to the previous Tivoli Enterprise
Monitoring Server, answering Yes causes the previous snapshot to be automatically loaded, thus restoring
your prior customizations.
Using SSL between the portal server and the client

You can choose to encrypt all communication between the portal server and portal client. IBM Tivoli
Monitoring uses two protocols to provide this level of security between portal server and client server:
v Secure Hypertext Transport Protocol (HTTPS) to retrieve files and Interoperable Object Reference
(IOR). The integrated browser in the client provides HTTPS support on the client side; for the server,
consider using a third party web server that supports HTTPS, such as the IBM HTTP Server. See
Configuring an external Web server to work with Tivoli Enterprise Portal on page 282 for more
information.
v Internet Inter-ORB Protocol (IIOP) to secure the communications between the portal server and client.
This uses the Secure Sockets Layer (SSL) API provided by VisiBroker. This secure communication uses
public key cryptography.
When you install IBM Tivoli Monitoring, the Global Security Toolkit (GSKit) and iKeyman utilities are
installed by default on all components. These utilities are used to create and manage the encryption of
data between components through the use of digital certificates.
Digital certificates are the vehicle that SSL uses for public-key cryptography. Public-key cryptography uses
two different cryptographic keys: a private key and a public key. Public-key cryptography is also known as
asymmetric cryptography, because you can encrypt information with one key and decrypt it with the
complement key from a given public/private key pair.
Public/private key pairs are simply long strings of data that act as keys to a user's encryption scheme. The
user keeps the private key in a secure place (for example, encrypted on a computers hard drive) and
provides the public key to anyone with whom the user wants to communicate. The private key is used to
digitally sign all secure communications sent from the user; the public key is used by the recipient to verify
the senders signature.
Public/private key pairs are validated by a trusted third party, called a Certificate Authority (CA). An
example of a CA is Verisign. If you are setting up your own key pairs, you submit them to the CA for
validation.
280
If you intend to use SSL for communication between the Tivoli Enterprise Portal Server and its clients, use
the GSKit provided with IBM Tivoli Monitoring to manage certificates and keys. See the IBM Tivoli
Monitoring: Administrator's Guide for instructions for setting up this encryption.
For additional information about using public/private key pairs, see the iKeyman documentation available
at http://www-128.ibm.com/developerworks/java/jdk/security/50/.
Enabling and disabling SSL for the Tivoli Enterprise Portal Server
IBM Tivoli Monitoring is shipped with SSL disabled as the default.
If you want to use Secure Sockets Layer communication between the portal server and the portal client,
use the following steps to enable it:
Note: This procedure disables the primary interface. For instructions on disabling additional interfaces,
see Chapter 12, Additional Tivoli Enterprise Portal configurations, on page 279.
On a Windows system:
Server.
2. Click Advanced Configure TEPS Interfaces.
3.
4.
5.
6.
Highlight cnps and click Edit in the TEPS Interface Definitions window.
Select Enable SSL for TEP Clients.
Click OK to save your changes and close the window.
Recycle the service by stopping and starting it.
On a Linux system:
1. Change to the install_dir/bin directory
./itmcmd manage
Server.
4. Click Configure
5. In the first tab, select Enable SSL for TEP Clients to enable SSL in the Tivoli Enterprise Portal Server
window.
6. Click OK to save your changes and close the window.
7. Recycle the service by stopping and starting it.
Disabling SSL
If you do not want to use Secure Sockets Layer communication between IBM Tivoli Monitoring
components and the Tivoli Enterprise Portal Server, use the following steps to disable it:
Note: Each interface independently enables or disables SSL. If you are using multiple interfaces, you
must disable all of them.
1. In Manage Tivoli Enterprise Monitoring Services, right-click Tivoli Enterprise Portal Server.
2. Click Advanced Edit ENV file.
3. Find the following line:
kfw_interface_cnps_ssl=Y
4. Change the Y to N.
5. Save the file and exit.
6. Click Yes when you are asked if you want to recycle the service.
281
Configuring an external Web server to work with Tivoli Enterprise

Portal
If you want to use an external Web server to view the Tivoli Enterprise Portal, you need to configure that
Web server. The following sections provide configuration information for Microsoft Internet Information
Server versions 5.0 and 6.0, IBM HTTP Server, and Apache HTTP Server.
v Configuring Internet Information Server V5.0
v Configuring Internet Information Server V6.0
v Configuring IBM HTTP Server and Apache HTTP Server on page 283
Configuring Internet Information Server V5.0

Use the following steps to configure Internet Information Server V5.0 to work as a Tivoli Enterprise Portal
browser client.
1. Start the Internet Services Manager.
2. Right click the WWW service (the system host name).
3. Select Master Properties and click Edit.
4. Click the Directory Security tab.
5. Click Edit.
6. Ensure that Anonymous access and Integrated Windows authentication are selected and click
OK.
7. Click the Documents tab.
8. Click Add.
9. Type index.html in the Default Document Name field.
10. Click OK and then click OK to close the Master Properties notebook.
Use the following steps to set up the Web site:
1. From the Internet Services Manager, right-click the WWW service.
2. Click New Web Site.
3. Click Next.
4. Type a description for the Web site (for example, "ITM").
Note: Refer to the documentation for Internet Information Server before changing any of the default
values in the next steps.
5. If you have multiple IP addresses, select the one that is appropriate for this site.
6. If you want to use a separate port of this site, type the port number in the TCP Port field.
7. Type the path to the Tivoli Enterprise Portal browser client. The default path is C:\IBM\ITM\CNB.
8. Ensure that Read and Run Scripts are selected. Do not select Execute.
9. Click Next and then click Finish.
If the site does not start automatically, right-click it and click Start.
Configuring Internet Information Server V6.0

Use the following steps to configure Internet Information Server V6.0 on Windows 2003 to work as a Tivoli
Enterprise Portal browser client:
1. Start IIS Manager.
2. Right-click Web Sites and click New Web Site.
3. Click Next.
4. Type the name of a Web site (for example "Tivoli") and click Next.
282
5. Type the IP address for the Tivoli Enterprise Portal Server computer (this should be the same
computer where IIS 6.0 is running) and click Next.
6. Type the path to the IBM Tivoli Monitoring home directory that is the root of the Web Content
subdirectories. The default path is C:\IBM\ITM\CNB. Click Next.
7. Select Read, Run scripts, and Execute. Click Next.
8. Click Finish.
9. Right-click the new Web site and click Properties.
10. Click the Documents tab.
11. In the Add Content Page field, type index.html. This is the main page for the Tivoli Enterprise
Portal.
12. Click the Move Up button to move index.html to the top of the list.
13. Click the HTTP Headers tab.
14. Click MIME Types.
15. Click New next to MIME Types.
16.
17.
18.
19.
Type *.asp in the Extension field.

Type application/x-asp in the MIME Type field.
Click OK.
Repeat Steps 15 to 18 for each of the following:
Extension
MIME Type
.class
application/java-class
.ior
application/octet-stream
.jar
application/java-archive
.jks
.jnlp
application/x-java-jnlp-file
.js
application/x-javascript
.llser
.pl
application/x-perl
.ser
application/java-serialized-object
.txt
text/plain
.zip
20. Click OK.
21. Click Apply.
application/zip
22. Click OK.
Configuring IBM HTTP Server and Apache HTTP Server

Use the following steps to configure IBM HTTP Server or Apache HTTP Server to work on a computer
with a Linux, UNIX, or Windows operating system:
1. Install the server with the default settings. See the product documentation (www-306.ibm.com/software/
webservers/httpservers/library) for additional information.
2. Open the httpd.conf file in a text editor.
On the IBM HTTP Server, this file is located in the conf directory of the server installation directory. For
the Apache server, the file is typically located in the /etc/httpd/conf/ directory, but may be found in
some other location specific to the platform.
3. Find the line that begins with DocumentRoot.
283
v On Linux and UNIX computers, change the value between the double quotation marks ("") to
itm_installdir/os_dir/cw, where itm_installdir is the directory where IBM Tivoli Monitoring is
installed and os_dir is the operating system type (li6263 for SLES9 for Intel systems, li3263 SLES9
for zSeries systems, or aix533for AIX systems). For example:
/opt/IBM/ITM/ls3263/cw
v On Windows computers, change the value between the double quotation marks () to
itm_installdir/CNB where itm_installdir is the directory where IBM Tivoli Monitoring is installed.
Use forward slashes for the path. For example:
DocumentRoot "C:/IBM/ITM/CNB"
4. Find the line that begins with <Directory docRoot>. Change the path to the value used for
DocumentRoot. (From our previous examples, this would be itm_installdir/ls3263/cw on Linux and
UNIX and itm_installdir/CNB on Windows.)
6. Open the mime.types file in a text editor and make the following changes. For the IBM HTTP Server,
this file is located in the conf directory of the server installation directory. For an Apache server, this file
is typically located in /etc/mime.types, but the location may differ by platform. You may need to search
for the file.
a. If the following lines are not in the file, add them:
application/java-archive jar
image/icon ico
b. If you will be using Java Web Start and the following lines are not in the file, add them:
application/x-java-jnlp-file jnlp
image/x-icon ico
c. Modify the line that begins with application/octet-stream to include ior ser at the end. For
example:
application/octet-stream bin dms lha lzh exe class so dll cab ior ser

8. Stop the IBM HTTP Server or Apache HTTP Server services, then start it again to enable the
configuration changes.
Configuring a portal client connection to an external Web server

Use the following sections to configure your portal client to work with an external Web server:
v Browser client
v Desktop client
v Web Start client on page 285
Browser client
During installation, the IBM Tivoli integral Web server is installed as a component of the Tivoli Enterprise
Portal Server. You can also use an external Web server on your Tivoli Enterprise Portal Server computer,
as shown in Firewall scenarios for Tivoli Enterprise Portal on page 287.
Currently, IBM supports an external Web server for browser client access only when the external server is
installed on the same computer as the Tivoli Enterprise Portal Server.
Desktop client
Although the desktop client does not need a Web server to start Tivoli Enterprise Portal, it does use it for
common files stored on the Tivoli Enterprise Portal Server, such as the graphic view icons and style
sheets. If your Tivoli Enterprise Portal Server setup disables the integral Web server and uses only an
external Web server, you need to specify the Interoperable Object Reference (IOR) for every desktop
client.
284
Updating the IOR for Windows

Use the following steps to specify the IOR for the desktop client:
1. On the computer where Tivoli Enterprise Portal desktop client is installed, open Manage Tivoli
Enterprise Monitoring Services
2. Right-click Tivoli Enterprise Portal Desktop and click Reconfigure.
3. Double-click cnp.http.url.DataBus in the parameters list.
The Edit Tivoli Enterprise Portal Parm window is displayed.
4. In the Value field, type the Web server address where the cnps.ior can be found.
For example, if the Web server name is xyz.myserver.com and the document root for the Web server
is \ibm\itm\cnb, the value is http://xyz.myserver.com/cnps.ior.
5. Select In Use and click OK.
6. Click OK to close the window.
Updating the IOR for Linux

Use the following steps to specify the IOR for the desktop client:
1. On the computer where the Tivoli Enterprise Portal desktop client is installed, go to the
install_dir/bin directory and edit the cnp.sh shell script.
If you are configuring an instance of the desktop client, the name of the file is cnp_instancename.sh.
2. Add the following parameter to the last line of the file specifying the Web server address where the
cnps.ior can be found for the value. For example, if the Web server name is xyz.myserver.com and the
document root for the Web server is /candle/cnb, the value is http://xyz.myserver.com/cnps.ior.
-Dcnp.http.url.DataBus=http://xyz.myserver.com/cnps.ior
Note: The last line of cnp.sh is very long and has various options on it, including several other -D
options to define other properties. It is very important to add the option in the correct place.
If the last line of your bin/cnp.sh originally looked like this:
-Dhttp.proxyHost=
To specify the IOR, change the line to look like the following:
-Dcnp.http.url.DataBus=http://xyz.myserver.com/cnps.ior
-Dhttp.proxyHost=
Web Start client

If you will be using a desktop client deployed using Web Start, you must edit several configuration
templates to enable connection to an external web server.
Take the following steps to configure the Web Start client:
1. On the host of the Tivoli Enterprise Portal Server, change to the following directory:
v Windows: itminstall_dir\config (for example, c:\ibm\itm\config)
v UNIX and Linux: itminstall_dir/config (for example, /opt/IBM/ITM/config)
2. Open tep.jnlpt in a text editor, and make the following changes:
v Replace the line:
285
codebase=http://$HOST$:$PORT$///cnp/kdh/lib
with:
codebase= http://$HOST$/
.
v Add the following statement to the set of <property> elements underneath the <resources>
section:
<property name="cnp.http.url.DataBus" value="http://$HOST$/cnps.ior"/>
3. Open component.jnlpt in a text editor, and make the following change:

v Replace the line:
codebase="http://$HOST$:$PORT$///cnp/kdh/lib/"
with the following line:

codebase="http://$HOST$/"
4. For these changes to take effect, reconfigure the Tivoli Enterprise Portal Server.
Use the following URL to launch the Java Web Start client:
http://teps_hostname/tep.jnlp
Firewall network address translation (NAT) or multiple network

interface cards
The URL for starting Tivoli Enterprise Portal in browser mode includes the Tivoli Enterprise Portal Server
host name or IP address. The address for starting Tivoli Enterprise Portal is set for the desktop client
during installation or through Manage Tivoli Enterprise Monitoring Services. If any of the following is true in
your configuration, you need to define a Tivoli Enterprise Portal Server interface:
v A firewall with Network Address Translation (NAT) is used between the client and the Tivoli Enterprise
Portal Server.
v The host of the Tivoli Enterprise Portal Server has more than one Network Interface Card (NIC).
On Windows you define an interface using Manage Tivoli Enterprise Monitoring Services. On Linux and
AIX, you edit the lnxenv file manually.
Defining a Tivoli Enterprise Portal Server interface on Windows

Use the following steps to define a Tivoli Enterprise Portal Server interface on Windows:
1. On the computer where the Tivoli Enterprise Portal Server is installed, click Start Programs IBM
Tivoli Monitoring Manage Tivoli Monitoring Services.
2. Right-click Tivoli Enterprise Portal Server.
3. Click Advanced Configure TEPS Interfaces.
Initially, the list has one definition named "cnps," using port 15001 for the Tivoli Enterprise Portal
Server and the IBM Tivoli integrated Web server at http://mysystem:1920///cnp/client (where the
variable mysystem is the host name). Port 80, for an external Web server, is assumed if the URL does
not specify 1920 for the integrated Web server.
Note: If IIS is being used as the external Web server for Tivoli Enterprise Portal over a firewall, you
may experience performance problems like slow download times. Socket pooling may also
cause problems under certain conditions. If you encounter problems, try using a port other than
the default port 80 on the IIS server.
4. Click Add.
5. Define the interface. Complete the following fields:
286
Interface Name
Type a one-word title for the interface.
Host
If you are defining an interface for a specific NIC or different IP address on this computer, type
the TCP/IP host address. Otherwise, leave this field blank.
Proxy Host
If you are using address translation (NAT), type the TCP/IP address used outside the firewall.
This is the NATed address.
Port
Type a new port number for the Tivoli Enterprise Portal Server. The default 15001 is for the
server host address, so a second host IP address or a NATed address requires a different port
number.
Proxy Port
If the port outside the firewall will be translated to something different than what is specified for
Port, set that value here.
Enable SSL for TEP clients
Enable secure communications between clients and the portal server.
6. Click OK to add the new Tivoli Enterprise Portal Server interface definition to the list.
Defining a Tivoli Enterprise Portal Server interface on Linux or UNIX

To define an additional Tivoli Enterprise Portal interface on Linux or UNIX, edit the install_dir/platform/cq/
bin/lnxenv file as follows:
1. Locate the KFW_INTERFACES= variable and add the one-word name of the new interface, separating
it from the preceding name by a space. For example:
KFW_INTERFACES=cnps myinterface
2. Following the entries for the default cnps interface, add the following variables as needed, specifying
the appropriate values:
KFW_INTERFACE_interface_name_HOST=
If you are defining an interface for a specific NIC or different IP address on this computer,
specify the TCP/IP host address.
KFW_INTERFACE_interface_name_PORT=
Type a port number for the Tivoli Enterprise Portal Server. The default 15001 is for the server
host address, so a second host IP address or a NATed address requires a different port
number.
KFW_INTERFACE_interface_name_PROXY_HOST=
If you are using address translation (NAT), type the TCP/IP address used outside the firewall.
This is the NATed address.
KFW_INTERFACE_interface_name_PROXY_PORT=
If the port outside the firewall will be translated to something different than what is specified for
Port, set that value here.
KFW_INTERFACE_interface_name_SSL=Y
If you want clients to use Secure Sockets Layers (SSL) to communicate with the Tivoli
Enterprise Portal Server, add the following variable.
Firewall scenarios for Tivoli Enterprise Portal

The following diagrams illustrate several firewall scenarios using various combinations of the IBM Tivoli
integral Web server, an external Web server (such as Apache or IBM HTTP Server), NAT, and a second
NIC on the Tivoli Enterprise Portal Server computer. These scenarios can help you to define the Tivoli
Enterprise Portal Server interface.
287
Note: You can download the IBM HTTP Server for free at http://www-306.ibm.com/software/webservers/
httpservers/.
Figure 45 shows scenario with the following configuration:
v Has an intranet firewall
v Has no NAT
v Uses the integral Web server
Figure 45. Intranet with integral Web server
The default Tivoli Enterprise Portal Server interface "cnps" is used. No additional interface definitions are
needed. Browser mode users, whether going through the firewall or not, start Tivoli Enterprise Portal at:
http://10.10.10.10:1920///cnp/client
or substitute the host name for the IP address.

For configurations using the integrated Web server and these port numbers, use the default cnps interface
definition.
In this scenario, the monitoring server and agents can be installed on the Tivoli Enterprise Portal Server
computer.
Figure 46 on page 289 shows a scenario that has the following configuration:
v Has an intranet firewall
288
v Has no NAT
v Uses an external Web server (such as IBM HTTP Server, Apache or IIS)
Figure 46. Intranet with external Web server
Browser mode users, whether going through the firewall or not, start Tivoli Enterprise Portal Server with
http://10.10.10.10 or http://10.10.10.10/mydirectory
(where mydirectory is the alias), or substitute the host name for the IP address.
For intranet configurations using an external Web server, with no NAT, you do not need to add a new
interface definition. Web server port 80 is used automatically when none is specified in the URL.
In this scenario, the monitoring server and agents can be installed on the Tivoli Enterprise Portal Server
computer.
Figure 47 on page 290 shows the following two-part configuration:
v Intranet firewall without NAT and using the integral Web server
v Internet firewall with NAT and using an external Web server
289
Figure 47. Intranet with integral Web server; Internet with external Web server
Intranet users can enter the URL for either the integral Web server or the external Web server:
http//10.10.10.10:1920///cnp/client or http://10.10.10.10
Internet users enter the URL for the NATed address:

http://198.210.32.34/?ior=internet.ior
(or substitute the host name for the IP address).

The Internet configuration requires a new Tivoli Enterprise Portal Server interface named "internet", with
proxy host address 198.210.32.34 and port number 15002. The intranet firewall uses the "cnps" definition.
In this scenario, the monitoring server and agents cannot be installed on the Tivoli Enterprise Portal Server
computer.
Figure 48 on page 291 shows the following three-part configuration:
v Intranet firewall with NAT through the firewall to the external Web server
http://192.168.1.100/?ior=intranet.ior
v Without NAT inside the DMZ to the integral Web server

http://10.10.10.10:1920///cnp/client
v Internet firewall with NAT through the firewall to the external Web server
http://198.210.32.34/?ior=internet.ior
290
Figure 48. Intranet and Internet with integral and external Web servers
The intranet firewall configuration requires a new Tivoli Enterprise Portal Server interface named "intranet",
which uses proxy host 192.168.1.100 and port 15003.
The Internet DMZ configuration requires a new Tivoli Enterprise Portal Server interface definition.
The Internet configuration uses the same Tivoli Enterprise Portal Server "internet" interface definition as
the previous scenario: proxy host 198.210.32.34 and port 15002.
computer.
Figure 49 on page 292 shows the following two-part configuration:
v Intranet firewall with NAT through the firewall to the external Web server using http://192.168.1.100, and
without NAT inside the DMZ to the integral Web server uses http://10.10.10.10:1920///cnp/client
v Internet firewall with NAT through the firewall to the external Web server using http://198.210.32.34.
291
Figure 49. Two host addresses, intranet and Internet, with integral and external Web servers
The intranet firewall configuration uses the same Tivoli Enterprise Portal Server interface definition (named
"intranet") as in the scenario shown in Figure 48 on page 291: http://10.10.10.10; proxy host
192.168.1.100; and port 15003.
The intranet DMZ configuration uses the default Tivoli Enterprise Portal Server interface definition: host
192.168.33.33; proxy host 198.210.32.34; port 15002; and proxy port 444.
computer.
292
Chapter 13. Configuring IBM Tivoli Monitoring Web Services

(the SOAP Server)
IBM Tivoli Monitoring Web Services provide an industry-standard open interface into products that use the
Tivoli Management Services framework. This open interface provides easy access to performance and
availability data, allowing you to use this information for advanced automation and integration capabilities.
Web Services implements a client/server architecture. The client sends SOAP requests to the SOAP
server. The server receives and processes the SOAP requests from the client. Predefined SOAP methods
let you perform many functions within the monitored environment. Using Web Services requires a basic
understanding of SOAP, XML and XML Namespaces, and the Web Services Description Language
(WSDL).
By default, the SOAP server is enabled on all hub monitoring servers. This chapter describes how to
configure security on a SOAP server, and how to configure communication between SOAP servers.
Note: You cannot make SOAP requests from IBM Tivoli Monitoring to earlier SOAP servers (such as
those in OMEGAMON Platform V350/360).
For complete information about using Web Services and customizing the SOAP interface for your site,
refer to the IBM Tivoli Monitoring: Administrator's Guide.
Table 60 outlines the steps required to configure the SOAP server.
Table 60. Overview of SOAP Server configuration steps
Task
Define the hubs with which your SOAP Server

communicates.
Defining hubs
Create users and grant them access.
Adding users on page 296
Verify that you have successfully configured SOAP.
Verifying the configuration on page 298
Defining hubs
In this step you activate a SOAP server and define hubs with which it communicates. You can use
Manage Tivoli Enterprise Monitoring Services to configure the SOAP server. On Linux and UNIX you can
also use the itmcmd config command. After you configure the SOAP Server, you must restart the Tivoli
v Windows: Defining hubs
v UNIX and Linux: Defining hubs (GUI procedure) on page 294
v UNIX and Linux: Defining hubs (CLI procedure) on page 295
Windows: Defining hubs

Use the following steps to define SOAP hubs on Windows:
1. Start Manage Tivoli Enterprise Monitoring Services (select Start (All) Programs IBM Tivoli
Monitoring Manage Tivoli Monitoring Services).
2. In the Manage Tivoli Enterprise Monitoring Services window, right-click Tivoli Enterprise Monitoring
Server.
3. Click Advanced Configure SOAP Server Hubs.
The SOAP Server Hubs Configuration window is displayed. If the name of the local hub does not
appear in the tree, define the local hub, including assigning user access, before defining the hubs with
which it communicates.
4. Click Add Hub. The Hub Specification window is displayed.
293
5. Select the communications protocol to be used with the hub from the Protocol menu.
6. Specify an alias name in the Alias field.
The alias for the local hub monitoring server must always be "SOAP". For hubs with which the local
SOAP Server communicates, you may choose any alias (for example, HUB2). Alias names can be a
minimum of 3 characters and a maximum of 8 characters.
7. Do one of the following:
v If you are using TCP/IP or TCP/IP Pipe communications, complete the fields in Table 61:
Table 61. TCP/IP Fields in Hub Specification dialog
Field
Description
The host name or TCP/IP address of the host computer.
Port
The TCP/IP listening port for the host computer.
v If you are using SNA communications, complete the fields in Table 62:
Table 62. SNA Fields in Hub Specification dialog
Field
Description
Network Name
Your site SNA network identifier.
LU Name

LU6.2 LOGMODE
The name of the LU6.2 logmode. Default: CANCTDCS.
TP Name
The Transaction Program name for the monitoring server.
8. Click OK. The server tree is displayed, with the newly defined hub.
You can define any hubs with which the local SOAP Server will communicate by repeating steps 4 - 7, or
you can specify which user IDs can access the SOAP Server you just defined and what access privileges
they have. See Adding users on page 296.
UNIX and Linux: Defining hubs (GUI procedure)

Use the following steps to define SOAP hubs on UNIX or Linux using Manage Tivoli Enterprise Monitoring
Services:
1. Change to the itm_install_dir/bin directory and start Manage Tivoli Enterprise Monitoring Services by
entering the following command:
./itmcmd manage

2. Right-click Tivoli Enterprise Monitoring Server and select Configure from the popup menu.
The Configure TEMS window is displayed.
3. Click Save.
The SOAP Server Hubs Configuration windowUNIX and Linux: Defining hubs (GUI procedure) is
displayed.
4. Confirm that the host name or IP address, port number, and protocol displayed for the hub monitoring
server are correct. If not, correct them.
If the name of the local hub does not appear in the tree, define the local hub before defining the hubs
with which it communicates. The alias for the local hub must always be "SOAP".
5. To add another hub:
a. Type the name or IP address and the port number of the host in the appropriate fields. The port
should be match the hub's protocol port number. By default, this is 1918.
294
b. Specify an alias name in the Alias field.

Alias names can be a minimum of 3 characters and a maximum of 8 characters (for example,
HUB2).
c. Select the communications protocol to be used with the hub from the Transport menu.
6. Click Add Host.
The server tree is displayed, with the newly defined hub.
You can now define any hubs with which the local SOAP Server will communicate by repeating step 5, or
you can specify which user IDs can communicate with the local SOAP Server and what access privileges
they have.
UNIX and Linux: Defining hubs (CLI procedure)

Complete the following steps to configure the SOAP server:
1. On the host of the hub monitoring server on which you want to configure Web Services, change to the
install_dir/bin directory and enter the following command:
2. Accept the default values, which should reflect the choices made during the last configuration, until you
see the following prompt:
*************************
Editor for SOAP hubs list
*************************
Hubs
## CMS_Name
1 ip.pipe:TEMS_NAME[port_#]
1)Add, 2)Remove ##, 3)Modify Hub ##, 4)UserAccess ##, 4)Cancel, 5)Save/exit:
3. To add a hub with which the local hub can communicate:

a. Type 1 and press Enter.
b. Respond to the following prompts as shown in :
Network Protocol [ip, sna, ip.pipe, or ip.spipe] (Default is: ip):
CMS Name (Default is: local_host):
Port Number (Default is: 1918):
Alias (Default is: SOAP):
Table 63. SOAP hub configuration values
Network Protocol
The communications protocol configured for the hub monitoring server
CMS Name
The host name of the hub monitoring server. The host name must be fully
Port Number
The protocol port for the hub monitoring server.
Alias
An alias for the hub. Alias names can be a minimum of 3 characters and a maximum of 8
characters. The alias for the local hub must always be SOAP, but you must create a new alias
for additional hubs (for example, HUB2).
After you enter the alias, the list of hubs is displayed with the new hub added. For example,
Hubs
##
1
2
CMS_Name
ip.pipe:chihuahua[1918]
ip:maple[1918]
You can continue to add hubs, or you can proceed to define user access for the hubs you have
already defined.
Chapter 13. Configuring IBM Tivoli Monitoring Web Services (the SOAP Server)
295
Adding users
Access to SOAP server can be secured in one of two ways: by enabling Security: Validate User and
creating user accounts on the host of the hub monitoring server, or by adding specific users to the server
definition.
If Security: Validate User is not enabled and no users are added to the server definition, the SOAP
server honors all requests regardless of the sender. If Security: Validate User is enabled on the hub
monitoring server, the SOAP server honors requests only from users defined to the operating system or
security authorization facility of the monitoring server host.
However, if any users are added to the SOAP server definition, only those users who have also been
defined to the operating system or the security authorization facility of the monitoring server host have
access to the server, regardless of whether or not Security: Validate User is enabled.
In this step you define users to a SOAP Server and specify the access privileges for each user: Query or
Update. The access privileges control what methods the user is allowed to use. Update access includes
Query access. Table 64 lists the methods associated with each access. For information on using these
methods, see the IBM Tivoli Monitoring: Administrator's Guide.
Table 64. SOAP methods associated with access privileges
Method
Update
Query
CT_Acknowledge
CT_Activate
CT_Alert
CT_Deactivate
CT_Email
CT_Execute
CT_Export
CT_Get
CT_Redirect
CT_Reset
CT_Resurface
CT_Threshold
WTO
After you configure the SOAP Server, you must restart the Tivoli Enterprise Monitoring Server.
Windows: Adding users

Use the following steps to define users to a SOAP server:
1. In the SOAP Server Hubs Configuration window, select the server (click anywhere within the server
tree displayed).
2. Under Add User Data, type the user name.
If Security: Validate User is enabled, user IDs must be identical to those specified for monitoring
server logon validation. Access is restricted to only that monitoring server to which a user has access.
3. Click the type of user access: Query or Update.
4. Click Add User. The server tree is updated, showing the user and type of access.
5. To delete a user: Select the user name from the tree and click Delete Item.
6. To delete a hub: Click anywhere within the hubs tree and click Clear Tree.
296
UNIX or Linux: Adding users (GUI)

Complete the following steps to define which users can make requests to a hub and assign access
privileges to those users, using a graphical user interface:
1. If you are not already in the SOAP Server Hubs Configuration window, perform steps 1 - 3 in UNIX
and Linux: Defining hubs (GUI procedure) on page 294.
2. In the hub tree, select the Access node for the hub to which you want to define users.
The values for that hub are displayed in the section above the tree.
3. Type the user ID you want to add in the User field.
If the Security: Validate User option is enabled on the hub, the user ID must be a valid user ID on the
hub system.
4. Use the radio buttons in the Access field to select the type of access you want to grant to the user.
See Table 64 on page 296 for a list of the method each type of access includes.
5. Click Add User.
The user ID appears under the appropriate subnode of the Access node of the selected hub.
6. To add additional users, repeat steps 2 through 5.
7. Click OK to close the window and save the changes.
UNIX or Linux: Adding users (CLI)

Complete the following steps to define users to a hub and assign access privileges using the command
line interface:
1. If you are not already at the following prompt, perform steps 1 and 2 in UNIX and Linux: Defining
hubs (CLI procedure) on page 295:
*************************
Editor for SOAP hubs list
*************************
Hubs
## CMS_Name
1 ip.pipe:TEMS_NAME[port_#]
2. To define users and assign access privileges, enter 4 followed by a space, and then the number (in the
list) of the hub you want to configure. For example:
1)Add, 2)Remove ##, 3)Modify Hub ##, 4)UserAccess ##, 5)Cancel, 6)Save/exit:4 1

=> Query Access:
=> Update Access:
1)QueryAdd <user>, 2)UpdateAdd <user>, 3)Remove ##, 4)Exit :
Any users already defined are listed under the corresponding access.
3. To define a user with Query access, enter 1 followed by a space and the user ID. To define a user with
Update access, enter 2 followed by a space and the user ID. See Table 64 on page 296 for a list of the
methods associated with each type of access.
Note: If the Security: Validate User option is enabled, the user ID must be a valid user on the hub
system.
The prompt appears again with the new user added to the appropriate access list. You can continue to
add users by repeating step 3 or complete the configuration by typing 4 and pressing Enter.
Chapter 13. Configuring IBM Tivoli Monitoring Web Services (the SOAP Server)
297
Verifying the configuration

In this step you verify that SOAP has been correctly configured by starting the SOAP client and making a
request using the command line utility kshsoap.
Use the following steps:
1. Verify that the monitoring server that you used to enable SOAP is running. If not, start it.
2. Open a command window.
3. Change to the install_dir\cms directory (on Windows) or the install_dir/TBD (on UNIX and Linux
operating systems).
4. In the current directory, create an ASCII text file named SOAPREQ.txt that contains the following
SOAP request:
<CT_Get><object>ManagedSystem</object></CT_Get>
Or if security has been enabled:

<CT_Get><userid>logonid</userid><password>password</password> \
<object>ManagedSystem</object></CT_Get>
5. Create another ASCII text file named URLS.txt that contains URLs that will receive the SOAP request.
For example: http://hostname:1920///cms/soap
kshsoap SOAPREQ.txt URLS.txt
SOAPREQ.txt is the name of the file that contains the SOAP request and URLS.txt is the name of the
file that contains the URLs.
The kshsoap utility processes the SOAPREQ.txt file and displays the output of the SOAP request in the
command window. The SOAP request is sent to each URL listed in URLS.txt, and the SOAP response
from each URL displays in the DOS window.
298
Chapter 14. Performance tuning

This chapter discusses considerations for optimizing the performance of several components within an IBM
Tivoli Monitoring environment. The following topics are discussed:
v Configuring the heartbeat interval on page 270
v Tivoli Enterprise Monitoring Server
v Tivoli Enterprise Monitoring agents on page 301
v Tivoli Enterprise Portal Server on page 301
v Tivoli Enterprise Portal client on page 304
v Tivoli Data Warehouse on page 307
Historical data collection on page 307
Warehouse proxy agent on page 309
Summarization and Pruning agent on page 310
Database tuning on page 312
v Optimizing queries on page 325
v Optimizing situations on page 327
v Planning for platform-specific scenarios on page 328
Review these topics and considerations for relevancy to your environment.
This chapter includes some sections from the redbook IBM Tivoli Monitoring: Implementation and
Performance Optimization for Large Scale Environments.
Appendix B in the IBM Tivoli Monitoring: Troubleshooting Guide provides an extensive list of environment
variables that can be customized for different components in the Tivoli Monitoring environment. The
sections below highlight specific environment variables to considered in performance tuning of the Tivoli
Note: When changing environment variables in configuration files, note than whenever maintenance or
reconfiguration takes place in your environment, these changes may be lost and need to be
reapplied.

This section provides information about parameters you may consider editing to improve either hub or
remote monitoring server performance. The parameters are set in the following files according to operating
system:
Windows
ITM_HOME/cms/KBBENV
For example: C:\IBM\ITM\cms\KBBENV
Linux and UNIX
ITM_HOME/config/tems_hostname_ms_tems_name.config
For example: /opt/IBM/ITM/config/edinburg_ms_labtems.config
z/OS
&shilev.&rtename.RKANPARU(KDSENV)
For example: ITM.SYP1.RKANPARU(KDSENV)
Note: The &shilev and &rtename are variables that correspond to high level qualifiers of the
RKANPARU(KDSENV) partitioned dataset. These variables can take 1 to 8 characters.
299
Be aware that on each occasion maintenance or reconfiguration takes place in your environment these
files may be recreated and changes lost and need to be reapplied.
The following lists the settings that may affect the monitoring server performance:
KDCFP_RXLIMIT
This parameter establishes the maximum number of 1 KB packets which may be transmitted to
this endpoint in a single RPC request or response. The default value is 4096 KB (4 MB); the
minimum is 1024 KB (1 MB); there is no maximum. If the remote endpoint (session partner)
exceed this limit (that is, send more), the RPC request will be failed with status
KDE1_STC_RXLIMITEXCEEDED. The intent of RXLIMIT is to prevent memory overrun by placing
an upper-limit on a single RPC request or response. If sufficient capacity exists in a large-scale
deployment, consider setting this value to 8192.
To increase the buffer size to 8 MB, include the following environment setting:
KDCFP_RXLIMIT=8192
CMS_DUPER
This parameter enables or disables situation synchronization of common filter objects actually
monitored by agents or endpoints. Enabling this setting in monitoring server environments with
predominantly z/OS address space applications for example, OMEGAMON XE for CICS or
Sysplex, improves performance and response time by limiting data collection samplings on behalf
of running situations. Enable it by setting the value to YES. Disable by setting the value to NO.
This parameter is enabled by default.
EVENT_FLUSH_TIMER
This parameter is set (in minutes) to set an interval at which time pending I/Os are committed to
situation status history as a background writer and garbage collection task. This feature improves
performance of incoming event throughput into the hub monitoring server per arriving situation
statuses.
EIB_FLUSH_TIMER
This parameter is used to specify in minutes how long the monitoring server should wait before
resetting distribution and database event requests to an initial state, thereby freeing held resources
by the request if no event information has been able to get processed in the specified time. The
default setting is 2 minutes. If event requests are not responding within 2 minutes it may be
desirable to allow for a higher minutes, setting to allow requests more time to process, particularly
in larger, more complex environments.
DELAY_STOP
This parameter is used to specify in seconds how long to delay monitoring server shutdown for
UNIX and Linux monitoring servers, as invoked by the itmcmd server stop tems_name
command. The default value is 60 seconds. The delay is used to allow network connections to
close prior to an immediate restart of the monitoring server with the itmcmd server start
tems_name command. If you do not immediately restart the monitoring server after shutting it
down, this parameter can be set to a lower value to cause the monitoring server shutdown to
complete more quickly.
KGLCB_FSYNC_ENABLED
This parameter is not available on Windows systems, and is not available on IBM Tivoli Monitoring
V6.1 systems.
For Linux and UNIX platforms, this variable can be used to specify whether the fsync() system call
should be invoked after writes to the filesystem. This configuration variable may be set in the
standard configuration file for the monitoring server . By default, for maximum reliability, fsync() will
be called. If and only if the following line is added to the monitoring server configuration file,
fsync() calls be omitted:
The default behavior is to call fsync() after writes, which is equivalent to the setting:
300
The fsync() system call flushes the filesystem's dirty pages to disk and protects against loss of
data in the event of an operating system crash, hardware crash or power failure. However, it can
have a significant negative effect on performance because in many cases it defeats the caching
mechanisms of the platform file system. On many UNIX platforms, the operating system itself
syncs the entire filesystem on a regular basis. For example, by default the syncd daemon that
runs on AIX syncs the filesystem every 60 seconds which limits the benefit of fsync() calls by
application programs to protecting against database corruption in the most recent 60 second
window.
Tivoli Enterprise Monitoring agents

This section describes agent environment variables to considered when tuning your Tivoli Monitoring
environment.
CTIRA_RECONNECT_WAIT
Time interval, in seconds, for the agent to wait between attempts to register with a Tivoli Enterprise
Monitoring Server. The default value is 600 seconds. Consider setting this value to a value
equivalent to the CTIRA_HEARTBEAT setting, which is specified in minutes. For example, if the
CTIRA_HEARTBEAT value has been set at 3 minutes, consider setting
CTIRA_RECONNECT_WAIT to 180 seconds.
CTIRA_MAX_RECONNECT_TRIES
Number of consecutive times without success the agent will attempt to connect to a Tivoli
Enterprise Monitoring Server before giving up and exiting. The default value is 720. Using the
default value along with the default CTIRA_RECONNECT_WAIT setting, the agent will try to
connect to the Tivoli Enterprise Monitoring Server for 432000 seconds (5 days) before giving up
and exiting. If you lower the value for CTIRA_RECONNECT_WAIT, consider increasing this value
to maintain an equivalent retry period. For example, if you lower the CTIRA_RECONNECT_WAIT
value to 180 seconds, consider increasing this value to 2400.

The Tivoli Enterprise Portal Server (portal server) acts as a conduit for Tivoli Enterprise Portal clients
requesting data for analysis from monitoring agents and other components within the enterprise. The portal
server connects directly to the hub monitoring server, which it queries for enterprise information and
receiving updates as they occur. As it is responsible for handling large amounts of data, it can be a
potential bottleneck within the IBM Tivoli Monitoring environment. This section is dedicated to discussing
considerations to optimize the portal server performance.
The portal server database stores information related to the presentation of monitored data at the portal
client, including definitions related to users, workspaces and views. After IBM Tivoli Monitoring V6.1 Fix
Pack 3, the portal server also stores information related to events and event attachments in the portal
server database. Prior to IBM Tivoli Monitoring V6.1 Fix Pack 3, the portal server database previously
required little or no tuning. In environments with a moderate to high rate of events, the portal server
database may require some tuning to optimize performance. In particular, the KFWTSIT table, which is
used to store events, can grow large.
If you are using DB2 for the portal server database, consider the following tuning recommendations:
The default buffer pool size is 250 4K pages. Increase the size of this buffer pool to minimize disk I/O
activity.
The following commands illustrate how to increase the size of the bufferpool to 2000 4K pages (from a
DB2 command prompt):
CONNECT TO TEPS;
ALTER BUFFERPOOL IBMDEFAULTBP IMMEDIATE SIZE 2000;
CONNECT RESET;
301
Because the KFWTSIT table is the most active table, use the runstats and reorg facilities on a regular
(for example, daily) basis.
The following commands illustrate how to run the RUNSTATS facility on the KFWTSIT table (from a
DB2 command prompt):
CONNECT TO TEPS;
RUNSTATS ON TABLE TEPS.KFWTSIT AND INDEXES ALL ALLOW WRITE ACCESS ;
CONNECT RESET;
The following commands illustrate how to run the REORG facility on the KFWTSIT table (from a DB2
command prompt):
CONNECT TO TEPS;
REORG TABLE TEPS.KFWTSIT INPLACE ALLOW WRITE ACCESS
CONNECT RESET;
START ;
Note: These tuning changes can also be made using the DB2 Control Center.
Configure an external Web server for large environments

If there will be more than ten portal clients connected to the portal server concurrently, consider
configuring an external Web server to work with the portal clients. An external Web server will offload
processing from the portal server process (KfwServices), and offer enhanced scalability.
Instructions for configuring an external Web server to work with the Tivoli Enterprise Portal can be found in
Chapter 12, Additional Tivoli Enterprise Portal configurations, on page 279.
Note: You can download the IBM HTTP Server for free at http://www.ibm.com/software/webservers/
httpservers/
Portal server parameter tuning

This section provides some information about parameters you may consider editing to improve portal
server performance. The parameters are set in the following files according to operating system:
Windows
ITM_HOME/CNPS/kfwenv
For example: C:\IBM\ITM\CNPS\kfwenv
Linux and UNIX
ITM_HOME/config/cq.ini
For example: /opt/IBM/ITM/config
Note: For parameter changes made in the portal server configuration file to take effect, the portal server
must be stopped and restarted.
Parameters affecting event processing
KFW_CMW_EVENT_SLEEP
In a complex environment you may have a number of events occurring simultaneously. This
variable specifies a time in seconds the portal server waits between processing similar events.
Consider setting this variable to a value of less than 10 seconds if you are experiencing slow
performance, such as portal client refresh, as a result.
KFW_EVENT_ASSIST
The Event Assistant is an internal component within the portal server that allows the user to:
v Associate attachments to events, such as logs
302
v Assign ownership to events and transfer ownership between users

v View events specific to the current user for the convenience of working with events which they
own
v View closed events along with any associated information provided by the user
The Event Assistant creates multiple tables within the portal server database, and processing
overhead by the Event Assistant increases the portal server CPU, disk and memory usage.
The Event Assistant is enabled by default. To reduce the processing demands for the portal server,
the Event Assistant can be disabled by setting KFW_EVENT_ASSIST=N in the portal server
configuration file (KFWENV on Windows, cq.ini on Unix or Linux). Disabling the Event Assistant
causes the following behavior:
v Event records will not be written to the portal server database.
v The ability for any user to attach files to an event will be disabled. This will be equivalent to all
users not having the Attach permission.
v The My Acknowledged Events view will not be updated with events that are being
acknowledged.
v The Event Notes view will not be populated. However, to view notes and previously existing
attachments, a user can still view notes via the Event Notes and Acknowledgement dialogs.
v The Similar Events by ... view will not be populated.
KFW_EVENT_RETENTION
The number of days to keep a closed event. For example, to prune an event 2 days after it is
close, specify 2. By default, no event pruning occurs. If the Event Assistant is disabled
(KFW_EVENT_ASSIST=N), this parameter is ignored.
KFW_PRUNE_START
The time of day to start pruning data, specified in 24-hour notation (hh:mm). For example, to begin
pruning data at 11:00 PM, specify 23:00. By default, no event pruning occurs. If the Event
Assistant is disabled (KFW_EVENT_ASSIST=N), this parameter is ignored.
KFW_PRUNE_END
The time of day to stop pruning data, specified in 24-hour notation (hh:mm). For example, to stop
pruning data at midnight, specify 24:00. By default, no event pruning occurs. If the Event Assistant
is disabled (KFW_EVENT_ASSIST=N), this parameter is ignored.
You can control the size of file attachments for events either at the individual client level or at the
monitoring environment level, by changing environment variables in the portal server environment file.
Consider changing these if you wish to restrict the number of large attachments to be held at the portal
server:
KFW_ATTACHMENT_MAX
Use this parameter to control the maximum size of all the files attached to an acknowledgement.
Consider editing this parameter if the size of event attachments are too large and are causing
network issues, or alternatively you have excess capacity that may be used and attachments have
been discarded. Enter the maximum size in bytes, such as 1000000 for 1 MB. The default value is
10000000 (10 MB). If the Event Assistant is disabled, this parameter is ignored.
KFW_ATTACHMENT_SEGMENT_MAX
This parameter enables you to set a size limitation for individual files attached to an
acknowledgement. Enter the maximum size in bytes, such as 250000 for 250 KB. The default
value is 1000000 (1 MB). If the Event Assistant is disabled, this parameter is ignored.
The portal server maintains an internal representation of the topology of the monitoring environment, which
is called the topology tree. When changes to the topology occur, the portal server updates the topology
tree. Examples of topology changes that cause updates to the topology tree include:
v A new agent or monitoring server connects to a monitoring server for the first time.
303
v Either the hostname or the IP address for a managed system changes.

v A managed system is removed or cleared from the monitoring server using either the portal client or the
tacmd cleanms command.
The process of updating the topology tree can be CPU-intensive for large environments, and the portal
server can cause high CPU utilization for a brief period of time, depending on the size of the environment
and the speed of the processor running the portal server. To minimize these processing requirements, the
portal server batches topology updates to be processed as a group. The following portal server
environment variables control how topology updates are batched together and affect the frequency of
update processing for the topology tree.
Parameters affecting topology update processing
KFW_CMW_UPDATE_TOPOLOGY_CUTOFF=xx
This variable sets how long the portal server waits after receiving a topology update for new
updates to arrive before updating the topology tree. If a new update arrives, the portal server waits
for another cutoff interval for more updates to arrive. If no new updates appear, the update
processing is started for topology tree. The default cutoff value is 20 seconds. Changing the value
to 60 seconds increases the possibility that topology updates will be batched together and can
reduce the frequency of topology tree updates.
KFW_CMW_UPDATE_TOPOLOGY_MAX_WAIT=xxx
This variable sets the maximum time the portal server waits when topology updates are arriving
before updating the topology tree. If multiple topology updates arrive and are batched together
across several cutoff intervals, this variable sets the maximum time the first topology update waits
before starting update processing for the topology tree. The default value is 120 seconds.
Changing the value to 300 seconds allows for more batching of topology update requests.
Note: Settings made at the client level take precedence over those at the monitoring environment level
defined here. If you have specified a setting at the client level, then any event variables defined
within the portal server configuration are ignored. If you have not specified a setting at the client
level, the portal server variables are used. If you have not specified any settings, the default values
are used.
Tivoli Enterprise Portal client

The Tivoli Enterprise Portal client issues requests to the Tivoli Enterprise Portal Server and renders the
data that is returned. Depending on the choice of installation, the portal client can be started as a desktop
application or as an applet embedded in a Web browser. This section discusses considerations to optimize
the portal client performance:
v Tuning the portal client JVM
v Portal client parameter tuning on page 306
Tuning the portal client JVM

The memory usage of the portal client JVM increases as the size of the monitoring environment increases.
If the maximum Java heap size setting is too low, the JVM will spend a significant amount of time
performing garbage collection. This can result in poor portal client response time and high CPU utilization.
The default value for the maximum Java heap size differs by client type, as shown in Table 65 on page
305 below.
304
Table 65. Default Java heap size parameters by portal client type
Client type
Initial Java heap size

(-Xms)
Maximum Java heap size

(-Xmx)
Where specified
Browser (Internet Explorer)
4 MB
64 MB
IBM Control Panel for Java
increase to 128 MB
increase to 256 MB
128 MB
256 MB
Desktop
v cnp.bat (Windows)
v cnp.sh (Linux)
v in install_dir/CNP
Java Web Start Desktop

client
128 MB
256MB
tep.jnlp file on portal server
For the desktop client and Java Web Start desktop client, the default maximum Java heap size is 256MB,
which is a good setting for most environments.
For the browser client, the Java Plug-in has a default maximum Java heap size of 64MB on Windows,
which is too low. The Tivoli Enterprise Portal browser client uses the IBM Java Plug-in, which is
automatically installed on your computer with the Tivoli Enterprise Portal. If the Java heap size parameters
are not set properly, browser client performance will be slow and your workstation may receive
HEAPDUMP and JAVACore files, an out-of-memory condition, when you are logged on.
To receive good performance from the browser client, you must increase the Java heap size parameters
from their default values. Before you start the browser client, take the following steps:
1. In the Windows Control Panel, open the Java Control Panel.
2. If you have multiple Java versions, verify that you have the correct control panel open by confirming
the Java Runtime is Version 1.5 and that the JRE is in the IBM path (such as c:\program
files\IBM\Java50\jre\bin). To verify, click on the Java(TM) tab and check the Location column for the
JRE.
3. Set the Java Runtime Parameters:
a. Click the Java tab.
b. Click the Java Applet Runtime Settings View button.
c. Double-click the Java Runtime Parameters field and enter -Xms128m -Xmx256m -Xverify:none.
d. Click OK.
The -Xms128m specifies the starting size of the Java heap (128 MB) and -Xmx256m specifies the
maximum size.
4. Confirm that the Temporary Files settings are set to Unlimited:
a. Click the General tab.
b. Click Settings.
c. Select Unlimited for the Amount of disk space to use.
d. Click OK.
5. Clear the browser cache:
a. In the General tab, click Delete Files.
b. In the window that opens, select Downloaded Applets and click OK.
With either the desktop or browser client, if you observe symptoms of heap memory exhaustion using a
maximum Java heap size setting of 256 MB, increase the maximum setting in increments of 64 MB until
the symptoms disappear.
Make sure the client workstation has enough memory to handle the maximum heap size. To determine if
the client workstation has sufficient memory, observe the available physical memory (as shown on the
305
Windows Task Manager Performance tab) when the workstation is not running the Tivoli Enterprise
Portal client, but is running any other applications that need to run concurrently with the portal client. Verify
that the client workstation has enough available physical memory to hold the entire maximum Java heap
size for the Tivoli Enterprise Portal plus another 150 MB. The additional 150 MB provides an allowance for
non-Java heap storage for the Tivoli Enterprise Portal and extra available memory for use by the operating
system.
For more information on Java memory management and Java heap tuning parameters, please refer to the
IBM Developer Kit and Runtime Environment, Java 2 Technology Edition, Version 5.0 Diagnostics Guide
(SC34-6650).
Portal client parameter tuning

This section provides some information about parameters you may consider editing to improve portal client
performance and usability. The parameters are set in the following files according to operating system:
Windows
ITM_HOME\CNP\cnp.bat (or cnp_instance_name.bat)
For example: C:\IBM\ITM\CNP\cnp.bat
Linux ITM_HOME/OS_Specific_Directory/cj/bin/cnp.sh (or cnp_instance_name.sh)
For example: /opt/IBM/ITM/li6243/cj/bin/cnp.sh
cnp.databus.pageSize
Number of rows to fetch in single logical page for any workspace table. By default 100 rows are
returned. Although there is no limit to what you can set here, the larger the page size, the more
memory required at the client and portal server. To increase manageability you might want to edit
this value to return more rows.
cnp.attachment.total.maxsize
Use this parameter to control the maximum size of all the files attached to an acknowledgement.
Consider editing this parameter if the size of event attachments are too large and are causing
network issues, or alternatively you have excess capacity that may be used and attachments have
been discarded. Enter the maximum size in bytes, such as 1000000 for 1 MB. The default value is
10 MB.
cnp.attachment.segment.maxsize
This parameter enables you to set a size limitation for individual files attached to an
acknowledgement. Enter the maximum size in bytes, such as 250000 for 250 KB. The default
value is 1 MB.
The following two parameters control the behavior when expanding items in the Navigator view which have
a large number items in the expanded list. The amount of time required to expand Navigator branches
depends on how many items are in the expanded list. These parameters allow you to control how many
items are expanded at a time.
cnp.navigator.branch.pagesize
The number of items to fetch on a Navigator branch expansion request. The default value is 25.
cnp.navigator.branch.threshold
The warning threshold for Navigator branch expansion requests. The default value is 100.
The following four parameters control the behavior of the Situation Event Console view when it is initially
displayed on a workspace, and when it adds events to the display. The default values allow the portal
client user to make selections while events are processed in the background.
306
cnp.siteventcon.initial_batchsize
Maximum number of events that the situation event console will process in the first event batch
cycle. The default value is 100.
cnp.siteventcon.initial_dispatchrate
Number of milliseconds that will elapse after the first event batch cycle is processed by the
situation event console. The default value is 5000 milliseconds (5 seconds).
cnp.siteventcon.batchsize
Maximum number of events that the situation event console will process in all subsequent event
batch cycles. The default value is 100.
cnp.siteventcon.dispatchrate
Number of milliseconds that will elapse after each subsequent event batch cycle is processed by
the situation event console. The default value is 1000 milliseconds (1 second).
Note: Settings made here at the client level take precedence over those at the monitoring environment
level. If you have specified a setting at the client level, then any event variables defined within the
portal server configuration are ignored. If you have not specified a setting at the client level, the
portal server variables are used. If you have not specified any settings, the default values are used.

The Tivoli Data Warehouse is the most intensely utilized component of the Tivoli Monitoring V6.2.2
infrastructure. The warehouse must support a large volume of data transactions during every warehousing
period, daily summarization and pruning of the warehoused data and multiple queries that often return
result sets that are thousands of rows long. The processing power required to support the warehouse
database and the Summarization and Pruning agent can be significant.
This section provides good guidelines for setting your Tivoli Data Warehouse. If you are interested in
additional information, see the Tivoli Management Services Warehouse and Reporting Redbook.
This section is dedicated to discussing processes to optimize the performance of the warehousing
process, including the Warehouse Proxy and the Summarization and Pruning agents:
v Historical data collection
v Warehouse proxy agent on page 309
v Summarization and Pruning agent on page 310
v Database tuning on page 312
Historical data collection

This section contains recommendations related to historical data collection and controlling the volume of
data that will be generated and loaded into the Tivoli Data Warehouse.
v Do not start collecting historical data for an attribute group without first estimating the data volume that
will be generated and the disk space requirements on both the agent and the warehouse database. The
Warehouse load projections spreadsheet helps you make these calculations. You can find this
spreadsheet in the by searching for "warehouse load projections" or the navigation code "1TW10TM1Y"
in Tivoli Open Process Automation Library (OPAL).
v Collect historical data only for attribute groups where there is a planned use for the information. Do not
collect data that will not be used.
v The number of rows per day generated by a monitoring agent collecting historical data for an attribute
group can be calculated with the following formula:
( 60 / collection interval) * 24 * (# instances at each interval)
Where:
60 Represents the 60 minutes in an hour.
307
collection interval The data collection interval, in minutes. This value can be 1, 5, 15, 30, 60, or
1440 (1 day).
24 Represents 24 hours in one day.
# instances at each interval The number of instances recorded at each interval.
The two variables in this formula are the collection interval and the number of instances recorded at
each interval.
The collection interval is a configuration parameter specified in the Historical Data Collection
configuration dialog.
The number of instances recorded at each interval depends on the nature of the attribute group and
the managed system being monitored. Some attribute groups, such as NT_Memory, generate a
single row of data per collection interval. Most attribute groups, however, generate multiple rows of
data, one row for each monitoring instance (for example, one per CPU, one per disk, and so on).
Certain attribute groups can be instance-intense, generating dozens or hundreds of rows of data per
collection interval. Examples of instance-intense attribute groups would be those reporting
information at the process level, thread level, disk level (for file servers), or network connection level.
For attribute groups that return multiple rows, the number of instance recorded at each interval is
configuration dependent, and can be different from one monitoring environment to another. The
Warehouse load projections spreadsheet requires the user to specify the number of instances recorded
at each interval. There are several approaches that you can use to come up with this number.
Using the portal client, build a table view for the monitoring agent and define a query to obtain data
from the desired attribute group. The number of rows shown in the table view is the number of
instances that would be recorded at each interval. For details on how to define table views in the
portal client, refer to the IBM Tivoli Monitoring: Tivoli Enterprise Portal User's Guide.
Issue a SOAP call to collect data for this attribute group from the monitoring agent. The number of
data rows returned by the SOAP call is the number of instances that would be recorded at each
interval. For details on how to issue SOAP calls, refer to Appendix A Tivoli Enterprise Monitoring
Web services in the IBM Tivoli Monitoring: Administrator's Guide.
If you have a test environment, you can create a monitoring server to use in historical data collection
testing. Enable historical data collection for the desired attribute group under this remote monitoring
server, and configure a representative agent to connect to this monitoring server. When the agent
uploads data to the Warehouse Proxy agent, you can query the WAREHOUSELOG table to see how
many rows were written by the agent for the attribute group.
To minimize the data volume (rows per day) generated by a monitoring agent for an attribute group,
consider the following two recommendations:
Use the longest data collection interval (1, 5, 15, 30, 60 or 1440 minutes) that will provide the
desired level of information.
Avoid or minimize data collection for instance-intense attribute groups, which can generate a large
number of rows per data collection interval.
v When configuring historical data collection for an attribute group, you specify which monitoring servers
collects the data. Since historical data collection is configured at the monitoring server level, restrict the
number of agents collecting data for an attribute group, if possible, by enabling historical data collection
on a subset of the monitoring servers.
v To minimize the performance impact on the monitoring server, configure historical data to keep
short-term history files at the agent, if possible, rather than at the monitoring server.
v Enable warehouse collection only for attribute groups where there is a planned use for the information.
For attribute groups with historical data collection enabled but not configured for warehouse collection,
you need to schedule regular tasks to prune the short-term history files (the supplied programs are
described in the IBM Tivoli Monitoring: Administrator's Guide).
v To spread the warehouse collection load across the day, configure warehouse collection to occur hourly
rather than daily.
308
Warehouse proxy agent

The Warehouse Proxy agent provides a means of translating and transferring historical data collected by
other monitoring agents to the Tivoli Data Warehouse. The amount of historical data generated can be
huge, particularly in environments with thousands of monitoring agents or when instance intense attribute
groups are enabled.
This section describes Warehouse Proxy agent configuration parameters that affect performance and
throughput. For most environments, the default settings for these parameters provide good performance. If
the Warehouse Proxy agent starts to encounter errors when exporting data, these parameters may need
adjustment. If the Warehouse Proxy agent is not able to export data into the warehouse, or if it cannot
keep up with the volume of export requests, export errors will be encountered at the storage location. The
storage location can be the monitoring agent or the monitoring server, whichever is specified in the
historical data collection configuration dialog.
Configuration parameters for the Warehouse Proxy agent are set in the following files according to
operating system:
Windows
ITM_HOME\TMAITM6\khdenv
For example: C:\IBM\ITM\TMAITM6\khdenv
Linux and UNIX
ITM_HOME/config/hd.ini
For example: /opt/IBM/ITM/config/hd.ini
Be aware that whenever maintenance or reconfiguration takes place in your environment, these files may
be recreated, and configuration changes may be lost and need to be reapplied.
Warehouse Proxy internals

To understand the performance-related configuration parameters, it is first helpful to understand how the
Warehouse Proxy agent collects and transfers data to the warehouse. The Warehouse Proxy agent
comprises three internal components; the intelligent remote agent (IRA) communication framework, the
work queue and the exporter threads. These three components work together to collect, translate and
transmit historical data to the warehouse. Historical data flows from one component to the next,
undergoing specific processing at each step before being passed on.
For more information on Warehouse Proxy internals, work queues, exporter threads and database
connection pool size, and batch inserts, see "Warehouse Proxy internals" in Chapter 5 of the IBM Tivoli
Monitoring: Implementation and Performance Optimization for Large Scale Environments redbook.
Tuning the Warehouse Proxy agent on AIX and Linux systems

For a Warehouse Proxy agent running on AIX or Linux, make sure that the user limit value for number of
open file descriptors (the nofiles parameter) is set higher than the number of agents that will be uploading
data through the Warehouse Proxy agent. Refer to File descriptor (maxfiles) limit on UNIX and Linux
systems on page 93 for more details.
Warehouse Proxy agents running on AIX and Linux systems use a Java virtual machine (JVM), which
uses the JDBC (Java Database Connectivity) interface to communicate with the warehouse database. If
the maximum Java heap size of the JVM is set to a low value, performance can be degraded by frequent
garbage collections.
The maximum Java heap size is controlled by the -Xmx option. By default, this option is not specified in
the Warehouse Proxy agent configuration file. If this option is not specified, the default value used by Java
applies as follows:
AIX 64 MB
309
Linux Half the real storage with a minimum of 16 MB and a maximum of 512 MB -1.
Note: The above values are from the IBM Developer Kit and Runtime Environment, Java 2 Technology
Edition, Version 5.0 Diagnostics Guide.
To set the size of maximum Java heap size for the Warehouse Proxy agent, edit the hd.ini configuration
file and modify the KHD_JAVA_ARGS variable as shown below:
KHD_JAVA_ARGS=-Xmx256m
A maximum Java heap size of 256 megabytes is more than adequate for most environments.
Setting KHD_JNI_VERBOSE=Y in the configuration file will enable logging of the garbage collectors
actions. If the Java log contains an excessive number of garbage collection entries during a single
warehousing interval, consider increasing the size of the Java heap.
Using multiple Warehouse Proxy agents

Tivoli Monitoring supports multiple warehouse proxies within a single hub monitoring server environment.
The provision for multiple warehouse proxies provides for greater scalability and performance in historical
data collection, and more importantly, improves reliability by providing a failover mechanism. If a
Warehouse Proxy is unavailable, data can be inserted into the warehouse by a different Warehouse Proxy
agent (if the agents are configured properly for failover). Installing and configuring multiple Warehouse
Proxy agents on page 445 contains detailed information on configuring multiple Warehouse Proxy agents.
v If you are collecting and warehousing historical data in a monitoring environment with more than 1500
monitoring agents, consider using multiple Warehouse Proxy agents to handle the volume of data that
will be uploaded and inserted into the warehouse.
v To reduce the number of servers running Tivoli Monitoring infrastructure components, the Warehouse
Proxy agent can be installed on the same servers running the remote monitoring servers. Servers
running both a monitoring server and a Warehouse Proxy agent should have two processors.
v By default, each Warehouse Proxy agent opens 10 exporter threads and 10 database connections for
inserting data into the warehouse database (controlled by the KHD_EXPORT_THREADS and
KHD_CNX_POOL_SIZE parameters, respectively). If you will be using more than five Warehouse Proxy
agents, consider reducing the number of exporter threads and database connections for each
Warehouse Proxy agent, to limit the number of database connections inserting data into the warehouse
database.

The Summarization and Pruning agent is a multi-threaded, Java based application. It interacts with the
warehouse using a JDBC driver appropriate to the warehouses database. The number of worker threads
available and the heap size of the JVM affect the performance of the Summarization and Pruning agent
and the length of time of its processing runs. The installation location of the Summarization and Pruning
agent is another important aspect of Summarization and Pruning agent performance tuning.
On Windows, the Summarization and Pruning agent environment parameters are set in the following
configuration files according to operating system:
Windows
ITM_HOME\TMAITM6\KSYENV
For example: C:\IBM\ITM\TMAITM6\KSYENV
Linux and UNIX
ITM_HOME/config/sy.ini
For example: /opt/IBM/ITM/config/sy.ini
Be aware that whenever maintenance or reconfiguration takes place in your environment, these files may
be recreated, and configuration changes may be lost and need to be reapplied.
310
Number of worker threads

The Summarization and Pruning agent creates a pool of worker threads during initialization for the purpose
of performing the summarization and pruning tasks. Each worker thread operates independently of all
others, concentrating on one attribute group and its associated warehouse tables. After a worker thread
finishes an attribute group, it locates the next attribute group scheduled for processing. If there are no
more attribute groups to process, the thread ends, leaving the remaining threads to finish their work.
This threading model provides concurrency while minimizing lock activity, since threads are working on
different tables. If there are a few attribute group tables that are considerably larger than the other attribute
group tables, the run time of the Summarization and Pruning agent will be gated by the processing times
for the largest attribute group tables.
The number of worker threads can be set in the Additional Parameters tab of the configuration window,
or by setting the variable KSY_MAX_WORKER_THREADS in the configuration file (KSYENV on Windows,
sy.ini on UNIX or Linux).
v In Tivoli Monitoring V6.2.2, the default value is 2.
v The suggested number of worker threads is 2 or 4 times the number of processors on the host server. If
the Summarization and Pruning agent is running on a separate server from the warehouse database
server, set the value based on the number of processors on the warehouse database server.
v Configuring more threads than attribute groups will not decrease the processing time, because each
thread works on one attribute group at a time.
Setting the maximum Java heap size

The Summarization and Pruning agent runs in a Java virtual machine (JVM), which uses the JDBC (Java
Database Connectivity) interface to communicate with the warehouse database. If the maximum Java
heap size of the JVM is set to a low value, performance can be degraded by frequent garbage collections.
The maximum Java heap size is controlled by the -Xmx option. By default, this option is not specified in
the Summarization and Pruning agent configuration file. If this option is not specified, the default value
used by Java applies as follows:
v AIX 64 MB
v Linux Half the real storage with a minimum of 16 MB and a maximum of 511 MB.
v Windows Half the real storage with a minimum of 16 MB and a maximum of 2047 MB.
Note: The above values are from the IBM Developer Kit and Runtime Environment, Java 2 Technology
Edition, Version 5.0 Diagnostics Guide.
To set the size of maximum Java heap size for the Summarization and Pruning agent, edit the
configuration file (KSYENV on Windows, sy.ini on UNIX or Linux) and modify the KSZ_JAVA_ARGS
variable as shown below:
KSZ_JAVA_ARGS=-Xmx256m
v A maximum Java heap size of 256 megabytes (shown in the example above) is adequate for most
environments.
v In addition to the mx Java parameter, you can also specify the -verbose:gc Java run-time parameter,
which causes diagnostic messages related to garbage collection to be written to the log. If there are an
excessive number of garbage collection entries consider increasing the size of the Java heap.
v For more information on Java heap tuning parameters, refer to the IBM Developer Kit and Runtime
Environment, Java 2 Technology Edition, Version 5.0 Diagnostics Guide, which is available from
http://www.ibm.com/developerworks/java/jdk/diagnosis.
311
Enabling more detailed trace in log files

The Summarization and Pruning agent Java internal trace files contain diagnostic messages showing the
number of rows read and pruned for each attribute group and agent. The names of these files are of the
form hostname_sy_java_timestamp-n.log. For large environments, these trace files might be overwritten
during a single Summarization and Pruning agent processing cycle, and some of the diagnostic
information may be lost.
By default, the Java-based internal trace wraps at 5 files, and each file contains 300000 lines. To change
the default values, you can specify Java run-time parameters in the Summarization and Pruning agent
configuration file (KSYENV on Windows, sy.ini on UNIX or Linux):
KSZ_JAVA_ARGS=-Dibm.tdw.maxNumberDetailTraceFiles=A
-Dibm.tdw.maxLinesForDetailTraceFile=B
Wwhere:
A
Specifies the maximum number of Java-based internal trace files that can exist at any one time for a
single launch.
Specifies the maximum number of lines per Java-based internal trace file.
Consider increasing these log parameters so that you have a few days worth of data in the logs for
diagnostic purposes.
Consider disabling shifts and vacations

The Summarization and Pruning agent configuration settings can be specified in the configuration window,
which is described in the various Summarization and Pruning agent installation and configuration steps in
Part 5, Setting up data warehousing, on page 329. The Work Days tab in this configuration window
allows you to specify shift information and vacation settings.
When you enable and configure shifts, IBM Tivoli Monitoring produces three separate summarization
reports:
v Summarization for peak shift hours
v Summarization for off-peak shift hours
v Summarization for all hours (peak and off-peak)
Similarly, when you enable and configure vacations, IBM Tivoli Monitoring produces three separate
summarization reports:
v Summarization for vacation days
v Summarization for non-vacation days
v Summarization for all days (vacation and non-vacation)
Enabling shifts and vacations causes increased processing and database space usage by the
Summarization and Pruning agent. If you do not require the separate shift and vacation summarization
reports, verify that shift information and vacation settings are not enabled in the Summarization and
Pruning agent configuration window. Alternatively, to disable shifts and vacations, you can specify the
following parameter settings in the configuration file (KSYENV on Windows, sy.ini on UNIX or Linux):
KSY_SHIFTS_ENABLED=N
KSY_VACATIONS_ENABLED=N
Database tuning
Database tuning is a complex task, and for important databases, it requires the skills of a database
administrator. For the Tivoli Data Warehouse, a database located on a single disk using out of the box
database parameters is suitable only for small test environments. For all other environments, careful
planning, monitoring and tuning are required to achieve satisfactory performance.
312
There are a number of sources of database configuration and tuning information that should be helpful in
the planning, monitoring, and tuning of the Tivoli Data Warehouse:
1. Understanding the disk requirements for your database on page 337 describes factors to consider in
planning the disk subsystem to support the Tivoli Data Warehouse.
2. The paper Relational Database Design and Performance Tuning for DB2 Database Servers is
available from the Tivoli Open Process Automation Library (OPAL) by searching for "database tuning"
or navigation code "1TW10EC02" at OPAL. This paper is a concise reference describing some of the
major factors that affect DB2 performance. This document is a good starting point to use before
referencing more detailed information in manuals and Redbooks devoted to DB2 performance. While
DB2 specific, many of the concepts are applicable to Relational Databases in general, such as Oracle
and Microsoft SQL Server.
3. The Tivoli Data Warehouse tuning chapter of the Redbook Tivoli Management Services Warehouse
and Reporting (SG24-7443) builds upon the previously referenced OPAL paper, supplementing it with
information about Oracle and Microsoft SQL Server. This chapter is almost 100 pages in length.
4. The Optimizing the performance chapter of the Redbook IBM Tivoli Monitoring Implementation and
Performance Optimization for Large Scale Environments (SG24-7443) contains a section on database
tuning considerations for the Tivoli Data Warehouse. This section makes suggestions about specific
tuning parameters for DB2, Oracle and MS SQL. At approximately 12 pages, this section is much
shorter than the tuning chapter in the previously referenced Redbook (item number 3).
5. The IBM Tivoli Monitoring: Troubleshooting Guide contains an item Summarization and Pruning Agent
in large environment which lists specific tuning changes that were made to a Tivoli Monitoring V6.2.2
Tivoli Data Warehouse supporting a large number of agents.
The remainder of this section is a summarized version of material from the OPAL paper in number 2
above, which has been supplemented by identifying specific parameters relevant to Tivoli Data Warehouse
and providing some suggested ranges of values.
Relational database design and performance tuning for DB2 database

servers
This section explains some of the major factors that affect DB2 performance on distributed platforms such
as Windows, UNIX, and Linux. Many of the concepts are applicable to the topic of relational databases
such as Oracle and Microsoft SQL Server. This information does not replace detailed information about
DB2 performance that is available in various manuals and Redbooks. You can find the Redbooks at
http://www.redbooks.ibm.com. You can find the DB2 library of documents at http://publib.boulder.ibm.com/
infocenter/db2help/index.jsp
Terminology
The following terms are useful for understanding performance issues:
Throughput
The amount of data transferred from one place to another or processed in a specified amount of
time. Data transfer rates for disk drives and networks are measured in terms of throughput.
Typically, throughputs are measured in kilobytes per second, Mbps, and Gbps.
Optimizer
When an SQL statement must be executed, the SQL compiler must determine the access plan to
the database tables. The optimizer creates this access plan, using information about the
distribution of data in specific columns of tables and indexes if these columns are used to select
rows or join tables. The optimizer uses this information to estimate the costs of alternative access
plans for each query. Statistical information about the size of the database tables and available
indexes heavily influences the optimizer estimates.
Clustered Index
An index whose sequence of key values closely corresponds to the sequence of rows that are
stored in a table. Statistics that the optimizer uses measure the degree of this correspondence.
313
Cardinality
The number of rows in the table or for indexed columns the number of distinct values of that
column in a table.
Prefetch
An operation in which data is read before its use when its use is anticipated. DB2 supports the
following mechanisms:
Sequential prefetch
A mechanism that reads consecutive pages into the buffer pool before the application
requires the pages.
List prefetch or list sequential prefetch
Prefetches a set of non-consecutive data pages efficiently.
Performance factors
The following performance factors, which are thoroughly detailed in subsequent sections, affect overall
performance of any application:
v Database Design
v Application Design
v Hardware Design and Operating System Usage
This section identifies areas where you can influence performance of the Tivoli Data Warehouse database.
Database design details

Key factors for database design include table spaces, buffer pools, and logging. This section includes
information about the following topics:
v Files that are created to support and manage your database
v Amount of required space for storing your data
v Determining how you use the table spaces that are required to store your data
v Setting the various database parameters to fit your environment
Table spaces: A table space is a physical storage object that provides a level of indirection between a
database and the tables stored within the database. It is made up of a collection of containers into which
database objects are stored.
A container is an allocation of space to a table space. Depending on the table space type, the container
can be a directory, device, or file. The data, index, long field, and LOB portions of a table can be stored in
the same table space, or can be individually broken out into separate table spaces.
When you are working with database systems, the main objective is your ability to store and retrieve data
as quickly and efficiently as possible. One important consideration when designing your database or
analyzing a performance problem on an existing database is the physical layout of the database itself.
DB2 provides support for two types of table spaces:
System Managed Space (SMS)
Stores data in operating system files. This type is an excellent choice for general-purpose use,
providing good performance with little administration cost.
Database Managed Space (DMS)
Includes database manager control of the storage space. A list of devices or files is selected to
belong to a table space when it is defined. The DB2 database manager manages the space on
those devices or files. Some additional administration cost is incurred with DMS table spaces
because the size of the pre-allocated files is monitored and adjusted. Altering an existing container
or adding a new container to it can easily increase the DMS table space size.
314
Performance and table space types: DMS table spaces usually perform better than SMS table spaces
because they are pre-allocated and do not use up time extending files when new rows are added. DMS
table spaces can be either raw devices or file system files. DMS table spaces in raw device containers
provide the best performance because double buffering does not occur. Double buffering, which occurs
when data is buffered first at the database manager level and subsequently at the file system level, might
be an additional cost for file containers or SMS table spaces.
If you use SMS table spaces, consider using the db2empfa command on your database. The db2empfa
command, which runs the Enable Multipage File Allocation tool, runs multipage file allocation for a
database. With multipage file allocation enabled for SMS table spaces, disk space is allocated one extent
rather than one page at a time, improving INSERT throughput. In version 8 of DB2, this parameter is
turned on by default.
If you are using a RAID device, create the table space with a single container for the entire array. When a
database is created in DB2, a default table space called USERSPACE1 is created, and by default, Tivoli
Monitoring uses this table space when creating its tables in the DB2 database. You can create a new
default table space in DB2 by creating a table space with the name IBMDEFAULTGROUP. If a table space
with that name, and a sufficient page size, exists when a table is created without the IN tablespace clause,
it is used. You can create the table space in a different location, for example, a RAID array. You could also
create it as a DMS table space if you prefer, as in the following example:
CREATE REGULAR TABLESPACE IBMDEFAULTGROUP IN DATABASE
PARTITION GROUP IBMDEFAULTGROUP PAGESIZE 4096 MANAGED
BY SYSTEM
USING ('E:\DB2\NODE0000\SQL00001\IBMDEFAULTGROUP')
EXTENTSIZE 32
PREFETCHSIZE AUTOMATIC
BUFFERPOOL IBMDEFAULTBP
OVERHEAD 12.670000
TRANSFERRATE 0.180000
DROPPED TABLE RECOVERY ON;
File system caching on a Windows system: For Windows systems caching, the operating system might
cache pages in the file system cache for DMS file containers and all SMS containers. For DMS device
container table spaces, the operating system does not cache pages in the file system cache. On Windows,
the DB2 registry variable DB2NTNOCACHE specifies whether or not DB2 will open database files with the
NOCACHE option. If DB2NTNOCACHE is set to ON, file system caching is eliminated. If DB2NTNOCACHE
is set to OFF, the operating system caches DB2 files. This standard applies to all data except for files that
contain LONG FIELDS or LOBs. Eliminating system caching permits more available memory for the
database, and the buffer pool or SORTHEAP can be increased.
Buffer pools: A buffer pool is an area of memory into which database pages are read, modified, and
held during processing. On any system, accessing memory is faster than disk I/O. DB2 uses database
buffer pools to attempt to minimize disk I/O. Although the amount of memory to dedicate to the buffer pool
varies, in general it is true that more memory is preferable. Start with between 50 - 75% of your systems
main memory devoted to buffer pools if the machine is a dedicated database server. Because it is a
memory resource, buffer pool usage must be considered along with all other applications and processes
that are running on a server. If your table spaces have multiple page sizes, create only one buffer pool for
each page size.
Logging: Maintaining the integrity of your data is extremely important. All databases maintain log files
that record database changes. DB2 logging involves a set of primary and secondary log files that contain
log records that show all changes to a database. The database log is used to roll back changes for units
of work that are not committed and to recover a database to a consistent state.
DB2 provides the following strategies for logging:
v Circular logging
v Log retention logging
315
Circular logging: Circular logging is the default log mode in which log records fill the log files and
subsequently overwrite the initial log records in the initial log file. The overwritten log records are not
recoverable. This type of logging is not suited for a production application.
Log retain logging: With log retain logging, each log file is archived when it fills with log records. New log
files are made available for log records. Retaining log files enables roll-forward recovery, which reapplies
changes to the database based on completed units of work (transactions) that are recorded in the log. You
can specify that roll-forward recovery is done to the end of the logs, or to a specific point in time before
the end of the logs. Because DB2 never directly deletes archived log files, the application is responsible
for maintaining them (for example, archiving, purging, and so on).
Log performance: Ignoring the logging performance of your database can be a costly mistake, especially
in terms of time. Optimize the placement of the log files for write and read performance, because the
database manager must read the log files during database recovery. To improve logging performance, use
the following suggestions:
v Use the fastest disks available for your log files. Use a separate array or channel if possible.
v Use Log Retain logging.
v Mirror your log files.
Increase the size of the database configuration Log Buffer parameter (LOGBUFSZ). This parameter
specifies the amount of the database heap to use as a buffer for log records before writing these
records to disk. The log records are written to disk when one of the following points occurs:
A transaction commits, or a group of transactions commit, according to the definition in the
MINCOMMIT configuration parameter.
The log buffer is full.
Another internal database manager event occurs.
v Buffering the log records supports more efficient logging file I/O because the log records are written to
disk less frequently and more log records are written each time.
v Tune the Log File Size (LOGFILSIZ) database configuration parameter so that you are not creating
excessive log files.
Database maintenance: Regular maintenance, which involves running the REORG, RUNSTATS, and
REBIND facilities in that order on the database tables, is a critical factor in the performance of a database
environment. A regularly scheduled maintenance plan is essential for maintaining peak performance of
your system. Implement at least a minimum weekly maintenance schedule.
REORG: After many INSERT, DELETE, and UPDATE changes to table data, often involving variable
length columns activity, the logically sequential data might be on non-sequential physical data pages. The
database manager must perform additional read operations to access data. You can use the REORG
command to reorganize DB2 tables, eliminating fragmentation and reclaiming space. Regularly scheduled
REORGs improve I/O and significantly reduce elapsed time. Implement a regularly scheduled maintenance
plan.
DB2 provides the following types of REORG operation, classic REORG and In-Place REORG. If you have
an established database maintenance window, use the classic REORG. If you operate a 24 by 7
operation, use the In-Place REORG.
v Classic REORG
The fastest method of REORG
Indexes rebuilt during the reorganization
Ensures perfectly ordered data
Access limited to read-only during the UNLOAD phase, with no access during other phases
Not re-startable
v In-Place REORG
316
Slower than the Classic REORG and takes more time to complete
Does not ensure perfectly ordered data or indexes
Requires more log space
Can be paused and re-started
Can allow applications to access the database during reorganization
RUNSTATS: The DB2 optimizer uses information and statistics in the DB2 catalog to determine optimal
access to the database based on the provided query. Statistical information is collected for specific tables
and indexes in the local database when you execute the RUNSTATS utility. When significant numbers of
table rows are added or removed, or if data in columns for which you collect statistics is updated, execute
RUNSTATS again to update the statistics.
Use the RUNSTATS utility to collect statistics in the following situations:
v When data was loaded into a table and the appropriate indexes were created
v When you create a new index on a table. Execute RUNSTATS for the new index only if the table was
not modified since you last ran RUNSTATS on it.
v When a table has been reorganized with the REORG utility
v When the table and its indexes have been extensively updated by data modifications, deletions, and
insertions. Extensive in this case might mean that 10 to 20 percent of the table and index data was
affected.
v Before binding or rebinding, application programs whose performance is critical
v When you want to compare current and previous statistics. If you update statistics at regular intervals,
you can discover performance problems early.
v When the prefetch quantity is changed
v When you have used the REDISTRIBUTE DATABASE PARTITION GROUP utility
The RUNSTATS command has several formats that primarily determine the depth and breadth or statistics
that are collected. If you collect more statistics, the command takes more time to run. The following
options are included:
v Collecting either SAMPLED or DETAILED index statistics
v Collecting statistics on all columns or only columns used in JOIN operations
v Collecting distribution statistics on all, key, or no columns. Distribution statistics are very useful when
you have an uneven distribution of data on key columns.
Take care when running RUNSTATS, because the collected information impacts the optimizers selection
of access paths. Implement RUNSTATS as part of a regularly scheduled maintenance plan if some of the
conditions occur. To ensure that the index statistics are synchronized with the table, execute RUNSTATS
to collect table and index statistics at the same time.
Consider some of the following factors when deciding what type of statistics to collect:
v Collect statistics only for the columns that join tables or in the WHERE, GROUP BY, and similar clauses
of queries. If these columns are indexed, you can specify the columns with the ONLY ON KEY
COLUMNS clause for the RUNSTATS command.
v Customize the values for num_freqvalues and num_quantiles for specific tables and specific columns in
tables.
v Collect detailed index statistics with the SAMPLE DETAILED clause to reduce the amount of
background calculation performed for detailed index statistics. The SAMPLE DETAILED clause reduces
the time required to collect statistics and produces adequate precision in most cases.
v When you create an index for a populated table, add the COLLECT STATISTICS clause to create
statistics as the index is created.
317
REBIND: After running RUNSTATS on your database tables, you must rebind your applications to take
advantage of those new statistics. Rebinding ensures that DB2 is using the best access plan for your SQL
statements. Perform a REBIND after running RUNSTATS as part of you normal database maintenance
procedures. The type of SQL that you are running determines how the rebind occurs.
DB2 provides support for the following types of SQL:
v Dynamic SQL
v Static SQL
Dynamic SQL: Dynamic SQL statements are prepared and executed at run time. In dynamic SQL, the
SQL statement is contained as a character string in a host variable and is not precompiled. Dynamic SQL
statements and packages can be stored in one of the DB2 caches. A rebind occurs under the following
conditions when you are using dynamic SQL:
v If the statement is not in the cache, the SQL optimizer binds the statement and generates a new
access plan.
v If the statement is in the cache, no rebind occurs. To clear the contents of the SQL cache, use the
FLUSH PACKAGE CACHE SQL statement.
Static SQL: Static SQL statements are embedded within a program, and are prepared during the program
preparation process before the program is executed. After preparation, a static SQL statement does not
change, although values of host variables that the statement specifies can change. These static
statements are stored in a DB2 object called a package.
A rebind occurs under the following conditions when you are using static SQL:
v Explicitly, if an explicit REBIND package occurs
v Implicitly, if the package is marked invalid, which can happen if an index that the package was using
was dropped.
Application design details

The Tivoli Monitoring application was designed and tested with performance and scalability in mind.
Consider reuse of the database connection using the Tivoli Monitoring connection pooling feature.
Connection pooling is a process in which DB2 drops the inbound connection with an application that
requests disconnection, but keeps the outbound connection to the host in a pool. When a new application
requests a connection, DB2 uses one from the existing pool. Using the existing connection reduces the
total amount of connection time and the high processor connection cost on the host.
For the data warehouse, connection pooling is implemented using the Tivoli Monitoring environment
variable KHD_CNX_POOL_SIZE. The default value is 10. You can use the volume of work that the
database is processing to decide whether to increase or decrease this value. This parameter is applicable
to other database managers such as SQL Server and Oracle.
For information on other environment variables, see Warehouse Proxy agent on page 35 and
Warehouse Summarization and Pruning agent on page 35.
Hardware design and operating system usage

For any database system, a number of common areas must be addressed and sized appropriately to
support your application workload. This section discusses common and platform-specific hardware and
operating system components and explains main considerations for hardware design and operating system
usage. It does not include detailed calculations for capacity planning purposes.
Key factors for hardware design and operating system usage include memory, CPU, I/O and network
considerations.
318
Memory: Understanding how DB2 organizes memory helps you tune memory use for good performance.
Many configuration parameters affect memory usage. Some may affect memory on the server, some on
the client, and some on server and client. Furthermore, memory is allocated and de-allocated at different
times and from different areas of the system.
While the database server is running, you can increase or decrease the size of memory areas inside the
database shared memory. Understand how memory is divided among the different heaps before you tune
to balance overall memory usage on the entire system. Refer to the DB2 Administration Guide:
Performance for a detailed explanation of the DB2 memory model and all of the parameters that effect
memory usage.
CPU: CPU utilization should be about 70 to 80% of the total CPU time. Lower utilization means that the
CPU can cope better with peak workloads. Workloads between 85% to 90% result in queuing delays for
CPU resources, which affect response times. CPU utilization above 90% usually causes unacceptable
response times. While running batch jobs, backups, or loading large amounts of data, the CPU may be
driven to high percentages such as to 80 to 100% to maximize throughput.
DB2 supports the following processor configurations:
Uni-Processor
A single system that contains only one single CPU
SMP (symmetric multiprocessor)
A single system that can contain multiple CPUs. Scalability is limited to the CPU sockets on the
motherboard.
MPP (massively parallel processors)
A system with multiple nodes connected over a high speed link. Each node has its own CPUs.
Adding new nodes achieves scalability.
Notes:
1. Inefficient data access methods cause high CPU utilization and are major problems for database
system. Regular database maintenance is an important factor.
2. Paging and swapping requires CPU time. Consider this factor while planning your memory
requirements.
I/O: Improving I/O can include making accurate calculations for total disk space that an application
requires, improving disk efficiency, and providing for parallel I/O operations.
Calculating disk space for an application: Use the following guidelines to calculate total disk space that
an application requires:
v Calculate the raw data size. Add the column lengths of your database tables and multiply by the number
of expected rows.
v After calculating the raw data size, use the following scaling up ratios to include space for indexing,
working space, and so on:
OLTP ratio: 1:3
DSS ratio: 1:4
Data warehouse ratio: 1:5
Disk efficiency: You can improve disk efficiency with attention to the following concerns:
v Minimize I/O. Access to main memory is much faster than accessing the disk. Provide as much memory
as possible to the database buffer pools and various memory heaps to avoid I/O.
v When I/O is needed, reading simultaneously from several disks is the fastest method. You can use
several smaller disks rather than one big disk, or place the disk drives on separate controllers.
319
Selecting disk drives: Disks tend to grow larger every year, doubling in capacity every 18 months, and the
cost per GB is lower each year. The cost difference of the two smallest drives diminishes until the smaller
drive is not practical. The disk drives improve a little each year in seek time. The disk drives get smaller in
physical size. While the disk drives continue to increase capacity with a smaller physical size, the speed
improvements, seek, and so on, are small in comparison. A database that would have taken 36 * 1 GB
drives a number of years ago can now be placed on one disk.
This growth trend highlights database I/O problems. For example, if each 1 GB disk drive can do 80 I/O
operations a second, the system can process a combined 2880 I/O operations per second (36 multiplied
by 80). But a single 36-GB drive with a seek time of 7 milliseconds can process only 140 I/O operations
per second. Although increasing disk drive capacity is beneficial, fewer disks cannot deliver the same I/O
throughput.
Parallel operations: Provide for parallel I/O operations. Use the smallest disk drives possible to increase
the number of disks for I/O throughput. If you buy larger drives, use only half the space, especially the
middle area, for the database. The other half is useful for backups, archiving data, off hour test databases,
and extra space for accommodating upgrades.
Network: After a system is implemented, the network should be monitored to ensure that its bandwidth is
not being consumed more than 50%. The network can influence overall performance of your application,
especially if a delay occurs in the following situations:
v Lengthy time between the point a client machine sends a request to the server and the server receives
this request
v Lengthy time between the point the server machine sends data back to the client machine and the client
machine receives the data
Tuning
This section explains relevant database and database manager configuration parameters and includes
guidelines for setting their values.
Database manager configuration tuning: Each instance of the database manager has a set of
database manager configuration parameters, also called database manager parameters, which affect the
amount of system resources that are allocated to a single instance of the database manager. Some of
these parameters are used for configuring the setup of the database manager and other information that is
not related to performance. You can use either the DB2 Control Center or the following command to
change the parameters:
UPDATE DATABASE MANAGER CONFIG USING keyword
Parameters: The following database manager configuration parameters have a high impact on
performance:
Note: Refer to the DB2 Administration Guide: Performance for detailed explanations about all the
database manager configuration parameters.
AGENTPRI
Controls the priority that the operating system scheduler gives to all agents and to other database
manager instance processes and threads. Use the default value unless you run a benchmark to
determine the optimal value.
ASLHEAPSZ
Represents a communication buffer between the local application and its associated agent. The
application support layer heap buffer is allocated as shared memory by each database manager
agent that is started. If the request to the database manager or its associated reply do not fit into
the buffer, they are split into two or more send-and-receive pairs. The size of this buffer should be
set to handle the majority of requests using a single send-and-receive pair.
320
INTRA_PARALLEL
Specifies whether the database manager can use intra-partition parallelism on an SMP machine.
Multiple processors can be used to scan and sort data for index creation. Usually, this parameter
is set to YES, especially if you are running on a dedicated database server. The default value is NO.
MAX_QUERYDEGREE
Specifies the maximum degree of intra-partition parallelism that is used for any SQL statement that
is executing on this instance of the database manager. An SQL statement does not use more than
this number of parallel operations within a partition when the statement is executed. The
intra_parallel configuration parameter must be set to a value greater than 1 to enable the database
partition to use intra-partition parallelism. Setting the value to ANY enables use of all partitions.
Usually, this parameter should be set to ANY, especially if you are running on a dedicated database
server. The default value is ANY.
SHEAPTHRES
Determines the maximum amount of memory available for all the operations that use the sort
heap, including sorts, hash joins, dynamic bitmaps that are used for index ANDing and Star Joins,
and operations where the table is in memory. Set the sort heap threshold parameter to a
reasonable multiple of the largest SORTHEAP parameter in your database manager instance. This
parameter should be at least twice as large as the largest sort heap defined for any database
within the instance, but you must also consider the number of concurrent sort processes that can
run against your database.
Database configuration tuning: Each database has a set of the database configuration parameters,
which are also known as database parameters. These parameters affect the amount of system resources
that are allocated to that database. Furthermore, some database configuration parameters provide
descriptive information only and cannot be changed, and others are flags that indicate the status of the
database. You can use the DB2 Control Center or the UPDATE DATABASE CONFIG FOR dbname
USING keyword command to change those parameters. For more information about the numerous
database configuration parameters, see the DB2 Administration Guide: Performance.
The following data configuration parameters have a high impact on performance:
DBHEAP
Contains control block information for tables, indexes, table spaces, and buffer pools, and space
for the log buffer (LOGBUFSZ) and temporary memory that the utilities use. Each database has
only one database heap, and the database manager uses it on behalf of all applications connected
to the database. The size of the heap is dependent on a large number of variables. The control
block information is kept in the heap until all applications disconnect from the database. The DB2
default value is typically too low, particularly for the Tivoli Data Warehouse. Start with a value
between 2000 and 8000.
DFT_DEGREE
Specifies the default value for the CURRENT DEGREE special register and the DEGREE bind
option. The default value is 1, which means no intra-partition parallelism. A value of -1 means that
the optimizer determines the degree of intra-partition parallelism based on the number of
processors and the type of query. The degree of intra-partition parallelism for an SQL statement is
specified at statement compilation time using the CURRENT DEGREE special register or the
DEGREE bind option. The maximum runtime degree of intra-partition parallelism for an active
application is specified using the SET RUNTIME DEGREE command. The Maximum Query
Degree of Parallelism (max_querydegree) configuration parameter specifies the maximum query
degree of intra-partition parallelism for all SQL queries. The actual runtime degree that is used is
the lowest of one of the following:
v The max_querydegree configuration parameter
v Application runtime degree
v SQL statement compilation degree
321
For a multi-processor machine, set this to 1 (ANY), to allow intra-partition parallelism for this
database.
CHNGPGS_THRESH
Improves overall performance of the database applications. Asynchronous page cleaners write
changed pages from the buffer pool or the buffer pools to disk before a database agent requires
the space in the buffer pool. As a result, database agents should not have to wait for changed
pages to be written out so that they might use the space in the buffer pool. Usually, you can start
out with the default value.
LOCKLIST
Indicates the amount of storage that is allocated to the lock list. This parameter has a high impact
on performance if frequent lock escalations occur. The DB2 default value is typically too low,
particularly for the Tivoli Data Warehouse. Start with a value of between 500 and 800.
MAXLOCKS
Maximum percent of lock list before escalation. Use this parameter with the LOCKLIST parameter
to control lock escalations. Increasing the LOCKLIST parameter augments the number of available
locks.
LOGBUFSZ
Specifies the amount of the database heap (defined by the dbheap parameter) to use as a buffer
for log records before writing these records to disk. Buffering the log records supports more
efficient logging file I/O because the log records are written to disk less frequently, and more log
records are written at each time. The DB2 default value is typically too low, particularly for the
Tivoli Data Warehouse. Start with a value of between 256 and 768.
NUM_IOCLEANERS
Specifies the number of asynchronous page cleaners for a database. These page cleaners write
changed pages from the buffer pool to disk before a database agent requires the space in the
buffer pool. As a result, database agents do not wait for changed pages to be written out so that
they can use the space in the buffer pool. This parameter improves overall performance of the
database applications. The DB2 default value is typically too low. Set this parameter equal to the
number of physical disk drive devices that you have. The default value is 1.
NUM_IOSERVERS
Specifies the number of I/O servers for a database. I/O servers perform prefetch I/O and
asynchronous I/O by utilities such as backup and restore on behalf of the database agents.
Specify a value that is one or two more than the number of physical devices on which the
database is located. The DB2 default value is typically too low. Set this parameter equal to the
number of physical disk drive devices that you have, and add two to that number. The default
value is 3.
PCKCACHESZ
The package cache is used for caching sections for static and dynamic SQL statements on a
database. Caching packages and statements eliminates the need to access system catalogs when
reloading a package so that the database manager can reduce its internal overhead. If you are
using dynamic SQL, caching removes the need for compilation.
SORTHEAP
Defines the maximum number of private memory pages to be used for private sorts, or the
maximum number of shared memory pages to be used for shared sorts. Each sort has a separate
sort heap that is allocated as needed by the database manager. This sort heap is the area where
data is sorted. Increase the size of this parameter when frequent large sorts are required. The
DB2 default value may be too low, particularly for the Tivoli Data Warehouse. Start with a value of
between 256 and 1024. When changing this parameter, you might want to change the
SHEAPTHRES database manager parameter too.
322
LOGFILSIZ
Defines the size of each primary and secondary log file. The size of these log files limits the
number of log records that can be written to them before they become full, which requires a new
log file. The DB2 default value is too low, particularly for the Tivoli Data Warehouse. Start with a
value of between 4096 and 8192.
LOGPRIMARY
Specifies the number of primary log files to be pre-allocated. The primary log files establish a fixed
amount of storage that is allocated to the recovery log files. The DB2 default value may be too
low, particularly for the Tivoli Data Warehouse. Start with a value of between 6 and 10.
Buffer pools: The buffer pool is the area of memory where database pages, table rows or indexes, are
temporarily read and manipulated. All buffer pools are located in global memory, which is available to all
applications using the database. The purpose of the buffer pool is to improve database performance. Data
can be accessed much faster from memory than from disk. Therefore, as the database manager is able to
read from or write to more data (rows and indexes) to memory, database performance improves.
The default buffer pool allocation is usually not sufficient for production applications, and must be
monitored and tuned before placing your application in production. The DB2 default value is typically too
low, particularly for the Tivoli Data Warehouse. Start with a value of between 50 75 percent of your
system memory if the database server is dedicated. You can use the SQL statement ALTER
BUFFERPOOL to change this value.
Registry variables: Each instance of the database manager has a set of registry and environment
variables that affect various aspects of DB2 processing. You can change the value of DB2 registry
variables using the DB2SET command. Although numerous other registry and environment variables exist,
the DB2_PARALLEL_IO variable has a high impact on performance.
Note: Refer to the DB2 Administration Guide: Performance for a detailed explanation of all the registry
and environment variables.
While reading or writing data from and to table space containers, DB2 may use parallel I/O for each table
space value that you specify. The prefetch size and extent size for the containers in the table space
determine the degree of parallelism. For example, if the prefetch size is four times the extent size, there
are four extent-sized prefetch requests. The number of containers in the table space does not affect the
number of prefetchers.
To enable parallel I/O for all table spaces, you can specify the asterisk (*) wildcard character. To enable
parallel I/O for a subset of all table spaces, enter the list of table spaces. For several containers,
extent-size pieces of any full prefetch request are broken down into smaller requests that are executed in
parallel based on the number of prefetchers. When this variable is not enabled, the number of containers
in the table space determines the number of prefetcher requests that are created.
Monitoring tools
DB2 provides the following tools that can be used for monitoring or analyzing your database:
v Snapshot Monitor, which captures performance information at periodic points of time and is used to
determine the current state of the database
v Event Monitor, which provides a summary of activity at the completion of events such as statement
execution, transaction completion, or when an application disconnects
v Explain Facility, which provides information about how DB2 accesses the data to resolve the SQL
statements
v db2batch tool, which provides performance information as a benchmarking tool
SNAPSHOT and EVENT monitors: DB2 maintains data as the database manager runs about its
operation, its performance, and the applications that are using it. This data can provide important
performance and troubleshooting information. For example, you can track the following developments:
323
v The number of applications connected to a database, their status, and which SQL statements each
application is executing, if any
v Information that shows how well the database manager and database are configured, helping you make
tuning decisions
v Information about the time that deadlocks occurred for a specified database, the applications that were
involved, and the locks that were in contention
v The list of locks held by an application or a database. If the application cannot proceed because it is
waiting for a lock, additional information is on the lock, including which application is holding it.
Collecting performance data introduces some overhead on the operation of the database. DB2 provides
monitor switches to control which information is collected. You can use the following DB2 commands to
turn these switches on:
UPDATE
UPDATE
UPDATE
UPDATE
UPDATE
UPDATE
MONITOR
MONITOR
MONITOR
MONITOR
MONITOR
MONITOR
SWITCHES
SWITCHES
SWITCHES
SWITCHES
SWITCHES
SWITCHES
USING
USING
USING
USING
USING
USING
BUFFERPOOL
LOCK
SORT
STATEMENT
TABLE
UOW
ON
ON
ON
ON
ON
ON
;
;
;
;
;
;
You can access the data that the database manager maintains either by taking a snapshot or by using an
event monitor.
SNAPSHOTs: Use the GET SNAPSHOT command to collect status information and format the output for
your use. The returned information represents a snapshot of the database manager operational status at
the time the command was issued. Various formats of this command obtain different kinds of information,
and the specific syntax can be obtained from the DB2 Command Reference. The following formats are
quite useful:
GET SNAPSHOT FOR DATABASE
Provides general statistics for one or more active databases on the current database partition.
GET SNAPSHOT FOR APPLICATIONS
Provides information about one or more active applications that are connected to a database on
the current database partition.
GET SNAPSHOT FOR DATABASE MANAGER
Provides statistics for the active database manager instance.
GET SNAPSHOT FOR LOCKS
Provides information about every lock held by one or more applications connected to a specified
database.
GET SNAPSHOT FOR BUFFERPOOLS
Provides information about buffer pool activity for the specified database.
GET SNAPSHOT FOR DYNAMIC SQL
Returns a point-in-time picture of the contents of the SQL statement cache for the database.
You can create some simple scripts and schedule them to get periodic snapshots during your test cycles.
DB2BATCH: A benchmark tool called DB2BATCH is provided in the sqllib/bin subdirectory of your DB2
installation. This tool can read SQL statements from either a flat file or standard input, dynamically
describe and prepare the statements, and return an answer set. You can specify the level of performance
information that is supplied, including the elapsed time, CPU and buffer pool usage, locking, and other
statistics collected from the database monitor. If you are timing a set of SQL statements, DB2BATCH also
summarizes the performance results and provides both arithmetic and geometric means. For syntax and
options, type db2batch.
324
Optimizing queries
This section discusses tuning the queries that are processed to display the tables, charts and graphs that
make up workspace views within the Tivoli Enterprise Portal.
Processing queries
The query assigned to a chart or table view requests data from a particular attribute group. It executes
when you open or refresh the workspace. Queries make up the processing load for on-demand data
collection. You can reduce the frequency and amount of data sampling by:
v Customizing the query to filter out unwanted data. This reduces the number of selection criteria (rows)
and attributes (columns) collected.
v Applying the same query to other views in the workspace. This reduces the number of data samples
required: one query uses a single sample for multiple views.
v Disabling automatic refresh of workspace views or adjust the refresh rate to longer intervals. This
causes Tivoli Enterprise Monitoring Agent data to be collected less frequently.
v Consider how you wish to display the data returned by a query. A graphical view workspace may require
significantly less data compared to a table view, because it uses only the truly numeric data and leaves
out the character data.
Do not confuse custom queries with view filters from the Filters tab of the Query Properties editor. View
filters fine-tune the data after it has been retrieved by the query and do not reduce network traffic, data
collection processing, or memory demands.
The following general recommendations and observations might be considered as well:
v Some attributes are more expensive to retrieve than others. One expensive column in a table will make
any workspace view or situation that references that table more expensive. An example of an expensive
attribute is one that must run long storage chains to determine its value, such as using a process table
to look for looping tasks. Where possible, ensure you only retrieve attributes that are required for the
monitoring process.
v Column function (such as MIN, MAX, AVG, and so on) requires post processing of the query results set
after data is returned to Tivoli Enterprise Monitoring Server.
v Use more efficient data manipulating functions, such as substring instead of string scan. If you know the
position of the string to search, do not scan the whole string to check for the value.
Post-filters versus pre-filters
Performance will be improved for each view if you pre-filter the required view information and only send to
portal client what is needed in that view. This reduces the amount of data sent through the network and do
not have to post-process it either. However, there is one exception to the rule.
Think of a workspace that contains many views. Each of those views has a query associated with it, which
will be issued when the workspace is accessed. This might result in many queries that have to be
processed in parallel.
A better way of doing this might be to create one query that returns all data that is required in the
workspace. In this case, the query will only be issued once and the data can then be post-filtered for each
view to only display information as it applies to each view.
One important consideration however is that queries are saved globally and are not user ID dependent.
This means that only administrators will be able to modify queries in most installations. For the end user to
be able to modify filters, the preferred method might therefore be the filters applied in the view properties
Filters tab.
325
Defining custom queries

Custom queries reduce network traffic, processing at the agent and Tivoli Enterprise Monitoring Server,
and memory usage at the Tivoli Enterprise Portal Server and Tivoli Enterprise Portal client. Custom
queries accomplish this by limiting the number of rows and columns passed from the Tivoli Enterprise
Monitoring Agent to the Tivoli Enterprise Monitoring Server.
Most of the predefined, predefined queries request all columns and all rows of an attribute group, of which
only a few may be of interest to you. Removing the unwanted columns (attributes) will reduce the amount
of data transferred from monitoring agent to Tivoli Enterprise Monitoring client via the portal server, hub
monitoring server and remote monitoring server. Additionally, in the case of OMEGAMON Monitoring
Agents that are located on z/OS, you will also reduce the amount of EBCDIC/ASCII conversion required
when data is passed between mainframe and distributed platforms.
It is recommended to tune any queries servicing workspaces that are frequently executed or return large
quantities of data. Query execution always requires resources and intermittent extremely large reports will
cause a spike in memory requirements and network resources.
Restricting the number of rows
Most predefined queries return all rows and columns. You can create a custom query to filter out
the irrelevant or uninteresting metrics. Not only does this make it easier to read the report, but it
saves Tivoli Enterprise Portal Server memory, client memory, and CPU because there are fewer
rows to translate, sort, and transmit.
You may be using view filters inappropriately. View filters work only on the current page returned
from the query. For example, if page size is 100 lines and the filter reduces it to five lines on page
1 and similarly on subsequent pages, the row set cannot be seen on one page. Do not increase
the workspace page size to see everything on one page. Increased page size actually increases
portal client memory requirements.
Instead, avoid this condition by creating a custom query that filters the data at query execution
time.
Restricting the number of columns
Most predefined queries return all columns (or attributes). A particular attribute group may contain
50 columns, yet all you need is five. Creating a custom query to retrieve just the desired five
attributes will reduce portal server and client CPU and memory.
Use the same query in a workspace
If you have multiple views in a workspace requiring data from different attribute groups, you will
need a different query for each group. If however the views have data from the same attribute
group, use a single query to accommodate both even if the attributes (columns) each view
requires differs. Two unique queries will each drive data collection at the agent and increase
resource overhead. For each workspace, have one query that can be shared by all views using
that attribute group. Remember that the entire results set for each query is stored on the portal
server, this technique will avoid duplicate result sets being stored.
Collect agent data less frequently
A good practice is to avoid the use of workspace automatic refresh when possible. The Navigator
view and event views (message log, event console, and graphic console) will refresh automatically.
This provides you with instantaneous alerts, and you can navigate to their event workspaces with
actual data. The graphic view, the graphical equivalent of the Navigator, which shows alerts but no
data, affects client memory but not the portal server.
Reduce the distribution of queries
A query can be assigned to a particular managed system or to a group of systems by defining a
managed system group. The default group will usually include all known instances for that
application or operating system.
326
It may be that you want this query to be applied to only certain managed systems and so
distribution to all managed systems is an unnecessary waste of resource. Modify MSLs to reduce
the distribution of the query. Also remove the MSLs for queries that are of no interest to the user.
Even if you are not viewing the results of the query, there may be a use of system resources that
can be avoided by restricting the distribution of the unneeded queries.
Optimizing situations
Situations are conditions that you want to monitor on managed systems. Each situation contains a name,
a predicate formula, special attributes for specific situation processing, information on whether the situation
is automatically started or not, and the sampling interval. It can also contain a command to execute when
the situation is true, and advice to give the client when an alert for the situation is surfaced, and so on.
A situation predicate is a formula that uses attributes, functions, and other situations as operands along
with threshold values to describe a filtering criterion. The situation formula is made up of one or more
logical expressions.
Each expression takes the form:
[Attribute name] / [logical operator] / [value]
For example: PROCESS_ID == 0
The situation predicates are similar to a WHERE clause in SQL. In IBM Tivoli Monitoring, predicates are
processed sequentially, and perform better if you put the most restrictive condition as the first predicate.
You can use the situation editor to create/edit situations by choosing attributes, logical operator, value, and
sampling interval, and so on. Situations are assigned to run on behalf of managed systems or lists of
managed systems.
When a situation is running on a monitoring agent, the agent collects the current values of the attributes
specified in the formula, and tests the values against a threshold. When the condition is met, i.e. the
threshold is exceeded or a value is matched, the agent passes the collected data back to the monitoring
server to which it is connected, and an event will be generated.
However, some types of situations cannot be tested at the agent level:
v Situations involving group functions, such as MIN, MAX, AVG, SUM, COUNT
v Embedded situations
v Correlated situations
For these types of situations, the agent returns all rows back to the monitoring server to which it is
connected, and the server performs the testing. In large scale environments, especially if the sampling
interval for the situation is short, evaluation for such situations dramatically increases the workload and
memory usage for the monitoring server.
In general, there is limited situation processing at the hub monitoring server if there are no agents directly
connected to the hub. For remote monitoring servers, there is a direct correlation to the number of agents,
situations, and data rows to the amount of memory required. Therefore, the number of situations and size
of the data may be the limiting factor that determines how many agents an individual remote monitoring
server can support.
Since the performance of the monitoring server is greatly affected by the volume and frequency of
situation state changes, do not run a situation and collect data unless you are interested in the results.
The following recommendations provide guidance for how to write more efficient situations and how to
reduce the situation processing requirements:
327
1. If possible, avoid use of group functions, embedded situations or correlated situations. Processing
demands for such situations are much higher, since all attribute group rows must be sent to the
monitoring server for testing, increasing the processing demand and memory usage on the monitoring
server.
2. Put the most stringent condition at the beginning of the formula because the conditions are evaluated
sequentially, left to right.
Consider a situation that has the first condition test on real storage use, the result set may contain
multiple rows; then the second condition tests whether a given process name is among the returned
rows. It would be more efficient to first test on process name (the result will be one row), followed by
the test on the storage usage, just on the single row.
Consider the following in creating the condition tests:
a. Numeric attributes are processed more quickly than text attributes.
b. String checking with substring (STR) is more efficient than the string scan (SCAN), especially for
long strings. If you know the exact location of the text or characters to be evaluated, use a
substring.
3. Use longer sampling intervals where possible, especially for situations that are distributed to a large
number of agents.
4. Minimize the number of situations on attribute groups that can return a large number of rows, such as
process or disk attribute groups.
5. Put mission critical systems in a separated managed system group, and distribute the heavy workload
situations to them only if necessary.
6. Consider spreading business-critical situations amongst several different remote Tivoli Enterprise
Monitoring Servers. For example, a database monitoring situation might be high load, but
business-critical. Instead of having all 500 database agents report through the same remote monitoring
server, consider configuring the database agents across five remote monitoring servers, which are
supporting other less-demanding agents.
Planning for platform-specific scenarios

This section describes several platform-specific scenarios.
Disabling TCP-delayed acknowledgements on AIX systems

On AIX systems, the default behavior for TCP connections results in delayed acknowledgements (Ack
packets). When tcp_nodelayack is set to 0 (the default setting), TCP delays sending Ack packets by up to
200ms, the Ack attaches to a response, and system overhead is minimized.
Setting the tcp_nodelayack parameter to 1 causes TCP to send immediate acknowledgement (Ack)
packets to the sender.
Setting tcp_nodelayack to 1 will cause slightly more system overhead, but can result in much higher
performance for network transfers if the sender is waiting on the receiver's acknowledgement.
Measurements of communication between Tivoli Monitoring components have shown that setting
tcp_nodelayack to 1 can significantly improve performance.
To make the parameter setting, issue the following:
# no -p -o tcp_nodelayack=1
Setting tcp_nodelayack to 1
Setting tcp_nodelayack to 1 in nextboot file
The -p flag makes the change persistent, so that it will still be in effect at the next boot. This is a dynamic
change that takes effect immediately.
328
Part 5. Setting up data warehousing

The chapters in this section provide instructions for installing and configuring the components that collect
and manage historical data in the Tivoli Data Warehouse.
Chapter 15, Tivoli Data Warehouse solutions, on page 331 introduces and summarizes your options for
database platforms, operating systems, and communications between warehousing components.
Chapter 16, Tivoli Data Warehouse solution using DB2 for the workstation, on page 349 provides
information and instructions for implementing a Tivoli Data Warehouse solution using DB2 for the
workstation for the warehouse database.
Chapter 17, Tivoli Data Warehouse solution using DB2 on z/OS, on page 373 provides information and
instructions for implementing a Tivoli Data Warehouse solution using DB2 on z/OS for the warehouse
database.
Chapter 18, Tivoli Data Warehouse solution using Microsoft SQL Server, on page 397 provides
information and instructions for implementing a Tivoli Data Warehouse solution using Microsoft SQL Server
for the warehouse database.
Chapter 19, Tivoli Data Warehouse solution using Oracle, on page 415 provides information and
instructions for implementing a Tivoli Data Warehouse solution using Oracle for the warehouse database.
Chapter 20, Tivoli Data Warehouse solutions: common procedures, on page 435 contains information
and procedures common to the Tivoli Data Warehouse solutions that use any of the supported database
platform. You should read the chapter that pertains to the database platform you are using for the
warehouse before you read this chapter.
329
330
Chapter 15. Tivoli Data Warehouse solutions

The term Tivoli Data Warehouse solution refers to the set of IBM Tivoli Monitoring components,
successfully installed and configured, that interact to collect and manage historical data. These
warehousing components include the Tivoli Enterprise Monitoring Server and the Tivoli Enterprise Portal
Server, the Tivoli Data Warehouse database, the Warehouse Proxy agent, and the Summarization and
Pruning agent.
While all Tivoli Data Warehouse solutions include these four components, the details of any particular
solution vary according to the size of the environment, which database management systems are used,
and which operating systems are involved. This chapter introduces and summarizes your options for
database platforms, operating systems, and communications between warehousing components.
v New in Version 6.2
v Planning assumptions on page 338
v Firewall considerations for the Tivoli Data Warehouse on page 340
v Summary of supported operating systems on page 344
Each of the next four chapters describes how to implement solutions for a variety of configurations using
one of the supported database platforms: IBM DB2 for the workstation, IBM DB2 on z/OS, Microsoft SQL
Server, and Oracle.
New in Version 6.2

The following features are new in IBM Tivoli Monitoring Version 6.2:
v Use of variable length character columns:
Starting with V6.2, character columns in raw data and summary tables larger than 16 characters are
now created as variable length columns (VARCHAR in DB2 for the workstation, VARCHAR2 in Oracle,
VARCHAR or NVARCHAR in SQL Server) rather than fixed length CHAR or NCHAR columns. This
significantly reduces disk space requirements for tables and improves the performance and scalability of
the warehouse.
v Most key columns in summary tables defined as NOT NULL:
Many columns in summary tables can never have a NULL value. Defining these columns as NOT NULL
reduces disk space requirements. This is particularly true for DB2 for the workstation since these
columns are indexed. Index disk space requirements are significantly reduced when using DB2 for the
workstation.
v Improved indexing on summary tables
Indexes on summary tables now include all of the key columns needed for SNP processing. This
significantly improves SNP performance since many tablespace scans have been eliminated.
These improvements are available only on tables or indexes created by the 6.2 version of the Warehouse
Proxy and Summarization and Pruning agents. Currently there is no migration utility to convert tables and
indexes that were created in 6.1 versions of these agents, but those tables and indexes can be used by all
of the V6.2 components.
New in V6.2.1
v Starting with IBM Tivoli Monitoring V6.2.1, the Warehouse Proxy agent and the Summarization and
Pruning agent can use a DB2 version 9.1 (or subsequent) environment running on z/OS as the data
repository. Instructions for implementing a Tivoli Data Warehouse using DB2 on z/OS are in Chapter 17,
Tivoli Data Warehouse solution using DB2 on z/OS, on page 373.
v The Tivoli Data Warehouse now supports 64-bit agent data.
v The Tivoli Data Warehouse now supports IBM DB2 Database for Linux, UNIX, and Windows 9.5.
331
v With the new schema publication tool, you can now generate the SQL statements needed to create the
database objects (data warehouse tables, indexes, functions, views, and ID table inserts) required for
initial setup of the Tivoli Data Warehouse; see Generating SQL statements for the Tivoli Data
Warehouse: the schema publication tool on page 340.
New in V6.2.2 fix pack 1

The Tivoli Data Warehouse now supports IBM DB2 Database for Linux, UNIX, and Windows 9.7.
New in V6.2.2 fix pack 2

To support enterprise monitoring agents that are running autonomously, it is now possible to run the
Warehouse Proxy and Summarization and Pruning agents autonomously.
If a Warehouse Proxy agent is configured to run in autonomous mode, it does not register its location with
the global location broker on the hub monitoring server to make it available to agents. Instead, agents
obtain the location of the Warehouse Proxy agent from their local configuration file or from a central
configuration server (see the IBM Tivoli Monitoring: Administrator's Guide for more information on the
central configuration server). Providing the location of the Warehouse Proxy agent in the configuration
information allows an agent to pass historical data to the Warehouse Proxy agent for insertion into the
Tivoli Data Warehouse database without a connection to a monitoring server and prevents the loss of
historical information.
Beginning with V6.2.2 Fix Pack 2, historical data collection and summarization and pruning settings are
stored in a table in the Tivoli Data Warehouse database, instead of in the Tivoli Enterprise Portal
database. In addition, if the Summarization and Pruning agent is configured to run in autonomous mode, it
looks for required application support files in a specified location instead of obtaining the information from
the portal server. This means that the Summarization and Pruning agent can operate without connecting to
a Tivoli Enterprise Portal Server.
Historical data collection and summarization and pruning settings previously saved to the Tivoli Enterprise
Portal database are migrated to the Tivoli Data Warehouse database automatically the first time the
Summarization and Pruning agent is started after the WAREHOUSESUMPRUNE table is created in the
Tivoli Data Warehouse. The table is automatically created when the first time the V6.2.2FP2
Summarization and Pruning agent is started. Any settings specified subsequently are stored directly in the
Tivoli Data Warehouse's WAREHOUSESUMPRUNE table. Once these parameters have been migrated,
you can continue to configure historical data collection and summarization and pruning using the Tivoli
Enterprise Portal, or you can configure them directly in the warehouse database table using the SQL insert
command.
Notes:
1. The Summarization and Pruning agent can operate without a connection to a Tivoli Enterprise Portal
Server, but a portal server must be installed and application support for all agents that will be collecting
historical data must be installed on the portal server for required application support files to be
available.
2. Once the Tivoli Enterprise Portal Server has migrated the Summarization and Pruning agent's
configuration parameters to the WAREHOUSESUMPRUNE database table, the Tivoli Enterprise Portal
must be able to connect to that table. Otherwise, users (including possibly your database
administrator) will be unable to even view the Summarization and Pruning parameters.
For more information, see Running the warehouse agents autonomously on page 448.
332
Planning considerations for the Tivoli Data Warehouse

In a large or enterprise environment, you have the option of using multiple databases for the Tivoli Data
Warehouse or having all of your hub monitoring servers use one single database. The benefit of using one
database across your environment is that the information is stored in one location, meaning that you can
more easily and accurately generate reports that reflect your entire environment (as opposed to needing to
collate reports from several different databases). However, because the amount of data that is generated
during history collection across a large or enterprise environment can be immense, you need to carefully
plan the scale and performance of that database.
In addition to the planning information below, the IBM redbook Tivoli Management Services Warehouse
and Reporting, SG24-7290, provides database performance tuning information. You can download the
book at the following location: http://www.redbooks.ibm.com/abstracts/sg247290.html?Open.
Estimating the required size of your database

One of the factors to consider when planning the size of database that you need is the amount and type of
information you will collect for agent history data collection. Each of the agent user's guides provide
capacity planning information to help you calculate the amount of disk space required by data for each
attribute group. Use this information to complete the following calculations to determine how large your
data warehouse database needs to be:
v Step 1: Determine the number of detailed records per day for each attribute group
v Step 2: Determine the hard disk drive footprint for each attribute group
v Step 3: Determine the amount of detailed data for each attribute group on page 334
v Step 4: Calculate the amount of aggregate data for each attribute group on page 334
Use the worksheets in Appendix A, Installation worksheets, on page 529 to record the values from these
calculations. To print these, go to the IBM Tivoli Monitoring information center: http://
publib.boulder.ibm.com/infocenter/tivihelp/v15r1/.
You might prefer to use the Warehouse Load Projection tool available in the IBM Tivoli Open Process
Automation Library. (Search on "Warehouse Load Projects at the following site: http://www.ibm.com/
software/tivoli/opal.) The tool does all the calculations for you and includes data for nearly all of the IBM
Tivoli Monitoring V6.x-based monitoring agents.
Step 1: Determine the number of detailed records per day for each attribute group
Determine the number of detailed records per day for each attribute group that you want to collect data for.
Use the following equation:
(60 / collection interval) * (24) * (# instances at each interval)
where:
60
Represents the 60 minutes in an hour.
collection interval
The data collection interval, in minutes. This value can be 1, 5, 15, 30, 60, or 1440 (1 day).
24
Represents 24 hours in one day.
# instances at each interval

The number of instances recorded at each interval. See the agent user's guide for this value.
Step 2: Determine the hard disk drive footprint for each attribute group
Determine the hard disk drive footprint for each attribute group. The result generated by this formula gives
an estimate of the amount of disk space used for this attribute group for 24 hours worth of data for a
single agent.
333
Use the following equation:

(# detailed records) * (attribute group detailed record size) / 1024
where:
# detailed records
The number of detailed records for the attribute. This is the value you calculated in Step 1:
Determine the number of detailed records per day for each attribute group on page 333.
attribute group detailed record size
The detailed record size for the attribute group. See the agent user's guide for this value.
1024
Represents 1 KB and causes the equation to generate a kilobyte number instead of a byte
number.
Step 3: Determine the amount of detailed data for each attribute group
Determine the amount of detailed data in the warehouse database for each attribute group. Use the
following equation:
(attribute group disk footprint) * (# of agents) * (# days of detailed data) / 1024
where:
attribute group disk footprint
The disk footprint for the attribute group. This is the value you calculated in Step 2: Determine the
hard disk drive footprint for each attribute group on page 333.
# of agents
The number of agents of the same agent type in your environment.
# days of detailed data
The number of days for which you want to keep detailed data in the warehouse database.
1024
Represents 1 KB and causes the equation to generate a megabyte number.
Step 4: Calculate the amount of aggregate data for each attribute group
Determine the amount of aggregate data in the warehouse for each attribute group.
First, calculate the number of aggregate records per agent. Use the following equation:
(#hourly + #daily + #weekly + #monthly + #quarterly + #yearly) * (# instances at each interval)
where:
#hourly
The number of hourly records for the attribute group. For example, if you have hourly records for
60 days, the number of hourly records is 1440 (60 multiplied by 24 hours per day).
#daily The number of daily records for the attribute group. For example, if you have daily records for 12
months, the number of daily records is 365.
#weekly
The number of weekly records for the attribute group. For example, if you have weekly records for
a 2-year period, the number of weekly records is 104 (2 multiplied by 52 weeks per year).
#monthly
The number of monthly records for the attribute group. For example, if you have monthly records
for a 2-year period, the number of monthly records is 24.
#quarterly
The number of quarterly records for the attribute group. For example, if you have quarterly records
for a 2-year period, the number of quarterly records is 8 (2 years multiplied by 4 quarters in a
year).
334
#yearly
The number of yearly records for the attribute group. For example, if you have yearly reports for a
10-year period, the number of yearly records is 10.
# instances at each interval
The number of instances recorded at each interval. See the agent user's guide for this value.
Next, use the following equation to calculate the amount of attribute data in the warehouse for the attribute
group:
(# aggregate records per agent) * (attribute group aggregate record size) * (# agents) / 1048576
where:
# aggregate records per agent
The number of aggregate records per agent for the attribute group.
attribute group aggregate record size
The size of the attribute group aggregate group. See the agent user's guide for this value.
# agents
The number of agents of the same agent type in your environment.
1048576
Represents 1 MB and causes the equation to generate a megabyte number.
Step 5: Determine the estimated size of your database

First, determine the total space required for each attribute group. Add the amount of detailed data and the
amount of aggregate data for the attribute group. Use the following equation:
(detailed data size) + (aggregate data size)
Second, determine the total space required for all attribute groups for the agent. Add the total space for
each attribute group that you want to collect. Use the following equation:
aggGroup1 + aggGroup2 + aggGroup3 ...
Third, determine the total space required for all agents. Add the total space for each agent. Use the
following equation:
agent1 + agent2 + agent3 ...
Finally, to estimate the total disk space requirement for the database, multiplying the total amount of data
(detailed + aggregate for all attribute groups) by 1.5 (to increase the number by 50%). Compare this
number to the Database data row in Table 67 on page 337 to determine the number of disks you need for
your database.
Use the following worksheet to estimate the size of your data warehouse database.
335
336
Record
size
Number
of agents detailed
Record
size
Interval
Collection
aggregated instances interval
Detailed
records
per day*
Attribute
agent
disk
space
(KB)*
Warehouse
Warehouse
space
space
detailed
Aggregate aggregated
(MB)*
(MB)*
records
Total database size

(total warehouse data size * 1.5)
Total warehouse data size

(sum of all attribute group total warehouse space)
Days of
detailed
data kept
* Use the equations in Estimating the required size of your database on page 333 to obtain these values.
Attribute
group
Data from the User's Guide
Table 66. Tivoli Data Warehouse database size estimation worksheet

Total
warehouse
space for
attribute
group (MB)
Understanding the disk requirements for your database

Consider the following factors when designing a disk subsystem to support your database processing:
v Disk crash: With sufficient funds and planning, you can build a system that can continue running without
interruption or be recovered in a few hours, despite a system crash. You can provide disk protection by
using some level of RAID on parts, or all, of the disk subsystem. Some of the more popular types of
RAID include the following:
RAID 1, also known as disk mirroring, uses data mirroring to achieve a high level of redundancy. In a
RAID 1 configuration, two copies of the data are kept on separate disks, each mirroring the other.
RAID 5 uses block-level striping with distributed parity. RAID 5 stripes both data and parity
information across three or more drives.
v The database log needs disk protection to enable database recovery of recent transactions. The other
disks can optionally be protected. If they are protected, you can eliminate downtime while data is
recovered.
v Consider the OS and paging space disks.
v Also, consider including one or two additional disks to speed up recovery and reduce the risks while
running after a disk failure.
v Because of the increasing capacity of disk drives, the configurations listed below result in excess disk
capacity but increase the number of disks available for I/O throughput.
The following table provides some example sizes for a database:
Table 67. Database size examples
Number of disks to use
Absolute minimum
disks
Small RDBMS
Small and safe

RDBMS
Large RDBMS
Operating System
1 + mirror
Paging and RDBMS

code
Use above
1 + mirror
RDBMS data
1 + mirror
RDBMS indexes
1 + mirror
RDBMS temp
Use above
1 + mirror
RDBMS logs
1 + mirror
1 + mirror
1 + mirror
Database data
12 GB
24 GB
48 GB
108+ GB
Number of disks
12
24
The Absolute minimum disks column specifies the minimum number of disks for an RDBMS. In this
column, the index and temporary space is allocated onto one disk. While not an ideal arrangement, this
might work in practice because databases tend to use indexes for transactions or temporary space for
index creation and sorting full table scan large queries, but not both at the same time. This is not a
recommended minimum disk subsystem for a database, but it does have the lowest cost.
The Small RDBMS column represents a minimum disk subsystem, although there might be limits in I/O
rates because of the data being placed on only one disk. Striping the data, indexes, and temporary space
across these three disks might help reduce these I/O rate limits. This disk subsystem arrangement does
not include disk protection for the database or other disks (apart from the mandatory log disk protection for
transaction recovery).
The Small and safe RDBMS column adds full disk protection and can withstand any disk crash with zero
database downtime.
337
The Large RDBMS column represents a typical size database for a database subsystem. Disk protection
is not included in these sizings but can be added to increase the stability of the database.
Increasing the size of your database (DB2 for the workstation only)
DB2 for the workstation Workgroup Edition has a default table size limit of 64 GB with a page size of 4
KB. To increase the capacity of your DB2 for the workstation database, you can create a new tablespace,
IBMDEFAULTGROUP, and choose a larger page size (up to 32 KB). This increases the capacity of the
database up to 512 GB per table.
The following example creates the IBMDEFAULTGROUP tablespace with a page size of 16 K. This
increases the table size capacity to 256 GB.
CREATE REGULAR TABLESPACE IBMDEFAULTGROUP IN DATABASE PARTITION GROUP IBMCATGROUP
PAGESIZE 16384 MANAGED BY DATABASE
USING (FILE 'E:\DB2\NODE0000\SQL00001\IBMDEFAULTGROUP.001'1500000)
EXTENTSIZE 32
PREFETCHSIZE AUTOMATIC
BUFFERPOOL IBM16KBP
OVERHEAD 12.670000
TRANSFERRATE 0.180000
DROPPED TABLE RECOVERY ON
If 512 GB of space per table is not enough for your environment, move to DB2 for the workstation
Enterprise Edition and using physical or logical partitioning.
The following steps outline the process for using database partitioning with DB2 for the workstation
Enterprise Edition:
1. Add a new database partition to the DB2 for the workstation instance by running the db2ncrt
command.
2. Use the ALTER TABLE statement to add a partitioning key to the tables that you want to partition. For
example:
ALTER TABLE "CANDLE "."NT_System"
USING HASHING
ADD PARTITIONING KEY ("Server_Name")
3. Use the ALTER DATABASE PARTITION GROUP statement to assign the new partition to the database
partition group. You can do this either from the command line or from the DB2 Control Center.
4. Redistribute the data in the database partition group, using the Redistribute Data Wizard in the DB2
Control Center.
For additional information about database partitioning, see the following DB2 for the workstation sources:
v IBM DB2 Universal Database Administration Guide: Planning
v IBM DB2 Universal Database Administration Guide: Implementation
v DB2 for the workstation Information Center at http://publib.boulder.ibm.com/infocenter/db2help/index.jsp.
For additional database performance and tuning information, see the IBM Tivoli Monitoring: Administrator's
Guide.
Planning assumptions
The information in this and the next four chapters is based on the following assumptions:
v You have completed the preliminary planning required to determine the size and topology of your
environment and your warehousing needs. You may have already installed a monitoring server, a portal
server, and some monitoring agents, but you have not yet created the Tivoli Data Warehouse.
v You are not installing IBM Tivoli Monitoring on one computer.
v You will create the Tivoli Data Warehouse database on a different computer from the Tivoli Enterprise
Portal Server.
338
v If installing the warehouse database on Microsoft SQL Server, you will also install the Tivoli Enterprise
Portal Server on a Windows-based computer. This restriction applies even if the warehouse database
and portal server are installed on separate computers. For example, a portal server on Linux does not
support a warehouse database using Microsoft SQL Server.
v If you are upgrading from IBM Tivoli Monitoring V6.1, you have performed the necessary agent
warehouse database upgrade steps.
The following sections discuss these assumptions in more detail.
Preliminary planning is complete

For guidance on planning the size of your environment and determining the warehousing capacity you
need, see Sizing your Tivoli Monitoring hardware on page 39 and Planning considerations for the Tivoli
Data Warehouse on page 333. The deployment scenarios illustrate your options for where to locate the
warehousing components, whether to have multiple Warehouse Proxy agents reporting to the same hub
monitoring server, and whether to deploy single or multiple hub installations.
This need not be a multiple-computer installation

The information in the current chapter and the next four chapters assume an environment with more than
one computer. In environments where monitoring and warehousing needs are minimal, such as a test
environment, you can install all IBM Tivoli Monitoring components on one computer: a monitoring server,
portal server, data warehouse, Warehouse Proxy agent, and Summarization and Pruning agent. If you
install all components on a Windows system with either DB2 for the workstation or Microsoft SQL Server,
many of the warehouse configuration tasks are automated.
If you want to deploy IBM Tivoli Monitoring on one Windows computer with either of these database
platforms, follow the instructions in Chapter 7, Installing IBM Tivoli Monitoring on one computer, on page
139.
The data warehouse is remote from the portal server

There are two databases involved in IBM Tivoli Monitoring:
v The Tivoli Enterprise Portal Server database (or portal server database) stores user data and
information required for graphical presentation on the user interface. The portal server database is
created automatically during configuration of the portal server. It is always located on the same
computer as the portal server.
v The Tivoli Data Warehouse database (also called the warehouse database or data warehouse) stores
historical data for presentation in historical data views. While it is possible for the warehouse database
to be located on the portal server (as in the single computer deployment), it is best to create the
database on a remote computer to handle the warehousing needs of most production environments.
The procedures described in the next four chapters are based on the assumption that you will install the
Tivoli Data Warehouse database remotely from the portal server.
No assumption is made about where you will install the Warehouse Proxy agents and Summarization and
Pruning agent. Either of these agents may be installed on the same computer as the Tivoli Data
Warehouse or on a different computer:
v Installing the Warehouse Proxy agent and Summarization and Pruning agent on the same computer as
the data warehouse minimizes server deployments, simplifies configuration, and eliminates network
transmission overhead.
v If you install these components on different computers, ensure that you have a high-speed network
connection for best performance.
v In environments with more than one Warehouse Proxy agent reporting to the same hub monitoring
server, install each Warehouse Proxy on a separate computer.
339
Agent warehouse database upgrade

Some of the monitoring agents have made changes to the warehouse tables that require performing
upgrade procedures from IBM Tivoli Monitoring V6.1 before running the V6.2 Warehouse Proxy and
Summarization and Pruning agents. See Upgrading the warehouse on page 123 for more information.
Firewall considerations for the Tivoli Data Warehouse

Firewalls can be a significant factor in most Tivoli Data Warehouse implementations. At a minimum:
v The Warehouse Proxy agent must be able to communicate with:
The database
The agents that are exporting data
v The Summarization and Pruning agent must be able to communicate with:
The database
The monitoring server it is configured to communicate with (not necessarily the hub)
The Tivoli Enterprise Portal Server
Note: The default Tivoli Enterprise Portal Server interface port of 15001 is also used after the initial
connection of the Summarization and Pruning agent to the portal server over port 1920. Any
firewalls between the two need to allow communications on either 15001 or whichever port is
defined for any newTivoli Enterprise Portal Server interface used per the instructions in
Defining a Tivoli Enterprise Portal Server interface on Windows on page 286.
v The agents exporting data to the Warehouse Proxy agent must be able to communicate with the
Warehouse Proxy agent.
Appendix C, Firewalls, on page 551 contains information on the firewall options available. The IBM
redbook Tivoli Management Services Warehouse and Reporting, available from www.redbooks.ibm.com,
discusses firewall considerations specific to the Tivoli Data Warehouse in detail.
Generating SQL statements for the Tivoli Data Warehouse: the schema
publication tool
With the schema publication tool (an SQL editor), you can perform these tasks:
v Generate the SQL statements needed to create the database objects required for initial setup of the
Tivoli Data Warehouse.
v Create the necessary database objects whenever either historical collection is enabled for additional
attribute groups or additional summarizations are enabled. This is referred to as running the schema
publication tool in updated mode.
Generating SQL for data warehouse tables

You can use the schema publication tool to generate the SQL statements needed to create the database
objects required for initial setup of the Tivoli Data Warehouse.
Before you begin

The schema publication tool is installed with the Summarization and Pruning agent. You should perform
this task after product installation and after configuring the Summarization and Pruning agent, but before
starting the Warehouse Proxy agent and the Summarization and Pruning agent for the first time.
340
About this task

By default, the database objects required for the data warehouse are created automatically by the installer,
the Warehouse Proxy agent and the Summarization and Pruning agent. The schema publication tool
enables you to create the data warehouse database objects manually rather than allowing them to be
created automatically. There are several situations in which you might want to do this:
v You might want to use a separate database administration user ID for creating the tables, rather than
granting permission to the Tivoli Data Warehouse user ID specified during installation.
v You might want to customize the SQL before creating the tables in order to accommodate performance
considerations, security policies, or other issues unique to your environment.
The schema publication tool is a script that generates the SQL required to create the data warehouse
tables, indexes, functions, views, and ID table inserts required for the selected products.You can then
modify the generated SQL files before using them to create the tables and indexes.
Procedure
1. Create a new response file by making a copy of the sample response file:
v On Windows systems: itm_install_dir\TMAITM6\tdwschema.rsp
v On Linux and UNIX systems: itm_install_dir/arch/bin/tdwschema.rsp
2. Using an ASCII text editor, edit the response file to indicate the options you want to use. The keywords
in the response file affect which SQL statements are generated, as well as other options:
KSY_PRODUCT_SELECT=category
The category of products for which you want to generate SQL files:
Value
Description
installed
All installed Tivoli Enterprise Portal Server products.
configured
All configured portal server products.
updated
All configured portal server products with configuration

changes that have not yet been deployed to the
database.
This keyword is required.

KSY_PRODUCT_FILTER=product_filter
An optional filter to indicate that only certain specific products are included. (If you do not specify a
filter, all products in the specified category are included by default.) Specify the three-letter product
codes of the products you want to include, separated by commas. You can find these codes by
using the tacmd histListProduct command (for more information, refer to the IBM Tivoli Monitoring
Command Reference).
KSY_SUMMARIZATION_SELECTION=summarization_filter
An optional filter to indicate that only certain summarization options are to be included in the
generated tables:
Value
Description
Hourly
Daily
Weekly
Monthly
Quarterly
Yearly
341
This keyword is valid only with KSY_PRODUCT_SELECT=installed.

KSY_SQL_OUTPUT_FILE_PATH=path
An optional path to the directory where the generated SQL files are to be written. If you do not
include this keyword, the current working directory is used.
For more details and the complete syntax for each keyword, refer to the comments in the
tdwschema.rsp sample response file.
3. Make sure the Tivoli Enterprise Portal Server is started.
4. Run the schema publication tool script using the appropriate syntax for your operating system.
v Windows systems:
tdwschema -rspfile response_file
v Linux and UNIX systems:

tdwschema.sh -rspfile response_file
The SQL files for the products specified in the response file are generated and written to the directory
indicated by the KSY_SQL_OUTPUT_FILE_PATH keyword (or to the current working directory, if no
output directory is specified).
5. Make any necessary changes to the generated SQL files. For example, you might want to partition
tables or assign tables to table spaces.
Note: Do not change the names of any tables specified in the generated SQL files.
6. Use the appropriate tools to run the SQL queries to create the warehouse tables, indexes, views,
inserts, and functions for your relational database. Execute the scripts in this order:
a. tdw_schema_table.sql
b. tdw_schema_index.sql
c. tdw_schema_view.sql
d. tdw_schema_insert.sql
e. tdw_schema_function.sql
Using the schema publication tool in updated mode

Use the schema publication tool's updated mode to create the necessary database objects whenever
either historical collection is enabled for additional attribute groups or additional summarizations are
enabled.
About this task

Note: The schema publication tool is not intended for database migration. For information about migrating
warehouse data from a previous version, refer to Chapter 4. If you run the schema publication tool
in updated mode on an existing IBM Tivoli Monitoring version 6.1 Tivoli Data Warehouse database,
the following will not be done:
v In an IBM Tivoli Monitoring V6.1 Tivoli Data Warehouse database, indexes on aggregate tables
for a given attribute group do not include all of the key columns for the attribute group. This
causes performance problems with the Summarization and Pruning agent. The updated mode
does not generate SQL to recreate the indexes to optimize performance. v In IBM Tivoli Monitoring V6.1, all character data was stored in fixed-length CHAR columns. In
IBM Tivoli Monitoring V6.2, this was changed to VARCHAR, greatly reducing disk requirements
and improving performance. The updated mode does not generate SQL to convert CHAR
columns to VARCHAR.
v In IBM Tivoli Monitoring V6.1, all columns allowed NULL values. In IBM Tivoli Monitoring V6.2,
some columns that can never be NULL were changed to include a NOT NULL constraint. In
large tables this can save significant disk space. For DB2, this greatly reduced the disk
requirements for indexes. The updated mode does not generate SQL to set columns to NOT
NULL.
342
v If using DB2 for the workstation and if the IBM Tivoli Monitoring V6.1 database is not migrated
properly, the schema tool may produce SQL that fails. The tool may generate ALTER TABLE
statements that cause a table not to fit into the table's page size.
Procedure
1. Create a new response file by copying the sample response file:
v On Windows systems, copy itm_install_dir\TMAITM6\tdwschema.rsp.
v On Linux and UNIX systems, copy itm_install_dir/arch/bin/tdwschema.rsp2.
2. Using an ASCII text editor, edit the response file as follows: KSY_PRODUCT_SELECT=updated. (See
the description above.)
You may also specify an output path via the KSY_SQL_OUTPUT_FILE_PATH=path parameter, as
explained above.
3. Using either the historical configuration interface within the Tivoli Enterprise Portal or the historical
configuration CLI, make the desired changes to your site's historical configuration. If enabling historical
collection for new attribute groups, configure but do not start historical collection. If collection is started,
the warehouse proxy agent may attempt to create the database objects before you have a chance to
generate, edit, and execute the SQL.
4. Ensure the Tivoli Enterprise Portal Server is started.
5. Run the schema publication tool script:
v On Windows systems:
tdwschema -rspfile response_file
v On Linux and UNIX systems:

tdwschema.sh -rspfile response_file
where response_file is the name of the response file you edited in step 1. The SQL files for the
products specified in the response file are generated and written to the directory indicated by the
KSY_SQL_OUTPUT_FILE_PATH keyword (or to the current working directory, if no output directory is
specified).
6. Make any necessary changes to the generated SQL files. For example, you might want to partition
tables or assign tables to table spaces.
Note: Do not change any table names specified in the generated SQL files.
7. Use the appropriate tools to run the SQL queries to create the warehouse tables, indexes, views,
inserts, and functions for your relational database. Execute the scripts in this order:
a. tdw_schema_table.sql
b. tdw_schema_index.sql
c. tdw_schema_view.sql
d. tdw_schema_insert.sql
e. tdw_schema_function.sql
8. Using either the historical configuration interface within the portal or the historical configuration CLI,
start historical collection for the newly configured attribute groups.
Next steps
After you have completed your preliminary planning, you are ready to implement your Tivoli Data
Warehouse solution:
v Review the Summary of supported operating systems section in this chapter to understand your options
for operating system platforms, database platforms, and communications between warehousing
components, all summarized in a single composite graphic. This section also describes the relationships
between warehousing components.
343
v The next four chapters are organized by database platform. Follow the instructions in the chapter that
pertains to the database platform you are using for the Tivoli Data Warehouse database: IBM DB2 for
the workstation, IBM DB2 on z/OS, Microsoft SQL Server, or Oracle.
Summary of supported operating systems

Figure 50 on page 345 summarizes the supported operating system platforms for the various warehousing
components, the supported database products, and the connections between components. For more
specific information about supported operating systems and database products, including product names
and versions, see Hardware and software requirements on page 96. In this diagram, UNIX refers to any
UNIX platform supported by the RDBMS.
Note: The diagram is not meant to suggest that each warehousing component must be installed on a
separate computer. Multiple components can exist on the same computer provided there is
operating system support for all installed components. Connections between components must be
configured whether or not they exist on the same computer. (Although the diagram makes no
assumptions about where components are installed, the procedures described in the next four
chapters assume a Tivoli Data Warehouse that is remote from the portal server.)
344
Figure 50. Summary of support for the Tivoli Data Warehouse
In the following discussion, numbered product components correspond to the numbers on the diagram.
Tivoli Data Warehouse database
Data collected by monitoring agents is stored at intervals in binary files. The data in the binary files is
referred to as historical data. The binary files is located either at the agents or at the monitoring server
(hub or remote) to which the agents report. (An administrator can determine where the data is stored. The
monitoring agents and monitoring server are not shown in the diagram.)
The historical data is sent from its temporary storage location (at the monitoring agents or monitoring
server) to the Warehouse Proxy agent at a preset interval (either every hour or every 24 hours). The
Warehouse Proxy agent sends the data it receives to the Tivoli Data Warehouse.
Long-term historical data in binary files (data that is older than 24 hours) is pruned when the monitoring
agent or monitoring server receives an acknowledgment that the data has been successfully inserted into
the Tivoli Data Warehouse (an operation that may take some time). (The pruning of binary files is not the
345
pruning performed by the Summarization and Pruning agent. The Summarization and Pruning agent
prunes data in the Tivoli Data Warehouse.) The result of these operations is that at any given time the
binary files contain primarily short-term historical data (data less than 24 hours old) and the Tivoli Data
Warehouse contains primarily long-term historical data (data older than 24 hours).
The Tivoli Data Warehouse database can be created using Microsoft SQL Server, IBM DB2 for the
workstation, or Oracle, on the indicated operating system platforms. Note that the warehouse database is
supported on Microsoft SQL Server only if the Tivoli Enterprise Portal Server (TEPS) is installed on
Windows. This condition applies even if the warehouse database and portal server are installed on
separate computers. For example, a portal server on Linux does not support a warehouse database on
Microsoft SQL Server.
A Warehouse Proxy agent on Windows uses an ODBC connection to send the collected data to the
warehouse database. A Warehouse Proxy agent on Linux or AIX uses a JDBC connection.
The Warehouse Proxy agent will do the following as needed:
v Create new tables and indexes.
v Alter existing tables.
For example, add a new column to a table. This can occur if the table was created for an older version
of an agent but data is being exported for the first time from a newer version of the agent that has more
attributes.
Firewall considerations:
v The Warehouse Proxy agent must be able to communicate with the hub monitoring server.
v The Warehouse Proxy agent must be able to communicate with the RDBMS.
v The agents exporting data must be able to communicate with the Warehouse Proxy and the Warehouse
Proxy agent must be able to communicate with the agents (there must be two-way communication
between agents and the Warehouse Proxy agent).
Appropriate ports must be open to support these communication channels (see Appendix C, Firewalls, on
page 551).
The Tivoli Enterprise Portal Server retrieves historical data for display in historical data views in the Tivoli
Enterprise Portal. It retrieves short-term historical data from the binary files on the monitoring agents or
monitoring server. It retrieves long-term historical data from the Tivoli Data Warehouse.
In Figure 50 on page 345, the Tivoli Enterprise Portal Server is shown with the portal server database
(designated as TEPS database in the diagram). The portal server database stores user data and
information required for graphical presentation on the user interface. Before you install and configure the
portal server, you must install the database platform (RDBMS) to be used for the portal server database
(DB2 for the workstation or Microsoft SQL Server) on the same computer. The portal server database is
created automatically during configuration of the portal server.
Although the portal server database is not considered a warehousing component, it is included in the
diagrams in this and the following chapters because it can affect the installation and configuration tasks
required for the Tivoli Data Warehouse database. For example, the database client already installed for the
portal server database can connect to a remote warehouse database, provided both databases use the
same database platform. There is no need to manually install another client.
346
If the portal server is installed on Windows, it uses an ODBC connection to request and retrieve historical
data from the warehouse database. If the portal server is installed on Linux or AIX, it communicates with
the warehouse database through a JDBC connection, if the warehouse is installed on Oracle, or through a
proprietary DB2 CLI connection if the warehouse is installed on DB2 for the workstation.
The Summarization and Pruning agent retrieves detailed data from the warehouse database, aggregates
or prunes the data, and returns the processed data to the warehouse. Communication takes place through
a JDBC connection, regardless of the operating system on which the Summarization and Pruning agent is
installed.
The Summarization and Pruning agent will create tables, indexes, and views as needed. This could
happen in either of the following situations:
v Summarization is enabled for the first time for an attribute group.
v Additional summarizations are enabled for an attribute group.
In addition, the Summarization and Pruning agent, like the Warehouse Proxy agent, may alter existing
tables by adding new columns.
Firewall considerations:
v The Summarization and Pruning agent must be able to communicate with the RDBMS.
v The Summarization and Pruning agent must be able to communicate with the Tivoli Enterprise Portal
Server.
v The Summarization and Pruning agent must be able to communicate with the Tivoli Enterprise
Monitoring Server it is configured to use.
347
348
Chapter 16. Tivoli Data Warehouse solution using DB2 for the
workstation
Use the information and instructions in this chapter to implement a Tivoli Data Warehouse solution using
DB2 for the workstation for the warehouse database. The following table lists the goals for creating a DB2
for the workstation solution.
Table 68. Goals for creating a Tivoli Data Warehouse solution using DB2 for the workstation
Goal
Review your options, specific to a DB2 for the workstation Supported components
solution, for operating system platforms and
communications between warehousing components.
Install prerequisite software before implementing your
Tivoli Data Warehouse solution.
Prerequisite installation on page 351
Understand how to use the instructions for implementing

your Tivoli Data Warehouse solution.
Implementing a Tivoli Data Warehouse solution using

DB2 for the workstation on page 352
Complete the steps for implementing your Tivoli Data

Warehouse solution using DB2 for the data warehouse.
Step 1: Create the Tivoli Data Warehouse database on

page 353
Step 2: Install and configure communications for the
Warehouse Proxy agent on page 358
Step 3: Configure communications between the Tivoli
Enterprise Portal Server and the data warehouse on
page 367
Supported components
Figure 51 on page 350 presents the options for a Tivoli Data Warehouse solution using DB2 for the
workstation for the warehouse database. The diagram summarizes the supported operating system
platforms for the various warehousing components, the supported database products, and the connections
between components. For more specific information about supported operating systems and database
products, including product names and versions, see Hardware and software requirements on page 96.
349
Figure 51. Tivoli Data Warehouse solution using DB2 for the workstation
Note: An asterisk (*) next to a database client indicates that you must manually install the client if it does
not already exist.
Tivoli Data Warehouse on DB2 for the workstation
A Tivoli Data Warehouse database on DB2 for the workstation can be installed on supported Windows,
Linux, or any UNIX platform that is supported by DB2 for the workstation. Ensure that the DB2 TCP/IP
listeners are active in order to accept connections from a DB2 client or JDBC driver.
350

A Warehouse Proxy agent on Linux or AIX communicates with the warehouse database through a JDBC
connection. Install a Type 4 driver (DB2 for the workstation JDBC Universal Driver) on the computer where
the Warehouse Proxy agent is located.
A Warehouse Proxy agent on Windows communicates with the warehouse database through an ODBC
connection. The ODBC driver is included with the DB2 for the workstation client. If the Tivoli Data
Warehouse is located on a remote computer, install a DB2 client on the local computer where the
Warehouse Proxy agent is located. Also, catalog the remote node and database on the local computer.
A Tivoli Enterprise Portal Server on Windows, Linux, or AIX can connect to a DB2 for the workstation data
warehouse through a DB2 for the workstation client installed on the portal server. If the portal server
database (designated as TEPS database in the diagram) uses DB2 for the workstation, the DB2 client
already exists. Manually install a DB2 for the workstation client on the portal server only if the portal server
database uses Microsoft SQL Server.
A portal server on Windows communicates with the warehouse database through an ODBC connection.
The ODBC driver is included with the DB2 for the workstation client. Catalog the remote warehouse node
and database on the portal server.
A portal server on Linux or AIX uses the DB2 for the workstation CLI interface, a proprietary connection, to
communicate with the warehouse database. If the warehouse database is installed on a different computer
from the portal server, catalog the remote database and remote node on the portal server.
Summarization and Pruning Agent
The Summarization and Pruning agent communicates with the warehouse database through a JDBC
connection from any supported operating system. Install a DB2 for the workstation Type 4 JDBC driver
(DB2 for the workstation JDBC Universal Driver) on the computer where the Summarization and Pruning
agent is located.
Prerequisite installation
Before you implement your Tivoli Data Warehouse solution, complete one or more hub installations,
excluding the warehousing components. Include the following components in each hub installation:
v The hub Tivoli Enterprise Monitoring Server
v (Optional) One or more remote monitoring servers
v The Tivoli Enterprise Portal Server, including the prerequisite RDBMS for the portal server database
(DB2 for the workstation or Microsoft SQL Server)
v An IBM DB2 for the workstation server on the computer where you will create the Tivoli Data
Warehouse database. (The Tivoli Data Warehouse database can be shared in a multi-hub installation or
dedicated to a single hub.)
v (Optional) A portal desktop client
v (Optional) Monitoring agents, and the application support for the monitoring agents
Note: The term monitoring agent, as used here, refers to agents that collect data directly from
managed systems, not the Warehouse Proxy agent or Summarization and Pruning agent.
v (Optional) Language packs for all languages other than English
Refer to Table 69 on page 352 for related information:
Chapter 16. Tivoli Data Warehouse solution using DB2 for the workstation
351
Table 69. Information topics related to installation of prerequisite software for a Tivoli Data Warehouse solution
Topic
Single and multiple hub installations
To understand the terminology related to single and multiple hub

installations, see Locating and sizing the hub Tivoli Enterprise
Monitoring Server on page 40.
Installation procedures for prerequisite

components
The detailed instructions for installing the prerequisite components

are described in Chapter 8, Installing IBM Tivoli Monitoring, on
page 147. Refer to your database documentations for instructions on
how to install a supported database server.
Supported RDBMS versions
For specific information about the supported database platforms for

the portal server database and the Tivoli Data Warehouse, see
Implementing a Tivoli Data Warehouse solution using DB2 for the

workstation
Use the instructions in the remainder of this chapter to implement a Tivoli Data Warehouse solution using
DB2 for the workstation for the data warehouse.
Assumptions
The implementation instructions are based on the following assumptions:
Portal Server.
v You will create a single Tivoli Data Warehouse database, to be used either within a single hub
installation or to be shared in a multi-hub installation. If you have multiple independent hub installations,
repeat the implementation steps for each hub installation. (See Locating and sizing the hub Tivoli
Enterprise Monitoring Server on page 40 for information about hub installations.)
v No assumption is made about where you will install the Warehouse Proxy agent and Summarization
and Pruning agent. Either of these agents may be installed on the same computer as the Tivoli Data
Warehouse or on a different computer.
Solution steps
To implement your Tivoli Data Warehouse solution using DB2 for the workstation, complete the four major
steps described in the remaining sections of this chapter, in the order listed:
1.
2.
3.
4.
Create the Tivoli Data Warehouse database.

Install and configure communications for the Warehouse Proxy agent.
Configure communications between the Tivoli Enterprise Portal Server and the data warehouse.
Install and configure communications for the Summarization and Pruning agent.
Each major step consists of a series of installation and configuration tasks, listed and described in a table.
Use the step tables as a road map for implementing your solution. The step tables describe the tasks at a
high level, account for variations among configuration options (such as which operating system is used for
a component), and reference the appropriate sections for detailed implementation procedures. To
implement your solution successfully:
v Perform the tasks in the order listed in the table.
v Do not skip a table to the procedures that follow it.
Be aware that some of the implementation procedures referenced in a table are included in this chapter
and some are documented elsewhere. In some cases, the task is described in the table, without
referencing a separate procedure. Read and follow all instructions in the tables.
352
Step 1: Create the Tivoli Data Warehouse database

Complete the tasks described in the following table to create a Tivoli Data Warehouse database using DB2
for the workstation and to make it accessible to clients.
Table 70. Tasks for creating the Tivoli Data Warehouse database
Task
Procedure
Create the Tivoli Data Warehouse database on one of the For guidance on planning the size and disk requirements
supported Windows, Linux, or UNIX operating systems.
for the warehouse database, see Planning
considerations for the Tivoli Data Warehouse on page
To comply with the assumptions described in the
333.
introduction to this chapter, create the warehouse
database on a different computer from the Tivoli
For information about creating the warehouse database
Enterprise Portal Server.
using DB2, see Creating the warehouse database on
DB2 for the workstation.
Create an operating system (OS) user account (user
name and password) with administrator authority on the
computer where the warehouse database is located.
Creating a warehouse user on Windows on page 354

Creating a warehouse user on Linux or UNIX on page
354
The warehousing components (portal server, Warehouse

Proxy agents, and Summarization and Pruning agent) will
use this OS user account to access the database. Create
only one user account for all warehousing components to
use. This user is referred to in this chapter as the
warehouse user.
(Optional) Restrict the authority of the warehouse user.
Limiting the authority of the warehouse user on page

355
Initially, the warehouse user is created with OS

administrative authority. Use the referenced procedure if
you want to limit the authority of the warehouse user to
just those privileges required to access and use the data
warehouse.
(Tivoli Data Warehouse on Linux or AIX only)
Activating the DB2 listeners on a UNIX DB2 server on

page 357
Activate the DB2 for the workstation TCP/IP listeners on

the DB2 server where the Tivoli Data Warehouse is
installed.
The TCP/IP listener processes on the DB2 for the
workstation server must be active in order to accept
connections from a DB2 for the workstation client or
JDBC driver. The DB2 listeners are automatically
activated on Windows systems. Perform the referenced
procedure to activate the DB2 listeners if the warehouse
database is located on a Linux or AIX system.
Creating the warehouse database on DB2 for the workstation

This section provides guidelines for creating the Tivoli Data Warehouse database on DB2 for the
workstation. For specific instructions on how to create a DB2 database, refer to the DB2 for the
workstation documentation or have a database administrator create the database for you.
When you create the warehouse database using DB2, follow these guidelines:
v Create the database with UTF-8 encoding.
353
v Create a name for the warehouse database, and an operating system (OS) user account (user name
and password) that the warehousing components (portal server, Warehouse Proxy agent, and
Summarization and Pruning agent) can use to access the data warehouse. In these instructions, this
user account is referred to as the warehouse user.
v Consider using the default values shown in Table 71 for the warehouse name and warehouse user. The
default values are used in the configuration procedures for connecting the warehousing components to
the warehouse database. (For example, see the entries in Figure 53 on page 363.)
Table 71. Default values for Tivoli Data Warehouse parameters
Parameter
Default value
Tivoli Data Warehouse database name
WAREHOUS
User name
itmuser
User password
itmpswd1
v Give the warehouse user administrative authority to the database initially. After that, you can optionally
limit the authority of the warehouse user to just the privileges required for interacting with the data
warehouse. See the following sections for information about creating and limiting the authority of the
warehouse user.
Creating a warehouse user on Windows
Creating a warehouse user on Linux or UNIX
Limiting the authority of the warehouse user on page 355
v For a Tivoli Data Warehouse on Linux or AIX, ensure that the DB2 for the workstation server is
configured for TCP/IP communications. See Activating the DB2 listeners on a UNIX DB2 server on
page 357.
Creating a warehouse user on Windows

Complete the following steps on the computer where the warehouse database is installed to create a
Windows OS user with Administrator authority:
1. Right-click the My Computers icon on the Windows desktop and click Manage.
2. In the navigation pane of the Computer Management window, expand Local Users and Groups by
clicking on the plus sign (+).
3. Right-click the Users folder and click New User.
4. Type a user name and password in the User Name and Password fields. Confirm the password by
typing it again in the Confirm password field.
5. Clear User must change password at next logon.
6. Click Close.
7. Click the Groups folder.
8.
9.
10.
11.
12.
Double-click Administrators in the right pane of the window.

Click Add in the Administrator Properties window.
Locate the new user you created and select it.
Click Add.
Click OK and then OK again to close the Administrator Properties window.
13. Close the Computer Management window.
Creating a warehouse user on Linux or UNIX

Complete the following procedure on the computer where the warehouse database is installed to create a
Linux or UNIX OS user with administrative authority to the warehouse:
v To create the user, follow the instructions in the documentation for the specific Linux or UNIX product
and version that is installed on the computer where the warehouse database is located.
354
v To give this user administrative authority to the data warehouse, add the user to the DB2 for the
workstation SYSADM group. Run the following command to find the name of the SYSADM group:
db2 get dbm cfg | grep SYSADM
For example:
db2 get dbm cfg | grep SYSADM
SYSADM group name
(SYSADM_GROUP) = DB2GRP1
In this example, the name of the DB2 for the workstation SYSADM group is DB2GRP1. If you created
an OS user named ITMUSER, add ITMUSER to DB2GRP1.
Limiting the authority of the warehouse user

If you do not want the warehouse user to have broad administrative authority, you can limit the authority of
the warehouse user to just those privileges required for accessing and using the data warehouse. These
more limited privileges include the authority to create and update tables, to insert information into the
tables, to create indexes for the tables, and to grant public authority to the tables.
Before you begin

The Tivoli Data Warehouse requires one bufferpool and three tablespaces to begin its operation. The
bufferpool and tablespaces are created by the warehouse user before the Warehouse Proxy agent starts,
provided the warehouse user has administrative authority to the database. A warehouse user with limited
authority cannot create the required bufferpool and tablespaces. Therefore, this procedure to limit the
authority of the warehouse user includes steps to create the bufferpool and tablespaces in advance. Be
sure to perform this procedure before the Warehouse Proxy agent starts.
Use the script shown in Table 72 to create the required bufferpool and tablespaces. Create the script on a
computer from which you can connect to the Tivoli Data Warehouse database server. The name of the
script is KHD_DB2_crt_BP_TBSP.sql.
Table 72. Script for creating required bufferpool and tablespaces for the Tivoli Data Warehouse
-- CREATE a Bufferpool of page size 8K
CREATE BUFFERPOOL ITMBUF8K IMMEDIATE SIZE 2501 PAGESIZE 8 K;
-- CREATE a Regular Tablespace using the 8K Bufferpool
CREATE REGULAR TABLESPACE ITMREG8K PAGESIZE 8 K
MANAGED BY SYSTEM
USING ('itmreg8k')2 BUFFERPOOL ITMBUF8k;
-- CREATE a System tablespace using the 8K Bufferpool
CREATE SYSTEM TEMPORARY TABLESPACE ITMSYS8K PAGESIZE 8 K
MANAGED BY SYSTEM
USING ('itmsys8k')2 BUFFERPOOL ITMBUF8k;
-- CREATE a User tablespace using the 8K Bufferpool
CREATE USER TEMPORARY TABLESPACE ITMUSER8K PAGESIZE 8 K
MANAGED BY SYSTEM
USING ('itmuser8k')2 BUFFERPOOL ITMBUF8k;
Notes:
1. SIZE is the number of 8K pages to allocate for the bufferpool. If there is sufficient memory, performance can be
improved by increasing this number.
2. A fully qualified path can be specified here. As shown this will be created in a default directory.
3. IBM Tivoli Monitoring creates SMS tablespaces, which cannot be extended across multiple drives.
355
Procedure
To limit the authority of the warehouse user, complete the following steps:
1. Connect to the data warehouse with db2admin privileges:
db2 connect to warehouse user db2admin using password
where warehouse is the name of the Warehouse database, db2admin is the DB2 for the workstation
administrator ID, and password is the password of the db2admin user ID. The user ID must be a DB2
user with SYSADM authority
2. Change to the directory where the KHD_DB2_crt_BP_TBSP.sql script is located.
3. Run the script to create the required bufferpool and tablespaces:
db2 -stvf KHD_DB2_crt_BP_TBSP.sql
4. Remove administrative privileges from the warehouse user (OS user) that you created when you
created the warehouse database:
v On Windows, remove the warehouse user from the Administrator group.
v On Linux or UNIX, remove the warehouse user from the SYSADM group to which it was assigned
(for example, DB2GRP1). (See Creating a warehouse user on Linux or UNIX on page 354.)
5. Grant these database authorities to the warehouse user:
CONNECT
CREATETAB
USE OF TABLESPACE
CONNECT authority grants the user access to the database. CREATETAB authority allows the user to
create and drop tables, to alter tables, to create and drop indexes for the tables, and to insert, delete,
or update data in the tables. USE OF TABLESPACE grants the user authority to use particular
tablespaces, in this case ITMREG8K.
To grant these authorities, you can use either the DB2 Control Center (Database Authorities window)
or the command line interface. If you use the command line interface, run commands similar to the
following. In this example, the name of the warehouse user is itmuser.
db2 "GRANT CONNECT ON DATABASE TO USER itmuser"
db2 "GRANT CREATETAB ON DATABASE TO USER itmuser"
db2 "GRANT USE OF TABLESPACE ITMREG8K TO itmuser"
If you have upgraded or will be upgrading IBM Tivoli Monitoring to a later release or fix pack, the
ALTER privilege is necessary:
db2 "GRANT ALTER ON DATABASE TO USER itmuser"
Setting database and instance configuration values

The default values for many of the configuration values for the DB2 for the workstation database and the
DB2 for the workstation instance may not be acceptable for a production environment. Following are a few
of the values you should consider adjusting. Consult the DB2 for the workstation documentation or your
DB2 database administrator for other adjustments that can improve performance.
LOGPRIMARY
Number of primary transaction logs. In a production environment, this value should be larger than the
default value.
LOGSECOND
Number of secondary log files. In a production environment, this value should be larger than the
default value.
NEWLOGPATH
Location of transaction logs. To improve performance, the logs should be placed on a separate
physical disk from the tables and indexes.
356
LOGFILSIZ
Size of transaction log files. In a production environment, this value should be larger than the default
value.
LOCKTIMEOUT
Defaults to infinite wait, which can cause Warehouse Proxy and Summarization and Pruning
processing to appear to be locked up. This should be set to a reasonable value such as 120 seconds.
Activating the DB2 listeners on a UNIX DB2 server

The TCP/IP listener processes on the DB2 for the workstation server where the Tivoli Data Warehouse
database is installed must be active in order to accept connections from a DB2 for the workstation client or
a JDBC Type 4 driver (DB2 for the workstation JDBC Universal Driver). On a Windows system, the DB2
listeners are automatically activated. Run the following commands on a UNIX system where the Tivoli Data
Warehouse database is installed to activate the DB2 for the workstation listeners:
db2set -i instance_name DB2COMM=tcpip
db2 update dbm cfg using SVCENAME port_number
db2stop
db2start
where instance_name is the name of the instance in which you created the warehouse database and
port_number is the listening port for the instance. (The port number is specified in the file /etc/services.)
For example:
db2set -i db2inst1 DB2COMM=tcpip
db2 update dbm cfg using SVCENAME 60000
db2stop
db2start
357
Step 2: Install and configure communications for the Warehouse Proxy

agent
You can install one or more Warehouse Proxy agents to collect and send historical data to the Tivoli Data
Warehouse database. Complete the tasks described in the following table, in the order listed, to install and
configure each Warehouse Proxy agent.
Table 73. Tasks for installing and configuring communications for the Warehouse Proxy agent
Task
Procedure
Install one or more Warehouse Proxy agents. If you want to install a

Summarization and Pruning agent on the same computer as one of the
Warehouse Proxy agents, use the referenced procedures to install both
agents at the same time.
To install a Warehouse Proxy agent on

Windows, complete the procedure
on page 184.
If you are installing more than one Warehouse Proxy agent, each agent
must be installed on a separate computer.

Linux or AIX, complete the procedure
Linux or UNIX: Installing a monitoring
agent on page 189, including the
following subsections:
The installation procedure for Windows includes steps for configuring the
connection between the agent and the hub Tivoli Enterprise Monitoring
server. On Linux or AIX, this step is performed in a separate configuration
v Installing the monitoring agent
procedure (Configuring the monitoring agent) and an X11 GUI is required
v Configuring the monitoring agent
to configure the agent. Alternatively, you can run the following command
to utilize an X terminal emulation program (such as Cygwin) that is
v Changing the file permissions for
running on another computer:
agents (if you used a nonroot user to
install the Warehouse Proxy)
Do not complete the procedure for
where my_windows_pc_IP_addr is the IP address of a computer that is
starting the agent.
running an X terminal emulation program. See the information at right. Be
sure to perform all referenced installation and configuration procedures.
Note for sites setting up autonomous operation:: The installation
procedure includes steps for configuring the connection between the
agent and the hub Tivoli Enterprise Monitoring Server. On Windows
operating systems, if you want to run the Warehouse Proxy agent without
a connection to the hub, accept the defaults for the connection
information, but specify a nonvalid name for the monitoring server. On
UNIX and Linux operating systems, check No TEMS on the TEMS
Connection tab of the configuration window.
(Warehouse Proxy agent on Windows only)
v Install a DB2 for the workstation client on the computer where the
Warehouse Proxy agent is installed if both of the following statements
are true:
The Warehouse Proxy is installed on Windows, and
The Warehouse Proxy needs to connect to a remote data
warehouse.
v Catalog the remote data warehouse on the Windows computer where
you installed the DB2 for the workstation client. You must perform this
step before configuring an ODBC data source. (See the next row.)
v Set the following system variable on the computer where the
Warehouse Proxy agent is installed. Restart the computer after setting
the variable.
DB2CODEPAGE=1208
Set the environment variable whether or not the warehouse database
is local or remote.
358
Refer to the DB2 for the workstation

documentation for instructions on how to
install a DB2 for the workstation client.
To catalog a remote data warehouse, see
Cataloging a remote data warehouse on
page 359.
Table 73. Tasks for installing and configuring communications for the Warehouse Proxy agent (continued)
Task
Procedure
Configuring an ODBC data source for a

DB2 data warehouse on page 360
On the computer where the Warehouse Proxy agent is installed, configure

an ODBC data source for the data warehouse.
Perform this procedure whether or not the Warehouse Proxy agent and
the warehouse database are installed on the same computer.
(Warehouse Proxy agent on Linux or AIX only)
The Type 4 driver file names and

locations are as follows:
If the data warehouse is located on a remote computer, copy the DB2 for
the workstation JDBC Universal Driver (Type 4 driver) JAR files, included db2installdir/java/db2jcc.jar
with the DB2 for the workstation product installation, to the local computer db2installdir/java/db2jcc_license_cu.jar
where the Warehouse Proxy agent is installed. You can copy the files to
any directory on the local computer.
where db2installdir is the directory where
DB2 for the workstation was installed.
The default DB2 for the workstation
Version 9 installation directory is as
follows:
v On AIX: /usr/opt/db2_09_01
v On Linux: /opt/IBM/db2/V9.1
Configure the Warehouse Proxy agent to connect to the data warehouse.
For a Warehouse Proxy agent on

Windows, see Configuring a Warehouse
Proxy agent on Windows (ODBC
connection) on page 361.
For a Warehouse Proxy agent on Linux
or AIX, see Configuring a Warehouse
Proxy agent on Linux or UNIX (JDBC
If you are installing more than one Warehouse Proxy agent within the
same hub monitoring server installation, associate each Warehouse Proxy
agent with a subset of monitoring servers (hub or remote) within the
installation. Each Warehouse Proxy agent receives data from the
monitoring agents that report to the monitoring servers on the list. Use the
environment variable KHD_WAREHOUSE_TEMS_LIST to specify a list of
monitoring servers to associate with a Warehouse Proxy agent.
For instructions about installing and

configuring multiple Warehouse Proxy
agents within a single hub monitoring
server installation, see Installing and
agents on page 445.
(Optional) Customize the configuration of the Warehouse Proxy agent for

tuning performance.
Tuning the performance of the

Warehouse Proxy on page 456
Start the Warehouse Proxy agent.
Starting the Warehouse Proxy on page

366
Cataloging a remote data warehouse

Perform this procedure on a computer where a DB2 for the workstation client is installed to enable
communication between the client and a remote DB2 for the workstation server where the data warehouse
is installed. For example, use this procedure to set up communication to a remote DB2 data warehouse
server from:
v The DB2 for the workstation client on the computer where the Tivoli Enterprise Portal Server is installed
(on any platform)
v The DB2 client on a Windows computer where a Warehouse Proxy agent installed
Do not perform this procedure on the computer where the data warehouse (DB2 server) is installed or on
a computer where there is no DB2 client (for example, on a computer where a Type 4 DB2 for the
workstation JDBC driver is used to communicate with the remote DB2 server).
359
Complete the following steps on the computer where the DB2 for the workstation client is installed (the
local computer):
1. Catalog the remote TCP/IP node where the warehouse database is installed:
db2 catalog tcpip node node_name remote host_name server port
db2 terminate
where the indicated variables identify the location and port of the remote DB2 for the workstation
server. For host_name, specify the host name or IP address. The default port for a DB2 server is
60000. For example:
db2 catalog tcpip node amsc2424 remote 8.53.36.240 server 60000
db2 terminate
2. Catalog the remote Tivoli Data Warehouse database:

db2 catalog db db_name as db_alias at node node_name
db2 terminate
where
db_name is the name of the remote warehouse database.
db_alias is the nickname or alias used to identify the remote warehouse database on the local
computer. The local alias for the warehouse database must match the name that you specify in the
configuration procedure for the portal server, Warehouse Proxy agent, or Summarization and
Pruning agent.
node_name is the name of the node where the warehouse database is located.
Example:
db2 catalog db WAREHOUS as WAREHOUS at node amsc2424
db2 terminate
3. Test the connection to the remote warehouse database:

db2 connect to db_alias user user_name using user_password
where:
db_alias
Is the nickname or alias used to identify the remote warehouse database on the local computer.
user_name
Is the user ID that the local DB2 client uses to access the warehouse database.
user_password
Is the password for that user_name.
These values must match the values that you specify in the configuration procedures for the portal
server, Warehouse Proxy agent, or Summarization and Pruning agent.
Example:
db2 connect to WAREHOUS user itmuser using itmpswd1
Configuring an ODBC data source for a DB2 data warehouse

A DB2 for the workstation client on Windows requires an ODBC connection to the data warehouse. For the
Warehouse Proxy agent, you must configure the ODBC connection manually.
Before you begin

v If the warehouse database is remote from the Warehouse Proxy agent, catalog the remote database
before you configure the ODBC data source. See Cataloging a remote data warehouse on page 359.
The ODBC connection does not work if the remote database has not been cataloged prior to performing
this procedure.
360
v This procedure uses default values for the data source name, warehouse alias, and warehouse user ID.
(Default values are used in configuration procedures for warehousing components.) Substitute different
values if you do not want to use the default values.
Procedure
Complete the following procedure to set up an ODBC connection for a Warehouse Proxy agent on
Windows to a local or remote Tivoli Data Warehouse.
1. On the computer where the Warehouse Proxy agent is installed, open the Control Panel.
2. Click Administrative Tools Data Sources (ODBC)
3. Click Add in the System DSN tab in the ODBC Data Source Administrator window.
4. Select IBM DB2 ODBC DRIVER from the list.
5. Click Finish.
6. In the ODBC DB2 Driver - Add window, perform the following steps:
a. Enter ITM Warehouse in Data source name.
b. Enter Warehous in Database Alias.
If the Tivoli Data Warehouse is located on a remote computer, ensure that the database alias
matches the alias that you used when cataloging the remote data warehouse. See Cataloging a
remote data warehouse on page 359.
If local, ensure that the database alias matches the name used for the warehouse database.
c. Click OK.
7. Test the ODBC database connection before continuing:
a. In the ODBC Data Source Administrator window, select ITM Warehouse.
b. Click Configure.
c. In the CLI/ODBC Settings - ITM Warehouse window, you see the data source name, ITM
Warehouse.
d. Enter ITMUser for the User ID.
e.
f.
g.
h.
Type a password for the user in the Password field. The default password is itmpswd1.
Click Connect.
A Connection test successful message is displayed.
Click OK.
i. Click OK to close the window.
Configuring a Warehouse Proxy agent on Windows (ODBC connection)

Use this procedure to configure a Warehouse Proxy agent on Windows to connect to a DB2 for the
workstation data warehouse:
1. Log on to the Windows system where the Warehouse Proxy agent is installed and begin the
configuration:
a. Click Start Programs IBM Tivoli Monitoring Manage Tivoli Monitoring Services.
b. Right-click Warehouse Proxy and click Configure Using Defaults.
Click Reconfigure if the Warehouse Proxy is installed on the same computer as the portal server.
c. Click OK on the message regarding connection to a hub monitoring server.
2. The next two windows (entitled Warehouse Proxy: Agent Advanced Configuration) contain the settings
for the connection between the Warehouse Proxy agent and the hub monitoring server. These settings
were specified when the Warehouse Proxy agent was installed. Click OK on each window to accept
the settings.
3. Click Yes on the message asking if you want to configure the ODBC data source.
361
4. Select DB2 from the list of selectable databases (see Figure 52), and click OK
.
Figure 52. Warehouse Proxy Database Selection screen
The following configuration window is displayed.
362
Figure 53. Configure DB2 Data Source for Warehouse Proxy window
5. Click OK to accept all default information on this window, or change one or more default values and
then click OK. The fields on this window are described in Table 74 on page 364.
Note: The values for the data source name, database name, and database user ID and password
must match the values that you used when configuring an ODBC connection for the Warehouse
Proxy agent. (See Configuring an ODBC data source for a DB2 data warehouse on page
360.)
363
Table 74. Configuration information for the Tivoli Data Warehouse database on DB2 for the workstation
Field
Default value
Description
Data Source Name
ITM Warehouse
Database Name
WAREHOUS
The name of the database. If the Warehouse Proxy agent

is not installed on the same computer as the Tivoli Data
Warehouse, this value must match the name of the
database alias you used when cataloging the remote data
warehouse. (See Cataloging a remote data warehouse
on page 359.)
Admin User ID
db2admin
Admin Password
(no default)
The password for the database administrator.
Database User ID
ITMUser
The name of the Windows OS user that the Warehouse

Proxy agent will use to access the Tivoli Data Warehouse
database.
Database Password
itmpswd1
The password for the Windows OS user. If your

environment requires complex passwords (passwords that
require both alpha and numeric characters), specify a
password that complies with these requirements.
Reenter Password
itmpswd1
Synchronize TEPS Warehouse

Information
yes
This check box is used only if you are re-configuring a

Warehouse Proxy agent that is installed on the same
Windows computer as the portal server. If this check box is
selected, any change that you make to the connection
information on this window for the Warehouse Proxy is
automatically applied to the portal server.
6. Click OK.
Configuring a Warehouse Proxy agent on Linux or UNIX (JDBC

connection)
Use this procedure to configure a Warehouse Proxy agent on Linux or UNIX to connect to a DB2 for the
workstation Tivoli Data Warehouse on any operating system:
1. Log on to the computer where the Warehouse Proxy agent is installed and begin the configuration.
a. Change to the install_dir/bin directory and run the following command:
./itmcmd manage [-h install_dir]
where install_dir is the installation directory for IBM Tivoli Monitoring. The default installation
directory is /opt/IBM/ITM.
b. Right-click Warehouse Proxy and click Configure.
The Configure Warehouse Proxy window is displayed.
364
Figure 54. Configure Warehouse Proxy window (TEMS Connection tab)
2. On the TEMS Connection tab, review the settings for the connection between the Warehouse Proxy
agent and the hub monitoring server. Correct the settings if necessary.
The Warehouse Proxy agent must use the same protocols used by the application agents and by the
hub monitoring. If the proxy agent does not have the same protocol as the hub monitoring server, it
cannot register with the hub. If the proxy does not have the same protocol as the application agents,
then the application agents cannot communicate with the proxy when they to try create a route to it.
Figure 55. Configure Warehouse Proxy window (Agent Parameters tab)
4. In the Database drop-down list, select DB2.

5. Add the names and directory locations of the JDBC driver JAR files to the JDBC Drivers list box:
365
a. Use the scroll bar at the bottom of the window to display the Add and Delete buttons, which are
located to the right of the JDBC Drivers list box.
b. Click Add to display the file browser window. Navigate to the location of the driver files on this
computer and select the following driver files:
db2jcc.jar
db2jcc_license_cu.jar
c. Click OK to close the browser window and add the JDBC driver files to the list.
If you need to delete an entry from the list, select the entry and click Delete.
6. Change the default value displayed in the Warehouse URL field if it is not correct. The default Tivoli
Data Warehouse URL for IBM DB2 for the workstation is as follows:
jdbc:db2://localhost:60000/WAREHOUS
v If the Tivoli Data Warehouse is installed on a remote computer, specify the host name of the
remote computer instead of localhost.
v Change the port number if it is different.
v If the name of the Tivoli Data Warehouse database is not WAREHOUS, replace WAREHOUS with
the actual name. (See Creating the warehouse database on DB2 for the workstation on page
353.)
Note: When specifying the DB2 for the workstation database name on Linux and UNIX, case is
ignored. In other words, it makes no difference whether you provide the database name in
lowercase or uppercase.
7. Verify the JDBC driver name, which is displayed in the Warehouse Driver field. (Note that the
Warehouse Driver field displays the driver name, in contrast to the driver JAR files that are listed in
the JDBC Drivers field.)
The DB2 for the workstation JDBC driver name is as follows:
com.ibm.db2.jcc.DB2Driver
8. If necessary, change the entries in the Warehouse User and Warehouse Password fields to match
the user name and password that were created for the Tivoli Data Warehouse. (See Creating the
warehouse database on DB2 for the workstation on page 353.) The default user name is itmuser
and the default password is itmpswd1.
9. Check the Use Batch check box if you want the Warehouse Proxy agent to submit multiple execute
statements to the Tivoli Data Warehouse database for processing as a batch.
In some situations, such as crossing a network, sending multiple statements as a unit is more
efficient than sending each statement separately. Batch processing is one of the features provided
with the JDBC 2.0 API.
10. Click Test database connection to ensure you can communicate with the Tivoli Data Warehouse
database.
11. Click Save to save your settings and close the window.
Starting the Warehouse Proxy

v To start the Warehouse Proxy agent from the Manage Tivoli Enterprise Monitoring Services window,
right-click Warehouse Proxy and select Start.
v (Linux or AIX only) To start the Warehouse Proxy agent from the command line, run the following
command from the bin directory of the IBM Tivoli Monitoring installation directory. The default installation
./itmcmd agent start hd
where hd is the product code for the Warehouse Proxy agent.
366
Step 3: Configure communications between the Tivoli Enterprise Portal

Server and the data warehouse
Complete the tasks described in the following table, in the order listed, to configure communications
between the portal server and the data warehouse.
Table 75. Tasks for configuring communications between the portal server and a DB2 for the workstation data
warehouse
Task
Procedure
(Portal server on Windows only)
Refer to the DB2 for the workstation

If the portal server database was created on Microsoft SQL Server, install install a DB2 for the workstation client.
a DB2 for the workstation database client on the portal server.
If the portal server database was created on DB2 for the workstation, the
DB2 client already exists on the portal server.
On the computer where the portal server is installed, catalog the remote
data warehouse. You must perform this step before configuring the portal
server to connect to the data warehouse. (See the next row.)
Cataloging a remote data warehouse on

page 359
Cataloging the remote data warehouse enables communications between

the DB2 for the workstation client on the portal server and the remote
DB2 for the workstation server where the data warehouse is located.
Complete this task regardless of which platforms are used by the portal
server or the data warehouse.
Configure the portal server to connect to the data warehouse.
The configuration procedure on Windows automatically configures an
ODBC connection to the data warehouse.
For a portal server on Windows, see

Configuring a Windows portal server
(ODBC connection).
For a portal server on Linux or AIX, see
Configuring a Linux or AIX portal server
(DB2 for the workstation CLI connection)
on page 369.
Restart the portal server.
Test the connection between the portal server and the Tivoli Data
Testing the connection between the
Warehouse by creating a customized query in the Tivoli Enterprise Portal. portal server and the Tivoli Data
Configuring a Windows portal server (ODBC connection)

The procedure described in this section uses the Manage Tivoli Enterprise Monitoring Services window to
configure an ODBC connection between a Windows portal server and the data warehouse. You do not
need to configure the ODBC data source through the Control Panel in Windows.
Before you begin

Catalog the remote warehouse database before you configure the Windows portal server to connect to the
database. See Cataloging a remote data warehouse on page 359. The ODBC connection does not work
if the remote database has not been cataloged prior to performing this procedure.
Procedure
Complete the following procedure to configure a portal server on Windows to connect to a DB2 for the
workstation data warehouse:
1. Log on to the Windows system where the portal server is installed and begin the configuration:
367
b. Right-click Tivoli Enterprise Portal Server and click Reconfigure.

2. The next two windows (entitled TEP Server Configuration) contain the settings for the connection
between the portal server and the hub monitoring server. These settings were specified when the
portal server was installed. Click OK on each window to accept the settings.
3. Click Yes on the message asking if you want to reconfigure the warehouse information for the Tivoli
4. Select DB2 from the list of databases and click OK.
Figure 56. Configure DB2 Data Source for Warehouse window
368
then click OK. The fields on this window are described in the following table.
Field
Default value
Description
Data Source Name
ITM Warehouse
Database Name
WAREHOUS
The name of the database. This value must match the

name of the database alias you used when cataloging the
remote Tivoli Data Warehouse on the portal server. (See
Cataloging a remote data warehouse on page 359.)
Admin User ID
db2admin
Admin Password
(no default)
Database User ID
ITMUser
The name of the Windows OS user that the portal server

will use to access the Tivoli Data Warehouse database.
Database Password
itmpswd1
The password for the Windows user. If your environment

requires complex passwords (passwords that require both
alpha and numeric characters), specify a password that
complies with these requirements.
Reenter Password
itmpswd1
6. Click OK.
Configuring a Linux or AIX portal server (DB2 for the workstation CLI
connection)
Use this procedure to configure a portal server on Linux or AIX to connect to a DB2 for the workstation
Tivoli Data Warehouse on any operating system.
1. Log on to the computer where the Tivoli Enterprise Portal Server is installed and begin the
configuration.
b. Right-click Tivoli Enterprise Portal Server and click Configure.
2. On the TEMS Connection tab, review the settings for the connection between the portal server and
the hub monitoring server. These settings were specified when the portal server was installed.
4. Select the DB2 radio button.
The fields for configuring the connection to a DB2 for the workstation data warehouse are displayed at
the bottom of the window.
369
Figure 57. Configuring the connection to a DB2 for the workstation data warehouse
5. Enter information in the fields described in the following table:

Field
Default value
Description
Warehouse database name
WAREHOUS
The name of the Tivoli Data Warehouse database.
Warehouse database user ID
itmuser
The login name of the database user that the portal server
Warehouse user password
itmpswd1

Re-type warehouse user password
itmpswd1

Use the following steps to start the portal server:
v To start the portal server from the Manage Tivoli Enterprise Monitoring Services window, right-click
Tivoli Enterprise Portal Server and select Start.
v (Linux or AIX only) To start the portal server from the command line, run the following command from
the bin directory of the IBM Tivoli Monitoring installation directory. The default installation directory is
/opt/IBM/ITM.
370
Step 4: Install and configure communications for the Summarization

and Pruning agent
Complete the tasks described in the following table, in the order listed, to install and configure the
Summarization and Pruning agent.
Table 78. Tasks for installing and configuring communications for the Summarization and Pruning agent
Task
Procedure
Install the Summarization and Pruning agent if you have not already
installed it. For best performance, install the Summarization and Pruning
agent on the same computer as the data warehouse.
To install a Summarization and Pruning

agent on Windows, complete the
procedure Windows: Installing a
monitoring agent on page 184.
procedure (Configuring the monitoring agent). See the information at right.
Be sure to perform all referenced installation and configuration
procedures.
Note: The Summarization and Pruning agent is not automatically started
after installation. Do not complete any step or procedure for starting the
agent at this point.

agent on Linux or UNIX, complete the
procedure Linux or UNIX: Installing a
monitoring agent on page 189, including
the following subsections:
starting the agent.
If the data warehouse is located on a remote computer, copy the DB2 for
the workstation JDBC Universal Driver (Type 4 driver) JAR files, included
with the DB2 for the workstation product installation, to the local computer
where the Summarization and Pruning agent is installed. You can copy
the files to any directory that the user that the Summarization and Pruning
agent process runs as has access to.
The Type 4 driver file names and

locations are as follows:
db2installdir/java/db2jcc.jar
db2installdir/java/
db2jcc_license_cu.jar
where db2installdir is the directory where
DB2 for the workstation was installed.
The default DB2 for the workstation
Version 9 installation directory is as
follows:
v On Windows:
C:\Program Files\IBM\SQLLIB
v On AIX:
/usr/opt/db2_09_01
v On Linux or Solaris:
/opt/IBM/db2/V9.1
Configuring the Summarization and

Pruning agent (JDBC connection) on
When you configure the Summarization and Pruning agent, you configure page 435
the connection to the Tivoli Data Warehouse and you specify settings that
control the operation of the Summarization and Pruning agent.
Configure the Summarization and Pruning agent.
Perform this procedure whether or not the Summarization and Pruning

agent and the warehouse database are installed on the same computer.
Configure the Summarization and Pruning agent to connect to the Tivoli
Enterprise Portal Server. Perform this procedure whether or not the
Summarization and Pruning agent and the warehouse database are
installed on the same computer.
See Step 9 of Configuring the

Summarization and Pruning agent (JDBC
371
Table 78. Tasks for installing and configuring communications for the Summarization and Pruning agent (continued)
Task
Procedure
Configure history collection.
See the IBM Tivoli Monitoring:

Administrator's Guide for instructions on
how to configure history collection.
When you configure history collection, you specify settings for how often
to collect, aggregate, and prune data for individual monitoring agents and
attribute groups. Configure history collection from the Tivoli Enterprise
Portal.
Start the Summarization and Pruning agent.
372
Starting the Summarization and Pruning

agent on page 444
Chapter 17. Tivoli Data Warehouse solution using DB2 on

z/OS
mainframe-based DB2 running on z/OS as your warehouse database. The following table lists the goals
for creating a DB2 on z/OS solution.
Table 79. Goals for creating a Tivoli Data Warehouse solution using DB2 on z/OS
Goal
Review your options, specific to a DB2 on z/OS solution,

for operating system platforms and communications
Supported components on page 374



DB2 on z/OS on page 376

Warehouse solution using DB2 on z/OS for the data
warehouse.
Step 1: Connect the Warehouse Proxy node to your DB2

on z/OS database on page 378
Step 2: Configure the Tivoli Data Warehouse agents on
page 391
373
Figure 58 presents the IBM Tivoli Monitoring environment when implementing a Tivoli Data Warehouse
solution using DB2 on z/OS as the warehouse database. The diagram summarizes the supported
operating system platforms for the various warehousing components, the supported database products,
and the connections between components. For more specific information about supported operating
systems and database products, including product names and versions, see Hardware and software
requirements on page 96.
Figure 58. Tivoli Data Warehouse solution using DB2 on z/OS
not already exist.
Tivoli Data Warehouse on DB2 on z/OS
A Tivoli Data Warehouse repository on DB2 on z/OS can be accessed by any ITM-supported platform that
can run the Warehouse Proxy agentWindows, Linux, or AIXas well as the DB2 Connect software.
connection. Install a Type 4 driver (DB2 on z/OS JDBC Universal Driver) on the computer where the
Warehouse Proxy agent is located.
connection. The ODBC driver is included with the DB2 on z/OS client. You must install a DB2 client on the
Windows computer where the Warehouse Proxy agent is located, and then catalog the remote node and
database on the local computer.
374
Note: If you install a version 9 DB2 client, you also must install DB2 Connect Server Edition to connect to
a DB2 on z/OS data server.
connection from any supported operating system. Install a DB2 on z/OS Type 4 JDBC driver (DB2 on
z/OS JDBC Universal Driver) on the computer where the Summarization and Pruning agent is located.
including the warehousing components (see the appropriate chapter within this section for the necessary
installation instructions). Include the following components in each hub installation:
v
v
v
v
The hub Tivoli Enterprise Monitoring Server

(Optional) One or more remote monitoring servers
The Tivoli Enterprise Portal Server, on either Windows, Linux, or UNIX
An IBM DB2 on z/OS server on the computer where you will create the Tivoli Data Warehouse
database. (The Tivoli Data Warehouse database can be shared in a multi-hub installation or dedicated
to a single hub.)
v DB2 Connect Server Edition.

v (Optional) Monitoring agents and the application support for the monitoring agents
v The Warehouse Proxy agent and the Summarization and Pruning agent
Refer to Table 80 for related information:
Topic


components, excluding the Warehouse Proxy
agent and the Summarization and Pruning
agent


Chapter 17. Tivoli Data Warehouse solution using DB2 on z/OS
375
Implementing a Tivoli Data Warehouse solution using DB2 on z/OS

DB2 on z/OS version 9.1 (or subsequent) as your data warehouse.
Requirements
The Warehouse Proxy agent and the Summarization and Pruning agent both use the implicit table creation
option when connected to a DB2 database on z/OS. Both agents create tables without specifying a table
space or a database in the IN clause of a CREATE statement.
v
DB2 on z/OS version 9 creates an implicit database each time a table is created using a name in the
range DSN00001 to DSN60000. The characteristics of implicitly created databases are shown in
Table 81.
Table 81. Characteristics of implicitly created DB2 on z/OS database

Field
Value
Name
DSNxxxxx, where xxxxx is a number from 00001 to

60000
BUFFERPOOL
BP0, BP8K0, BP16K0, BP32K1

Default values. Changeable through DSNZPARM update
INDEXBP
IDXBPOOL setting in DSNZPARM
STOGROUP
SYSDEFLT
value in column IMPLICIT of SYSIBM.SYSDATABASE
ENCODING_SCHEME
DEFAULT is the DSNHDECP setting (see below)
SBCS_CCSID
DBCS_CCSID
MIXEC_CCSID
Notes:
1. DB2 on z/OS chooses a specific buffer pool during creation of the implicit object, depending on the
record size. When the maximum record size reaches approximately 90% of the capacity of the
smaller page size, DB2 chooses the next larger page size, as shown in Table 82.
Table 82. Maximum DB2 on z/OS page sizes
Name
Page Size
BP0
4K
BP8KO
8K
BP16KO
16KB
BP32K
32KB
2. To ensure databases can be created implicitly, DB2 on z/OS's CREATE IMPLICIT DATABASES
installation parameter must be set to YES.
v DB2 on z/OS v9 creates implicit table spaces when implicitly creating a table.
v The Summarization and Pruning agent creates functions that Tivoli Enterprise Portal user can take
advantage of when creating custom history queries. To let the agent create those functions, a default
WLM (Workload Manager) should be created.
v Before beginning this procedure, gather the following information about your target DB2 on z/OS
database:
376
Table 83. Required parameters for accessing the DB2 on z/OS database
DB2 on z/OS parameter
Your value
Database name
Port number
DB2 userid
DB2 password
Fully qualified host name
Solution steps
To implement your Tivoli Data Warehouse solution using DB2 on z/OS, complete the major steps
described in the remaining sections of this chapter, in the order listed:
1. Connect the Warehouse Proxy node to your DB2 on z/OS database.
2. Configure the Tivoli Data Warehouse agents.
To implement your solution successfully:
v Perform the tasks in the order listed.
v Do not skip a task and move forward to the procedures that follow it.
377
Step 1: Connect the Warehouse Proxy node to your DB2 on z/OS

database
On the IBM Tivoli Monitoring node running the Warehouse Proxy agent, invoke the DB2 Client
Configuration Assistant from the DB2 Control Center.
The Client Configuration Assistant, shown in Figure 59, opens.
Figure 59. DB2 Client Configuration Assistant screen
378
Start defining the database connection

From the Selected pulldown menu, select the Add Database Using Wizard menu option to set up the
connection to your DB2 on z/OS database.
The Add Database Wizard notebook opens with the Source tab active, as shown in Figure 60.
Figure 60. DB2 Add Database Wizard notebook, Source tab
Activate the Manually configure a connection to a database radio button; then click Next.
379
Define the communications protocol

The Add Database Wizard notebook reappears with the Protocol tab active, as shown in Figure 61.
Figure 61. DB2 Add Database Wizard notebook, Protocol tab
On the Protocol notebook page:

1. Activate the TCP/IP radio button.
2. Select the The database physically resides on a host or AS/400 system option.
3. Activate the Connect directly to the server radio button.
4. Click Next.
380
Define the TCP/IP communications parameters

The Add Database Wizard notebook reappears with the TCP/IP tab active, as shown in Figure 62.
Figure 62. DB2 Add Database Wizard notebook, TCP/IP tab
On the TCP/IP notebook page:

1. Enter the fully qualified IP Host name.
2. Specify the Port number. The default port for z/OS is 446.
3. Click Next.
381
Identify the DB2 on z/OS database

The Database tab opens, as shown in Figure 63.
Figure 63. DB2 Add Database Wizard notebook, Database tab
On the Database notebook page:

1. Enter the fully qualified Database name. For DB2 for the workstation, this is the database name;
however, with DB2 on z/OS, this is the subsystem name.
2. Enter the DB2 on z/OS Database alias. This field is required.
Note: The alias is limited to 8 characters. Do not create duplicate aliases across your Tivoli Monitoring
systems (such as WAREHOUS).
3. Click Next.
382
Register the database as an ODBC data source

The Data Source tab opens, as shown in Figure 64.
Figure 64. DB2 Add Database Wizard notebook, Data Source tab
On the Data Source notebook page, click Next.

1. Ensure the Register this database for CLI/ODBC option is selected.
2. Ensure the As system data source radio button is active.
3. Enter the fully qualified DB2 on z/OS Data source name. This is the name you will specify when
configuring the Warehouse Proxy agent in Step 2: Configure the Tivoli Data Warehouse agents on
page 391, for example, ITM Warehouse.
4. Click Next.
383
Identify the z/OS server containing the DB2 on z/OS database

The Node Options tab opens, as shown in Figure 65.
Figure 65. DB2 Add Database Wizard notebook, Node Options tab
On
1.
2.
3.
the Node Options notebook page:

Pull down the list of Operating system settings, and select OS/390 or z/OS.
For Instance name, specify your DB2 on z/OS instance name.
Click Next.
384
Define the DB2 on z/OS system options

The System Options tab opens, as shown in Figure 66.
Figure 66. DB2 Add Database Wizard notebook, System Options tab
On the System Options notebook page:

1. For System name, specify the host name or IP address of the z/OS system where your DB2 on z/OS
database is stored.
The Host name field gets filled in automatically with the same value.
2. Pull down the list of Operating system settings, and select OS/390 or z/OS.
3. Click Next.
385
Define the DB2 on z/OS security options

The Security Options tab opens, as shown in Figure 67.
Figure 67. DB2 Add Database Wizard notebook, Security Options tab
On the Security Options notebook page, activate the Server authentication (SERVER) radio button, and
click Next.
386
Complete the DB2 on z/OS host connection

The DCS Options tab opens, as shown in Figure 68.
Figure 68. DB2 Add Database Wizard notebook, DCS Options tab
On the DCS Options notebook page, click Finish.
387
Verify that the connection can be made

If your database definition is successful, the Add Database Confirmation window shown in Figure 69 is
displayed.
Figure 69. Connection-confirmation screen
If this window is not displayed, press the Back button, verify each notebook page, and correct the
information as necessary.
388
To test the connection to the remote DB2 on z/OS database, press the Test Connection button.
The Connect to DB2 Database screen, shown in Figure 70, opens.
Figure 70. Connect to DB2 Database screen
Enter the user ID and password for the remote DB2 on z/OS database, and press the Test Connection
button.
389
If the database connection can be made, the confirmation screen shown in Figure 71 is displayed.
Figure 71. DB2 Connection Confirmation screen
390
Step 2: Configure the Tivoli Data Warehouse agents

To enable storage of IBM Tivoli Monitoring historical data in your Tivoli Data Warehouse database on
z/OS, you need to perform the installation procedures for the Warehouse Proxy agent and the
Summarization and Pruning agent. Complete these two steps from Chapter 16, Tivoli Data Warehouse
solution using DB2 for the workstation, on page 349:
v Step 2: Install and configure communications for the Warehouse Proxy agent on page 358
Note: When specifying the DB2 on z/OS database name on Linux and UNIX, the correct case must be
used.
v Step 4: Install and configure communications for the Summarization and Pruning agent on page 371
Testing your DB2 on z/OS database connection

At any time you can invoke either of the following procedures to ensure your DB2 on z/OS database
connection is still active.
Testing the database connection using the DB2 Control Center

Invoke the DB2 Control Center, shown in Figure 72 on page 392.
391
Figure 72. DB2 Control Center
Select the plus sign ( ) to the left of the z/OS system that is running the DB2 on z/OS subsystem that
owns your Tivoli Data Warehouse repository; then expand its list of databases. The list should include the
database you're using.
To again check your database connection, right-click your database name, and select Connect from the
pop-up menu, as shown in Figure 73 on page 393.
392
Figure 73. DB2 Control Center right-click action menu
393
The Connect to the database window, shown in Figure 74, opens.
Figure 74. Connect to named database window
Enter the user ID and password for the remote DB2 on z/OS database, and press the OK button.
394
Testing the database connection using the DB2 command-line

processor
Invoke the DB2 Command Line Processor, shown in Figure 75.
Figure 75. DB2 Command Line Processor window. Note that the password is hidden in this figure.
Enter the following command at the db2 prompt:

connect to database_name user userid using password
where database_name is the name you assigned to the DB2 on z/OS database that contains your data
warehouse, and userid and password are the DB2 user ID and password required to access that
database.
The database information is displayed, as shown in Figure 75.
395
396
Chapter 18. Tivoli Data Warehouse solution using Microsoft

SQL Server
Microsoft SQL Server for the warehouse database. The following table lists the goals for achieving a
Microsoft SQL solution.
Table 84. Goals for achieving a Tivoli Data Warehouse solution using Microsoft SQL Server
Goal
Review your options, specific to a Microsoft SQL solution, Supported components on page 398
for operating system platforms and communications
Complete prerequisite configuration steps before
implementing your Tivoli Data Warehouse solution.


Microsoft SQL Server on page 400

Warehouse solution using Microsoft SQL Server for the
data warehouse.

page 402
page 410
397
Figure 76 presents the options for a Tivoli Data Warehouse solution using Microsoft SQL Server for the
warehouse database. The diagram summarizes the supported operating system platforms for the various
warehousing components, the supported database products, and the connections between components.
For more specific information about supported operating systems and database products, including product
names and versions, see Hardware and software requirements on page 96.
Figure 76. Tivoli Data Warehouse solution using Microsoft SQL Server
not already exist.
Tivoli Data Warehouse on Microsoft SQL Server
398
A Tivoli Data Warehouse database on Microsoft SQL Server can be installed on supported Windows
platforms.
connection. Install a Microsoft SQL Type 4 driver on the computer where the Warehouse Proxy is located.
Important: Use the 2005 SQL driver even if you are connecting to a warehouse database that was
created in Microsoft SQL Server 2000.
connection. The ODBC driver is included with the Microsoft SQL Server client. If the Tivoli Data
Warehouse is located on a remote computer, install a Microsoft SQL Server client on the local computer
where the Warehouse Proxy agent is located. Also, configure a remote client connection to the Tivoli Data
Warehouse.
A Tivoli Enterprise Portal Server on Windows can connect to a Microsoft SQL Server data warehouse
through a Microsoft SQL Server client installed on the portal server. If the portal server database
(designated as TEPS database in the diagram) uses Microsoft SQL Server, the client already exists.
Manually install a Microsoft SQL Server client on the portal server only if the portal server database uses
DB2 for the workstation.
The portal server communicates with the warehouse database through an ODBC connection. The ODBC
driver is included with the Microsoft SQL Server client. Configure a remote client connection to the Tivoli
Data Warehouse.
connection from any supported operating system. Install a Microsoft SQL Type 4 JDBC driver on the
computer where the Summarization and Pruning agent is located.
Important: Use the 2005 SQL driver even if you are connecting to a warehouse database that was
created in Microsoft SQL Server 2000.
v A Microsoft SQL Server instance on the computer where you will create the Tivoli Data Warehouse
database. (The Tivoli Data Warehouse database can be shared in a multi-hub installation or dedicated
to a single hub.) The SQL Server instance must be patched to the current service pack level.
Chapter 18. Tivoli Data Warehouse solution using Microsoft SQL Server
399
Refer to the following table for related information:
Topic


components


Implementing a Tivoli Data Warehouse solution using Microsoft SQL

Server
Microsoft SQL Server for the data warehouse.
Assumptions
Portal Server.
Solution steps
To implement your Tivoli Data Warehouse solution using Microsoft SQL Server, complete the four major
steps described in the remaining sections of this chapter, in the order listed:
1. Create the Tivoli Data Warehouse database.
2. Install and configure communications for the Warehouse Proxy agent.
3. Configure communications between the Tivoli Enterprise Portal Server and the data warehouse.
4. Install and configure communications for the Summarization and Pruning agent.
Except for Step 1, each major step consists of a series of installation and configuration tasks, listed and
described in a table. Use the step tables as a road map for implementing your solution. The step tables
describe the tasks at a high level, account for variations among configuration options (such as which
operating system is used for a component), and reference the appropriate sections for detailed
implementation procedures. To implement your solution successfully:
400

401

This section provides guidelines for creating the Tivoli Data Warehouse database using Microsoft SQL
Server 2000 and 2005. For specific instructions on how to create a Microsoft SQL Server database, refer
to the Microsoft SQL Server documentation or have a database administrator create the database for you.
When you create the warehouse database using Microsoft SQL Server, follow these guidelines:
v Connect to the Microsoft SQL database server and create the Tivoli Data Warehouse database using
the system administrator (sa) user.
v Create a database user login name and password that the warehousing components (portal server,
Warehouse Proxy agent, and Summarization and Pruning agent) can use to access the data
warehouse. In these instructions, this user account is referred to as the warehouse user.
You must have SQL Server authentication to create the warehouse user.
Note: The warehousing components must not use the system administrator (sa) user to connect to the
data warehouse.
v Consider using the default values shown in the following table for the warehouse name and warehouse
user. The default values are used in the configuration procedures for connecting the warehousing
components to the warehouse database.
Parameter
Default value

WAREHOUS
Note: When connecting to a DB2 on z/OS database, this
value is unnecessary.
User name
ITMUser
User password
itmpswd1
v If the Warehouse Proxy and Summarization and Pruning agents create database objects at runtime, you
must give the warehouse user public and db_owner privileges to the Tivoli Data Warehouse database.
The warehouse user may have much fewer rights if the schema publication tool is used to create the
database objects. If the schema tool is used, the warehouse user needs only the db_datareader and
db_datawriter roles. If the warehouse user has limited privileges, the schema tool must be used to
create any additional database objects (using the schema tool's updated mode) if the historical
configuration is changed; see Generating SQL statements for the Tivoli Data Warehouse: the schema
publication tool on page 340.
v For Microsoft SQL Server 2005, do the following:
Create a schema with the same name (and owner) as the database user login name (for example,
ITMUser) and change the default schema for the user from dbo to this login name. (This step is not
necessary if you are using Microsoft SQL Server 2000.)
Make sure the database is set up to support inbound network TCP/IP connections.
402

agent
Task
Procedure


on page 184.

connection between the Warehouse Proxy and the hub Tivoli Enterprise
Monitoring server. On Linux or AIX, this step is performed in a separate
configuration procedure (Configuring the monitoring agent). See the
information at right. Be sure to perform all of the referenced installation
and configuration procedures.
v Install a Microsoft SQL Server client on the computer where the
Warehouse Proxy agent is installed if both of the following statements
are true:

starting the agent.
Refer to the Microsoft SQL Server

install a Microsoft SQL client and
configure a remote client connection.

warehouse.
v Configure a remote client connection to the data warehouse server
using Microsoft SQL Server tools.
Configuring an ODBC data source for a
Microsoft SQL data warehouse on page
On the computer where the Warehouse Proxy agent is installed, configure 404
an ODBC data source for the data warehouse.
403
Task
Procedure
Obtain the 2005 JDBC driver from the

following Microsoft Web page:
Install the Microsoft SQL Server 2005 JDBC Driver (Type 4 driver) on the
computer where the Warehouse Proxy agent is installed. Use the 2005
SQL JDBC driver even if you are connecting to a Microsoft SQL Server
2000 data warehouse.
http://msdn.microsoft.com/data/jdbc/
default.aspx
Follow the instructions on the Microsoft
download page for installing the driver.
After you install the driver, the JAR file
name and location are as follows:
mssql2005installdir/sqljdbc_1.1/
enu/sqljdbc.jar



agents on page 445.

tuning performance.

Starting the Warehouse Proxy agent on

page 409
Configuring an ODBC data source for a Microsoft SQL data warehouse

A Microsoft SQL client on Windows requires an ODBC connection to the data warehouse. For the
Warehouse Proxy agent, you must configure the ODBC connection manually.
Note: This procedure uses default values for the data source name and warehouse user ID. (Default
values are used in configuration procedures for warehousing components.) Substitute different
values if you do not want to use the default values.
1. Open the Control Panel.
4. Select SQL Server and click Finish.
5. Enter ITM Warehouse in the Name field.
6. Select the Microsoft SQL Server where the Tivoli Data Warehouse is located from the drop down list
and click Next.
7. Select With SQL Server authentication using a login ID and password entered by the user.
404
8. Enter ITMUser for the Login ID.

The user ID must match exactly, including case, what was created in the SQL Server database if
using database authentication or the ID that was created in the Windows OS. Mixing the case will
cause tables to be created with dbo as the owner rather than ITMUser. This will cause many
warehousing components to not work correctly.
9. Type a password for the user in the Password field. The default password is itmpswd1.
10.
11.
12.
13.
14.
Click Next.
Click Next again.
Click Finish.
Click Test Data Source to test the connection to the database.
Click OK.

Use this procedure to configure a Warehouse Proxy agent on Windows to connect to a Tivoli Data
Warehouse in Microsoft SQL Server:
configuration:
for the connection between the Warehouse Proxy agent and the hub monitoring server. These settings
were specified when the Warehouse Proxy agent was installed. Click OK on each window to accept
the settings.
4. Select SQL Server from the list of databases (see Figure 52 on page 362) and click OK.
405
Figure 77. Configure SQL Data Source for Warehouse Proxy window
then click OK. The fields on this window are described in Table 88.
Note: The values for the data source name, and database user ID and password must match the
values that you used when configuring an ODBC connection for the Warehouse Proxy agent.
(See Configuring an ODBC data source for a Microsoft SQL data warehouse on page 404.)
Table 88. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server
Field
Default value
Description
Data Source Name
ITM Warehouse
Database Name
WAREHOUS

Note: When connecting to a DB2 on z/OS database, this
is the subsystem name.
406
Table 88. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server (continued)
Field
Default value
Description
Admin User ID
sa
Admin Password
(no default)
Database User ID
ITMUser
The user ID must match exactly, including case, what was
created in the SQL Server database if using database
authentication or the ID that was created in the Windows
OS.
Database Password
itmpswd1

Reenter Password
itmpswd1
Synchronize TEPS Warehouse

Information
yes
This check box is used only if you are re-configuring a

Warehouse Proxy agent that is installed on the same
Windows computer as the portal server. If this check box is
selected, any change that you make to the connection
information on this window for the Warehouse Proxy is
automatically applied to the portal server.
6. Click OK.

connection)
Use this procedure to configure a Warehouse Proxy agent on Linux or UNIX to connect to a Microsoft
SQL Server data warehouse:
407
agent and the hub monitoring server.
then the application agents cannot communicate with the proxy when they to create a route to it.
408
4. In the Database drop-down list, select MSSQL.

5. Add the name and directory location of the JDBC driver JAR file to the JDBC Drivers list box:
b. Click Add to display the file browser window. Navigate to the location of the JDBC driver JAR file
on this computer and select the file. The Microsoft SQL Server 2005 driver JAR file name and
default location after downloading from the Web are as follows:
mssql2005installdir/sqljdbc_1.1/enu/sqljdbc.jar
Important: Use the Microsoft SQL Server 2005 Driver even if you are connecting to a Microsoft
SQL Server 2000 data warehouse.
c. Click OK to close the browser window and add the driver file to the list.
6. Change the default value displayed in the Warehouse URL field if it is not correct. The Warehouse
URL for Microsoft SQL Server 2005 is as follows:
jdbc:sqlserver://localhost:1433;databaseName=WAREHOUS
the actual name. (See Table 86 on page 402.)
Warehouse Driver field displays the driver name, in contrast to the driver JAR file that is listed in the
JDBC Drivers field.)
The Microsoft SQL Server 2005 Driver name is as follows:
com.microsoft.sqlserver.jdbc.SQLServerDriver
the user name and password that were created for the Tivoli Data Warehouse. (See Step 1: Create
the Tivoli Data Warehouse database on page 402.) The default user name is ITMUser and the default
password is itmpswd1.
database.
Starting the Warehouse Proxy agent

Use the following steps to start the Warehouse Proxy agent:
409

Table 89. Tasks for configuring communications between the portal server and a Microsoft SQL Server data
warehouse
Task
Procedure
If the portal server database was created using DB2 for the workstation,
install a Microsoft SQL Server database client on the portal server.

install a Microsoft SQL Server database
If the portal server database was created using Microsoft SQL Server, the client.
Microsoft SQL Server database client already exists on the portal server.
Configure a remote client connection to the data warehouse server using

Microsoft SQL Server tools.

configure a remote client connection.
Configuring the portal server (ODBC

connection)
The configuration procedure automatically configures an ODBC

connection to the data warehouse.
On the Manage Tivoli Enterprise

Monitoring Services window, right-click
Tivoli Enterprise Portal Server and
select Start.
Configuring the portal server (ODBC connection)

Use this procedure to configure the portal server to connect to a Tivoli Data Warehouse in Microsoft SQL
Server:
4. Select SQL Server from the list of databases and click OK.
410
Figure 80. Configure SQL Data Source for Warehouse window
then click OK. The fields on this window are described in the following table:
Table 90. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server
Field
Default value
Description
Data Source Name
ITM Warehouse
Database Name
WAREHOUS
Admin User ID
sa
Admin Password
(no default)
Database User ID
ITMUser
411
Table 90. Configuration information for the Tivoli Data Warehouse database on Microsoft SQL Server (continued)
Field
Default value
Description
Database Password
(no default)

Reenter Password
(no default)
6. Click OK.

and Pruning agent
Task
Procedure

procedures.

starting the agent.
Install the Microsoft SQL Server 2005 JDBC Driver (Type 4 driver) on the Obtain the 2005 JDBC driver from the
computer where the Summarization and Pruning agent is installed. Use
the 2005 SQL JDBC driver even if you are connecting to a Microsoft SQL
http://msdn.microsoft.com/data/jdbc/
Server 2000 data warehouse.
default.aspx
Follow the instructions on the Microsoft
download page for installing the driver.
After you install the driver, the JAR file
name and location are as follows:
mssql2005installdir/sqljdbc_1.1/
enu/sqljdbc.jar

412
Task
Procedure



Portal.

agent on page 444
413
414
Chapter 19. Tivoli Data Warehouse solution using Oracle

Oracle for the warehouse database. The following table lists the goals for achieving an Oracle solution.
Table 92. Goals for achieving a Tivoli Data Warehouse solution using Oracle
Goal
Review your options, specific to an Oracle solution, for

operating system platforms and communications between
warehousing components.


Oracle on page 418

Warehouse solution using Oracle for the data warehouse. page 419
page 429
Figure 81 on page 416 presents the options for a Tivoli Data Warehouse solution using Oracle for the
warehouse database. The diagram summarizes the supported operating system platforms for the various
warehousing components, the supported database products, and the connections between components.
For more specific information about supported operating systems and database products, including product
names and versions, see Hardware and software requirements on page 96.
415
Figure 81. Tivoli Data Warehouse solution using Oracle
not already exist.
Tivoli Data Warehouse on Oracle
A Tivoli Data Warehouse database on Oracle can be installed on supported Windows, Linux, or any UNIX
platform support by Oracle. Ensure that the Oracle listener is active in order to accept connections from an
Oracle client or JDBC driver.
416

connection. Install an Oracle Type 4 JDBC driver on the computer where the Warehouse Proxy agent is
located. If the Tivoli Data Warehouse is located on a remote computer, create a TNS (Transparent
Network Substrate) Service Name on the local computer where the Warehouse Proxy agent is located.
connection. The ODBC driver is included with the Oracle client. If the Tivoli Data Warehouse is located on
a remote computer, install an Oracle client on the local computer where the Warehouse Proxy agent is
located. Also, create a TNS Service Name on the local computer.
A Tivoli Enterprise Portal Server on Windows communicates with an Oracle data warehouse through an
Oracle database client using an ODBC connection. You must manually install the Oracle client on the
portal server. The ODBC driver is included with the Oracle client.
A portal server on Linux or AIX communicates with the warehouse database through a JDBC connection.
Install an Oracle Type 4 JDBC driver on the portal server.
connection from any supported operating system. Install an Oracle Type 4 JDBC driver on the computer
where the Summarization and Pruning agent is located.
v An Oracle database server on the computer where you will create the Tivoli Data Warehouse database.
(The Tivoli Data Warehouse database can be shared in a multi-hub installation or dedicated to a single
hub.)
Refer to the following table for related information:
Topic

417
Table 93. Information topics related to installation of prerequisite software for a Tivoli Data Warehouse
solution (continued)
Topic

components


Implementing a Tivoli Data Warehouse solution using Oracle

Oracle for the data warehouse.
Assumptions
Portal Server.
Solution steps
To implement your Tivoli Data Warehouse solution using Oracle, complete the four major steps described
in the remaining sections of this chapter, in the order listed:
1. Create the Tivoli Data Warehouse database.
2. Install and configure communications for the Warehouse Proxy agent.
3. Configure communications between the Tivoli Enterprise Portal Server and the data warehouse.
4. Install and configure communications for the Summarization and Pruning agent.
Each major step consists of a series of installation and configuration tasks, listed and described in a table.
Use the step tables as a road map for implementing your solution. The step tables describe the tasks at a
high level, account for variations among configuration options (such as which operating system is used for
a component), and reference the appropriate sections for detailed implementation procedures. To
implement your solution successfully:
418

Complete the tasks described in the following table to create a Tivoli Data Warehouse database using
Oracle and to make it accessible to clients.
Table 94. Tasks for creating the Tivoli Data Warehouse database
Task
Procedure
Create the Tivoli Data Warehouse database on one of the For guidance on planning the size and disk requirements
supported Windows, Linux, or UNIX operating systems.
for the warehouse database, see Planning
considerations for the Tivoli Data Warehouse on page
To comply with the assumptions described in the
333.
introduction to this chapter, create the database on a
different computer from the Tivoli Enterprise Portal
For information about creating the warehouse database
Server.
using Oracle, see Creating the warehouse database on
Oracle.
Activate the Oracle listener on the Oracle server where
the Tivoli Data Warehouse is installed. To activate the
Oracle listener:
Refer to the Oracle documentation for instructions on how

to activate the Oracle listener.
v Use the Oracle Listener Service on Windows.

v Use the lsnrctl start command on Linux and UNIX.
Creating the warehouse database on Oracle

This section provides guidelines for creating the Tivoli Data Warehouse database on Oracle. For specific
instructions on how to create an Oracle database, refer to the Oracle documentation or have a database
administrator create the database for you.
When you create the warehouse database using Oracle, follow these guidelines:
v Use the Unicode character set (AL32UTF8) when creating the database.
v Create a database user login name and password that the warehousing components (portal server,
Warehouse Proxy agent, and Summarization and Pruning agent) can use to access the data
warehouse. In these instructions, this user account is referred to as the warehouse user.
v Use the default values shown in the following table for the warehouse name and warehouse user. The
default values are used in the configuration procedures for connecting the warehousing components to
the warehouse database.
Parameter
Default value
WAREHOUS
User name
ITMUser
User password
itmpswd1
v Create an ITM_DW role, and give this role the following permissions:
CREATE ROLE role not IDENTIFIED;
GRANT CREATE SESSION TO role;
GRANT ALTER SESSION TO role;
GRANT CREATE PROCEDURE TO role;
GRANT CREATE TABLE TO role;
GRANT CREATE VIEW TO role;
After you create the warehouse user ID that will be used by the Warehouse Proxy and the
Summarization and Pruning agents to connect to the Tivoli Data Warehouse database, give this user ID
the role you just created:
419
CREATE USER itmuser PROFILE DEFAULT IDENTIFIED by itmuser_password

ACCOUNT UNLOCK;
GRANT role TO itmuser;
As all the Tivoli Data Warehouse tables are created in the user's default tablespace, you need to
allocate enough space quota on the default tablespace to this user to create all the tables, or you can
simplify it by allowing unlimited tablespace to this user.
Note: The ITM_DW role needs the connect privilege only if the database objects are created using the
schema publication tool. If the historical configuration is changed and the warehouse user has
limited privileges, the schema tool must be used to create any additional database objects (using
the schema tool's updated mode; see Generating SQL statements for the Tivoli Data
Warehouse: the schema publication tool on page 340).
v Activate the Oracle listener using the Oracle Listener Service on Windows or the lsnrctl start command
on Linux and UNIX.
420

agent
Task
Procedure


on page 184.

procedures.
v Install an Oracle client on the computer where the Warehouse Proxy
agent is installed if both of the following statements are true:
warehouse.
v Ensure that the the latest Oracle patches are installed.
v Set the following system variable on the computer where the
Warehouse Proxy agent is installed. Restart the computer after setting
the variable. The format of the NLS_LANG environment variable is:

starting the agent.
Refer to the Oracle documentation for

instructions on how to install an Oracle
client.
Obtain Oracle ODBC drivers from the
following Web site:
http://www.oracle.com/technology/
software/tech/windows/odbc/htdocs/
utilsoft.html
NLS_LANG=language_territory.charset
Set the language and territory to appropriate variables. For the United
States this is NLS_LANG=AMERICAN_AMERICA.AL32UTF8.
Perform the last two tasks whether or not the warehouse database is
local or remote.
Creating a TNS Service Name on page

422
If the Tivoli Data Warehouse is located on a remote computer, create a

TNS (Transparent Network Substrate) Service Name on the local
computer where the Warehouse Proxy agent is located.
421
Task
Procedure
Configuring an ODBC data source for an

Oracle data warehouse on page 423
On the computer where the Warehouse Proxy agent is installed, configure

an ODBC data source for the data warehouse, using the TNS Service
Name that you created in the preceding step.
Install an Oracle Type 4 JDBC driver on the computer where the
Warehouse Proxy agent is installed.
Obtain the Oracle JDBC Driver from the

following Web site:
software/tech/java/sqlj_jdbc/index.html
The Oracle JDBC driver JAR file name
and location after installation is as
follows:
oracleinstalldir/jdbc/lib/
ojdbc14.jar
The ojdbc14.jar file supports JRE 1.5 or
higher, the required Java Runtime
Environment for IBM Tivoli Monitoring.



agents on page 445.

tuning performance.

Starting the Warehouse Proxy on page

428
Creating a TNS Service Name

Create a TNS (Transparent Network Substrate) Service Name (also called a Net Service Name) on a
computer where an Oracle client is installed if the Tivoli Data Warehouse exists on a remote Oracle server.
The TNS Service name is needed to create an ODBC connection between the client and the server. Use
this procedure to create a TNS Service name:
v On a Windows computer where a Warehouse Proxy agent installed.
v On a Windows computer where the Tivoli Enterprise Portal Server is installed.
422
Do not perform this procedure on the computer where the data warehouse (Oracle server) is installed or
on a computer where there is no Oracle client (for example, on a computer where a Type 4 Oracle JDBC
driver is used to communicate with the remote data warehouse).
Note: This procedure uses the default value for the warehouse name (WAREHOUS). Substitute a different
value if you do not want to use the default name.
Complete the following steps to create the TNS Service Name. Click Next after each step.
1. Enter dbca at the Oracle command line to start the Oracle Net Configuration Assistant tool.
2. On the Welcome window, select Local Net Service Name configuration.
3. Select Add.
4. Enter WAREHOUS in the Service Name field. (This is the remote name for the Tivoli Data Warehouse.)
5. Select TCP as the network protocol to communicate with the Tivoli Data Warehouse database.
6. Specify the fully qualified host name and port number of the computer where the warehouse
database is installed.
7. Perform the connection test to verify the connection to the warehouse database.
8. Optionally change the default name in the Net Service Name field.
This is the TNS Service Name. The default name matches the name that you entered in Step 4. You
can change this to a different name. The TNS Service Name can be considered a local alias for the
remote Tivoli Data Warehouse name.
9. When prompted to configure another net service name, click No to return to the Welcome window.
10. Click Finish.
Configuring an ODBC data source for an Oracle data warehouse

An Oracle client on Windows requires an ODBC connection to the data warehouse. For the Warehouse
Proxy agent, you must configure the ODBC connection manually.
Note: This procedure uses default values for the data source name (ITM Warehouse) and warehouse user
ID (ITMUser). (Default values are used in configuration procedures for warehousing components.)
Substitute different values if you do not want to use the default values.
1. On the computer where the Warehouse Proxy agent is installed, open the Control Panel.
4. Select the Oracle ODBC driver:
5.
6.
7.
8.
9.
10.
v For Oracle 9, the ODBC driver name is Oracle in Ora9ias_home.

v For Oracle 10, the ODBC driver name is Oracle in OraDb10g_home1.
Enter ITM Warehouse in the Data Source Name field.
Enter the TNS Service Name in the TNS Service Name field. This is the name that you specified in
Step 8 (for example, WAREHOUS).
Enter ITMUser in the User ID field.
Click Test Connection.
In the Oracle ODBC Driver Connect window, enter the TNS Service Name, and the user ID and
password of the warehouse user.
Click OK on the Connection successful message.
423

Use this procedure to configure a Warehouse Proxy agent on Windows to connect to an Oracle Tivoli Data
Warehouse:
configuration:
for the connection between the Warehouse Proxy agent and the hub monitoring server. Click OK on
each window to accept the settings.
4. Select Oracle from the list of databases (see Figure 52 on page 362) and click OK.
424
Figure 82. Configure Oracle Data Source for Warehouse Proxy window
then click OK. The fields on this window are described in Table 97.
Note: The values for the data source name, database name, and database user ID and password
must match the values that you used when configuring an ODBC connection for the Warehouse
Proxy agent. (See Configuring an ODBC data source for an Oracle data warehouse on page
423.)
Table 97. Configuration information for the Tivoli Data Warehouse database on Oracle
Field
Default value
Description
Data Source Name
ITM Warehouse
Database User ID
ITMUser
Database Password
itmpswd1

425
Table 97. Configuration information for the Tivoli Data Warehouse database on Oracle (continued)
Field
Default value
Description
Reenter Password
itmpswd1
6. Click OK.

connection)
Use this procedure to configure a Warehouse Proxy agent on Linux or UNIX to connect to an Oracle data
warehouse:
1. Log on to the computer where the Warehouse Proxy agent is installed.
agent and the hub monitoring server.
then the application agents cannot communicate with the proxy when they to create a route to it.
426
5. In the Database drop-down list, select Oracle.

6. Add the name and directory location of the JDBC driver JAR file to the JDBC Drivers list box:
b. Click Add to display the file browser window. Navigate to the location of the JDBC driver JAR file
on this computer and select the file. The Oracle JDBC driver JAR file name and default location
after downloading from the Web are as follows:
c. Click OK to close the browser window and add the driver file to the list.
7. Change the default value displayed in the Warehouse URL field if it is not correct. The default Tivoli
Data Warehouse URL for Oracle is as follows:
the actual name. (See Creating the warehouse database on Oracle on page 419.)
Warehouse Driver field displays the driver name, in contrast to the driver JAR file that is listed in the
The Oracle JDBC Type 4 driver name is as follows:
427
the user name and password that were created for the Tivoli Data Warehouse. (See Creating the
warehouse database on Oracle on page 419.) The default user name is itmuser and the default
password is itmpswd1.
database.
Starting the Warehouse Proxy

428

Table 98. Tasks for configuring communications between the portal server and an Oracle data warehouse
Task
Procedure
Refer to the Oracle documentation for

instructions on how to install an Oracle
client.
Install an Oracle database client on the portal server.

Creating a TNS Service Name on page

422
Create a TNS (Transparent Network Substrate) Service Name on the

portal server.
(Portal server on Linux or AIX only)
Obtain the Oracle JDBC Type 4 Driver

from the following Web site:
Install an Oracle JDBC Type 4 driver on the portal server.

follows:
The configuration procedure on Windows automatically configures an
ODBC connection to the data warehouse.
For a portal server on Windows, see

Configuring a Windows portal server
(ODBC connection).
For a portal server on Linux or AIX, see
Configuring a Linux or AIX portal server
(JDBC connection) on page 431.
Configuring a Windows portal server (ODBC connection)

Use this procedure to configure a portal server on Windows to connect to an Oracle Tivoli Data
Warehouse:
429
4. Select Oracle from the list of databases and click OK.

Figure 85. Configure Oracle Data Source for Warehouse window
then click OK. The fields on this window are described in the following table:
Table 99. Configuration information for the Tivoli Data Warehouse database on Oracle
Field
Default value
Description
Data Source Name
ITM Warehouse
Database User ID
ITMUser
Database Password
itmpswd1

Reenter Password
itmpswd1
430
6. Click OK.
Configuring a Linux or AIX portal server (JDBC connection)

Use this procedure to configure a portal server on Linux or AIX to connect to an Oracle Tivoli Data
Warehouse on any operating system:
1. Log on to the computer where the Tivoli Enterprise Portal Server is installed and begin the
configuration.
b. Right-click Tivoli Enterprise Portal Server and click Configure.
2. On the TEMS Connection tab, review the settings for the connection between the portal server and
the hub monitoring server. These settings were specified when the portal server was installed.
4. Select the Oracle radio button.
The fields for configuring the connection to an Oracle data warehouse are displayed at the bottom of
the window.
Figure 86. Configuring the connection to an Oracle data warehouse
5. Fill in the fields in Figure 86 with the configuration values described in Table 100.
Table 100. Configuration information for a Tivoli Data Warehouse database on Oracle
Field
Default value
Warehouse database WAREHOUS

name
Description
The name of the Tivoli Data Warehouse database.
431
Table 100. Configuration information for a Tivoli Data Warehouse database on Oracle (continued)
Field
Default value
Description
Warehouse DB user
ID
ITMUser
The database login user that the portal server uses

to access the Tivoli Data Warehouse database. This
user is referred to as the warehouse user.
Warehouse user
password
itmpswd1
The password for the warehouse user.
Re-type Warehouse
user password
itmpswd1
The password for the warehouse user.
JDBC driver class

path
ojdbc14.jar
The full path name of the Oracle JDBC Type 4

driver JAR file on this computer.
JDBC driver name
The Oracle JDBC Type 4 driver name.
JDBC driver URL
jdbc:oracle:thin:@localhost:
1521:WAREHOUS
The Oracle-defined URL that identifies the Oracle

instance used for the remote Tivoli Data
Warehouse.
Replace localhost with the host name of the
remote computer where the Tivoli Data Warehouse
is installed.
Change the default port number (1521) and Tivoli
Data Warehouse name (WAREHOUS) if they are
different.
User-defined
attributes
(no default)
Enter any user-defined attributes that are used to

customize the behavior of the driver connection.
Use semi-colons (;) to delimit the attributes.

v To start the portal server from the Manage Tivoli Enterprise Monitoring Services window, right-click
Tivoli Enterprise Portal Server and select Start.
v (Linux or AIX only) To start the portal server from the command line, run the following command from
the bin directory of the IBM Tivoli Monitoring installation directory. The default installation directory is
/opt/IBM/ITM.
432

and Pruning agent
Task
Procedure

procedures.

starting the agent.
Install an Oracle Type 4 JDBC driver on the computer where the

Summarization and Pruning agent is installed.
Obtain the Oracle JDBC Driver from the

following Web site:
follows:
ojdbc14.jar


433
Task
Procedure

Portal.
434

agent on page 444
Chapter 20. Tivoli Data Warehouse solutions: common

procedures
This chapter contains information and procedures for Tivoli Data Warehouse solutions that use any of the
supported database platforms: IBM DB2 for the workstation, Microsoft SQL Server, and Oracle. Read the
chapter pertaining to the database platform you are using for the Tivoli Data Warehouse before performing
any of these procedures.
v Configuring the Summarization and Pruning agent (JDBC connection)
v Starting the Summarization and Pruning agent on page 444
v
v
v
v
v
Installing and configuring multiple Warehouse Proxy agents on page 445

Running the warehouse agents autonomously on page 448
Testing the connection between the portal server and the Tivoli Data Warehouse on page 453
Tuning the performance of the Warehouse Proxy on page 456
WAREHOUSELOG and WAREHOUSEAGGREGLOG tables on page 458
Configuring the Summarization and Pruning agent (JDBC connection)

Use this procedure to configure the Summarization and Pruning agent to connect to a Tivoli Data
Warehouse database created on any of the supported database platforms and operating systems.
Before you begin

The JDBC driver JAR files for your database platform must be located on the computer where you
installed the Summarization and Pruning agent. Use a Type 4 JDBC driver. Do not use the Type 2 driver.
v If you are using DB2 for the workstation for your Tivoli Data Warehouse database, the JDBC driver files
are included with the database platform installation. If the warehouse database and the Summarization
and Pruning agent are installed on the same computer, the JDBC driver files are already present. It is
not necessary to move them from their current location. If your warehouse database is located on a
remote computer, copy the driver files to the local computer (the computer where you installed the
Summarization and Pruning agent). Copy the files to any directory to which the user the Summarization
and Pruning agent is running as has access to.
v If you are using Oracle or Microsoft SQL Server for your Tivoli Data Warehouse database, download the
driver file from the company Web site to the computer where you installed the Summarization and
Pruning agent. Download the files to any directory to which the user the Summarization and Pruning
agent is running as has access to.
Table 102 shows where to obtain the driver files for each database platform.
Table 102. Where to obtain the JDBC driver files for the Summarization and Pruning agent
Database platform
JDBC driver files
IBM DB2 for the

workstation
Use the DB2 for the workstation JDBC Universal Driver (Type 4 driver). The DB2 for the
workstation driver files are located with your Tivoli Data Warehouse server installation. The
Type 4 driver file names and locations are as follows:
db2installdir/java/db2jcc.jar
db2installdir/java/db2jcc_license_cu.jar
where db2installdir is the directory where DB2 for the workstation was installed. The default
DB2 for the workstation Version 9 installation directory is as follows:
v On Windows: C:\Program Files\IBM\SQLLIB
v On AIX: /usr/opt/db2_09_01
v On Linux and Solaris: /opt/IBM/db2/V9.1
435
Table 102. Where to obtain the JDBC driver files for the Summarization and Pruning agent (continued)
Database platform
JDBC driver files
Microsoft SQL Server Use the Microsoft SQL Server 2005 Type 4 driver to connect to a Tivoli Data Warehouse on
either SQL Server 2000 or SQL Server 2005. (The SQL Server 2005 JDBC Driver works with
a Tivoli Data Warehouse on SQL Server 2000.) Obtain the 2005 JDBC driver from the
http://msdn.microsoft.com/data/jdbc/default.aspx
Download and install the driver to the computer where you installed the Summarization and
Pruning agent. Follow the instructions on the Microsoft download page for installing the driver.
The SQL Server 2005 JAR file name and location after installation is as follows:
mssql2005installdir/sqljdbc_1.1/enu/sqljdbc.jar
Oracle
Obtain the Oracle JDBC Type 4 driver from the following Web site:
http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html
The Oracle JDBC driver JAR file name and location after installation is as follows:
The ojdbc14.jar file supports JRE 1.5 or higher, the required Java Runtime Environment for
IBM Tivoli Monitoring.
Procedure
Complete the following steps to configure the Summarization and Pruning agent.
Note: A Reload button is available on the configuration windows. Click Reload at any time during the
procedure to restore the original settings.
1. Log on to the computer where the Summarization and Pruning agent is installed and begin the
configuration:
a. Open the Manage Tivoli Enterprise Monitoring Services window:
v On Windows, click Start Programs IBM Tivoli Monitoring Manage Tivoli Monitoring
Services.
v On Linux or UNIX, change to the install_dir/bin directory and run the following command:
b. Right-click Summarization and Pruning Agent.
c. On Windows, click Configure Using Defaults. On Linux or UNIX, click Configure. If you are
reconfiguring, click Reconfigure.
2. Review the settings for the connection between the Summarization and Pruning agent and the hub
Tivoli Enterprise Monitoring server. These settings were specified when the Summarization and
Pruning agent was installed.
v On Windows, perform the following steps:
a. On the Warehouse Summarization and Pruning Agent: Agent Advanced Configuration window,
verify the communications protocol of the hub monitoring server in the Protocol drop down list.
Click OK.
b. On the next window, verify the host name and port number of the hub monitoring server. Click
OK.
For information about the different protocols available to the hub monitoring server on Windows,
and associated default values, see 12e on page 150.
v On Linux or UNIX, verify the following information on the TEMS Connection tab:
436
The hostname of the hub monitoring server in the TEMS Hostname field. (If the field is not
active, clear the No TEMS check box.)
The communications protocol that the hub monitoring server uses in the Protocol drop down
list.
- If you select IP.UDP, IP.PIPE, or IP.SPIPE, enter the port number of the monitoring server in
the Port Number field.
- If you select SNA, enter information in the Net Name, LU Name, and LOG Mode fields.
For information about the different protocols available to the hub monitoring server on Linux or
UNIX, and associated default values, seeTable 30 on page 154.
3. When you are finished verifying or entering information about the hub monitoring server:
v On Windows, click Yes on the message asking if you want to configure the Summarization and
Pruning agent.
v On Linux or UNIX, click the Agent Parameters tab.
A multi-tabbed configuration window is displayed with the Sources tab at the front.
Figure 87 shows the configuration window for a Summarization and Pruning agent on Windows
(values displayed are for a DB2 for the workstation warehouse database). The configuration window
for a Summarization and Pruning agent on Linux or UNIX is similar.
Figure 87. Sources tab of Configure Summarization and Pruning Agent window
Chapter 20. Tivoli Data Warehouse solutions: common procedures
437
4. Add the names and directory locations of the JDBC driver JAR files to the JDBC Drivers list box:
a. On Linux or UNIX, use the scroll bar at the bottom of the window to display the Add and Delete
buttons, which are located to the right of the JDBC Drivers list box.
b. Click Add to display the file browser window. Navigate to the location of the driver files on this
computer and select the Type 4 driver files for your database platform. See Table 102 on page
435 for the names and default locations of the driver files to add.
c. Click OK to close the browser window and add the JDBC driver files to the list.
5. In the Database field, select the database platform you are using for the Tivoli Data Warehouse from
the drop-down list: DB2, SQL Server, or Oracle.
The default values for the database platform you selected are displayed in the other text fields on the
Sources tab.
6. Change the default value displayed in the Warehouse URL field if it is not correct. The following table
lists the default Tivoli Data Warehouse URLs for the different database platforms:
Table 103. Tivoli Data Warehouse URLs
Database platform
Warehouse URL
IBM DB2 for the

workstation
jdbc:db2://localhost:60000/WAREHOUS
Oracle
Microsoft SQL Server jdbc:sqlserver://localhost:1433;databaseName=WAREHOUS

2000 or SQL Server
2005
the actual name.
Warehouse Driver field displays the driver name, in contrast to the driver files that are listed in the
The following table lists the JDBC Type 4 driver names for each database platform:
Table 104. JDBC driver names
Database platform
JDBC driver name
IBM DB2 for the

workstation
com.ibm.db2.jcc.DB2Driver
Oracle
Microsoft SQL Server com.microsoft.sqlserver.jdbc.SQLServerDriver

Note: This is the name of the 2005 SQL Driver. Do not use the SQL Server 2000 JDBC
driver, even if the Tivoli Data Warehouse was created in Microsoft SQL 2000. (The name of
the 2000 SQL driver was com.microsoft.jdbc.sqlserver.SQLServerDriver. Note the reversal of
the string jdbc.sqlserver.)
the user name and password that were created for the Tivoli Data Warehouse. The default user name
is itmuser and the default password is itmpswd1.
9. In the TEP Server Host and TEP Server Port fields, enter the host name of the computer where the
Tivoli Enterprise Portal Server is installed and the port number that it uses to communicate with the
438
Note: The default Tivoli Enterprise Portal Server interface port of 15001 is also used after the
Summarization and Pruning agent's initial connection to the portal server over port 1920. Any
firewalls between the two need to allow communications on either 15001 or whichever port is
defined for any new Tivoli Enterprise Portal Server interface used per the instructions in
Defining a Tivoli Enterprise Portal Server interface on Windows on page 286.
database.
11. Select the Scheduling tab to specify when you want summarization and pruning to take place. You
can schedule it to run on a fixed schedule or on a flexible schedule:
Figure 88. Scheduling tab of Configure Summarization and Pruning Agent window
v Fixed
Schedule the Summarization and Pruning agent to run every x days.
Select the time of the day that you want the agent to run.
Set the time to at least 5 minutes from the current time if you want it to run right away.
v Flexible
Schedule the Summarization and Pruning agent to run every x minutes.
Optionally, specify the times when the agent should not run, using the format HH:MM-HH:MM.
Press Add to add the text. For example, to block the agent from running between 00:00 and
01:59 and between 04:00 and 04:59, type 00:00-01:59, click Add, type 04:00-04:59 and click
Add. Do not use the Add button unless you are adding a blackout period. All values must be
between 00:00 and 23:59 and the end time must be greater than start time.
439
Note: If you select Fixed, the Summarization and Pruning agent does not immediately perform any
summarization or pruning when it starts. It performs summarization and pruning when it runs. It
runs according to the schedule you specify on the Scheduling tab. If you select Flexible, the
Summarization and Pruning agent runs once immediately after it is started and then at the
interval you specified except during any blackout times.
12. Specify shift and vacation settings in the Work Days tab:
Figure 89. Work Days tab of Summarization and Pruning Agent configuration window
When you enable and configure shifts, IBM Tivoli Monitoring produces three separate summarization
reports:
v Summarization for peak shift hours
v Summarization for off-peak shift hours
v Summarization for all hours (peak and off-peak)
Similarly, when you enable and configure vacations, IBM Tivoli Monitoring produces three separate
summarization reports:
v Summarization for vacation days
v Summarization for nonvacation days
v Summarization for all days (vacation and nonvacation)
Complete the following steps to enable shifts, vacations, or both:
v Select when the beginning of the week starts.
v To configure shifts:
a. Select Specify shifts to enable shifts.
440
b. Optionally change the default settings for peak and off peak hours by selecting and moving
hours between the Peak Shift Hours box and the Off Peak Shift Hours box using the arrow
buttons.
Note: Changing the shift information after data has been summarized creates an inconsistency
in the data. Data that was previously collected is not summarized again to account for
the new shift values.
v To configure vacation settings:
a. Select Specify vacation days to enable vacation days.
b. Select Yes in the drop down list if you want to specify weekends as vacation days.
c. Select Add to add vacation days.
d. Select the vacation days you want to add from the calendar.
On UNIX or Linux, right-click, instead of left-click, to select the month and year.
The days you select are displayed in the list box.
If you want to delete any days you have previously chosen, select them and click Delete.
Notes:
1) Add vacation days in the future. Adding vacation days in the past creates an inconsistency
in the data. Data that was previously collected is not summarized again to account for
vacation days.
2) Enabling shifts or vacation periods can significantly increase the size of the warehouse
database. It will also negatively affect the performance of the Summarization and Pruning
Agent.
13. Select the Log Parameters tab to set the intervals for log pruning:
441
Figure 90. Log Parameters tab of Summarization and Pruning Agent configuration window
v Select Keep WAREHOUSEAGGREGLOG data for, select the unit of time (day, month or year), and
the number of units for which data should be kept.
v Select Keep WAREHOUSELOG data for, select the unit of time (day, month or year), and the
number of units for which data should be kept.
14. Specify additional summarization and pruning settings in the Additional Parameters tab:
442
Figure 91. Additional Parameters tab of Summarization and Pruning Agent configuration window
a. Specify the number of additional threads you want to use for handling summarization and pruning
processing. The number of threads should be 2 * N, where N is the number of processors running
the Summarization and Pruning agent. A higher number of threads can be used, depending on
your database configuration and hardware.
b. Specify the maximum rows that can be deleted in a single pruning transaction. Any positive
integer is valid. The default value is 1000. There is no value that indicates you want all rows
deleted.
If you increase the number of threads, you might consider increasing this value if your transaction
log allows for it. The effective number of rows deleted per transaction is based on this value
divided by the number of worker threads.
c. Indicate a time zone for historical data from the Use timezone offset from drop down list.
This field indicates which time zone to use when a user specifies a time period in a query for
monitoring data.
v Select Agent to use the time zone (or time zones) where the monitoring agents are located.
443
v Select Warehouse to use the time zone where the Summarization and Pruning agent is
located. If the Tivoli Data Warehouse and the Summarization and Pruning agent are in different
time zones, the Warehouse choice indicates the time zone of the Summarization and Pruning
agent, not the warehouse.
Skip this field if the Summarization and Pruning agent and the monitoring agents that collect data
are all in the same time zone.
d. Specify the age of the data you want summarized in the Summarize hourly data older than and
Summarize daily data older than fields. The default value is 1 for hourly data and 0 for daily
data.
e. The Maximum number of node errors to display refers to the node error table in the
Summarization and Pruning workspace. It determines the maximum number of rows that
workspace is to save and display.
f. The Maximum number of summarization and pruning runs to display refers to the
Summarization and Pruning Run table in the Summarization and Pruning workspace. It determines
the maximum number of rows that workspace is to save and display.
Maximum number of Summarization and Pruning runs to display and Maximum number of node
errors to display together determine the number of rows shown in the Summarization and Pruning
overall run table and Errors table respectively. There is a minimum value of 10 for each. These
equate to keywords KSY_SUMMARIZATION_UNITS and KSY_NODE_ERROR_UNITS in file
KSYENV/sy.ini.
g. The Database Connectivity Cache Time determines how long after a positive check for
connectivity that the result will be cached. Longer times may result in inaccurate results in the
workspace; however, it saves processing time.
Database Connectivity Cache Time records the number of minutes to cache the database
connectivity for MOSWOS reporting purposes. The minimum value is 5 minutes. This equates to
keyword KSY_CACHE_MINS in file KSYENV/sy.ini.
h. Batch mode determines if data from different managed systems are used in the same database
batch; this setting also improves performance.
Batch mode controls the batching method used by the Summarization and Pruning agent. A value
of Single Managed System (0) means that data should only be batched for the same system,
whereas a value of Multiple Managed System (1) means that data from multiple systems can be
batched together; this can lead to higher performance at potentially bigger transaction sizes. The
default value is Single Managed System (0). This equates to keyword KSY_BATCH_MODE in file
KSYENV/sy.ini.
To change these values, you can either use the Summarization and Pruning configuration window's
Additional parameters tab or update these parameters directly in file KSYENV/sy.ini.
15. Save your settings and close the window. Click Save to save your settings. On Windows, click Close
to close the configuration window.
v On Windows, click Save and then click Close.
v On Linux or UNIX, click Save and then click Cancel.
Starting the Summarization and Pruning agent

v To start the Summarization and Pruning agent from the Manage Tivoli Enterprise Monitoring Services
window, right-click Summarization and Pruning and select Start.
v (Linux or UNIX only) To start the Summarization and Pruning agent from the command line, run the
following command from the bin directory of the IBM Tivoli Monitoring installation directory. The default
installation directory is /opt/IBM/ITM.
./itmcmd agent start sy
where sy is the product code for the Summarization and Pruning agent.
444
Installing and configuring multiple Warehouse Proxy agents

IBM Tivoli Monitoring supports multiple Warehouse Proxies within a single hub monitoring server
environment. The provision for multiple warehouse proxies provides for greater scalability and performance
in historical data collection. More importantly, use multiple proxies enhance reliability via their failover
mechanism: if a Warehouse Proxy is unavailable, data can be inserted into the warehouse by a different
Warehouse Proxy agent (if the agents are configured properly for failover).
The support for multiple Warehouse Proxy agents has the following important features:
v All Warehouse Proxy agents within a single hub monitoring server environment export data to a single
Tivoli Data Warehouse.
v Each Warehouse Proxy agent is associated with a subset of monitoring server instances that you
specify when you configure the proxy agent. Each Warehouse Proxy exports data only for monitoring
agents that report to one of the monitoring servers (hub or remote) on the specified list. Alternatively, a
given Warehouse Proxy agent can be configured to service any monitoring server. This is important for
backward compatibility and for configuring failover.
The following sequence of events explains how the monitoring agents, which collect the data for historical
reports, know which Warehouse Proxy agent to use:
1. When a Warehouse Proxy agent starts, it registers with the Global Location Broker on the hub
monitoring server, sending it the list of monitoring servers that it is configured to serve, oran indication
that the Warehouse Proxy agent can service any monitoring server. This registration process is
repeated every hour.
2. Each monitoring server queries the Global Location Broker at regular intervals to determine which
Warehouse Proxy it is associated with. The monitoring server then sends the address of this
Warehouse Proxy to all of its child monitoring agents to use during historical data exports. You can
change the default query interval of 60 minutes to some other value.
When a Warehouse Proxy agent registers with the Global Location Broker, it is registered as the default
proxy agent if no other proxy agent is already configured as the default. When a monitoring server queries
the Global Location Broker for its associated Warehouse Proxy, the default proxy agent is used if that
monitoring server is not on the list of servers for any proxy agent.
Installing and configuring the proxy agents

Use the following procedure to install and configure each Warehouse Proxy agent:
1. Install each proxy agent using the following procedures:
v To install a Warehouse Proxy agent on Windows, complete the procedure Windows: Installing a
v To install a Warehouse Proxy agent on Linux or AIX, complete the procedure Linux or UNIX:
Installing a monitoring agent on page 189, including the following subsections:
Installing the monitoring agent
Configuring the monitoring agent
Changing the file permissions for agents (if you used a nonroot user to install the Warehouse
Proxy)
2. Associate each proxy agent with the list of monitoring servers that you want the proxy agent to serve:
a. Open the environment file for the proxy agent:
v (Windows) ITMinstall_dir\TMAITM6\KHDENV
v (Linux or AIX) ITMinstall_dir/config/hd.ini
where ITMinstall_dir is the directory where you installed the product.
b. Add the environment variable KHD_WAREHOUSE_TEMS_LIST to the file and set it to specify a
space- or comma-delimited list of monitoring server instance names. For example:
445
KHD_WAREHOUSE_TEMS_LIST=REMOTE_TEMS1 REMOTE_TEMS2
The name of a monitoring server is specified when the server is installed. The default name of a
monitoring server is HUB_host_name (for a hub monitoring server) or REMOTE_host_name (for a
remote monitoring server), where host_name is the short host name.
Each proxy agent will register with an annotation representing one or more monitoring server
names, indicating that it will serve all the agents reporting to those monitoring servers. The default
annotation (or the string *ANY) in the KHD_WAREHOUSE_TEMS_LIST variable indicates that a
proxy may serve as a possible failover agent. Adding the *ANY string in the monitoring server list
for the third proxy agent means that this agent will serve as a failover agent if one or more proxy
agents stop working.
When a lookup to find the address of the proxy agent is done by a monitoring agent (if data is
collected at the monitoring agent) or by the monitoring server (if data is collected at the monitoring
server), the address of the proxy agent registered with an annotation equal to the name of the
monitoring server the agents are connected to is found first, then the proxy agents registered with
a default annotation are found in the order they were registered on the hub monitoring server. If an
historical export has been redirected to a proxy agent, the historical exports will continue to be sent
to that agent as long as the connection is working. To reestablish the original configuration, stop
and restart the fall-back WHP.
The name of a particular monitoring server can be specified in the list for only one proxy agent. Do
not specify the same monitoring server name in more than one list. Do not try to do load balancing
by specifying the same monitoring server name in two different KHD_WAREHOUSE_TEMS_LIST
variables.
3. Optionally modify the interval at which a monitoring server queries the Global Location Broker to find
out which Warehouse Proxy it is associated with:
a. Open the environment file for the monitoring server:
v (Windows) ITMinstall_dir\CMS\KBBENV
v (Linux or UNIX) ITMinstall_dir/config/hostname_ms_TEMSid.config
b. Change the following entry to specify a different query interval:
KPX_WAREHOUSE_REGCHK=60
The query interval is specified in minutes. The default value is 60 minutes.

4. (Optional) Use the KDC_FAMILIES options COUNT and SKIP with all IBM Tivoli Monitoring products
running on the Warehouse Proxy agent computer.
Perform this step only to guarantee the port that Warehouse Proxy listens for firewall consideration.
Using these options guarantees that the Warehouse Proxy agent always obtains the same listening
port that was opened by the network administrator. The Warehouse Proxy agent uses the
KDC_FAMILIES COUNT option to obtain its listening port. All other nonmonitoring server processes
(agents, portal server) running on the computer with the Warehouse Proxy agent use the
KDC_FAMILIES SKIP option to bypass reserved ports.
The network administrator must open access for inbound data for the Warehouse Proxy port through
the firewall. Example:
HUB TEMS
IP.PIPE PORT:1918
(listens on port 1918)
WH Proxy Agent
IP.PIPE COUNT:1
Windows Agent
IP.PIPE SKIP:2
446
TEPServer
IP.PIPE SKIP:2
WHProxy port 6014
Open through firewall for export
TEMS port 1918
Open through firewall
5. Start the Warehouse Proxy agent:

v To start a Warehouse Proxy agent on Windows or Linux from the Manage Tivoli Enterprise
Monitoring Services window, right-click Warehouse Proxy and select Start.
v To start a Warehouse Proxy agent on Linux or AIX from the command line, enter the following
command:
Setting a permanent socket address for a proxy agent

In some network environments, use of the Global Location Broker default registration algorithm is not
supportable and a specific monitoring server variable must be used. This applies also when monitoring
agents configure their connections as ephemeral (using KDC_FAMILIES=ip.pipe use:y ephemeral:y for
instance).
KPX_WAREHOUSE_LOCATION is the variable that allows a fixed warehouse route to be delivered to
connected agents. KPX_WAREHOUSE_LOCATION is an optional list of fully qualified, semicolon delimited
network names and should be added in the monitoring server environment file located in different place
depending on the platform:
v Windows: install_dir/CMS/KBBENV
v UNIX and Linux: install_dir/config/kbbenv.ini
KPX_WAREHOUSE_LOCATION is used instead of the routing string currently derived by the monitoring
server from the Location Broker monitoring. If the variable KPX_WAREHOUSE_LOCATION is set on the
hub monitoring server, then the Warehouse Proxy agent is registered in the Global Location Broker. If the
variable is set on the remote monitoring server, then the Warehouse Proxy agent is registered in the Local
Location Broker. This variable has a maximum length of 200 bytes. The syntax is:
KPX_WAREHOUSE_LOCATION= family_protocol:network_address[port number];
Verifying the configuration

Use the following trace settings to verify the configuration:
v To verify that a Warehouse Proxy is registering with the hub monitoring server and placing the correct
entries into the Global Location Broker:
1. Open the environment file for the proxy agent:
(Windows) ITMinstall_dir\TMAITM6\KHDENV
(Linux or AIX) ITMinstall_dir/config/hd.ini
2. Add the following entry to the KBB_RAS1 trace setting:
KBB_RAS1=ERROR(UNIT:khdxrpcr STATE)
This setting prints the value of KHD_WAREHOUSE_TEMS_LIST and shows any errors associated
with its components.
v To determine which Warehouse Proxy a particular monitoring server uses for its agents:
1. Open the environment file for the monitoring server:
447
(Windows) ITMinstall_dir\CMS\KBBENV
(Linux or UNIX) ITMinstall_dir/config/hostname_ms_TEMSid
2. Add the following entry to the KBB_RAS1 trace setting:
KBB_RAS1=ERROR(UNIT:kpxrwhpx STATE)
This setting prints entries in the RAS log of the monitoring server when a registration change
occurs. The entry specifies the name and address of the new Warehouse Proxy agent that the
monitoring server is using.
Running the warehouse agents autonomously

Both the Warehouse Proxy agent and Warehouse Summarization and Pruning agent can run in
autonomous ("unmanaged") mode.
If a Warehouse Proxy agent is running in connected ("managed") mode, it makes its location available to
the monitoring servers and application monitoring agents by registering the location with the Global
Location Broker on the hub monitoring server, along with a list of monitoring servers that it supports.
Remote monitoring servers and the agents that connect to them obtain the network addresses of the proxy
agents to which they report from the hub. However, if the Warehouse Proxy agent is running in
autonomous ("unmanaged") mode, it does not register its location with the hub monitoring server; instead,
monitoring agents are configured to obtain the location of their Warehouse Proxy agents from their local
configuration file or from a central configuration server facility. This allows the Warehouse Proxy agent to
support monitoring agents that are running autonomously (that is, without a connection to a monitoring
server).
If the Summarization and Pruning agent is running in connected mode, it obtains the information it needs
about the collected historical data from the Tivoli Enterprise Portal Server. If the Summarization and
Pruning agent is configured to run in autonomous mode, it obtains the information about attribute data
directly from attribute support files for the monitoring agents, and the summarization and pruning settings
from the WAREHOUSESUMPRUNE table in the warehouse database. The location of the application
support files is specified in the Summarization and Pruning agent configuration file (see Configuring a
Summarization and Pruning agent to run autonomously on page 449 ). See Configuring summarization
and pruning without the Tivoli Enterprise Portal Server on page 450 for more information on the
WAREHOUSESUMPRUNE table.
Configuring a Warehouse Proxy agent to run autonomously

For a Warehouse Proxy agent to run in autonomous mode, it must be configured to run without registering
its location with the hub monitoring server. Every monitoring agent that sends historical data to the
Warehouse Proxy agent must be configured with its location.
To configure the Warehouse Proxy agent to run without registering, complete the following steps:
1. Install and configure one or more Warehouse Proxy agents following the procedures in the appropriate
chapter:
v Chapter 16, Tivoli Data Warehouse solution using DB2 for the workstation, on page 349
v Chapter 18, Tivoli Data Warehouse solution using Microsoft SQL Server, on page 397
v Chapter 19, Tivoli Data Warehouse solution using Oracle, on page 415
Note: The installation procedure for Windows operating systems includes steps for configuring the
connection between the proxy agent and the hub Tivoli Enterprise Monitoring Server. On Linux
or UNIX operating systems, this step is performed in a separate configuration procedure. On
Windows operating systems, if you want to run the Warehouse Proxy agent without a
connection to the hub, accept the defaults for the connection information, but specify a nonvalid
448
name for the monitoring server. On UNIX and Linux operating systems, check No TEMS on the
TEMS Connection tab of the configuration window.
2. Add the following variable to the Warehouse Proxy agent environment file (install_dir\TMAITM6\khdenv
on Windows operating systems; install_dir/config/hd.ini on UNIX and Linux operating systems):
KHD_REGWITHGLB=N
3. Configure the Warehouse Proxy agent to use the same IP port number as you chose for the various
autonomous agents that will be sending historical data to it; see the IBM Tivoli Monitoring:
Administrator's Guide for details.
4. Restart the agent.
5. Restart the agent's Tivoli Enterprise Monitoring Server, if necessary.
If the Warehouse Proxy agent you reconfigured to run autonomously has previously connected to
either a hub monitoring server or a remote monitoring server, the agent has already registered with the
monitoring server to which it connected. To clear this registration information now that the agent is
running autonomously, recycle the monitoring server. If the monitoring server is a remote monitoring
server, also recycle the hub monitoring server to which it connects.
To configure a monitoring agent with the location of the Warehouse Proxy agent or agents to which it
should export historical data, complete the following steps:
1. Install the agent following Installing monitoring agents on page 183 or the documentation for the
agent.
2. Open the monitoring agent environment file in a text editor:
v Windows operating systems: install_dir\TMAITM6\kpcenv
v Linux and UNIX operating systems: install_dir/config/pc.ini
v z/OS operating system: &hilev.&rte.RKANPARU(KPCENV)
where pc is the two-character product code for the monitoring agent (see Appendix D, IBM Tivoli
product, platform, and component codes, on page 567).
3. Add the following variable to the file:
KHD_WAREHOUSE_LOCATION=family protocol.#network address[port number]
The value of the variable can be a semicolon-delimited list of network addresses. For example:
KHD_WAREHOUSE_LOCATION=ip.pipe:SYS2-XP[63358];ip:SYS2-XP[63358]
4. Restart the agent.
Configuring a Summarization and Pruning agent to run autonomously

For a Summarization and Pruning agent to run without connecting to a Tivoli Enterprise Portal Server, it
must be configured to run autonomously and it must be able to locate the application support files for the
monitoring agents.
To configure a Summarization and Pruning agent to run in autonomous mode, complete the following
steps:
1. If you have not already installed done so, install a Tivoli Enterprise Portal Server, and add application
support for all types of monitoring agents that will be collecting historical data.
2. Install and configure Summarization and Pruning agent following the instructions in the appropriate
chapter:
v Chapter 16, Tivoli Data Warehouse solution using DB2 for the workstation, on page 349
v Chapter 18, Tivoli Data Warehouse solution using Microsoft SQL Server, on page 397
v Chapter 19, Tivoli Data Warehouse solution using Oracle, on page 415
3. If the Summarization and Pruning agent is not installed on the same machine as the portal server,
copy the required application support files to the same machine.
449
These files are named dockpc, where pc is the two-letter product code for the monitoring agent (see
Appendix D, IBM Tivoli product, platform, and component codes, on page 567). For Universal Agent
attributes, the file is named cccodicc.
On Windows operating systems, the files are located in install_dir\cnps directory; on Linux and
UNIX operating systems, the files are located in the installdir/arch/cq/data directory.
By default, the Summarization and Pruning agent looks for the application support files in the
install_dir\TMAINT6\data directory (on Windows) or the install_dir/config/data directory (on UNIX
and Linux). If you do not create this directory and copy the files to it, you must add the
KSY_AUTONOMOUS_ODI_DIR variable to the Summarization and Pruning agent environment file and
specify the alternative location.
Note: There is no need to copy the dockcj file; it is not used when reconfiguring the Summarization
and Pruning agent. If you do copy this file, the following error will occur and can be ignored.
Validation failed: Column name exceeds 10 characters: ACKNOWLEDGED.
ODI File contents not loaded: /install_dir/dockcj
4. On the machine where the Summarization and Pruning agent is installed, open its environment file in a
text editor:
v Windows operating systems: install_dir\cnps\KSYENV
v Linux and UNIX operating systems: install_dir/config/data/sy.ini
5. Edit the following variables:
v To enable the Summarization and Pruning agent to run without connecting to the Tivoli Enterprise
Portal Server, set KSY_AUTONOMOUS=YES.
v If you did not install the application support files in the default directory (see step 3), set
KSY_AUTONOMOUS_ODI_DIR=alternative location of application support files.
6. Restart the Summarization and Pruning agent agent. The WAREHOUSESUMPRUNE table is
automatically created when the Summarization and Pruning agent is started.
7. If you are upgrading from a previous version and already have summarization and pruning settings
stored in the Tivoli Enterprise Portal Server database, restart the Tivoli Enterprise Portal Server.
The first time the portal server is started after the WAREHOUSESUMPRUNE table has been created,
any previously existing data collection and summarization and pruning configuration settings are
migrated to the WAREHOUSESUMPRUNE table in the warehouse data base. Subsequently, any
settings configured using the portal server are stored directly in the warehouse.
Configuring summarization and pruning without the Tivoli Enterprise Portal Server
You can configure historical data collection and summarization and pruning using the Tivoli Enterprise
Portal , or you can configure them directly in the warehouse database WAREHOUSESUMPRUNE table
using SQL commands.
Table 105 contains descriptions of the columns in the WAREHOUSESUMPRUNE table. Insert one row for
each attribute group for which you want to collect historical data, along with the values for any
summarization and pruning settings. You do not need to set defaults for unused options; they are built into
the table design. Varchar values must be enclosed in single quotes (' ')
Table 105. Descriptions of the columns in the WAREHOUSESUMPRUNE control settings table
Name
Type
Description
TABNAME
VARCHAR (40)
NOT NULL PRIMARY
KEY
The short table name. In the application support file, this is the
value of TABLE. Review the application support file associated
with each agent for the TABLE names.
YEARSUM
VARCHAR (8)
DEFAULT -16823
Yearly Summarization on (-16822); off (-16823)
QUARTSUM
VARCHAR (8)
DEFAULT -16823
Quarterly Summarization on (-16822); off (-16823)
450
Table 105. Descriptions of the columns in the WAREHOUSESUMPRUNE control settings table (continued)
Name
Type
Description
MONSUM
VARCHAR (8)
DEFAULT -16823
Monthly Summarization on (-16822); off (-16823)
WEEKSUM
VARCHAR (8)
DEFAULT -16823
Weekly Summarization on (-16822); off (-16823)
DAYSUM
VARCHAR (8)
DEFAULT -16823
Hourly Summarization on (-16822); off (-16823)
HOURSUM
VARCHAR (8) DEFAULT Daily Summarization on (-16822); off (-16823)

-16823
PYEAR
VARCHAR (8)
DEFAULT -16838
Yearly Pruning on (-16837); off (-16838)
PYEARINT
SMALLINT
DEFAULT 1
Number of units (years, months, or days)
PYEARUNIT
VARCHAR (8)
DEFAULT -16834
Type of Unit. Years (-16834), Months (-16835), Days (-16836)
PQUART
VARCHAR (8)
DEFAULT -16838
Quarterly Pruning on (-16837); off (-16838)
PMON
VARCHAR (8)
DEFAULT -16838
Monthly Pruning on (-16837); off (-16838)
PMONINT
SMALLINT
DEFAULT 1
PMONUNIT
VARCHAR (8)
DEFAULT -16835
PWEEK
VARCHAR (8)
DEFAULT -16838
Weekly Pruning on (-16837); off (-16838)
PWEEKINT
SMALLINT
DEFAULT 1
Number of units (years, months or days)
PWEEKUNIT
VARCHAR (8)
DEFAULT -16835
Type of Unit. Years (-16834), Months(-16835), Days(-16836)
PDAY
VARCHAR (8)
DEFAULT -16838
Daily Pruning on (-16837); off (-16838)
PDAYINT
SMALLINT
DEFAULT 1
PDAYUNIT
VARCHAR (8)
DEFAULT -16835
PHOUR
VARCHAR (8)
DEFAULT -16838
Hourly Pruning on (-16837); off (-16838)
PHOURINT
SMALLINT
DEFAULT 1
PHOURUNIT
VARCHAR (8)
DEFAULT -16836
PRAW
VARCHAR (8)
DEFAULT -16838
Detailed Pruning on (-16837); off (-16838)
PRAWINT
SMALLINT
DEFAULT 1
PRAWUNIT
VARCHAR (8)
DEFAULT -16836
451
Examples: Following are examples of basic collection and summarization and pruning configuration.
Configuration and daily/hourly summarization
Collection is configured, and daily and hourly summarizations are set. No pruning has been
specified. Use the SQL INSERT command.
Required:
v TABNAME= Table Code
v DAYSUM= -16822 (summarize daily)
v HOURSUM=-16822 (summarize hourly)
INSERT INTO WAREHOUSESUMPRUNE (TABNAME,DAYSUM,HOURSUM) VALUES ('WTMEMORY','-16822','-16822');
Configuration, daily/hourly summarization, and daily/hourly pruning

Collection is configured, and daily and hourly summarizations are set. Pruning is specified for daily
3-month intervals and hourly 2-day intervals. Use the SQL INSERT command.
Required:
v TABNAME=Table Code
v DAYSUM=-16822 (summarize daily)
v HOURSUM= -16822 (summarize hourly on)
v PDAY= -16837 (prune daily)
v PDAYINT=3 (prune interval)
v
v
v
v
v
v
PDAYUNIT= -16835 (prune monthly)

PHOUR = -16837 (prune hourly on)
PHOURINT= 2 (prune interval)
PHOURUNIT= -16836 (prune daily)
PRAW = -16837 (prune detailed on)
PRAWINT= 1 (prune interval)
v PRAWUNIT= -16836 (prune daily)

INSERT INTO WAREHOUSESUMPRUNE
(TABNAME,DAYSUM,HOURSUM,PDAY,PDAYINT,PDAYUNIT,PHOUR,PHOURINT,PHOURUNIT,PRAW,PRAWINT,PRAWUNIT)
VALUES ('WTMEMORY','-16822','-16822','-16837',3,'-16835',2,'-16836','-16837',1,'-16836');
Remove daily summarization and pruning

In this example, collection has been configured, and daily and hourly summarizations have been
set. You want to remove daily summarization and pruning. Use the SQL UPDATE command.
Required:
v TABNAME= Table Code
v
v
v
v
DAYSUM= -16823 (summarize off)

PDAY= -16838 (prune daily off)
PDAYINT= 1 (prune interval to default)
PDAYUNIT= -16836 (prune daily)
UPDATE WAREHOUSESUMPRUNE SET DAYSUM='-16823', SET PDAY='-16838', SET PDAYINT=1,

SET PDAYUNIT='-16836' WHERE TABNAME='WTMEMORY';
Remove collection entirely

Collection has been configured, and daily and hourly summarizations have been set. Set the
collection to unconfigured by removing the entire row from the table, using the SQL DELETE
command.
Required: TABNAME= Table Code
DELETE FROM WAREHOUSESUMPRUNE WHERE TABNAME='WTMEMORY';
452
Testing the connection between the portal server and the Tivoli Data
Warehouse
To test the connection between the Tivoli Enterprise Portal Server and the Tivoli Data Warehouse
database, use the Tivoli Enterprise Portal to create a custom SQL query to the warehouse database and
display the results. The procedure described in this section creates an SQL query to the
WAREHOUSELOG table, a status table that is created in the warehouse database when the Warehouse
Proxy agent starts. See WAREHOUSELOG and WAREHOUSEAGGREGLOG tables on page 458 for a
description of this table.
Before you begin, make sure that the following components are installed and started:
v The Tivoli Enterprise Portal Server
v The Warehouse Proxy agent
v The Tivoli Data Warehouse RDBMS server
The test procedure consists of the following steps:
1. Create a custom SQL query to the WAREHOUSELOG table.
2. Create a new workspace to display the results.
3. Assign the query to the workspace.
1. Create the query

1. Start the Tivoli Enterprise Portal using the desktop or browser client. See Starting the Tivoli Enterprise
Portal client on page 232 for instructions.
Log in as the system administrator. (The default system administrator ID is sysadmin.)
2. Click
Query Editor on the Tivoli Enterprise Portal tool bar.
Create New Query.

3. In the Query Editor window, click
The Create Query window is displayed.
453
Figure 92. Create Query window
4. Enter a name and description for the query. For this test, enter WAREHOUSELOG for the query name.
5. From the Category drop-down list, select the folder where you want the WAREHOUSELOG query to
appear in the Query tree.
For example, select a folder name that corresponds to the operating system (Windows OS or UNIX
OS) where the Tivoli Data Warehouse is installed.
6. Select the name of the data source for the Tivoli Data Warehouse in the Data Sources list.
7. Click OK.
The WAREHOUSELOG query appears in the Query tree in the Custom_SQL folder under the category
that you selected. The Specification tab opens with a Custom SQL text box for you to enter an SQL
command.
8. Enter the following SQL statement in the Custom SQL text box to select all columns of the
WAREHOUSELOG table:
select * from WAREHOUSELOG
9. Click OK to save the query and close the Query Editor window.
2. Create a workspace
1.
2.
3.
4.
If the Enterprise Status workspace is not open, click the

Select Save Workspace As from the File menu.
Enter the name WAREHOUSELOG for the new workspace.
Click OK.
454
Enterprise Navigator item.
You now have a duplicate of the Enterprise Status workspace named WAREHOUSELOG that you can
modify.
3. Assign the query to the workspace

1. In the WAREHOUSELOG workspace, click
Table on the tool bar, release the mouse button; then
click inside one of the workspace views (for example, the Situation Event Console view).
2. Click Yes on the message asking if you want to assign the query now.
Click here to assign query.
3. In the Query tab, select
The Query editor opens with a list of all product queries.
4. In the list of queries, expand the category folder you specified when you created the query (for
example Windows OS or UNIX OS), and then expand the Custom_SQL folder.
5. Select WAREHOUSELOG from the list of queries in the Custom_SQL folder.
The query definition opens in the right frame.
Figure 93. Assigning the WAREHOUSELOG query to a workspace
6. Click OK to select the WAREHOUSELOG query for the table and close the Query editor.
7. Click OK to close the Properties editor.
The columns of the WAREHOUSELOG table are displayed within the table view in the
WAREHOUSELOG workspace. The content of the table is also displayed if the table is not empty.
455
Tuning the performance of the Warehouse Proxy

You can set the following environment variables to control the way that the Warehouse Proxy works:
v Database initialization
v Work queue
v Connection pool on page 457
v RPC threads and export requests on page 457
v Timeout values on page 457
You can set that these variables in the KHDENV file.
Database initialization
When the Warehouse Proxy starts, the following tests are done:
v Checks that the Warehouse Proxy can connect to the database.
v If the database is Oracle or DB2 for the workstation, checks that the encoding is set to UTF8.
v If the database is DB2 for the workstation, checks that a bufferpool of page size 8KB is created. If it is
not, one is created, along with three new tablespaces that use the 8KB bufferpool. The bufferpool is
called "ITMBUF8K" and the tablespaces are named "ITMREG8K," "ITMSYS8K," and "ITMBUF8K."
v Creates a database cache that contains a list of all the tables and columns that exist in the database.
If any of these tests fail, a message is written to the log file and messages are displayed in the Event
Viewer.
These tests are repeated every 10 minutes.
You can change this default start up behavior by changing the following environment variables:
KHD_CNX_WAIT_ENABLE
Enables the Warehouse Proxy to wait in between attempts to connect to the database. By default,
this variable is set to Y. If you do not want the Warehouse Proxy to wait, change the variable to N.
However, this can generate a large log file if the connection to the database fails with each
attempt.
KHD_CNX_WAIT
Defines the amount of time, in minutes, that the Warehouse Proxy waits between attempts to
connect to the database. The default value is 10 minutes.
Work queue
The work queue consists of a single queue instance and a configurable number of worker threads that run
work placed on it. There are two primary configuration parameters that you can set. You can set these
parameters in the KHDENV file on Windows or the hd.ini file on Linux and UNIX before starting the
Warehouse Proxy.
KHD_QUEUE_LENGTH
The length of the KHD work queue. This is an integer that identifies the maximum number of
export work requests that can be placed on the work queue before the work queue begins
rejecting requests. The default value is 1000. Setting this value to 0 means that the work queue
has no limit.
KHD_EXPORT_THREADS
The number of worker threads exporting data to the database. The default value is 10.
456
Connection pool
The Warehouse Proxy uses several pre-initialized ODBC connections to access the target database. The
use of these ODBC connection objects is synchronized through a single connection pool. The connection
pool is initialized when the Warehouse Proxy starts.
You can configure the number of connections in the pool by defining the following environment variable in
the KHDENV file on Windows or the hd.ini file on Linux and UNIX:
v KHD_CNX_POOL_SIZE: The total number of pre-initialized ODBC connection objects available to the
work queue export threads. The default value is 10.
All export worker threads request connections from the connection pool and must obtain a connection
before the work of exporting data can continue.
You only see the connections established when a request is active. It is important to set the number of
worker threads to greater or equal to the number of ODBC connections. To do this, set
KHD_KHD_EXPORT_THREADS >= KHD_CNX_POOL_SIZE.
RPC threads and export requests

In addition to the configurable environment variables discussed previously, the standard agent framework
provides some control over the scalability and performance profile for the Warehouse Proxy. When the
Warehouse Proxy starts, it initializes RPC and registers a group of function pointers that respond to
incoming RPC calls.
Use the CTIRA_NCSLISTEN variable to set the number of RPC threads.
Timeout values
You can set two environment variables to control the timeout value. One variable is set on the application
agent, the other on the Warehouse Proxy.
KHD_STATUSTIMEOUT
The time, in seconds, to wait for a status from the Warehouse Proxy before sending an export
request again. The default value is 900 seconds, or 15 minutes.
KHD_SRV_STATUSTIMEOUT
The timeout value, in seconds, for the work queue to perform work. The default value is 600
seconds, or 10 minutes.
Export requests are rejected by the Warehouse Proxy are the following four reasons:
v The time between when an export request is sent to the work queue and when it is extracted from the
queue exceeds the timeout. If you have tracing for the Warehouse Proxy set to ERROR, an error similar
to the following is logged in the Warehouse Proxy log file:
REJECTED: The export for the originnode OriginNodeName, the application
applicationName and the table tableName has been rejected for timeout
reason in stage END_QUEUE.
v The time between when an export request is sent to the work queue and when the work queue starts to
do existence checking in the database exceeds the timeout. If you have tracing for the Warehouse
Proxy set to ERROR, an error similar to the following is logged in the Warehouse Proxy log file and the
WAREHOUSELOG table:
Sample data rejected for timeout reason at stage START EXPORT
v The time between when an export request is sent to the work queue and when the work queue fetches
all the rows in the sample exceeds the timeout. If you have tracing for the Warehouse Proxy set to
ERROR, a message similar to the following is logged in the Warehouse Proxy log file and the
WAREHOUSELOG table:
Sample data rejected for timeout reason at stage START SAMPLE
457
v The time between when an export request is sent to the work queue and when the work queue commits
the rows in the database exceeds the timeout. If you have tracing for the Warehouse Proxy set to
ERROR, a message similar to the following is logged in the Warehouse Proxy log file and the
WAREHOUSELOG table:
Sample data rejected for timeout reason at stage COMMIT
The KHD_SRV_STATUSTIMEOUT variable should be set less than KHD_STATUSTIMEOUT by at least 60

seconds. Do not change these values unless there is a problem in the environment.
WAREHOUSELOG and WAREHOUSEAGGREGLOG tables

The WAREHOUSELOG table lets you know how many exports succeed and how many failed because of
an ODBC error or a timeout value issue.
The WAREHOUSELOG table has the following columns. All times are the local time on the machine where
the Warehouse Proxy instance is running.
ORIGINNODE
The name of the computer that made the request. This name is the node name for the agent. For
example, Primary::box1:NT.
OBJECT
The attribute group that submitted the request. For example, NT_System.
STARTQUEUE
The time when the request was inserted in the work queue. For example, 10508201154000000.
ENDQUEUE
The time when the request exited the work queue. For example, 10508201155000000.
STARTEXPORT
The amount of time that elapsed before the first row of the sample request was retrieved. For
example, 105082011562000000.
EXPORTTIME
The amount of time after the export request transaction was committed. For example,
10508201157000000.
ROWSINSERTED
The number of row inserted in the database for the request. For example, 1000.
ROWSRECEIVED
The number of rows retrieved from the RPC source. For example, 1000.
ROWSSKIPPED
This column is not used.
STARTTIME
The start time of the collection for that sample. For example, 10508150920000000.
ENDTIME
The end time of the collection for that sample. For example, 1050815092000000.
ERRORMSG
An error message when no rows are inserted in the database. The error message can indicate an
ODBC error or a TIMEOUT error. For example:
Sample data rejected for timeout reason at stage COMMIT EXPORT
WPSYSNAME
The name of the Warehouse Proxy Agent that inserted the rows into the database.
458
The WAREHOUSEAGGREGLOG table logs the progress of the Summarization and Pruning agent as it is
processing data. Each time the Summarization and Pruning agent executes, it adds an entry for each
attribute group (OBJECT column) and origin node (ORIGINNODE column) that was processed. The
WAREHOUSEAGGREGLOG table contains the following columns:
ORIGINNODE
The name of the computer that is being summarized. This name is the node name for the agent.
For example, Primary::box1:NT. OBJECT
The attribute group that was processed.
LOGTMZDIFF
The time zone difference for the Summarization and Pruning agent.
MINWRITETIME
The minimum WRITETIME value that was read from the sample data for the specified
ORIGINNODE and OBJECT.
MAXWRITETIME
The maximum WRITETIME value that was read from the sample data for the specified
ORIGINNODE and OBJECT
STARTTIME
The time that the Summarization and Pruning agent processing began for the specified
ENDTIME
The time that the Summarization and Pruning agent processing ended for the specified
ROWSREAD
The number of sample data rows read for the specified ORIGINNODE and OBJECT in the time
interval MINWRITETIME and MAXWRITETIME.
459
460
Part 6. Integrating event management systems

If you are using either Tivoli Enterprise Console or Netcool/OMNIbus in addition to IBM Tivoli Monitoring to
manage events in your enterprise, you can integrate and manage events from a single console. You can
integrate event management by forwarding events reported by Tivoli Enterprise Monitoring Agents to either
event system for correlation and managementchanges in event status made on the event system are
reflected back to the hub monitoring server that forwarded them. Or you can enable events reported by a
Tivoli Enterprise Monitoring Agent to be passed directly to OMNIbus for processing, thereby bypassing the
monitoring server entirely.
To enable forwarding of situation events, the Tivoli Enterprise Console or Netcool/OMNIbus server (the
event server) must be configured to receive the events, a situation update forwarding process must be
installed on the event server, situation forwarding must be enabled on either the hub monitoring server or
the monitoring agent, and a default event integration facility (EIF) destination must be defined.
Using the Tivoli Enterprise Portal, you can define monitoring specifications, called situations, to detect the
occurrence of specific conditions on managed systems. When conditions that match the specifications are
detected by monitoring agents, events are reported to the monitoring servers. In environments where IBM
Tivoli Enterprise Console or Netcool/OMNIbus are also being used for event management, hub Tivoli
Enterprise Monitoring Servers or the agents themselves can be configured to forward these situation
events to either of these event servers for further correlation and management. Changes in the status of
events made on the event server are reported back to the forwarding monitoring server so that events are
synchronized on the two event management systems.
The chapters in this section provide instructions for implementing event integration by forwarding situation
events to Tivoli Enterprise Console and Netcool/OMNIbus.
In addition you can view events within the Tivoli Enterprise Portal. The Common Event Console is a Tivoli
Enterprise Portal view that provides an integrated display of events from multiple event systems. The
Common Event Console presents normalized events from the supported event systems in a single table.
By default, the view displays events reported to a hub Tivoli Enterprise Monitoring Server by Tivoli
Enterprise Monitoring Agents (situation events); it can also be configured to present events from Tivoli
Enterprise Console and Netcool/OMNIbus event systems.
A common event connector (frequently called simply a connector) enables the integrated display of events
from an event system in the Common Event Console. The connector retrieves event data from a
supported event system and sends user-initiated actions to be run in that event system. To have the
events from a specific event system displayed in the Common Event Console, you must configure a
connector for that event system. Because the connector for Tivoli Enterprise Monitoring Agents is
configured when you install the portal, the Common Event Console includes all situation events by default.
However, to have Tivoli Enterprise Console or Netcool/OMNIbus events included in the Common Event
Console, you must configure a connector for each of these event systems after you install the Tivoli
Enterprise Portal. You might also want to change some of the configuration values for the default
connector. For information on configuring the display of events from Tivoli Enterprise Console and
Netcool/OMNIbus, see the IBM Tivoli Monitoring: Administrator's Guide.
After situation forwarding is enabled, by default all situation events are forwarded to the specified event
server. However, you can customize which situation events are forwarded and to which event server. For
information on specifying which situation events to forward, see the Tivoli Enterprise Portal online help and
the IBM Tivoli Monitoring: Tivoli Enterprise Portal User's Guide.
461
Event integration scenarios

The scenarios in this section illustrate how event integration can be implemented with either Tivoli
Enterprise Console or Netcool/OMNIbus by forwarding situation events. To implement these
scenarios, hub monitoring servers must be configured to forward events to at least one event server,
and the event server must be configured to interpret the events and send updates to the originating
monitoring server. A special event-synchronization component, the Situation Update Forwarder, must
be installed on the event server. You can find complete instructions for implementing these scenarios
in the next two chapters, Chapter 21, Setting up event forwarding to Tivoli Enterprise Console, on
page 463 and Chapter 22, Setting up event forwarding to Netcool/OMNIbus, on page 491.
As of IBM Tivoli Monitoring V6.2.2, a new type of Tivoli Management Services agent, the System Monitor
Agent, allows you to send OS monitoring data directly to Netcool/OMNIbus without first passing the data to
a Tivoli Enterprise Monitoring Server. In this way these agents can run in agent-only environments that
lack the standard Tivoli Monitoring servers (the Tivoli Enterprise Monitoring Server and the Tivoli Enterprise
Portal Server). These monitoring agents, which run on Windows and on Linux/UNIX, effectively replace the
OMNIbus System Service Monitors for monitoring of desktop operating systems. Chapter 23, Monitoring
your operating system via a System Monitor Agent, on page 517 provides complete information on
installing, configuring, and uninstalling a System Monitor Agent on either Windows or Linux.
Note: As of fix pack 2 for V6.2.2, for sites running x86_64 CPUs, both 32-bit and 64-bit Windows
environments (Windows 2003, Vista, 2008) are supported for the System Monitor Agents.
An enhancement provided with the first fix pack for version 6.2.2 enables the System Monitor Agents to
send event data directly to OMNIbus, thus making a monitoring server unnecessary even for event
processing.
v EIF events generated by autonomous agents (including the System Monitor Agents) can be sent
directory to either Tivoli Enterprise Console or OMNIbus for private situations only.
v SNMP alerts generated by autonomous agents can be forwarded to any SNMP trap receiver, including
OMNIbus's MTTRAPD probe for both enterprise and private situations.
For more information, see Event forwarding from autonomous agents on page 53.
462
Chapter 21. Setting up event forwarding to Tivoli Enterprise

Console
If you are using Tivoli Enterprise Console, you can configure hub monitoring servers to forward situation
events to the Tivoli Enterprise Console event server (referred to as the event server) for correlation and
management.
To view updates to the forwarded situation events in the Tivoli Enterprise Portal, you need to install the
event synchronization component on the event server. The event synchronization component enables
changes in the event status made on the Tivoli Enterprise Console to be reflected on the Tivoli Enterprise
Portal.
The following table provides an overview of the tasks required to configure situation event forwarding and
synchronization:
Table 106. Tivoli Enterprise Console event synchronization installation and configuration steps
Task
Plan the deployment of your integration.
Event integration with Tivoli Enterprise Console
Gather information required during the installation and

configuration processes.
Information to gather for event forwarding on page 84
Install the event synchronization component on your

event server.
Installing event synchronization on your event server on

page 468
Install monitoring agent .baroc files on the event server.
Installing monitoring agent .baroc files on the event

server on page 481
Configure your monitoring server to forward events to

Tivoli Enterprise Console.
Configuring your monitoring server to forward events on

page 482
Start and stop event synchronization on the event server.
Starting and stopping the Situation Update Forwarder

process on page 484
Modify the configuration of event synchronization as your

monitoring needs change.
Changing the configuration of the event synchronization

component on the event server on page 484
Define additional monitoring servers to the event server.
Defining additional monitoring servers to the event

server on page 484
Change the default TCP/IP settings if it is taking a long

time to forward events back to the monitoring server.
Changing the TCP/IP timeout setting on your event

server on page 485
If you are upgrading from IBM Tivoli Monitoring and Tivoli Event Synchronization version 1.x to version
2.2.0.0, see Upgrading to Tivoli Event Synchronization version 2.2.0.0 on page 485.
Event integration with Tivoli Enterprise Console

The scenarios in this section illustrate the various ways to forward situation events from one or more
monitoring servers to one or more Tivoli Enterprise Console event servers:
v One or more hub monitoring servers and a single event server on page 464
v A single hub monitoring server and multiple event servers on page 465
v Multiple hub monitoring servers and multiple event servers in a hub and spoke configuration on page
466
The Tivoli Enterprise Console product significantly reduces the number of events displayed, enabling you
to focus on the most critical, relevant events and manage even the largest, most complex environments.
The Tivoli Enterprise Console product gives you the extensive control and flexibility that you need to
463
manage and maintain availability across your enterprise. Managing situation events with the Tivoli
Enterprise Console product gives you the following advantages:
v Aggregation of event information from a variety of different sources including those from other Tivoli
software applications, Tivoli partner applications, custom applications, network management platforms,
and relational database systems
v Pre-configured rules that automatically provide best-practices event management
v Persistence and processing of a high volume of events in an IT environment by:
Prioritizing events by their level of importance
Filtering redundant or low priority events
Correlating events with other events from different sources
Root cause analysis and resolution
Initiating automatic corrective actions, when appropriate, such as escalation
v Unified system and network management by automatically performing the following event management
tasks:
Correlating the status of a system or application to the status of the network that it uses
Determining if the root cause of a system or application problem is an underlying network failure
Note: If you already have policies that contain emitter activities that send events to the Tivoli Enterprise
Console, turning on Tivoli Event Integration event forwarding will result in duplicate events. You can
deactivate the emitter activities within policies so you do not have to modify all your policies when
you activate Tivoli Event Integration Facility forwarding by using Disable Workflow Policy/Tivoli
Emitter Agent Event Forwarding when you configure the monitoring server.
Using policies gives you more control over which events are sent and may not want to lose this
granularity. Moreover, it is likely the policies that are invoking the Tivoli Enterprise Console emitter
are doing little else. If you deactivate these activities, there is no point in running the policy. You
may prefer to delete policies that are longer required, instead of disabling them.
One or more hub monitoring servers and a single event server

You can configure one or more monitoring servers to forward situation events to an event server. Figure 94
on page 465 shows multiple hub monitoring servers that are configured to forward situation events to the
same event server. The event server sends situation updates based on Tivoli Enterprise Console rules and
operator actions back to the hub monitoring server that is associated with that situation.
464
Figure 94. One or more hub monitoring servers connecting to a single event server
A single hub monitoring server and multiple event servers

Figure 95 on page 466 shows a single hub monitoring server that is configured to forward situation events
to multiple event servers. The event servers send situation updates based on Tivoli Enterprise Console
rules and operator actions back to the hub monitoring server.
For this configuration, you must install the Tivoli Enterprise Console event synchronization component on
each event server, and, for each situation, you must specify the event server to which the situation event
is forwarded (see the IBM Tivoli Monitoring: Administrator's Guide).
Chapter 21. Setting up event forwarding to Tivoli Enterprise Console
465
Figure 95. Single hub monitoring server and multiple event servers
Multiple hub monitoring servers and multiple event servers in a hub

and spoke configuration
Figure 96 on page 467 shows multiple hub monitoring servers that are configured to forward situation
events to an event server that is connected to a hub event server. The hub event server sends situation
updates based on Tivoli Enterprise Console rules and operator actions back to the hub monitoring server
that is associated with that situation.
466
Figure 96. Multiple hub monitoring servers and multiple event servers in a hub and spoke configuration
Note: This graphic is intended to be an example of one possible scaled configuration for the IBM Tivoli
Monitoring and Tivoli Enterprise Console integration. The procedures in this chapter do not provide
all of the information needed to set up this sort of configuration.
For this configuration, you must install the Tivoli Enterprise Console event synchronization component on
the hub event server. You must also load the omegamon.baroc and Sentry.baroc files on the spoke event
servers, as described in Modifying an existing rule base on page 481. In addition, you must load each
.baroc file for any monitoring agent generating situations that are forwarded to spoke event servers, as
described in Installing monitoring agent .baroc files on the event server on page 481.
Determining when to use the IBM Tivoli Enterprise Console

IBM Tivoli Enterprise Console is a key element of a monitoring environment. Because of its capabilities,
the Tivoli Enterprise Console is commonly used in a Manager of Managers role, providing an enterprise
level solution for aggregation, consolidation, correlation, and management of events across the enterprise.
It is also used as an integration point with which other management applications interact. Tivoli Enterprise
Console provides the following capabilities:
467
v Aggregation of event information from a large number and variety of different sources including those
from other Tivoli software applications, Tivoli partner applications, custom applications, network
management platforms, and relational database systems
v Pre-configured rules that automatically provide best-practices event management and root cause
determination from an end to end perspective
v Persistence, processing, and access to a high volume of events in an IT environment
v Unified system and network management by automatically performing the following event management
tasks:
Correlating the status of a system or application to the status of the network that it uses
Determining if the root cause of a system or application problem is an underlying network failure
If you are monitoring fewer than 1000 active events and you want to view only situation events (not the
other types of events that IBM Tivoli Enterprise Console can monitor), you can use the Situation Event
Console in the Tivoli Enterprise Portal. If you are monitoring more than 1000 active events, consider
moving to IBM Tivoli Enterprise Console for your event aggregation, and use the Tivoli Enterprise Console
view within the Tivoli Enterprise Portal to display the event information. The response time for the Tivoli
Enterprise Console view is better than the Situation Event Console view when a large number of events is
displayed.
For additional information about the integration with Tivoli Enterprise Console, see Event synchronization
component on page 8. For additional information about Tivoli Enterprise Console itself, see the Tivoli
Enterprise Console information center. For additional information about using the Situation Event Console
in the Tivoli Enterprise Portal, see the IBM Tivoli Monitoring: Tivoli Enterprise Portal User's Guide.
Installing event synchronization on your event server

The installer for the event synchronization component is located in the /tec directory of the IBM Tivoli
Monitoring V6.2.2 Tools DVD.
There are three methods for installing the component:
v Installing from a wizard on page 469
v Installing from the command line on page 472
v Installing from the command line using a silent installation on page 476
When you install the event synchronization component on your event server, the following changes are
made:
v If you select to use an existing rule base, the event synchronization .baroc class files (omegamon.baroc
and Sentry.baroc [if not present]) and the omegamon.rls rule set file are imported into your existing rule
base. If you do not want to modify your existing rule base during the installation, you can choose to
manually perform rule base modifications after installation is complete. See Manually importing the
event synchronization class files and rule set on page 479 for more information.
v For all rule bases that have Sentry.baroc imported, the Sentry2_0_Base class is updated to define
additional integration attributes for the situation events received from IBM Tivoli Monitoring.
v A new process, Situation Update Forwarder, is installed along with its supporting binary and
configuration files. This process is used to forward updates to the situation events back to the
monitoring server. On Windows, a Tivoli Situation Update Forwarder service is also created.
Notes:
1. If your IBM Tivoli Enterprise Console event server is running on Windows 2003 and you are planning
to install the event synchronization remotely (using a program such as Terminal Services to connect to
that Windows 2003 computer), you need to run the change user /install command before you run the
installation. This puts the computer into the required "install" mode. After the installation, run the
change user /execute command to return the computer to its previous mode.
468
2. If you have a monitoring server on an operating system like UNIX or Linux, you must configure your
TCP/IP network services in the /etc/hosts file to return the fully qualified host name. See Host name
for TCP/IP network services on page 91 for more information.
3. For a Windows event server, any existing rule base that you use must indicate a relative drive letter
(such as C:\) as part of its associated path. To verify that your existing rule base contains a relative
drive letter, run the following command from a bash environment on your event server:
wrb -lsrb -path
If the returned path includes something like hostname:\rulebase_directory, with no drive letter (such as
C:\), copy the ESync2200Win32.exe file from the \TEC subdirectory of the IBM Tivoli Monitoring
installation image to the drive where the rule base exists and run the installation from that file.
4. If you are using a Windows event server, if you have any rule base with an associated path that does
not contain a relative drive letter and that has the Sentry2_0_Base class imported, copy the
ESync2200Win32.exe file from the \TEC subdirectory of the IBM Tivoli Monitoring installation image to
the drive where the rule base exists and run the installation from that file.
To verify if you have any rule bases that have an associated path containing no relative drive letter, run
the wrb -lsrb -path command as described in the previous note.
To determine if your rule bases have the Sentry2_0_Base class imported, run the following command
against all of your rule bases:
wrb -lsrbclass rule_base
where rule_base is the name of the rule base.
Installing from a wizard

Use the following steps to install event synchronization using the installation wizard:
Note: The appearance of the window shown in Figure 97 indicates that the installer did not find an IBM
Tivoli Enterprise Console event server installed on the system, so it expects to install event
synchronization for Netcool/OMNIbus. If you see this window when you launch the installation,
cancel the installation and install the event server on the system before restarting the installer, or
install the synchronization component on another system where an event server is installed.
Figure 97. Window shown when no Tivoli Enterprise Console event server is found.
1. On the host of the event server, launch the event synchronization installer from the installation media:
469
On Windows, double-click the ESync2200Win32.exe file in the \tec subdirectory on the IBM Tivoli
Monitoring V6.2.2 Tools DVD or DVD image.
On Linux or UNIX, change to the \tec subdirectory of the IBM Tivoli Monitoring V6.2.2 Tools DVD
and run the following command:
ESync2200operating_system.bin
where operating_system is the operating system you are installing on (aix, HP11, Linux, linux390,
or Solaris). For example, run the following command on an AIX computer:
ESync2200Aix.bin

3. Select I accept the terms in the license agreement and click Next.
4. Complete the following fields and click Next:
Table 107. IBM Tivoli Enterprise Console event synchronization configuration fields
Field
Description
Name of configuration file
The name of the file where event synchronization

configuration information is stored. The default name is
situpdate.conf.
Number of seconds to sleep when no new situation

updates
The polling interval, in seconds. The minimum value is 1,

while the default value is 3. If there are no situation
events, the Situation Update Forwarder rests for 3
seconds.
Number of bytes to use to save last event
Number of bytes that the long-running process uses when

it saves the location of the last event it processes. This
value must be an integer. The minimum (and default)
value is 50.
URL of the CMS SOAP Server
The URL for the SOAP Server configured on the

computer where the monitoring server is running. The
default value is cms/soap. This value is used to create the
URL to which IBM Tivoli Enterprise Console sends event
information. For example, http://hostname:port///cms/soap,
where hostname is the host name of the monitoring
server and port is the port.
Rate for sending SOAP requests to CMS from TEC via

web services
The maximum number of event updates sent to the

monitoring server at one time. The minimum (and default)
value is 10 events.
Level of debug detail for log
The level of information for event synchronization that will

be logged. You have the following choices:
v Low (default)
v Medium
v Verbose
5. Complete the following information about the files where events will be written and click Next:
Table 108. IBM Tivoli Enterprise Console event synchronization configuration fields, continued
Field
Description
Maximum size of any single cache file, in bytes
The maximum permitted size, in bytes, for any one event

cache file. The minimum (and default) value is 50000. Do
not use commas when specifying this value (specify
50000 instead of 50,000).
470
Table 108. IBM Tivoli Enterprise Console event synchronization configuration fields, continued (continued)
Field
Description
Maximum number of caches files
The maximum number of event caches files at any given

time. The minimum value is 2, while the default value is
10. When this value is reached, the oldest file is deleted
to make room for a new file.
Directory for cache files to be located
The location where event cache files are located. The

default locations are as follows:
v On Windows: C:\tmp\TME\TEC\OM_TEC\persistence.
v On UNIX: /var/TME/TEC/OM_TEC/persistence
6. Type the following information for each monitoring server with which you want to synchronize events
and click Add. You must specify information for at least one monitoring server.
Host name
The fully qualified host name for the computer where the monitoring server is running. This
name must match the information that will be in events that are issued from this monitoring
server.
User ID
The user ID to access the computer where the monitoring server is running.
Password
The password to access the computer.
Confirmation
The same password, for confirmation.
You can add information for up to 10 monitoring servers in this wizard. If you want to add additional
monitoring servers, add them after you install them by using the steps provided in Defining additional
monitoring servers to the event server on page 484.
7. When you have provided information about all of the monitoring servers, click Next.
You are presented with the options of having the installer automatically perform rule base
modifications, or manually performing the modifications after installation is complete (see Table 109).
Table 109. Options for rule base modification
Option
Description
Automatically install rules and

classes
The installation wizard will ask for the rule base into which event synchronization
class files and rule set will be imported, and automatically execute the rule base
commands to do this.
Manually install rules and

classes
The installation wizard will not create or update any rule base with event
synchronization files.
Important: You will have to manually create or update the rule base with event
synchronization files after the installation is complete. See Manually importing the
event synchronization class files and rule set on page 479.
If you select the automatic option, continue with step 8. If you select the manual option, skip to step
11.
8. Specify the rule base that you want to use to synchronize events. You have two choices:
v Create a new rulebase
v Use existing rulebase
If you select to use an existing rule base, the event synchronization .baroc class files
(omegamon.baroc and Sentry.baroc [if not present]) and the omegamon.rls rule set file are imported
into your existing rule base. Also, if Sentry.baroc has already been imported into the existing rule
base, the Sentry2_0_Base class is extended to define additional integration attributes for the situation
events from IBM Tivoli Monitoring.
471
v If you are creating a new rule base, type the name for the rule base you want to create and the
path to where the new rule base will be located. There is no default location; you must specify a
location.
v If you are using an existing rule base, type the name of the rule base.
v If you want to import an existing rule base into a new rule base, type the name of the existing rule
base in the Existing rulebase to import field.
Note: This step is only available if you are creating a new rule base.
9. Click Next.
10. If you indicated in the previous step that the installer uses an existing rule base to import the event
synchronization class files and rule set, a window is displayed that allows you to specify whether you
want the installer to back up the rule base before updating it. If you request a backup, specify both
the backup rule base name and backup rule base path. If you leave these fields blank, no backup is
made. Click Next to proceed to the pre-installation summary panel.
11. Verify the installation location, then click Next.
12. When the installation and configuration steps are finished, a message telling you to stop and restart
the event server is displayed.
If you chose to have the installer automatically update the rule base, you are offered the option of
having the installer restart the event server for you. Check the box to have the installer restart the
server. If you want to restart the event server yourself, leave the box unchecked.
13. Click OK.
14. Click Finish on the Summary Information window.
Note: If any configuration errors occurred during installation and configuration, you are directed to a
log file that contains additional troubleshooting information.
Perform the following tasks after the installation is finished:
v Stop and restart the event server for the configuration changes to take effect.
v Install the monitoring agent .baroc files on the event server as described in Installing monitoring agent
.baroc files on the event server on page 481.
v Configure the monitoring server to forward events to the event server as described in Configuring your
monitoring server to forward events on page 482.
v If you did not choose to have the rule base updated automatically, update the rule base as described in
Manually importing the event synchronization class files and rule set on page 479.
Installing from the command line

Use the following steps to install the event synchronization from the command line on your event server:
1. Change to the tec directory on the IBM Tivoli Monitoring V6.2.2 Tools DVD or DVD image.
2. Run the following command to launch the installation:
On Windows:
ESync2200Win32.exe -console
On UNIX or Linux:
ESync2200operating_system.bin -console
ESync2200Aix.bin -console

Press 1 for Next, 3 to Cancel or 4 to Redisplay [3]
472
3. Type 1 to start the installation and press Enter.

Software Licensing Agreement:
Press Enter to display the license agreement on your screen. Please
read the agreement carefully before installing the Program. After
reading the agreement, you will be given the opportunity to accept it
or decline it. If you choose to decline the agreement, installation
will not be completed and you will not be able to use the Program.
4. Press Enter to display the software license agreement.

5. Type 1 and press Enter to accept the license.
Press 1 for Next, 2 for Previous, 3 to Cancel, or 4 to Redisplay [1]
6. Type 1 and press Enter to continue.

Name of configuration file [situpdate.conf]
7. Press Enter to use the default configuration file, situpdate.conf. If you want to use a different
configuration file, type the name and press Enter.
Number of seconds to sleep when no new situation updates [3]
8. Type the number of seconds that you want to use for the polling interval. The default value is 3, while
the minimum value is 1. Press Enter.
Number of bytes to use to save last event [50]
9. Type the number of bytes to use to save the last event and press Enter. The default and minimum
value is 50.
URL of the CMS SOAP server [cms/soap]
10. Type the URL for the monitoring server SOAP server and press Enter. The default value is cms/soap
(which you can use if you set up your monitoring server using the defaults for SOAP server
configuration).
Rate for sending SOAP requests to CMS from TEC via Web Services [10]
11. Supply the maximum number of event updates to send to the monitoring server at one time and press
Enter. The default and minimum value is 10.
Level of debug for log
[x] 1 low
[ ] 2 med
[ ] 3 verbose
To select an item enter its number, or enter 0 when you are finished: [0]
12. Type the level of debugging that you want to use and press Enter. The default value is Low, indicated
by an x next to Low.
13. Type 0 when you have finished and press Enter.

Maximum size of any single cache file, in bytes [50000]
473
15. Type the maximum size, in bytes, for the cache file and press Enter. The default value is 50000. Do
not use commas (,) when specifying this value.
Maximum number of cache files [10]
16. Type the maximum number of cache files to have at one time and press Enter. The default value is
10, while the minimum is 2.
On Windows, the following prompt is displayed:
Directory for cache files to reside [C:/tmp/TME/TEC/OM_TEC/persistence]
On UNIX, the following prompt is displayed:

Directory for cache files to reside [/var/TME/TEC/OM_TEC/persistence]
17. Type the directory for the cache files and press Enter. The default directory on Windows is
C:\tmp\TME\TEC\OM_TEC\persistence; on UNIX, /var/TME/TEC/OM_TEC/persistence.

--- Tivoli Enterprise Monitoring Server 1 --Host name []
Type the fully qualified host name for the computer where the monitoring server is running. This name
must match the information that is in events issued by this monitoring server. Press Enter.
User ID []
20. Type the user ID to use to access the computer where the monitoring server is running and press
Enter.
Password:
21. Type the password to access the computer and press Enter.
Confirmation:
22. Type the password again to confirm it and press Enter.

23. Repeat steps 19 to 22 for each monitoring server for which you want to receive events on this event
server.
When you have provided information for all the monitoring servers and you specified information for
less than 10 monitoring servers, press Enter to move through the remaining fields defining additional
monitoring servers. Do not specify any additional monitoring server information.
[X] 1 Automatically install rules and classes (recommended)
[ ] 2 Manually install rules and classes (advanced users)
To select an item enter its number, or 0 when you are finished: [0]
24. If you want to have the installer automatically install the rules and classes, enter 1 and continue with
step 25. If you prefer to manually install the rules and classes, enter 2 and proceed to step 35.
25. When you see the following prompt, type 1 and press Enter to continue:
Press 1 for Next, 2 for Previous, 3 to cancel or 4 to Redisplay [1]
474

[x] 1 - Create a new rulebase (name and path required)
[ ] 2 - Use Existing Rulebase (path is optional)
To select an item, enter its number, or press 0 when you are finished: [0]
26. Type 1 to create a new rule base or 2 to use an existing rule base. Press Enter.
27. Type 0 when you are finished and press Enter.
28. If you are creating a new rule base, the following prompt is displayed:
Rulebase Name []
type the name for the rule base and press Enter.
Rulebase Path []
29. If you are creating a new rule base, type the path for the new rule base and press Enter.
30. If you are using an existing rule base, the following prompt is displayed:
Rulebase Name []
Type the name of the rule base and press Enter.

31. If you are creating a new rule base, the following prompt is displayed:
Existing rulebase name to import: []
If you want to import an existing rule base into the new rule base, type the name of the existing rule
base and press Enter.

You indicated on the previous dialog that you want to modify an existing
rule base. If you want this installer to back up the existing rule base
before modifying it please provide a backup rule base name. Leave backup
rule base name blank and click Next if you do not want a backup made.
Backup rule base name. []
33. Type the name for the backup rule base and press Enter to continue. If you do not want the installer
to back up the existing rule base, press Enter without providing a backup rule base name.
If you have provided a backup rule base name you must provide a backup
rule base path. NOTE: We append the backup rule base name to the backup
rule base path for clarity and easy lookup.
Backup rule base path. []
34. Type the path for the backup rule base and press Enter to continue. If you did not provide a name for
a backup rule base, press Enter without providing a rule base path.
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

The event synchronization is installed.
Installation and Configuration has completed. Please stop and restart the
Tivoli Enterprise Console Server.
475

Installation and configuration has completed.
Please restart the Tivoli Enterprise Console server for the changes
to take effect.
Mark appropriately below to restart the Tivoli Enterprise Console
server.
[ ] 1 - Restart the Tivoli Enterprise Console server to make changes
effective
The option to automatically restart the Tivoli Enterprise Console is presented only if you chose to
have the installer automatically update the rules and classes.
37. If you want the installer to stop and restart the Tivoli Enterprise Console server, type 1 and press
Enter. If you want to stop and restart yourself, type 0 and press Enter to continue. The following
prompt is displayed:
Press 3 to Finish, or 4 to Redisplay [1]
38. Type 3 to finish and press Enter.

v If you did not have the installer do it, stop and restart the event server for the configuration changes to
take effect.
Manually importing the event synchronization class files and rule set on page 479.
Installing from the command line using a silent installation

Use the following steps to install the event synchronization using a silent installation from the command
line on your event server. This installation method runs silently, so you will not see status messages during
the actual installation.
1. Change to the tec directory of the IBM Tivoli Monitoring V6.2.2 Tools DVD or DVD image.
2. Run the following command to generate the configuration file:
On Windows:
ESync2200Win32.exe -options-template filename
where filename is the name of the configuration file to create, for example, es_silentinstall.conf.
On UNIX:
ESync2200operating_system.bin -options-template filename
where operating_system is the operating system you are installing on (Aix, HP11, Linux, linux390,
ESync2200Aix.bin -options-template filename
3. Edit the output file to specify the values shown in Table 110 on page 477.
Notes:
a. Remove the pound signs (###) from the beginning of any value that you want to specify.
b. Do not enclose any values in quotation marks (").
c. You must specify the following values:
v configInfoPanel2.fileLocn
476
v Information for at least one monitoring server (the cmdSvrsPnlNotGuiMode.hostname1,

cmdSvrsPnlNotGuiMode.userID1, cmdSvrsPnlNotGuiMode.pswd1, and
cmdSvrsPnlNotGuiMode.retypePswd1 values)
v rulebasePanel.chooseNewOrExistingRB
v rulebasePanel.rbName
v rbInstallTypePanel.rbInstallType
If you are creating a new rule base, rulebasePanel.rbPath is also required. If "manual" is specified
for rbInstallTypePanel.rbInstallType, all the other rulebasePanel.* options are ignored.
If you do not specify any of the other values, the default values are used.
d. The following values are specified only when installing event synchronization on a
Netcool/Omnibus Object Server:
###
###
###
###
-P
-W
-W
-W
installLocation
configInfoPanel3.filesize
configInfoPanel3.fileNumber
configInfoPanel3.fileLocn
e. If you specify values, ensure that the value you specify meets the minimum required values.
Otherwise, the installation stops and an error is written to the log file.
Table 110. IBM Tivoli Enterprise Console event synchronization configuration values
Value
Description
installLocation
The directory where you want the product to be installed.

If the directory path contains spaces, enclose it in double
quotes (" "). For example, to install the product to
C:\Program Files\My Product, use
-P installLocation="C:\Program Files
\My Product"
Any specified value is ignored if an event server is
detected.
configInfoPanel.filename

configuration information is stored. The default file name
is situpdate.conf.
configInfoPanel.pollingInt

events, the process that forwards events to IBM Tivoli
Enterprise Console rests for 3 seconds.
configInfoPanel.crcByteCnt
Number of bytes that the long running process will use

when it saves the location of the last event it processes.
This value must be an integer. The minimum (and default)
value is 50.
configInfoPanel.cmsSoapURL

default value is cms/soap. This value is used to create
the URL to which IBM Tivoli Enterprise Console sends
event information. For example, http://hostname:port///
cms/soap, where hostname is the host name of the
monitoring server and port is the port.
configInfoPanel.bufFlushRate

value is 10 events.
477
Table 110. IBM Tivoli Enterprise Console event synchronization configuration values (continued)
Value
Description
configInfoPanel.logLevel
The level of debug information for event synchronization

that is logged. You have the following choices:
v Low (default)
v Medium
v Verbose

not use commas when specifying this value (50,000
instead of 50000).


v On Windows: C:\tmp\TME\TEC\OM_TEC\persistence.
v On UNIX: /var/TME/TEC/OM_TEC/persistence
cmsSvrsPnlNotGuiMode.hostname#
The host name of each monitoring server that will send
Note: The pound sign (#) stands for a number between 1 events to the event server. Specify up to 10 monitoring
and 10. For example, "hostname1".
servers.
cmsSvrsPnlNotGuiMode.userID#
The user ID for the monitoring server, identified in

hostname#, to use to access the computer where the
monitoring server is running.
cmsSvrsPnlNotGuiMode.pswd#
The password for the user ID used to access the

computer where the monitoring server is running.
cmsSvrsPnlNotGuiMode.retypePswd#
The password confirmation for the user ID.
rbInstallTypePanel.rbInstallType
Specifies whether the installer will automatically update a

specified rule base, or if a rule base must be manually
modified after installation is complete. Specify either
automatic or manual. If manual is specified, all other
rulebasePanel.* options are ignored.
rulebasePanel.chooseNewOrExistingRB
Specifies whether you are going to create a new rule

base or use an existing rule base. Specify either new or
existing.
rulebasePanel.rbName
The name of the rule base (existing or new).
rulebasePanel.rbPath
The path for the new rule base. There is no default

location. You must specify a path.
rulebasePanel.fromRB
If you are creating a new rule base, identify any existing

rule bases that you want to import into the new rule base.
bckupERB.backupName
If you want the install to back up an existing rule base

before modifying it, specify the name of the backup rule
base.
rulebasePanel.backupPath
Specify the directory where the backup rule base should

be created.
restartTECQ.restartTEC
Specify whether or not the installer should recycle the

event server to implement the changes. Specify Yes to
have the installer restart the server; specify No if you want
to restart the server yourself after installation is
completed.
478
4. Save the file.

On Windows:
ESync2200Win32.exe -options filename -silent
where filename is the name of your configuration file.

On UNIX:
ESync2200operating_system.bin -options filename -silent
Solaris). For example, on AIX, run the following command:
ESync2200Aix.bin -options filename -silent
You must stop and restart the event server for these changes to take effect.
When installation is complete, the results are written to the itm_tec_event_sync_install.log file. On UNIX,
this log file is always created in the /tmp directory. For Windows, this file is created in the directory defined
by the %TEMP% environment variable. To determine where this directory is defined for the current
command line window, run the following command:
echo %TEMP%
If you specified the monitoring servers in the silent installation configuration file, you might consider
deleting that file after installation, for security reasons. The passwords specified in the files are not
encrypted.
If you want to define additional monitoring servers (in addition to the one required monitoring server), run
the sitconfsvruser.sh command as described in Defining additional monitoring servers to the event server
on page 484. Repeat this command for each monitoring server.
If you specified your monitoring servers after the installation, you must stop and restart the Situation
Update Forwarder process manually. See Starting and stopping the Situation Update Forwarder process
on page 484 for information.
Manually importing the event synchronization class files and rule set.
Manually importing the event synchronization class files and rule set
If you do not want to permit the installation program to modify your rule base, you can choose the manual
rule base modification option during the installation and then use one of the following methods to manually
modify your rule base:
v Creating a new rule base on page 480
v Creating a new rule base and importing an existing rule base into it on page 480
v Modifying an existing rule base on page 481
Before you can run any of the commands in the following sections, you must source your Tivoli
environment by running the following command:
On Windows, run the following command from a command prompt:
479
C:\Windows\system32\drivers\etc\Tivoli\setup_env.cmd
On Linux or UNIX, run the following command from a shell environment:

. /etc/Tivoli/setup_env.sh
See the IBM Tivoli Enterprise Console Command and Task Reference for more information about the wrb,
wstopesvr, and wstartesvr commands.
Creating a new rule base

Use the following steps to create a new rule base after you install the event synchronization component:
1. Create the new rule base by running the following command:
wrb -crtrb -path newrb_path newrb_name
where newrb_path is the path to where you want to create the new rule base, and newrb_name is the
name for the new rule base.
2. Import the event synchronization class and rule files into the new rule base from the
$BINDIR/TME/TEC/OM_TEC/rules directory created during the installation of the event synchronization
component. Run the following commands:
wrb -imprbclass path_to_Sentry_baroc_file newrb_name
wrb -imprbclass path_to_omegamon_baroc_file newrb_name
wrb -imprbrule path_to_omegamon_rls_file newrb_name
wrb -imptgtrule omegamon EventServer newrb_name
3. Compile and load the new rule base by running the following commands:
wrb -comprules newrb_name
wrb -loadrb newrb_name
4. Stop and restart the event server by running the following commands:
wstopesvr
wstartesvr
Creating a new rule base and importing an existing rule base into it
Use the following steps to create a new rule base and import an existing rule base into it:
1. Create the new rule base by running the following command:
wrb -crtrb -path newrb_path newrb_name
where newrb_path is the path to where you want to create the new rule base and newrb_name is the
name for the new rule base.
2. Import the existing rule base into the new rule base by running the following commands:
wrb -cprb -overwrite existing_rbname newrb_name
where existing_rbname is the name of the existing rule base that you want to import.
3. If the existing rule base is an older rule base, you must upgrade the tec.baroc file to include the
TEC_Generic class. Run the following command:
perl $BINDIR/TME/TEC/OM_TEC/bin/upg_tec_baroc.pl newrb_name
4. If the rule base already contains a Sentry.baroc file, you must upgrade it with the event synchronization
event class attributes. Run the following command:
perl $BINDIR/TME/TEC/OM_TEC/bin/upg_sentry_baroc.pl
5. If the rule base does not contain a Sentry.baroc file, you must import it from the $BINDIR/TME/TEC/
OM_TEC/rules directory created during event synchronization installation. Run the following command:
480
6. Import the omegamon.baroc and rules file into the rule base from the $BINDIR/TME/TEC/OM_TEC/
rules directory created during event synchronization installation. Run the following commands:
wstopesvr
wstartesvr
Modifying an existing rule base

Use the following steps to modify an existing rule base to include the class files and rule set for the event
synchronization component:
1. If the existing rule base is an older rule base, you must upgrade the tec.baroc file to include the
TEC_Generic class. Run the following command:
perl $BINDIR/TME/TEC/OM_TEC/bin/upg_tec_baroc.pl newrb_name
2. If the rule base already contains a Sentry.baroc file, you must upgrade it with the event synchronization
event class attributes. Run the following command:
perl $BINDIR/TME/TEC/OM_TEC/bin/upg_sentry_baroc.pl
3. If the rule base does not contain a Sentry.baroc file, you must import it from the $BINDIR/TME/TEC/
OM_TEC/rules directory created during event synchronization installation. Run the following command:
4. Import the omegamon.baroc and rules file into the rule base from the $BINDIR/TME/TEC/OM_TEC/
rules directory created during event synchronization installation. Run the following commands:
wstopesvr
wstartesvr
Installing monitoring agent .baroc files on the event server

The monitoring server generates Tivoli Enterprise Console events with classes that are unique to each
monitoring agent. Each monitoring agent provides a .baroc file with the Tivoli Enterprise Console classes
that are generated by IBM Tivoli Monitoring. In order to view this event data in the event console, you
must install these monitoring agent .baroc files on the event server.
After you have added application support for each agent to the monitoring server, the monitoring agent
.baroc files are located in the following directory:
v On Windows, in the itm_installdir\cms\TECLIB directory, where itm_installdir is the directory where
you installed IBM Tivoli Monitoring.
v On Linux and UNIX, in the itm_installdir/tables/ms_name/TECLIB directory, where itm_installdir is the
directory where you installed IBM Tivoli Monitoring and ms_name is the name of the monitoring server.
v z/OS users, see the IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise
Monitoring Server on z/OS guide.
Use the following steps to install the monitoring agent .baroc files on the event server:
481
1. Copy the monitoring agent .baroc files from the computer where the monitoring server is installed to a
temporary directory on the event server computer (for example, /tmp). The location of the agent .baroc
files is described above. Do not copy the om_tec.baroc file; this file contains classes that are
duplicates of classes in the omegamon.baroc file.
2. Set up the Tivoli Management Framework environment by running the following command:
On Windows, run the following command:
C:\WINDOWS\system32\drivers\etc\Tivoli\setup_env.cmd
On Linux and UNIX, run the following command from a shell environment:
3. For each monitoring agent .baroc file to load into the rule base, run the following command from the
same command prompt:
wrb -imprbclass /tmp/agent_baroc_file rb_name
where:
/tmp/agent_baroc_file
Specifies the location and name of the monitoring agent .baroc file. The example above uses the
/tmp directory as the location.
rb_name
Is the name of the rule base that you are using for event synchronization.
4. Compile and load the rule base by running the following commands
wrb -comprules rb_name
wrb -loadrb rb_name
wstopesvr
wstartesvr
When you have loaded each of the agent .baroc files into the rule base and restarted the event server, the
event server is ready to receive and correctly parse any events it receives from the monitoring server from
one of the installed monitoring agents.
See the IBM Tivoli Enterprise Console Command and Task Reference for more information about the wrb,
wstopesvr, and wstartesvr commands.
Configuring your monitoring server to forward events

Before the monitoring server forwards any situation events to Tivoli Enterprise Console, you have to
enable that forwarding of events. Use the following steps to enable event forwarding on your monitoring
server.
Note: z/OS users, see the IBM Tivoli Management Services on z/OS: Configuring the Tivoli Enterprise
Monitoring Server on z/OS guide.
For Windows monitoring servers only, do the following:
1. Open Manage Tivoli Enterprise Monitoring Services.
2.
3.
4.
5.
Right-click the monitoring server and click Reconfigure.

On the configuration options window, select Tivoli Event Integration Facility.
Click OK and OK.
Complete the following fields on the Event Server: Location and Port Number window and click OK:
Server or EIF Probe Location
Type the host name or IP address for the computer where the IBM Tivoli Enterprise Console
event server is installed.
482
Port Number
Type the port number for the event server. If the event server is using port mapping, set this
value to 0. If the event server was configured to use a specific port number, specify that
number.
To determine the port number that the event server is using, search for the
tec_recv_agent_port parameter in the .tec_config file in the $BINDIR/TME/TEC directory on
the event server. If the parameter is commented out with a pound sign (#), the event server is
using port mapping. If it is not, the event server is using the port number specified by this
parameter.
For Linux and UNIX monitoring servers: You configured the TEC Server and TEC Port information for
the Linux/UNIX monitoring server during installation, if you installed the monitoring server using the
configuration instructions in this installation guide. However, if you did not configure this information, see
Configuring the hub monitoring server on page 154 for the procedure.
Note: If you already have policies that contain emitter activities that send events to the Tivoli Enterprise
Console, turning on Tivoli Event Integration event forwarding will result in duplicate events. You can
deactivate the emitter activities within policies so you do not have to modify all your policies when
you activate Tivoli Event Integration Facility forwarding by specifying Disable Workflow
Policy/Tivoli Emitter Agent Event Forwarding when you enable forwarding using the Event
Integration Facility.
Using policies gives you more control over which events are sent and you may not want to lose this
granularity. Moreover, it is likely the policies that are invoking the TEC emitter are doing little else. If
you deactivate these activities, there is no point in running the policy. You may prefer to delete
policies that are longer required, instead of disabling them. Note that events forwarded via the TEC
event emitter are not eligible for event synchronization (that is, changes to these events on the TEC
side will not be sent back to the monitoring server).
Controlling event forwarding

The om_tec.config file controls the forwarding of events to IBM Tivoli Enterprise Console. It contains this
parameter:
BufferFlushRate=events_per_minute
Specifies the number of events that are sent per minute when the adapter has reestablished its
connection to Tivoli Enterprise Console. After the adapter has recovered the lost connection, if there
are events in the buffer, the events are sent at this rate per minute. The default value is 0, meaning all
events are sent in one burst.
If your environment can have a large number of open situation events, you may want to adjust this
parameter to control the rate at which events are sent to the event server. To edit this file and change this
parameter:
v On Windows:
2. Right-click Tivoli Enterprise Monitoring Server, and click Advanced Edit EIF Configuration.
3. Once you have completed your reconfiguration, recycle the Tivoli Enterprise Portal Server and each
Tivoli Enterprise Portal client.
v On Linux or UNIX:
1. Edit file install_dir/tables/hostname/TECLIB/ om_tec.config, where install_dir is your Tivoli
Monitoring installation directory and hostname is the name of the host running this monitoring
server.
2. Once you have saved your configuration updates, recycle the Tivoli Enterprise Portal Server and
each Tivoli Enterprise Portal client.
483
Starting and stopping the Situation Update Forwarder process

To send event updates to a monitoring server, you must start the Situation Update Forwarder. This process
is started automatically when the event server starts. To start the process manually, change to the
$BINDIR/TME/TEC/OM_TEC/bin directory (where $BINDIR is the location of the Tivoli Management
Framework installation) and run the following command:
On Windows:
startSUF.cmd
On UNIX:
startSUF.sh
To stop the process, run the following command:

On Windows:
stopSUF.cmd
On UNIX:
stopSUF.sh
On Windows, you can also start and stop the Tivoli Situation Update Forwarder service to start or stop the
forwarding of event updates. You can start and stop this service either from the Windows Service Manager
utility or with the following commands:
net start situpdate
net stop situpdate
Changing the configuration of the event synchronization component

on the event server
If you want to change any of the settings for the event synchronization on the event server, use the
sitconfig.sh command. You have two options for running this command:
v Manually modify the configuration file for event synchronization (named situpdate.conf by default and
located in the /etc/TME/TEC/OM_TEC directory on UNIX and Linux, and the %SystemDrive%\Program
Files\TME\TEC\OM_TEC\etc directory on Windows), and then run the following command:
sitconfig.sh update filename=config_filename
v Run the sitconfig.sh command directly, specifying only those settings that you want to change. See the
IBM Tivoli Monitoring: Command Reference for the full syntax of this command.
After you change the configuration of the event synchronization, you must manually stop and restart the
Situation Update Forwarder process. See Starting and stopping the Situation Update Forwarder process
for information.
Defining additional monitoring servers to the event server

To add additional monitoring servers to the list that can receive event status updates from Tivoli Enterprise
Console, run the sitconfsvruser.sh command as follows:
1. Source your Tivoli environment by running the following command:
v On Windows, run the following command from a command prompt:
C:\Windows\system32\drivers\etc\Tivoli\setup_env.cmd
v On operating systems like UNIX and Linux, run the following command from a shell environment:
2. On Windows, type BASH to invoke the bash shell.
484
3. Change to the $BINDIR/TME/TEC/OM_TEC/bin directory (where $BINDIR is the location of the Tivoli
Management Framework installation) and enter the following command:
sitconfsvruser.sh add serverid=server userid=user password=password
where:
server Is the fully qualified host name of the monitoring server.
user
Is the user ID to access the computer where the monitoring server is running.
password
Is the password to access the computer.
Repeat this command for each monitoring server.
You can also delete monitoring servers. See the IBM Tivoli Monitoring: Command Reference for the full
syntax of this command.
Changing the TCP/IP timeout setting on your event server

If the Situation Update Forwarder cannot reach a monitoring server to send an update, depending on the
TCP/IP settings for the computer where your event server is running, you might have to wait up to 15
minutes before the Situation Update Forwarder tries to connect to the monitoring server again. This might
occur if your event server is running on an AIX, Solaris, or HP-UX computer.
Use the following steps to change the TCP/IP timeout value for your computer.
On AIX, run the following command:
no -o tcp_keepinit=timeout_value
where timeout_value is the length of the timeout period, in half seconds. To configure a timeout of 30
seconds, set the timeout_value value to 60.
On Solaris and HP-UX, run the following command:
ndd -set /dev/tcp tcp_ip_abort_cinterval timeout_value
where timeout_value is the length of the timeout period, in milliseconds. To configure a timeout of 30
seconds, set the timeout_value value to 30000.
Upgrading to Tivoli Event Synchronization version 2.2.0.0

Upgrading replaces the omegamon.rls file. Any changes you have made to this file will be lost. However, a
backup file named omegamon.rls.bac is created so you can recover your changes. You must load the
noncurrent rule base and restart the Tivoli Enterprise Console event server after updating either the
noncurrent or the current rule base.
Note: If you have already installed IBM Tivoli Monitoring and Tivoli Event Synchronization, you must
upgrade to version 2.2.0.0.
You install the upgrade from the IBM Tivoli Monitoring installation media.
There are three methods for upgrading event synchronization:
v Upgrading from a wizard on page 486
485
v Upgrading from the command line on page 487

v Upgrading from the command line using a silent installation on page 489
If you have multiple rule bases that are using IBM Tivoli Monitoring and Tivoli Event Synchronization, you
can run the upgrade installation to update each rule base. After you finish the first rule base, restart the
upgrade installer and supply the targeted next rule base you want to update.
Note: You cannot uninstall just the upgrade. You must uninstall the entire product. For instructions on
uninstalling, see Uninstalling the event synchronization component on page 590
Upgrading from a wizard

Use the following steps to upgrade event synchronization from the installation wizard:
1. On the host of the event server, launch the event synchronization upgrade installation:
On Windows, double-click the ESUpgrade22Win32.exefile in the tec subdirectory on the IBM Tivoli
On Linux or UNIX, change to the tec subdirectory on the IBM Tivoli Monitoring V6.2.2 Tools DVD or
DVD image and run the following command:
ESUpgrade22operating_system.bin
ESUpgrade22Aix.bin

3. Select I accept the terms in the license agreement and click Next.
You are presented with the option of having the installer automatically update the rule base for you.
4. Select whether you want to have the installer update the rule base or whether you prefer to update it
manually after the installation is complete, then click Next.
If you chose to manually update the rule base, you will see a progress indicator for the installation.
Proceed to step 9. If you chose to have the installer automatically update the rule base, the data
collection window shown in Figure 98 is displayed:
Figure 98. Upgrade data collection window
Proceed to step 5.
486
5. Specify the name of the rule base to be upgraded. The rule base must be one that has event
synchronization previously installed.
6. If you want the installer to back up the rule base before it is modified, specify a name and a path for
the backup rule base.
7. Click Next to continue.
A window is displayed that summarizes the information you entered.
8. If the information is correct, click Next to proceed with the installation. If the information is not correct,
click Back and correct the fields as necessary; then click Next and Next again to proceed.
A progress indicator shows the progress of the installation and configuration.
9. When the installation completes successfully, you will see a message that reminds you to restart the
TEC server. If the updated rule base is not the currently loaded rule base, you are reminded to load
the rule base and restart the server. Click OK to dismiss the message.
A window is displayed that reminds you to restart the Tivoli Enterprise Console server.
10. If you want the installer to restart the server for you, check Restart the Tivoli Enterprise Console
server to make changes effective; then click Next. If you do not want the installer to restart the
server, leave the option unchecked and click Next.
11. Click Finish to exit the installer.
Important:: If you chose the manual update option, you must copy the files in $BINDIR/TME/TEC/OM_TEC/
rules directory to the rule base, recompile and reload the rule base, and restart the Tivoli
Enterprise Console. Refer to Manually importing the event synchronization class files and
rule set on page 479 for the commands to use to do this.
Upgrading from the command line

Use the following steps to upgrade event synchronization from the command line on your event server:
On Windows:
ESUpgrade22Win32.exe -console
On UNIX or Linux operating systems:

ESUpgrade22operating_system.bin -console
ESUpgrade22Aix.bin -console



487
[X] 1 Automatically install rules and classes (recommended)

[ ] 2 Manually install rules and classes (advanced users)
6. If you want to have the installer automatically install the rules and classes, enter 1. The following
Rule base Name []
Continue with step 7. If you prefer to manually install the rules and classes, enter 2 and proceed to
step 11.
8. Type the name of the rule base to upgrade then press Enter.
The rule base must be one in which event synchronization was previously installed.
Backup rule base name. []
9. If you want the installer to back up the rule base before modifying it, type a name for the backup rule
base, then press Enter. If you do not want the installer to create a backup rule base, press Enter
without typing any name. If you provide a name for the backup rule base, you are prompted for the
path for the backup rule base:
If you have provided a backup rule base name you must provide a backup
rule base path. NOTE: We append the backup rule base name to the
backup rule base path for clarity and easy look-up.
Backup rule base path. []
10. Type the path and press Enter. The following prompt is displayed:
Press 1 for Next, 2 for Previous, 3 to Cancel, or 4 to Redisplay []


The event synchronization is installed. The following prompt is displayed:
Installation and Configuration has completed. Please stop
and restart the Tivoli Enterprise Console Server.

Installation and configuration has completed.
Please restart the Tivoli Enterprise Console server for the changes
to take effect.
Mark appropriately below to restart the Tivoli Enterprise Console
server.
[ ] 1 - Restart the Tivoli Enterprise Console server to make changes
effective
If you did not choose to have the installer automatically update the rule base, you will not be offered
the option to restart the Tivoli Enterprise Console automatically.
14. If you want the installer to stop and restart the Tivoli Enterprise Console server, type 1 and press
Enter. If you want to stop and restart the console yourself, type 0 and press Enter. The following
488

You must stop and restart the event server for these changes to take effect.
Important: If you chose the manual update option, you must copy the files in $BINDIR/TME/TEC/OM_TEC/
Enterprise Console. Refer to Manually importing the event synchronization class files and rule
set on page 479 for the commands to use to do this.
Upgrading from the command line using a silent installation

If you have already installed Fix Pack 1, be aware that if you define the rulebasePanel.rbName, this silent
installation will update the rule base. If you do not want to apply the updated rules file to a rule base leave
the rulebasePanel.rbName commented out (do not delete the pound signs ### preceding the parameter).
On Windows:
ESUpgrade22Win32.exe -options-template filename
On UNIX:
ESUpgrade22operating_system.bin -options-template filename
ESUpgrade22Aix.bin -options-template filename
3. Edit the output file to specify the following values.

rbInstallTypePanel.rbInstallType
Specifies whether the installer will automatically update a specified rule base, or if a rule base
must be manually modified after installation is complete. Specify either automatic or manual. If
manual is specified, all other rulebasePanel.* options are ignored.
The name of the rule base to be updated.
rulebasePanel.backupName
The name of the backup rule base.
rulebasePanel.backupPath
The path for the backup rule base.
restartTEC.startTEC
Indicates that you want the installer to restart the Tivoli Enterprise Console event server.
Notes:
b. Do not enclose any values in quotation marks (").
c. Specify the following value only if you want the indicated rule base updated:
d. If you specify values, ensure that the value you specify meets the minimum required values.
Otherwise, the installation stops and an error is written to the log file.
489
4. Save the file.

On Windows:
ESUpgrade22Win32.exe -options filename -silent

On UNIX:
ESUpgrade22operating_system.bin -options filename -silent
ESUpgrade22Aix.bin -options filename -silent
The rule base that is updated during silent installation is made current.
Important: If you chose the manual update option, you must copy the files in $BINDIR/TME/TEC/OM_TEC/
Enterprise Console. Refer to Manually importing the event synchronization class files and rule
set on page 479 for the commands to use to do this.
490
Chapter 22. Setting up event forwarding to Netcool/OMNIbus

If you are already using Netcool/OMNIbus to monitor events from other sources in your enterprise, you
can also view and manage situation events from a Tivoli Enterprise Monitoring Server in the
Netcool/OMNIbus console. Event integration requires Netcool/OMNIbus V7.x and Netcool/OMNIbus V7.x
Probe for Tivoli EIF.
Situation events are sent to Netcool/OMNIbus Probe for Tivoli EIF using the Tivoli Event Integration Facility
(EIF) interface. Events are sent through the Netcool/OMNIbus EIF Probe, which maps them to and then
inserts them into the Netcool/OMNIbus Object Server. When a Netcool/OMNIbus user acknowledges,
closes, or reopens a situation event, Netcool/OMNIbus sends those changes to the originating monitoring
server (see Figure 99).
Figure 99. Event flow and synchronization between Tivoli Monitoring and Netcool/OMNIbus. Events are sent through
the EIF probe to the OMNIbus server
Note: The EIF Probe and the OMNIbus Object Server do not have to be installed on the same machine.
Setting up event integration for Netcool/OMNIbus involves these tasks:
v Installing the event synchronization component on page 494
The event synchronization component enables changes in event status made on a Netcool/OMNIbus
Object Server to be sent back to the Tivoli Enterprise Monitoring Server and reflected on the Tivoli
Enterprise Portal. When you install the event synchronization component for Netcool/OMNIbus, a new
process, Situation Update Forwarder, is installed along with its supporting binary and configuration files.
This process is used to forward updates to the situation events back to the originating monitoring server.
On Windows, a Situation Update Forwarder service is also created.
v Configuring the Netcool/OMNIbus Object Server on page 502
You configure the Netcool/OMNIbus server to receive situation event information and reflect changes to
their status to the Netcool/OMNIbus console. You also configure the Object Server to send changes in
event status back from Netcool/OMNIbus to the monitoring server.
v Configuring the monitoring server to forward events on page 508
You configure the hub monitoring server to enable situation event forwarding and to define the default
event receiver.
v Customizing the OMNIbus configuration on page 509
After you have set up event integration, you can customize:
How events are mapped
How events are synchronized
v Defining additional monitoring servers to the Object Server on page 510
491
If you have multiple monitoring servers sending events to the same Netcool/OMNIbus Object Server,
you can add additional monitoring servers to the list that receive event status updates from the Object
Server after you have installed the event synchronization component.
The following products must be installed and configured before you install the event synchronization
component and configure event forwarding for Netcool/OMNIbus:
v IBM Tivoli Netcool/OMNIbus V7.x
v IBM Tivoli Netcool/OMNIbus V7.x probe for Tivoli EIF
v IBM Tivoli Monitoring V6.2.2
Event integration with Netcool/OMNIbus

The scenarios in this section illustrate various ways to forward situation events from one or more
monitoring servers to one or more Netcool/OMNIbus Object Servers (the event server).
Monitoring servers use the Tivoli Event Integration Facility (EIF) interface to forward situation events to
OMNIbus. The events are received by the Netcool/OMNIbus Probe for Tivoli EIF, which maps them to
OMNIbus events and then inserts them into the OMNIbus server. Updates to those events are also sent to
OMNIbus. When an OMNIbus user acknowledges, closes, or reopens a forwarded event, OMNIbus sends
those changes to back to the monitoring server that forwarded them.
One or more hub monitoring servers and a single Object Server

You can configure one or more monitoring servers to forward situation events to an event
server.Figure 100 on page 493 shows multiple hub monitoring servers that are configured to forward
situation events to the same event server. The event server sends situation updates back to the hub
monitoring server that is associated with that situation. Event forwarding must be enabled on each
monitoring server, and the EIF probe associated with the Object Server must be defined as the default EIF
receiver.
492
Figure 100. One or more hub monitoring servers connecting to a single event server
A single hub monitoring server and multiple Object Servers

You can configure one monitoring server to forward situations to different event servers. A single hub
monitoring server and multiple Object Servers shows a single hub monitoring server that is configured to
forward situation events to multiple event servers. The event servers send situation updates back to the
monitoring server from which they were forwarded.
Each event server to which events are forwarded must have an EIF probe associated with it and the event
synchronization component installed on it. You must specify for each situation the event server to which
the situation event is forwarded. (By default, all situation events are forwarded and all of them are
forwarded to the default EIF receiver, which is the probe defined to the monitoring server when event
forwarding is enabled.) You must also define additional EIF receivers to the monitoring server. See the IBM
Tivoli Monitoring: Administrator's Guide for information on defining multiple EIF receivers and customizing
event forwarding.
493
Figure 101. Single hub monitoring server and multiple event servers
Installing the event synchronization component

You install event synchronization on the host of the Netcool/OMNIbus Object Server using the IBM Tivoli
Monitoring V6.2.2 Tools DVD or DVD image. Installing event synchronization installs a new process,
Situation Update Forwarder, and its supporting binary and configuration files. This process is used to
forward updates to the situation events back to the monitoring server. On Windows, a Situation Update
Forwarder service is also created.
If you are forwarding situation events to multiple Object Servers, install event synchronization on each
server.
There are three methods for installing the event synchronization component:
v Installing from a wizard on page 495
v Installing from the command line on page 497
v Installing from the command line using a silent installation on page 500
494
Notes:
1. You cannot install event synchronization for Netcool/OMNIbus on the same system as an IBM Tivoli
Enterprise Console event server.
2. If the Object Server is running on Windows 2003 and you are planning to install the event
synchronization remotely (using a program such as Terminal Services to connect to that Windows 2003
computer), you need to run the change user /install command before you run the installation, which
puts the computer into the required "install" mode. After the installation, run the change user /execute
command to return the computer to its previous mode.
3. If you have a monitoring server on an operating system like UNIX or Linux, you must configure your
TCP/IP network services in the /etc/hosts file to return the fully qualified host name. See Host name
for TCP/IP network services on page 91 for more information.
4. Linux or UNIX users can run the EIF installer under either a root or a non-root userid.
Installing from a wizard

Take the following steps to install event synchronization using the installation wizard:
1. On the computer where the Object Server is installed, launch the event synchronization installation:
v On Windows, double-click the ESync2200Win32.exe file in the tec subdirectory on the IBM Tivoli
v On Linux or UNIX operating systems, change to the tec subdirectory on the IBM Tivoli Monitoring
V6.2.2 Tools DVD or DVD image and run the following command:
ESync2200operating_system.bin
where operating_system is the operating system you are installing on (aix, HP11, Linux,
linux390, or Solaris). For example, run the following command on an AIX computer:
ESync2200Aix.bin
If the installer cannot locate OMNIbus in its usual place, the following window is displayed. Click
Next to continue installing the event synchronization:
Figure 102. Installation of IBM Tivoli Monitoring and Tivoli Event Synchronization

3. Review the license agreement, select I accept the terms in the license agreement and click Next.
495
4. Click Next to install the synchronization component in the default location, or use the Browse button
to select another location and then click Next to continue.
5. Complete the fields in the installation windows using the configuration values described in Table 111
and click Next.
Table 111. Netcool/OMNIbus event synchronization configuration fields
Field
Description
Name of configuration file

configuration information is stored. The default name is
situpdate.conf.
Number of seconds to sleep when no new situation

updates

events, the Situation Update Forwarder rests for 3
seconds.
Number of bytes to use to save last event

value is 50.
URL of the TEMS SOAP Server

default value is cms/soap. This value is used to create the
URL to which Netcool/OMNIbus sends event status
update information. For example, http://
hostname:port///cms/soap, where hostname is the host
name of the monitoring server and port is the port.
Rate for sending SOAP requests to the monitoring server

from the OMNIbus probe via web services

value is 10 events.
Level of debug detail for log
The level of information for event synchronization that will

be logged. You have the following choices:
v Low (default)
v Medium
v Verbose
6. Complete the fields on the installation window about the files where events will be written using the
values described in Table 112 and click Next:
Table 112. Netcool/OMNIbus event synchronization configuration fields, continued
Field
Description
Maximum size of any single cache file, in bytes

not use commas when specifying this value (specify
50000 instead of 50,000).
Maximum number of caches files

Directory for cache files to be located

v On Windows: C:\Program Files\IBM\SitForwarder\
persistence.
v On UNIX: /opt/IBM/TEC/SitForwarder/persistence
496
7. Type the following information for each hub monitoring server with which you want to synchronize
events and click Add. You must specify information for at least one hub monitoring server.
Host name
The fully qualified host name for the computer where the monitoring server is running. The
name must match the information that will be in events coming from this monitoring server.
User ID
The user ID to access the computer where the monitoring server is running.
Password
The password to access the computer.
Confirmation
The password, again.
You can add information for up to 10 monitoring servers in this wizard. If you want to add additional
monitoring servers, do so after install by using the steps provided in Defining additional monitoring
servers to the event server on page 484.
8. When you have provided information about all of the monitoring servers, click Next.
A summary window is displayed.
9.
Click Next to proceed.

The installation begins and a progress indicator is displayed. When the installation is completed, a
message is displayed telling you that the installation has been successful.
10. Click Finish to exit the wizard.

Note: If any configuration errors occurred during installation and configuration, you are directed to a
log file that contains additional troubleshooting information.
Installing from the command line

Use the following steps to install the event synchronization from the command line on your event server:
On Windows:
ESync2200Win32.exe -console
On UNIX or Linux:
ESync2200operating_system.bin -console
ESync2200Aix.bin -console



497

Name of configuration file [situpdate.conf]
7. Press Enter to use the default configuration file, situpdate.conf. If you want to use a different
configuration file, type the name and press Enter.
Number of seconds to sleep when no new situation updates [3]
8. Type the number of seconds that you want to use for the polling interval. The default value is 3, while
the minimum value is 1. Press Enter.
Number of bytes to use to save last event [50]
9. Type the number of bytes to use to save the last event and press Enter. The default and minimum
value is 50.
URL of the CMS SOAP server [cms/soap]
10. Type the URL for the monitoring server SOAP Server and press Enter. The default value is cms/soap
(which you can use if you set up your monitoring server using the defaults for SOAP server
configuration).
Rate for sending SOAP requests to CMS from TEC via Web Services [10]
11. Type maximum number of event updates to send to the monitoring server at one time and press
Enter. The default and minimum value is 10.
Level of debug for log
[x] 1 low
[ ] 2 med
[ ] 3 verbose
To select an item enter its number, or enter 0 when you are finished: [0]
12. Type the level of debugging that you want to use and press Enter. The default is Low, indicated by an
x next to Low.
13. Type 0 when you have finished and press Enter.

Maximum size of any single cache file, in bytes [50000]
15. Type the maximum size, in bytes, for the cache file and press Enter. The default is 50000. Do not use
commas (,) when specifying this value.
Maximum number of cache files [10]
16. Type the maximum number of cache files to have at one time and press Enter. The default is 10,
while the minimum is 2.
On Windows, the following prompt is displayed:
Directory for cache files to reside [C:/Program Files/IBM/SitForwarder/persistence]
On UNIX, the following prompt is displayed:

Directory for cache files to reside [/opt/IBM/SitForwarder/persistence]
498
17. Type the directory for the cache files and press Enter. The default directory on Windows is
C:\Program Files\IBM\SitForwarder\persistence; on UNIX, /opt/IBM/SitForwarder/persistence.

Type the fully qualified host name for the computer where the monitoring server is running. This
should match the information that will be in events coming from this monitoring server. Press Enter.
User ID []
20. Type the user ID to use to access the computer where the monitoring server is running and press
Enter.
Password:
21. Type the password to access the computer and press Enter.
Confirmation:
22. Type the password again to confirm it and press Enter.

23. Repeat steps 19 to 22 for each monitoring server for which you want to receive events on this event
server.
When you have provided information for all the monitoring servers and you specified information for
less than 10 monitoring servers, press Enter to move through the remaining fields defining additional
monitoring servers. Do not specify any additional monitoring server information.
24. When you see the following prompt, type 1 and press Enter to continue:
Press 1 for Next, 2 for Previous, 3 to cancel or 4 to Redisplay [1]
The event synchronization is installed. The following prompt is displayed:

IBM Tivoli Monitoring and Tivoli Enterprise Console Event
Synchronization will
be installed in the following location:
/opt/IBM/SitForwarder
for a total size:
101.3 MB
Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]

The InstallShield Wizard has successfully installed IBM Tivoli
Monitoring and Tivoli Event Synchronization.
Choose Finish to exit the wizard.
499
Installing from the command line using a silent installation

On Windows:
ESync2200Win32.exe -options-template filename
On UNIX:
ESync2200operating_system.bin -options-template filename
ESync2200Aix.bin -options-template filename
3. Edit the output file to specify the values described in Table 113.
Notes:
b. You must specify the following values:
### -P installLocation="value"
### -W configInfoPanel3.fileLocn="value"
and the following information for at least one monitoring server:

cmdSvrsPnlNotGuiMode.hostname1,
cmdSvrsPnlNotGuiMode.userID1
cmdSvrsPnlNotGuiMode.pswd1
cmdSvrsPnlNotGuiMode.retypePswd1
If you do not specify any of the other values, the default values are used. If you specify values,
ensure that the values you specify meets the minimum required values. Otherwise, the installation
stops and an error is written to the log file.
Table 113. Netcool/OMNIbus event synchronization configuration values
Value
Description
installLocation
The directory into which the product should be installed. If

the directory path contains spaces, enclose it in double
quotes (" "). For example, to install the product to
C:\Program Files\My Product, use
-P installLocation="C:\Program Files
\My Product"
configInfoPanel.filename

configuration information is stored. The default file name
is situpdate.conf.
configInfoPanel.pollingInt

events, the process that forwards events rests for 3
seconds.
configInfoPanel.crcByteCnt

value is 50.
500
Table 113. Netcool/OMNIbus event synchronization configuration values (continued)

Value
Description
configInfoPanel.cmsSoapURL

default value is cms/soap. This value is used to create
the URL to which Netcool/OMNIbus sends event status
update information. For example, http://hostname:port///
cms/soap, where hostname is the host name of the
monitoring server and port is the port.
configInfoPanel.bufFlushRate

value is 10 events.
configInfoPanel.logLevel
The level of debug information for event synchronization

that is logged. You have the following choices:
v Low (default)
v Medium
v Verbose

not use commas when specifying this value (50,000
instead of 50000).


v On Windows: C:\Program Files\IBM\SitForwarder\
persistence.
v On UNIX: /opt/IBM/SitForwarder/persistence
The host name of each monitoring server that will send

cmsSvrsPnlNotGuiMode.hostname#
Note: The pound sign (#) stands for a number between 1 events to the event server. Specify up to 10 monitoring
and 10. For example, "hostname1".
servers.
cmsSvrsPnlNotGuiMode.userID#
The user ID for the monitoring server, identified in

hostname#, to use to access the computer where the
monitoring server is running.
cmsSvrsPnlNotGuiMode.pswd#
The password for the user ID used to access the

computer where the monitoring server is running.
cmsSvrsPnlNotGuiMode.retypePswd#
The password confirmation for the user ID.
cms_port
ITMPort
situation_fullname
ITMSitFullName
situation_group
ITMSitGroup
appl_label
ITMApplLabel
4. Save the file.

On Windows:
ESync2200Win32.exe -options filename -silent

On UNIX:
501
ESync2200operating_system.bin -options filename -silent
ESync2200Aix.bin -options filename -silent
When installation is complete, the results are written to the itm_tec_event_sync_install.log file. On UNIX,
this log file is always created in the /tmp directory. For Windows, this file is created in the directory defined
by the %TEMP% environment variable. To determine where this directory is defined for the current
command line window, run the following command:
echo %TEMP%
If you specified the monitoring servers in the silent installation configuration file, you might consider
deleting that file after installation, for security reasons. The passwords specified in the files are not
encrypted.
If you want to define additional monitoring servers (in addition to the one required monitoring server), run
the sitconfuser.sh command as described in Defining additional monitoring servers to the Object Server
on page 510. Repeat this command for each monitoring server.
If you specified your monitoring servers after the installation, you must stop and restart the Situation
Update Forwarder process manually. See for information.
v Configure OMNIbus to receive events and update event status as described in Configuring the
Netcool/OMNIbus Object Server.
v Configure the monitoring server to forward events to OMNIbus as described in Configuring the
Configuring the Netcool/OMNIbus Object Server

In this step you configure the OMNIbus Object Server to receive and map the situation event information
forwarded by a monitoring server and to reflect the events to the OMNIbus console. You also configure the
OMNIbus server to send event synchronization information back to the originating monitoring server and
configure the EIF probe to map the situation event attributes to OMNIbus event attributes. Optionally, you
can configure the event synchronization component to send error events to the OMNIbus system when
errors are detected in the synchronization process. The configuration comprises the following steps:
v
v
v
v
Configuring the OMNIbus server for program execution from scripts

Updating the OMNIbus database schema on page 503
Configuring the EIF probe on page 505
Configuring error event flow to OMNIbus (optional) on page 508
Configuring the OMNIbus server for program execution from scripts

To run the event synchronization program from SQL automation scripts for sending synchronization events
to the monitoring server, the OMNIbus event server must be running under process control and the
properties PA.Username and PA.Password must be set in OMNIHOME/etc/NCOMS.props file, where
OMNIHOME is the system-defined variable defining the installation location of OMNIbus.
For Linux and UNIX: By default, the process control grants access to the members of the default group
ncoadmin. For default configuration, create a ncoadmin group, and add root as a user to this group. The
PA.Username property must be set to the username for connecting to the process control agent. The
default value is root. The PA.Password property must be set to the password for the user connecting to
the process control agent. For the default setting, specify the password of the root user.
502
For Windows: The PA.Username property must be set to a Windows account name, and the
PA.Password property must be set to the password for that account.
Refer to OMNIbus documentation for more information on configuring OMNIbus server under process
control and for information on the nco_pa_crypt utility that encrypts the PA.Password property value.
After you change the PA.Username and PA.Password properties in the OMNIHOME/etc/NCOMS.props file,
perform the procedure below to restart the OMNIbus Object Server:
1. Stop the OMNIbus server:
v On Windows: In the Control Panel, open Administrative Tools, then Services. In the list of services,
double-click OMNIbus server, then click Stop.
v On UNIX: Issue the following command from command line
$OMNIHOME/bin/nco_pa_stop -process server_name
where:
$OMNIHOME
Is the system-defined variable defining the installation location of OMNIbus.
server_name
Is the OMNIbus Object Server name defined for process control.
2. Restart the OMNIbus server.
v On Windows: In the list of services, double-click OMNIbus server, then click Start.
v On UNIX: Issue the following command from command line:
$OMNIHOME/bin/nco_pa_start -process server_name
Updating the OMNIbus database schema

The command to configure OMNIbus pipes the SQL command set into the SQL command line tool and
performs the updates to the Object Server.
1. Update the Object Server database with the following commands:
v On Windows:
%OMNIHOME%\..\bin\redist\isql -U username
-P password
-S server_name
< path_to_file\itm_proc.sql
-P password
-S server_name
< path_to_file\itm_db_update.sql
-P password
-S server_name
< path_to_file\itm_sync.sql
where:
$OMNIHOME
Is the system-defined variable defining the installation location of OMNIbus
username
Is the OMNIbus Object Server user name
password
Is the OMNIbus Object Server password
503
server_name
path_to_file
Is the fully qualified path to the specified SQL file
v On UNIX:
$OMNIHOME/bin/nco_sql -user username
-password password
-server server_name
< path_to_file/itm_proc.sql
-password password
-server server_name
< path_to_file/itm_db_update.sql
-password password
-server server_name
< path_to_file/itm_sync.sql
where:
$OMNIHOME
username
password
server_name
path_to_file
Notes:
1. Object exists and "Attempt to insert duplicate row" errors will occur if the scripts were previously run.
These errors are harmless.
2. The schema updates in the itm_db_update.sql file add a number of columns to the alerts.status table
for the Object Server. If any Object Server gateways forward from the Object Server, consider adding
these columns to the gateway mapping file. Also, if the IBM Tivoli Monitoring fields will be viewed in
both Object Servers, run the schema updates on the other Object Server as well.
3. If you are integrating IBM Tivoli Monitoring and Tivoli Business Service Manager, add the Tivoli
Business Service Manager schema updates before you add the Tivoli Monitoring schema updates. If
you add the Tivoli Monitoring schema updates before the Tivoli Business Service Manager schema
updates, rerun the procedure above to add the IBM Tivoli Monitoring schema updates again to ensure
the latest definitions are used.
After updating the OMNIbus schema with the Tivoli Monitoring updates, run the Tivoli Business Service
Manager discover schema utility (rad_discover_schema). See the Tivoli Business Service Manager
Information Center for detailed instructions on using this utility: http://publib.boulder.ibm.com/infocenter/
tivihelp/v3r1/index.jsp?topic=/com.ibm.tivoli.itbsm.doc/welcome.htm.
After running the discover schema utility, remember to restart the Tivoli Business Service Manager
Dataserver. Failure to do so can cause connection problems.
4. If the OMNIbus Object Server is running on UNIX as a non-root user and the event synchronization
component is installed and run as either root or another user, verify that the user under which the
Object Server is running has write permission to the event_sync_install_dir\log directory prior to
updating the OMNIbus database schema.
504
Configuring the EIF probe

This step configures the probe with the rules for mapping situation events to OMNIbus events. Configuring
the mapping involves updating the tivoli_eif.rules file installed with the probe with the rules for IBM
Tivoli Monitoring events. If you are merely integrating Tivoli Monitoring with Netcool/OMNIbus, use the
contents of the tivoli_eif.rules file included with the synchronization component.
However, if you are integrating IBM Tivoli Monitoring with both Tivoli Business Service Manager and
Netcool/OMNIbus, use the tivoli_eif.rules file provided with Tivoli Business Service Manager's EIF
probe installation and the itm_event.rules and tbsm_eif_event.rules rules files included with the
synchronization component.
You must recycle the probe after you update any of the rules files.
The default mapping is shown in Table 114.
Table 114. Mapping of situation attributes to OMNIbus attributes
Situation attribute
OMNIbus Attribute
situation_name + situation_origin +situation_displayitem + Identifier (for ITM Problem)

event_class
situation_name + situation_origin + situation_displayitem
+ event_class + ITMResolution
Identifier (for ITMResolution)
situation_name
AlertKey
situation_origin
Node
situation_origin
NodeAlias
source
Agent
default
Type (20) (for ITMProblem)
situation_status = P and integration_type = U
Type (21) (for ITMResolution)
situation_status = D and integration_type = U
situation_status = N and integration_type = U
situation_displayitem
ITMDisplayItem
situation_status
ITMStatus
situation_time
ITMTime
situation_type
ITMSitType
situation_thrunode
ITMThruNode
situation_eventdata
ITMEventData
cms_hostname
ITMHostname
master_reset_flag
ITMResetFlag
integration_type
ITMIntType
event_class
AlertGroup
msg
Summary
tivoli_eif probe on +hostname()
Manager
6601
Class
505
Table 114. Mapping of situation attributes to OMNIbus attributes (continued)

Situation attribute
OMNIbus Attribute
severity
Severity
FATAL / 60 = Critical
CRITICAL / 50 = Critical
MINOR / 40 = Minor
WARNING / 30 = Warning
HARMLESS / 20 = Indeterminate
UNKNOWN / 10 = Indeterminate
INFORMATIONAL = Indeterminate
getdate
LastOccurrence/FirstOccurrence
date
TECDate
repeat_count
TECRepeatCount
fqhostname
TECFQHostname
hostname
TECHostname
cms_port
ITMPort
situation_fullname
ITMSitFullName
situation_group
ITMSitGroup
appl_label
ITMApplLabel
Take the following steps to update the tivoli_eif.rules file if you are not integrating with Tivoli Business
Service Manager:
1. Copy the contents of event_sync_install_dir\omnibus\tivoli_eif.rules (Windows) or
event_sync_install_dir/omnibus/tivoli_eif.rules (UNIX) to the following file on the machine where
the EIF probe is installed:
%OMNIHOME%\probes\os_dir\tivoli_eif.rules (Windows)
or
$OMNIHOME/probes/os_dir/tivoli_eif.rules (UNIX)
where:
OMNIHOME
Is a system-defined variable defining the installation location of OMNIbus.
os_dir
Is the operating system, such as Windows or AIX.
2. Stop the EIF probe.
v On Windows: In the Control Panel, open Administrative Tools, then Services. In the list of
services, double-click the EIF probe; then click Stop.
v On UNIX: Issue the following command from the command line
$OMNIHOME/bin/nco_pa_stop -process probe_name
where:
$OMNIHOME
probe_name
Is the OMNIbus EIF probe name defined for Process Control.
3. Restart the OMNIbus probe.
v On Windows: In the list of services, double-click OMNIbus EIF Probe; then click Start.
506
v On UNIX: Issue the following command from the command line:

$OMNIHOME/bin/nco_pa_start -process probe_name
Integrating with Tivoli Business Service Manager and Netcool/OMNIbus

If you are integrating IBM Tivoli Monitoring, Tivoli Business Service Manager, and Netcool/OMNIbus, the
Tivoli Business Service Manager EIF probe installation provides a tivoli_eif.rules file that contains EIF
probe rules for multiple products including IBM Tivoli Monitoring. Tivoli Business Service Manager also
provides .sql files for updating the OMNIbus database schema.
Before configuring the EIF probe, you must update the OMNIbus database schema with the schema
updates provided with Tivoli Business Service Manager and then follow them with the IBM Tivoli
Monitoring database schema updates described in the previous section.
v If you are using Tivoli Business Service Manager Version 4.2 or earlier, see the Tivoli Monitoring support
site for a technote that describes how to configure the OMNIbus Object Server and EIF probe to use
the latest version of the IBM Tivoli Monitoring .sql files and probe rules.
v If you are using Tivoli Business Service Manager Version 4.2.1, the Tivoli Business Service Manager
EIF probe installation creates a tivoli_eif.rules file that includes the itm_event.rules file. To replace
the itm_event.rules file provided by Tivoli Business Service Manager with the itm_event.rules file
included with the IBM Tivoli Monitoring synchronization component while still using the
tbsm_eif_event.rules file:
1. Copy the files as follows:
On Windows, copy files event_sync_install_dir\omnibus\tbsm\itm_event.rules and
tbsm_eif_event.rules to directory %OMNIHOME%\probes\os_dir on the machine where your EIF
probe is installed
On UNIX, copy files event_sync_install_dir/omnibus/tbsm/itm_event.rules and
tbsm_eif_event.rules to directory $OMNIHOME/probes/os_dir on the machine where your EIF
probe is installed
where:
OMNIHOME
os_dir
On Windows: In the Control Panel, open Administrative Tools, then Services. In the list of
On UNIX: Issue the following command from the command line
where:
$OMNIHOME
probe_name
On Windows: In the list of services, double-click OMNIbus EIF Probe; then click Start.
On UNIX: Issue the following command from the command line:
507
Configuring error event flow to OMNIbus (optional)

To send error events to the OMNIbus system when errors are detected in the event synchronization
process (or to use the sitconf refresh command to update event synchronization so it uses the latest
situation timeout configuration parameter), update the values for the following parameters in the
eventsync_install/omnibus/errorevent.conf file:
ServerName
ServerPort
where:
eventsync_install
Is the location where event synchronization program is installed (on Windows the default installation
directory is C:\Program Files\IBM\SitForwarder; on Linux and UNIX operating systems, the default
installation directory is /opt/IBM/SitForwarder).
ServerName
Is the name of the computer where the EIF probe is running.
ServerPort
Is the listening port for EIF probe. The default value is 9999.
Configuring the monitoring server to forward events

Before the monitoring server forwards any situation events to Netcool/OMNIbus, you must enable event
forwarding and define a default event destination.
Take the following steps to enable event forwarding for each hub monitoring server from which you want to
forward events to an OMNIbus Object Server:
For Windows monitoring servers only, do the following:
2.
3.
4.
5.
Right-click the monitoring server and click Reconfigure.

On the configuration options window, select Tivoli Event Integration Facility.
Click OK and OK.
Complete the following fields on the Event Server: Location and Port Number window and click OK:
Server or EIF Probe Location
Type the host name or IP address for the computer where the EIF probe is installed.
Port Number
Type the port number on which the probe is listening.
For Linux and UNIX monitoring servers: You configured the EIF probe and port information for the
Linux/UNIX monitoring server during installation, if you installed the monitoring server using the
configuration instructions in this installation guide. However, if you did not configure this information, see
Configuring the hub monitoring server on page 154 for the procedure.
Controlling event forwarding

The om_tec.config file controls the forwarding of events to IBM Tivoli Netcool/OMNIbus. It contains this
parameter:
BufferFlushRate=events_per_minute
Specifies the number of events that are sent per minute when the adapter has reestablished its
connection to Netcool/OMNIbus. Once the adapter has recovered the lost connection, if there are
events in the buffer, the events are sent at this rate per minute. The default value is 0, meaning all
events are sent in one burst.
508
If your environment can have a large number of open situation events, you may want to adjust this
parameter to control the rate at which events are sent to the event server. To edit this file and change this
parameter:
v On Windows:
2. Right-click Tivoli Enterprise Monitoring Server, and click Advanced Edit EIF Configuration.
v On Linux or UNIX, edit file install_dir/tables/hostname/TECLIB/ om_tec.config, where install_dir is
your Tivoli Monitoring installation directory and hostname is the name of the host running this monitoring
server.
Customizing the OMNIbus configuration

The get_config_parms procedure in the eventsync_install/omnibus/itm_proc.sql file defines three
configuration parameters:
set sit_ack_expired_def_action = 'REJECT'
set sit_resurface_def_action = 'ACCEPT'
set situpdate_conf_file = 'situpdate.conf'
The sit_ack_expired_def_action variable defines the action to be taken for an event by the OMNIbus
server when acknowledgement expiration information is received for an event from a monitoring server.
The default action is to reject the request. OMNIbus sends information to change the state of the event to
Acknowledge back to the monitoring server. If you want to change the action taken by the OMNIbus server
to accept the acknowledgement expiration, modify the statement to set sit_ack_expired_def_action =
'ACCEPT'.
The sit_resurface_def_action variable defines the action to be taken by the OMNIbus server when a
situation event has resurfaced. The default action of the OMNIbus server is to accept this request and
deacknowledge the event. If you want to change the action taken by OMNIbus server to reject the
resurface of the event, modify the statement to set sit_resurface_def_action = 'REJECT'. OMNIbus then
sends information back to the monitoring server to change the state of the event back to Acknowledge.
The situpdate_conf_file variable specifies the name of the configuration file to be used by the SitUpdate
Forwarder. If you want to change the name of the configuration file, modify the statement to set
situpdate_conf_file = 'newname.conf'.
The eventcmd procedure in the event_sync_install_dir/omnibus/itm_proc.sql file may also need
modification:
v The executable should not have any spaces. For example, on Windows, change C:\Program
Files\IBM\SitForwarder\omnibus\eventcmd.bat to C:\Progra~1\IBM\SitForwarder\omnibus\
eventcmd.bat.
v The host should be changed to reflect the actual host name on which the Object Server is running.
v The user and group may need to be changed from the default settings if the executable cannot be run
as root.
After modifying itm_proc.sql, issue the following command:
v For Windows:
-P password
-S server_name
v For UNIX:
509

-password password
-server server_name
where:
OMNIHOME
username
password
server_name
path_to_file
Defining additional monitoring servers to the Object Server

To add additional monitoring servers to the list that can receive event status updates from the
Netcool/OMNIbus Object Server, issue the sitconfuser command as described in the following steps.
Ensure event synchronization is configured for both the fully qualified host name and the short host name
of the monitoring server.
v On Windows, change to the %SystemDrive%\Program Files\SitForwarder\bin directory and enter the
following command:
sitconfuser.cmd add serverid=server userid=user
pathc=path_to_conf_file type=OMNIBUS
password=password
where:
server
Is the fully qualified host name of the monitoring server.
user
Is the user ID used to access the computer where the monitoring server is running.
password
Is the password used to access the host computer.
path_to_conf_file
Is the directory containing the situser.conf file.
Repeat this command to add short host name information for the same monitoring server by specifying
the short host name value for the serverid parameter.
v On UNIX, change to the /opt/IBM/SitForwarder/bin directory and enter the following command:
sitconfuser.sh add serverid=server userid=user
pathc=path_to_conf_file type=OMNIBUS
password=password
where:
server
Is the fully qualified host name of the monitoring server.
user
Is the user ID used to access the computer where the monitoring server is running.
510
password
Is the password used to access the host computer.
path_to_conf_file
Is the directory containing the situser.conf file.
Repeat this command to add short host name information for the same monitoring server by specifying
the short host name value for the serverid parameter.
Repeat this step for each monitoring server that you want to add.
You can also delete monitoring servers. See the IBM Tivoli Monitoring: Command Reference for the full
syntax of this command.
Verifying installation and configuration

Take the following steps to verify that the event synchronization component has been installed and event
integration has been configured successfully.
1. Stop and restart the hub Tivoli Enterprise Monitoring Server:
v On Windows computers:
a. Start the Manage Tivoli Enterprise Monitoring Services utility (Start > (All) Programs > IBM
Tivoli Monitoring > Manage Tivoli Monitoring Services).
b. Right-click the hub monitoring server and select Recycle from the popup menu.
v On UNIX and Linux computers, enter the following commands:
$ITM_INSTALL_PATH/bin/itmcmd stop tems_server
$ITM_INSTALL_PATH/bin/itmcmd start tems_server
where:
$ITM_INSTALL_PATH
Is the system variable defining the installation location of the monitoring server.
2.
tems_server
Is the host name of the computer where the monitoring server is installed (the host where you
are executing this command).
On the OMNIbus server machine, run the following command to start the OMNIbus console:
$OMNIHOME/bin/nco_event
3. Refresh the event view in the OMNIbus console and check for situation events from the monitoring
server.
Starting and stopping the Situation Update Forwarder

To send event updates to a monitoring server, you must start the Situation Update Forwarder. This process
is started automatically when the event server starts. To start the process manually, change to the
install_esynch/bin directory and run the following command:
On Windows:
startSUF.cmd
On UNIX:
startSUF.sh
511
To stop the process, run the following command:

On Windows:
stopSUF.cmd
On UNIX:
stopSUF.sh
On Windows, you can also start and stop the Tivoli Situation Update Forwarder service to start or stop the
forwarding of event updates. You can start and stop this service either from the Windows Administrative
Tools > Services utility or with the following commands:
net start situpdate
net stop situpdate
Upgrading to Tivoli Event Synchronization version 2.2.0.0

Upgrading event synchronization for IBM Tivoli Netcool/OMNIbus installs the newest version of the
Situation Update Forwarder, and replaces any scripts that have been updated since the base version.
Upgrading consists of these steps:
v Upgrading from a wizard
v Updating the IBM Tivoli Netcool/OMNIbus database schema
v Replacing the default deduplication trigger
v Updating the EIF probe
These steps are detailed in the following sections.
Upgrading from a wizard

Follow these steps to upgrade event synchronization via the installation wizard.
1. On the host of the Object Server, launch the event synchronization upgrade installation.
v On Windows, double-click the ESUpgrade22win32.exe file in the tec subdirectory on the IBM Tivoli
v On Linux or UNIX, change to the tec subdirectory on the IBM Tivoli Monitoring V6.2.2 Tools DVD or
DVD image, and run the following command:
ESUpgrade22operating_system.bin
where operating_systemis the operating system you are installing on (aix, HP11, Linux, linux390, or
Solaris).
For example, run the following command on an AIX computer:
ESUpgrade22Aix.bin

3. Select I accept the terms in the license agreement, and click Next.
A window is displayed indicating the installation is about to proceed.
4. Click Next to proceed with the installation.
A progress indicator shows the progress of the installation.
5. Click Finish to exit the installer.
Updating the OMNIbus database schema

The upgrade installation installs new SQL scripts to the omnibus subdirectory of the installation directory.
These updates need to be applied to ensure that the event synchronization is up to date.
v On Windows:
512
-P password
-S server_name
-P password
-S server_name
< path_to_file\itm_db_update.sql
-P password
-S server_name
< path_to_file\itm_sync.sql
where:
$OMNIHOME
username
password
server_name
path_to_file
v On UNIX:
-password password
-server server_name
-password password
-server server_name
< path_to_file/itm_db_update.sql
-password password
-server server_name
< path_to_file/itm_sync.sql
where:
$OMNIHOME
username
password
server_name
path_to_file
513
Notes:
1. Object exists and "Attempt to insert duplicate row" errors will occur if the scripts were previously run.
These errors are harmless.
2. The schema updates in itm_db_update.sql add a number of columns to the alerts.status table for the
Object Server. If any Object Server gateways forward from the Object Server, consider adding these
columns to the gateway mapping file. Also, if the IBM Tivoli Monitoring fields will be viewed in both
Object Servers, run the schema updates on the other Object Server as well.
3. If you are integrating IBM Tivoli Monitoring and Tivoli Business Service Manager, add the Tivoli
Business Service Manager schema updates before you add the Tivoli Monitoring schema updates. If
you add the Tivoli Monitoring schema updates before the Tivoli Business Service Manager schema
updates, rerun the procedure above to add the IBM Tivoli Monitoring schema updates again to ensure
the latest definitions are used.
After updating the OMNIbus schema with the Tivoli Monitoring updates, run the Tivoli Business Service
Manager discover schema utility (rad_discover_schema). Refer to the Tivoli Business Service Manager
Information Center for detailed instructions on using this utility: http://publib.boulder.ibm.com/infocenter/
tivihelp/v3r1/index.jsp?topic=/com.ibm.tivoli.itbsm.doc/welcome.htm.
After running the discover schema utility, remember to restart the Tivoli Business Service Manager
Dataserver. Failure to do so can cause connection problems.
4. If the OMNIbus Object Server is running on UNIX as a non-root user and the event synchronization
component is installed and run as either root or another user, verify that the user under which the
Object Server is running has write permission to the event_sync_install_dir\log directory prior to
updating the OMNIbus database schema.
Replacing the default deduplication trigger

With previous versions of event synchronization for IBM Tivoli Netcool/OMNIbus, the default deduplication
trigger was overwritten. This caused customers to lose any customizations they had made to the trigger. If
event synchronization was installed previously, follow these steps to apply the default deduplication trigger
to the Object Server.
1. Open the automation.sql file located at %OMNIHOME%\etc\automation.sql (Windows) or
$OMNIHOME/etc/automation.sql (UNIX).
2. Locate the command that creates the deduplication trigger. For example:
create or replace trigger deduplication
group default_triggers
priority 1
comment 'Deduplication processing for ALERTS.STATUS'
before reinsert on alerts.status
for each row
begin
set old.Tally = old.Tally + 1;
set old.LastOccurrence = new.LastOccurrence;
set old.StateChange = getdate();
set old.InternalLast = getdate();
set old.Summary = new.Summary;
set old.AlertKey = new.AlertKey;
if (( old.Severity = 0) and (new.Severity > 0))
then
set old.Severity = new.Severity;
end if;
end;
go
3. Copy this command to a temporary file. For this example, the temporary file is /tmp/dedup.sql.
4. Run the command to replace the deduplication trigger.
v On Windows:
%OMNIHOME%\..\bin\redist\isql -U username -P password -S server_name < C:\tmp\dedup.sql
514
v On UNIX:
$OMNIHOME/bin/nco_sql -user username -password password -server server_name < /tmp/dedup.sql
where:
OMNIHOME
username
password
server_name
Updating the EIF probe

The upgrade installation creates a new probe rules file in the omnibus subdirectory of the installation
directory that needs to be applied to the EIF probe to ensure event synchronization is up to date. Follow
these steps to update the rules file:
1. Copy the contents of event_sync_install_dir\omnibus\tivoli_eif.rules (Windows) or
event_sync_install_dir/omnibus/tivoli_eif.rules (UNIX) to the following file:
v On Windows:
%OMNIHOME%\probes\os_dir\tivoli_eif.rules
v On UNIX:
$OMNIHOME/probes/os_dir/tivoli_eif.rules
where:
OMNIHOME
os_dir
2. Stop the EIF probe:
v On Windows:
a. In the Control Panel, open Administrative Tools, then Services.
b. In the list of services, double-click the EIF probe; then click Stop.
v On UNIX, issue the following command from the command line:
where:
$OMNIHOME
probe_name
3. Restart the OMNIbus probe:
v On Windows, in the list of services, double-click OMNIbus EIF Probe; then click Start.
v On UNIX, issue the following command from the command line:
515
Integrating IBM Tivoli Monitoring with Tivoli Business Service Manager and
Netcool/OMNIbus
If you are integrating IBM Tivoli Monitoring, Tivoli Business Service Manager, and Netcool/OMNIbus, the
Tivoli Business Service Manager EIF probe installation provides a tivoli_eif.rules file that contains EIF
probe rules for multiple products including IBM Tivoli Monitoring. Tivoli Business Service Manager also
provides .sql files for updating the OMNIbus database schema.
Before configuring the EIF probe, you must update the OMNIbus database schema with the schema
updates provided with Tivoli Business Service Manager and then follow them with the IBM Tivoli
Monitoring database schema updates described in the previous section.
v If you are using Tivoli Business Service Manager Version 4.2 or earlier, refer to the Tivoli Monitoring
support site for a tech note that describes how to configure the OMNIbus Object Server and EIF probe
to use the latest version of the IBM Tivoli Monitoring .sql files and probe rules.
v If you are using Tivoli Business Service Manager Version 4.2.1, the Tivoli Business Service Manager
EIF probe installation creates a tivoli_eif.rules file that includes the itm_event.rules file. To replace
the itm_event.rules file provided by Tivoli Business Service Manager with the itm_event.rules file
included with the IBM Tivoli Monitoring synchronization component while still using the
tbsm_eif_event.rules file:
1. Copy the files as follows:
On Windows, copy files event_sync_install_dir\omnibus\tbsm\itm_event.rules and
tbsm_eif_event.rules to directory %OMNIHOME%\probes\os_dir on the machine where your EIF
probe is installed
On UNIX, copy files event_sync_install_dir/omnibus/tbsm/itm_event.rules and
tbsm_eif_event.rules to directory $OMNIHOME/probes/os_dir on the machine where your EIF
probe is installed
where:
OMNIHOME
os_dir
On Windows: In the Control Panel, open Administrative Tools, then Services. In the list of
On UNIX: Issue the following command from the command line
where:
$OMNIHOME
probe_name
On Windows: In the list of services, double-click OMNIbus EIF Probe; then click Start.
On UNIX: Issue the following command from the command line:
516
Chapter 23. Monitoring your operating system via a System

Monitor Agent
A special type of Tivoli Management Services agent, the System Monitor Agent, allows you to send OS
monitoring data directly to Netcool/OMNIbus without first passing the data to a Tivoli Enterprise Monitoring
Server. These lighter-weight agents (they require a much smaller footprint than full-function Tivoli
Monitoring OS agents) are configured locally to the agent node, which makes them ideal for customers
who want fully autonomous monitoring of their desktop operating systems in environments where disk
space or image transmission bandwidth is in short supply. This configuration enables them to be deployed
autonomously (that is, they do not require the support of a Tivoli Enterprise Monitoring Server): they send
SNMP event information directly to an SNMP Event Collector such as IBM Tivoli Netcool/OMNIbus. In
addition, using SSL (Secure Sockets Layer), they can send event data directly to OMNIbus, thus making a
monitoring server unnecessary even for event processing (see Event forwarding from autonomous
agents on page 53).
These agents can run in agent-only environments that lack the standard Tivoli Monitoring servers (the
Tivoli Enterprise Monitoring Server and the Tivoli Enterprise Portal Server). These agents, which run on
Windows and on Linux/UNIX, effectively replace the OMNIbus System Service Monitors for monitoring of
desktop operating systems. IBM Netcool System Service Monitor users may find these agents appropriate
as an upgrade path.
Note: No other agents should be installed alongside these new system monitor agents, nor should they
be installed on nodes where there is already a Tivoli Monitoring component in operation. Agents
created with version 6.2.2 (or subsequent) of the Agent Builder tool are the only exception to this
rule.
To support these new System Monitor Agents, there is a new silent installation process for both Windows
and Linux/UNIX sites, along with operating system-specific configuration steps. There are also new
uninstallation processes for these Windows and Linux/UNIX OS agents. All these processes are detailed in
this chapter.
Background information about agent autonomy on page 52 introduces the concept of agents that operate
autonomously (that is, without a connection to a Tivoli Enterprise Monitoring Server). For additional
information, see the IBM Tivoli Monitoring: Administrator's Guide.
Installing the System Monitor Agent on Windows systems

The System Monitor Agent packages provide IBM Tivoli Monitoring OS agents whose reduced footprint
makes them ideal for customers who need fully autonomous OS agent monitoring in environments where
disk space or image transmission bandwidth is in short supply. These OS agent packages offer a
significantly reduced bundle size and installed footprint.
The System Monitor Agents support direct Netcool/OMNIbus integration without a connection to a Tivoli
Enterprise Monitoring Server. The System Monitor Agent instead sends SNMP alerts directly to an SNMP
Event Collector such as Netcool/OMNIbus.
Installation times are significantly reduced due to the small size of the System Monitor Agents. These
agents use simplified flat-file, machine-independent configuration. Configuration files no longer contain
references to the host name or system where the file is located; with this change, you can share and
transport common configuration files across your network.
Note: A System Monitor Agent must not be installed into a system where existing IBM Tivoli Monitoring
components (including other monitoring agents) are already installed, with this exception: Agents
built with Agent Builder V6.2.2 or subsequent may be installed alongside a System Monitor Agent,
517
provided they run in the same mode as the Windows System Monitor Agent itself: if the Windows
agent runs in 32-bit mode, only 32-bit Agent Builder agents are supported; if the Windows agent
runs in 64-bit mode, only 64-bit Agent Builder agents are supported.
The following 64-bit Windows environments support 64-bit System Monitor Agents:
v Windows Server 2003 Standard Edition R2 on x86-64 CPUs in 64-bit mode
v Windows Server 2003 Enterprise Edition R2 on x86-64 CPUs in 64-bit mode
v Windows Server 2003 Datacenter Edition R2 on Intel x86-64 CPUs in 64-bit mode
v Windows Vista Enterprise Edition on Intel x86-64 CPUs in 64-bit mode
v Windows Server 2008 Standard Edition on Intel x86-64 CPUs in 64-bit mode
v Windows Server 2008 Enterprise Edition on Intel x86-64 CPUs in 64-bit mode
v Windows Server 2008 Datacenter Edition on Intel x86-64 CPUs in 64-bit mode
You must invoke a silent installation procedure to install the System Monitor Agent that monitors the
Windows operating system:
silentInstall.cmd -p response_file
where:
response_file
is the name of the updated version of the nt_silent_install.txt response file you created that
names the components to be installed and where.
On completion of the install script, the OS agent for Windows is installed, configured with a default
configuration, and started.
518
Contents of the silent response file

The silent response file supports the following records:
comments
Any line beginning with a semicolon (;) is treated as a comment.
Keyword=value
These lines define variables in the silent response file. Do not include spaces before the keyword
or immediately before or after the equal sign (=). Values must not contain the following
characters:
$
=
|
Note: By default the silentInstall.cmd installation script checks the processor architecture on
which it is running; if it discovers it is running on a 64-bit x86_64 CPU, silentInstall.cmd
installs the System Monitor Agent in 64-bit mode. Otherwise the agent is installed in 32-bit
mode.
To force installation of the 32-bit System Monitor Agent on an x86_64 CPU, set variable
OS_ARCH to 32 in the nt_silent_response.txt file. (OS_ARCH can also be set to 64, to
force installation of a 64-bit agent. If OS_ARCH is blank or unspecified, the installer
determines which agent to install based on the host processor.)
The silent response file supports the following variables:
License Agreement
(Required) This variable accepts the license agreement for the System Monitor Agent. In the
sample response file, simply uncomment the line containing the License Agreement variable, or
set the variable to I agree to use the software only in accordance with the installed license.
Install Directory
(Required) This variable specifies the directory where the System Monitor Agent will be installed.
Characters supported for the Install Directory are alphanumeric characters, underscore (_), and
hyphen (-).
Chapter 23. Monitoring your operating system via a System Monitor Agent
519
Contents of the silent response file (cont'd)

EncryptionKey
(Optional) This variable sets the encryption key used for storing passwords and other protected
content. The default value if not specified is IBMTivoliMonitoringEncryptionKey.
Notes:
1. Do not
&
|
'
=
$

ampersand
pipe
single quote
equal sign
dollar sign

2. Ensure that you document the value you use for the key. Use this key during the installation
of any components that communicate with this monitoring server.
InstallLog
(Optional) This variable overrides the default location of the installation log created by the
silentInstall.cmd command. The default value if not specified is %CANDLE_HOME%\InstallITM\
ibm_tivoli_micro_install.log. In case of an installation error where the installation directory
was not created, the installation log will be created in the %TEMP% directory as
ibm_tivoli_micro_install.log. Characters supported for the InstallLog are alphanumeric
characters, underscore (_), and hyphen (-).
A sample nt_silent_install.txt response file can be found in directory \agents\
system_monitor_agent\WINDOWS\ on the Agents DVD.
Configuring the System Monitor Agents on Windows

Environmental configuration for the autonomous OS agents is unchanged on Windows: Configuration
parameters are contained in the agent's ENV file in the InstDir\tmaitm6 directory, where InstDir is your
installation directory. By directly editing this file, you can modify existing variables within that file or append
additional environment variables.
User-defined local configuration files:
These configuration files are stored in a separate local configuration directory, InstDir\localconfig\pc,
where pc is the agent's two-character product code. This segregation simplifies agent configuration
through the use of flat files. It also segregates your user configurations, which preserves them during
agent upgrade. They also allow redistribution of a configured agent to other systems while ensure their
configurations remain identical.
To modify the default location of the operational configuration files, perform the following steps:
1. Edit the agent's ENV file (for example, KNTENV for the Windows OS agent).
2. Add or modify the IRA_LOCALCONFIG_DIR parameter to specify a different local configuration
directory location.
After you have modified the ENV file and saved it, recycle the agent to implement your updated
configuration.
520
Note: On Windows, there are new CLI commands to start and stop an agent:
%CANDLE_HOME%\InstallITM\itmcmd.cmd agent start nt
%CANDLE_HOME%\InstallITM\itmcmd.cmd agent stop nt
Private situation configuration files:

If a correctly named private situation configuration file is present in the System Monitor Agent's local
configuration directory when the agent is started, the agent will run the private situations that the file
defines. The file must be named pc_situations.xml, where pc is the agent's two-character product code.
You can use the IRA_PRIVATE_SITUATION_CONFIG parameter to specify a different file name or
location. This variable is resolved relative to the IRA_LOCALCONFIG_DIR, or you can specify a fully
qualified file name.
For more information about the private situation configuration files, see the IBM Tivoli Monitoring:
SNMP trap configuration files:
If a correctly named trap configuration file is present in the System Monitor Agent's local configuration
directory when the agent is started, the agent will emit the SNMP alerts that the file defines. The file must
be named pc_trapcnfg.xml, where pc is the agent's two-character product code.
You can use the IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG parameter to specify a different file name
or location. This variable is resolved relative to the IRA_LOCALCONFIG_DIR, or you can specify a fully
qualified file name.
For more information about SNMP trap configuration files, see the IBM Tivoli Monitoring: Administrator's
Guide.
Uninstalling the Windows System Monitor Agent

There is a separate procedure for uninstalling the System Monitor Agent that monitors the Windows
operating system and deleting the directory where it is stored. Issue the following command:
%CANDLE_HOME%\InstallITM\uninstall.cmd [-f]
You are prompted to confirm your request to uninstall the agent. Respond Y to continue the uninstallation.
The -f option forces the uninstallation command to bypass the confirmation prompt.
If the command is invoked while the current working directory is %CANDLE_HOME%\InstallITM, the directory
is not deleted; you must delete it manually.
Notes:
1. Uninstalling the Windows operating system agent also uninstalls all Agent Builder agents installed in
the same environment.
2. Directories are not removed on Microsoft Windows systems if the command that attempts to remove it
is running from the directory being removed or if a file is locked within that directory. Thus, if you run
uninstall.cmd from %CANDLE_HOME%\BIN, the directory is not removed; you must remove it yourself.
Before running uninstall.cmd, it is recommended that you first close all processes (such as command
prompts and text editors) currently accessing subdirectories of %CANDLE_HOME%. Then run the
uninstall.cmd command from outside of %CANDLE_HOME% . Specify a fully qualified path.
If uninstall.cmd cannot remove a subdirectory, it displays the following message:
directory may have to be removed manually after this script completes.
521
This same message also is written to the uninstallation log file,

%TEMP%\IBM_Tivoli_Monitoring_System_Monitor_Agent_uninstall.log.
Installing the System Monitor Agent on Linux or UNIX systems

The System Monitor Agent packages provide IBM Tivoli Monitoring operating-system agents whose
reduced footprint makes them ideal for customers who need fully autonomous OS agent monitoring in
environments where disk space or image transmission bandwidth is in short supply. These System Monitor
Agent packages offer a significantly reduced bundle size and installed footprint.
The System Monitor Agents support direct Netcool/OMNIbus integration without a connection to a Tivoli
Enterprise Monitoring Server. The System Monitor Agent instead sends SNMP alerts directly to an SNMP
Event Collector such as Netcool/OMNIbus.
Installation times are significantly reduced due to the small size of the agents. System monitor agents use
simplified flat-file, machine-independent configuration. Configuration files no longer contain references to
the host name or system where the file is located; with this change, you can share and transport common
configuration files across your network.
Note: A System Monitor Agent must not be installed into a system where existing IBM Tivoli Monitoring
components (including other monitoring agents) are already installed, with this exception: Agent
Builder agents built with Agent Builder V6.2.2 or subsequent may be installed alongside a System
Monitor Agent.
There is a silent installation procedure that you must invoke to install these autonomous agents that
monitor the Linux and UNIX operating systems:
silentInstall.sh -h installation_dir -p response_file
where:
installation_dir
is the directory on the target machine where the System Monitor Agent is to be installed.
response_file
is the name of the response file you created that names the components to be installed and where.
To verify the installation, enter this command:
InstDir/bin/cinfo -i
where InstDir is the directory where you installed the System Monitor Agent. The list of installed agent
components is displayed, as shown in Figure 103 on page 523.
522
Figure 103. Output of the cinfo command
If no agents are listed, check the installation logs for more information.
523
Contents of the silent response file

The silent response file supports the following records:
comments
Any line beginning with a hash mark (#) is treated as a comment.
Keyword=value
These lines define variables in the silent response file. Do not include spaces before the keyword
or immediately before or after the equal sign (=). Values must not contain the following
characters:
$
=
|
The silent response file supports the following variables:
License_Agreement
(Required) This variable accepts the license agreement for the System Monitor Agent. In the
sample response file, simply uncomment the line containing the License Agreement variable, or
set the variable to I agree to use the software only in accordance with the installed license.
INSTALL_PRODUCT
(Required) Identifies the product you want installed; specify lz for Linux for ux for UNIX.
INSTALL_FOR_PLATFORM
(Optional) Identifies the platform for which the product should be installed; see Table 129 on page
568. If left commented out, the installer will use the platform of the machine on which the
installation is performed.
INSTALL_ENCRYPTION_KEY
(Optional) This variable sets the encryption key used for storing passwords and other protected
content. The default value if not specified is IBMTivoliMonitoringEncryptionKey.
Notes:
1. Do not
&
|
'
=
$

ampersand
pipe
single quote
equal sign
dollar sign

2. Ensure that you document the value you use for the key. Use this key during the installation
of any components that communicate with this monitoring server.
INSTALL_IGNORE_RUNNING_PROCESSES
If set to n, this keyword aborts the installation of running IBM Tivoli Monitoring processes. If this
parameter is set to y, the installation stops the running processes, installs the requested product,
and restarts the processes that were running.
Sample lz_silent_install.txt and ux_silent_install.txt response files can be found in directory
/agents/system_monitor_agent/unix/ on the Agents DVD.
524
Configuring the System Monitor Agents on Linux or UNIX

The autonomous OS agents do not use the pc.ini files (where pc is the product code) for configuration.
Instead these System Monitor Agents follow a new configuration model based on flat files. These files are
designed to segregate and preserve your user configuration, which simplifies agent upgrade. They also
allow redistribution of a configured agent to other systems while ensuring the original configuration is
exactly duplicated.
The System Monitor Agents' environment files are stored in the InstDir/config directory, where InstDir is
your installation directory. When the agent is installed, two files are added to this directory:
.global.environment
This file contains IBM Tivoli Monitoring-defined global environment settings that are available to all
monitoring agents that use the same installation directory. User modifications should not be made
to this file, as the changes may not be preserved in future upgrades. Instead, make your global
user configuration changes in the global.environment file described below.
.pc.environment
Here pc is the two-character IBM Tivoli Monitoring product code (for example, .ux.environment is
the product-provided UNIX System Monitor Agent environment configuration file, and
.lz.environment is the Linux System Monitor Agent environment configuration file). These files
contain product-defined, agent-specific environment settings that are available only to the pc
agents running in the same installation directory. Again, user modifications should not be made to
this file, as the changes may not be preserved in future upgrades. Instead, make your user agent
configuration changes in the pc.environment file described below.
Values defined in the .pc.environment files override those defined in the global environment files.
In the InstDir/config directory (where InstDir is your installation directory), you may create custom
environment files that override the environment settings defined in the .global.environment and
.pc.environment files. These user customization are preserved during future product upgrades. These files
are:
global.environment
This file is not created when the System Monitor Agent is installed but must be created by you:
1. Copy the IBM Tivoli Monitoring-supplied .global.environment file to global.environment.
2. Delete all entries that do not need to be customized.
3. Add any custom global configuration variables that should be available to all agents running in
the same installation directory.
User modifications should be made to this file as these changes will never be overwritten by future
upgrades. Values specified in the global.environment configuration file override those in both the
.global.environment file and the .pc.environment.
pc.environment
This file is not created when the System Monitor Agent is installed but must be created by you:
1. Copy the IBM Tivoli Monitoring-supplied .pc.environment file to pc.environment.
2. Delete all entries that do not need to be customized.
3. Add any agent-specific configuration variables that should be available to all pc agents running
in the same installation directory.
User modifications should be made to this file as these changes will never be overwritten by future
upgrades. Values specified in the user pc.environment file override all others.
525
User-defined local configuration files:

These configuration files are stored in a separate local configuration directory, InstDir/localconfig/pc,
and include this parameter:
IRA_LOCALCONFIG_DIR
Specifies a different local configuration directory. You may want to set the
IRA_LOCALCONFIG_DIR parameter in the pc.environment file so each agent will have its own
unique IRA_LOCALCONFIG_DIR setting. Alternatively, setting the IRA_LOCALCONFIG_DIR in the
global.environment file allows all agents to share the same IRA_LOCALCONFIG_DIR setting.
Private situation configuration files:
If a correctly named private situation configuration file is present in the System Monitor Agent's local
configuration directory when the agent is started, the agent will run the private situations that the file
defines. The file must be named pc_situations.xml, where pc is the agent's two-character product code.
The IRA_PRIVATE_SITUATION_CONFIG environment variable may be used to specify a different file
name or location. This variable is resolved relative to the IRA_LOCALCONFIG_DIR directory, or you may
specify a fully qualified filename.
For more information about the private situation configuration files, see the IBM Tivoli Monitoring:
SNMP trap configuration files:
If a correctly named trap configuration file is present in the System Monitor Agent's local configuration
directory when the agent is started, the agent will emit the SNMP alerts that the file defines. The file must
be named pc_trapcnfg.xml, where pc is the agent's two-character product code.
The IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG environment variable may be used to specify a
different file name or location. This variable is resolved relative to the IRA_LOCALCONFIG_DIR directory,
or you may specify a fully qualified filename.
For more information about SNMP trap configuration files, see the IBM Tivoli Monitoring: Administrator's
Guide.
Uninstalling the Linux or UNIX System Monitor Agent

There is a separate, manual procedure for uninstalling the System Monitor Agent that monitors the Linux
or UNIX operating system:
1. Stop the agent by invoking either of the following commands:
v For Linux, specify:
InstDir/bin/itmcmd agent stop lz
v For UNIX, specify:

InstDir/bin/itmcmd agent stop ux
where InstDir is the directory where you installed the System Monitor Agent.
2. Stop any other agents running from the same InstDir.
3. Issue one of the following commands :
InstDir/bin/uninstall.sh
or:
InstDir/bin/uninstall.sh REMOVE EVERYTHING
526
Invoking the uninstall.sh script with the REMOVE EVERYTHING parameter removes all agent files and
deletes the installation subdirectory tree.
On UNIX and Linux, you can uninstall multiple, individual agents by listing each one in the uninstall.sh
command.
Note: Uninstalling the UNIX or Linux OS System Monitor Agent also removes common files that are
necessary for Agent Builder agents to function. If you are uninstalling the UNIX or Linux OS system
monitor agent, you must also uninstall any Agent Builder agents in the same environment.
Defining common configuration parameters: accessing centralized

configuration information
System Monitor Agents are started at the end of their silent installation. Unless private configuration files
exist for them, these agents run but do not analyze situations or send events. Centralized configuration
allows an agent to retrieve these files from the centralized configuration server and to begin using them
immediately. You define these parameters in the pc_silent_install.txt silent response file that is used
when installing a System Monitor Agent.
The System Monitor Agent installation process uses entries in the silent response file to create entries in
the agent's environment file, based on statements of this form: SETENV_parameter=value statements
create parameter=value statements in the agent's environment file, whereas SETENCR_parameter=value
create parameter={AES256:keyfile:a}encryptedvalue statements.
Example: These silent response file entries connect to a centralized configuration server running on the
node named linuxhost:
SETENV_IRA_CONFIG_SERVER_URL= http://linuxhost:1920///linuxhost_lz/linuxhost_lz/
SETENV_IRA_CONFIG_SERVER_USERID=itmuser
SETENCR_IRA_CONFIG_SERVER_PASSWORD=password
SETENV_IRA_CONFIG_SERVER_FILE_PATH=initloadlist/@PRODUCT@
SETENV_IRA_CONFIG_SERVER_FILE_NAME=cnfglist.xml
Agents recognize the following keywords and substitute for them runtime values retrieved from the client:
@PRODUCT@
Agent's lowercase, two-letter product code. Example: For a Windows OS agent,
@PRODUCT@_trapcnfg.xml resolves to nt_trapcnfg.xml.
@ITMHOME@
IBM Tivoli Monitoring installation path. Example: If this is a Linux system and the default
installation path is used, @ITMHOME@ resolves to /opt/IBM/ITM/.
@MSN@
Agent's managed system name (not the subnode name). Example: If the agent's managed system
name is primary:icvw3d62:nt, @MSN@ resolves to primary-icvw3d62-nt.
@TASKNAME@
Agent's process name. Examples: klzagent; kntcma.
@VERSION@
Agent's product version string. Example: If the agent's version is Tivoli Monitoring 6.2.2 fixpack 2,
@VERSION@ resolves to 06-22-02.
@HOSTNAME@
Computer host name. Example: myhost.
@IPADDRESS@
Computer network interface IP address. Example: If the agent's IP address is 9.42.38.333,
@IPADDRESS@ resolves to 9-42-38-333.
527
@OSTYPE@
Operating system type. Examples: linux; win2003.
@OSVERSION@
Operating system version. Examples: Red Hat Enterprise Linux Version 5 (64 bit) resolves to
2-6-18-128-el5; Windows 2003 (32 bit) with Service Pack 2 resolves to 5-2-sp2
@SYSTEMID@
Computer system identifier. Example: System ID icvr4a04.mylab.mycity.ibm.com resolves to
icvr4a04-mylab-mycity-ibm-com.
For detailed information on using the centralized configuration facility, see the IBM Tivoli Monitoring:
Notes:
1. All special characters in the parameter values for all keywords other than @ITMHOME@ are converted
to dashes (-). For example, if the IP address is 9.42.38.233, keyword @IPADDRESS@ resolves to
9-42-38-233.
The value for @ITMHOME@, however, remains unchanged.
2. The value of SETENCR_IRA_CONFIG_SERVER_PASSWORD may be either plain text or encrypted
when saved in the pc_silent_install.txt silent response file. Plain-text values are encrypted when
created in the agent environment file. Encrypted values are created as specified. The itmpwdsnmp utility
is used interactively on another system to encrypt the password string if desired; see the IBM Tivoli
Monitoring: Administrator's Guide.
528
Appendix A. Installation worksheets

Use the following worksheets to gather information you need during the installation of the IBM Tivoli
Monitoring components:
v Windows hub monitoring server worksheet on page 530
v Linux or UNIX hub monitoring server installation worksheet on page 531
v Windows remote monitoring server worksheet on page 532
v Linux or UNIX remote monitoring server installation worksheet on page 533
v Windows portal server worksheet on page 534
v Linux portal server worksheet on page 535
v
v
v
v
v
Generic Windows monitoring agent worksheet on page 536

Generic Linux or UNIX monitoring agent worksheet on page 537
Windows portal desktop client worksheet on page 538
Linux portal desktop client worksheet on page 539
Monitoring server communications protocol details worksheet on page 540
529
Windows hub monitoring server worksheet

Use the following worksheet to gather information for your installation of the hub monitoring server on a
Windows computer.
Table 115. Windows hub monitoring server installation worksheet
Host name of computer
IP address
IBM Tivoli Monitoring installation directory
Encryption key
Must use the same encryption key on all IBM Tivoli

Monitoring components. Do not specify the following
characters:
&
ampersand
|
pipe
'
single quote
=
equal sign
$
dollar sign
In addition, do not specify double-byte (DBCS)
characters.
Agents to install on this computer

Agents to add to the deployment depot (plus non-agent
bundles, if your site uses them)
Program folder name

Monitoring server name
Communications protocol details
Agents for which to add application support data
530
See Monitoring server communications protocol details

worksheet.
Linux or UNIX hub monitoring server installation worksheet

Use the following worksheet to gather information for the installation of the hub monitoring server on a
Linux or UNIX computer.
Table 116. Linux or UNIX hub monitoring server installation worksheet
IP address
Encryption key

characters:
&
ampersand
|
pipe
'
single quote
=
equal sign
$
dollar sign
characters.

Communications protocol details

worksheet.
KDC_PARTITION
NIC interface name ("Optional Primary Network Name")

531
Windows remote monitoring server worksheet

Use the following worksheet to gather information for the installation of the remote monitoring server on a
Windows computer.
Table 117. Windows remote monitoring server installation worksheet
IP address
Encryption key

characters:
&
ampersand
|
pipe
'
single quote
=
equal sign
$
dollar sign
characters.

Program folder name

Hub monitoring server name

Hub monitoring server host name
Hub monitoring server communications protocol details
532

worksheet.
Linux or UNIX remote monitoring server installation worksheet

Use the following worksheet to gather information for the installation of the remote monitoring server on a
Linux or UNIX computer.
Table 118. Linux or UNIX remote monitoring server installation worksheet
IP address
Encryption key

characters:
&
ampersand
|
pipe
'
single quote
=
equal sign
$
dollar sign
characters.

KDC_PARTITION
NIC interface name ("Optional Primary Network Name")


worksheet.

533
Windows portal server worksheet

Use the following worksheet to gather information for the installation of the portal server on a Windows
computer.
Table 119. Windows portal server worksheet
Installation location
Encryption key used on the hub monitoring server
Must specify the same encryption key on all IBM Tivoli

Monitoring components.
Program folder
Host name of the computer where you are installing the
portal server
Portal server database administrator ID
Portal server database administrator password
Portal server database user ID (default = TEPS)
Portal server database user password
Warehouse database administrator ID
Warehouse database administrator password
Warehouse database user ID (default = ITMUser)
Warehouse database user password
Warehouse data source name (default = ITM Warehouse)
Warehouse database name
534

worksheet.
Linux portal server worksheet

Use the following worksheet to gather information for the installation of the portal server on a Linux
computer.
Table 120. Linux portal server worksheet
Installation location
Encryption key for the hub monitoring server

Host name for the hub monitoring server


worksheet.
NIC interface name (Primary Optional Network Name)

DB2 for the workstation instance name (default =
db2inst1)
DB2 for the workstation administrator ID (default =
db2inst1)
DB2 for the workstation administrator password
Portal server database name (default = TEPS)
Portal server database user (default = itmuser)
Portal server database user password
Warehouse database name (default = WAREHOUS)
Warehouse database user (default = itmuser)
Warehouse database user password
535
Generic Windows monitoring agent worksheet

Use the following worksheet to gather information for the installation of a monitoring agent on a Windows
computer. Depending on the agent you are installing, you might need additional information to configure
the agent. See the agent user's guide for more information.
Table 121. Generic Windows monitoring agent worksheet
Installation directory

Agents to install
Program folder name

Monitoring server host name
Monitoring server communications protocol details
536

worksheet.
Generic Linux or UNIX monitoring agent worksheet

Use the following worksheet to gather information for the installation of a monitoring agent on a Linux or
UNIX computer. Depending on the agent you are installing, you might need additional information to
configure the agent. See the agent user's guide for more information.
Table 122. Generic monitoring agent for a Linux or UNIX computer worksheet

Agents to install
Agent product code or codes


worksheet.
KDC_PARTITION
NIC interface name (Optional Primary Network Name)
root user password
User group name
Optional user name
537
Windows portal desktop client worksheet

Use the following worksheet to gather information for the installation of a the portal desktop client on a
Windows computer.
Table 123. Windows portal desktop client worksheet
Encryption key for the monitoring server

Program folder name

Portal server host name
538

worksheet.
Linux portal desktop client worksheet

Use the following worksheet to gather information for the installation of a the portal desktop client on a
Windows computer.
Table 124. Linux portal desktop client worksheet
Encryption key for the monitoring server

Instance name for the portal server

Portal server host name
539
Monitoring server communications protocol details worksheet

Use the following worksheet to gather the communications protocol details for your hub and remote
monitoring servers.
Table 125. Monitoring server communications protocol details worksheet
IP.UDP Settings
Host name or IP address
Port number or port pools
IP.PIPE Settings
Port number
IP.SPIPE Settings
Port number
SNA Settings
Network name
LU name
LU 6.2 LOGMODE
TP name
Local LU alias
540
Appendix B. Performing a silent installation of IBM Tivoli

Monitoring
This appendix provides information about installing IBM Tivoli Monitoring using the silent installation
method. This method of installation is useful for advanced users who prefer to supply installation
information once through a response file instead of repeatedly through an installation wizard.
You might run through the installation wizard one time to determine the values that you need to set for
your monitoring needs and then use silent installation to install the rest of your environment. For more
information about installing through the installation wizard, see Chapter 8, Installing IBM Tivoli Monitoring,
on page 147.
The following table outlines the steps for performing a silent installation of IBM Tivoli Monitoring.
Table 126. Installation and configuration steps
Step
Where to find detailed information
Assess your monitoring needs to determine the best

deployment of IBM Tivoli Monitoring components.
Chapter 5, Preparing for installation, on page 83
Ensure you have the required hardware and software.
Hardware and software requirements on page 96
Gather any information required for successful installation Specific information to have ready on page 83
(such as DB2 user information and security specifications).
Run the silent installation.
Creating and using a Windows response file

Performing a silent installation on a Linux or UNIX
computer on page 544
Install application support files on the monitoring server,

portal server, and portal desktop client.
Installing and enabling application support on page 196
Start the portal client to verify that you can view the
monitoring data.
For information on performing a silent uninstallation, see Uninstalling components and agents silently on
page 587.
Creating and using a Windows response file

A sample Windows silent installation response file is provided on the product installation media. Use the
following steps to edit that response file as appropriate for your environment:
1. Locate on the product installation media the appropriate silent_*.txt file, as dictated by the Tivoli
Management Services component for which you're building a response file.
silent_server.txt
for a server image
silent_agent.txt
for an agent image
silent_WIA64.txt
for an agent image for 64-bit Windows Itanium
2. Copy this file to a temporary directory on your system.
3. Open your copy of the silent_*.txt file in a text editor.
4. Change the parameters as appropriate for your environment. The silent_*.txt file contains descriptions
of all the parameters, including directions on how to use them.
541
Complete all of the steps listed in the file. Each line of the file must be either a comment (containing a
semi-colon in column one) or a meaningful statement that starts in column one.
Note: If you want to use the TCP/IP protocol, make sure to specify "IP.UDP." If you specify "TCP/IP,"
IP.PIPE is used by default.
Attention: Do not modify any other files supplied with the installation (for example, the SETUP.ISS
file).
5. Save the file and close the editor.
6. Run the silent installation using one of the following methods:
v Running the silent installation from the command line with parameters on page 544
v Running the silent installation using SMS on page 544
Notes:
1. A silentInstall.cmd script has been added to the Agents DVD. To install this agent you need to run
this script:
silentInstall.cmd
To install the agent in a different directory than the default one (CANDLE_HOME), use the -h option:
silentInstall.cmd -h directory
If this directory name contains spaces, make sure you enclose the name in quotation marks:
silentInstall.cmd -h "directory_with_spaces"
To review the usage of the silentInstall.cmd file, enter silentInstall.cmd -?.

2. To silently install the tacmd command interface (component KUE) so you can continue running
commands based on the previous CLI, uncomment this line in the FEATURES sections of your
response file:
KUEWICMA= Tivoli Enterprise Services User Interface
3. If the installation fails for any reason, a log file, "Abort IBM Tivoli Monitoring date time.log," is created
to document the problem. If the installation fails before reading in the installation location, the log file is
written to the Windows boot drive, typically the C:\ drive. If the installation fails after reading the
installation location, the log file is written to an \install subdirectory in the installation directory. For
example, if you use the default installation directory, the log file is written to the C:\ibm\itm\installITM
directory.
Automatically creating agent response files on Windows

As of IBM Tivoli Monitoring V6.2.2, you can have Tivoli Monitoring create the response files for you after
configuring an agent. This new feature vastly simplifies and speeds up the creation and customization of
response files for agent installation and deployment. It also reduces the likelihood of user error when
specifying their contents. The resulting response files can be used to either install or deploy similar agents
across your environment.
Note: The automatic generation of response files does not apply to multi-instance agents or to server
components.
The agent must be successfully installed and configured prior to generating the response file. To have
Tivoli Monitoring generate a response file, follow these steps:
1. From the Manage Tivoli Enterprise Monitoring Services screen, right-click the agent whose
configuration information you want saved, and select the Advanced Utilities Generate Response
Files option from the pop-up menu. See Figure 104 on page 543.
542
Figure 104. The Generate Response Files option
Note: This option does not appear if the agent has not yet been configured.
2. A window opens where you can specify the path into which you want the generated response files
written; the default directory is ITM_Install_Home\response.
The newly generated response files are named silent_install_pc.txt and silent_deploy_pc.txt,
where pc is the product code for the agent whose configuration parameters you want saved. See
Appendix D, IBM Tivoli product, platform, and component codes, on page 567 for the list of product
codes. If the directory you specify already contains files with these names, you are prompted to either
replace them or specify new names.
The installation and remote-deployment response files are created. When they are available, you can use
them to either install or remotely deploy identical agents across your IBM Tivoli Monitoring network:
1. Edit the response file, and supply missing security parameters such as passwords and encryption
keys.
Note: For security reasons, the IBM Tivoli Monitoring encryption key entered during installation is not
saved in the generated response file, and password parameters are blanked out. You must
supply these values yourself.
2. Install the agent.
v If you prefer to install it locally on the target computer, perform a silent installation using the
generated response file for installation: silent_install_pc.txt.
543
v If instead you prefer to remotely deploy the new agent, use the generated response file for remote
deployment: silent_deploy_pc.txt.
When the silent installation completes successfully, the new agent is installed and configured with
identical settings as the first one.
Note: Menu option Generate Response Files creates silent response files for the selected agent; such
files contain all the installation parameters required to install the same agent with identical settings
on other machines. However, the generated response files apply only to the Common Installer.
They do not work with Solution Installer-based agent images.
Running the silent installation from the command line with parameters
Use the following steps to run the installation from the command line:
1. Start a DOS Command Shell.
2. From the shell, change to the directory containing this installation (where setup.exe and setup.ins are
located).
3. Run the setup as follows. You must specify the parameters in the same order as listed.
start /wait setup /z"/sfC:\temp\SILENT_*.TXT" /s /f2"C:\temp\silent_setup.log"
where:
/z"/sf"
Specifies the name of the installation driver you customized for your site. This is a required
parameter. This file must exist.
SILENT_*.TXT
is the name of the input silent_server.txt, silent_agent.txt, or silent_WIA64.txt file, as described
above.
/s Specifies that this is a silent installation. This causes nothing to be displayed during installation.
/f2 Specifies the name of the InstallShield log file. If you do not specify this parameter, the default
action is to create Setup.log in the same location as the setup.iss file. In either case, the Setup
program must be able to create and write to this file.
Running the silent installation using SMS

Use the following steps:
1. Copy all the installation files to a LAN-based disk that SMS will mount on the desired computers.
(Copy all files in the directory that contains the setup.exe and setup.ins files.)
2. Replace the original silent_server.txt, silent_agent.txt, or silent_WIA64.txt file on the LAN disk with your
modified version.
3. Edit the PDF file located with the setup.exe file, and change the Setup invocation as follows:
Setup /z"/sfC:\temp\SILENT_*.TXT" /s /f2"C:\temp\silent_setup.log"
where:
SILENT_*.TXT
is the name of the input silent_server.txt, silent_agent.txt, or silent_WIA64.txt file, as described
above.
Performing a silent installation on a Linux or UNIX computer

Just as the interactive installation on Linux and UNIX requires both an installation of code and then a
separate configuration, so does the silent installation method. Both the installation and configuration use
parameter files to define what you are installing or configuring. Sample installation and configuration
parameter files are included with IBM Tivoli Monitoring and with monitoring agents. The files are located in
the following locations:
v Silent installation files:
544
On the product installation media (both base IBM Tivoli Monitoring and agent installation media)
After installation, a sample file is located in the install_dir/samples directory
v Silent configuration files: After you install the product, a configuration file for each component that
requires configuration is located in the install_dir/samples directory. There is also a sample
configuration file that you can use to configure any component.
Before editing any of the response files, note the following syntax rules:
v Comment lines begin with a pound sign (#).
v Blank lines are ignored.
v Parameter lines are PARAMETER=value. Do not use a space before the parameter; you can use a
space before or after an equal sign (=).
v Do not use any of the following characters in any parameter value:
$
dollar sign
=
equal sign
|
pipe
Use the following procedures to perform silent installations:
v Installing components with a response file
v Configuring components with a response file on page 547
Installing components with a response file

The silent_install.txt response file specifies the installation parameters for IBM Tivoli Monitoring
components. To use this file to perform a silent installation, edit the file to identify what you want to install
and then run the following command:
./install.sh -q -h install_dir -p response_file
where:
install_dir
identifies the installation location for the IBM Tivoli Monitoring component. The default installation
location is /opt/IBM/ITM.
response_file
identifies the response file that you edited to specify installation parameters. Specify the absolute path
to this file.
The parameters that you can configure in the silent_install.txt file vary depending on the component that
you are installing. Each of the files contains comments that explain the options. The following procedure is
an example of installing all available components on one computer. Use this to determine the type of
information you need to gather when you are setting up your own silent installation.
Use the following steps to perform a silent installation on a UNIX computer:
1. Edit the silent_install.txt file.
2. Set the following parameters as appropriate for your environment:
545
Table 127. Silent installation parameters for UNIX

Parameter
Definition
INSTALL_ENCRYPTION_KEY
REQUIRED. The data encryption key used to encrypt

data sent between systems. This key must be the same
for all components in your IBM Tivoli Monitoring
environment.
Do not use the following characters in the key:
&
ampersand
|
pipe
'
single quote
=
equal sign
$
dollar sign
characters.
INSTALL_FOR_PLATFORM
The operating system for which to install the components.

You can specify an architecture code. If you do not
specify an architecture code, the operating system for the
current computer is used. You can find a list of the
architecture codes for the supported architectures in
archdsc.tbl in the registry directory; they are also listed
in Appendix D, IBM Tivoli product, platform, and
To install application support, uncomment the
INSTALL_FOR_PLATFORM entry, and set it to one of the
following values:
tms
Tivoli Enterprise Monitoring Server application

support
tps
Tivoli Enterprise Portal Server application

support
When installing application support on a Tivoli
Enterprise Portal Server, you must run the silent
installation twice, once for component tps and
again for component tpw.
tpw
Tivoli Enterprise Portal Web (browser) client

application support
tpd
Tivoli Enterprise Portal desktop client application

support
Note: You cannot specify more then one platform at a

time.
546
Table 127. Silent installation parameters for UNIX (continued)

Parameter
Definition
INSTALL_PRODUCT
The product code for the components (or "products") that

you want to install. See Appendix D, IBM Tivoli product,
platform, and component codes, on page 567 for a list of
the codes for the base components. You can use the
./cinfo command to view the product codes for the
applications installed on this computer. You can also find
a list of the product codes in the registry directory in
proddsc.tbl.
You can specify "all" to install all available components.
To install multiple components (but not all), repeat this
parameter for each component that you want to install.
For example:
INSTALL_PRODUCT=ms
INSTALL_PRODUCT=cj
INSTALL_PRODUCT=cq
This example installs the monitoring server, portal server,
and portal desktop client on a Linux computer.
MS_CMS_NAME
If you are installing a monitoring server, use this

parameter to specify the name for the monitoring server,
such as HUB_hostname. Do not specify an IP address or
fully qualified host name.

4. Run the following command to install IBM Tivoli Monitoring in the /opt/IBM/ITM directory:
./install.sh -q -h /opt/ibm/itm -p /tmp/silent_install.txt
Configuring components with a response file

You can use the itmcmd config command with the -p filename parameter to configure IBM Tivoli
Monitoring components silently.
The following sample configuration response files are provided with IBM Tivoli Monitoring:
v ms_silent_config.txt: Used to configure the monitoring server
v cq_silent_config.txt: Used to configure the portal server
v cj_silent_config.txt: Used to configure the portal desktop client
v silent_config.txt: A generic configuration file used to configure agents that do not require unique
configuration parameters
Note that these sample configuration files are available only after the monitoring server has been installed
in a UNIX or Linux system. The files are created in the itm_installdir/samples directory.
If an agent requires unique configuration parameters, configure the agent by using the itmcmd config
command or the Manage Tivoli Enterprise Monitoring Services utility.
Use the following steps to configure a component using the silent method:
1. Edit the configuration file for the component that you want to configure.
2. Complete the parameters identified in the file. Each file contains comments that define the available
parameters and the values to specify.
3. Save the file and exit.
4. Run one of the following commands.
547
To configure the monitoring server:

./itmcmd config -S -p response_file -t ms_name
To configure the portal server, desktop client, or an agent:

./itmcmd config -A -p response_file pc
where:
response_file
Is the name of the configuration response file. Specify an absolute path to this file.
ms_name
Is the name of the monitoring server that you want to configure.
pc Is the product code for the component or agent that you want to configure. See Appendix D, IBM
Tivoli product, platform, and component codes, on page 567 for the list of product codes.
Automatically creating agent response files on Linux or UNIX

As of IBM Tivoli Monitoring V6.2.2, you can have Tivoli Monitoring create the response files for you after
configuring an agent. This new feature vastly simplifies and speeds up the creation and customization of
response files for agent installation and deployment. It also reduces the likelihood of user error when
specifying their contents. The resulting response files can be used to either install or deploy similar agents
across your environment.
Note: The automatic generation of response files does not apply to multi-instance agents or to server
components.
The agent must be successfully installed and configured prior to generating the response file. To have
Tivoli Monitoring generate a response file, invoke the itmcmd CLI command with the resp option:
itmcmd resp [-d directory] pc
where:
directory
is the name of the directory where you want the generated files stored. The default directory is
itm_installdir/response.
pc is the product code for the agent whose configuration parameters you want saved. See Appendix D,
IBM Tivoli product, platform, and component codes, on page 567 for the list of product codes.
Possible errors are that either the directorypath or the product code, pc, is invalid. In either case, an error
message is displayed, and the response files are not generated.
When it completes, the itmcmd resp command creates these installation and remote-deployment response
files:
silent_install_pc.txt
silent_deploy_pc.txt
silent_config_pc.txt
When response files are available, you can use them to either install or remotely deploy, and then
configure, identical agents across your IBM Tivoli Monitoring network:
1. Edit the response files, and supply missing security parameters such as passwords and encryption
keys.
Note: For security reasons, the IBM Tivoli Monitoring encryption key entered during installation is not
saved in the generated response file, and password parameters are blanked out. You must
supply these values yourself.
2. Install the agent.
548
v If you prefer to install it locally on the target computer, perform a silent installation using the
generated response file for installation: silent_install_pc.txt.
v If instead you prefer to remotely deploy the new agent, use the generated response file for remote
deployment: silent_deploy_pc.txt.
3. Using the configuration response file (silent_config_pc.txt), configure the newly installed agent:
549
550
Appendix C. Firewalls
There are four options for achieving interoperability between Tivoli Management Services components
across network firewalls:
1. Automatic (do nothing)
2. Configure IP.PIPE with the ephemeral keyword
3. Use a broker partition file
4. Implement a firewall gateway
Use the following topics to select and implement the appropriate option for your environment:
v Determining which option to use
v Basic (automatic) implementation on page 552
v Implementation with ephemeral pipe on page 552
v Implementation with partition files on page 554
v Implementation with firewall gateway on page 557
Determining which option to use

To determine which option is needed in a particular the firewall environment, four factors must be
considered:
v
v
v
v
Flow of connection establishment

Permission at the firewall
Server address continuity on page 552
Number of internet zones on page 552
Flow of connection establishment

Products based on Tivoli Management Services typically establish connections in a traditional client-server
flow: connect requests flow from a client in the public network to a server in the trusted network. If the
network configuration allows this connection flow, permissions at the firewall are the next consideration in
determining how interoperability is achieved.
If the configuration requires that the physical connect requests flow from the secure, trusted server
network to the public, untrusted client network, then option 4, a firewall gatewall, is required for
interoperability. See Implementation with firewall gateway on page 557.
Permission at the firewall

If the network configuration allows traditional connection flow, the next consideration is what firewall
permissions, if any, are required of the firewall that separates the private, trusted server network from the
public, untrusted client network. For simplicity the firewall between these disjoint networks is referred to as
the barrier firewall.
If all ports are permitted across the barrier firewall, then server address continuity becomes a
consideration (see Server address continuity on page 552).
If no ports are permitted at the barrier firewall, then to achieve interoperability among components in this
firewall environment, full-duplex traffic must be permitted by the firewall administrator for as many ports as
there are servers being concurrently accessed. For example, if Tivoli Enterprise Monitoring Agents are
accessing only the Tivoli Enterprise Monitoring Server, then only one port must be permitted (for full-duplex
traffic) or opened at the barrier firewall. This is the well-known monitoring server port (the default is 1918
for IP.PIPE, 3660 for IP.SPIPE). If agents are accessing two servers concurrently, a monitoring server and
551
a Warehouse Proxy server, then two ports must be opened at the firewall, one for the monitoring server
(typically 1918) and one for the Warehouse Proxy (typically 63358) for interoperability in this firewall
environment.
Server address continuity

If the barrier firewall has no restrictions and all ports are permitted, the next factor to consider is server
address continuity. Address continuity refers to the validity and reachability of published IP addresses.
Address continuity exists when a published server address is universally reachable by all network clients
requesting that service. An example of a server address with address continuity is update.microsoft.com
(207.46.211.124).
Tivoli Management Services server components register their services and the location of these services
(IP address) with a location broker. Clients send queries to the location broker to request address
information for a service, and receive responses that a list of protocols (address families) and IP
addresses at which these services are available. The client then sends a specific server request to one of
the addresses in the list received from the location broker. Service registration with the location broker
assumes address continuity.
If the published address of the Tivoli service (a remote monitoring server, for example) is identical and
reachable for either side of the barrier firewall, then nothing further needs to be done to achieve
interoperability in this firewall environment. If the same address cannot be reached from either side of the
barrier firewall, then option 2 (ephemeral pipe configuration) or option 3 (broker partition files) is required
for interoperability.
Both options are used when traversing a firewall with Network Address Translation (NAT) in effect. While
option 2 (ephemeral pipe) is easier to implement, it restricts the endpoint: ephemeral endpoints cannot
warehouse data. If warehousing data at the endpoint is required, then partition files must be used for
interoperability in this firewall environment (see Implementation with partition files on page 554);
otherwise ephemeral pipes are sufficient to traverse the translating firewall (see Implementation with
ephemeral pipe).
Number of internet zones

The final factor to be taken into consideration is the number of internet zones, that is, how many barrier
firewalls must be crossed. If there are two or more translating firewalls, then option 4, a firewall gateway,
must be used for interoperability in this firewall environment (see Implementation with firewall gateway on
page 557).
Basic (automatic) implementation

IBM Tivoli Monitoring supports most common firewall configurations. To enable this support, IBM Tivoli
Monitoring uses the IP.PIPE socket address family, a TCP-based protocol that opens a single port on the
firewall for communication by IBM Tivoli Monitoring components. If your target environment includes a
firewall between any IBM Tivoli Monitoring components, you must specify IP.PIPE or IP.SPIPE as your
communication protocol during configuration. Typically, no other special configuration is needed unless one
of the factors discussed in Determining which option to use on page 551 requires it.
Implementation with ephemeral pipe

Configure your communications to use ephemeral pipe when addresses on either side of a barrier firewall
are not identical or are not reachable from either side. (Note that use of ephemeral pipe may be dictated
by the per-machine agent count, as well as any form of discontiguous addressing such as a NAT firewall.)
552
You configure an IP.PIPE or IP.SPIPE connection as an ephemeral pipe by adding the ephemeral keyword
ephemeral:y the KDE_TRANSPORT environment variable immediately following the protocol keyword
(IP.PIPE or IP.SPIPE) in the associated KPPENV file for that process. You must then restart the process
for the change to be effective.
Some KPPENV files use KDC_FAMILIES instead of KDE_TRANSPORT. The process is exactly the same
for the KDC_FAMILIES environment variable: adding the ephemeral keyword ephemeral:y immediately
following the protocol keyword (IP.PIPE or IP.SPIPE) that is to be designated ephemeral.
For example, to configure the KNTAGENT to make an ephemeral connection to the monitoring server,
change KDE_TRANSPORT (or KDC_FAMILIES) in the file KNTENV from
KDE_TRANSPORT=IP.PIPE PORT:1918 IP SNA
to
KDE_TRANSPORT=IP.PIPE ephemeral:y PORT:1918 IP SNA
or from
KDC_FAMILIES=IP.PIPE PORT:1918 IP SNA
to
KDC_FAMILIES=IP.PIPE ephemeral:y PORT:1918 IP SNA
To configure a remote monitoring server to make an ephemeral connection to the hub, change
KDE_TRANSPORT (or KDC_FAMILIES) in the file KDSENV from
KDE_TRANSPORT=IP.PIPE PORT:1918 IP SNA
to
KDE_TRANSPORT=IP.PIPE ephemeral:y PORT:1918 IP SNA
or from
KDC_FAMILIES=IP.PIPE PORT:1918 IP SNA
to
KDC_FAMILIES=IP.PIPE ephemeral:y PORT:1918 IP SNA
Monitoring agents that configure their connections as ephemeral cannot warehouse data unless
KPX_WAREHOUSE_LOCATION is also configured at the remote monitoring server to which the
monitoring agent reports. The variable KPX_WAREHOUSE_LOCATION is an optional list of fully qualified,
semicolon-delimited network names that must be added to environment file of the monitoring server to
which the agents are connected. This file is located in different places, depending on the platform:
v On Windows systems: install_dir\CMS\KBBENV
v On UNIX systems:install_dir/config/kbbenv.ini
The syntax is:
KPX_WAREHOUSE_LOCATION=family_protocol:#network_address[port_number];
For example:
KPX_WAREHOUSE_LOCATION=ip.pipe:#192.168.0.14[18303];ip:#192.168.0.14[34543];
See also Setting a permanent socket address for a proxy agent on page 447.
553
Implementation with partition files

Address translation is an enhanced security feature of some firewall configurations. With this feature,
components that must be reached across the firewall have two unique, but corresponding addresses: the
external address (valid for components outside the firewall) and the internal address (valid for components
inside the firewall).
In IBM Tivoli Monitoring, the component that typically must be reached for connection is the monitoring
server; however, the Warehouse Proxy, which runs on Windows as a server-type application, must also be
accessible to clients and also requires an external and internal address. A component on either side of the
firewall knows only about the address that is valid for its side, its partition.
To accommodate sites with address translation, IBM Tivoli Monitoring uses a partition-naming strategy.
This strategy requires two steps:
v The creation of a text file, called a partition file, as part of the configuration of a hub or remote
monitoring server (or Warehouse Proxy). The partition file contains an entry that defines the address of
that component in the other partition.
v The specification of a partition name (any alphanumeric string up to 32 characters) as part of the
configuration of any agent, a hub or remote monitoring server, or Warehouse Proxy. A partition name
must be specified for each component regardless of which side of the firewall it is located on.
v Sample scenarios
v Creating or modifying the partition file in Manage Tivoli Enterprise Monitoring Services on page 555
v Creating the partition file manually on page 556
Sample scenarios
The following scenarios illustrate how to implement partition files in various configurations. In these
scenarios, your site has one firewall that contains two partitions, which are named OUTSIDE and INSIDE:
v Scenario 1: Hub monitoring server INSIDE and monitoring agents OUTSIDE
v Scenario 2: Hub and remote monitoring servers INSIDE and monitoring agents OUTSIDE
v Scenario 3: Hub monitoring server INSIDE, remote monitoring server and agents OUTSIDE on page
555
Scenario 1: Hub monitoring server INSIDE and monitoring agents OUTSIDE

The hub monitoring server is contained within the firewall in a partition named INSIDE. A partition file
named parthub.txt is included in this partition and contains the following entry:
OUTSIDE ip.pipe: hub's_external_address
OUTSIDE is the partition name outside the firewall and hub's_external_address is the address of the hub
monitoring server that is valid for the agents.
As part of the configuration of each agent, specify the name of the partition that each is located in
OUTSIDE.
When an agent starts, parthub.txt is searched for an entry that matches the partition name OUTSIDE and
sees the monitoring server address that is valid for the agents (the external address).
Scenario 2: Hub and remote monitoring servers INSIDE and monitoring agents
OUTSIDE
Note: In Scenarios 2 and 3, all agents report to the remote monitoring server.
As part of the configuration of the hub monitoring server, specify the name of the partition that it is located
in INSIDE. No partition file is needed because the only component that reports to it (the remote monitoring
server) is also inside the firewall.
554
As part of the configuration of the remote monitoring server, specify the name of the partition that it is
located in INSIDE. A partition file, partremote.txt, must also be created at the remote monitoring server. It
contains the following entries:
OUTSIDE ip.pipe: remote's_external_address
When configuring the agents (all of which are outside the firewall, reporting to the remote monitoring
server), specify the name of the partition that they are located in OUTSIDE. When the agents start,
partremote.txt is searched for an entry that matches the partition name OUTSIDE and sees the remote
monitoring server address that is valid for them (the external address).
Scenario 3: Hub monitoring server INSIDE, remote monitoring server and agents
OUTSIDE
As part of the configuration of the hub monitoring server, specify the name of the partition that it is located
in INSIDE. Create a partition file, parthub.txt, containing the following entry:
OUTSIDE ip.pipe: hub's_external_address
OUTSIDE is the partition name outside the firewall and hub's_external_address is the address of the hub
monitoring server that is valid for the remote monitoring server.
As part of the configuration of both the agents and the remote monitoring server, specify the name of the
partition they are located in OUTSIDE.
A partition file partremote.txt also must be created at the remote monitoring server. It contains the
following entry:
INSIDE ip.pipe: remote's_internal_address
If the hub monitoring server needs to communicate with the remote monitoring server (for example, to
issue a report request from an agent that is connected to the remote monitoring server), the
partremote.txt file is searched for an entry that matches the partition name INSIDE and sees the remote
monitoring server address that is valid for it (the internal address).
Creating or modifying the partition file in Manage Tivoli Enterprise

Monitoring Services
The following instructions provide the steps for creating or editing the partition file using Manage Tivoli
Enterprise Monitoring Services:
v Windows: Editing the partition file
v UNIX and Linux: Editing the partition file on page 556
Windows: Editing the partition file

You can create or modify the partition file using the Tivoli Enterprise Monitoring Server Configuration
option in Manage Tivoli Enterprise Monitoring Services. Use the following steps:
1. Right-click the monitoring server you want to configure and select Reconfigure.
The Tivoli Enterprise Monitoring Server Configuration window is displayed.
2. Select IP.PIPE as the communications protocol.
3. Select Address Translation.
4. Click OK.
The Hub (or Remote) TEMS Configuration window is displayed.
5. Click NAT Settings.
The NAT Settings window is displayed.
6. To create the file:
a. For Partition File, type the fully qualified name of the partition file, for example
C:\IBM\ITM\CMS\KDCPARTITION.TXT.
555
b. For Partition Name, type the name of the partition to which the file applies.
c. Click Edit File.
A message appears saying that the partition file cannot be found and asking you if you want to
create it.
d. Click Yes to create the file.
The file is created and opened in Notepad.
e. Create the entry for the partition.
The format for the entries is PARTITION-ID IP.PIPE:nn.nn.nn.nn IP.PIPE:nn.nn.nn.nn. For
example, to create a monitoring server partition for a typical scenario with a monitoring agent
outside of a NAT firewall connecting to a monitoring server behind a firewall, use the partition ID of
your monitoring agent, two spaces, and then the IP address of the host of the monitoring server.
Add additional IP.PIPE:nn.nn.nn.nn addresses on a single line for multiple network interface cards.
See Sample partition file on page 557 for more information on creating entries in the partition file.
f. Save and close the file.
7. Click OK to save the changes and close the configuration window.
UNIX and Linux: Editing the partition file

You can create or modify the partition file using the Tivoli Enterprise Monitoring Server Configuration
option in Manage Tivoli Enterprise Monitoring Services. Use the following steps:
1.
2.
3.
4.
5.
Select the monitoring server you want to configure.

Click Action Configure Basic Settings.
Select IP.PIPE as the communications protocol.
Select Use Address Translation.
Enter the full path and file name for the partition file.
6. Click Create to create the file (if it does not exist) or Modify to edit the file.
7. Enter the partition ID in the first column.
8. Enter the IP address in the second column. If you require a second IP address, enter it in the third
column. (If more than two IP addresses are required for a partition ID, use a text editor to add the
additional addresses. See Sample partition file on page 557.)
9. Click Save to save the file and exit or Cancel to return to the previous screen without modifying the
file.
Creating the partition file manually

If your site is using address translation, you must create a partition file. The partition file is a text file
containing the name of a partition and its constituent interface address. You must create or modify this file
before implementing firewall support with monitoring servers and agents, the portal server and the hub
monitoring server, clients and the portal server, and monitoring agents and Warehouse Proxy agents.
When Tivoli Management Services components need to communicate across a firewall that performs NAT,
those components must be able to retrieve an IP address of the other component that is valid on its side
of the firewall. To support this capability, the location broker namespace is logically divided into partitions
with unique partition IDs. Partition IDs are specified using the KDC_PARTITION environment variable. The
partition file is the means to insert appropriate IP addresses into the location broker namespaces.
When an IBM Tivoli Monitoring component performs a location broker lookup operation, the partition ID of
its partition is automatically supplied. The location broker returns only addresses that have been defined
for that partition namespace and no other. In effect, the IBM Tivoli Monitoring component sees only
addresses that are valid for its partition.
556
A partition file is a standard text file defined to the system using the KDC_PARTITIONFILE environment
variable. Within this file, each line describes a partition name with its constituent IP addresses using space
delimited tokens. The format is as follows:
PARTITION-ID IP.PIPE:nn.nn.nn.nn IP.PIPE:nn.nn.nn.nn
The first token on each line is used as a case-insensitive partition ID. The partition ID can be any
alphanumeric string with a maximum length of 32 characters. Subsequent tokens specified are treated as
interface addresses in standard NCS format (address-family:address). For communication across
firewalls, use only IP.PIPE for address-family.
The expected default location of the file is /install_dir/tables/tems_name.
Sample partition file

The following sample partition file illustrates the format and content expected.
# SAMPLE PARTITION FILE
#
# IMPORTANT: Do not overwrite this file. Copy to another directory
# before making changes.
#
# Lines beginning with a '# are treated as comments and are ignored.
# Note: Do not specify a line that starts with an '* as it might prevent
# proper functioning.
#
# Basic Format
# PARTITION-ID IP.PIPE:nn.nn.nn.nn IP.PIPE:nn.nn.nn.nn
#
# Procedure to edit this sample partition file.
# To create a monitoring server partition file for a typical scenario
# (monitoring agent outside of a NAT firewall connecting to a
# monitoring server behind the firewall),do the following:
# 1) Replace the $OUTSIDE-PID$ with the partition id of your monitoring agent
# 2) Replace the $OUTSIDE-TEMS-HOST-ADDRESS$ with the ip address of the monitoring
# server host outside of the firewall.
# 3) Add additional IP.PIPE:nn.nn.nn.nn addresses on a single line for multiple
# Network Interface Cards (NICs) as in the format above. Separate entries with
# two spaces.Lines can be continued by placing a backslash ('\) char at
# the end of the line.
#
##############################################################################
$OUTSIDE-PID$ IP.PIPE:$OUTSIDE-CMS-HOST-ADDRESS$
Implementation with firewall gateway

The firewall gateway feature enables additional end-to-end connectivity options for use in environments
with specific TCP/IP connection management policies. The firewall gateway is capable of negotiating
multiple firewall hops and network address translation (NAT). It also allows you to configure network traffic
so that it is initiated from the more secure network zone.
The Firewall Gateway provides the following functionality:
v Gateway instances interoperate over a single physical relay connection. Logical connections are
multiplexed over the relay. The origination direction of the relay connection is configurable to match
enterprise firewall transit requirements.
v Relay support enables a logical connection to span multiple firewall zones. Each relay instance can
optionally provide access to the upstream management network. Multiple relays can be chained to
provide seamless hops across multiple zones.
v Proxy support provides a transparent interface to IBM Tivoli Monitoring V6.2 components. Server proxy
components reside downstream and listen for inbound connections. Client proxy components reside
upstream and make connections to services on behalf of downstream endpoints.
557
v All ports used by gateway instances are configurable. Port pooling is available to constrain client proxy
connections to designated port values.
v Multiple failover addresses can be configured for all gateway connections.
NAT alone is not a reason to use the firewall gateway, which is content-neutral and can proxy any TCP
connection. In most cases, NAT processing is handled by the PIPE protocol (IP.PIPE or IP.SPIPE), which
can be used without the firewall gateway. Use the gateway when you have any of the following scenarios:
v A single TCP connection cannot be made to span between IBM Tivoli Monitoring components An
example would be that there are multiple firewalls between these components and a policy that does
not allow a single connection to traverse multiple firewalls.
v Connection requirements do not allow the IBM Tivoli Monitoring default pattern of connections to the
hub monitoring server. An example here would be agents residing in a less-secure zone connecting to a
monitoring server residing in a more-secure zone. Security policy would only allow a connection to be
established from a more-secure zone to a less-secure zone, but not the other way round.
v You must reduce open firewall ports to a single port or connection. For example, rather than opening
the port for every system being monitored, you would like to consolidate the ports to a single
concentrator. Connection requirements do not allow the IBM Tivoli Monitoring default pattern of
connections to the hub monitoring server.
v You must reduce open firewall ports to a single port or connection. You must manage agent failover and
monitoring server assignment symbolically at the hub monitoring server end of the gateway. Because
gateway connections are made between matching service names, an administrator can change the
failover and monitoring server assignment of downstream gateway agents by changing the client proxy
bindings next to the hub monitoring server.
In the context of firewalls, the server and client relationship can best be described in terms of upstream
and downstream. Those entities that open a socket to listen for requests are at the upstream or server
end. Those entities connecting to the server are at the downstream or client end. Using one or more relay
configurations, logical connection requests flow from a listening downstream server proxy interface, and
terminate in an outbound connection from an upstream client proxy interface to a listening server.
Intermediate relay configurations consist of an upstream relay interface containing at least one
downstream relay interface.
Configuration
The gateway component is configured through an XML document that specifies a set of zones, each of
which contain at least one upstream interface with one or more imbedded downstream interfaces. The
following sections provide information on the activation, structure, and content of the XML document:
v Activation
v IPv4 Address Data on page 559
v IPv6 Address Data on page 559
v XML Document Structure on page 559
Activation
The gateway feature can be activated within any IBM Tivoli Monitoring process. However, use must be
limited to the host computer operating system agent to prevent potential resource consumption conflicts
with Tivoli Enterprise Monitoring Server and Tivoli Enterprise Portal Server processes.
The configuration variable KDE_GATEWAY is set to the XML configuration file name. A line of the form
KDE_GATEWAY=filename must be added to the following configuration files, depending on your environment:
v On Windows computers, configuration variables for the Windows operating system agent are located in
the ITMinstall_dir\tmaitm6\KNTENV file.
v On UNIX computers, configuration variables for the UNIX operating system agent are located in the
ITMinstall_dire/config/ux.ini and ITMinstall_dir/config/ux.config files. Add the entry to both files
for reliable results.
558
v On Linux computers, configuration variables for the Linux operating system agent are located in the
ITMinstall_dir/config/lz.ini and ITMinstall_dir/config/lz.config files. Add the entry to both files
for reliable results.
After you make these changes, stop and restart the monitoring agents.
IPv4 Address Data

Internet Protocol Version 4 (IPv4) addresses supplied as data to <bind> and <connection> tags can be in
absolute dotted decimal or symbolic form. An address-specific port number override can be specified
following a trailing colon (":") character.
IPv6 Address Data

Internet Protocol Version 6 (IPv6) addresses supplied as data to <bind> and <connection> tags can be in
absolute uncompressed hexadecimal, absolute compressed hexadecimal, or symbolic form. Absolute
hexadecimal expressions must be enclosed within parentheses ("(" and ")") with one-to four-digit groups
separated by a colon (":"). Compression of a run of 0 digits can occur at most once and is indicated by
double colons ("::"). An address-specific port number override can be specified following a trailing colon;
this specification is outside the parentheses that wrap an absolute address.
XML Document Structure

The relationships between XML configuration elements are illustrated in Figure 105. Attributes are
described on affected elements; default values for most attributes can be supplied on outer elements with
noted exceptions.
<tepgwml:gateway xmlns:tepgwml="http://xml.schemas.ibm.com/tivoli/tep/kde/">
<zone>
<interface>
upstream interface
<bind>
<connection>
</connection
</bind
<interface>
downstream interface
<bind>
<connection>
</connection>
</bind>
</interface>
</interface>
</zone>
<portpool>
</portpool>
</tepgwml:gateway>
Figure 105. Structure of firewall gateway XML configuration document
<gateway>
A <gateway> element in the assigned namespace http://xml.schemas.ibm.com/tivoli/tep/kde/
contains configuration elements described within this document. The gateway XML processor
semantically ignores valid XML until the container is opened, allowing for configuration documents
to be imbedded in other documents. This element cannot contain data.
name
The name attribute is required, cannot contain imbedded delimiters, and must begin with a
nonnumeric. This attribute is used to identify a specific gateway instance.This attribute cannot
be inherited from an outer element.
threads
The threads attribute specifies the number of worker threads in a general purpose thread
pool. The specification must satisfy 1 <= value <= 256, and defaults to 32. Threads in this
559
pool are shared by all defined zones, and are used only by interface startup logic, and to
recover from outbound buffer exhaustion conditions. The default value is generally more than
adequate.
<zone>
A zone is a container of interfaces sharing communication resources. This element cannot contain
data.
name
nonnumeric. This attribute is used to identify a specific zone instance. This attribute cannot be
inherited from an outer element.
maxconn
The maxconn attribute imposes an upper limit on the number of concurrent gateway
connections within the zone. Each proxy physical connection and each logical connection
crossing a relay interface consume this value. The specification must satisfy 8 <= value <=
4096, and defaults to 256.
bufsize
The bufsize attribute sets the data buffer size within the zone. The specification must satisfy
256 <= value <= 16384, and defaults to 2048.
minbufs
The minbufs attribute sets the minimum number of buffers in the zone buffer pool that are
reserved for inbound traffic. The specification must satisfy 4 <= value <= 1024, and defaults to
64.
maxbufs
The maxbufs attribute sets the maximum number of buffers in the zone buffer pool that are
reserved for inbound traffic. The specification must satisfy minbufs <= value <- 2048, and
defaults to 128.
<interface>
An interface describes a set of network bindings that exhibit a fixed behavior according to a
specified role, and based on whether it is defined as upstream, which means that the enclosing
element is <zone>, or downstream, where the enclosing element is <interface>. In all roles, logical
connections arrive through one or more downstream interfaces and are forwarded through the
upstream interface. After a logical connection has been established end to end, data flow is full
duplex. A valid configuration requires an upstream interface to contain at least one downstream
interface. This element cannot contain data.
name
nonnumeric. This attribute is used to identify a specific interface instance. This attribute cannot
be inherited from an outer element.
role
The role attribute is required, and describes the behavior of network bindings contained within.
The role attribute must be specified as proxy, listen, or connect. Downstream proxy
interfaces represent local listening endpoints, and function as a server proxy. Upstream proxy
interfaces represent local connecting endpoints, and function as a client proxy. Relay
interfaces are assigned either listen or connect. No configuration restriction is made on the
relay connection role other than peer relay connections must specify the opposite role. Relay
connections are considered persistent, are initiated at gateway startup, and automatically
restarted in the event of a network disruption.
<bind>
A <bind> element represents connection resources on one or more local interfaces. When
specified within interfaces that listen (downstream proxy, relay listen), bind elements represent
listening ports on local interfaces. For connect interfaces (upstream proxy, relay connect), they
560
represent the local binding to be used for the outbound connection. Specific local interface
addresses can be supplied as data; the default interface is any.
localport
The localport attribute is required within listen interfaces, and is optional within connect
interfaces. The value supplied can be either a number that satisfies 1 <= value <= 65535, or
for connect based roles, can only contain the name of a portpool element defined within the
gateway.
ipversion
Theipversion attribute declares the address family to be used for activity within the tag scope.
Valid values are 4 or 6, with a default of 4.
ssl
The ssl attribute controls SSL negotiation for connections within the scope of this binding.
When specified as yes, a successful negotiation is required before a connection is allowed on
the gateway. The default value is no, meaning no SSL negotiation occurs on behalf of the
gateway connection. Note that this does not restrict the conveyance of SSL streams across a
gateway, only whether or not the gateway acts as one end of the SSL negotiation. When this
operand is specified on a relay binding, it can be used to secure relay traffic, and must be
specified on both ends of the relay connection.
service
The service attribute is a character string used to represent a logical connection between
client and server proxy interfaces. Each connection accepted by a server proxy must find an
upstream client proxy connection with a matching service string. No value restrictions are
imposed.
<connection>
The <connection> tag is used to supply remote network interfaces as data. When applied to a
listen mode binding, the connection tag represents the list of remote interface addresses that are
allowed to make a connection, and is optional. This tag is required for connect mode bindings,
and describes the remote end of the connection. Multiple addresses can be supplied for failover
purposes.
remoteport
The remoteport attribute supplies the default port number of remote interfaces described
within this tag. The value supplied must satisfy 1 <= value <= 65535.
<portpool>
The <portpool> tag is used to create a list of local port numbers to be used for outbound
connections. Port numbers are supplied as data, and can be specified discretely or as a range
expression separated by hyphen ("-"). Range expressions are limited to 1024 bytes to prevent
syntax errors from resulting in larger ranges than expected. Multiple specifications of either form
are allowed.
name
nonnumeric. This attribute is used to identify a specific portpool instance. This attribute cannot
be inherited from an outer element, and is referenced by a localport attribute on a bind
element.
561
Warehouse Proxy Configuration

To ensure that the Warehouse Proxy agent listens at a fixed port number across the monitoring enterprise,
append the following configuration text to the KDC_FAMILIES configuration variable for the Warehouse
Proxy:
IP.PIPE SKIP:15 COUNT:1
The effect of this configuration change is to force the Warehouse Proxy to listen at the Tivoli Enterprise
Monitoring Server well-known port number (default 1918) plus the quantity 4096 multiplied by 15. For
example purposes, if the monitoring server port is defaulted to 1918, this causes the Warehouse Proxy to
listen at 63358. The following examples assume this recommendation has been implemented.
Example gateway configuration scenario

This example uses a three-hop firewall scenario, shown in Figure 106. This scenario makes the following
assumptions:
v Connections can only cross a firewall from the more trusted side to the less trusted side.
v Relay data crossing a zone enters and leaves on separate ports.
The effects of NAT on cross-zone addresses are not shown for clarity. NAT connections are fully
supported. Dynamic NAT connections may require that inbound connection verification be removed. This is
accomplished by removing the <connection> tag under the "listening" <bind>.
Figure 106. Three-hop firewall scenario
562
Public Network (TEMAG3):

The public network has the following characteristics:
v Gateway service is configured as part of operating system agent TEMAG3 on 10.3.1.1.
v TEMAG3 accepts a relay connection on port 10030 only from TEMAG22, port 10030.
v The Tivoli Monitoring components within this zone will contact the hub monitoring server and
Warehouse Proxy server proxy ports 1918 and 63358 through the TEMAG3 interface address.
The agents and the monitoring server at these zones needs to be configured as follows: Agents 3B, 3C,
and 3D pointed directly to RMT3. RMT3 needs to be configured to point to TEMAG3, even if the
configuration dialog asks for the hostname or address of the primary hub monitoring server. Agent3A as
well as TEMAG3 itself should both point to TEMAG3.
In general, a gateway agent should point to itself, except for the final gateway, which should point to a
monitoring server as usual. In this example, TEMAG1 should point to HUB.
In terms of node topology, all the agents and monitoring servers in this example that are pointed to the
gateway agents will appear as if they are directly connected to the hub monitoring server.
v A remote monitoring server resides on a computer other than TEMAG3 to prevent conflict on port 1918.
The TEMAG3 gateway has the following configuration:
<tep:gateway name="temag3"
xmlns:tep="http://xml.schemas.ibm.com/tivoli/tep/kde/" >
<zone name="least_trusted">
<!-upstream interface, listens for incoming relay
connections, accepts traffic from downstream interfaces.
-->
<interface name="uprelay" ipversion="4" role="listen">
<bind localport="10030">10.3.1.1
<connection remoteport="10030">10.2.2.1
</connection>
</bind>
<!-downstream interface, listens for incoming proxy
connections, routes traffic over upstream relay.
-->
<interface name="serverproxy" ipversion="4" role="proxy">
<bind localport="1918" service="tems"/>
<bind localport="63358" service="whp"/>
</interface>
</interface>
</zone>
</tep:gateway>
DMZ2 Network (TEMAG22):

The DMZ2 network has the following characteristics:
v Gateway service configured as part of OS agent TEMAG22 on 10.2.2.1.
v TEMAG22 originates a relay connection to TEMAG3 port 10030 using local port 10030.
v TEMAG22 accepts a relay connection on port 10022 only from TEMAG21, port 10022.
v Tivoli Monitoring components within this zone will contact the hub monitoring server and Warehouse
Proxy server proxy ports 1918 and 63358 through the TEMAG22 interface address.
v A remote monitoring server resides on a computer other than TEMAG22 to prevent conflicts on port
1918.
<zone name="dmz2">
563
<!-upstream interface, listens for incoming relay

connections, accepts traffic from downstream
interfaces
-->
<connection remoteport="10022">10.2.1.1</connection>
</bind>
<!-downstream interface, originates relay connection to
downstream relay, routes traffic over upstream relay.
-->
<interface name="downrelay" ipversion="4" role="connect">
</bind>
</interface>
<!-downstream interface, listens for incoming proxy
connections, routes traffic over upstream relay.
-->
</interface>
</interface>
</zone>
</tep:gateway>
DMZ1 Network (TEMAG21):

The DMZ1 network has the following characteristics:
v Gateway service is configured as part of OS agent TEMAG21 on 10.2.1.1.
v TEMAG21 accepts a relay connection on port 10021 only from TEMAG1 port 10021.
v Tivoli Monitoring components within this zone will contact the hub monitoring server and Warehouse
Proxy server proxy ports 1918 and 63358 via the TEMAG21 interface address.
v A remote monitoring server resides on a computer other than TEMAG21 to prevent conflicts on port
1918.
<zone name="dmz1">
</bind>
</bind>
</interface>
</interface>
</interface>
</zone>
</tep:gateway>
564
Trusted Network (TEMAG1):

The Trusted Network has the following characteristics:
v Gateway service is configured as part of operating system agent TEMAG1 on 10.1.1.1.
v TEMAG1 makes client proxy connections to the hub monitoring server using source ports in the range
20000-20099.
v TEMAG1 makes client proxy connections to the Warehouse Proxy agent at destination port 63358 using
source ports in the range 20100-20199.
<zone name="most_trusted">
<!-upstream interface, traffic from downstream
interfaces and originates proxy connections on behalf
of downstream server proxy clients
-->
<interface name="clientproxy" ipversion="4" role="proxy">
<bind localport="poolhub" service="tems">
</bind>
<bind localport="poolwhp" services="whp">
</bind>
<!-downstream interface, originates connection to
downstream relay, routes traffic to upstream proxy
-->
</bind>
</interface>
</interface>
</zone>
<portpool name="poolhub">20000-20099</portpool>
<portpool name="poolwhp">20100-20199</portpool>
</tep:gateway>
565
566
Appendix D. IBM Tivoli product, platform, and component

codes
Table 128 lists the product codes that identify the different IBM Tivoli Monitoring components and base
agents. Use these codes when running commands. For information on the product codes for Tivoli
Monitoring distributed agents and other Tivoli Management Services based agents, see the product
documentation.
Table 128. Component product codes for infrastructure components and base monitoring agents
Component
Product code
Endpoint monitoring agent
tm
i5/OS monitoring agent
a4
Linux OS monitoring agent
lz
sy
ms
Tivoli Enterprise Portal browser client
cw
Tivoli Enterprise Portal desktop client
cj
cq
um
UNIX Log Alert monitoring agent
ul
UNIX OS monitoring agent
ux
Warehouse Proxy
hd
Windows OS monitoring agent
nt
Eclipse Help Server
kf
Agentless monitoring for Windows operating systems
r2
Agentless monitoring for AIX operating systems
r3
Agentless monitoring for Linux operating systems
r4
Agentless monitoring for HP-UX operating systems
r5
Agentless monitoring for Solaris operating systems
r6
Business System Manager common agent
r9
A complete, alphabetical list of product codes for IBM Tivoli Monitoring can be found at this Web site:
http://www-01.ibm.com/support/docview.wss?uid=swg21265222&myns=swgtiv&mynp=OCSSZ8F3
&mync=E.
567
Table 129 lists the platform codes required by the commands related to remote agent deployment.
Table 129. Platform codes required for remote agent deployment
Platform
Code
AIX R4.1
aix4
AIX R4.2
aix42
AIX R4.2.0
aix420
AIX R4.2.1
aix421
AIX R4.3
aix43
AIX R4.3.3
aix433
AIX R5.1 (32 bit)
aix513
AIX R5.1 (64 bit)
aix516
AIX R5.2 (32 bit)
aix523
AIX R5.2 (64 bit)
aix526
AIX R5.3 (32 bit)
aix533
AIX R5.3 (64 bit)
aix536
HP-UX R10.01/10.10
hp10
HP-UX R10.20
hp102
HP-UX R11 (32 bit)
hp11
HP-UX R11 (64 bit)
hp116
HP-UX R11 Integrity (32 bit)
hpi113
HP-UX R11 Integrity (64 bit)
hpi116
Linux Intel R2.2
li622
Linux Intel R2.2 (32 bit)
li6223
Linux Intel R2.4
li624
Linux Intel R2.4 GCC 2.9.5 (32 bit)
li6242
li6243
li6245
li6262
li6263
li6265
Linux S390 R2.2 (31 bit)
ls322
ls3223
ls3226
ls324
Linux S390 R2.4 GCC 2.9.5 (31 bit)
ls3242
ls3243
Linux S390 R2.4 GCC 2.9.5 (64 bit)
ls3245
ls3246
Linux S390 R2.6 GCC 2.9.5 (31 bit)
ls3262
ls3263
Linux S390 R2.6 GCC 2.9.5 (64 bit)
ls3265
ls3266
568
Table 129. Platform codes required for remote agent deployment (continued)
Platform
Code
Linux AMD64 R2.4 (32 bit)
lx8243
Linux x86_64 R2.4 (64 bit)
lx8246
Linux AMD64 R2.6 (32 bit)
lx8263
Linux x86_64 R2.6 (64 bit)
lx8266
Linux ia64 R2.4 (64 bit)
lia246
Linux ia64 R2.6 (64 bit)
lia266
Linux ppc R2.4 (64 bit)
lpp246
lpp263
lpp266
MVS
mvs
Digital UNIX
osf1
OS/2
os2
OS/400
os400
Solaris R2.4
sol24
Solaris R2.5
sol25
Solaris R2.6
sol26
Solaris R7 (32 bit)
sol273
Solaris R7 (64 bit)
sol276
Solaris R8 (32 bit)
sol283
Solaris R8 (64 bit)
sol286
Solaris R9 (32 bit)
sol293
Solaris R9 (64 bit)
sol296
Solaris R10 (32 bit)
sol503
Solaris R10 (64 bit)
sol506
Solaris R10 Opteron (32 bit)
sol603
Solaris R10 Opteron (64 bit)
sol606
Tandem Itanium (64 Bit)
ta6046
Tandem MIPS (64 Bit)
tv6256
Tru64 V5.0
tsf50
Tivoli Enterprise Monitoring Server support
tms
Tivoli Enterprise Portal Server support
tps
Tivoli Enterprise Portal Desktop client support
tpd
Tivoli Enterprise Portal Browser client support
tpw
Common code, sample libraries and documentation
unix
Windows Itanium 64 bit
WIA64
Windows x86-64 64 bit
WIX64
Windows (all other environments)
winnt
Appendix D. IBM Tivoli product, platform, and component codes
569
Table 130 lists the various IBM Tivoli Monitoring components and the codes that represent them; these
show up when invoking the cinfo -t command.
Table 130. Application support codes
Component
Code
TEMS
TEPS
TEP
Windows
WI
Tivoli Enterprise Monitoring Server application support

(Windows systems)
WICMS
Tivoli Enterprise Portal Server application support

(Windows systems)
WICNS
Tivoli Enterprise Portal browser client application support

(Windows systems)
WIXEB
Tivoli Enterprise Portal desktop client application support

(Windows systems)
WIXEW
Tivoli Enterprise Monitoring Server application support

(Linux or UNIX systems)
tms
Tivoli Enterprise Portal Server application support (Linux

or UNIX systems)
tps
Tivoli Enterprise Portal browser client application support

tpw
Tivoli Enterprise Portal desktop client application support

tpd
570
Appendix E. Common agent environment variables

The following environment variables are used by all IBM Tivoli Monitoring agents:
KCA_CAP_DIR
Directories where Common Agent Package files are installed by default.
KCA_CMD_TIMEOUT
Command timeout parameter for the Common Agent Package. The default value is 30 seconds, and
the maximum is 120 seconds.
KCA_DISCOVERY_INTERVAL
How frequently the watchdog polls for new, running instances of agents managed by Agent
Management Services.
CMS_MSGBASE
Applies only to the i5/OS platform. Specifies the MSG2 message file for agent framework messages.
CT_CMSDIRECT
Obsolete. Replaced by IBM Tivoli Monitoring V6 firewall communications services. Specify the full NAT
firewall address of the monitoring server to connect to, including protocol:address[port#].
CT_CMSLIST
Required variable that specifies the primary or secondary Tivoli Enterprise Monitoring Server the agent
must connect with. Takes a list of monitoring server names in the form network_protocol:hostname or
network_protocol:address and delimited by semicolons.
CTIRA_CELL_NAME
Obsolete. Replaced by the CT_CMSLIST agent configuration variable.
CTIRA_DYNDESCR
Enable agents other than Universal Agents to dynamically upload support files (Tivoli Enterprise
Monitoring Server catalog and attribute files, Tivoli Enterprise Portal Server ODI file). The default value
is N to disable this function. Not yet available.
CTIRA_HEARTBEAT
The interval, in minutes, of the agent-to-monitoring server heartbeat data sample. The default value is
10 minutes. Shorter heartbeat intervals increase network traffic between the agent and the Tivoli
CTIRA_HIST_DIR
Required variable that specifies the directory where agent-based short-term history data files are
stored. Does not apply to the Tivoli Enterprise Monitoring Server's short-term history data files.
CTIRA_HOSTNAME
Used by many, but not all, agents to provide an alternate hostname qualifier
(subsystem:hostname:nodetype) for the published agent managed system name. Used to remove a
long network domain name (such as acme.us.com) from the default agent hostname. Not honored by
all agents. For some agents, CTIRA_HOSTNAME might cause unpredictable results in the Tivoli
Enterprise Portal navigation tree.
CTIRA_IP_PORT
Applies to z/OS agents only. Do not modify. Set this variable to 0 so the operating system can provide
the agent RPC listen port, which prevents a port conflict for some z/OS configurations.
CTIRA_LOG_PATH
Required variable that specifies the directory where the agent's Operations Log file is stored. The file
names themselves use the suffixes .LG0and .LG1. This variable does not apply to z/OS-based agents.
571
CTIRA_MAX_RECONNECT_TRIES
Obsolete. Number of consecutive unsuccessful attempts the agent makes to connect to a Tivoli
Enterprise Monitoring Server before giving up and exiting. The default value of 0 means that the agent
remains started regardless of its connection status with the monitoring server. (Prior to IBM Tivoli
Monitoring V6.2.2, the default value was 720.)
CTIRA_NCSLISTEN
Number of RPC listen server threads to create for the agent. The default value is 10.
CTIRA_NODETYPE
Supplies the agent node type qualifier (subsystem:hostname:nodetype) of the agent managed system
name (msn). Provide the agent product indicator in this name. This value may also be set by the agent
itself.
CTIRA_OS_INFO
Overrides the default value for agent entries in the Tivoli Enterprise Monitoring Server's
ManagedSystem.Host_Info column. This variable is used to build the Tivoli Enterprise Portal Server's
navigation tree. The value must match an existing entry in the CNPS/osnames file. This variable is not
applicable to subnode type records in the monitoring server's ManagedSystem table.
CTIRA_PRIMARY_FALLBACK_INTERVAL
Forces the agent to switch from the primary Tivoli Enterprise Monitoring Server to one of the defined
secondary monitoring servers, because the primary monitoring server is offline or due to
network-connectivity issues. You want the agent to switch back to the primary monitoring server as
soon as possible when it becomes available. This parameter controls the frequency with which the
agent performs a lookup of the primary monitoring server. If the primary monitoring server is found, the
agent disconnects from the secondary monitoring server and reconnects to the primary monitoring
server. A value of zero disables this feature. The minimum value must be 2.5 times
CTIRA_RECONNECT_WAIT value. The default value is 4500 seconds, or 75 minutes.
CTIRA_PRODUCT_SEP
Supplies an alternate qualifier for the agent's managed system name (msn). The default value is a
colon (:).
CTIRA_RECONNECT_WAIT
Time interval, in seconds, that the agent waits between attempts to register with a Tivoli Enterprise
Monitoring Server. The default value is 600 seconds.
CTIRA_REFLEX_ATOMIC
For subnode targets only. Evaluates situation state by any existing specified display item column name
when deciding which reflex situation automation command the agent should execute. Not applicable to
reflex situation commands executed or evaluated by the Tivoli Enterprise Monitoring Server. Disable by
setting to N. The default value is Y.
CTIRA_REFLEX_TARGET
For subnode targets only. Evaluates situation state by subnode name value in the ORIGINNODE
column when deciding which reflex situation automation command the agent should execute. Not
applicable to reflex situation commands executed or evaluated by the Tivoli Enterprise Monitoring
Server. Disable by setting to N. The default value is Y.
CTIRA_SIT_CLEAN
Number of seconds between garbage cleanup of stale entries in the agent persistent situation file. The
default value is 900 seconds.
CTIRA_SIT_FILE
Specifies an alternate name for the default agent-based persistent situation file. This variable should
be used only in exceptional conditions, because the file name reflects the agents managed system
name. Unsupported for z/OS-based agents.
CTIRA_SIT_MGR
Specifies whether or not to use the agent's persistent situation file when registering with the Tivoli
572
Enterprise Monitoring Server. Using this file improves performance of the monitoring server. Set this
variable to N to disable usage. For a z/OS agent, the value must be N, because this feature is not
implemented for a z/OS-based monitoring server. For all other platforms, the default value is Y.
CTIRA_SIT_PATH
Required variable that specifies the directory where the agent-based persistent situation file is stored.
This agent-only file contains a copy of the Tivoli Enterprise Monitoring Server monitoring situations for
the agent's use while registering with the monitoring server. The file is named psit_msn.str, where
msn is the managed system name of the agent process. Unsupported for z/OS-based agents.
CTIRA_SUBSYSTEM_ID
Optional variable that overrides the subsystem ID qualifier (subsystem:hostname:nodetype) of the
agent managed system name (msn). Describes a monitored resource instance to help make this name
unique. Value may also be set by the agent itself.
CTIRA_SYSTEM_NAME
Sets an alternate system name for agent entries in the Tivoli Enterprise Monitoring Server's
ManagedSystem.Host_Address column within the <NM>mysystem</NM> tags. Used to build the
Tivoli Enterprise Portal Server's navigation tree. Not applicable to subnode type records in the
monitoring server's ManagedSystem table.
CTIRA_THRESHOLDS
Specifies the fully qualified name of the XML-based adaptive (dynamic) threshold override file. The
default file is located in $CANDLE_HOME/localconfig/pc/pc_thresholds.xml, where pc is the agent
product code. On z/OS system, the default file name is pcTHRES.
IRA_ADAPTIVE_THRESHOLD_MODE
Specifies the adaptive (dynamic) threshold operation mode, either CENTRAL or LOCAL. In CENTRAL
mode, threshold overrides are centrally created and distributed to the agent, and the threshold
override XML file should not be modified. This is the recommended mode and the default.
In LOCAL mode, central distribution to the agent is inhibited, and threshold overrides are locally
created and managed. Use LOCAL mode to specify that the agent should ignore enterprise
distribution; its affinity will not be registered, so the Tivoli Enterprise Portal cannot override the agent's
managed system node. This mode should be used cautiously since it causes the Tivoli Enterprise
Monitoring Server's thresholds and the agent's thresholds to be out of sync.
You must create and manually write override definitions in the same file that is created in CENTRAL
mode: managed-system-name_product-code_thresholds.xml. For instance, on Windows, this file is
named Primary_myagent_NT_thresholds.xml; on Linux, myagent_LZ_thresholds.xml; on UNIX,
myagent_UX_thresholds.xml. On Windows, the file is stored in the %CANDLEHOME%\TMAITM6 directory; on
Linux and UNIX, the file is stored in $CANDLEHOME/interp/product-code/bin.
The names of the columns to be used when specifying overrides is taken from the attributes file. The
override name and objectId must be unique in the XML file. Timestamp is not required.
If later you switch back from LOCAL mode to CENTRAL mode, centrally located overrides will again
override the local definitions.
IRA_AUTONOMOUS_LIMIT
Sets the saved event limit for autonomous operation. If the specified value is a number (for example,
500), then it is the maximum number of situation event records to be saved by the agent. If the
specification is in common disk space units such as KB, MB, or GB (for example, 5MB), then it is the
total amount of disk space to be used by the agent for saving situation event data. The default value is
2MB.
IRA_AUTONOMOUS_MODE
Turns on (YES) or off (NO) agent autonomous mode. While in autonomous mode, the agent continues
to run Enterprise situations. The situation event data persists on disk even after agent restart. Upon
reconnection to the Tivoli Enterprise Monitoring Server, the agent uploads saved situation event data
to the monitoring server. The default value is Y.
573
IRA_DEBUG_AUTONOMOUS
Turns on (Y) or off (N) debug trace for agent autonomous operation. The default value is N.
IRA_DEBUG_EVENTEXPORT
Turns on (Y) or off (N) agent event export operations, such as SNMP trap and debug trace. The
default value is N.
IRA_DEBUG_PRIVATE_SITUATION
Turns on (Y) or off (N) debug trace when processing an agent's private situations. The default value is
N.
IRA_DEBUG_SERVICEAPI
Turns on (Y) or off (N) debug trace for agent service interface processing. The default value is N.
IRA_DEBUG_TRANSCON
Turns on (Y) or off (N) debug trace for agent transport conduit processing. The default value is N.
IRA_DUMP_DATA
Used by both agents and the Tivoli Enterprise Monitoring Server for debugging. Set to Y to do a
hexadecimal dump of RPC transaction content data contents into the RAS1 log. The default value is
N. Can produce voluminous RAS1 message output if enabled.
IRA_EVENT_EXPORT_CHECKUSAGE_INTERVAL
Specifies the frequency with which the agent checks and calculates the autonomous operation saved
event usage limit that is defined by the IRA_AUTONOMOUS_LIMIT parameter . The default value is
90 seconds; the agent enforces the minimum setting of 30 seconds.
IRA_EVENT_EXPORT_LISTSTAT_INTERVAL
Defines the frequency with which the agent outputs collected situation statistics to the debug trace log.
The default value is 900 seconds, or 15 minutes.
IRA_EVENT_EXPORT_LISTSTAT_OUTPUT
Enables (Y) or disables (N) periodic output of situation operation statistics data to the trace log. The
default is N.
IRA_EVENT_EXPORT_SIT_STATS
Enables (Y) or disables (N) basic situation operation statistics data collection. The basic situation data
includes situation first start time, situation first event time, situation last start time, situation last stop
time, situation last true event time, situation last false event time, number of times situation recycles,
number of times situation enters autonomous operation. The default value is Y.
IRA_EVENT_EXPORT_SIT_STATS_DETAIL
Enables (Y) or disables (N) details situation operation statistics data collection. The detail data
collected includes 8 days' situation operation profile such as hourly true event count, hourly false event
count, hourly data row count, hourly true event ratio, and hourly false event ratio. The default value is
N.
IRA_EVENT_EXPORT_SNMP_TRAP
Enables (Y) or disables (N) the SNMP trap emitter capability. When enabled, the SNMP trap
configuration file is required and must exist for the agent to emit SNMP V1, V2, or V3 trap to
configured SNMP trap managers. The default value is Y.
IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG
Specifies the fully qualified SNMP trap configuration file name. The default file is located in
$CANDLE_HOME/localconfig/pc/pc_trapcnfg.xml (member pcTRAPS on z/OS systems), where pc is the
agent product code.
IRA_LOCALCONFIG_DIR
Specifies the local configuration directory path that contains locally customized configuration files such
as threshold overrides, private situations, and SNMP trap configuration file. The default directory is the
localconfig subdirectory of the directory specified by the CANDLE_HOME environment variable,
which is the RKANDATV DD name on z/OS systems.
574
IRA_PRIVATE_SITUATION_CONFIG
Specifies the fully qualified autonomous Private Situation configuration file name. The default file on
distributed systems is located in $CANDLE_HOME/localconfig/pc/pc_situations.xml, where pc is the
agent product code. The default file on z/OS systems is the SICNFG member in the RKANDATV data
set.
IRA_SERVICE_INTERFACE_DEFAULT_PAGE
Instructs the agent to open the named product-specific HTML page instead of the installed
navigator.htm page upon logon to the agent service interface. The HTML file must exist in the agent
installation HTML subdirectory (CANDLE_HOME/localconfig/html/) or as specified by the
IRA_SERVICE_INTERFACE_DIRvariable.
IRA_SERVICE_INTERFACE_DIR
Defines the path specification of the agent service interface HTML directory. In conjunction with the
IRA_SERVICE_INTERFACE_DEFAULT_PAGE parameter, the agent constructs the file path to a
specific, requested HTTP GET object. The default filepath is CANDLE_HOME/localconfig on distributed
systems and the RKANDATV dataset on z/OS systems. The parameter is equivalent to the
IRA_HTML_PATH parameter.
Example: If IRA_SERVICE_INTERFACE_DIR="\mypath\private" and you enter http://
localhost:1920///kuxagent/kuxagent/html/myPage.htm in your browser, myPage.htm is retrieved from
\mypath\private\html\ instead of %CANDLE_HOME%\localconfig\html\.
IRA_SERVICE_INTERFACE_NAME
Specifies a unique agent interface name to represent this agent. The default agent service interface
name is pcagent, where pc is the application product code. In the scenario where multiple instances of
the same agent are running in the system, this parameter enables customization of a unique service
interface name to correspond to this agent.
ITM_BINARCH
Set by the installer to supply the platform architecture code. Used by the agents to read the agent
installation version files and retrieve agent version information.
KBB_RAS1
Sets the level of agent tracing:
ERR (UNIT:KRA ST)
View the state of main agent functions such as situation and report processing.
ERR (UNIT:KRA ALL)
View detailed debug messages for agent functions.
ERR (UNIT:KHDX ST)
View the state of the agent's short-term history data uploads to the Tivoli Data Warehouse.
ERR (UNIT:KHD ALL)
View detailed debugging messages about short-term history data uploads to the Tivoli Data
Warehouse.
575
576
Appendix F. Maintaining the EIB on Linux or UNIX

To ensure the effective operation of your monitoring server, back up your Enterprise Information Base
(EIB) tables as part of your routine maintenance. The EIB contains the attributes and other data that
define the agents to the server. The following files, which are stored in the install_dir/tables/eib directory,
compose the EIB.
Table 131. EIB Files
*.db Files
*.idx Files
qa1cacts.db
qa1daggr.db
qa1cacts.idx
qa1daggr.idx
qa1cckpt.db
qa1dcct.db
qa1cckpt.idx
qa1dcct.idx
qa1ccobj.db
qa1dcct2.db
qa1ccobj.idx
qa1dcct2.idx
qa1ccomm.db
qa1dmobj.db
qa1ccomm.idx
qa1dmobj.idx
qa1ceibl.db
qa1dmtmp.db
qa1ceibl.idx
qa1dmtmp.idx
qa1chost.db
qa1dobja.db
qa1chost.idx
qa1dobja.idx
qa1ciobj.db
qa1dpcyf.db
qa1ciobj.idx
qa1dpcyf.idx
qa1cmcfg.db
qa1drnke.db
qa1cmcfg.idx
qa1drnke.idx
qa1cnodl.db
qa1drnkg.db
qa1cnodl.idx
qa1drnkg.idx
qa1cplat.db
qa1dsnos.db
qa1cplat.idx
qa1dsnos.idx
qa1cpset.db
qa1dspst.db
qa1cpset.idx
qa1dspst.idx
qa1cruld.db
qa1dstms.db
qa1cruld.idx
qa1dstms.idx
qa1csitf.db
qa1dstsa.db
qa1csitf.idx
qa1dstsa.idx
qa1csmni.db
qa1dstua.db
qa1csmni.idx
qa1dstua.idx
qa1cstsc.db
qa1dswrs.db
qa1cstsc.idx
qa1dswrs.idx
qa1cstsh.db
qa1dswus.db
qa1cstsh.idx
qa1dswus.idx
qa1cthre.db
qa1dwgrp.db
qa1cthre.idx
qa1dwgrp.idx
qa1dactp.db
qa1dwork.db
qa1dactp.idx
qa1dwork.idx
577
578
Appendix G. Securing your IBM Tivoli Monitoring installation

on Linux or UNIX
On UNIX and Linux operating systems, the product installation process creates the majority of directories
and files with world write permissions. This configuration creates a security situation that is not
acceptable in many enterprises. The secureMain utility helps you bring the monitoring environment into
compliance with the security standards of your company. Run the secureMain utility on all installations,
especially those installations that include the UNIX OS Agent, to prevent privilege escalation.
Note: You do not need to be logged in as a root user to run this utility, but you are prompted for the root
password when it is required.
Usage
The secureMain commands use the following syntax:
secureMain [-h install_dir] [-g common_group] [-t type_code [-t type_code]] lock
secureMain [-h install_dir] [-g common_group] unlock
where variables are defined as follows:

v install_dir is the directory path for the IBM Tivoli Monitoring installation. If this parameter is not supplied,
the script attempts to determine the installation directory.
v common_group is a group ID common to all of the user IDs that are used to run components in this
installation. The user ID that is used to perform the installation must also be a member of the group ID
specified. The only exception is that the root ID is not required to be a member of the group ID
specified.
v type_code is a component code belonging to an installed component. You can specify multiple -t
options to create a list of component codes to be processed.
If secureMain is invoked with no parameters, the usage text is displayed.
secureMain lock is used to tighten permissions in an IBM Tivoli Monitoring 6.1 installation. It should be
run after installing or configuring components.
When secureMain lock is invoked with no other parameters, the permissions are tightened generally to
755. However, a number of directories and some files are still left with world write permissions. When
certain components which are commonly run using multiple user IDs are present in the installation, many
more files have world write permissions.
When secureMain lock is invoked with the -g common_group parameter, the permissions are tightened
generally to 775 and the directories and files have their group owner changed to common_group
specified. There are no directories or files left with world write permissions. Even when certain
components which are commonly run using multiple user IDs are present in the installation, no files will
have world write permissions. Additionally, the common_group value specified is written to a file and is
used for all future secureMain lock invocations in this installation, unless the -g option is specified and
the common_group is different from the previous value.
When secureMain lock is invoked with the -t type_code parameter, sections of the installation might be
skipped when tightening permissions. Common directories, like bin, config, registry, and logs, and the
files in them are always processed. Only directories and files specific to the specified type_code
components are processed. The other component directory trees are skipped.
579
secureMain unlock is used to loosen permissions in an IBM Tivoli Monitoring 6.2 installation. secureMain
unlock is normally not necessary, but can be run if desired. It should be run before installing or
configuring components.
secureMain unlock does not return the installation to the permission state that it was in before running
secureMain lock. It only processes the common directories, like bin, config, registry, and logs, and the
files in them.
Examples
The following example locks the installation using the common group itmgroup:
secureMain -g itmgroup lock
The following example locks the base and mq component directories using the common group itmgroup:
secureMain -g itmgroup -t mq lock
Scenario with secureMain

The following scenario illustrates the use of secureMain:
1. Complete the following operations using root authorization:
a. Install OS Agent.
b. Configure OS Agent.
c. List files with world write permissions, using the following command: find . -perm -o+w -ls
d. Run the following command: secureMain -g itmgroup -t ux lock
e.
f.
g.
h.
i.
Install the 32-bit Enterprise Svcs UI to get the 32-bit framework.

Install the MQ agent.
Run the following command: secureMain -g itmgroup -t mq lock
List files with world write permissions, using the following command: find . -perm -o+w -ls
Start the OS agent.
2. Complete the following operations using mquser authorization:

a. Start the MQ agent for a queue manager.
b. Start the MQ agent for a second queue manager.
c. Stop the MQ agent for the first queue manager.
d. Stop the MQ agent for the second queue manager.
3. Complete the following operations using root authorization:
a. Stop OS Agent.
b. List files with world write permissions, using the following command: find . -perm -o+w -ls
580
Appendix H. Uninstalling IBM Tivoli Monitoring

Use the following steps to uninstall IBM Tivoli Monitoring:
v Uninstalling the entire IBM Tivoli Monitoring environment
v Uninstalling an individual IBM Tivoli Monitoring agent or component on page 584
v Uninstalling components and agents silently on page 587
v Uninstalling the event synchronization component on page 590
Uninstalling the entire IBM Tivoli Monitoring environment

Use the following procedures to remove the entire IBM Tivoli Monitoring environment from your computer.
v Uninstalling the environment on Windows
v Uninstalling the environment on Linux or UNIX on page 583
If you want to remove just one component such as an agent, see Uninstalling an individual IBM Tivoli
Monitoring agent or component on page 584.
Note: If you plan to reinstall IBM Tivoli Monitoring into a different directory than the one used for this
installation, you must stop and restart this computer before reinstalling IBM Tivoli Monitoring.
Uninstalling the environment on Windows

Use the following steps to uninstall IBM Tivoli Monitoring from a Windows computer:
1. From the desktop, click Start Settings Control Panel (for Windows 2000) or Start Control
Panel (for Windows 2003).
2. Click Add/Remove Programs.
3. Select IBM Tivoli Monitoring and click Change/Remove. The following window is displayed.
Figure 107. Uninstalling IBM Tivoli Monitoring
4. Select Remove and click Next.

The following window is displayed.
581
Figure 108. Confirming the uninstallation
5. Click OK.
The following progress window is displayed.
Figure 109. Stopping Tivoli components before uninstallation
After Tivoli Enterprise services have stopped, you are asked if you want to remove the Tivoli Enterprise
Portal database.
Figure 110. Removing the portal database
6. Click Yes.
The following window is displayed, requesting information required to remove the database:
Figure 111. Database information
7. Type the password for the database administrator in the Admin Password field and click OK.
The following progress window is displayed.
582
Figure 112. Uninstallation progress window
A pop-up window, indicating that GSKit is being uninstalled, is displayed.
Figure 113. GSKit uninstallation
After GSKit is uninstalled, the following window is displayed:
Figure 114. Successful uninstallation
8. Click Finish.
Uninstalling the environment on Linux or UNIX

Use the following steps to uninstall IBM Tivoli Monitoring from a UNIX computer:
1. From a command prompt, run the following command to change to the appropriate /bin directory:
cd install_dir/bin
where install_dir is the path for the home directory for IBM Tivoli Monitoring.
./uninstall.sh
A numbered list of product codes, architecture codes, version and release numbers, and product titles
is displayed for all installed products.
583
3. Type the number for the installed product that you want to uninstall. Repeat this step for each
additional installed product you want to uninstall.
4. After you have removed all installed components, you are asked if you want to remove the installation
directory. Type y and press Enter.
You can also run the following command to remove all installed components from the command line:
./uninstall.sh REMOVE EVERYTHING
After the command completes, you can manually remove the IBM Tivoli Monitoring installation directory.
Note: If for any reason, the UNIX uninstallation is not successful, run the following command to remove
all IBM Tivoli Monitoring directories:
rm -r install_dir
This uninstallation program does not delete the database created for Tivoli Enterprise Portal on a Linux
portal server. If you want to delete that database, you must remove it manually. See the documentation for
your database software for information about deleting a database.
Uninstalling an individual IBM Tivoli Monitoring agent or component

Use the following procedures to remove an agent or other individual IBM Tivoli Monitoring component from
your computer:
v Uninstalling a component on Windows
v Uninstalling a component on Linux or UNIX on page 585
v Uninstalling OMEGAMON Monitoring Agents on page 585
v Removing an agent through the Tivoli Enterprise Portal on page 587
Note: If you plan to reinstall a IBM Tivoli Monitoring component into a different directory than the one
used for this installation, you must stop and restart this computer before reinstalling the IBM Tivoli
Monitoring component.
Uninstalling a component on Windows

Use the following steps to remove a component on a Windows computer. You can uninstall a single agent
or the entire agent bundle (such as IBM Tivoli Monitoring for Databases). You cannot uninstall the
application support files laid down for a Windows Tivoli Enterprise Monitoring Server without uninstalling
the monitoring server.
1. From the desktop, click Start Settings Control Panel (for Windows 2000 or 2003) or Start
Control Panel (for Windows XP).
2. Click Add/Remove Programs.
3. Complete one of the following:
v To uninstall a single IBM Tivoli Monitoring component, such as the portal server or portal client (but
not all components), select IBM Tivoli Monitoring.
v To uninstall an agent bundle or a specific agent, select the agent bundle.
4. Click Change/Remove.
5. Complete one of the following steps:
v To uninstall a specific agent or component, select Modify.
v To uninstall the entire agent bundle, select Remove.
6. Click Next.
7. If you are uninstalling an agent bundle, click OK to confirm the uninstallation.
8. If you are uninstalling an agent or component, complete the following steps:
584
a. For an agent, expand Tivoli Enterprise Monitoring Agents and select the agent you want to
uninstall.
b. For a component, select the component (such as Tivoli Enterprise Portal Desktop Client).
c. Click Next.
d. Click Next on the confirmation screen.
e. Depending on the remaining components on your computer, there might be a series of
configuration panels. Click Next on each of these panels.
Note: When you are uninstalling the Tivoli Enterprise Portal Server, the installer gives you the
option to remove the portal server database. If there are other databases created by Tivoli
Monitoring in this or previous version on the computer, the installer gives you the option to
remove them as well.
9. Click Finish to complete the uninstallation.
Uninstalling a component on Linux or UNIX

Use the following steps to remove a component on a UNIX computer. You can uninstall a single agent or
the entire agent bundle (such as IBM Tivoli Monitoring for Databases).
1. From a command prompt, run the following command to change to the appropriate /bin directory:
cd install_dir/bin
where install_dir is the path for the home directory for IBM Tivoli Monitoring.
./uninstall.sh
A numbered list of product codes, architecture codes, version and release numbers, and product titles
is displayed for all installed products.
3. Type the number for the agent or component that you want to uninstall. Repeat this step for each
additional installed product you want to uninstall.
Note: When you are uninstalling the Tivoli Enterprise Portal Server, the installer gives you the option
to remove the portal server database. If there are other databases created by Tivoli Monitoring
in this or previous version on the computer, the installer gives you the option to remove them as
well.
Uninstalling OMEGAMON Monitoring Agents

Use the following steps to remove OMEGAMON agents from a computer. Table 132 on page 586 and
Table 133 on page 586 list the agents by internal code, release, and descriptive name.
1. Launch Manage Candle Services (350 or 360) or Manage Tivoli Enterprise Monitoring Services.
2. Use the Description and Release columns to locate the agent service name.
3. Stop the service by right-clicking the name and clicking Stop.
4. Take note of any task or subsystem names that are listed in the column for your agent. Usually this
column lists Primary unless your agent supports instances. If your agent supports instances, record
these names for later use.
5. Unconfigure the agent by right-clicking the name and clicking Advanced Unconfigure. The
Configured column changes from Yes to No. Continue to unconfigure all instances found in step 4.
6. Open the Windows Explorer and navigate to the installation directory for OMEGAMON 350 or 360
products and IBM Tivoli Monitoring. The default directories are C:\Candle Candle OMEGAMON and
C:\IBM\ITM for IBM Tivoli Monitoring. Then navigate to the CMA directory.
7. Delete files K??ENV (Task/SubSystem name Primary) and any instances shown as
K??ENV_INSTANCENAME (Task/SubSystem name from step 4).
585
8. Delete any PC*.EXE or PC*.DLL files for the product. PC is the product internal identifier
three-character code from the tables.
9. Exit Manage Candle Services or Manage Tivoli Enterprise Monitoring Services, and launch it again.
The agent and all instances should not be shown under the Service/Application column.
Note: You can also use this procedure to remove IBM Tivoli Monitoring agents if you use the TMAITM6
directory instead of the CMA directory in step 6 on page 585. All of the other steps do not change.
Table 132. Candle OMEGAMON Release 04R1
Internal identifier
Release
Description
K3Z
400
Windows Server Active Directories Monitoring Agent
KA2
120
Alert Adapter for AF/Remote
KA4
300
Monitoring Agent for OS/400
KBL
320
CASP Directory Server Monitoring Agent
KBR
320
CASP Exchange Connector Monitoring Agent
KEZ
251
eBA Solutions Monitoring Agent
KIC
100
WebSphere InterChange Server Monitoring Agent
KIE
100
WebSphere InterChange Server Data Source
KMA
201
Alert Adapter for Remedy ARS
KMC
360
WebSphere MQ Configuration Agent
KMQ
360
WebSphere MQ Monitoring Agent
KNW
300
NetWare Monitoring Agent
KOQ
301
Microsoft SQL Server Monitoring Agent
KOR
301
Oracle Monitoring Agent
KOY
300
Sybase Monitoring Agent
KPT
201
Alert Adapter for Peregrine Service Center
KQI
120
WebSphere Integration Brokers Monitoring Agent
KSA
301
R/3 Monitoring Agent
KTX
300
Tuxedo Monitoring Agent
KUD
400
DB2 Universal Database Monitoring Agent
KWE
130
WebSphere Application Server Monitoring Agent
KWL
100
BEA WebLogic Server Monitoring Agent
KWN
100
Windows Management Web Service
Table 133. Candle OMEGAMON Release BIV110

Internal identifier
Release
Description
KIC
110
WebSphere InterChange Server Monitoring Agent
KIE
110
WebSphere InterChange Server Data Source
KMC
370
WebSphere MQ Configuration Agent
KMQ
370
WebSphere MQ Agent
KQI
130
WebSphere Integration Brokers Monitoring Agent
586
Removing an agent through the Tivoli Enterprise Portal

You can also uninstall non-OS monitoring agents from the Tivoli Enterprise Portal by stopping the agent
and removing its configuration settings. After you have removed the agent from the enterprise, you can
completely uninstall the agent from the managed system. When you remove an agent, it is removed from
any managed system groups to which it is assigned, any situation or policy distribution lists it was on, and
any custom Navigator view items to which it was assigned.
Note: You cannot use the Tivoli Enterprise Portal to remove or uninstall OS agents.
Note: If the Manage Tivoli Enterprise Monitoring Services utility is running when you uninstall the agent, it
is shut down automatically by the uninstallation process.
Use the following steps to remove and optionally uninstall an agent:
1. In the Tivoli Enterprise Portal, right-click the agent Navigator item and click Remove.
2. Click Yes when you are asked to confirm the removal of the agent.
3. When you are asked to confirm that you want to permanently uninstall the agent, click Yes to uninstall
or No to leave the agent installed on the computer.
Uninstalling the Warehouse Proxy

When you uninstall the Warehouse Proxy, the warehouse database is not removed and historical situations
on the agent are not stopped.
Before you uninstall, complete the following steps to uninstall the warehouse database and historical
situations on the agent:
1. Stop the historical situations.
2. Drop the warehouse database.
3. Remove the ODBC data source.
4. Remove the Windows user, ITMUser, that was created to connect to a DB2 for the workstation
database.
Removing the ODBC data source connection

When you uninstall IBM Tivoli Monitoring, the ODBC data source created for the Warehouse Proxy agent
is not removed automatically, which can cause problems when you reinstall IBM Tivoli Monitoring. To
prevent these problems, manually remove the ODBC data source after you uninstall IBM Tivoli Monitoring.
For example, to remove the DB2 for the workstation data source from the DB2 command line, run the
following command:
DB2 UNCATALOG SYSTEM ODBC DATA SOURCE datasource_name
If you are using a Microsoft SQL database or an Oracle database, use the Windows ODBC Data Source
Administrator utility to remove the ODBC data source.
Uninstalling components and agents silently

Use the following procedures to uninstall components and agents silently:
v Performing a silent uninstallation on a Windows computer on page 588
v Performing a silent uninstallation on a Linux or UNIX computer on page 589
587
Performing a silent uninstallation on a Windows computer

Like silent installation, silent uninstallation on Windows uses a response file. Sample response files are
shipped with IBM Tivoli Monitoring components and all monitoring agents that use the IBM Tivoli
Monitoring services. The sample files can be found in one of the following locations:
v On the product installation media
v After installation, in the install_dir>samples directory (if present)
Note: The name of the response file varies by installation media and release. The file is typically found on
the media under the WINDOWS directory. For Windows on Itanium, there is a separate WIA64
directory with an Itanium specific response file. If IBM Tivoli Monitoring was used to generate the
response file for a configured agent, the response file is located where it was generated
(install_dir\response is the default) and the name of the file is silent_install_pc.txt. See
Automatically creating agent response files on Windows on page 542 for more information.
Note:
Complete the following steps to edit the response file as appropriate for your uninstallation:
1. Locate the appropriate file. For example:
silent_server.txt
For a server image
silent_agent.txt
For an agent image
silent_WIA64.txt
For an agent image for 64-bit Windows Itanium
2. Copy this file to a temporary directory on your system.
3. Open your copy of the file in a text editor.
4. Change the parameters as appropriate for the uninstallation:
v To remove all components and the installation directory, uncomment (by removing the semicolon)
the following line in the ACTION TYPE section:
;REMOVEALL=Yes
v To select a component to uninstall, uncomment the following line in the ACTION TYPE section
;UNINSTALLSELECTED=Yes
and uncomment the component or components to be removed in the FEATURE section. For
example:
;*********************************************************************
;
;
TIVOLI ENTERPRISE MONITORING AGENT
;
TEMA INSTALLATION SECTION
;
; Any Feature selected that ends in CMA will cause the TEMA Framework
; and specific Agent to be installed.
;
;*********************************************************************
;KGLWICMA=Tivoli Enterprise Monitoring Agent Framework
;KNTWICMA=Monitoring Agent for Windows OS
;KNT64CMA=Monitoring Agent for Windows OS (86-x64 only)
;KR2WICMA=Agentless Monitoring for Windows Operating Systems
;KR3WICMA=Agentless Monitoring for AIX Operating Systems
;KR4WICMA=Agentless Monitoring for Linux Operating Systems
;KR5WICMA=Agentless Monitoring for HP-UX Operating Systems
;KR6WICMA=Agentless Monitoring for Solaris Operating Systems
;KUMWICMA=Universal Agent
;KAC64CMA=32/64 Bit Agent Compatibility Package
;KUEWICMA=Tivoli Enterprise Services User Interface Extensions
588
5. Save the file and close the editor.

Take the following steps to run the silent uninstallation:
1. Open a DOS command prompt.
2. In the prompt, change to the directory containing this installation (where setup.exe and setup.ins files
are located).
3. Run the setup as follows, specifying the parameters in the order listed:
start /wait setup /z"/sfresponse_file" /s /f2"C:\temp\silent_setup.log"
where:
/z"/sf
Specifies the fully qualified name of the response file you edited. For example:
/z"/sfC:\temp\myresponse.txt"
/s
Specifies that this is a silent installation. This causes nothing to be displayed during
installation.
/f2
Specifies the name of the InstallShield log file. If you do not specify this parameter, the default
is to create Setup.log in the same location as the setup.iss file. In either case, the Setup
program must be able to create and write to this file.
When the uninstallation is complete, setup.exe returns to the command prompt.

If the uninstallation is unsuccessful, check the installation log in the install_dir\InstallITM\
product_nametime_stamp.log directory. If all components and directories have been removed, the log will
be in the root of the C: drive. The name of the file is the name of the product being uninstalled with date
and time appended to the end of the product name.
Performing a silent uninstallation on a Linux or UNIX computer

Complete the following steps to uninstall IBM Tivoli Monitoring components and monitoring agents
unattended (that is, without having to specify parameters interactively):
1. Stop all agents and servers that you are going to remove. Use the ./cinfo -r command to see a list of
running process, and then use the itmcmd command to stop the appropriate processes.
2. Change to the installation directory bin directory:
cd install_dir/bin
3. To select individual components or agents, enter the following command:

uninstall.sh [-f] [-i] [-h install_directory] [product platformCode]
where
-f
Forces delete, suppressing confirmation messages and prompts.
-i
Ignores all running processes.
product
Is the two-letter code for the product to be uninstalled.
platformCode
Is the platform code for the product (such as aix513, sol286, hp11, and so forth: see
Appendix D, IBM Tivoli product, platform, and component codes, on page 567).
Repeat the command for each agent or component you want to remove on the target computer.
4. To remove all components and agents enter the following command:
uninstall.sh REMOVE EVERYTHING
When the uninstallation is complete, the uninstall command returns to the command prompt. Some
messages may be written to the screen. There may be additional steps, depending on the component
589
being uninstalled. For example, if you uninstall the Warehouse Proxy, the warehouse database is not
removed and historical situations on the agent are not stopped (see Uninstalling the Warehouse Proxy
on page 587).
If the uninstallation is unsuccessful, some messages may be written to the screen. See the installation log
in the install_dir/logs/product_nametime_stamp.log directory or the IBM Tivoli Monitoring:
Troubleshooting Guide for more information. If all components have been removed, the log is at the root.
Note: If for any reason, the UNIX uninstallation is not successful, run the following command to remove
all Tivoli Monitoring directories:
rm -r install_dir
Uninstalling the event synchronization component

Use the following steps to uninstall the event synchronization from your event server:
Note: On Windows 2003 you must run the change user /install command from a command prompt
before you begin. This puts the computer into the required install mode. After the uninstallation,
run the change user /execute command to return the computer to its previous mode.
1. Set the Tivoli environment:
v On Windows:
C:\windows\system32\drivers\etc\Tivoli\setup_env.cmd
or
C:\winnt\system32\drivers\etc\Tivoli\setup_env.cmd
v On operating systems like UNIX and Linux:

2. Run the following uninstallation program:

v On Windows:
%BINDIR%\TME\TEC\OM_TEC\_uninst\uninstaller.exe
v On operating systems like UNIX and Linux:

$BINDIR/TME/TEC/OM_TEC/_uninst/uninstaller.bin
You can run this uninstallation program in silent mode (by running the program from the command line
with the -silent parameter) or in console mode (by using the -console parameter).
3. Follow the prompts in the uninstallation program.
When the uninstallation is completed, you can tell the installer what rule base should be loaded. If initial
installation created a new rule base, the value shown in Rule base name of rule base to be loaded on
completion of this uninstall will be Default, meaning that the Default rule base will be loaded. If the initial
installation updated an existing rule base, that rule base name is provided as the value for Rule base
name of rule base to be loaded on completion of this uninstall. You can override this value by typing in
the name of the rule base you want to have loaded.
You can also tell the uninstaller to stop and restart the event server.
You can run the silent uninstallation using default processing or create a template to change the default
values. The default processing will load the Default rule base (or the existing rule base was chosen during
installation) and will not restart the TEC server.
To create and use a template:
1. Create the template:
v On Windows:
590
%BINDIR%\TME\TEC\OM_TEC\_uninst\uninstaller.exe options-template
itmeventsynchU.txt
v On operating systems like UNIX or Linux:
$BINDIR/TME/TEC/OM_TEC/_uninst/uninstaller.bin options-template
itmeventsynchU.txt
2. Modify the template as desired:
v To specify which rule base to load, modify the restartTECU.uRBN file.
v To automatically restart the event server, modify the restartTECU.restartTECU file.
3. Set the Tivoli environment.
4. Run the uninstallation program as follows:
v On Windows:
%BINDIR%\TME\TEC\OM_TEC\_uninst\uninstaller.exe options
itmeventsynchU.txt silent
v On operating systems like UNIX or Linux:
$BINDIR/TME/TEC/OM_TEC/_uninst/uninstaller.bin options
itmeventsynchU.txt silent
If your event server is running on an HP-UX computer, ensure that the _uninst and _jvm directories are
successfully removed by the uninstallation program. If they are not, manually delete these directories.
Uninstalling event synchronization manually

Use the instructions for the appropriate operating system to remove event synchronization manually.
HP11
1. Stop the situation update forwarder long-running process if it is still running:
a. Find the long-running process using:
ps ef
b. Use the kill command to remove the process:

kill 9 process_number
2. Run the following command to determine whether the operating system still knows that the event
synchronization component is there:
swlist -v TecEvntSyncInstaller
If it is there but all the code has been deleted, or just the uninstaller is deleted, you can try this
command:
swremove TecEvntSyncInstaller
3. If errors are returned saying that TecEvntSyncInstaller cannot be removed due to consistency or
dependency checks, create a file named something like "remove_EvntSync.txt" and add these two
lines:
enforce_dependencies=false
enforce_scripts=false
Then run the swremove command as follows:

swremove -X remove_EvntSync.txt TecEvntSyncInstaller
The -X option tells the swremove command to ignore checks and dependencies and remove the
files regardless.
4. Remove any event synchronization directories that are left behind.
Remove any directories found in OM_TEC including OM_TEC itself. OM_TEC is found in
$BINDIR/TME/TEC. To use $BINDIR you must run the following command:
591
If the installation was for Netcool/OMNIbus, remove files from the location indicated during
installation.
Windows
1. Stop the situation update forwarder long running process if it is still running:
a. In the Control Panel, open Administrative Tools, then Services.
b. Find the Tivoli Situation Update Forwarder service, and right-click it and select Stop.
2. Go to operating system directory (C:\windows or C:\winnt) and open the vpd.properties file.
3. Remove all lines that have itmTecEvntSyncProduct, EvntSyncForwarder, itmTecEvntSyncLapComp
or EvntSyncForwarderWin in them.
%BINDIR%/TME/TEC. To use %BINDIR% you must run the C:\windows\system32\drivers\etc\
Tivoli\setup_env.cmd command. If the installation was for Netcool/OMNIbus, remove the files from
the location indicated during installation.
AIX
a. Find the long running process using:
ps ef

2. Go to operating system directory (this is typically /usr/lib/objrepos) and open the vpd.properties file.
4. Remove any event synchronization directories that remain.
If the installation was for Netcool/OMNIbus, remove the files from the location specified during
installation.
Linux
ps ef

2. Go to operating system directory (this is typically / or /root) and open the file vpd.properties.
If the installation was for OMNIbus, remove the files from the location specified during installation
592
Solaris
ps ef

2. Run the following command to remove the situation update forwarder:

pkgrm A ISitmTecE

If the installation was for OMNIbus, remove the files from the location specified during installation.
593
594
Appendix I. Documentation library

This appendix contains information about the publications related to IBM Tivoli Monitoring and to the
commonly shared components of Tivoli Management Services. These publications are listed in the
following categories:
v IBM Tivoli Monitoring library
v Related publications
See IBM Tivoli Monitoring and OMEGAMON XE Products: Documentation Guide, SC23-8816, for
information about accessing and using the publications. You can find the Documentation Guide in the IBM
Tivoli Monitoring and OMEGAMON XE Information Center at http://publib.boulder.ibm.com/infocenter/
tivihelp/v15r1/. To open the Documentation Guide in the information center, select Using the publications
in the Contents pane.
To find a list of new and changed publications, click What's new on the Welcome page of the IBM Tivoli
Monitoring and OMEGAMON XE Information Center. To find publications from the previous version of a
product, click Previous versions under the name of the product in the Contents pane.
IBM Tivoli Monitoring library

The following publications provide information about IBM Tivoli Monitoring and about the commonly shared
components of Tivoli Management Services:
v Quick Start Guide, GI11-8058
Introduces the components of IBM Tivoli Monitoring.
v Installation and Setup Guide, GC32-9407
Provides instructions for installing and configuring IBM Tivoli Monitoring components on Windows, Linux,
and UNIX systems.
v Upgrading from V5.1.2, GC32-1976
Gives instructions for migrating your site's custom resource models from IBM Tivoli Monitoring V5.1.2 to
IBM Tivoli Monitoring V6.2.
v Program Directory for IBM Tivoli Management Services on z/OS, GI11-4105
Gives instructions for the SMP/E installation of the Tivoli Management Services components on z/OS.
v Configuring the Tivoli Enterprise Monitoring Server on z/OS, SC32-9463
Gives detailed instructions for using the Configuration Tool to configure Tivoli Enterprise Monitoring
Server on z/OS systems. Includes scenarios for using batch mode to replicate monitoring environments
across the z/OS enterprise. Also provides instructions for setting up security and for adding application
support to a Tivoli Enterprise Monitoring Server on z/OS.
v Administrator's Guide, SC32-9408
Describes the support tasks and functions required for the Tivoli Enterprise Portal Server and clients,
including Tivoli Enterprise Portal user administration.
v High-Availability Guide for Distributed Systems, SC23-9768
Gives instructions for several methods of ensuring the availability of the IBM Tivoli Monitoring
components.
v Tivoli Enterprise Portal online help
Provides context-sensitive reference information about all features and customization options of the
Tivoli Enterprise Portal. Also gives instructions for using and administering the Tivoli Enterprise Portal.
595
v Tivoli Enterprise Portal User's Guide, SC32-9409

Complements the Tivoli Enterprise Portal online help. The guide provides hands-on lessons and detailed
instructions for all Tivoli Enterprise Portal features.
v Command Reference, SC32-6045
Provides detailed syntax and parameter information, as well as examples, for the commands you can
use in IBM Tivoli Monitoring.
v Troubleshooting Guide, GC32-9458
Provides information to help you troubleshoot problems with the software.
v Messages, SC23-7969
Lists and explains messages generated by all IBM Tivoli Monitoring components and by z/OS-based
Tivoli Management Services components (such as Tivoli Enterprise Monitoring Server on z/OS and
TMS:Engine).
v IBM Tivoli Universal Agent User's Guide, SC32-9459
Introduces you to the IBM Tivoli Universal Agent, an agent of IBM Tivoli Monitoring. The IBM Tivoli
Universal Agent enables you to use the monitoring and automation capabilities of IBM Tivoli Monitoring
to monitor any type of data you collect.
v IBM Tivoli Universal Agent API and Command Programming Reference Guide, SC32-9461
Explains the procedures for implementing the IBM Tivoli Universal Agent APIs and provides
descriptions, syntax, and return status codes for the API calls and command-line interface commands.
v Agent Builder User's Guide, SC32-1921
Explains how to use the Agent Builder for creating monitoring agents and their installation packages,
and for adding functions to existing agents.IBM Tivoli Monitoring: Upgrading from V5.1.2
Documentation for the base agents

If you purchased IBM Tivoli Monitoring as a product, you received a set of base monitoring agents as part
of the product. If you purchased a monitoring agent product (for example, an OMEGAMON XE product)
that includes the commonly shared components of Tivoli Management Services, you did not receive the
base agents.
The following publications provide information about using the base agents.
v Operating system agents:
Windows OS Agent User's Guide, SC32-9445
UNIX OS Agent User's Guide, SC32-9446
Linux OS Agent User's Guide, SC32-9447
i5/OS Agent User's Guide, SC32-9448
UNIX Log Agent User's Guide, SC32-9471
v Agentless operating system monitors:
Agentless Monitoring for Windows Operating Systems User's Guide, SC23-9765
Agentless Monitoring for AIX Operating Systems User's Guide, SC23-9761
Agentless Monitoring for HP-UX Operating Systems User's Guide, SC23-9763
Agentless Monitoring for Solaris Operating Systems User's Guide, SC23-9764
Agentless Monitoring for Linux Operating Systems User's Guide, SC23-9762
v Warehouse agents:
Warehouse Summarization and Pruning Agent User's Guide, SC23-9767
Warehouse Proxy Agent User's Guide, SC23-9766
596
v System P agents:
AIX Premium Agent User's Guide, SA23-2237
CEC Base Agent User's Guide, SC23-5239
HMC Base Agent User's Guide, SA23-2239
VIOS Premium Agent User's Guide, SA23-2238
v Other base agents:
Monitoring Agent for IBM Tivoli Monitoring 5.x Endpoint User's Guide, SC32-9490
Related publications
You can find useful information about related products in the IBM Tivoli Monitoring and OMEGAMON XE
Information Center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/.
Other sources of documentation

You can also obtain technical documentation about IBM Tivoli Monitoring and related products from the
following sources:
v IBM Tivoli Open Process Automation Library (OPAL)
http://www.ibm.com/software/tivoli/opal
OPAL is an online catalog that contains integration documentation and other downloadable product
extensions.
v Redbooks
http://www.redbooks.ibm.com/
IBM Redbooks and Redpapers include information about products from platform and solution
perspectives.
v Technotes
Technotes provide the latest information about known product limitations and workarounds. You can find
Technotes through the IBM Software Support Web site at http://www.ibm.com/software/support.
v Tivoli wikis on the IBM developerWorks Web site
Tivoli Wiki Central at http://www.ibm.com/developerworks/wikis/display/tivoli/Home is the home for
interactive wikis that offer best practices and scenarios for using Tivoli products. The wikis contain white
papers contributed by IBM employees, and content created by customers and business partners.
Two of these wikis are of particular relevance to IBM Tivoli Monitoring:
Tivoli Distributed Monitoring and Application Management Wiki at http://www.ibm.com/
developerworks/wikis/display/tivolimonitoring/Home provides information about IBM Tivoli Monitoring
and related distributed products, including IBM Tivoli Composite Application Management products.
Tivoli System z Monitoring and Application Management Wiki at http://www.ibm.com/developerworks/
wikis/display/tivoliomegamon/Home provides information about the OMEGAMON XE products,
NetView for z/OS, Tivoli Monitoring Agent for z/TPF, and other System z monitoring and application
management products.
Appendix I. Documentation library
597
598
Appendix J. Additional resources

The following sections include resources and information you can use during your Tivoli Monitoring
planning and deployment.
IBM Tivoli Monitoring 6 Welcome Kit

The purpose of this guide is to provide guidelines and reference materials to assist you in getting yourself
familiar with the Tivoli Monitoring version 6 product. It was produced with the following objectives in mind:
v Help you to effectively use Tivoli Monitoring
v Obtaining Tivoli Monitoring assistance online
v Provide additional resources for working with Tivoli Monitoring
v Introduce you to the Tivoli Monitoring Support
v Provide an image containing documents and presentations on Tivoli Monitoring
Documents can be viewed at http://www.ibm.com/support/docview.wss?rs=2366&uid=swg21253835 .
General education and support Web sites

Main Tivoli Page
http://www.ibm.com/tivoli
This is the main Tivoli page (formerly www.tivoli.com)
Main Tivoli Support Page
http://www.ibm.com/software/sysmgmt/products/support/
This is the main Tivoli Support page. All Tivoli products are listed in the drop down box in the
middle. Choosing a product takes you to the support page dedicated to the product you need help
with.
Main Tivoli Education Page
http://www.ibm.com/software/tivoli/education/
IBM Tivoli offers a variety of course types such as: online, on-site and instructor-led education.
The courses cover aspects of the Tivoli software portfolio.
Main IBM Redbook Page
http://www.redbooks.ibm.com/redbooks.nsf/redbooks/
IBM Redbooks are developed and published by IBM's International Technical Support
Organization. They deliver skills, technical know-how, and materials to technical professionals of
IBM, Business Partners, and users and to the marketplace generally.
IBM Certified Advanced Deployment Professional - Tivoli Enterprise Management Solutions
http://www.ibm.com/certify/certs/tvaden04.shtml
An IBM Certified Advanced Deployment Professional - Tivoli Enterprise Management Solutions
2004 is an individual who has demonstrated a higher level of implementation knowledge and skill
both in breadth and in depth in the IBM Tivoli Enterprise Management solutions area.
Product documentation and IBM Redbooks

IBM Tivoli Monitoring product documentation
http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/
Infrastructure Solutions: Building a Smart Bank Operating Environment, SG24-7113
http://www.redbooks.ibm.com/abstracts/sg247113.html?Open
599
Implementing OMEGAMON XE for Messaging 6.0, SG24-7357

Best Practices for SOA Management, REDP-4233
http://www.redbooks.ibm.com/abstracts/redp4233.html?Open
Deployment Guide Series: IBM Tivoli Monitoring 6.2, SG24-7444
http://www.redbooks.ibm.com/Redbooks.nsf/RedpieceAbstracts/sg247444.html?Open
Getting Started with IBM Tivoli Monitoring 6.1 on Distributed Environments, SG24-7143
Tivoli Management Services Warehouse and Reporting, SG24-7290
IBM Tivoli OMEGAMON XE V3.1 Deep Dive on z/OS, SG24-7155
http://www.redbooks.ibm.com/Redbooks.nsf/ad6437adb3f17484852568dd006f956e/
b8e023248b2d90718525706c00609acd?OpenDocument
IBM Tivoli Monitoring: Implementation and Performance Optimization for Large Scale Environments,
SG24-7443
http://www.redbooks.ibm.com/redpieces/abstracts/sg247443.html?Open
Education offerings
A listing of all the current Tivoli Monitoring training can be found at http://www.ibm.com/software/tivoli/
education/edu_prd.html#M.
The training road maps for Tivoli Monitoring can be found at http://www.ibm.com/software/tivoli/education/
eduroad_prod.html#2.
Support Technical Exchange (STE) Seminars
Expand your technical understanding of your current Tivoli products, in a convenient format hosted by IBM
Tivoli Worldwide Support and Services. These live seminars are support oriented discussions of product
information, deployment and trouble-shooting tips, common issues, problem solving resources and other
support and service recommendations. Tivoli engineers and consultants who are subject matter experts for
the product(s) discussed lead each STE. Each STE is recorded and playback is available at anytime. To
attend a live STE or review a previously recorded STE go to http://www.ibm.com/software/sysmgmt/
products/support/supp_tech_exch.html.
Service offerings
There are several Services offerings for the Tivoli Monitoring product. Access the Services offerings and
additional details on some of the offerings at the following link:
http://www.ibm.com/software/tivoli/services/consulting/offers-availability.html#monitoring
IBM QuickStart Services for Tivoli Monitoring
This offering is designed to facilitate ease of deployment and rapid time to value for Tivoli
Monitoring, allowing you to begin monitoring and reporting on your essential system resources by
providing architecture and design recommendation for production, implementation plan, hands-on
training and working test lab prototype using up to six standard resource models.
IBM Migration Assistance Services for Tivoli Monitoring
This new packaged service offering is tailored to help you obtain a clear and applicable
understanding in order to migrate an existing Tivoli based monitoring environment to the new Tivoli
Monitoring technology.
600
Tivoli Monitoring On-site

Learn from the experts! This workshop provides three days of formal education course delivery
on-site, plus two days of customized training or mentoring specific to your business needs.
Other resources
AA&BSM Enablement Best Practices website
http://www.ibm.com/software/tivoli/features/monitoring-best-practices/index.html
Tivoli AA&BSM Technical Exchange Wiki
http://www.ibm.com/developerworks/wikis/display/aabsmenbl/Home
IBM Tivoli Monitoring 6 Forum
http://www.ibm.com/developerworks/forums/dw_forum.jsp?forum=796&cat=15
Appendix J. Additional resources
601
602
Appendix K. Support for problem solving

If you have a problem with your IBM software, you want to resolve it quickly. This section describes the
following options for obtaining support for IBM software products:
v Using IBM Support Assistant
v Obtaining fixes on page 604
v Receiving weekly support updates on page 604
v Contacting IBM Software Support on page 605
Using IBM Support Assistant

The IBM Support Assistant is a free, stand-alone application that you can install on most workstations and
also use to perform remote troubleshooting of other workstations. You can enhance the application by
installing product-specific add-ons for the IBM products you use.
The IBM Support Assistant saves you the time it takes to search product, support, and educational
resources. Several troubleshooting features are provided, including the ability to perform guided
troubleshooting to aid in problem resolution and the ability to collect diagnostic information. The collected
diagnostic information can then be used to self-diagnose the problem, or it can be included in an
Electronic Service Request (ESR) submitted to IBM Support engineers. The ESR tool is used to open,
update, and report on PMRs (Problem Management Records) online. See http://www.ibm.com/software/
support/help.html for assistance in using the ESR tool.
For more information, and to download the IBM Support Assistant, see http://www.ibm.com/software/
support/isa. Currently, the add-on for this product is supported by IBM Support Assistant V4.0.1, or later.
After you download and install the IBM Support Assistant, follow these steps to install the IBM Support
Assistant add-on for the IBM Tivoli Monitoring product that you are using:
1. Start the IBM Support Assistant application.
2. From the File > Preferences > Updater preferences menu, provide the URL to update the site under
Specify an Update Site > Location.
3. Select http from the list.
4. Validate the site and click OK to confirm changes.
5. Run Update > Find new > Product Add-ons.
6. Select the appropriate plug-in
7. Read the license and description, and if you comply, select I accept the terms in the license
agreements and click Next.
8. Click Finish to proceed with the installation, and when prompted, restart the IBM Support Assistant to
complete the installation.
To collect the diagnostic files and include them in an ESR that can be sent to IBM Support engineers, view
the help files from the Help menu bar. To perform the collection of diagnostic files for self-diagnosis only,
1. Start the IBM Support Assistant application.
2. From the Home screen, select Analyze Problem.
3. In the Select A Collector dialog box, expand the appropriate product name, and select the agent for
which you want to collect diagnostic information. Choose Add.
4. After the agent or agents are added to the Collector Queue, choose Collect All to begin the collection.
5. Enter the information requested in the dialog boxes.
603
6. The final dialog box requests whether or not you want to upload the collection file to IBM Support or
another FTP location. If you only want to view the collected files on your computer, choose Do Not
FTP the Logs.
7. The collection has finished. You can view the collected files by clicking the compressed file in the
Collector Status dialog box.
Obtaining fixes
A product fix might be available to resolve your problem. To determine which fixes are available for your
Tivoli software product, follow these steps:
1. Go to the IBM Software Support Web site at http://www.ibm.com/software/support.
2. Under Select a brand and/or product, select Tivoli.
3. Click the right arrow to view the Tivoli support page.
4. Use the Select a category field to select the product.
5. Select your product and click the right arrow that shows the Go hover text.
6. Under Download, click the name of a fix to read its description and, optionally, to download it.
If there is no Download heading for your product, supply a search term, error code, or APAR number
in the field provided under Search Support (this product), and click the right arrow that shows the
Go hover text.
For more information about the types of fixes that are available, see the IBM Software Support Handbook
at http://techsupport.services.ibm.com/guides/handbook.html.
Receiving weekly support updates

To receive weekly e-mail notifications about fixes and other software support news, follow these steps:
1. Go to the IBM Software Support Web site at http://www.ibm.com/software/support.
2. Click My support in the far upper-right corner of the page under Personalized support.
3. If you have already registered for My support, sign in and skip to the next step. If you have not
registered, click register now. Complete the registration form using your e-mail address as your IBM
ID and click Submit.
4. The Edit profile tab is displayed.
5. In the first list under Products, select Software. In the second list, select a product category (for
example, Systems and Asset Management). In the third list, select a product sub-category (for
example, Application Performance & Availability or Systems Performance). A list of applicable
products is displayed.
6. Select the products for which you want to receive updates.
7. Click Add products.
8. After selecting all products that are of interest to you, click Subscribe to email on the Edit profile
tab.
9. In the Documents list, select Software.
10. Select Please send these documents by weekly email.
11. Update your e-mail address as needed.
12. Select the types of documents you want to receive.
13. Click Update.
If you experience problems with the My support feature, you can obtain help in one of the following ways:
Online
Send an e-mail message to erchelp@ca.ibm.com, describing your problem.
604
By phone
Call 1-800-IBM-4You (1-800-426-4968).
Contacting IBM Software Support

IBM Software Support provides assistance with product defects. The easiest way to obtain that assistance
is to open a PMR or Electronic Service Request (ESR) directly from the IBM Support Assistant (see Using
IBM Support Assistant on page 603).
Before contacting IBM Software Support, your company must have an active IBM software maintenance
contract, and you must be authorized to submit problems to IBM. The type of software maintenance
contract that you need depends on the type of product you have:
v For IBM distributed software products (including, but not limited to, Tivoli, Lotus, and Rational
products, and DB2 and WebSphere products that run on Windows or UNIX operating systems), enroll in
Passport Advantage in one of the following ways:
Online
Go to the Passport Advantage Web site at http://www-306.ibm.com/software/howtobuy/
passportadvantage/pao_customers.htm .
By phone
For the phone number to call in your country, go to the IBM Software Support Web site at
http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic
region.
v For customers with Subscription and Support (S & S) contracts, go to the Software Service Request
Web site at https://techsupport.services.ibm.com/ssr/login.
v For customers with IBMLink, CATIA, Linux, OS/390, iSeries, pSeries, zSeries, and other support
agreements, go to the IBM Support Line Web site at http://www.ibm.com/services/us/index.wss/so/its/
a1000030/dt006.
v For IBM eServer software products (including, but not limited to, DB2 and WebSphere products that
run in zSeries, pSeries, and iSeries environments), you can purchase a software maintenance
agreement by working directly with an IBM sales representative or an IBM Business Partner. For more
information about support for eServer software products, go to the IBM Technical Support Advantage
Web site at http://www.ibm.com/servers/eserver/techsupport.html.
If you are not sure what type of software maintenance contract you need, call 1-800-IBMSERV
(1-800-426-7378) in the United States. From other countries, go to the contacts page of the IBM Software
Support Handbook on the Web at http://techsupport.services.ibm.com/guides/contacts.html and click the
name of your geographic region for phone numbers of people who provide support for your location.
To
1.
2.
3.
contact IBM Software support, follow these steps:

Determining the business impact
Describing problems and gathering information on page 606
Submitting problems on page 606
Determining the business impact

When you report a problem to IBM, you are asked to supply a severity level. Use the following criteria to
understand and assess the business impact of the problem that you are reporting:
Severity 1
The problem has a critical business impact. You are unable to use the program, resulting in a
critical impact on operations. This condition requires an immediate solution.
Severity 2
The problem has a significant business impact. The program is usable, but it is severely limited.
Appendix K. Support for problem solving
605
Severity 3
The problem has some business impact. The program is usable, but less significant features (not
critical to operations) are unavailable.
Severity 4
The problem has minimal business impact. The problem causes little impact on operations, or a
reasonable circumvention to the problem was implemented.
Describing problems and gathering information

When describing a problem to IBM, be as specific as possible. Include all relevant background information
so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know
the answers to these questions:
v Which software versions were you running when the problem occurred?
v Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software
Support is likely to ask for this information.
v Can you re-create the problem? If so, what steps were performed to re-create the problem?
v Did you make any changes to the system? For example, did you make changes to the hardware,
operating system, networking software, and so on.
v Are you currently using a workaround for the problem? If so, be prepared to explain the workaround
when you report the problem.
Submitting problems
You can submit your problem to IBM Software Support in one of two ways:
Online
Click Submit and track problems on the IBM Software Support site at http://www.ibm.com/
software/support/probsub.html. Type your information into the appropriate problem submission
form.
By phone
For the phone number to call in your country, go to the contacts page of the IBM Software Support
Handbook at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your
geographic region.
If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM
Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the
problem in detail. Whenever possible, IBM Software Support provides a workaround that you can
implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the
Software Support Web site daily, so that other users who experience the same problem can benefit from
the same resolution.
606
Appendix L. Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the
products, services, or features discussed in this document in other countries. Consult your local IBM
representative for information on the products and services currently available in your area. Any reference
to an IBM product, program, or service is not intended to state or imply that only that IBM product,
program, or service may be used. Any functionally equivalent product, program, or service that does not
infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to
evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document.
The furnishing of this document does not give you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785 U.S.A.
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS"
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE.
Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this
statement might not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this one)
and (ii) the mutual use of the information which has been exchanged, should contact:
607
IBM Corporation
2Z4A/101
11400 Burnet Road
Austin, TX 78758 U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases
payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by
IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any
equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results
obtained in other operating environments may vary significantly. Some measurements may have been
made on development-level systems and there is no guarantee that these measurements will be the same
on generally available systems. Furthermore, some measurement may have been estimated through
extrapolation. Actual results may vary. Users of this document should verify the applicable data for their
specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their
published announcements or other publicly available sources. IBM has not tested those products and
cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice,
and represent goals and objectives only.
All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without
notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to change before the
products described become available.
This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. You may copy, modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application programs conforming to
IBMs application programming interfaces.
Each copy or any portion of these sample programs or any derivative work, must include a copyright
notice as follows:
(your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs.
Copyright IBM Corp. _enter the year or years_. All rights reserved.
608
If you are viewing this information in softcopy form, the photographs and color illustrations might not be
displayed.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at
Copyright and trademark information at www.ibm.com/legal/copytrade.shtml.
Java and all Java-based trademarks and logos are trademarks or registered trademarks
of Sun Microsystems, Inc. in the United States, other countries, or both.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, and service names may be trademarks or service marks of others.
Appendix L. Notices
609
610
Appendix M. Accessibility features for IBM Tivoli Monitoring

Accessibility features help users who have a disability, such as restricted mobility or limited vision, to use
information technology products successfully.
Accessibility features
The following list includes the major accessibility features in IBM Tivoli Monitoring:
v Keyboard-only operation
v Interfaces that are commonly used by screen readers
v Keys that are discernible by touch but do not activate just by touching them
v Industry-standard devices for ports and connectors
v The attachment of alternative input and output devices
The Tivoli Monitoring Information Center and its constituent publications are accessibility-enabled. The
accessibility features of the information center are described at http://publib.boulder.ibm.com/infocenter/
tivihelp/v15r1/.
IBM and accessibility

See the IBM Human Ability and Accessibility Center for more information about the commitment that IBM
has to accessibility:
http://www.ibm.com/able
611
612
Glossary
A
activity. One phase within a sequence of predefined
steps called a policy that automate system responses
to a situation that has fired (that is, become true).
administration mode. See workspace administration
mode on page 623.
Advanced Encryption Standard. An encryption
algorithm for securing sensitive but unclassified material
designed by the National Institute of Standards and
Technology (NIST) of the U.S. Department of
Commerce. AES is intended to be a more robust
replacement for the Data Encryption Standard. The
specification calls for a symmetric algorithm (in which
the same key is used for both encryption and
decryption), using block encryption of 128 bits and
supporting key sizes of 128, 192 and 256 bits. The
algorithm was required to offer security of a sufficient
level to protect data for the next 20 to 30 years. It had
to be easily implemented in hardware and software and
had to offer good defenses against various attack
techniques. AES has been published as Federal
Information Processing Standard (FIPS) 197, which
specifies the encryption algorithm that all sensitive,
unclassified documents must use.
AES. See Advanced Encryption Standard.
affinity. A label that classifies objects by managed
system.
agent. Software installed on systems you want to
monitor that collects data about an operating system,
subsystem, or application running on each such system.
Because an executable file gathers information about a
managed system, there is always a one-to-one
correspondence between them. Also called a Tivoli
Enterprise Monitoring Agent.
agentless monitor. An agentless monitor uses a
standard API (such as SNMP or CIM) to identify and
notify you of common problems with the operating
system running on a remote computer. Thus, as their
name implies, the agentless monitors can retrieve
monitoring and performance data without requiring OS
agents on the computers being monitored. The
agentless monitors provide monitoring, data gathering,
and event management for Windows, Linux, AIX,
HP-UX, and Solaris systems.
agentless monitoring server. A computer that has
one or more agentless monitors running on it. Each
agentless monitoring server can support up to 10 active
instances of the various types of agentless monitors, in
any combination. Each instance can communicate with
up to 100 remote nodes, which means a single

agentless monitoring server can support as many as
1000 monitored systems.
alert. A warning message or other indication that
appears at a console to indicate that something has
occurred or is about to occur that may require
intervention.
alert monitor. A monitoring agent that monitors and
relays alert information to the monitoring server.
Sources of alerts include message logs, system
consoles, and network and system management
products.
algorithm. A set of well-defined rules for the solution
of a problem in a finite number of steps. For example, a
full statement of an arithmetic procedure for evaluating
sin(x) to a stated precision.
API. See Application Programming Interface.
application. A software component or collection of
software components that performs specific
user-oriented work (a task) on a computer. Examples
include payroll, inventory-management, and
word-processing applications.
Application Programming Interface. A set of multiple
subprograms and data structures and the rules for using
them that enables application development via a
particular language and, often, a particular operating
environment. An API is a functional interface supplied
by the operating system or by a separately licensed
program that allows an application program written in a
high-level language to use specific data or functions of
the operating system or the licensed program.
arithmetic expression. A statement containing any
combination of values joined together by one or more
arithmetic operators in such a way that the statement
can be processed as a single numeric value.
arithmetic operator. A symbol representing a
mathematical operation (addition, subtraction,
multiplication, division, or exponentiation), such as +, -,
*, /, or ^.
associate. The process of linking a situation with a
Navigator item that enables a light to go on and a
sound to play for an open event. Predefined situations
are associated automatically, as are situations created
or edited through the Navigator item pop-up menu.
When you open the Situation editor from the toolbar,
any situations you create cannot be associated with a
Navigator item during this editing session. You need to
close the Situation editor, and then open it again from
the pop-up menu of the Navigator item with which the
situation is associated.
613
attribute. (1) A system or application element being

monitored by the monitoring agent, such as Disk
Name and Disk Read/Writes Per Second. (2) A
characteristic of a managed object; that is, a field in
the data structure of a managed object or in the
workspace associated with that managed object. (3) A
field in an ODBC-compliant database.
attribute group. A set of related attributes that can
be combined in a data view or a situation. When you
open the view or start the situation, data samples of the
selected attributes are retrieved. Each type of
monitoring agent has its own set of attribute groups.
B
baroc files. Basic Recorder of Objects in C files define
event classes for a particular IBM Tivoli Enterprise
Console server. Baroc files also validate event formats
based on these event-class definitions.
browser client. The software installed with the Tivoli
Enterprise Portal Server that is downloaded to your
computer when you start Tivoli Enterprise Portal in
browser mode. The browser client runs under the
control of a Web browser.
C
Candle Management Workstation. The client
component of a CandleNet Command Center
environment; it provides the graphical user interface. It
is replaced by the Tivoli Enterprise Portal user interface
in the IBM Tivoli Monitoring environment.
capacity planning. The process of determining the
hardware and software configuration required to
accommodate the anticipated workload on a system.
chart. A graphical view of data returned from a
monitoring agent. A data point is plotted for each
attribute chosen and, for bar and pie charts, a data
series for each row. Types of charts include pie, bar,
plot, and gauge.
application processing. In IBM Tivoli Monitoring the

Tivoli Enterprise Portal is the client to the Tivoli
Enterprise Portal Server, whereas the portal server is
the client to the Tivoli Enterprise Monitoring Server.
A database server maintains the databases and
processes requests from the client to extract data from
or to update the database. An application server
provides additional business-support processing for the
clients.
Common Information Model. An XML-based
standard for defining device and application
characteristics so that system administrators and
management programs can monitor and control them
using the same set of tools, regardless of their differing
architectures. CIM provides a more comprehensive
toolkit for such management functions than the Simple
Network Management Protocol.
Common Object Request Broker Architecture. An
industry specification for the design and standardization
of different types of object request brokers (ORBs).
ORBs allow different computers to exchange object
data; CORBA enables ORBs from different software
vendors (often running under dissimilar computer
systems and operating systems) to exchange object
data. CORBA facilitates communication among program
components in a network using objects. The Tivoli
Enterprise Portal Server is a CORBA implementation.
condition. An expression that evaluates to either true
or false. It can be expressed in natural language text, in
mathematically formal notation, or in a
machine-readable language.
Configure History permission. Your user ID must
have Configure History permission to open the History
Collection Configuration window for setting up history
files and data rolloff. If you do not have this permission,
you cannot see the menu item or tool for historical
configuration.
CIM. See Common Information Model.
Configuration Tool, z/OS (ICAT). A REXX-based tool

for configuring OMEGAMON XE products running on
zSeries systems, after they have been installed using
the System Modification Program/Extended (SMP/E)
tool.
class file. A file containing Java object code for a

single Java object class.
CORBA. See Common Object Request Broker

Architecture.
class loader. A Java component that loads Java class

files.
critical state. The indication that a situation

associated with a Navigator item is in an unacceptable
state and that you must take corrective action. The
critical state is represented by the color red.
client. An application that receives requested data

from a server.
client/server architecture. An architecture in which
the client (usually a personal computer or workstation)
is the machine requesting data or services and the
server is the machine supplying them. Servers can be
microcomputers, minicomputers, or mainframes. The
client provides the user interface and may perform
614
Custom Navigator Views permission. Your user ID

has a Modify check box for the Custom Navigator Views
feature. This permission must be enabled for you to
open the Navigator view editor to maintain and update
Navigator views.
D
Data Encryption Standard. A widely used method of
private-key data encryption that originated at IBM in
1977 and was adopted by the U.S. Department of
Defense. DES supports 72 quadrillion or more possible
encryption keys; for each message, the key is chosen at
random from among this enormous number of possible
keys. Like all other private-key cryptographic methods,
both the sender and the receiver must know and use
the same private key.
DES applies a 56-bit key to each 64-bit block of data.
Although this is considered strong encryption, many
companies use triple DES, which applies three keys in
succession.
data source name. The name that is stored in the
database server and that enables you to retrieve
information from the database through ODBC. The DSN
includes such information as the database name,
database driver, user ID, and password.
data sources. Data pertaining to J2EE data sources,
which are logical connections to database subsystems.
data warehouse. A central repository for all or
significant parts of the data that an organization's
business systems collect.
DES. See Data Encryption Standard.

desktop client. Software supplied with IBM Tivoli
Monitoring that you install on a workstation that you
plan to use for interacting with the Tivoli Enterprise
Portal Server and the Tivoli Enterprise Monitoring
Server. The desktop Tivoli Enterprise Portal client
provides the graphical user interface into the IBM Tivoli
Monitoring network.
detailed attribute name. The name used in formulas,
expert advice, Take Action commands, and headers
and footers when referencing a monitoring agent
attribute. In the Properties and Situation editors, you
click Show Formula, and then check Show detailed
formula to see the detailed attribute name.
display item. An attribute designated to further
qualify a situation. With a display item set for a
multiple-row attribute group, the situation continues to
look at the other rows in the sample and opens more
events if other rows qualify. The value displays in the
event workspace and in the message log and situation
event console views. You can select a display item
when building a situation with a multiple-row attribute
group.
distribution. The managed systems on which the
situation is running.
database. A collection of both interrelated and

independent data items that are stored together on a
computer disk to serve multiple applications.
DLL. See Dynamic Link Library.
DB2 for the workstation. IBM's DB2 Database for

Linux, UNIX, and Windows systems is a relational
database management system that runs on desktop
computers. You install a DB2 database on the same
system as the Tivoli Enterprise Portal Server; it stores
the portal server's queries, customized workspaces,
user IDs, and custom Navigator views. DB2 for the
workstation can also serve as the data repository for the
Tivoli Data Warehouse, which stores historical
monitoring information.
drill down. To access information by starting with a

general category and moving through the hierarchy of
information, for example, in a database, to move from
file to record to field.
default. Pertaining to an attribute, value, or option

that is assumed when none is explicitly specified.
Demilitarized Zone. The area of a World Wide Web
application that a company can use to host Internet
services without allowing unauthorized access.
Derby. An open-source, public-domain, relational
database management system implemented in Java
and designed to conform to accepted database
standards (such as SQL and JDBC). Derby came about
when IBM contributed its Cloudscape database
manager to the Apache project and features a small
machine footprint. IBM Tivoli Monitoring implements
Derby as an embedded database within its Tivoli
Enterprise Portal Server; in other words, the database
is installed with the portal server, and it runs within the
portal server's Java virtual machine.
DMZ. See Demilitarized Zone.
DSN. See data source name.

Dynamic Link Library. A composite of one or more
executable objects that is bound together by a linking
procedure and loaded at run time (rather than when the
application is linked). The code and data in a dynamic
link library can be shared by several applications
simultaneously. DLLs apply only to Windows operating
environments.
E
EIB. See Enterprise Information Base.
EIF. See Event Integration Facility on page 616.
endcode. You assign endcodes in a policy when you
connect one activity to another. The endcode indicates
the result of this activity that triggers the next activity.
Enterprise Information Base. A database used by the
Tivoli Enterprise Monitoring Server that serves as a
repository of shared objects for all systems across your
enterprise. The EIB stores all persistent data, including
Glossary
615
situations, policies, user definitions, and

managed-object definitions.
enterprise situation. A situation that is created for a
Tivoli Enterprise Monitoring Agent that reports events to
the Tivoli Enterprise Monitoring Server to which it
connects. Enterprise situations are centrally defined at
the monitoring server and distributed at agent startup.
See also situation on page 621.
event. An action or some occurrence, such as running
out of memory or completing a transaction, that can be
detected by a situation. Events cause a change in the
state of a managed object associated with a situation,
thereby make the situation true and causing an alert to
be issued.
event indicator. The colored icon that displays over a
Navigator item when an event opens for a situation
running on that item.
Event Integration Facility. An application
programming interface that external applications can
invoke to create, send, or receive IBM Tivoli Enterprise
Console events. These events are referred to as either
EIF events or TEC/EIF events.
event item. A Navigator item that shows when you
open the event workspace for a true situation (by
selecting it from the event flyover listing or from the
situation event console pop-up menu).
event sound. The sound file that plays when an event
opens. This sound file is set in the Situation editor when
the situation is associated with a Navigator item and
can differ for different Navigator items.
expert advice. A description within the Situation editor
of each situation provided with a monitoring agent to
help you quickly understand and interpret events arising
from it.
Extensible Markup Language. A data-description
language derived from Standard Generalized Markup
Language (SGML); also a tool for encoding messages
so they describe their own fields. You use XML to
format a document as a data structure. As program
objects, such documents can have their contents and
data hidden within the object, which allows you to
control who can manipulate the document and how. In
addition, documents can carry with them the
object-oriented procedures called methods. The XML
standard aids in exchanging data between applications
and users.
F
filter criteria. These criteria limit the amount of
information returned to the data view in response to a
query. You can apply a prefilter to the query to collect
616
only certain data, or apply a postfilter to the view

properties to show only certain data from the
information collected.
G
georeferenced map. A special type of graphic that
has built-in knowledge of latitude and longitude and can
be zoomed into and out of quickly. The Tivoli Enterprise
Portal uses proprietary .IVL files generated with the
map-rendering component. These files cannot be
opened or saved in a graphics editor.
GSKit. The Global Security Toolkit provides SSL
(Secure Sockets Layer) processing within protocols
such as SPIPE and HTTPS. On z/OS systems, GSKit is
known as the Integrated Cryptographic Service Facility,
or ICSF.
H
historical collection. A definition for collecting and
storing data samples for historical reporting. The
historical collection identifies the attribute group, any
row filtering you have assigned, the managed system
distribution, frequency of data collection, where to
store it for the short term, and whether to save data
long term (usually to the Tivoli Data Warehouse).
historical data management. The procedures applied
to short-term binary history files that roll off historical
data to either the Tivoli Data Warehouse or to
delimited text files (the krarloff utility on UNIX or
Windows systems; ddname KBDXTRA for the z/OS
Persistent Datastore), and then delete entries in the
short-term history files over 24 hours old, thereby
making room for new entries.
hot standby. A redundant Tivoli Enterprise
Monitoring Server that, if the primary or hub
monitoring server should fail, assumes the
responsibilities of the failed monitoring server.
HTTP. The Hypertext Transfer Protocol is a suite of
Internet protocols that transfer and display hypertext
documents within Web browsers.
HTTP sessions. Data related to invocations of specific
World Wide Web sites.
HTTPS. The Secure Hypertext Transport Protocol is an
implementation of the Hypertext Transport Protocol
(HTTP) that relies on either the Secure Sockets Layer
(SSL) API or the Transport Layer Security (TLS) API to
provide your users with secure access to your site's
Web server. These APIs encrypt and then decrypt user
page requests as well as the pages returned by the
Web server.
hub Tivoli Enterprise Monitoring Server. (1) A
central host system that collects the status of situations
running on your systems. (2) The monitoring server that

your site has selected to act as the focal point to which
all portal servers and remote monitoring servers in this
monitored network connect. A remote monitoring server
passes its collected data to the hub to be made
available to clients, creating an enterprise-wide view.
I
IBM Tivoli Monitoring. A client/server
implementation for monitoring enterprise-wide computer
networks that comprises a Tivoli Enterprise
Monitoring Server, an application server known as the
Tivoli Enterprise Portal Server, one or more Tivoli
Enterprise Portal clients, and multiple monitoring
agents that collect and distribute data to the monitoring
server.
IIOP. See Internet Inter-ORB Protocol.
input data. Data provided to the computer for further
processing. See also output data on page 619.
integral Web server. A proprietary Web server
developed for IBM Tivoli Monitoring that is installed and
configured automatically with the Tivoli Enterprise
Portal Server. You enter the URL of the integral Web
server to start the Tivoli Enterprise Portal client in
browser mode.
Internet Inter-ORB Protocol. An Internet
communications protocol that runs on distributed
platforms. Using this protocol, software programs written
in different programming languages and running on
distributed platforms can communicate over the Internet.
IIOP, a part of the CORBA standard, is based on the
client/server computing model, in which a client
program makes requests of a server program that waits
to respond to client requests. With IIOP, you can write
client programs that communicate with your site's
existing server programs wherever they are located
without having to understand anything about the server
other than the service it performs and its address
(called the Interoperable Object Reference, IOR, which
comprises the server's port number and IP address).
Interoperable Object Reference. Connects clients to
the Tivoli Enterprise Portal Server. The IOR identifies
a remote object, including such information as name,
capabilities, and how to contact it. The URL may include
an IOR because it goes through the Web server; the
portal server uses it to tell the client which IOR to fetch.
After it does that, the portal server extracts the host and
port information and tells the client where to route the
request.
interval. The number of seconds that have elapsed
between one sample and the next.
IOR. See Interoperable Object Reference.
J
Java Database Connectivity. A standard API that
application developers use to access and update
relational databases (RDBMSes) from within Java
programs. The JDBC standard is based on the X/Open
SQL Call Level Interface (CLI) and complies with the
SQL-92 Entry Level standard; it provides a
DBMS-independent interface that enables
SQL-compliant database access for Java programmers.
Java Management Extensions. A set of Java classes
for application and network management in J2EE
environments. JMX provides Java programmers a set of
native Java tools called MBeans (managed beans) that
facilitate network, device, and application management.
JMX provides a Java-based alternative to the Simple
Network Management Protocol.
JDBC. See Java Database Connectivity.
JMX. See Java Management Extensions.
L
LDAP. See Lightweight Directory Access Protocol.
Lightweight Directory Access Protocol. A protocol
that conforms to the International Standards
Organization's X.500 directory standard that uses
TCP/IP to access directory databases where
applications can store and retrieve common naming
and location data. For example, applications can use
LDAP to access such directory information as email
addresses, service configuration parameters, and public
keys.
location broker. The component that manages
connections for the hub monitoring server, enabling it to
find all other Tivoli Management Services
components, including remote monitoring servers, the
Tivoli Enterprise Portal Server, and monitoring
agents.
M
managed object. An icon created in the Tivoli
Enterprise Portal from a managed object template that
represents resources you monitor using situations.
Managed objects are converted to items in the
Navigator's Logical view.
managed system. A particular operating system,
subsystem, or application in your enterprise where a
monitoring agent is installed and running. A managed
system is any system that IBM Tivoli Monitoring is
monitoring.
managed system group. (Formerly managed system
list.) A named, heterogeneous group of both similar and
dissimilar managed systems organized for the
Glossary
617
distribution of historical collections, situations, and

policies, and for assignment to queries and items in
custom Navigator views. For example, you might create
a managed system group named IT_London for a
geographic region and another named Credit_Approval
for a functional area of your organization.
If a managed system group is updated (usually when a
constituent managed system is added or deleted), then
all the historical collections, situations, and policies that
use that group are redistributed to all managed systems
in the group. Managed system groups are created,
modified, or deleted either by the Tivoli Enterprise
Portal's Object Group editor or via the tacmd CLI
command with the createsystemlist, editsystemlist, or
deletesystemlist keywords; they are maintained by the
Tivoli Enterprise Monitoring Server.
MBeans. Managed beans are Java objects that
represent managed resources such as devices,
services, and applications. The management functions
are provided by the MBean server.
middleware. Software that enables the exchange of
information between components in a distributed
computing environment. The middleware is the
data-exchange and communications channel that allows
programs to cooperate with each other without having to
know details about how they are implemented or where
they are deployed. Middleware typically provides a
range of related facilities such as persistence, auditing,
and the ability to build a transactional unit of work.
IBM's CICS and WebSphere MQ are examples of
middleware.
migrating. Preserving your customized configuration
data so you can use it again after installing a newer
version of the product.
monitor. An entity that performs measurements to
collect data pertaining to the performance, availability,
reliability, or other attributes of applications or the
systems on which those applications rely. These
measurements can be compared to predefined
thresholds. If a threshold is exceeded, administrators
can be notified, or predefined automated responses can
be performed.
monitor interval. A specified time, scalable to
seconds, minutes, hours, or days, for how often the
monitoring server checks to see if a situation has
become true. The minimum monitor interval is 30
seconds; the default value is 15 minutes.
monitoring. Running a hardware or software tool to
monitor the performance characteristics of a system.
N
NAT. See Network Address Translation.
618
Navigator. The upper-left pane of the Tivoli Enterprise

Portal window. The Navigator Physical view shows your
network enterprise as a physical hierarchy of systems
grouped by platform. You can also define other views
that create logical hierarchies grouped as you specify,
such as by department or function.
Network Address Translation. A scheme used by
local-area networks (LANs) to establish an internal and
external set of IP addresses. Internal IP addresses are
kept private and must be translated to and from the
external addresses for outbound and inbound
communications. NAT is often used in firewall
configurations.
Network File System. A client/server file system
developed by Sun Microsystems that, once mounted
(that is, made accessible), allows a user on an NFS
client to view, store, and update files on a remote
computer (the NFS server) as though they were on the
user's own computer. The portion of the mounted file
system that each user can access and in what ways is
determined by the user's own file-access privileges and
restrictions.
Both the NFS server and client use TCP/IP's User
Datagram Protocol as the mechanism for sending file
contents and updates back and forth. NFS has been
designated a file server standard; it uses the Remote
Procedure Call method of communication between
computers.
NFS. See Network File System.
node. (1) In networking, a point capable of sending
and receiving data. A node can be a device, such as
printer or workstation, a system, a storage location on a
disk, or a single computer. (2) Any managed system,
such as an AIX-based pSeries server, that IBM Tivoli
Monitoring is monitoring. A node can also be a
managed system of subnodes, all of which are being
managed as components of the primary node.
non-agent bundles. You can use these custom
bundles to remotely deploy components that need not
connect to a Tivoli Enterprise Monitoring Server,
such as those that support other Tivoli products like IBM
Tivoli Netcool/OMNIbus.
O
object. An instance of a class, which comprises an
implementation and an interface. An object reflects its
original, holding data and methods and responds to
requests for services. CORBA defines an object as a
combination of state and a set of methods characterized
by the behavior of relevant requests.
ODBC. See Open Database Connectivity on page
619.
OMEGAMON Monitoring Agent. The software

process that probes a managed z/OS system or
subsystem (such as CICS) for data. The monitoring
agent sends that monitoring information back to the
Tivoli Enterprise Monitoring Server and then on to
the Tivoli Enterprise Portal Server to be formatted into
table and chart views for display on a Tivoli Enterprise
Portal client.
OMEGAMON Dashboard Edition (OMEGAMON DE).
The OMEGAMON implementation that includes all the
features of Tivoli Enterprise Portal provided with
OMEGAMON XE, plus application-integration
components that facilitate an enterprise-wide view of
your computing environment. OMEGAMON DE's
workspaces integrate the data from multiple
OMEGAMON Monitoring Agents into one
network-wide view.
OMEGAMON Extended Edition (OMEGAMON XE).
The IBM Tivoli Monitoring implementation of a single
OMEGAMON Monitoring Agent. OMEGAMON XE
displays the monitoring data from each OMEGAMON
Monitoring Agent independently, without integrating it
into the enterprise-wide workspaces provided by
OMEGAMON DE.
OMEGAMON Tivoli Event Adapter. Invokes the
Event Integration Facility API to synchronize IBM
Tivoli Monitoring events with the IBM Tivoli Enterprise
Console product. OTEA is a component of the Tivoli
Enterprise Monitoring Server; it forwards IBM Tivoli
Monitoring events to Tivoli Enterprise Console and
maps them to their corresponding Tivoli Enterprise
Console event classes based on the situation name's
suffix, either _Warning or _Critical.
Integrating these products requires two parts: a Tivoli
Enterprise Monitoring Server piece (included with IBM
Tivoli Monitoring version 6.1 and subsequent releases)
called the OMEGAMON Tivoli Event Adapter, and a
Tivoli Enterprise Console piece called the Situation
Update Forwarder that is installed on the Tivoli
Enterprise Console server.
Open Database Connectivity. A standard API for
accessing data in both relational and nonrelational
database systems using procedural, non-object-based
languages such as C. Using this API, database
applications can access data stored in database
management systems on a variety of computers even if
each database management system uses a different
data storage format and programming interface.
Tivoli Enterprise Portal users can access the Query
editor to write custom SQL queries for creating views
that retrieve data from ODBC-compliant databases.
OTEA. See OMEGAMON Tivoli Event Adapter.
output data. Data resulting from computer processing.
See also input data on page 617.
parameter. A value or reference passed to a function,

command, or program that serves as input or to control
actions. The value is supplied by a user or by another
program or process.
P
PDS. See Persistent Datastore.
PerfMon. See Performance Monitor
performance. A major factor in measuring system
productivity. Performance is determined by a
combination of throughput, response time, and
availability.
Performance Monitor (PerfMon). The Windows
Performance Monitor is an SNMP-based
performance-monitoring tool for Windows environments.
PerfMon monitors network elements such as computers,
routers, and switches.
Persistent Datastore. A set of z/OS data sets where
IBM Tivoli Monitoring running on z/OS systems stores
historical monitoring data.
platform. The operating system on which the
managed system is running, such as z/OS or Linux.
The Navigator's Physical mapping places the platform
level under the Enterprise level.
policy. A set of automated system processes that can
perform actions, schedule work for users, or automate
manual tasks, frequently in response to events.
Policies are the IBM Tivoli Monitoring automation tool;
they comprise a series of automated steps, called
activities, whose order of execution you control.
In most cases, a policy links a Take Action command
to a situation that has turned true. When started, the
policy's workflow progresses until all activities have
been completed or until the Tivoli Enterprise Portal user
manually stops the policy. You can create both policies
that fully automate workflow strategies and those that
require user intervention. As with situations, policies are
distributed to the managed systems you want to
monitor and to which you are sending commands.
private situation. A situation that is defined in an
XML-based private configuration file for the local Tivoli
Enterprise Monitoring Agent or Tivoli System Monitor
Agent and that does not interact with a Tivoli
Enterprise Monitoring Server. Such events can be
sent via either EIF or SNMP alerts to a receiver such
as IBM Tivoli Enterprise Console or Netcool/OMNIbus.
See also situation on page 621.
product code. The three-letter code used by IBM
Tivoli Monitoring to identify the product component. For
example, the product code for IBM Tivoli Monitoring for
WebSphere Application Server is KWE.
Glossary
619
Properties editor. A multi-tabbed window for

specifying the properties of the individual views that
make up a workspace, as well as the general
workspace properties.
runtime environment. A group of execution libraries

that provide an operational environment on a z/OS
system. RTEs execute OMEGAMON products on a
z/OS image.
pure event. A pure event is one that occurs

automatically, such as when a paper-out condition
occurs on the printer or when a new log entry is written.
Situations written to notify you of pure events remain
true until they are manually closed or automatically
closed by an UNTIL clause. See also event on page
616.
runtime libraries. Libraries in the runtime

environment that the product uses when it is started
and running.
Q
query. A particular view of specified attributes of
selected instances of a set of managed-object classes,
arranged to satisfy a user request. Queries are written
using SQL.
R
remote deployment. Using IBM Tivoli Monitoring
software, you can deploy agents and other non-agent,
Tivoli Management Services-based components to
remote nodes without your having to sign onto those
nodes and perform the installation and configuration
steps yourself. Remote deployment requires two pieces
on the destination node: (1) a bundle containing the
component code and the instructions for installing and
configuring it and (2) an operating-system agent to read
the bundle and perform the installation and
configuration steps.
Remote Procedure Call. A protocol based on the
Open Software Foundation's Distributed Computing
Environment (DCE) that allows one program to request
services from a program running on another computer
in a network. RPC uses the client/server model: the
requesting program is the client, and the responding
program is the server. As with a local procedure call
(also known as a function call or a subroutine call),
an RPC is a synchronous operation: the requesting
program is suspended until the remote procedure
returns its results.
remote Tivoli Enterprise Monitoring Server. A
remote monitoring server collects monitoring data from
a subset of your site's monitoring agents and passes its
collected data to the hub Tivoli Enterprise Monitoring
Server to be made available to one or more Tivoli
Enterprise Portal clients through the Tivoli Enterprise
Portal Server, thereby creating an enterprise-wide view.
rolloff. The transfer of monitoring data to a data
warehouse.
RPC. See Remote Procedure Call.
RTE. See runtime environment.
620
S
sample. The data that the monitoring agent collects
for the monitoring server instance. The interval is the
time between data samplings.
sampled event. Sampled events happen when a
situation becomes true. Situations sample data at
regular intervals. When the situation becomes true, it
opens an event, which gets closed automatically when
the situation goes back to false (or when you close it
manually). See also event on page 616.
Secure Sockets Layer. A security protocol for
communication privacy that provides secure
client/server conversations.
seed data. The product-provided situations,
templates, policies, and other sample data included
with a monitoring agent to initialize the Tivoli
Enterprise Monitoring Server's Enterprise
Information Base. Before you can use a monitoring
agent, the monitoring server to which it reports must be
seeded, that is, initialized with application data.
server. An application that satisfies data and service
requests from clients.
SELinux. The National Security Agency's
security-enhanced Linux (SELinux) is a set of patches
to the Linux kernel plus utilities that together incorporate
a strong, flexible mandatory access control (MAC)
architecture into the kernel's major subsystems.
SELinux enforces the separation of information based
on confidentiality and integrity requirements, which
allows attempts to tamper with or bypass application
security mechanisms to be recorded and enables the
confinement of damage caused by malicious or flawed
applications.
Simple Network Management Protocol. A TCP/IP
transport protocol for exchanging network management
data and controlling the monitoring of network nodes in
a TCP/IP environment. The SNMP software protocol
facilitates communications between different types of
networks. IBM Tivoli Monitoring uses SNMP messaging
to discover the devices on your network and their
availability.
Simple Object Access Protocol. The Simple Object
Access Protocol is an XML-based interface that vendors
use to bridge remote procedure calls between
competing systems. SOAP makes it unnecessary for

sites to choose between CORBA/Java/EJB and
Microsoft's COM+.
Because XML and SOAP are platform- and
language-neutral, users can mix operating systems,
programming languages, and object architectures yet
maintain business-component interoperability across
platforms: using SOAP, applications can converse with
each other and exchange data over the Internet,
regardless of the platforms on which they run.
situation. The set of monitored conditions running on
a managed system that, when met, creates an event.
A situation comprises an attribute, an operator such as
greater than or equal to, and a value. It can be read as
If system_condition compared_to value is_true. An
example of a situation is: If CPU_usage > 90% TRUE.
The expression CPU_usage > 90% is the situation
condition.
Situation Update Forwarder. The Situation Update
Forwarder is a Java- and CORBA-based background
process for communication between IBM Tivoli
Enterprise Console and a particular Tivoli Enterprise
Monitoring Server running under IBM Tivoli Monitoring
version 6.1 and subsequent releases. Your site must
install this component on the Tivoli Enterprise Console
server; for instructions, see the IBM Tivoli Enterprise
Console Installation Guide.
SNMP. See Simple Network Management Protocol
on page 620.
SOAP. See Simple Object Access Protocol on page
620.
sockets. Refers to the sockets method of passing data
back and forth between a networked client and server
or between program layers on the same computer.
sound. The WAV file that plays whenever a situation
becomes true for the current Navigator item. Sound is
assigned to the Navigator item for a situation in the
same way a state is assigned.
SPIPE. A secure pipe is an implementation of the
Internet Protocol's pipe specification that uses the
Secure Sockets Layer API. Using SPIPE, your
corporate Web server can securely access internal
servers that are not based on the HTTPS protocol,
while retaining their ability to process HTTP requests.
SQL. See Structured Query Language.
SSL. See Secure Sockets Layer on page 620.
SSM. See System Service Monitors.
state. The severity of the situation event: critical,
warning, or informational. Indicated by a colored event
indicator, state is set in the Situation editor and can be
different for different Navigator items.
status. The true or false condition of a situation.

Structured Query Language. A standards-based
programming language for extracting information from
and updating information within a relational database.
The Query editor enables you to write SQL queries to
ODBC data sources for retrieval and display in table
and chart views.
subnetwork. A configuration wherein a single IP
network address is split up so it can be used on several
interconnected local networks. Subnetworking is a local
configuration; outside it appears as a single IP network.
SUF. See Situation Update Forwarder.
Summarization and Pruning agent. One of the IBM
Tivoli Monitoring base agents, the Summarization and
Pruning agent keeps the data warehouse from growing
too large by summarizing and pruning your stored
historical data at intervals you set. For every attribute
group that has data collection configured, you specify
how often to aggregate (summarize) data in the Tivoli
Data Warehouse and the length of time to delete
(prune) data from the warehouse.
symbol. Represents a variable that can be added to
header or footer text for data views, expert-advice text,
or query specification. The detailed attribute name is
enclosed in dollar signs, such as $ORIGINNODE$, and
resolves to the attribute's value. For Tivoli Enterprise
Monitoring Server queries, == $NODE$ specifies the
managed systems from which to retrieve data. For
queries to be used in link target workspaces, you can
create symbols for attributes using the $symbolname$
format.
System Monitor Agent. These agents were
introduced with IBM Tivoli Monitoring V6.2.2 for nodes
that run the desktop operating systems (Windows,
Linux, UNIX). These agents operate only autonomously
(that is, they run without a connection to a Tivoli
Enterprise Monitoring Server) and pass SNMP trap
data about operating system performance to an SNMP
Event Collector such as IBM Tivoli Netcool/OMNIbus's
MTTRAPD receiver.
No other IBM Tivoli Monitoring agents or other
components should be installed on the same node as a
System Monitor Agent. The only exception to this rule is
agents created with the Agent Builder tool for V6.2.2 or
subsequent.
System Service Monitors. The IBM Tivoli
Netcool/OMNIbus product provides System Service
Monitors that support basic system-level monitoring of
network components such as operating systems. In
addition, OMNIbus provides ISMs (Internet Service
Monitors) and ASMs (Application Service Monitors).
Glossary
621
T
Take Action. A Tivoli Enterprise Portal dialog box from
which you can enter a command or choose from a list
of predefined commands. It also lists systems on which
to effect the command, which is usually a response to
an event.
Take Action command. A Take Action command
allows you to send commands to your managed
systems, either automatically, in response to a
situation that has fired (that is, turned true), or
manually, as the Tivoli Enterprise Portal operator
requires. With Take Action commands, you can enter a
command or select one of the commands predefined by
your product and run it on any system in your managed
network. Thus you can issue Take Action commands
either against the managed system where the situation
fired or a different managed system in your network.
target libraries. SMP/E-controlled libraries that contain
the data installed from the distribution media.
task. A unit of work representing one of the steps in a
process.
TCP/IP. See Transmission Control Protocol/Internet
Protocol.
TDW. See Tivoli Data Warehouse.
telnet. A terminal emulation program used on TCP/IP
networks. You can start a telnet session with another
system and enter commands that execute on that
system. A valid user ID and password for that remote
system are required.
threshold. (1) A level set in the system at which a
message is sent or an error-handling program is called.
For example, in a user auxiliary storage pool, the user
can set the threshold level in the system values, and
the system notifies the system operator when that level
is reached. (2) A customizable value for defining the
acceptable tolerance limits (maximum, minimum, or
reference limit) for an application resource or system
resource. When the measured value of the resource is
greater than the maximum value, less than the minimum
value, or equal to the reference value, an exception is
raised.
Tivoli Data Warehouse. This member of the IBM
Tivoli Monitoring product family stores Tivoli Monitoring
agents' monitoring data in separate relational
database tables so you can analyze historical trends
using that enterprise-wide data. Reports generated from
Tivoli Data Warehouse data provide information about
the availability and performance of your monitored
environment over different periods of time.
622
Tivoli Enterprise Monitoring Server. The host

data-management component for IBM Tivoli Monitoring.
It receives and stores data from either the agents or
other monitoring servers.
Tivoli Enterprise Portal Server. The server you log
onto and connect to through the Tivoli Enterprise Portal
client. The portal server connects to the hub Tivoli
Enterprise Monitoring Server; it enables retrieval,
manipulation, and analysis of data from your
enterprise's monitoring agents.
Tivoli Enterprise Web Services. An open
standards-based interface to the monitoring server that
uses SOAP requests. Using SOAP, any monitoring
agent can be dynamically queried, which means that
its performance and availability data can be processed
by external applications not a part of IBM Tivoli
Monitoring.
Tivoli Management Services. An integrated, layered
architecture consisting of data-access, communication,
and presentation components that enable cross-platform
operation and integration of enterprise-wide data for
systems-management applications. The software
foundation that supports the development and
operations of the Tivoli Enterprise Monitoring Server,
the Tivoli Enterprise Portal Server and Tivoli
Enterprise Portal, and their monitoring agents.
Transmission Control Protocol/Internet Protocol.
An open, portable communications protocol that is the
software basis for the Internet.
TSO. Time Sharing Option, the interactive interface
into the z/OS operating system.
U
User Datagram Protocol. A TCP/IP communications
protocol that exchanges messages ("datagrams")
between networked computers linked by the Internet
Protocol (IP). UDP is an alternative to the Transmission
Control Protocol (TCP), which, like UDP, uses IP to
move a message from one computer to another. Unlike
TCP, however, UDP does not divide the message into
packets and reassemble them at the other end.
The Network File System uses UDP to move file
contents and file updates between the NFS server and
the NFS client.
UDP. See User Datagram Protocol.
V
value of expression. A function in a situation
condition, query specification, or data view filter or
threshold that uses the raw value of an attribute. A
value can be a number, text string, attribute, or modified
attribute. Use this function with any operator.
view. A window pane, or frame, in a workspace. It

may contain data from an agent in a chart or table, or it
may contain a terminal session or browser, for example.
A view can be split into two separate, autonomous
views.
W
Warehouse Proxy agent. One of the IBM Tivoli
Monitoring base agents, the Warehouse Proxy agent
passes historical monitoring data from either a
monitoring agent or the Tivoli Enterprise Monitoring
Server to the Tivoli Data Warehouse. This
multithreaded server process can handle concurrent
requests from multiple data sources to roll off data from
their short-term history files to the data warehouse.
X
XML. See Extensible Markup Language on page
616.
Z
z/OS. IBM's operating system for its line of mainframe,
zSeries computers known for its processing speed and
its ability to manage large amounts of memory,
direct-access storage, and data.
WAV file. Waveform audio format for storing sound in

files, developed jointly by Microsoft and IBM.
wildcard. An asterisk (*) used to represent any
characters that may follow or precede those entered,
such as Sys* to find System and SysTray. Used in
formulas with the VALUE function or MISSING function
(in the Missing Task List). Used also with the SCAN
function, but at the beginning of the text as in *Z to find
markZ and typeZ.
Windows Management Instrumentation. Microsoft's
Windows Management Instrumentation API provides a
toolkit for managing devices and applications in a
network of Windows-based computers. WMI provides
both the data about the status of local or remote
computer systems and the tools for controlling the data.
WMI is included with the Windows XP and Windows
Server 2003 operating systems.
WMI. See Windows Management Instrumentation.
workload. A percentage that shows how much of its
resources a managed system is using. Workload is
calculated using a weighted combination of resource
use statistics.
workspace. The viewing area of the Tivoli Enterprise
Portal window, excluding the Navigator. Each
workspace comprises one or more views. Every
Navigator item has its own default workspace and may
have multiple workspaces.
workspace administration mode. A global parameter
set in the Administer Users editor but which is available
only for user IDs with administrator authority. When
enabled for a user ID, customization of workspaces,
links, and terminal-session scripts automatically
becomes available to all users connected to the same
Tivoli Enterprise Portal Server.
Glossary
623
624
Index
Special characters
/3GB boot option 12
/etc/hosts file 469
<bind> element 560
<connection> element 561
<gateway> element 559
<interface> element 560
<portpool> element 561
<zone> element 560
A
AC (agent compatibility) component 23, 185, 186
errors 185, 187
access plan 318
accessibility features for this product 611
activating a firewall gateway 558
Active Directory, Microsoft
See Microsoft Active Directory
adding application support
for nonbase agents 199
itmcmd support command 156
Linux desktop client 211
Linux monitoring server 128, 155, 204
Linux portal server 208
to a remote monitoring server from Linux or
UNIX 214
to a remote monitoring server from Windows 212
UNIX monitoring server 128, 155, 204
Windows desktop client 209
Windows monitoring server 128, 200
Windows portal server 206
advanced configuration
Linux 275
UNIX 275
Advanced Encryption Standard 125, 613
AES
See Advanced Encryption Standard
agent autonomous mode 15
fully connected agent 15
Managed Mode 15
partially connected agent 15
Unmanaged Mode 15
Agent Builder CD 7
Agent Compatibility Package
See AC (agent compatibility) component
agent deployment 237
deploying OS agents 242
managing agent depot 240
OS agents, deploying 242
populating agent depot 237
sharing an agent depot 241
tacmd createNode command 242
Tivoli Universal Agent 245
agent depot 237
DEPOTHOME environment variable 240
location 240
agent depot (continued)

managing 240
populating through install 238
populating with tacmd addBundles command 240
sharing 241
agent interoperability 134
agentless monitoring 6, 17, 53
AIX 17
deployment options 58
documentation for 59
HP-UX 17
Linux 17
platforms monitored 55
problem-diagnosis tools for 59
Solaris 17
Windows 17
AGENTPRI parameter 320
agents
application agents 6
configuring 264
deploying 237
IBM Tivoli Monitoring for Applications: mySAP
Agent 123
IBM Tivoli Monitoring for Databases: DB2 for the
workstation Agent 123, 124
IBM Tivoli Monitoring for Databases: Oracle
Agent 124
IBM Tivoli Monitoring for Databases: Sybase Server
Agent 124
IBM Tivoli Monitoring: UNIX OS Agent 123, 124
IBM Tivoli Monitoring: Windows OS Agent 124
non-OS agents 6
operating system (OS) agents 6
OS agents 6
product codes 567
removing through the portal 587
starting 265
stopping 265
uninstalling OMEGAMON 585
uninstalling on Linux 585
uninstalling on UNIX 585
uninstalling on Windows 584
aggregate data, amount of 334
AIX
configuring the portal server 171, 175
installing the portal server 170
portal server installation 169
AIX, clustering software for 15
alert monitor 613
application agents 6
application server 614
Application Service Monitors, Netcool/OMNIbus 621
application support
adding to a remote monitoring server from Linux or
UNIX 214
adding to a remote monitoring server from
Windows 212
625
application support (continued)

for agents on Base DVDs 199
for an IBM Tivoli Composite Application Manager
agent 197
application support files
installing remotely 13
application support media 198
application support, enabling
enabling 196
application support, installing
catalog and attribute files 196
seed data 196
SQL files 196
archdsc.tbl 93
architecture codes
Linux 93
UNIX 93
ASLHEAPSZ parameter 320
asterisk (*) wildcard character 323
asymmetric cryptography 280
asynchronous page cleaners 322
attribute files 13
attribute group
detailed data, amount of 334
detailed records per day, number of 333
hard disk drive footprint 333
attributes
event synchronization event class 481
authenticating passwords 94
authenticating users 94
authentication
using external LDAP registry 94
using local registry 94
authorizing users 94
autonomous mode, agent 15
fully connected agent 15
Managed Mode 15
partially connected agent 15
Unmanaged Mode 15
autonomous OS agents
See System Monitor Agents
autostart scripts
changes to 87
B
backing up a current installation
UNIX or Linux 121
Windows 120
backing up the portal server database 122
backing up the Tivoli Data Warehouse database
backup monitoring servers 15
baroc files 614
for Tivoli Enterprise Console 64
update history 65
update history 65
barrier firewall 551
Base DVDs
version 6.2.1 15
626
122
base monitoring agents 3

Basic Recorder of Objects in C files
See baroc files
benchmarking tool 323, 324
Big Local Zone 92
Brio 7
browser
configuring location on UNIX and Linux
configuring location on Windows 229
browser client 614
configuring 225
defined 6
starting 232
buffer pools
definition and purpose 315
memory allocation 315
BufferFlushRate parameter 483, 508
buffering
advantages 316
double 315
buildpresentation.bat 125
bulk agent deployment 248
230
C
cache, clearing 318
caching
dynamic SQL 318
Windows system 315
Candle Management Workstation 614
Candle Management Workstation coexistence 133
CandleNet Command Center 72
enabling historical collection 72
CandleNet Portal database, upgrading 134
cardinality 314
cat and atr files
location of on Windows 213
catalog and attribute (cat and atr) files 196
catalog files 13
change user /execute command 86
CHNGPGS_THRESH parameter 322
CIM
See Common Information Model
cinfo command 547, 570
circular logging, definition and purpose 316
Citrix client 86
class, Sentry2_0_Base 84, 468
Classic REORG 316
client/server architecture 614
clustered index 313
clustering of IBM Tivoli Monitoring components 15
coexistence with version 6.2.2 124
Cold Backup 49
COLLECT STATISTICS clause 317
command
sitconfuser 510
tacmd createNode 243
commands 87, 121, 126, 128, 132, 136, 154
cgabge user/execute 86
itmcmd agent 192, 265
itmcmd config 547
commands (continued)
itmcmd manage 261
itmcmd server 155, 156, 265
itmcmd support 156
sitconfig.sh 484
sitconfuser.sh 484
tacmd
installation 21
packaging 21
tacmd addBundles 240
tacmd createNode 242
common event connector
described 12
Common Event Console view 8, 12
Tivoli Enterprise Portal 461
Common Information Model 54, 614
Common Installer 544
Common Object Request Broker Architecture 614, 621
common services components 3
communications
securing 94
security options for 93
components 6, 11, 20, 24, 119, 517, 522
Agent Builder 7
Agents DVD 7, 15, 58, 198
browser client 6
deciding which to upgrade 117
desktop client 6
event synchronization 8
Infrastructure DVD 7, 15, 198
installing an agent 38, 189
monitoring agents 6
monitoring server 5
portal client 5, 6
portal server 5
Summarization and Pruning agent 7
Tivoli Data Warehouse 7
Tivoli Enterprise Portal Server 5
use with System Monitor Agents 521, 527
Warehouse Proxy 7
configuration fields
Netcool/OMNIbus event synchronization 497
Configuration Tool, z/OS 614
configuration values
validation 13
configuration variables, agent 571
configuring
agents 264
hub monitoring server, Linux 154
hub monitoring server, UNIX 154
Linux, silent 547
monitoring agents 264
monitoring agents on Linux 190
monitoring agents on UNIX 190
monitoring server 262
monitoring server, Linux 161
password authentication 94
port number assignments 266
portal server 279
configuring (continued)
portal server on Linux or AIX 171, 175
remote monitoring server, UNIX 161
response file, using 547
UNIX, silent 547
configuring a firewall gateway 558
configuring Netcool/OMNIbus Object Server
error event flow 508
for program execution from scripts 502
updating the Netcool/OMNIbus database
schema 503
configuring the desktop client 221
connection
inbound 318
outbound 318
pooling 318
containers, definition and purpose 314
contents of installation media 11, 13
control block information 321
controllers, using separate 319
CORBA
See Common Object Request Broker Architecture
COUNT and SKIP 38
CPU utilization 319
creating a partition file 555
creating a workspace 454
Crystal Reports 7
CT/Service Console 267
CTIRA_HEARTBEAT environment variable 271
CURRENT DEGREE special register 321
customer support
See Software Support
D
daily health checks 78
Data Encryption Standard 125, 615
data integrity, importance of logs 315
data size, calculating 319
data warehouse
creating database objects for 341
creating functions for 341
creating indexes for 341
creating table inserts for 341
creating tables for 341
creating views for 341
data warehouse ratio 319
Database Managed Space (DMS) table space
database objects, creating manually 341
database parameters 321
database server 614
database size, estimating 335
databases
configuration parameters 316
heap 316
reorganization 316
databases, supported
portal server 107
DB2 Control Center 320
314
Index
627
DB2 for the workstation 7, 20, 122, 139, 141, 143,

163, 166, 191, 272, 273, 349
creating a tablespace 338
IBMDEFAULTGROUP 338
increasing the size 338
DB2 for the workstation data warehouse
ODBC connection 360
DB2 for the workstation Enterprise Edition 24, 107
DB2BATCH 324
db2batch tool 323
db2empfa command 315
DB2NTNOCACHE option 315
DB2SET command 323
DBHEAP parameter 321
ddname KBDXTRA 616
default certificate 96
default event destination, defining 508
Default Small Local Zone 92
defining a portal server interface on Linux or UNIX 287
defining a portal server interface on Windows 286
DEGREE bind option 321
Deploy Status attribute group 250
Deploy Summary attribute group 250
deploying
non-OS agents 244
through the command line 244
through the Tivoli Enterprise Portal 244
deploying a Tivoli Universal Agent 245
deployment 69
configuring your warehouse agents 73
installing additional agents 74
installing infrastructure components 69
installing your first agents 72
post-installation checklist 73
pre-installation checklist 69
Deployment Status workspaces 250
deployment task estimates 63
agents 65
deployment 67
fix packs 67
policies and workflows 66
situations 66
skills transfer 67
Summarization and Pruning agent 64
Tivoli Enterprise Console integration 64
Warehouse Proxy agent 64
Windows and UNIX environments 64
workspaces 66
z/OS servers 64
DEPOTHOME keyword
KBBENV configuration file 41, 150
Derby embedded portal server database 20, 107, 141,
272, 273
memory requirements 21
DES
See Data Encryption Standard
desktop client 615
adding application support on Linux 211
adding application support on Windows 209
628
desktop client (continued)

configuring 221
configuring on Linux 196
connecting to an external Web server 284
creating a shortcut to launch using Web Start 236
defined 6
downloading from portal server 235
external Web server, connecting to 284
installing 193
installing on Linux from installation media 194
installing on Windows from installation media 193
Interoperable Object Reference (IOR) on Linux,
updating 285
Interoperable Object Reference (IOR) on Windows,
updating 285
IOR for Linux, updating 285
IOR for Windows, updating 285
launching from IBM Java Control Panel 235
logs, location of 234
planning worksheet, Linux 539
planning worksheet, Windows 538
starting 232
using Web Start from the command line 236
detailed data, amount of 334
developerWorks Web site 597
DFT_DEGREE parameter 321
digital certificates 280
disk I/O, minimizing 315
disk requirements for Tivoli Data Warehouse 337
disk space, calculating 319
disk storage requirements 110
disks, drives 320
DLL
See Dynamic Link Library
documentation
See publications
downloading the desktop client using Java Web
Start 235
DSS ratio 319
DVDs, contents of 11, 13
dynamic affinity, agent 22, 126
Dynamic Link Library 615
E
Eclipse Help Server 12, 110, 120, 121, 125, 145, 164,
171, 567
education 599
offerings 600
EGG1 encryption scheme 96
EIB 31
See Enterprise Information Base
EIB tables 577
EIF
See Event Integration Facility
EIF Probe 36
EIF probe, configuring 505
Enable Multipage File Allocation tool 315
enabling application support
enabling event forwarding on the monitoring

server 508
enabling tracing for the JRE 234
Enterprise Information Base 5, 31, 615
enterprise situation 616
environment variables
agent 571
CTIRA_HEARTBEAT 271
IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG 521,
526
IRA_LOCALCONFIG_DIR 521, 526
IRA_PRIVATE_SITUATION_CONFIG 521, 526
KDC_FAMILIES 268, 269
KDE_TRANSPORT 268, 269
Warehouse Proxy 456
ephemeral keyword 553
ephemeral pipe
implementing 552
estimating warehouse database size 333
amount of detailed data 334
determining the size 335
worksheet 335
event forwarding 12
event information, preventing the loss of 15
Event Integration Facility 8, 53, 492, 616, 619
Netcool/OMNIbus
configuring error event flow 508
configuring the EIF probe 505
updating the database schema 503
event integration scenarios 461
Netcool/OMNIbus 17, 492
Tivoli Enterprise Console 17
with Tivoli Enterprise Console 463
event integration, customizing on Netcool/
OMNIbus 509
event synchronization
installation planning 84
installing 494
removing 590
Situation Update Forwarder process 484, 511
uninstalling
programmatically 590
event synchronization component 463
changes made to event server 468
changing the configuration 484
changing the TCP/IP timeout setting 485
configuring the Netcool/OMNIbus Object Server 502
creating a new rule base 480
defining additional monitoring servers 484
importing agent class files and rule set 481
importing class files and rule set 479
installing from the command line 472
Netcool/OMNIbus Object Server 497
installing on Netcool/OMNIbus Object Server 494
from a wizard 495
installing with the wizard 469
methods of installing 468
event synchronization component (continued)

overview 8
sitconfig.sh command 484
sitconfuser.sh command 484
uninstalling manually 591
upgrading to version 2.2.0.0
from a wizard 486, 512
from the command line 487
Netcool/OMNIbus 512
replacing the default trigger 514
updating the EIF probe 515
using silent installation 489
using silent installation 476
verifying installation
Netcool/OMNIbus 511
event synchronization configuration fields
Netcool/OMNIbus 497
event synchronization event class attributes 481
events, forwarding to Netcool/OMNIbus 508
events, forwarding to Tivoli Enterprise Console 482
eWAS server 21, 110, 125, 221
example firewall gateway configuration scenario 562
explicit rebind 318
Extensible Markup Language 616
external Web server
desktop client connection 284
portal client connection 284
portal server configuration 282
Web Start client connection 285
F
file descriptors limit 93
file system caching 315
file, Sentry.baroc 481
files
atr 213
cat 213
catalog and attribute 196
seedkpp.log file 214
SQL 196
FIPS 197 613
Firefox browser 14
tips for using with Tivoli Monitoring 223
versions supported 22, 98, 112
firewall gateway 37
activation 558
configuration 39, 558
configuration for Warehouse Proxy 562
determine if you require 29
example configuration scenario 562
KDE_GATEWAY configuration variable 558
usage scenarios 558
uses 557
XML configuration document 559
Firewall gateway 37
firewall gateway configuration document 559
firewall support 556
Index
629
firewall support (continued)

editing the partition file
UNIX and Linux 556
Windows 555
sample partition file 557
firewalls
achieving interoperability across 551
and Network Address Translation 552
factors in implementation 551
flow of connection establishment 551
implementing with ephemeral pipe 552
implementing with firewall gateway 557
implementing with partition files 554
multiple network interface cards 286
NAT 286
NIC 286
number of internet zones 552
options for 551
permissions at 551
portal server interface, defining 286, 287
scenarios 287
server address continuity across 552
firewalls, achieving interoperability across 551
fix packs
See maintenance
fixes, obtaining 604
flexible scheduling 13
FLUSH PACKAGE CACHE statement 318
forwarding events to Tivoli Enterprise Console 482
forwarding situation events 12, 461
to Netcool/OMNIbus 492
to Tivoli Enterprise Console 463
fragmentation 316
fsync() 275
fully qualified path names, using 91
G
georeferenced map 616
GET SNAPSHOT command 324
get_config_parms procedure 509
Global Location Broker 447
Global Security Toolkit
See GSKit
Global Zone 92
globalization, installing support 218
GROUP BY clause 317
GSK_V3_CIPHER_SPECS parameter
GSKit 95, 280, 616
32-bit environments 23, 96, 187
64-bit environments 23, 96, 187
installation requirements 106
installation with Solaris zones 92
125
H
HACMP
See High-Availability Cluster Multiprocessing
hardware design 318
630
hardware requirements
distributed systems 109
System z 111
hash JOINs 321
health checks 77
daily 78
monthly 78
quarterly 79
weekly 78
heaps 319, 321
heartbeat 31
tracking 31
heartbeat interval 270
CTIRA_HEARTBEAT environment variable 271
performance issues 271
setting the interval 271
heartbeat monitoring 270
performance issues 271
Help Server
See Eclipse Help Server
high availability and disaster recovery 47
agent and remote monitoring server
considerations 49
hub monitoring server considerations 48
portal server considerations 48
considerations 51
Tivoli Data Warehouse considerations 50
Warehouse Proxy agent considerations 50
high speed link 319
High-Availability Cluster Multiprocessing 15
historical data 7
host variables 318
Hot Standby monitoring servers 15
hot-standby monitoring server 616
HTTP 616
port assignments 269
HTTP daemon 267
KDE_TRANSPORT environment variable for 267
HTTPS 92, 94, 95, 266, 267, 280, 616, 621
port assignments 269
HTTPS daemon 267
KDE_TRANSPORT environment variable for 267
hub monitoring server
adding application support on UNIX 155
configuring on UNIX 154
installing 148
installing on Linux 153
installing on UNIX 153
installing on Windows 148
planning worksheet, Linux or UNIX 531
Hypertext Transport Protocol
See HTTP
I
I/O operations, parallel 320
I/O, minimizing 315, 319
IBM HTTP Server on Linux, configuring 283

IBM Java Web Start
using to download the desktop client 233
IBM JRE
installing 233
IBM Redbooks 603
IBM Runtime Environments
installing 233
Linux 234
Windows 233
IBM Support Assistant 603
IBM Tivoli Enterprise Console integration 8
IBM Tivoli License Manager 3
IBM Tivoli License Manager, support for 13
agent deployment 237
component status, monitoring 270
configuring components 261
heartbeat monitoring 270
Java level, required 131
Sun Java 1.6.0_10 or higher 227
Manage Tivoli Enterprise Monitoring Services 261
overview 3
remote deployment 237
removing 581
uninstalling 581
upgrading to 115
IBM Tivoli Monitoring 5.x Endpoint 36
IBM Tivoli Monitoring for Applications: mySAP
Agent 123
IBM Tivoli Monitoring for Databases: DB2 for the
workstation Agent 123, 124
IBM Tivoli Monitoring for Databases: Oracle Agent 124
IBM Tivoli Monitoring for Databases: Sybase Server
Agent 124
IBM Tivoli Monitoring V5.1.2
upgrading to V6.2 115
IBM Tivoli Monitoring V5.x Endpoint agent 115
IBM Tivoli Monitoring V5.x interoperability 115
IBM Tivoli Monitoring Web Services
adding users 296
defining hubs 293
verifying configuration 298
IBM Tivoli Monitoring Web Services, configuring 293
IBM Tivoli Monitoring: UNIX OS Agent 123, 124
IBM Tivoli Monitoring: Windows OS Agent 124
IBM Web Membership URL 116
ICAT 614
ICSF
See Integrated Cryptographic Service Facility
IIOP
See Internet Inter-ORB Protocol
iKeyMan 96
iKeyman utility 280
implicit rebind 318
importing event synchronization class files and rule
set 479
In-Place REORG 316
inbound connection 318
indexes
cardinality 314
indexes (continued)
clustered 313
columns 317
dropped 318
extensive updates 317
new 317
perfectly ordered 316
rebuilt, reorganizing with REORG 316
statistics 313, 317
synchronized statistics 317
information to gather before installing 83
install
See deployment
installation
hardware requirements, distributed systems 109
hardware requirements, System z 111
information to gather 83
Linux considerations 87
monitoring server name guidelines 84
operating systems, supported 96
order of install 86
overview of the process 83
required information 83
requirements 96
software requirements 111
UNIX considerations 87
Windows considerations 86
installation media
changes to 11, 13
contents of 11, 13
installation steps 147
installing 147
application support 199
desktop client 193
globalization support 218
hub monitoring server 148
language packs 218
Linux monitoring server 153, 160
monitoring agents on Linux 189, 190
monitoring agents on UNIX 189, 190
monitoring agents on Windows 184
planning worksheets 529
portal server 162
remote monitoring server 157
silent 541
UNIX monitoring server 153, 160
Windows monitoring server 148, 157
installing all components on a single Windows
computer 139
installing application support
catalog and attribute files 196
seed data 196
SQL files 196
installing into Solaris zones 92
installing monitoring agent .baroc files on the event
server 481
installing the event synchronization component
on Netcool/OMNIbus Object Server 494
InstallPresentation.sh 125
integral Web server 617
Index
631
Integrated Cryptographic Service Facility 96, 616

integrity, data 315
Internet Explorer 223
Internet Information Server V5.0, configuring 282
Internet Inter-ORB Protocol 94, 280, 617
Internet Service Monitors, Netcool/OMNIbus 621
interoperability with version 6.2.2 124
Interoperable Object Reference 94, 617
Interoperable Object Reference (IOR)
updating on Linux 285
updating on Windows 285
INTRA_PARALLEL parameter 321
IOR
See Interoperable Object Reference
IP PIPE 28
IP SPIPE 28
IPv4 address data 559
IPv6 communications protocol 85
IPv6 address data 559
IRA_EVENT_EXPORT_SNMP_TRAP_CONFIG
environment variable 521, 526
IRA_LOCALCONFIG_DIR environment variable 521,
526
IRA_PRIVATE_SITUATION_CONFIG environment
variable 521, 526
itm_event.rules file 507, 516
itm_proc.sql 509
ITMAgentsN script 87
itmcmd agent command 192, 265
itmcmd config command 547
itmcmd manage command 261
itmcmd resp command 548
itmcmd server command 155, 156, 265
itmcmd startAgent command 265
itmcmd stopAgent command 265
itmcmd support command 87, 121, 126, 128, 132,
136, 154, 156
IWM URL
See IBM Web Membership URL
J
Java Database Connectivity 617
Java Management Extensions API 617
Java Runtime Environment, required 131
Java Runtime Environment, Sun 14
Java Web Start 221
using to download the desktop client 233
JDBC
See Java Database Connectivity
JMX
See Java Management Extensions API
JRE
enabling tracing for 234
K
KBB_RAS1 trace setting 448
kcirunas.cfg file 88
KDC_FAMILIES configuration variable
632
562
KDC_FAMILIES environment variable 268, 269

KDC_FAMILIES variable 553
KDC_PARTITION environment variable 556
KDE_GATEWAY configuration variable 558
KDE_TRANSPORT environment variable 268, 269
KDE_TRANSPORT variable 553
KDY0012E message 256
keyword
ephemeral 553
KfwServices 275
KGLCB_FSYNC_ENABLED parameter 275
KHD_CNX_POOL_SIZE environment variable 318
KinConfg.exe utility 120
KNTENV file 558
Kochi fonts
installing on SuSE Linux 220
KPX_WAREHOUSE_LOCATION 447
KPX_WAREHOUSE_LOCATION variable 553
krarloff utility 616
KUE component 21
KUI component 21
L
language packs, installing 218
large environments 40
large-scale deployment 60
LDAP
See Lightweight Directory Access Protocol
ldedit command 275
libraries
IBM Tivoli Monitoring 595
License Manager, IBM Tivoli 3
Lightweight Directory Access Protocol 617
link, high speed 319
Linux
/etc/hosts file 91
adding application support 155
backing up a current installation 121
configuring 547
configuring desktop client 196
configuring monitoring agents 190
configuring portal desktop client 196
configuring the portal server 171, 175
EIB tables 577
file permissions for monitoring agents 191
fully qualified path names 91
host names, setting 91
hub monitoring server 153, 154
installation considerations 87
installation user account 90
installing as root 90
installing monitoring agents 190
installing the desktop client from installation
media 194
installing the portal server 170
maxfiles parameter 93
network interface cards 91
NFS environment 91
Linux (continued)
planning 87
portal server installation 169
remote monitoring server 160, 161
response file configuration 547
response file installation 545
silent configuration 547
silent installation 544, 545
starting monitoring agents 192
starting portal server 182
TCP/IP network services 91
Linux monitoring server
KDC_PARTITION 556
NAT 556
network address translation (NAT) 556
LOBs, DB2 315
Local Location Broker 447
localhost requirements
Linux 277
location broker 552
Location Broker
Global 447
Local 447
lock list 322
LOCKLIST parameter 322
Log Buffer parameter 316
log retain logging, definition and purpose 316
LOGBUFSZ parameter 316, 322
LOGFILSIZ parameter 316, 323
logging
circular 316
log retain 316
mirroring 316
performance 316
records 316
LOGPRIMARY parameter 323
logs
for desktop client 233
lz.config file 559
M
mainframe 61
deployment considerations 61
maintenance 75, 77
installing 236
post-upgrade 76
pre-upgrade 75
maintenance utilities for the database 316
adding application support 212, 214
agents, configuring 264
application support, adding 212, 214
defining SOAP hubs 293
editing the partition file
UNIX and Linux 556
Windows 555
monitoring agents, configuring 264
261

(continued)
monitoring server, configuring 262
starting components 265
starting on Linux 261
starting on UNIX 261
starting on Windows 261
stopping components 265
managed Java beans
See MBeans
MAX_QUERYDEGREE parameter 321
MAXLOCKS parameter 322
MBeans 617, 618
medium environments 40
memory
accessing 315
allocating for browser client 225
allocation 319
buffer pools 315
DB2 model 319
organization 319
parameters 319
tuning 319
memory requirements 110
Microsoft Active Directory 94
Microsoft Cluster Server 15
Microsoft SQL data warehouse
ODBC connection 404
Microsoft Windows Terminal Services 86
migrate-export process 279
migrate-import process 280
migrated information 119
MINCOMMIT parameter 316
mirroring log files 316
monitoring agent
removing through the portal 587
uninstalling on Linux 585
uninstalling on UNIX 585
uninstalling on Windows 584
monitoring agent .baroc files, installing on the event
server 481
monitoring agents
configuring 264
definition 6
deploying 237
file permissions, changing 191
installing 183
installing on Linux 189, 190
monitoring agents on Linux 189
product codes 567
starting 265
stopping 265
monitoring agents, base 3
Index
633
Monitoring components 30
Firewall gateway 37
IBM Tivoli Monitoring 5.x Endpoint 36
Netcool/OMNIbus integration 36
Summarization and Pruning agent 35, 86
Tivoli Enterprise Monitoring Agent 34
Tivoli Enterprise Monitoring Server 31
Tivoli Enterprise Portal client 33
Warehouse Proxy agent 35, 86
monitoring server
adding application support on Linux 128, 155, 204
adding application support on UNIX 128, 155, 204
adding application support on Windows 128, 200
agent depot, location 240
agent depot, populating 237
communications protocol planning worksheet 540
configuration file 150, 158, 164, 185, 194, 240, 241,
249, 250, 271, 446, 447, 553
configuring 262
configuring on Linux 154, 161
configuring on UNIX 154, 161
defined 5
defining additional to the event server
Netcool/OMNIbus 510
EIB tables 577
environment file 150, 158, 164, 185, 194, 240, 241,
249, 250, 271, 446, 447, 553
file descriptor limit on UNIX 93
forwarding events to Netcool/OMNIbus 508
forwarding events to Tivoli Enterprise Console 482
heartbeat interval, configuring 270
installing on Linux 153, 160
installing on UNIX 153, 160
installing on Windows 148, 157
KBBENV configuration file 150, 158, 164, 185, 194,
240, 241, 249, 250, 271, 446, 447, 553
DEPOTHOME keyword 41, 150
naming 84
starting 155, 265
stopping 156, 265
Tivoli Event Integration Facility 482, 508
monthly health checks 78
motherboard 319
MPP (Massively Parallel Processors) 319
MSCS
See Microsoft Cluster Server
MTTRAPD trap receiver 462
multiple network interface cards 91, 286
multiple nodes 319
multiprocessor systems 109
634
N
naming conventions 71
naming the monitoring server 84
NAT 286, 556
See Network Address Translation
Netcool SSM agents
deployment of 251, 252
Netcool/OMNIbus 24, 53, 517, 522, 621
information required for event forwarding 84
integration 492
MTTRAPD trap receiver for 462, 621
planning 492
verifying installation of event synchronization
component 511
Netcool/OMNIbus configuration, customizing 509
Netcool/OMNIbus event synchronization configuration
fields 497
Netcool/OMNIbus integration 36
Netcool/OMNIbus Object Server
configuring for event integration 502
configuring for program execution from scripts 502
configuring the EIF probe 505
configuring the error event flow 508
Network Address Translation 618
and firewalls 552
network address translation (NAT) 286, 556
Network File System 618
network interface cards
specifying 91
network, monitoring bandwidth 320
NFS
See Network File System
NFS environment, installing into 91
required permissions 92
NIC 286
NOCACHE option 315
node ID 217
nodes, multiple 319
non-agent bundles 23
Linux and UNIX 531, 533
Windows 530, 532
non-NIS Solaris monitoring server, configuring
permissions for 275
non-OS agents 6
deploying 244
non-sequential physical data pages 316
NUM_IOCLEANERS parameter 322
NUM_IOSERVERS parameter 322
O
ODBC 35
See Open Database Connectivity
ODBC connection
DB2 for the workstation data warehouse
Microsoft SQL data warehouse 404
360
ODBC connection (continued)

Oracle data warehouse 423
ODBC data source connection, removing 587
OLTP ratio 319
om_tec.config event-forwarding control file 483, 508
OMEGAMON
uninstalling agents 585
OMEGAMON Platform V350 and V360
agents, configuration settings 133
CandleNet Portal database 134
installation directory 133
Java level, required 134
OMEGAMON XE for CICS 133
SOAP server 293
terminology 133
unsupported functions 134
upgrading 115
using existing agents 134
when to run the upgrade 133
OMEGAMON Tivoli Event Adapter 619
OMEGAMON XE for CICS 3.1.0
Candle Management Workstation requirement 133
omegamon.baroc class file 468
omegamon.rls file 485
omegamon.rls rule set file 468
OMNIbus
See Netcool/OMNIbus
ONLY ON KEY COLUMNS clause 317
OPAL documentation 137, 597
Open Database Connectivity 35, 619
Open Process Automation Library
See OPAL documentation
operating system (OS) agents 6
operating systems
no longer supported 117
optimizer
access plan creator 313
intra-partition parallelism determination 321
purpose 317
statement binding with dynamic SQL 318
statistics influence 313
Optional Primary Network Name option 91
options
Security: Validate User 94
Oracle data warehouse
ODBC connection 423
OS agents 6
OS Cluster 49
OTEA
See OMEGAMON Tivoli Event Adapter
overview 3
P
packages
cache for dynamic and static SQL
invalid 318
static SQL 318
page cleaners, asynchronous 322
322
paging and swapping 319

parallel I/O operations 320
partition file
creating 555
editing 555
UNIX and Linux 556
Windows 555
modifying 555
sample 557
partition files
implementing 554
sample scenarios 554
password authentication, configuring 94
password encryption 93
PCKCACHESZ parameter 322
PDS
See Persistent Datastore
PerfMon
See Performance Monitor, Windows
Performance Monitor, Windows 619
performance tuning for DB2 databases 313
Persistent Datastore 616, 619
physical data pages, non-sequential 316
placing components 30
planning
See also pre-deployment
hardware requirements, distributed systems 109
hardware requirements, System z 111
installation 83
Linux considerations 87
requirements 96
UNIX considerations 87
Windows considerations 86
worksheets 529
planning, upgrade 116
pooling, connection 318
populate_agents.sql script 192
port number assignments
configuring client connections for the portal
server 266
configuring for monitoring agents 268
configuring for the monitoring server 266
controlling 266
portal browser client
starting 232
portal client 6
browser 225
portal desktop client
downloading with IBM Java Web Start 233
installing on Linux from installation media 194
installing on Windows from installation media 193
Index
635
portal desktop client (continued)

starting 232
portal server
backing up 183
backing up the database 122
configuring 279
configuring on Linux or AIX 171, 175
configuring SSL 280
connecting to a different monitoring server 279
defined 5
disabling SSL 281
enabling SSL 281
exporting configuration data 279
external Web server 282
firewall scenarios 287
IBM HTTP Server on Linux 283
importing configuration data 280
installing 162
installing on Linux or AIX 169, 170
interface, defining 286, 287
reconfiguring for a different monitoring server 279
restoring 183
restoring your configuration data 280
SSL, configuring 280
starting 265
starting on Linux 182
stopping 265
supported databases 107
testing connection to the Tivoli Data
Warehouse 453
portal server database
backing up 122
portal server interface
defining on Linux or UNIX 287
defining on Windows 286
post-deployment 75
applying maintenance 75, 236
maintenance 77
post-installation 73
post-upgrade 76
pre-deployment 27
accelerating 62
additional ports 38
agent deployments 51
firewall gateway determination 29
high availability and disaster recovery 47
Monitoring component placement 30
multi-hub environments 61
planning checklist 27
platform support matrix 46
project management and planning 63
sizing your Tivoli Monitoring hardware 39
636
pre-deployment (continued)
staffing 67
task estimates 63
Tivoli Universal Agent deployments 59
understanding your network 28
pre-installation 69
prefetch
definition 314
list 314
list sequential 314
quantity 317
sequential 314
prelink SELinux command 105
prerequisites
for upgrading 117
hardware 96
software 96
private situation 619
problem determination and resolution 605
problem resolution 603
processor configurations 319
processor requirements 109
proddsc.tbl 93, 547
product codes 567
Linux 93
UNIX 93
product documentation 599
product overview 3
project management and planning 63
protocols
validation 13
public/private key pair 280
publication tool, schema 340
publications
developerWorks Web site 597
OPAL 597
Redbooks 597
related 597
Technotes 597
types 595
wikis 597
Q
quarterly health checks 79
queries 317
queue delays, causes 319
R
RAID device 315
ratios, scaling up 319
raw data size, calculating 319
rc.itm script 87
read operations, excessive 316
REBIND utility
place in order of utilities 318
purpose 318
SQL types supported 318
rebinding, explicit and implicit 318
recovery, roll-forward 316
Redbooks 313, 597, 599, 603

REDISTRIBUTE DATABASE PARTITION GROUP
utility 317
registry variables 315, 323
remote deployment 41, 237
managing agent depot 240
OS agents, deploying 242
populating agent depot 237
sharing an agent depot 241
tacmd createNode command 242
remote monitoring server
installing 157
installing on Linux 160
Remote Procedure Call 620
removing 581
agents 587
component 584
Linux 585
UNIX 585
Warehouse Proxy 587
Windows 584
from the portal 587
monitoring component 584
Linux 585
UNIX 585
Warehouse Proxy 587
Windows 584
monitoring environment 581
Linux 583
UNIX 583
Windows 581
OMEGAMON Monitoring Agent 585
REORG utility
classic 316
In-Place 316
types 316
reporting software 7
Reports, Crystal 7
required hardware
distributed systems 109
System z 111
required information for installation 83
required software 111
requirements
disk storage 110
hardware 96
memory 110
processor 109
software 96
resources 599
education 599
education offerings 600
resources (continued)
IBM Tivoli Monitoring 6 Welcome Kit 599
other 601
product documentation 599
Redbooks 599
service offerings 600
support Web sites 599
response file
use with schema publication tool 341
response time, delayed 319
reverse synchronization 12
roll-forward recovery 316
RPC
See Remote Procedure Call
rule base
creating new 480
importing existing rule base into 480
modifying 481
RUNSTATS utility
formats 317
list of purposes 317
options 317
precaution 317
S
SAMP
See System AutomationMultiplatform
sample deployment scenarios
event integration 461
SAMPLE DETAILED clause 317
scalability 318, 319
scaling up ratios 319
scenarios
partition files 554
secureMain 580
upgrade 115
schema publication tool 340
updated mode 342
scripts
autostart 87
secondary monitoring servers 15
Secure Hypertext Transport Protocol
See HTTPS
secure pipe
See SPIPE
secure protocols
Internet Inter-ORB Protocol (IIOP) 94
Interoperable Object Reference (IOR) protocol 94
Secure Hypertext Transport Protocol (HTTPS) 94
Secure Sockets Layer API 53, 92, 94, 95, 173, 280,
287, 517, 616, 620, 621
asymmetric cryptography 280
digital certificates 280
disabling 281
enabling 281
Global Security Toolkit (GSKit) 280
public/private key pair 280
secureMain utility 579
examples 580
Index
637
secureMain utility (continued)

scenarios 580
usage 579
securing a Linux or UNIX installation 579
securing communication between components 94
securing the SOAP server 95
security
firewall scenarios 287
HTTPS 280
Secure Hypertext Transport Protocol (HTTPS) 280
SSL 280
security options
for communications 93, 94
for SOAP Server 93
for user authentication 93
single sign-on 95
security-enhanced Linux
See SELinux
Security: Validate User option 94
seed data 196
seeding 196
seedkpp.log file 214
seek time 320
SELinux 170, 620
configuration with 105
execution with 105
installation with 105
Sentry.baroc class file 468
Sentry.baroc file 481
Sentry2_0_Base class 84, 468
sequential prefetch 314
Service Console, CT 267
SET RUNTIME DEGREE command 321
setenforce SELinux command 105
setting, KBB_RAS1 trace 448
sharing 61
customization 62
SHEAPTHRES parameter 321
shortcut for launching desktop client 236
silent installation 541
Linux 544, 545
UNIX 544, 545
Windows 541
from command line 544
using SMS 544
silent-installation files 543, 548
Simple Network Management Protocol 54, 614, 617,
619, 620
Simple Object Access Protocol 620
single sign-on capability 95
single-computer installation
order 86
sit_ack_expired_def_action variable 509
sit_resurface_def_action variable 509
sitconfig.sh command 484
sitconf refresh command 508
sitconfuser command 510
sitconfuser.sh command 484
sitpad tool 137, 138
Situation Event Console 8
situation events, forwarding 461
638
Situation Update Forwarder 619, 621

Situation Update Forwarder process 468, 484
starting and stopping 511
situpdate_conf_file variable 509
size of raw data, calculating 319
SKIP and COUNT 38
small environments 40
Small Local Zone 92
Small Local Zone with /opt directory share 92
SMP (Symmetric Multiprocessor) 319
SMP/E
See System Modification Program/Extended
SNMP
See Simple Network Management Protocol
SOAP
See Simple Object Access Protocol
SOAP server
adding users 296
defining hubs 293
SOAP Server
security options for 93
SOAP server, configuring 293
SOAP server, securing 95
sockets 319
Software Support
contacting 605
overview 603
receiving weekly updates 604
software, reporting 7
Solaris local zones
support for 13
Solaris zones
installing into 92
types of 92
Solution Installer 544
SORTHEAP parameter 315, 321, 322
SPIPE 92, 94, 95, 616, 621
SQL
See also Structured Query Language
dynamic 318
optimizer 318
static 318
types 318
SQL editor
See schema publication tool
SQL files 196
SQL query 453
assigning to a workspace 455
creating 453
WAREHOUSELOG 455
SQL Server, Microsoft 7, 20, 107, 108, 122, 139, 141,
143, 163, 191, 273, 397
SQL statements
schema publication tool for generating 340
SSL
See Secure Sockets Layer API
SSM
See System Service Monitors, Netcool/OMNIbus
SSO
See single sign-on capability
staffing 67
Star JOINs 321
starting
Situation Update Forwarder process 511
starting Manage Tivoli Enterprise Monitoring Services
on Linux 261
on UNIX 261
on Windows 261
starting monitoring agents
itmcmd agent command 192
starting the monitoring server
itmcmd server command 155
starting the portal server 182
startSUF command 511
stash file 96
statistics
collected for RUNSTATS 317
comparing current and previous 317
distribution 317
index 317
queries 317
types of collections 317
stopping
Situation Update Forwarder process 511
stopping the monitoring server
itmcmd server command 156
stopSUF command 511
Structured Query Language 621
SUF
See Situation Update Forwarder
Summarization and Pruning agent 7, 35, 86, 123
configuration 73
configuration for autonomous operation 448
configuring communications for DB2 for the
workstation 371
configuring JDBC connection 435
considerations 44
description of 347
flexible scheduling 13
high availability and disaster recovery
considerations 51
installing on DB2 for the workstation 371
log trimming 13
product code 567
role in Tivoli Data Warehouse 7
starting 444
Sun Java Runtime Environment 14
version 1.6.0_10 or higher
browser requirements 227
support assistant 603
support Web sites 599
supported databases
portal server 107
supported operating systems 96
swapping 319
switches 324
sysadmin user account 94

System AutomationMultiplatform 15
system caching, files 315
System Managed Space (SMS) table space 314
System Modification Program/Extended 614, 622
System Monitor Agents 20
64-bit Windows agent 24
configuring
on Linux or UNIX 525
on Windows 520
installing 20
on Windows 517
on Windows 64-bit processors 519
uninstalling 20
on Windows 521
System Service Monitors, Netcool/OMNIbus 6, 20,
255, 621
bulk deployment of 247
configuring 247
deploying 246
installing 246
patching 246
querying deployment status of 247
restarting 247
starting 247
stopping 247
uninstalling 246
unpatching 247
System z
required hardware 111
systems, multiprocessor 109
T
table spaces
containers 314
multiple page sizes 315
types 314
tacmd addBundles command 188, 240, 246, 252
tacmd addSystem command 251, 252, 255, 256
tacmd AddSystem command 188
tacmd clearDeployStatus command 256, 257
tacmd commands
errors 77, 189
installation 21
packaging 21
tacmd configureSystem command 247, 251, 256
tacmd createNode command 242, 246, 251, 252, 255
requirements 242
using 243
tacmd createsystemlist command 618
tacmd deletesystemlist command 618
tacmd editsystemlist command 618
tacmd executecommand command
installing application support for an IBM Tivoli
Composite Application Manager agent 197
tacmd getDeployStatus command 249, 256
Index
639
tacmd getfile command

tacmd putfile command
tacmd removeSystem command 246, 247, 256
tacmd restartAgent command 247
tacmd startAgent command 247
tacmd stopAgent command 247
tacmd updateAgent command 246, 251, 255, 256
tacmd viewDepot command 246
taudit tool 137, 138
tbsm_eif_event.rules file 507, 516
TCP 28
TCP/IP
See Transmission Control Protocol/Internet Protocol
TCP/IP timeout setting, changing on event server 485
TDS
See Tivoli Directory Server
TDW
See Tivoli Data Warehouse
TEC_Generic class 481
tec.baroc file 481
Technotes 597
telnet 622
TEMS name 217
TEPS/e
See Tivoli Enterprise Portal Server extended services
(TEPS/e)
tepsBackup command 183
tepsRestore command 183
Terminal Services 86
throughput 313, 319, 320
Tivoli Business Service Manager 504, 505, 514
integration with IBM Tivoli Monitoring and
Netcool/OMNIbus 507, 516
Tivoli Data Warehouse 7, 36, 615, 622
backing up the database 122
creating a Windows user 354
creating database objects for 341
DB2 for the workstation database, increasing the size
of 338
disk requirements, understanding 337
estimating database size 333
considerations 50
planning 333
populate_agents.sql script 192
sharing 61
supported databases 107
testing connection to the portal server 453
uninstalling the Warehouse Proxy 587
updating the ManagedSystem table 192
upgrading 123
Windows user, creating 354
worksheet 335
Tivoli Data Warehouse database
backing up 122
Tivoli Directory Server 94
Tivoli Distributed Monitoring, upgrading from 115
640
Tivoli Enterprise Console 24, 53, 614, 616, 619, 621

changing the TCP/IP timeout setting 485
determining when to use 467
event forwarding 463
forwarding events to 482
information required for event forwarding 84
integration 8, 463
planning 463
Tivoli Event Integration Facility 482
Tivoli Enterprise Console event view 8
Tivoli Enterprise Monitoring Agent 34
See also monitoring agents
installing 72
configuring port number assignments 268
Tivoli Enterprise Monitoring Server 31
See also monitoring server
changing configuration settings 71
configuring port number 266
considerations 48
hub considerations 40
multiple hub considerations 40
remote considerations 41
remote high availability and disaster recovery
considerations 49
using remote monitoring servers with Universal
Agents 60
authorizing users 94
browser client 6
Common Event Console view 461
desktop client 6
Tivoli Enterprise Portal client 6, 33
considerations 45
See also portal server
configuring port number assignments for client
connections 266
considerations 42
considerations 48
Tivoli Enterprise Portal Server extended services
(TEPS/e)
definition of 9
Tivoli Event Integration Facility 482, 508
Tivoli Management Services 3
Tivoli Monitoring environment
additional ports used 38
changing monitoring server configuration
settings 71
components 30
configuration checklist 70
customizing your environment 71
enabling historical collection 72
Tivoli Monitoring environment (continued)

installing components 69
maintenance 77, 236
platform support matrix 46
sizing your hardware 39
Tivoli Universal Agent 6, 37
definition 6
deploying 245
naming 245
deployment considerations 59
deployment versioning considerations 59
firewall considerations 60
large-scale deployment 60
using with remote monitoring servers 60
tivoli_eif.rules file 507, 516
TLS
See Transport Layer Security API
tools
benchmarking 323
db2batch 323
Enable Multipage File Allocation 315
Event Monitor 323
Explain Facility 323
monitoring 323
Snapshot Monitor 323
topology view 117
trace setting, KBB_RAS1 448
transactions 316
Transmission Control Protocol/Internet Protocol
Transport Layer Security API 616
troubleshooting 603
tuning
DB2 performance on Windows, UNIX, and
Linux 313
guidelines 320
tuning parameters
AGENTPRI 320
ASLHEAPSZ 320
CHNGPGS_THRESH 322
DBHEAP 321
DFT_DEGREE 321
INTRA_PARALLEL 320
LOCKLIST 322
LOGBUFSZ 322
LOGFILSIZ 323
LOGPRIMARY 323
MAX_QUERYDEGREE 321
MAXLOCKS 322
NUM_IOCLEANERS 322
NUM_IOSERVERS 322
PCKCACHESZ 322
SHEAPTHRES 321
SORTHEAP 322
type 567
U
UDP
See User Datagram Protocol
Uni-Processor 319
622
uninstallation 581
agents 587
component 584
Linux 585
UNIX 585
Warehouse Proxy 587
Windows 584
from the portal 587
monitoring component 584
Linux 585
UNIX 585
Warehouse Proxy 587
Windows 584
monitoring environment 581
Linux 583
UNIX 583
Windows 581
Warehouse Proxy 587
uninstalling
event synchronization component
manually 591
IBM Tivoli Monitoring environment 581
ODBC data source 587
OMEGAMON Monitoring Agents 585
Warehouse Proxy agent 587
UNIX
/etc/hosts file 91
adding application support 155
configuring 547
configuring monitoring agents 190
EIB tables 577
file permissions for configuring monitoring
agents 191
fully qualified path names 91
host names, setting 91
hub monitoring server 153, 154
installation considerations 87
installation user account 90
installing as root 90
installing monitoring agents 190
monitoring server parameter 275
network interface cards 91
NFS environment 91
planning 87
remote monitoring server 160, 161
response file configuration 547
response file installation 545
silent configuration 547
silent installation 544, 545
Solaris zones
installing into 92
starting monitoring agents 192
TCP/IP network services 91
UNIX environment 64
UNIX monitoring server
configuring permissions for non-NIS Solaris
275
Index
641
UNIX monitoring server (continued)

KDC_PARTITION 556
NAT 556
network address translation (NAT) 556
non-NIS Solaris monitoring server 275
unsupported operating systems 117
updated mode
schema publication tool 342
updating the Netcool/OMNIbus database schema 503
upgrade 75
order 86
steps 75
Tivoli Distributed Monitoring 115
upgrade planning 116
upgrade scenarios 115
upgrading
agents, configuration settings 133
CandleNet Portal database 134
deciding which components 117
from IBM Tivoli Monitoring V6.1 127
overview 127
from IBM Tivoli Monitoring V6.2 127
overview 127
from OMEGAMON Platform V350 and V360 131
IBM Tivoli Monitoring V5.1.2 to V6.2 115
IBM Tivoli Monitoring V6.1 to V6.2 115
installation directory 133
Java level, required 131, 134
migrated information 119
OMEGAMON Platform V350 and V360 115
order 86
required order 119
terminology 133
unsupported OMEGAMON functions 134
when to run 133
upgrading the Tivoli Data Warehouse 123
upgrading to IBM Tivoli Monitoring 115
upgrading to V6.2
required order 119
upgrading to version 6.2
planning 116
user accounts 94
user authentication
options for 93
user authority when installing on Linux or UNIX 90
User Datagram Protocol 622
not supported with the portal server 24
using Java Web Start to download the desktop
client 235
utilities
KinConfg.exe 120
utilization, CPU 319
ux.config file 558
ux.ini file 558
642
V
validation
configuration values 13
protocols 13
variables
KDC_FAMILIES 553
KDE_TRANSPORT 553
KPX_WAREHOUSE_LOCATION 553
variables, host 318
versioning 59
view
topology 117
virtual memory
increasing for large environments on AIX
VMWare ESX Server 48, 103, 104
275
W
Warehouse load projection spreadsheet 42
Warehouse Proxy
removing 587
tuning performance 456
uninstalling 587
Warehouse Proxy agent 7, 35, 86, 123
configuration 73, 445
configuration for autonomous operation 448
port assignment for 449
configuration with firewall gateway 562
considerations 42
file descriptor limit on UNIX 93
considerations 50
installing 445
product code 567
role in Tivoli Data Warehouse 7
support for multiple 445
uninstalling 587
Warehouse load projection spreadsheet 42
Warehouse Summarization and Pruning agent
See Summarization and Pruning agent
WAREHOUSEAGGREGLOG table 458, 459
ENDTIME column 459
LOGTMZDIFF column 459
MAXWRITETIME column 459
MINWRITETIME column 459
OBJECT column 459
ORIGINNODE column 459
ROWSREAD column 459
STARTTIME column 459
WAREHOUSELOG query 455
WAREHOUSELOG table 458
ENDQUEUE column 458
ENDTIME column 458
ERRORMSG column 458
EXPORTTIME column 458
OBJECT column 458
ORIGINNODE column 458
ROWSINSERTED column 458
WAREHOUSELOG table (continued)

ROWSRECEIVED column 458
ROWSSKIPPED column 458
STARTEXPORT column 458
STARTQUEUE column 458
STARTTIME column 458
WPSYSNAME column 458
WAREHOUSELOG workspace 455
WAREHOUSESUMPRUNE database table 332
WAV file 623
Web browser
changing locations on UNIX or Linux 230
Web Health Console, IBM Tivoli Monitoring V5.1
Tivoli Enterprise Portal visualization for 115
Web Start
launching from IBM Java Control Panel 235
launching the desktop client from a browser 235
launching the desktop client from the command
line 236
Web Start client
weekly health checks 78
WHERE clause 317
wikis 597
wildcard 623
Windows
hub monitoring server 148
installing the desktop client 193
portal server 162
remote monitoring server 157
response file 541
silent installation 541
Windows Dynamic Link Library
See Dynamic Link Library
Windows environment 64
Windows Management Instrumentation API 54, 623
Windows Performance Monitor
See Performance Monitor, Windows
Windows Terminal Services 86
WMI
See Windows Management Instrumentation API
work
roll-forward recovery 316
rollbacks 315
worksheets 529
communications protocol 540
desktop client on Linux 539
desktop client on Windows 538
Linux or UNIX hub monitoring server 531
Linux or UNIX remote monitoring server 533
Linux portal server 535
monitoring agent on Linux or UNIX 537
monitoring agent on Windows 536
monitoring server communications protocol 540
portal desktop client on Linux 539
portal desktop client on Windows 538
Windows hub monitoring server 530
Windows portal server 534
worksheets (continued)
Windows remote monitoring server
workspace, WAREHOUSELOG 455
workspaces, creating 454
world permission
required for NFS access 92
532
X
XML
See Extensible Markup Language
Z
z/OS server
64
Index
643
644

Printed in USA
GC32-9407-03

Itm Install

Uploaded by

Copyright:

Available Formats

Itm Install

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Itm Install

Uploaded by

Copyright:

Available Formats

Tivoli IBM Tivoli Monitoring

Version 6.2.2 Fix Pack 2 (Revised May 2010)

Installation and Setup Guide

Tivoli IBM Tivoli Monitoring

Version 6.2.2 Fix Pack 2 (Revised May 2010)

Installation and Setup Guide

Contents of the Deployment Guide merged . . . . . . . . . . . . . . . . . . .

Part 2. Planning your IBM Tivoli Monitoring deployment . . . . . . . . . . . . 25

IBM Tivoli Monitoring: Installation and Setup Guide

Chapter 3. Deployment phase . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Installing the infrastructure components . . . . . . . . . . .

Chapter 4. Post-deployment phase . . . .

Part 3. Installation and initial configuration of base components and agents . . 81

IBM Tivoli Monitoring: Installation and Setup Guide

Chapter 6. Upgrading from a previous installation . . . . . . . . . . . . .

Chapter 7. Installing IBM Tivoli Monitoring on one computer . . . . . . . . . . . . . . 139

Post-installation procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

IBM Tivoli Monitoring: Installation and Setup Guide

Configuring application support on a nonlocal monitoring server from a Windows system. . .

Chapter 9. Deploying monitoring agents across your environment

Uninstalling an SSM patch. . . . . . . . .

Part 4. Post-installation configuration and customization . . . . . . . . . . . 259

Chapter 11. Additional Linux and UNIX configuration steps . . . . . .

IBM Tivoli Monitoring: Installation and Setup Guide

Chapter 12. Additional Tivoli Enterprise Portal configurations . . . . . . . . . .

Chapter 13. Configuring IBM Tivoli Monitoring Web

Services (the SOAP

Chapter 14. Performance tuning . . . . . . . . . . . . . . . . . .

Part 5. Setting up data warehousing . . . . . . . . . . . . . . . . . . . . . 329

IBM Tivoli Monitoring: Installation and Setup Guide

Chapter 17. Tivoli Data Warehouse solution using DB2 on z/OS . . .

Chapter 19. Tivoli Data Warehouse solution using Oracle . . . . . . . . . . . .

Chapter 20. Tivoli Data Warehouse solutions: common procedures . . . . . .

Part 6. Integrating event management systems . . . . . . . . . . . . . . . . 461

IBM Tivoli Monitoring: Installation and Setup Guide

One or more hub monitoring servers and a single event server . . . . . . . . . . .

Chapter 22. Setting up event forwarding to Netcool/OMNIbus . . . . . . . . . . . . .

Configuring the System Monitor Agents on Linux or UNIX . . . . . . . . . . . . . . . . 525

Appendix B. Performing a silent installation of IBM Tivoli Monitoring

Appendix D. IBM Tivoli product, platform, and component codes . . . . . . . . . . . . . 567

IBM Tivoli Monitoring: Installation and Setup Guide

Appendix E. Common agent environment variables . . . . . . . . . . . . . . . . . . 571

Appendix H. Uninstalling IBM Tivoli Monitoring . . . . . . .

Appendix I. Documentation library .

Appendix J. Additional resources . . .

Appendix K. Support for problem solving . .

Appendix L. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

IBM Tivoli Monitoring: Installation and Setup Guide

54. Configure Warehouse Proxy window (TEMS Connection tab) . . . . . . . . . . . .

IBM Tivoli Monitoring: Installation and Setup Guide

Removing the portal database

IBM Tivoli Monitoring: Installation and Setup Guide

53. Interaction between member properties and group properties . . . . . . . . . . . . .

IBM Tivoli Monitoring: Installation and Setup Guide

103. Tivoli Data Warehouse URLs . . . . . . . . . . . . . . . . . . . . .

IBM Tivoli Monitoring: Installation and Setup Guide

Copyright IBM Corp. 2005, 2010

IBM Tivoli Monitoring: Installation and Setup Guide

Chapter 1. Overview of IBM Tivoli Monitoring

Components of the monitoring architecture