Tivoli Netcool/OMNIbusVersion 8 Release 1

Installation and Deployment Guide

SC27-6264-11

IBM

Tivoli Netcool/OMNIbusVersion 8 Release 1

Installation and Deployment Guide

SC27-6264-11

IBM

NoteBefore using this information and the product it supports, read the information in Notices on page 711.

This edition applies to version 8, release 1 of IBM Tivoli Netcool/OMNIbus (product number 5724-S44) and to allsubsequent releases and modifications until otherwise indicated in new editions.

Copyright IBM Corporation 1994, 2017.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

About this publication . . . . . . . . ixIntended audience . . . . . . . . . . . . ixPublications . . . . . . . . . . . . . . ixAccessibility . . . . . . . . . . . . . . xTivoli technical training . . . . . . . . . . xiSupport information . . . . . . . . . . . xiConventions used in this publication . . . . . . xi

Chapter 1. Introduction to TivoliNetcool/OMNIbus. . . . . . . . . . . 1The ObjectServer . . . . . . . . . . . . . 2Probes . . . . . . . . . . . . . . . . 3Gateways . . . . . . . . . . . . . . . 3

ObjectServer Gateways . . . . . . . . . . 3Desktop tools . . . . . . . . . . . . . . 4Administration tools . . . . . . . . . . . . 4Netcool MIB Manager . . . . . . . . . . . 6The Web GUI . . . . . . . . . . . . . . 6

Chapter 2. Quick reference to gettingstarted . . . . . . . . . . . . . . . 9

Chapter 3. Quick reference toupgrading . . . . . . . . . . . . . 13

Chapter 4. Planning for installation orupgrade . . . . . . . . . . . . . . 15Sizing your deployment . . . . . . . . . . 15

Sizing examples . . . . . . . . . . . . 17Disk space requirements . . . . . . . . . 24

IBM Prerequisite Scanner . . . . . . . . . . 25Obtaining the installation package . . . . . . . 26IBM Installation Manager. . . . . . . . . . 26

IBM Installation Manager overview . . . . . 27Obtaining Installation Manager . . . . . . . 29Installation Manager response files . . . . . 30Installing Installation Manager (GUI or console) 30Installing Installation Manager (silent) . . . . 33Installing Installation Manager for Web GUI . . 35

Supported operating systems . . . . . . . . 36JRE requirements . . . . . . . . . . . . 47Web GUI browsers, JREs, and mobile devices . . . 47User interface requirements . . . . . . . . . 48Online help requirements. . . . . . . . . . 49Networking protocol support . . . . . . . . 50Communication protocol . . . . . . . . . . 51Compatibility with previous versions . . . . . . 51Integration with other Tivoli products . . . . . 58setuid awareness of Tivoli Netcool/OMNIbusexecutables . . . . . . . . . . . . . . 59

Chapter 5. Installing and updatingTivoli Netcool/OMNIbus . . . . . . . 61Preparing to install . . . . . . . . . . . . 61

Tivoli Netcool/OMNIbus installable features . . 61Installation directory structure . . . . . . . 63

Installing Tivoli Netcool/OMNIbus . . . . . . 67Installing Tivoli Netcool/OMNIbus (GUI) . . . 68Installing Tivoli Netcool/OMNIbus (console) . . 73Installing Tivoli Netcool/OMNIbus (silent) . . . 77Collecting installation details . . . . . . . 80Post-installation tasks . . . . . . . . . . 81Removing Tivoli Netcool/OMNIbus. . . . . 101

Updating Tivoli Netcool/OMNIbus . . . . . . 103Preparing to update . . . . . . . . . . 103Updating Tivoli Netcool/OMNIbus (GUI) . . . 104Updating Tivoli Netcool/OMNIbus (console) 105Updating Tivoli Netcool/OMNIbus (silent) . . 107Collecting installation details . . . . . . . 108Rolling back updates . . . . . . . . . . 109

Upgrading from V7.4 (and earlier) . . . . . . 111Migrating data . . . . . . . . . . . . 111Files migrated during an upgrade . . . . . 113Updating the ObjectServer schema . . . . . 116Upgrading an ObjectServer connected to adatabase gateway . . . . . . . . . . . 119Preparing property value encryptions forupgrade (FIPS 140-2 mode) . . . . . . . . 120Guidelines for upgrading to UTF-8 encoding(Windows) . . . . . . . . . . . . . 121Upgrading a multitiered architecture . . . . 123Installing probes or gateways into an upgradedTivoli Netcool/OMNIbus environment . . . . 126Additional upgrade and migration notes . . . 126

Chapter 6. Installing and updating theWeb GUI component . . . . . . . . 135Preparing to install or upgrade the Web GUI . . . 137

Web GUI installation prerequisites . . . . . 137Gathering installation information . . . . . 140Installing and upgrading the Web GUI in a loadbalancing environment . . . . . . . . . 141Web GUI installation directory structure . . . 142Preserving files when a fix pack is applied . . 143

Installing the Web GUI . . . . . . . . . . 144Installing the Web GUI (GUI) . . . . . . . 144Installing the Web GUI in console mode . . . 146Installing the Web GUI in silent mode . . . . 148

Upgrading the Web GUI and migrating data . . . 150Upgrading from V7.4.0 or V7.3.1 on TivoliIntegrated Portal V2.2 or V2.1 . . . . . . . 151Upgrading from IBM Tivoli Netcool/WebtopV2.2 or Web GUI V7.3.0 . . . . . . . . . 157Migrating from IBM Tivoli Netcool/Webtopversions 2.0 or 2.1 . . . . . . . . . . . 157

Copyright IBM Corp. 1994, 2017 iii

Migrating from IBM Tivoli Netcool/Webtopversion 1.3.1 . . . . . . . . . . . . . 162Fix pack media offerings . . . . . . . . 166Backing up a V8.1 installation . . . . . . . 167Restoring a V8.1 installation . . . . . . . 167Updating to a V8.1 fix pack in a load balancingenvironment. . . . . . . . . . . . . 168

Performing post-installation tasks . . . . . . 170Performing postinstallation tasks for the WebGUI . . . . . . . . . . . . . . . 170Logging in . . . . . . . . . . . . . 173Protecting the vault key file . . . . . . . 175Assigning Web GUI roles to the administrativeuser . . . . . . . . . . . . . . . 175Changing the passwords of the supplied users 176Setting up the WAAPI client . . . . . . . 177Enabling multicultural support for the Web GUI 178

Troubleshooting installation . . . . . . . . 180Migration fails with "Out of Memory" errors 180

Removing the Web GUI . . . . . . . . . . 180

Chapter 7. Setting up the TivoliNetcool/OMNIbus system . . . . . . 183Initial configuration wizard. . . . . . . . . 183Creating and running ObjectServers . . . . . . 183

ObjectServer overview . . . . . . . . . 184Configuring automated failover and failback 185Creating an ObjectServer . . . . . . . . 186Starting an ObjectServer . . . . . . . . . 191Stopping an ObjectServer . . . . . . . . 194

Configuring server communication details in theServer Editor . . . . . . . . . . . . . 196

Creating and maintaining server entries afterinstallation . . . . . . . . . . . . . 196Configuring server communication information 198Adding a backup ObjectServer . . . . . . 201Changing the priority of servers . . . . . . 203Hiding backup ObjectServers in the ServerEditor (UNIX only) . . . . . . . . . . 204Testing a server. . . . . . . . . . . . 204Manually editing the connections data file. . . 204

Setting up distributed installations . . . . . . 205Step 1: Installing Tivoli Netcool/OMNIbuscomponents . . . . . . . . . . . . . 205Step 2: Configuring component communications 206Step 3: Distributing the interfaces files (UNIXonly) . . . . . . . . . . . . . . . 207

Chapter 8. Configuring and deployinga multitiered architecture . . . . . . 209Before you begin . . . . . . . . . . . . 209

Overview of the standard multitieredarchitecture . . . . . . . . . . . . . 209Naming conventions for the multitieredarchitecture . . . . . . . . . . . . . 212Component resourcing: determining the numberof ObjectServers needed . . . . . . . . . 213Severity handling . . . . . . . . . . . 215Multitiered configuration file locations . . . . 217

Setting up the standard multitiered environment 218

Configuring server communication information(multitiered architecture) . . . . . . . . 219Installing the primary aggregation ObjectServer 220Installing the backup aggregation ObjectServer 221Configuring the bidirectional aggregationObjectServer Gateway . . . . . . . . . 222Installing the primary collection ObjectServer 222Configuring the unidirectional primarycollection ObjectServer Gateway . . . . . . 223Installing the backup collection ObjectServer 224Configuring the unidirectional backup collectionObjectServer Gateway . . . . . . . . . 225Installing the display ObjectServer 1. . . . . 225Configuring the unidirectional displayObjectServer 1 Gateway . . . . . . . . . 227Installing the display ObjectServer 2. . . . . 227Configuring the unidirectional displayObjectServer 2 Gateway . . . . . . . . . 229

Installing additional ObjectServers . . . . . . 229Adding a second pair of collection ObjectServers 229Adding an additional display ObjectServer . . 235

Automatic load balancing of event list clients. . . 238Creating custom triggers . . . . . . . . . 240The performance triggers . . . . . . . . . 241Resynchronization Complete synthetic events . . 243Final steps . . . . . . . . . . . . . . 243Sample omni.dat files. . . . . . . . . . . 244User triggers in multitiered environments . . . . 245Upgrading a multitiered architecture . . . . . 246

Chapter 9. Configuring highavailability. . . . . . . . . . . . . 249Failover configuration . . . . . . . . . . 249Configuring controlled failback of clients . . . . 251Configuring probes for high availability . . . . 253

Configuring probes to run in circularstore-and-forward mode . . . . . . . . . 253Configuring peer-to-peer failover mode . . . 254

Reducing event loss on ObjectServer failure duringresynchronization . . . . . . . . . . . . 256Reducing resynchronization time . . . . . . . 256Configuring controlled shutdown of anObjectServer. . . . . . . . . . . . . . 256Configurin