Académique Documents
Professionnel Documents
Culture Documents
ibm.com/redbooks
Redpaper
International Technical Support Organization IBM Tivoli Business Service Manager V4.1 September 2007
REDP-4288-00
Note: Before using this information and the product it supports, read the information in Notices on page v.
First Edition (September 2007) This edition applies to Version 4, Release 1, Modification 0 of Tivoli Business Service Manager (product number 5724-C51).
Note: This book is based on a pre-GA version of a product and may not apply when the product becomes generally available. We recommend that you consult the product documentation or follow-on versions of this book for more current information.
Copyright International Business Machines Corporation 2007. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii The team that wrote this IBM Redpaper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Become a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii Comments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Chapter 1. Introduction to business service management . . . . . . . . . . . . . 1 1.1 Business service management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 1.2 Tivoli management portfolio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.3 Redpaper environment and organization . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Chapter 2. Tivoli Business Service Manager concepts and architecture . 5 2.1 Business service management concepts . . . . . . . . . . . . . . . . . . . . . . . . . . 6 2.2 Tivoli Business Service Manager architecture . . . . . . . . . . . . . . . . . . . . . . 8 2.2.1 Netcool OMNIBus object server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2.2.2 Netcool license server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.2.3 Netcool security server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 2.2.4 Netcool GUI Foundation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.2.5 Tivoli Business Service Manager server . . . . . . . . . . . . . . . . . . . . . . 14 2.3 Interfaces and integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.3.1 Tivoli EIF event interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.3.2 Discovery interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.3.3 ESDA interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2.4 Services Manager or Systems Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 18 2.4.1 Terminologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2.4.2 Function differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 3.1 Installation process overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 3.2 Installation planning considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 3.3 Typical full installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 3.4 Migration process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 3.4.1 License server considerations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 3.4.2 Security manager considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 3.4.3 Netcool OMNIbus considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 3.4.4 Migrating Tivoli Business Service Manager data . . . . . . . . . . . . . . . 37
iii
3.4.5 Manual modifications required . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Chapter 4. Working with Discovery Library toolkit . . . . . . . . . . . . . . . . . . 41 4.1 Introduction Discovery Library toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 4.2 Installation of the Discovery Library toolkit . . . . . . . . . . . . . . . . . . . . . . . . 43 4.2.1 Verify the xmltoolkitsvc.properties is correct . . . . . . . . . . . . . . . . . . . 48 4.2.2 Verify Tivoli BSM Discovery Library toolkit service . . . . . . . . . . . . . . 49 4.2.3 Verify that default templates have been installed . . . . . . . . . . . . . . . 49 4.2.4 Test discovery using the sample provided . . . . . . . . . . . . . . . . . . . . 50 4.3 IBM Tivoli Discovery Library Adapter for z/OS . . . . . . . . . . . . . . . . . . . . . 51 4.3.1 Discovery features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 4.3.2 Installing z/OS DLA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 4.3.3 Running z/OS discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 4.3.4 Running Discovery Library toolkit . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 4.4 Tivoli Application Dependency Discovery Manager . . . . . . . . . . . . . . . . . 62 4.4.1 Integration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 4.4.2 Integration prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 4.4.3 Integration in action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 Chapter 5. Operational aspects of Tivoli Business Service Manager . . . 71 5.1 Startup and shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 5.2 Backup and recovery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 5.3 Performance optimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 5.4 Failover consideration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 5.4.1 Setting up security server for failover . . . . . . . . . . . . . . . . . . . . . . . . 75 5.4.2 Setting up OMNIbus for failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 5.4.3 Setting up Tivoli Business Service Manager for failover . . . . . . . . . . 76 5.4.4 Finalizing failover configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Related publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 IBM Redbooks Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Other publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 Online resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 How to get IBM Redbooks Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Help from IBM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
iv
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. 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 may 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. 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. 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.
Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United States, other countries, or both: Redbooks (logo) z/OS zSeries AIX 5L AIX CICS DB2 IBM IMS MQSeries Netcool NetView OMEGAMON Redbooks RACF Tivoli Enterprise Tivoli Enterprise Console Tivoli WebSphere
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office. Other company, product, or service names may be trademarks or service marks of others.
vi
Preface
This IBM Redpaper leads you through the new Tivoli Business Service Manager V4.1 that is based on Netcool/Realtime Active Dashboard (RAD), instead of the previous Tivoli Business Systems Manager V3.1. This paper describes Tivoli Business Service Manager V4.1 components and architecture. It also discusses function comparison of Tivoli Business Systems Manager V3.1 and Netcool/RAD to Tivoli Business Service Manager V4.1. It documents the installation and migration of Tivoli Business Service Manager V4.1 in our environment. Migration is currently only available for Netcool/RAD 3.0 users. This paper also discusses integration with IBM Tivoli Service Management framework that allows Tivoli Business Service Manager to integrate with Tivoli Change and Configuration Management database (CCMDB) using Discovery Library toolkit. This function is also available for z/OS configuration. Finally, Tivoli Business Service Manager operational consideration is discussed, including backup and recovery process, maintenance schedule, and performance tips.
vii
Gary Kalatucka is a Senior Consultant for the SWAT team worldwide team specializing in Availability and Business Service Management from IBM United States. Thanks to the following people for their contributions to this project: Allen Sofley, Editor International Technical Support Organization Douglas McClure, Daniel Kitay, Rod Bowman IBM Software Group
viii
Comments welcome
Your comments are important to us! We want our IBM Redpapers to be as helpful as possible. Send us your comments about this IBM Redpaper or other IBM Redbooks Publications in one of the following ways: Use the online Contact us review form found at: ibm.com/redbooks Send your comments in an e-mail to: redbooks@us.ibm.com Mail your comments to: IBM Corporation, International Technical Support Organization Dept. HYTD Mail Station P099 2455 South Road Poughkeepsie, NY 12601-5400
Preface
ix
Chapter 1.
Platform based grouping (which might only be of interest to the IT department): for example, Windows servers, UNIX machines, mainframes Any other combination or decomposition of an entity that needs to be managed The availability of a business service would be the most important aspect for Service Level Agreement (SLA). In SLA, the service provider commits certain measurement for services to satisfy the service consumer. In IT service SLAs, it is important to harness the users view of the service status instead of the IT departments view of it. The abstraction of different components that build into a business service provides a framework to measure the net impact of business service availability affected by different combination of outages and failures.
Service Deployment
Information Management
Business Resilience
Best Practices
Storage Management
Security Management
In Figure 1-1, the business service management product resides in the business application management discipline. For more information on other Tivoli product suites, visit the Tivoli homepage at: http://www.ibm.com/tivoli
The business service management function is primarily managed using the products: IBM Tivoli Business Service Manager: manages business service entities because they are affected by the health and status of the underlying IT components IBM Tivoli Service Level Advisor: collects and maintains service level information from various sources for reporting and analysis This paper discusses the IBM Tivoli Business Service Manager Version 4.1. This product evolved from Netcool/Real-time Active Dashboard (RAD) Version 3.0. The product will merge with the existing IBM Tivoli Business Systems Manager Version 3.1 in the next release.
Chapter 2.
SQL query
Service templates
Service instances
Tivoli Business Service Manager service management function is defined as a set of service templates and rules. Service templates can be regarded as a class definition. Service templates are created in a tree like structure. A service template is an instance generator which defines how the service objects are created. Service objects creation is based on: Events from Netcool/OMNIbus External SQL query from a repository table Rules are definitions changing service instance definition and its attributes. There are several different types of rules in Tivoli Business Service Manager, such as: Service object creation rules Auto population rule: determines how an event can create service instances Data fetcher rule: creates service objects based on data on a relational database Enhanced Service Dependency Adapter (ESDA) rule: dynamic service object creation based on an external relational database query. Service objects that are created using ESDA rules can be persistent or non-persistent. Their statuses are calculated at runtime using a database query.
Incoming status rule: defines how an event or data query changes the status of a service object, can be based on the event state or a numerical computation Status aggregation rule: calculating a status of a service object based on the collective status of its children Numerical rule: defines a computational value that can be used to show a new attribute of an instance (numerical formula rule) or an aggregated status of an instance (numerical aggregation rule) Cumulative SLA rule: SLA is based on the time a service object has a good status. Duration cumulative SLA rule: SLA is based on availability on a specific duration (for example: 1 hour of down time in a day). Incident based SLA rule: SLA is measured from the number of detected outages.
The user interface for Tivoli Business Service Manager is Web browser based. It is based on the Netcool GUI Foundation. The following are some user interface objects that can be customized in the Web interface: Custom view. There are several view types in Tivoli Business Service Manager, such as: Basic relationship tree with only color coded status Relationship tree view with SLA information and event count information Concentric with the root node as the center Grid for all the children without relations Geographical Information System (GIS) map
Custom canvas. The canvas provides a visualization method for a service object. The canvas is useful when combined with the appropriate view to quickly present business status. Context menu or action items Custom icon for newly defined template or service object
NetView
Optional components
TBSM processes
SLA events
TBSM postgreSQL
user data
license
In Figure 2-2, the components in the TBSM processes box must exist and can be installed using the Tivoli Business Service Manager installation wizard. These are the central components that make up the Tivoli Business Service Manager server. The optional components are distributed with Tivoli Business Service Manager but can be installed separately. These components are primarily used if you want to interface Tivoli Business Service Manager with external systems. The items in Figure 2-2 that are not shown in the boxes are external components that interface with Tivoli Business Service Manager. The discussion in this section primarily regards the mandatory components in the TBSM processes box in Figure 2-2. The optional components and external interfaces are discussed in 2.3, Interfaces and integration on page 15.
10
The OMNIbus events can be accessed using the utility called $NCHOME/omnibus/bin/nco_event. The login page is shown in Figure 2-4 on page 12. Note: We have to modify $NCHOME/platform/linux2x86/locales/locales.dat under the [linux] section to define out locale. The $LOCALE definition in our Red Hat Enterprise Linux is en_US.UTF-8, while the definition is en_US.utf8.
11
When you click View, for example in the All Events area, the detailed event list is displayed. See Figure 2-6 on page 13.
12
13
The security manager is installed as a separate directory structure under $NCHOME/security. The user and group IDs in the security manager are stored in a separate database under $NCHOME/security/db directory. For UNIX or Linux based platforms, the command ncsm_db can be used to maintain the database. Another option for using the security manager is to interface authentication to an external Light-weight Directory Access Protocol (LDAP) server. This allows user management to be performed integrated with other user authentication processes outside of the Netcool suite.
14
The Tivoli Business Service Manager Web application uses a separate postgreSQL relational database as its repository. The postgreSQL database runs on its own process. The Netcool GUI Foundation uses JDBC to access the postgreSQL database.
15
The discovery interface allows service instance creation based on the object structure from the XML files. The service instances are created in the SCM tables. The actual instances are created from the SCM instances. The discovery interface can also be used to create resources from the z/OS Discovery Library adapter. The Discovery Library adapter is discussed in Chapter 4, Working with Discovery Library toolkit on page 41.
16
Event no 0 4 2 2 1 19 2
Enterprise
Location
Machine
Software
In Figure 2-7, the source data is a single table. From the table, we define the hierarchy of Enterprise - Location - Machine - Software component. The mapping of the hierarchy would be similar to Table 2-1.
Table 2-1 Hierarchy mapping Component Enterprise Location Machine Software Source data ABC Corp substr(hostname, pos(.,hostname), length(hostname)) hostname column sw column
Based on that hierarchy, the service instances are then defined similar to Figure 2-8 on page 18.
17
ABC Corp north.abc.com abc DB2 WebSphere def Apache DB2 south.abc.com Tomcat ghi Domino WebSphere
18
2.4.1 Terminologies
This section provides a summary of terminologies translation. The translation is performed loosely based on the apparent functions that they provide. The definitions that we provide here are for comparing the functionality of the products, not a formal translation. Physical resource SCM resource Only resources from the Discovery Library adapter would appear in this tree. This is the closest that Tivoli Business Service Manager V4.1 has regarding physical resources. For service instances defined directly from auto population rules based on events, there is no concept of physical resources. Service instance There is no concept of physical resources in Tivoli Business Service Manager V4.1. All definitions are related to business system resources and business system folder. There is no distinction between them. Service template This is a loosely related definition of the class object to be the template for the instances. The classes in Tivoli Business Systems Manager V3.1 are formally related to physical resource type, however the service template defines the hierarchy of the business system tree. The business system tree is not structured rigidly, but the service tree hierarchy is defined by the template structure. The same resource can appear in different tree branches, but this might require a different template being defined.
Resource
Class
Alerts and messages Events There is no distinction on the types of events nor its source in terms of processing. All events are treated equally from Netcool/OMNIbus or an external data calculation. Child event Numerical rules The events are not propagated based on the incoming events, such as in Tivoli Business Systems Manager V3.1. The status of aggregate objects or containers are calculated based on the numerical rules from the children status. Tivoli EIF probe The event enablement interface allows events to be retrieved from the Tivoli Enterprise console. The function
Event enablement
19
is performed by the Tivoli EIF probe. There is no comparable function for common listener, because it can perform both topology discovery and alerting functions. The discovery must be ported to the Discovery Library adapter, while a new probe might be needed to receive its events. There are some functions in Tivoli Business Systems Manager V3.1 that have no comparable functions in Tivoli Business Service Manager V4.1. They are just inherently not needed. Some of them are: Business systems building tools Business systems building tools, such as Automated Business Systems (ABS) or XML interface, are not needed as the service instance structure must be predefined using service templates. The templates define the structure of the discovered instances and also determine the containment hierarchy of the instances. The ESDA interface can be used to accommodate service instance hierarchy that is totally dynamic based on external relational data for both placement and status. Critical resource list There is no critical resources list in Tivoli Business Service Manager V4.1. Custom views can be created for operators that provide quick access to critical resources for the operator. Executive dashboard Because the Web interface is very adaptable and versatile, custom views can be created to accommodate the executive dashboard function. There is only a single Web console for Tivoli Business Service Manager V4.1, as opposed to the three options for accessing Tivoli Business Systems Manager V3.1 from a Java console, Web console, or executive dashboard (or four options with the reporting system).
20
Function Discovery of Distributed Resources using TADDM Discovery of Distributed Resources using Discovery Library adapters Discovery of Distributed Resources using Data Fetcher (query) Discovery of z/OS Resources using Events Discovery of z/OS Resources using TADDM Discovery of z/OS Resources using batch process Discovery of z/OS Resources using Discovery Library adapters Discovery of z/OS Resources using Data Fetcher (query) Automatic Business System Rules (ABS) Automatic Business Service Population (Auto-Population Rules, DataFetcher, ESDA, Composite Objects using Discovery) Resource and Business System Creation (import file) Resource and Business System Creation (manually from console) Dynamic Resource and Business System Creation from External Data Source (using ESDA) Event Management Infrastructure/Event Respository - Internal database structure Event Management Infrastructure/Event Respository - OMNIbus provides the Event Management Infrastructure Counter Based Status Propagation (Threshold) - Defined at Object Level in v3.1 - Defined at event rule level in v4.1 Percentage Based Status Propagation Worst Case Status Propagation Java Console
V3.1 X X
V4.1 X X X
Prerequisite
X X
X X X X X
X X
X X X
X X Netcool OMNIbus*
X X X
X X
21
Function Web Console Executive Dashboard Visualization - Console consolidation point Visualization - Custom workspace per user Visualization - Canvas View Definitions (view customization) Visualization - All Resource View Visualization - Business System View - Service Navigation Panel in V4.1 Visualization - Tree View - Service Navigation Panel in V4.1 Visualization - Service Navigator Scorecard Visualization - Topology View - Service Viewer in V4.1 Visualization - Event Detail View - Service Affecting Events View and Active Event List in V4.1 Visualization - Events Summary Panel Visualization - HyperView Visualization - Table View Visualization - Business Impact View - Service Viewer in V4.1 Visualization - z/OS Systems Specific Views - CICS, IMS, DB2, Batch Visualization -GIS Map-based View Active Metric Retrieval from External Data Sources Numerical Formula Based Calculations (for status & metrics) Role-based User Authentication and Authorization Right-Click Task Integration from Business Service - URL Launch only for V4.1
V3.1 X X X X X X X X
V4.1 X X X X X
Prerequisite
X X X
X X
X X
22
Function Right-Click Task Integration from event Tivoli Management Framework Integration NetView for z/OS Command Integration System Automation for z/OS Command Integration Policy Based Actions (clear events, send email, execute external commands, scripts and applications, and so on) Alert Workflow Historical Reporting Problem Ticket Interface Self-Management (Health Monitor) Maintenance Mode Support Real-time SLA Integration - Configure real-time SLA against defined business services Historical SLA Integration Failover
V3.1 X X X X X
V4.1 X
X X X X X
X X X
X X
X X
Tivoli Service Level Advisor Netcool OMNIbus* Netcool OMNIbus ObjectServer Gateway
23
24
Chapter 3.
Installation and migration consideration for Tivoli Business Service Manager V4.1
This chapter documents our experiences in installing and migrating to Tivoli Business Service Manager V4.1. The discussion consists of: 3.1, Installation process overview on page 26 3.2, Installation planning considerations on page 27 3.3, Typical full installation on page 27 3.4, Migration process on page 33
25
26
As shown in Figure 3-1 on page 26, the DVD image contains the installation wizard for all the components. The installation also gives the option of performing migration. Migration is only supported from Netcool Real-time Active Dashboard V3.0. We discuss migration in 3.4, Migration process on page 33.
The installation of Tivoli Business Service Manager must be performed by a user ID other than root or Administrator. You can define the user ID using: Computer Management application in Windows, go to Local users and groups Users and select Add. The command smitty user in AIX would take you to user administration functions. The command adduser in Linux would add a user and its associated attributes.
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
27
Installation is started from the launch pad. You must start this using a non-root user ID. The launch pad is started automatically when the DVD is inserted; otherwise you can invoke the launchpad using the launchpad or ./launchpad.sh commands. The launchpad window is shown in Figure 3-2.
From the launch pad in Figure 3-2, click Install IBM Tivoli Business Service Manager V4.1 link, and start the installation wizard. You can use the default options for the installation. The installation options window on a Linux platform are shown in Figure 3-3 on page 29. It basically requires only the home directory of where to install the product. The default directory in Linux is /opt/IBM/Netcool. This directory would be called $NCHOME.
28
Figure 3-4 shows the list of products and options for this installation.
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
29
After the install, Tivoli Business Service Manager processes are started automatically, and the default service templates are defined. If Tivoli Business Service Manager is not started you can start it using the sequence shown in Figure 3-5.
[TBSMadmin@tbsmsrv ~]$ $NCHOME/InstallTBSM/bin/start_licsvr.sh Running: /opt/IBM/Netcool/license/bin/nc_start_license & Number of License Server processes found = 2 License Server is running, continue... [TBSMadmin@tbsmsrv ~]$ $NCHOME/InstallTBSM/bin/start_secmgr.sh Running: /opt/IBM/Netcool/security/bin/ncsm_server & Starting Server ... Logging to file: log/SM_server.log ... Server Started. Number of Security Manager processes found = 2 Security Manager is running, continue... [TBSMadmin@tbsmsrv ~]$ $NCHOME/InstallTBSM/bin/start_omni.sh NCOMS Running: /opt/IBM/Netcool/omnibus/bin/nco_objserv -name NCOMS & Netcool/OMNIbus Object Server - Version 7.1 Copyright (C) 1994 - 2005, Micromuse Ltd. All rights reserved. Server 'NCOMS' initialised - entering RUN state. Number of ObjectServer processes found = 1 ObjectServer is running, continue... [TBSMadmin@tbsmsrv ~]$ $NCHOME/InstallTBSM/bin/start_tbsm.sh Running: /opt/IBM/Netcool/bin/rad_server & JAVA_HOME is /opt/IBM/Netcool/platform/linux2x86/jre_1.5.0 JAVA_OPTS is -Dnchome=/opt/IBM/Netcool -Dngfhome=/opt/IBM/Netcool/guifoundation . . . Starting IBM Tivoli Business Service Manager Server process... Figure 3-5 Starting Tivoli Business Service Manager processes
You can verify that processes are running as shown in Figure 3-6 on page 31. Using the ps -ef command. It shows the following processes: Netcool GUI Foundation Adaptive Server Anywhere database Tivoli Business Service Manager progreSQL database processes License manager processes Security manager processes Netcool OMNIbus object server Netcool GUI Foundation Tivoli Business Service Manager server
30
5738 5957 5960 5961 5962 6088 6089 6099 6107 6161 6203
/opt/IBM/Netcool/guifoundation/asa/unix/dbsrv9 -o /opt/IBM/Netcool/guifoundatio /opt/IBM/Netcool/platform/linux2x86/pgsql8/bin/postmaster -B 35 -N 15 -i postgres: writer process postgres: stats buffer process postgres: stats collector process /opt/IBM/Netcool/license/platform/linux2x86/bin/lmgrd -c $NCHOME/license/etc/ netcool -T tbsmsrv 9.2 3 -c /opt/IBM/Netcool/license/etc/ --lmgrd_start /bin/sh /opt/IBM/Netcool/security/bin/ncsm_server /opt/IBM/Netcool/platform/linux2x86/jre_1.4.2/bin/java -Dapp=SM_ncsm_server /opt/IBM/Netcool/omnibus/platform/linux2x86/bin/nco_objserv -name NCOMS /opt/IBM/Netcool/platform/linux2x86/jre_1.5.0/bin/java -Dnchome=/opt/IBM/Netcool
You can get into the Tivoli Business Service Manager console using a Web browser to connect to port 8080 of your machine. The default user ID is admin with the password netcool. Figure 3-7 shows the login panel.
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
31
Inside the Tivoli Business Service Manager interface, you can see the predefined service templates using the Service Administration desktop. The templates are shown in the Service Component Repository tree. These templates are defined from the $NCHOME/guifoundation/webapps/sla/install/BSM_Templates.radsh file. If you are using an Advanced installation and want to load the templates, you can run the $NCHOME/bin/rad_radshell and pipe the radsh file to the command. Figure 3-8 shows the service templates definition.
This concludes our installation discussion. The migration process in 3.4, Migration process on page 33 should be run only if you have an existing Netcool Real-time Active Dashboard (RAD) V3.0.
32
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
33
License Server
License Server
Security Server
Security Server
OMNIbus
OMNIbus
RAD 3.0
TBSM 4.1
The migration process would be: 1. Install a new custom installed Tivoli Business Service Manager server (or servers) according to the desired configuration. You may preserve the options that you have for the existing Netcool RAD environment, such as a separate OMNIbus or failover implementation. The Tivoli Business Service Manager installation type must be custom. The custom installation does not create the default service templates. 2. Migrate prerequisite software if needed, or prepare for inplace migration. Actions include: Expand the existing OMNIbus schema for Tivoli Business Service Manager V4.1 processing or apply schema modifications from the existing OMNIbus. Add new Tivoli Business Service Manager V4.1 licenses to the existing license server, or migrate other Netcool licenses to the new license server. Use existing security, or migrate security manager user ID and groups. 3. Stop Netcool RAD processing, by disabling probes to the OMNIbus. Generate an export file for Tivoli Business Service Manager definitions. 4. Apply migrated Netcool RAD definitions into an empty Tivoli Business Service Manager system.
34
5. Perform manual changes for additional Tivoli Business Service Manager features.
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
35
The database files (*.tab) will be stored on the directory that you choose. You can copy these files into the new OMNIbus while it is not running. The OMNIbus database called NCOMS is stored in $NCHOME/omnibus/db/NCOMS.
36
After the OMNIbus database is restored, you must update the Tivoli Business Service Manager V4.1 data model from $NCHOME/InstallTBSM/sql/tbsm_db_update.sql similar to Usage of existing OMNIbus on page 36. Furthermore, you must also run the following SQL command using the interactive SQL prompt:
UPDATE alerts.status SET RAD_FilterIDList = , RAD_RawInputLastValue = 6;
ncs200*.jar
ncsSoapClient200*.jar remove existing ncsSoapClient200*.jar from $NCHOME/guifoundation/webapps/sla/WEB-INF/lib; and copy $platform/TBSM/migration/ncsSoapClient200*.jar to $NCHOME/guifoundation/webapps/sla/WEB-INF/lib The migration wizard windows are shown in Figure 3-11 on page 38.
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
37
The migration wizard performs the following steps: 1. Invoking rad_radshell for command line access to Tivoli Business Service Manager. This is performed from the Tivoli Business Service Manager V4.1 server. 2. Running the radshell command exportForMigration(host, port) that is targeted to the RAD 3.0 host and port. This would invoke SOAP access to the RAD 3.0 server. This creates export.radsh script under $NCHOME/guifoundation/webapps/sla. 3. Piping the export.radsh file into the rad_radshell command. This creates the objects while preserving the object IDs. 4. Copying files using the radshell command getfile(radhost, radport, radNCHOME, tbsmNCHOME, path, user, password). Additions to these files are
38
applied to the new files in the Tivoli Business Service Manager V4.1 server. The files are: Maintenance schedule: $NCHOME/guifoundation/webapps/sla/xml/scheduleTime.xml Custom view definitions and custom service tree: $NCHOME/guifoundation/webapps/sla/av/xmlconfig Custom static view: $NCHOME/guifoundation/webapps/sla/av/canvas Custom dashboard changes: $NCHOME/guifoundation/webapps/sla/dashboard/chartconfig and $NCHOME/guifoundation/webapps/sla/dashboard/chartcss
Chapter 3. Installation and migration consideration for Tivoli Business Service Manager V4.1
39
b. From the Tivoli Business Service Manager V4.1 Web consoles Administration window, Layout tab, select the pages list. Click the Import button to indicate the source files as exported from step a. Figure 3-13 shows the import page.
Icon files must be migrated from: $NCHOME%/guifoundation/webapps/sla/icons $NCHOME%/guifoundation/webapps/sla/icons/svg Property files migration from: $NCHOME/etc/rad/RAD_av.props $NCHOME/etc/rad/RAD_chart.props $NCHOME/etc/rad/RAD_server.props $NCHOME/etc/rad/RAD_sla.props
40
Chapter 4.
41
Bulk load
TADDM API `
ESDA
TBSM database
read
XML toolkit
Discovery Library Reader SCR tables
The Discovery Library toolkit acts as a Windows service or UNIX daemon that monitors the data source and adds data to the Service Component Registry (SCR) tables. Tivoli Business Service Manager uses ESDA rule to query these tables and build the service object hierarchy based on these tables. Discovery library books are idML files that are created by Discovery Library adapter (DLA) programs. There are various IBM DLAs output that are supported by Tivoli Business Service Manager V4.1, including: IBM Tivoli Monitoring Services IBM Tivoli Discovery Library Adapter for z/OS IBM Tivoli Composite Application Manager for SOA IBM Tivoli NetView for z/OS
42
Discovery Library books from the DLAs can be either loaded directly in Tivoli Business Service Manager 4.1 or can be loaded into Tivoli Application Dependency Discovery Manager into the Configuration Manager Database (CMDB). We recommend that if Tivoli Application Dependency Discovery Manager is deployed, the DLAs should be loaded into Tivoli Application Dependency Discovery Manager and then imported to Tivoli Business Service Manager 4.1 using the Tivoli Application Dependency Discovery Manager API. More information about the DLAs can be found on the IBM OPAL website at http://catalog.lotus.com/wps/portal/tccmd. Generally Tivoli Business Service Manager 4.1 supports all DLAs that conform to version 2.3 of the Common Data Model (CDM) specifications. The processing of Discovery Library books by Tivoli Business Service Manager 4.1 are similar for all Discovery Library adapters. This chapter discusses: 4.2, Installation of the Discovery Library toolkit on page 43 which shows the installation and verification of the Discovery Library toolkit. 4.3, IBM Tivoli Discovery Library Adapter for z/OS on page 51. 4.4, Tivoli Application Dependency Discovery Manager on page 62 which discusses the integration with IBM Tivoli Application Dependency Discovery Manager.
43
44
3. The license agreement panel is launched. 4. Figure 4-4 shows the installation target directory. Although the panel suggests that you can change this installation directory, you should not change this. The toolkit uses $NCHOME location to get the JDBC driver for the PostgreSQL database. The directory will default to the $NCHOME/XMLToolkit. Click Next.
5. Figure 4-5 shows the Tivoli Business Service Manager connection information window. The Discovery Library toolkit connects to the Tivoli Business Service Manager using SOAP connection from the information in this window. Click Next after filling in the values. Note: The userid and password are not validated during the install. The default userid and password on the Tivoli Business Service Manager 4.1 install is admin and netcool.
6. Figure 4-6 on page 46 shows the window for configuring the Discovery Library toolkit data source. We selected Discovery Library books. This setting can be modified after the install by updating the $NCHOME/XMLToolkit/bib/xmltoolkitsvc.properties file. The userid and
45
password must be entered for access to the Tivoli Business Service Manager PostgreSQL database. Click Next. Note: The PostgreSQL userid is not validated during the install.
Figure 4-6 Data source for toolkit and database user information
7. Figure 4-7 on page 47 shows the postgreSQL connection information. All of the values are populated with the defaults. We accept all the default values. Click Next.
46
8. Figure 4-8 prompts for the location of the Discovery Library books. This directory is the location where the books will be read. This directory can be modified to any directory accessible to the Tivoli Business Service Manager server. The default is $NCHOME/discovery/dlbooks. Click Next.
9. Figure 4-9 on page 48 shows the summary of the installation. Click Next.
47
10.After the progress bar and the installation process is running, click Finish in the installation complete window. After the Discovery toolkit is installed there are various ways to verify the installation was successful and configured correctly. A reboot of the server is not required after the install. Prior to starting and testing, it would be beneficial to verify the install. Here are some suggestions: Verify the xmltoolkitsvc.properties is correct on page 48 Verify Tivoli BSM Discovery Library toolkit service on page 49 Verify that default templates have been installed on page 49 Test discovery using the sample provided on page 50
48
Note: If the Discovery Library toolkit is reinstalled it will NOT recreate this file. If the toolkit was installed for Discovery Library books, then uninstalled the configuration will not change. We suggest you rename the $NCHOME/XMLToolkit directory before reinstalling the toolkit.
49
50
3. Verify in the console that the instances were created. 4. The logs for the toolkit can be found in the $NCHOME/XMLtoolkit/log directory. The log file names are msgGTM_XT.log for the message log and traceGTM_XT.log is for trace. The properties for the trace setting is in $NCHOME/XMLtoolkit/bin/enqueuecl.properties.
51
Although all of this information is created in the Discovery Library books, not all of the discovery data creates individual services in Tivoli Business Service Manager 4.1 Service Component Registry. The z/OS Discovery Library Adapter will discover the following z/OS resources and relationships: zSeries hardware and z/OS details Address Space details and relationships DB2 Subsystem details and relationships IMS subsystem details and relationships MQ subsystem details and relationships CICS region details and relationships WebSphere Application Server details and relationships Status event for z/OS discovered resources is supported from the OMNIbus Tivoli EIF Probe. There are several ways to integrate these events including: NetView for z/OS forwarding of TEC events Event Integration Facility from Tivoli Business Systems Manager V3.1 object pump OMEGAMON situation events from Tivoli Enterprise Monitoring Server
52
User setup
A valid TSO userid must be set with the following accesses: The user must have an OMVS segment to run the DLA. From a security administrator user, you can add an OMVS segment using the ALU command similar to ALU userid OMVS(HOME(/u/userid) PROGRAM(/bin/sh) UID(555)) The user must have READ access to RACF protected resources as required, such as system PARMLIB data set, MQCMDS class resources, and WebSphere configuration files. The user must have access to the DB2 DSNREXX interface. The user must be granted READ access to DB2 controlled resources: DB2 -DISPLAY commands (DISPLAY GROUP and DISPLAY DB) SYSIBM resources (SYSIBM.SYSDATABASE, SYSIBM.SYSTABLES, SYSIBM.SYSTABLESPACE, SYSIBM.SYSINDEXES, and SYSIBM.SYSCOLUMNS). The user must be granted READ access to MQ controlled resources in the MQCMDS class for DISPLAY commands (QMGR, DQM V5.3.1, or CHINIT V6.0 and CHANNEL).
Install process
Download the z/OS DLA from the URL: http://catalog.lotus.com/tccmd?NavCode=1TW10CC0H Once you have downloaded the z/OS DLA, unzip the file and run the HTML application file zosdla_ftp.hta. The zosdla_ftp.hta opens a Web browser. The top part shown in Figure 4-11 on page 54 provides the parameters and four operation options: Run z/OS DLA and download the output XML files Download all XML files Download all members Install z/OS DLA V2.1 run time datasets
53
Select the Install z/OS DLA V2.1 run time datasets for PoC as seen in Figure 4-11. The z/OS DLA FTP utility requires the following information: FTP Server IP Name/Address - Hostname or IP address of the z/OS operating system where the DLA will be installed Note: If there is a firewall authentication required to connect to the z/OS operating system, it will have to be done prior to submitting the z/OS DLA. FTP Userid - TSO userid that has the access required to run the DLA FTP Password - TSO password FTP Port - The FTP port on the z/OS operating system z/OS DLA Dataset HLQ - The default high level qualifier is the &SYSUID which is the TSO userid. This is the dataset name of the target library of the DLA. z/OS DLA IDML Dataset - The default high level qualifier is the &SYSUID which is the TSO userid. This will be the partitioned dataset for storing the IDML output.
54
Figure 4-12 shows the bottom part of the page. The content of this area is dynamic, depending on your selection in the top part. The instruction and JCL is provided for the installation selection.
Figure 4-12
The JCL changes updates made to the panel are not saved after the first execution. If you plan on installing on multiple environments or you might want to save your changes, you can update the template_jcl_install.txt file. Example 4-1 on page 56 shows the content of this JCL file template.
55
//&SYSUID.I JOB (),'INSTALL ZOS DLA', // CLASS=A,MSGCLASS=H,REGION=0M,NOTIFY=&SYSUID //* /*JOBPARM SYSAFF=* RUN ON OS THAT THE JOB WAS SUBMITTED //* //INSTALL EXEC PGM=IKJEFT01 //SYSPRINT DD SYSOUT=*,HOLD=YES //SYSTSPRT DD SYSOUT=*,HOLD=YES //SYSTSIN DD * RECEIVE INDSN('&DLAHLQ..XMIT') DA('&DLAHLQ..XMITPDS') RECEIVE INDSN('&DLAHLQ..XMITPDS(SIZDEXEC)') DA('&DLAHLQ..SIZDEXEC') RECEIVE INDSN('&DLAHLQ..XMITPDS(SIZDLOAD)') DA('&DLAHLQ..SIZDLOAD') RECEIVE INDSN('&DLAHLQ..XMITPDS(SIZDMESG)') DA('&DLAHLQ..SIZDMESG') RECEIVE INDSN('&DLAHLQ..XMITPDS(SIZDMAPS)') DA('&DLAHLQ..SIZDMAPS') RECEIVE INDSN('&DLAHLQ..XMITPDS(SIZDSAMP)') DA('&DLAHLQ..SIZDSAMP') DELETE '&DLAHLQ..XMITPDS' CONSOLE NAME(ZOSDLA) SYSCMD(SETPROG APF,ADD,+ DSNAME=&DLAHLQ..SIZDLOAD,SMS) /* //* //* IN CASE THE USER DOESN'T HAVE TSO CONSOLE ACCESS, APF //* AUTHORIZATION IS ATTEMPTED VIA A SDSF CONSOLE COMMAND. //* //SDSFAPF EXEC PGM=ISFAFD //ISFPRT DD SYSOUT=*,HOLD=YES //ISFOUT DD DUMMY //ISFIN DD DATA,DLM=$$ SET DELAY 10 SET CONSOLE ZOSDLA /+ ++<='SETPROG APF,ADD,'>, <='DSNAME=&DLAHLQ..SIZDLOAD,SMS'> ULOG PRINT FILE ISFPRT PRINT PRINT CLOSE $$
56
When you click the Submit button, the following will happen: FTP binary lrecl=80 upload ZOSDLA.V2R1M0.XMITPOC to z/OS Upload the Install JCL Submit the JCL Download joblog Launch the Discovery Library XML Viewer for the downloaded files APF authorize the SIZDLOAD dataset. If the TSO userid does not have console authority the dataset can be dynamically APF authorized using the SET PROG command. Once processing is completed, the IDL view page is shown. Figure 4-13 shows the file browser which should be used to verify that the process completed successfully. Verify the outputs by selecting ftp_joblog.txt and ftp_log.txt files and check for errors, as seen in Figure 4-13
The DLA must be installed or accessible to each z/OS system or sysplex that is the subject of discovery. APF authorization is required for the SIZDLOAD dataset.
57
Click Submit to run the discovery process. The submit creates a batch job and ftps the output back to the Windows workstation. The created XML files are stored in the partitioned dataset that was specified for the z/OS DLA IDML dataset. The Discovery Library XML Viewer will launch and show the XML output files produced as seen in Figure 4-15 on page 59
58
The file names are consistent with the XML toolkit naming conventions. The Discovery Library toolkit will not process any files that do not meet the naming standards. The Discovery Library file naming standard is: appcode@hostname.timestamp.refresh.xml where: appCode - the DLA Application Code hostname - the MSS Hostname specified in the IdML MSSName, which the z/OS DLA populates in the format member@fullyqualified domain name timestamp - the timestamp specified in the IdML create refresh if the IdML has a refresh clause
59
If the files are not created the job probably abended, check the ftp_joblog.txt file using the Discovery Library XML Viewer.
2007.04.20 07:56:16.109 GTM ASIRADObserver ASIRADObserver [Thread-0] XMLTOOLKIT srv181 GTMCL5289I: Begin processing book z/OSDISC210BASE.z/OSBASE@wtsc67.ITSO.IBM.COM.2007-04-19T17.11.55Z.xml. 2007.04.20 07:56:16.109 GTM ASIXSLTTransform transform [Thread-0] XMLTOOLKIT srv181 GTMCL5258I: Starting Transform: XML: C:/IBM/Netcool/discovery/dlbooks/z/OSDISC210BASE.z/OSBASE@wtsc67.ITSO.I BM.COM.2007-04-19T17.11.55Z.xml
60
Schema: C:/IBM/Netcool/XMLtoolkit/xml/ScrProcessBookLevel0.xsl stdout: C:/IBM/Netcool/XMLtoolkit/xml/ScrGeneratedIdsTemp.xml P1Key: transformstepparm P1Value: 0. If the XML file is not processed successfully and the traceGTM_XT.log reflects an error message such as schemaVersion is not valid for ASIRADObserver, as seen in Example 4-3. The z/OS DLA probably did not run properly. Verify the joblogs from the z/OS DLA.
Example 4-3 Error for schema
007.04.19 12:29:08.969 GTM ASIRADObserver ASIRADObserver [Thread-0] XMLTOOLKIT srv181 GTMCL5286I: Skipping book z/OSDISC210BASE.z/OSBASE@wtsc67.ITSO.IBM.COM.2007-04-11T22.38.50Z.xml because the schemaVersion is not valid for ASIRADObserver.2007.04.19 12:29:08.969 GTM ASIRADObserver ASIRADObserver [Thread-0] XMLTOOLKIT srv181 GTMCL5286I: Skipping book z/OSDISC210CICS.CICSBUD1@wtsc67.ITSO.IBM.COM.2007-04-11T22.38.50Z.xml because the schemaVersion is not valid for ASIRADObserver. Once the XML files are processed, the Service Component Repository will be populated. To view the discovery, you must log on to the Tivoli Business Service Manager 4.1 console as Service Administrator, and open the Service Administration view. The DLA will discover the z/OS operating system, started tasks, CICS, DB2 subsystems, IMS, MQ, and WebSphere components and their relationships at the time the DLA was processed. As seen in Figure 4-16 on page 62, the CICS region was discovered with the relationship to an MQ subsystem, the z/OS operating system, and the sysplex.
61
62
Application Dependency Discovery Manager. This information is then mapped to templates defined in Tivoli Business Service Manager, providing a quick means of building business services in Tivoli Business Service Manager integration. Once the import is completed the business applications are imported to Tivoli Business Service Manager 4.1 as imported business services and the Tivoli Application Dependency Discovery Manager components are imported into the Service Component Registry. The integration continues to provide updates from Tivoli Application Dependency Discovery Manager by continually querying the Tivoli Application Dependency Discovery Manager database.
# --------------------------------------------------------------# TBSM 4.1 Discovery Library Reader Properties # --------------------------------------------------------------# DL_Enable_41 =true DL_TADDM_Connect =true DL_TADDM_HostName =9.3.4.162 DL_TADDM_Port =9530 DL_TADDM_GUI_Port = 9430 DL_TADDM_Retry_Limit=86400 Discovery Library toolkit must be installed and configured for the Tivoli Application Dependency Discovery Manager integration - If the Discovery Library toolkit was installed to read Discovery Library books, update the DL_TADDM properties with the appropriate values and restart the Discovery Library toolkit process.
63
Copy the Jar files on the Tivoli Application Dependency Discovery Manager server in /opt/IBM/cmdb/dist/lib to the $NCHOME/XMLToolkit/sdk/lib directory. The Jar files installed with the Tivoli Application Dependency Discovery Manager fix pack 2 are not compatible with the base Tivoli Business Service Manager 4.1 install. If these files are not copied to the Tivoli Business Service Manager server, the Discovery Library toolkit process will fail. The server collation.properties in Tivoli Application Dependency Discovery Manager must have: com.collation.topomgr.generateExplicitRelationship=true If the Tivoli Application Dependency Discovery Manager server collation.properties does not have this set to true, it does not generate the correct relationships that Tivoli Business Service Manager requires. The fix pack 2 provides a script to generate additional relationships. Recycle Tivoli Application Dependency Discovery Manager, and then run the explicitrel.sh script to generate the additional relationships, then any newly discovered resources will have all of the relationships needed. To integrate with Tivoli Application Dependency Discovery Manager the Discovery Library toolkit must be setup to connect to Tivoli Application Dependency Discovery Manager using the setxmlaccess command. The setxmlaccess command creates the userids and password associated with the Discovery Library toolkit to connect to Tivoli Business Service Manager, PostgreSQL database, and Tivoli Application Dependency Discovery Manager. The format of the command is: setXMLAccess.bat -U postgresuid:tbsmuid:taddmuid -P postgrespw:tbsmpw:taddmpw Figure 4-17 shows an example of the execution of setxmlaccess command.
C:\IBM\Netcool\XMLtoolkit\bin>setxmlaccess.bat -U postgres:admin:administrator P tbsmadmin:netcool:collation GTMCI0002I Command processing completed. Figure 4-17 The setxmlaccess command
The SCR tables should have been installed with Tivoli Business Service Manager, but the setupdbschema command can be issued to ensure they were created. If the tables were already installed the command will return the error that the schema already exists, as seen in Figure 4-18 on page 65.
64
You can also check the msgGTM_XT.log under IBM/Netcool /XMLtoolkit/log that contains the GTPCL5227I message as shown in Figure 4-20. Other logs that you might want to consult are taddmsdk.log (taddm api log) and traceGTM_XT.log (Discovery Library toolkit trace log). GTMCL5276I: Requesting a connection to the CMDB at 9.3.4.162. 2007.04.23 06:04:27.516 GTM ASITADDMConnection getConnection [P??] XMLTOOLKIT srv181 GTMCL5277I: Connection established with 9.3.4.162.
Figure 4-20 Connection to CMDB
The following steps show the integration between TBSM and TADDM: 1. Start the initial bulk discovery by using the cmdbdiscovery.bat -b commands seen in Figure 4-21 on page 66. Depending on the size of the Tivoli Application Dependency Discovery Manager database and the processing load of the server, the discovery process might take some time. During the discovery the memory usage on the Tivoli Application Dependency Discovery Manager server could increase. You can check the status of the discovery by using the cmdbdiscovery.bat -s commands seen in Figure 4-21 on page 66.
65
C:\IBM\Netcool\XMLtoolkit\bin>cmdbdiscovery.bat -b C:\IBM\Netcool\XMLtoolkit\bin>cmdbdiscovery.bat -s GTMCL5302I: A bulk discovery is schedule to be run. C:\IBM\Netcool\XMLtoolkit\bin>cmdbdiscovery.bat -s GTMCL5303I: A bulk discovery is running.
Figure 4-21 Running cmdbdiscovery.bat command
2. Verify the discovery has completed by viewing the log to find the message GTMCL52931 that indicates CMDB discovery is completed (in the msgGTM_XT.log), as seen in Figure 4-22. 2007.04.23 07:31:33.531 GTM ASITADDMObserver ASITADDMObserver [Thread-2] XMLTOOLKIT srv181 GTMCL5293I: CMDB discovery completed successfully.
Figure 4-22 CMDB discovery completed
3. Log on to the Tivoli Business Service Manager Console and verify the Service Component Registry is populated and there is a service folder named Imported Business services. In our scenario, here is the Credit Verification Business application that was imported from Tivoli Application Dependency Discovery Manager, as seen in Figure 4-23 on page 67.
66
The same Credit Verification Business Application correspond to the same entity in Tivoli Application Dependency Discovery Manager, as seen in Figure 4-24 on page 68.
67
Figure 4-24 Credit Verification Tivoli Application Dependency Discovery Manager Business Application
With the integration complete, the Tivoli Application Dependency Discovery Manager console can be launched in context by right clicking on the imported business service and Launch Integrations and launch Tivoli Application Dependency Discovery Manager tab, as seen in Figure 4-25 on page 69.
68
Figure 4-25 Integrations and launch Tivoli Application Dependency Discovery Manager tab
69
70
Chapter 5.
71
72
Back up Netcool OMNIbus object server Back up the security server, use the ncsm_db command. The recovery process of Tivoli Business Service Manager should be based on which component is broken. However, the complete rebuild of Tivoli Business Service Manager server after the base software is installed would be performed with the following sequence: 1. Assure license server is started 2. Recovery of the security database 3. Recovery of the object server 4. Recovery of the Web resources and policy of Tivoli Business Service Manager server 5. Recovery of the Tivoli Business Service Manager database The recovery procedure for Tivoli Business Service Manager database only is: 1. Stop Tivoli Business Service Manager server using $NCHOME/bin/rad_shutdown command. 2. Optionally copy the Tivoli Business Service Manager configuration files that you back up. 3. Start the postgreSQL database only using $NCHOME/bin/rad_db start command.
73
4. Restore the database backup. Pipe the backup file name into the $NCHOME/bin/rad_db log command. 5. Start back Tivoli Business Service Manager server using $NCHOME/bin/rad_server command.
74
Primary
TBSM server NGF Webtop PostgreSQL
Backup
TBSM server NGF Webtop PostgreSQL
events
Security Manager
Security Manager
OMNIbus
OMNIbus
The failover configuration allows the primary set of servers to be replaced with a backup set of servers in the case of a failure of the servers. Each component has to be set separately to enable failover. When both systems are running, the primary and backup systems are kept synchronized automatically. Database updates and configuration modifications are communicated to the backup machines. Some points to note are: Some manual modifications such as custom visualization file, static canvases, and static view definitions are not copied automatically When the backup server acts as a primary, the file changes are not reflected on the primary servers. You must manually copy changed files to the primary servers.
75
Database operations can be performed using the command: java -cp $NCHOME\security\lib3p\ncsm3p2004Aug24.jar org.hsqldb.util.DatabaseManager -url jdbc:hsqldb:db/security
76
Example 5-1 Sample configuration file LocalHost NCHOME OMNIHOME PrimaryTBSMHost PrimaryObjServHost PrimarySecMgrHost BackupTBSMHost BackupObjServHost BackupSecMgrHost PrimaryObjServDB PrimaryObjServUser PrimaryObjServPW object server BackupObjServDB BackupObjServUser BackupObjServPW object server PrimarySecMgrPort PrimarySecMgrCtrlPort PrimarySecMgrDBPort manager BackupSecMgrPort BackupSecMgrCtrlPort BackupSecMgrDBPort thishost # host name of this server /opt/IBM/Netcool # install directory of TBSM 4.1 /opt/IBM/Netcool/omnibus # install directory of Omnibus server1 # host name of primary TBSM server server2 # host name of primary object server server3 # host name of primary security manager server4 # host name of backup TBSM server server5 # host name of backup object server server6 # host name of backup security manager NCOMS # database name of primary object server root # database user of primary object server '' # password for database user of primary NCOMS_B root '' 8077 8087 5600 8077 8087 5600 # database name of backup object server # database user of backup object server # password for database user of backup # HTTP port for primary security manager # Control port for primary security manager # Database port for primary security # HTTP port for backup security manager # Control port for backup security manager # Database port for backup security manager
77
78
Related publications
The publications listed in this section are considered particularly suitable for a more detailed discussion of the topics covered in this IBM Redpaper.
Other publications
These publications are also relevant as further information sources: IBM Tivoli Business Service Manager V4.1 Installation Guide, GI11-8054 IBM Tivoli Business Service Manager V4.1 Quick Start, GI11-8055 Exploring IBM Tivoli Business Service Manager 4.1, GI11-8056 IBM Tivoli Business Service Manager V4.1 Administrator's Guide, SC23-6040 IBM Tivoli Business Service Manager V4.1 Service Configuration Guide, SC23-6041 IBM Tivoli Business Service Manager V4.1 Customization Guide, SC23-6042 IBM Tivoli Business Service Manager V4.1 Scenarios Guide, SC23-6043 IBM Tivoli Business Service Manager V4.1 Troubleshooting Guide, GI11-8057 IBM Tivoli Business Service Manager V4.1 Release Notes, GC23-6044
79
Online resources
These Web sites are also relevant as further information sources: Netcool product information center http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp
80
Index
Symbols
$NCHOME/bin/rad_db command 73 $NCHOME/bin/rad_radshell command 32 $NCHOME/bin/rad_server command 74 $NCHOME/bin/rad_shutdown command 73 $NCHOME/InstallTBSM/start_omni.sh command 10 $OMNIHOME/bin/nco_dbinit command 76 rad_shutdown 73 SET PROG 57 setupdbschema 64 setxmlaccess 64 start_omni.sh 10 zosdla_ftp.hta 53 Common Data Model, see CDM Configuration Manager Database, see CMDB
A
ABS 20 Alerts and messages 19 alter command 72 ALU command 53 Automated Business Systems, see ABS
D
Discovery Library Adapter, see DLA Disk space 27 DLA 4, 42
E
EIF 10, 15 Enhanced Service Dependency Adapter, see ESDA ESDA 7 Event enablement 19 Event Integration Facility, see EIF explicitrel.sh command 64
B
business application management 3
C
CDM 43 Child event 19 Class 19 CMDB 43 cmdbdiscovery.bat command 65 commands alter 72 ALU 53 cmdbdiscovery.bat 65 explicitrel.sh 64 failover_cfg 76 ihstttec 15 isql 36 launchpad 28 nco_dbinit 76 nco_sql 36 ncsm_db 14, 35, 73 netstat 65 ps 30 rad_db 73 rad_radshell 32, 38 rad_server 74
F
failover_cfg command 76
G
Geographical Information System, see GIS GIS 8
I
IBM Redbooks Publications Web site 80 ihstttec command 15 Information Technology Infrastructure Library, see ITIL International Technical Support Organization, see ITSO isql command 36 IT infrastructure 3 ITIL 3 ITSO 4
81
L
launchpad command 28 LDAP 14 Light-weight Directory Access Protocol, see LDAP logical partition, see LPAR LPAR 51
Z
zosdla_ftp.hta command 53
M
Memory 27
N
nco_sql command 36 ncs200*.jar 37 ncsm_db command 14, 35, 73 ncsSoapClient200*.jar 37 netstat command 65
O
of Government Commerce, see OGC OGC 2 OPAL 52 Open Process Automation Library, see OPAL Operating system 27
P
Physical resource 19 Processor 27 ps command 30
R
RAD 4, 32 rad_db command 73 rad_radshell command 38 Real-time Active Dashboard, see RAD Resource 19
S
SCR 42 Service Component Registry, see SCR Service Level Agreement, see SLA SET PROG command 57 setupdbschema command 64 setxmlaccess command 64 SIT 51 SLA 3 System Initialization Table, see SIT
82
Back cover
BUILDING TECHNICAL INFORMATION BASED ON PRACTICAL EXPERIENCE IBM Redbooks are developed by the IBM International Technical Support Organization. Experts from IBM, Customers and Partners from around the world create timely technical information based on realistic scenarios. Specific recommendations are provided to help you implement IT solutions more effectively in your environment.