Table Of ContentIBM
Tivoli OMEGAMON Platform and CandleNet Portal
®
Version 3.6.0 and Version 1.9.6
Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX
SC32-1768-00
12
1
2
IBM
Tivoli OMEGAMON Platform and CandleNet Portal
®
Version 3.6.0 and Version 1.9.6
Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX
SC32-1768-00
12
Note
Before using this information and the product it supports, read the information in “Notices” on page 235.
1
First Edition (April 2005)
© Copyright Sun Microsystems, Inc. 1999
© Copyright International Business Machines Corporation 2005. All rights reserved.
Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
2
Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14
Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Chapter 1. Preparing for Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
What Are IBM Tivoli OMEGAMON XE and IBM Tivoli OMEGAMON DE?. . . . . . . . . .20
Installation Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
Configuring Your System for CandleNet Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Configuring IBM Tivoli OMEGAMON XE Across a Firewall. . . . . . . . . . . . . . . . . . . . . .33
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
To Do Before Beginning on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
To Do Before Beginning on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Chapter 2. Preparing for Upgrading and Migrating from a Previous Installation . . . . . . . . .59
Upgrade and Migration Planning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
To Do Before Beginning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
Chapter 3. Installation and Basic Configuration Steps on Windows . . . . . . . . . . . . . . . . . .67
Starting the InstallShield Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
Selecting Products and Copying Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
Configuring CandleNet Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
Configuring the CMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Configuring Agent-to-CMS Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
Completing Installation and Basic Configuration of OMEGAMON Platform and
CandleNet Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
Installing IBM Tivoli OMEGAMON DE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
Seeding the Candle Management Server in Manage Candle Services . . . . . . . . . . . . . .85
Rebooting and Starting Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Starting and Configuring Candle Management Workstation . . . . . . . . . . . . . . . . . . . . .89
Starting CandleNet Portal Desktop Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Starting CandleNet Portal Browser Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
Enabling Security (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Additional Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Chapter 4. GUI Installation and Basic Configuration Steps on UNIX . . . . . . . . . . . . . . . . .95
Running the Installation Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Manage Candle Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Basic Configuration of Agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
CMS Configuration Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Seeding Procedure in Manage Candle Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108
5
File Permission Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
Security Validation on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
Starting and Stopping Products. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
Managing Log Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116
Verifying Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
Additional Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
Chapter 5. Command-Line Installation and Basic Configuration Steps on UNIX . . . . . . .121
Summary of Essential Steps for Command Line Installation . . . . . . . . . . . . . . . . . . . .122
Using install.sh to Install from CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Using CandleConfig to Configure or Reconfigure the Product. . . . . . . . . . . . . . . . . . .127
Seeding Procedure Using CandleSeed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
Using CandleServer to Start and Stop the Candle Management Server. . . . . . . . . . . .134
Checking CMS Shutdown Using netstat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
Using CandleAgent to Start and Stop Agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
Using CandleAudit to Manage Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
Using cinfo to Show Product Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
Using CandleExecute to Run Previously Defined Scripts or Commands . . . . . . . . . . .143
Verifying Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144
Silent Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
Additional Configuration Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
Chapter 6. Configuring OMEGAMON XE Web Services (SOAP Server) on Windows. . .151
Defining Hubs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
Adding Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154
Verifying the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
Chapter 7. Additional CMS Configuration on Windows . . . . . . . . . . . . . . . . . . . . . . . . . .157
Enabling Security (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
Hot Standby Feature (optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
Candle System Backup and Restore Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
Unattended (Silent) Installations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
CMS Name (seeding error 171). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
Chapter 8. Additional CMS Configuration on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
Setting Permissions for a Non-NIS Solaris CMS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
CMS Name (seeding error 171). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
Hot Standby Operation (optional). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172
Firewall Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
Using CandleMigrate to Migrate Enterprise Information Base Tables. . . . . . . . . . . . . .176
Chapter 9. Additional CandleNet Portal Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . .179
Connection to an External Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
Firewall Network Address Translation or Multiple Network Interface Cards . . . . . . . . .181
Firewall Scenarios. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
6 Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX
Chapter 10. Additional Agent Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
Alert Adapter for AF/REMOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
Warehouse Proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
Appendix A. Uninstalling Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199
Uninstalling Component Products on Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
Uninstalling Component Products on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
Appendix B. UNIX CandleRemote Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
Differences between CandleRemote and CandleClone . . . . . . . . . . . . . . . . . . . . . . . .204
CandleRemote Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
Using CandleRemote in GUI Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
Using CandleRemote in Command Line Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
Appendix C. UNIX CandleClone Command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
Differences between CandleClone and CandleRemote . . . . . . . . . . . . . . . . . . . . . . . .212
Using CandleClone in GUI Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
Using CandleClone in Command Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
Appendix D. UNIX Multi-platform Installation Configuration Files. . . . . . . . . . . . . . . . . . . .219
Multi-platform Installation Program. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
Configuration File Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
Appendix E. IBM Tivoli Product Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
Appendix F. IBM Tivoli Architecture Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
Appendix G. Support Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
Appendix H. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
7
8 Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX
Figures
Figure 1. IBM Tivoli OMEGAMON XE Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
Figure 2. Example Configuration Including a Remote CMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
Figure 3. Using Network File System on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Figure 4. Intranet with Integral Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
Figure 5. Intranet with External Web Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
Figure 6. Intranet with Integral Web Server; Internet with External Web Server . . . . . . . . . . . . .185
Figure 7. Intranet and Internet with Integral and External Web Servers . . . . . . . . . . . . . . . . . . .186
Figure 8. Two Host Addresses, Intranet and Internet, and with Integral and External
Web Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
9
10 Installing and Setting up OMEGAMON Platform and CandleNet Portal on Windows and UNIX
Description:2. Before using this information and the product it supports, read the OMEGAMON Platform Messages manuals provide lists of descriptions that help IBM Tivoli Candle Products Messages Volume 1 (AOP–ETX), SC32-9416-00.
