Installation and Setup Guide

Transcription

1 IBM Tioli Monitoring for Business Integration Installation and Setup Guide Version SC

2

3 IBM Tioli Monitoring for Business Integration Installation and Setup Guide Version SC

4 Note Before using this information and the product it supports, read the information Appendix D, Notices, on page 205. First Edition (October 2003) This edition applies to ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ, ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, and ersion of IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2002, All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures Tables ii About this guide ix Who should read this guide ix What this guide contains ix Publications x IBM Tioli Monitoring for Business Integration library x Prerequisite publications xii Related publications xii Accessing publications online xiii Ordering publications xiii Accessibility xiii Contacting software support xi Conentions used in this guide xi Typeface conentions xi Operating system-dependent ariables and paths x Tioli command syntax x Chapter 1. Oeriew Choosing an installation method Tioli monitoring enironment Tioli management region Components of a Tioli monitoring enironment.6 Chapter 2. Guidelines for installation and setup Chapter 3. Pre-installation requirements Supported operating systems Requirements for OS/400 endpoints Required and optional software System requirements Disk space requirements for installing the Tioli enironment Disk space requirements for log files Additional system requirements Permissions and priileges About upgrades Language requirements Key points for system layout Where to install IBM Tioli Monitoring for Business Integration component software...30 Setting up endpoints IBM Tioli Monitoring for Business Integration and interconnected regions Planning for eent handling Configuration requirements for IBM Tioli Monitoring for Business Integration Naming conentions Setting up user IDs About starting and stopping WebSphere MQ listener About installing and using the TioliMonitor node Enabling monitoring of WebSphere MQ and WebSphere MQ Integrator on z/os systems..37 Backing up and restoring Tioli databases Verifying that the required software is running..40 Completing installation planning sheets Obtaining the installation files Using installation files from CDs Using installation files from the Web Downloading installation files from the Web..54 Chapter 4. Performing an Ealuation installation Chapter 5. Performing a Typical installation Installing the product using the Typical option..65 Creating a Windows proxy endpoint Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment Road map for manual installations and upgrades..79 Accessing the Tioli Management Framework enironment Installing new Tioli software Upgrading, installing Tioli patches, and installing fix packs Chapter 7. Completing the installation of the product Verifying the installation of the product Installing the Jaa Runtime Enironment Linking to an existing Jaa Runtime Enironment 97 Loading Managed Object Format (MOF) files into Resource Model Builder Installing files to enable Tioli Enterprise Data Warehouse Installing IBM Tioli Language Support for this product Updating Web Health Console files Integrating the product with Tioli Inentory Installing the DB2 WebSphere MQ database schema Installing the Microsoft SQL WebSphere MQ database schema Installing the Oracle WebSphere MQ database schema Installing the Sybase WebSphere MQ database schema Creating the MQSeries Inentory policy region 115 Copyright IBM Corp. 2002, 2003 iii

6 Chapter 8. Expanding your Tioli enironment Installing managed nodes through an existing Tioli enironment Installing endpoints through an existing Tioli enironment Changing the gateway assignment of an endpoint 127 Installing the Web Health Console manually Chapter 9. Installing and configuring the WebSphere MQ component for z/os Tioli enironment for monitoring WebSphere MQ for z/os Installing Monitoring for WebSphere MQ for z/os 133 Configuring timeouts for Tioli gateways Installing the task serer Configuring the task serer to communicate with z/os systems Configuring the IBM Tioli NetView for z/os enironment Starting communication between the task serer and z/os Using IBM Tioli NetView for z/os message automation Creating the eent adapter configuration file Creating the eent adapter JCL Configuring eent queues for the queue manager 148 Configuring the dead-letter queue handler for z/os About monitoring SMF records with the Statistics Eent Adapter Setting up the Statistics Eent Adapter Starting the Statistics Eent Adapter Controlling statistics eents Chapter 10. Installing and configuring the WebSphere MQ Integrator component for z/os Tioli enironment for monitoring WebSphere MQ Integrator for z/os Installing and setting up Monitoring for WebSphere MQ Integrator for z/os Configuring timeouts for Tioli gateways Configuring the IBM Tioli NetView for z/os enironment Starting communication between the task serer and z/os Chapter 11. Monitoring for MQSeries for z/os and RACF NetView NetView operator ID NetView operator commands MVS operating system Programs MVS operator commands MVS data sets WebSphere MQ Queue manager Queue sharing group Queue Process Name list MQSC operator commands Command resource Channel Data sets Tioli Chapter 12. Setting up OS/400 endpoints for the WebSphere MQ component Installing the endpoint Starting an OS/400 endpoint Stopping an OS/400 endpoint Remoing an endpoint from an OS/400 system 184 Chapter 13. Installing Message Manager console Appendix A. Patches and fix packs 189 Appendix B. Icons and options in the Step List window Appendix C. Uninstalling the product 195 Uninstalling Monitoring for WebSphere MQ Uninstalling Monitoring for WebSphere MQ Integrator from the Tioli serer Uninstalling Monitoring for WebSphere MQ Integrator from a single gateway Creating the Uninstall Monitoring for WebSphere InterChange Serer task Uninstalling IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer from the Tioli serer Uninstalling IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer managed nodes and endpoints Uninstalling Message Manager Appendix D. Notices Trademarks Index i IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

7 Figures 1. Installation options window: Ealuation/Product Demonstration option Component selection window Sample prompt for a software CD Installation options window: Typical option Basic tab for managed nodes Adanced tab for managed nodes Component selection window Basic tab for endpoints Adanced tab for endpoints Sample prompt for a software CD Stop deployment message Detail window for TMA installation step Tioli enironment for monitoring WebSphere MQ for z/os Architecture of Monitoring for WebSphere MQ Integrator for z/os Copyright IBM Corp. 2002, 2003

8 i IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

9 Tables 1. Guidelines for installation and setup Pre-installation requirements and procedures Supported operating systems for the Tioli management region serer and managed nodes Supported operating systems for endpoints Required and optional software for IBM Tioli Monitoring for Business Integration Disk space requirements for installing the Tioli enironment Subdirectories for log files on managed nodes and endpoints Additional system requirements for installation of the IBM Tioli Monitoring for Business Integration software Context for setting up endpoints Eent adapters for Monitoring for WebSphere MQ Integrator Valid and Inalid characters for the names of WebSphere MQ Integrator resources Managed resources and their purpose Planning sheet for creating managed nodes Planning sheet for creating endpoints Planning sheet for creating proxy managed objects CDs for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration Web download links for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration Download directories for a Typical or Ealuation installation Guidelines for a Typical installation Procedures for creating Windows endpoints Startup and configuration options Guidelines for installing the product from the Tioli desktop or command line Installation and upgrade procedures for manual installations of IBM Tioli Monitoring for Business Integration Information required to install the software Information required for installing patches for Tioli Management Framework, Version Information required for installing patches for Tioli Management Framework, Version Information required for installing fix packs Information required for installing upgrade software Guidelines for completing the installation of the product Locations of Tioli Enterprise Data Warehouse configuration files Language support and names of corresponding installation index (.IND) files Guidelines for expanding your Tioli enironment Guidelines for installing the product through an existing Tioli enironment Goals for installation and configuration of Monitoring for WebSphere MQ for z/os Components of a Monitoring for WebSphere MQ for z/os installation Goals for installing and configuring the WebSphere MQ Integrator component for z/os Guidelines for setting up OS/400 endpoints User profiles that Tioli creates on OS/ Parameters for the STRTMEEPT command Message Manager installation file types Specifications of required patches that the installer installs automatically Specifications of required patches for other required and optional software Status icons and options for the Step List window of the installer Guidelines for uninstalling the product Tioli serer uninstall actions Copyright IBM Corp. 2002, 2003 ii

10 iii IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

11 About this guide Who should read this guide This guide describes how to install and set up IBM Tioli Monitoring for Business Integration to monitor and manage serer resources and other objects in a Tioli enironment. This guide is for system administrators who monitor and manage WebSphere MQ, WebSphere MQ Integrator, and WebSphere InterChange Serer resources. Readers should be familiar with the following topics: Tioli management software UNIX operating systems Windows operating systems z/os operating systems databases IBM WebSphere MQ What this guide contains IBM WebSphere MQ Integrator IBM WebSphere MQ Workflow IBM WebSphere InterChange Serer Tioli Enterprise Data Warehouse IBM Tioli Enterprise Console IBM Tioli Business Systems Manager (optional) This guide contains the following sections: Chapter 1, Oeriew, on page 1 Proides an oeriew of the installation and setup of IBM Tioli Monitoring for Business Integration. Chapter 2, Guidelines for installation and setup, on page 17 Proides guidelines for installing and setting up IBM Tioli Monitoring for Business Integration. Chapter 3, Pre-installation requirements, on page 19 Describes how to plan and prepare for installing the product. Chapter 4, Performing an Ealuation installation, on page 59 Describes the Ealuation installation method. Chapter 5, Performing a Typical installation, on page 65 Describes the Typical installation method. Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79 Describes how to install or upgrade the product in an existing Tioli enironment from the Tioli command line or desktop. Chapter 7, Completing the installation of the product, on page 93 Describes how to erify and complete the installation of the product. Copyright IBM Corp. 2002, 2003 ix

12 Chapter 8, Expanding your Tioli enironment, on page 119 Describes how to add managed nodes, endpoints, or installations of the IBM Tioli Monitoring Web Health Console to an existing Tioli enironment. Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 Describes how to install and set up Monitoring for WebSphere MQ for z/os. Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157 Describes how to install and set up Monitoring for WebSphere MQ Integrator for z/os. Chapter 11, Monitoring for MQSeries for z/os and RACF, on page 169 Proides information about using IBM Tioli Monitoring for Business Integration: WebSphere MQ in a Resource Access Control Facility (RACF) enironment. Chapter 12, Setting up OS/400 endpoints for the WebSphere MQ component, on page 177 Describes the OS/400 commands that enable you to set up and manage Monitoring for WebSphere MQ endpoints. Chapter 13, Installing Message Manager console, on page 187 Describes how to install the IBM Tioli Monitoring for Business Integration: WebSphere MQ Message Manager Console. Appendix A, Patches and fix packs, on page 189 Lists required patches and fix packs. Appendix B, Icons and options in the Step List window, on page 193 Describes the icons and options that are displayed in the Step List window of the installer. Appendix C, Uninstalling the product, on page 195 Describes how to uninstall the product. Appendix D, Notices, on page 205 Proides information about copyrights and trademarks. Publications This section lists publications in the IBM Tioli Monitoring for Business Integration library and related documents. It also describes how to access Tioli publications online and how to order Tioli publications. IBM Tioli Monitoring for Business Integration library The following documents are aailable in the IBM Tioli Monitoring for Business Integration library: IBM Tioli Monitoring for Business Integration IBM Tioli Monitoring for Business Integration: Readme First, SC Proides information on where to find all of the IBM Tioli Monitoring for Business Integration documentation, including the titles and locations of all documentation. IBM Tioli Monitoring for Business Integration Installation and Setup Guide, SC Proides information about installing each of the IBM Tioli Monitoring for Business Integration components. x IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

13 IBM Tioli Monitoring for Business Integration User s Guide, SC Proides information about how to use each IBM Tioli Monitoring for Business Integration component to manage resources. IBM Tioli Monitoring for Business Integration Problem Determination Guide, SC Proides information and messages to assist users with troubleshooting problems with the software. IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide, SC Proides information about the tasks and resource models that Monitoring for WebSphere MQ proides. IBM Tioli Monitoring for Business Integration: WebSphere MQ Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere MQ. IBM Tioli Monitoring for Business Integration: MQ Workflow Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with the Workflow function in IBM Tioli Monitoring for Business Integration: WebSphere MQ. Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os, GI Proides information about installing Monitoring for WebSphere MQ for z/os in proxy mode or natie mode. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Reference Guide, SC Proides information about the resource models, tasks, and commands that IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator proides. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Warehouse Enablement Pack Implementation Guide, SC Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator for z/os, GI Proides information about installing IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator for z/os. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Reference Guide, SC Proides information about the tasks and resource models that IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer proides. IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer Warehouse Enablement Pack Implementation Guide, SC About this guide xi

14 Proides information that helps users deploy and use Tioli Enterprise Data Warehouse with IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer. Prerequisite publications To use the information in this guide effectiely, you must hae some prerequisite knowledge, which you can get from the following guides: IBM Tioli Monitoring User s Guide, SC Proides an oeriew of IBM Tioli Monitoring, especially of resource models. It also describes how to use the user interface. IBM Tioli Monitoring Resource Model Builder User s Guide, Version 1.1.0, SC Describes using the IBM Tioli Monitoring Resource Model Builder to create and customize resource models. Related publications The following documents also proide useful information: Tioli Software Installation Serice User s Guide, SG Tioli Management Framework User s Guide, GC Tioli Enterprise Installation Guide, GC Tioli Management Framework Reference Manual, SC Tioli Software Distribution User s Guide, GC Tioli Software Distribution Reference Manual, GC IBM Tioli Configuration Manager User s Guide for Inentory, SC IBM Tioli Enterprise Console Eent Integration Facility User s Guide, GC IBM Tioli Enterprise Console Reference Manual, GC IBM Tioli Enterprise Console Rule Builder s Guide, GC IBM WebSphere MQ product documentation IBM WebSphere MQ Integrator product documentation IBM WebSphere MQ Workflow product documentation IBM WebSphere InterChange Serer product documentation IBM Tioli NetView for z/os product documentation IBM Tioli Business Systems Manager product documentation MQSeries Link for R/3 User s Guide, GC TSO/E REXX Reference, SA Tioli Enterprise Data Warehouse product documentation IBM Tioli Monitoring product documentation Road Map for the Typical Installation Option of IBM Tioli Monitoring Products, GI Road Map for Enabling Tioli Enterprise Data Warehouse for IBM Tioli Monitoring Products The Tioli Software Glossary includes definitions for many of the technical terms related to Tioli software. The Tioli Software Glossary is aailable, in English only, at the following Web site: xii IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

15 Accessibility Accessing publications online The documentation CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. Refer to the readme file on the CD for instructions on how to access the documentation. IBM posts publications for this and all other Tioli products, as they become aailable and wheneer they are updated, to the Tioli software information center Web site. Access the Tioli software information center by first going to the Tioli software library at the following Web address: Scroll down and click the Product manuals link. In the Tioli Technical Product Documents Alphabetical Listing window, click M to access all of the IBM Tioli Monitoring product manuals. Note: If you print PDF documents on other than letter-sized paper, set the option in the File Print window that allows Adobe Reader to print letter-sized pages on your local paper. The IBM Tioli Software Support Web site proides the latest information about known product limitations and workarounds for your product. You can iew this information at the following Web site: Ordering publications You can order many Tioli publications online at the following Web site: publications/cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: In the United States: In Canada: In other countries, see the following Web site for a list of telephone numbers: Accessibility features help users with a physical disability, such as restricted mobility or limited ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate the interface. You can also use the keyboard instead of the mouse to operate most features of the graphical user interface. For additional information, see the Accessibility Appendix in the user s guide for this product. About this guide xiii

16 Contacting software support Before contacting IBM software support with a problem, refer to the IBM software support Web site: To access Tioli support, click the Tioli support link at the bottom right of the support page. If you want to contact software support, see the IBM Software Support Guide at the following Web site: The guide proides information about how to contact IBM Software Support, depending on the seerity of your problem, and the following information: Registration and eligibility Conentions used in this guide Telephone numbers, depending on the country in which you are located Information you must hae before contacting IBM Software Support This guide uses seeral conentions for special terms and actions, and operating system-dependent commands and paths. Typeface conentions This guide uses the following typeface conentions: Bold Italic Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text Words defined in text Emphasis of words (words as words) New terms in text (except in a definition list) Variables and alues you must proide Monospace Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options xi IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

17 Operating system-dependent ariables and paths The publications in this library use the UNIX conention for specifying enironment ariables and for directory notation. When using the Windows command line, replace $ariable with %ariable% for enironment ariables and replace each forward slash (/) with a backslash (\) in directory paths. The names of enironment ariables are not always the same in Windows and UNIX. For example, %TEMP% in Windows is equialent to $tmp in UNIX. Note: If you are using the bash shell on a Windows system, you can use the UNIX conentions. Tioli command syntax The following special characters define Tioli command syntax: [ ] Identifies elements that are optional. Required elements do not hae brackets around them.... Indicates that you can specify multiple alues for the preious element. Separate multiple alues by a space, unless otherwise directed by command information. If the ellipsis for an element follows a closing bracket, use the syntax within the brackets to specify multiple alues. For example, to specify two administrators for the option [ a admin]..., use a admin1 a admin2. If the ellipsis for an element is within the brackets, use the syntax of the last element to specify multiple alues. For example, to specify two hosts for the option [ h host...], use h host1 host2. Indicates mutually exclusie information. You can use the element on either the left or right of the ertical bar. { } Delimits a set of mutually exclusie elements when a command requires one of them. Brackets ([ ]) are around elements that are optional. In addition to the special characters, Tioli command syntax uses the typeface conentions described in Typeface conentions on page xi. The following examples illustrate the typeface conentions used in Tioli command syntax: wcrtpr [ a admin]... [ s region] [ m resource]... name The name argument is the only required element for the wcrtpr command. The brackets around the options indicate they are optional. The ellipsis after the a admin resource option means that you can specify multiple administrators multiple times. The ellipsis after the m resource option means that you can specify multiple resources multiple times. wchkdb [ o outfile] [ u] [ x] { f infile i object...} The f, i, and object elements are mutually exclusie. Braces that surround elements indicate that you are including a required element. If you specify the object argument, you can specify more than one object. About this guide x

18 xi IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

19 Chapter 1. Oeriew This guide describes installation and setup of IBM Tioli Monitoring for Business Integration, monitoring and management software for business-critical hardware and software. This document includes information on the following topics: Determining the proper installation for your enironment Oeriew of a Tioli enironment Choosing an installation method Guidelines and worksheets for planning your installation and setup Using the installation wizard (also referred to in this document as the installer) to ealuate the product Using the installation wizard to install or upgrade the product in a production enironment Using the Tioli desktop or command line to install or upgrade the product Using the Tioli desktop or command line to expand an existing Tioli enironment The IBM Tioli Monitoring products offer seeral options for installing the software, depending on the complexity of your enironment and your knowledge of Tioli management systems. Your choices include the following: Installation wizard The installation wizard (also referred to in this guide as the installer) installs the product and creates a Tioli enironment if none exists. The installer also installs supplemental software, such as the Jaa runtime enironment and language packs. If you use the installer, you must choose between a Typical or Ealuation installation path. Use the following criteria to determine which path you want to take: Use the Typical installation path if you want to install the product on a target computer that matches one of the following profiles: Has no software installed for the Tioli Management Framework OR Has Tioli Management Framework Version or a later ersion installed. You cannot install this product on systems that run preious ersions of the Tioli Management Framework. The Typical installation is suitable for a production enironment. Use the Ealuation installation path if you want to install a limited Tioli enironment and IBM Tioli Monitoring for Business Integration on one computer so that you can test and ealuate the product. Use the Ealuation installation path only if you hae no Tioli software installed on the computer. The Ealuation installation is not intended for use in a production enironment. Tioli desktop or command line interface installation Use one of these options (both referred to in this guide as a manual installation) if either of the following conditions is true: Copyright IBM Corp. 2002,

20 You are an existing Tioli user with a ersion of the Tioli Management Framework earlier than Version OR You hae expert knowledge of the Tioli enironment and plan to extensiely customize your installation. The manual installation method enables you to create interconnected Tioli management regions and to create enironments with more than 50 endpoints. Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79 proides manual installation instructions. For further information, see the documentation for Tioli Management Framework, aailable with IBM Tioli Monitoring for Business Integration. Tioli Software Installation Serice Tioli Software Installation Serice (SIS) can install multiple Tioli products on multiple systems in parallel. This Jaa -based product can install more products on more systems in less time than the install facility of Tioli Management Framework. SIS performs product prerequisite checks and, if defined, user-specified prerequisite checks, ensuring as few installation failures as possible. In most cases, failures occur only when machines are turned off or remoed from the network. Tioli Software Installation Serice also creates an installation repository into which you can import the installation image of one or more Tioli products. You can import only those interpreter types needed in your enironment, which saes disk space and import time. The installation repository is then the source of all your Tioli installations. You can share a single installation repository across multiple Tioli Management Regions. This guide does not coer Tioli Software Installation Serice. For instructions on how to install Tioli Software Installation Serice in your Tioli enironment and how to use it to install products, refer to the Tioli Software Installation Serice User s Guide. Setting up Monitoring for WebSphere MQ and WebSphere MQ Integrator on z/os The Tioli Business Systems Manager task serer enables communication between Tioli distributed enironments and z/os enironments. For more information about working with z/os systems, see Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 and Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157. The task serer is a component of Tioli Business Systems Manager eent enablement. Both terms ( task serer and Tioli Business Systems Manager eent enablement ) are used in this document to refer to the software that enables communication between Tioli distributed enironments and z/os enironments. Setting up Monitoring for WebSphere MQ on OS/400 For more information about working with OS/400 systems, see Chapter 12, Setting up OS/400 endpoints for the WebSphere MQ component, on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

21 Tioli monitoring enironment A basic monitoring solution begins with a set of core monitoring products. You can extend the basic monitoring solution with additional products to take full adantage of the collected performance and aailability data. The following products constitute a full monitoring solution: Core monitoring products Tioli Management Framework IBM Tioli Monitoring Additional products to extend monitoring capabilities and collected data Tioli Enterprise Console IBM Tioli Monitoring Web Health Console Tioli Enterprise Data Warehouse IBM Tioli Monitoring Resource Model Builder Tioli Business Systems Manager The additional products use components that are installed on the Tioli serer and gateways to link with IBM Tioli Monitoring on the endpoint. The IBM Tioli Monitoring and Web Health Console components are automatically enabled on the endpoints at the first profile distribution. Tioli management region A Tioli region contains three tiers of resources: the Tioli serer, managed nodes and gateways, and endpoints. Chapter 1. Oeriew 3

22 In a Tioli enironment, a managed resource is a database object that represents a system or network resource and is goerned by policies. A resource is a hardware, software, or data entity that is managed by Tioli software. Anything that affects the operation of a computer system is a resource, for example, physical and logical disks, CPUs, memory, printers, processes that are running, and serice such as LanMan, Windows eent log, UNIX syslogd (logging system daemon), and TCP/IP. Tioli management region serer Tioli Management Framework software proides the base component for Tioli products. The computer in which this software is installed becomes the Tioli management region serer. The Tioli serer includes the libraries, binaries, data files, and the graphical user interface (GUI) (the Tioli desktop) that are required to install and manage your Tioli enironment. See 1- Tioli Management Framework on page 6 for more information. Managed nodes A managed node runs the same software that runs on a Tioli serer. Managed nodes maintain their own object databases that can be accessed by the Tioli serer. When managed nodes communicate directly with other managed nodes, they perform the same communication or security operations that the Tioli serer performs. The difference between a Tioli serer and a managed node is that the Tioli serer object database is global to the entire region including all managed nodes. In contrast, the managed node database is local to the particular managed node. IBM Tioli Monitoring for Web Infrastructure: WebSphere Application Serer uses two types of endpoints: local endpoints and proxy endpoints. A local endpoint represents an IBM WebSphere serer resources running on a non-z/os platform, such as Windows or AIX. A proxy endpoint is a non-z/os system that communicates with an IBM WebSphere serer resource running on a z/os system. To manage IBM WebSphere Application Serer resources on local endpoints, the Tioli endpoint must be installed on each IBM WebSphere Application Serer node. For z/os systems, the proxy endpoint must be installed on a separate system from z/os. Note: In the Tioli enironment, the term node is used to refer to any managed resource with Tioli Management Framework installed. In the WebSphere enironment, the term node is used to refer to the IBM WebSphere serer resources. In this document, unless specifically indicated, the Tioli enironment definition of node is used. Gateways A gateway controls communication and operations with endpoints. Each gateway can support thousands of endpoints. A gateway can launch methods on an endpoint or run methods on behalf of the endpoint. Endpoints A gateway is generally created on an existing managed node. This managed node proides access to the endpoint methods and proides the communication with the Tioli serer that the endpoints occasionally require. 4 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

23 Endpoints communicate with the Tioli management region through assigned gateways. An endpoint can be created on UNIX or PC operating systems, including Windows NetWare and OS/2. An endpoint runs the IBM Tioli Monitoring engine. See 7- Endpoints on page 13 for more information about endpoints. Chapter 1. Oeriew 5

24 Components of a Tioli monitoring enironment A Tioli monitoring enironment consists of the following components: 1. Tioli Management Framework 2. Tioli Enterprise Console 3. RIM database 4. IBM Tioli Monitoring 5. IBM Tioli Monitoring Web Health Console 6. Profile (resource models) 7. Endpoints 8. Tioli Enterprise Data Warehouse 9. IBM Tioli Monitoring Resource Model Builder 10. Tioli Business Systems Manager The following sections proide descriptions of the components in the Tioli monitoring enironment. 1- Tioli Management Framework (Requires separate installation) Tioli Management Framework is the base component for Tioli products. Using Tioli Management Framework and a combination of Tioli software, you can manage large distributed networks with multiple operating systems, arious network serices, dierse system operations, and constantly changing nodes and users. 6 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

25 The Tioli Management Framework function in your IBM Tioli Monitoring software is installed in your Tioli management region or on your Tioli management region serer. When installed, you hae the following tools for managing your resources: Policy regions The policy region is the entry point into the management functions for your software installations. It is installed on your administrator desktop. Task libraries Each IBM Tioli Monitoring software contains two or more task libraries. The name of each task library indicates the type of tasks that the task library contains. For example, configuration task libraries contain tasks that support the discoery and Tioli configuration functions. Operations task libraries contains tasks that support the daily operations for managing resources. Profile managers A profile manager contains resource model profiles for monitoring your resources. Profiles A profile contains the resource models for monitoring your resources. See also 10 and 6- Profile (resource models) on page 12. Resource models The resource models proide best practices monitoring functions for your resources. Tioli Enterprise Console eent classes and rules The eent classes and rules proide a set of eent definitions for iewing changes on your Tioli Enterprise Console console, and proide a set of rules that aggregate and consolidate eents to minimize Tioli Enterprise Console eent traffic. Icons for resources Icons represent arious resources in your software. The icons graphically show the current state of a resource. Context menus from which you can easily access the functions required to manage a resource are aailable using the following icons: Software icon on your administrator desktop Resource icons, one icon for each resource or object being managed 2- Tioli Enterprise Console (Requires separate installation) Chapter 1. Oeriew 7

26 Tioli Enterprise Console is a rules-based eent management application that collects, processes, and automatically responds to eents. You can install Tioli Enterprise Console on the serer or any managed node or gateway within the Tioli management region. When you install an endpoint, you can enable the sending of eents generated by IBM Tioli Monitoring applications to the Tioli Enterprise Console. You can the enable sending of eents either through a Tioli enironment, which enables you to take adantage of multiple Tioli Enterprise Console serers, or directly to a specific Tioli Enterprise Console serer. Tioli Enterprise Console eent classes and rules proide a set of eent definitions for iewing changes on your Tioli Enterprise Console console, and proide a set of rules that aggregate and consolidate eents to minimize Tioli Enterprise Console eent traffic. 8 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

27 3- RIM database You can configure an endpoint to send eents generated by IBM Tioli Monitoring applications to Tioli Enterprise Console. Eents sent from the endpoints are stored in a RIM database. An RDBMS Interface Module (RIM) database is used to store data from resource monitoring. You can hae multiple RIMs in your enironment. Various applications use the data stored in RIMs to produce reports about your monitored enironment. You create a RIM database with an RDBMS serer installation. The RIM database can be part of the Tioli Management Framework or not. System configurations do not require the RDBMS to reside on the same system as the Tioli management region serer or managed node. The RDBMS client on those systems must connect to the remote RDBMS. Chapter 1. Oeriew 9

28 4- IBM Tioli Monitoring IBM Tioli Monitoring is an application that applies preconfigured best practices to the automated monitoring of essential system resources. The application detects bottlenecks and other potential problems and proides for automatic recoery from critical situations. IBM Tioli Monitoring performs the following tasks: Monitors operating system status Sends notification of system or performance problems and takes automated, correctie actions Collects and stores system data A Common Information Model (CIM) interface proides all data to the IBM Tioli Monitoring engine. In a Windows enironment, Windows Management Instrumentation (WMI an implementation of CIM by Microsoft ) proides the data. In a UNIX enironment, Touchpoint (an implementation of CIM by IBM Tioli) proides the data. IBM Tioli Monitoring is installed on the Tioli management region serer. This application proides three important monitoring elements: Profile The profile is a collected set of information corresponding to a Tioli application resource. For example, the profile contains resource models that define monitoring configurations that monitor specific criteria in your enironment. See also 6- Profile (resource models) on page 12. Heartbeat A heartbeat function regularly monitors endpoints to erify that they are 10 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

29 aailable and running correctly. This function proides notification if the engine on an endpoint fails. The heartbeat function is enabled on the gateway of the monitored endpoints. The heartbeat monitoring function sends eents to Tioli Enterprise Console and Tioli Business Systems Manager (proided that the Tioli Business Systems Manager Adapter component is installed at the gateway) and sends notices to the IBM Tioli Monitoring notice group. Data collector The data collector is a component that uploads data from the endpoints to the RIM database for data collection. This RIM database can be the same database that is used for Tioli Enterprise Console or a separate database. 5- IBM Tioli Monitoring Web Health Console IBM Tioli Monitoring Web Health Console, a part of IBM Tioli Monitoring, is a Web-based graphical interface that runs on any system that can be connected through a TCP/IP interface to the Tioli management region. The IBM Tioli Monitoring Web Health Console enables you to iew the health of resources on an endpoint and iew real-time or historical monitored data. A numeric alue between 100 (perfect health) and zero (corresponding eent conditions met) represents the health of each resource. You can access and use the IBM Tioli Monitoring Web Health Console from any Netscape 6.2 (or later) and Internet Explorer 6.x browser on any machine. You can connect the IBM Tioli Monitoring Web Health Console to any Tioli management region serer or managed node and configure it to monitor any or all of the endpoints that are found in that region (assuming that all of the gateways are interconnected). To connect to the IBM Tioli Monitoring Web Health Console you need access to the serer on which the IBM Tioli Monitoring Web Health Console serer is installed and the IBM Tioli managed region on which you want to Chapter 1. Oeriew 11

30 monitor health. All user management and security is handled through the IBM Tioli management enironment. This includes creating users and passwords as well as assigning authority. 6- Profile (resource models) The profile is a collected set of information corresponding to a Tioli application resource. For example, the profile contains resource models that define monitoring configurations that monitor specific criteria in your enironment. IBM Tioli Monitoring enables you to deploy preconfigured best practices resource models as well as standard and customized resource models to automate the monitoring of essential resources. A resource model accesses specific performance and operational data from the system at runtime. (For example, the Process resource model gathers data about processes running on the system.) The resource models process the data they collect using an algorithm that determines whether or not the system is performing according to expectations. This enables you to detect bottlenecks and other potential problems and define automatic recoery from critical situations affecting your resources. This ability frees system administrators from manually scanning extensie performance and operational data. 12 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

31 7- Endpoints An endpoint proides the primary interface for system management. An endpoint is any computer that runs the lcfd serice (or daemon), which is configured using the lcfd command. Typically, an endpoint is installed on a computer system that is not used for daily management operations. Endpoints run a ery small amount of software and do not maintain an object database. The majority of computers in a Tioli enironment should be endpoints. The Tioli desktop is not installed with the endpoint software. If you choose to run a desktop on an endpoint, you must install Tioli Desktop for Windows or telnet to a UNIX managed node. 8- Tioli Enterprise Data Warehouse (Requires separate installation) Chapter 1. Oeriew 13

32 Tioli Enterprise Data Warehouse proides a data warehouse with which you can iew historical reports and graphs, enabling you to analyze historical patterns and trends of your enironment. The software maintains historical data for resources that the IBM Tioli Monitoring for Business Integration resource models capture. The warehouse enablement pack for each IBM Tioli Monitoring for Business Integration component proides prepackaged reports to analyze this historical data. You can also create reports to meet your specific needs. Tioli Enterprise Data Warehouse is installed on the Tioli management region serer. The Tioli Enterprise Data Warehouse Support Component (required for interaction with IBM Tioli Monitoring) is installed on the Tioli management region serer, and, optionally, on one or more managed nodes. You must install the component on the serer before you install it on the managed nodes. After installing the component on the serer, you can optionally install the component on one or more managed nodes as well. This component collects the monitored data and stores it in a RIM database. 9- IBM Tioli Monitoring Resource Model Builder (Requires separate installation) IBM Tioli Monitoring Resource Model Builder is an application that enables you to deelop, debug, and package resource models for IBM Tioli Monitoring. IBM Tioli Monitoring Resource Model Builder is independent of the Tioli Management Framework enironment. You can install it on a machine that is not within the Tioli Management Framework. IBM Tioli Monitoring Resource Model Builder is a Windows-only tool. Although it does not run on UNIX systems, you can create resource models for UNIX systems. 14 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

33 10- Tioli Business Systems Manager (Requires separate installation) Tioli Business Systems Manager proides a graphical interface to determine the health of an information technology (IT) infrastructure. The software enables you to discoer and create a set of topology iews for your resources. Use Tioli Business Systems Manager to examine how indiidual components or resources affect a business function. You can monitor and manage these resources from an Tioli Business Systems Manager console. Tioli Business Systems Manager can be installed on a stand-alone computer that can be part of the Tioli management enironment or not. You must install an Tioli Business Systems Manager adapter on all gateways in a region to be able to receie IBM Tioli Monitoring eents. Chapter 1. Oeriew 15

34 16 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

35 Chapter 2. Guidelines for installation and setup Table 1. Guidelines for installation and setup What you do Before Installation Table 1 summarizes the procedures for installing and setting up IBM Tioli Monitoring for Business Integration. It also tells where you can find the information and procedures that guide you through the installation. 1. Check the system for compliance with the system requirements and set up or check the prerequisite software. 2. Back up an existing Tioli enironment, if you hae one. If you encounter a problem during an installation, use the backup copy to restore the enironment to a known working state. 3. Consider key points such as interconnecting regions and placing eent serers and endpoints. 4. If you use Monitoring for WebSphere MQ Integrator, reiew configuration details for that product. If you use Monitoring for WebSphere MQ Integrator for z/os, reiew configuration details for that product. 5. Complete the planning sheets for the managed nodes and endpoints that you want to create. (Optional) Refer to Supported operating systems on page 19 Backing up and restoring Tioli databases on page 38 Key points for system layout on page 30 Configuration requirements for IBM Tioli Monitoring for Business Integration on page 34 Enabling monitoring of WebSphere MQ and WebSphere MQ Integrator on z/os systems on page 37 Completing installation planning sheets on page Obtain the installation files. Obtaining the installation files on page If you hae a Solaris Operating Enironment (referred to in the remainder of this document as Solaris), you must install certain fix packs on the target computer to enable the installer. Patches are aailable from the following Sun Web site: 8. Hewlett-Packard Company requires a set of patches for the HP-UX enironment. 9. If you hae AIX Version 4.3.x systems, install IBM AIX maintenance package 9 to enable the installer. Fix packages for Solaris , , , , , , , , , , , , , , , and Fix packages for Solaris , , , , , , , , , , , , , and SUNWi1 fonts package Note: You can obtain the fonts package on the Solaris installation CD. Fix packages for Solaris , , and See the following Web site for the latest required patches for the HP-UX operating system: \ infolibrary/patches.html Obtain the maintenance package at the following IBM Web site: Copyright IBM Corp. 2002,

36 Table 1. Guidelines for installation and setup (continued) What you do 10. Use the ping command to test network names of the target computers for the installation, which ensures the network recognizes the names. The target computer replies to the ping command with its IP address and statistics regarding the transaction if the name is alid, the network connection is actie, and the target computer is running. 11. Confirm that the required software serices are running on the target computers. Installation 12. Install the product. The installation can include the following: managed nodes endpoints the Web Health Console Note: You can create these components after installation. You can also use the Web Health Console s installation executable to install the console on any computer in your Tioli enironment. Refer to Run a ping command to contact each target computer. For example, enter the following command in the MS-DOS command prompt on Windows: ping name where name is the name of the target computer. Verifying that the required software is running on page 40 Chapter 5, Performing a Typical installation, on page 65 OR Chapter 4, Performing an Ealuation installation, on page 59 OR Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79 OR Use Tioli Software Installation Serice (SIS) to install Monitoring for WebSphere MQ. For information about obtaining and using SIS, go to the following Web site: After Installation 13. Back up the Tioli enironment after installation. If you encounter a problem during final configuration, use the backup copy to restore the enironment to a known state. 14. Create managed nodes and endpoints if you did not create them during installation. 15. Verify the functionality of the Tioli management region by running communication commands. 17. Install software to enable resource models, the Web Health Console, historical reporting, and national language ersions of the product. 18. Set up monitoring for z/os systems or for OS/400 systems. Backing up and restoring Tioli databases on page 38 Tioli Enterprise, Version 3.7.1: Installation Guide that comes with the Tioli Management Framework software. Verifying the installation of the product on page 94 Chapter 7, Completing the installation of the product, on page 93 Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157 Chapter 12, Setting up OS/400 endpoints for the WebSphere MQ component, on page Create serer objects for the product to manage. See the IBM Tioli Monitoring for Business Integration User s Guide. 18 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

37 Chapter 3. Pre-installation requirements This chapter proides the following pre-installation requirements and procedures for IBM Tioli Monitoring for Business Integration. Table 2. Pre-installation requirements and procedures Goal Reiew installation requirements so that you can ensure your enironment is prepared for installation. Refer to Supported operating systems Requirements for OS/400 endpoints on page 21 Required and optional software on page 22 System requirements on page 27 Permissions and priileges on page 29 About upgrades on page 30 Language requirements on page 30 Prepare your enironment. Key points for system layout on page 30 Configuration requirements for IBM Tioli Monitoring for Business Integration on page 34 Backing up and restoring Tioli databases on page 38 Verifying that the required software is running on page 40 Completing installation planning sheets on page 43 Obtain the files you need for installation. Obtaining the installation files on page 49 Supported operating systems Optionally, you can also set up monitoring for WebSphere MQ and WebSphere MQ Integrator on z/os. The Tioli Business Systems Manager task serer enables communication between Tioli distributed enironments and z/os enironments. For more information about working with z/os systems, see Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 and Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157. This section lists the supported operating systems that work with the Tioli management region serer, managed nodes, and endpoints in IBM Tioli Monitoring for Business Integration. Copyright IBM Corp. 2002,

38 Table 3. Supported operating systems for the Tioli management region serer and managed nodes Platform Tioli Management Framework Version AIX 4.33, 5.1, and 5.1L Yes Yes AIX 5.2 and 5.2L No Yes Solaris 1 2.7, 2.8, and 2.9 Yes Yes HP-UX 11 Yes No HP-UX 11i Yes Yes Windows NT 4.0, Serice Pack 6a/6 Yes Yes Windows 2000 Professional (SP3 required) Yes No Windows 2000 Serer (SP3 required) Yes Yes Windows 2000 Adanced Serer (SP3 required) Yes Yes Windows 2003 Serer Standard Edition No Yes Windows 2003 Serer Enterprise Edition No Yes Red Hat Linux Adanced Serer 2.1 (ix86) No Yes 2 SuSE Linux Enterprise Serer Version 7 for IA32 (7.2 base) No Yes 2 SuSE Linux Enterprise Serer Version 7 for zseries (31-bit only) No Yes 2 Notes: 1. Sun Solaris Operating Enironment, referred to in this document as Solaris 2. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator is not supported on Linux systems. Table 4. Supported operating systems for endpoints Supported operating systems for endpoints MQ AIX WebSphere product or feature ersion MQ Workflow AIX 5.1 and 5.1L AIX 5.2 and 5.2L Tioli Management Framework 4.1 only Solaris Not supported Solaris Solaris Not supported HP-UX 11 Tioli Management Framework only InterChange Serer Not supported MQ Integrator Not supported Not supported Not supported HP-UX 11i Not supported Not supported Not supported Message Manager Yes Yes Yes Yes Yes Yes Yes Yes 20 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

39 Table 4. Supported operating systems for endpoints (continued) Supported operating systems for endpoints MQ Windows NT 4.0 with Serice Pack 6a/ Windows 2000 Serer, Professional, and Adanced Serer Windows XP Professional Not supported OS/400 Version 5 Release 1 and OS/ Version 5 Release OS/390 Version 2 Release 10 (proxy z/os queue manager support) z/os Version 1 Release 2-4 (proxy z/os queue manager support) Red Hat Linux Adanced Serer 2.1 (ix86) Tioli Management Framework 4.1 only SuSE Linux Enterprise Serer Version 7 for IA32 (7.2 base) Tioli Management Framework 4.1 only SuSE Linux Enterprise Serer Version 7 for zseries (31-bit only) Tioli Management Framework 4.1 only WebSphere product or feature ersion MQ Workflow Not supported Not supported Not supported Not supported Not supported Not supported Not supported InterChange Serer MQ Integrator Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Not supported Message Manager Yes Yes Not supported Yes 4 Yes 4 Yes 4 Yes 4 Yes Yes Notes: 1. See Requirements for OS/400 endpoints for information about specific requirements for OS/400 endpoints. 2. Requires Linux kernel or higher. 3. Requires Linux kernel 2.4 or higher. 4. Remote connection only. Requirements for OS/400 endpoints Consider the following before installing IBM Tioli Monitoring for Business Integration: WebSphere MQ on OS/400 systems: Follow the OS/400 hardware and software requirements described in the IBM Tioli Monitoring User s Guide, Version For optimal system performance, refer to disk space and other requirements listed in Table 8 on page 29. You must also ensure that the following items are installed: the correct ersion of the Jaa Runtime Enironment (JRE) with the latest PTF group leel the QShell Interpreter the most recent OS/400 cumulatie fix pack Chapter 3. Pre-installation requirements 21

40 Required and optional software For OS/400, Version 5, Release 1, obtain the software in IBM Deeloper Kit for Jaa, *BASE and Option 5, 5722-JV1. Also install Jaa group PTF SF99069 Leel 14 or the most recent leel. For OS/400, Version 5, Release 2, obtain the software in IBM Deeloper Kit for Jaa, *BASE and Option 5, 5722-JV1. Also install Jaa group PTF SF99169 Leel 4 or the most recent leel. For OS/400 endpoints, the JRE link configuration step is not required. This section lists the required and optional products for IBM Tioli Monitoring for Business Integration. Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration Product Required base Tioli software Release This section of the table lists the base Tioli software required for all installations. All software listed in this section is installed by the installer. Tioli Management Framework 3.7.1, 4.1 The installer detects an existing installation of Tioli Management Framework, Version 3.7.1, and performs the following actions: If you are performing an Ealuation installation, the installer automatically upgrades Tioli Management Framework to Version 4.1 with the required patches. If you are performing a Typical installation, you hae the following choices: You can remain at Version If necessary, the installer deploys the required patches for Version You can upgrade to Version 4.1 with the required patches. Appendix A, Patches and fix packs, on page 189 lists the patches that the installer deploys. IBM Tioli Monitoring with Fix Pack 5 (5.1.1-ITM-FP05) The installer detects an existing installation of IBM Tioli Monitoring, Version 4.1.x or Version 5.1.0, and upgrades it to the required Version with Fix Pack 5. IBM Tioli Monitoring Component Serices The installer detects an existing ersion of IBM Tioli Monitoring Component Serices and automatically upgrades it to the required Version IBM Tioli Monitoring for Business Integration Component Software 22 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

41 Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration (continued) Product IBM Tioli Monitoring for Business Integration: WebSphere MQ is required to monitor resources for IBM WebSphere MQ and IBM WebSphere MQ Workflow. IBM Tioli Monitoring for Business Integration: WebSphere MQ includes a software component for monitoring IBM WebSphere MQ Workflow. You hae the option of choosing whether or not to install this component. Release The installer detects an existing prior ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ and upgrades it to the current ersion. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator is required to monitor resources for IBM WebSphere MQ Integrator (or its predecessor, MQSeries Integrator) IBM Tioli Monitoring for Business Integration: WebSphere MQ must be installed to enable the functionality of IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator The installer detects an existing prior ersion of IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator and upgrades it to the current ersion. IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer is required to monitor resources for IBM WebSphere InterChange Serer Products monitored by IBM Tioli Monitoring for Business Integration See Table 4 on page 20 for a full list of supported platforms for these products. IBM WebSphere MQ 5.2, 5.3 IBM WebSphere MQ for z/os For Versions 5.2 and 5.3 for z/os systems you must apply PTF UW94954, which is associated with APAR OW IBM WebSphere MQ Workflow 3.3.2, 3.4 IBM WebSphere MQ Integrator MQSeries Integrator (IBM WebSphere MQ Integrator was formerly known as MQSeries Integrator.) 1.2, 2.1, 5.2, 5.3, IBM WebSphere MQ Integrator 2.1 MQSeries Integrator 2.0, 2.0.2, and Chapter 3. Pre-installation requirements 23

42 Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration (continued) Product IBM WebSphere MQ Integrator for z/os For Version 2.1 you must apply the following maintenance packages that are associated with APARs: PQ57196 PQ62118 IBM WebSphere MQ Integrator on z/os must include an installation of IBM DB2 Uniersal Database Enterprise Edition Version 7.1 or higher. Apply the following maintenance packages for DB2: PQ53207 PQ56114 PQ57112 PQ55346 PQ55078 PQ55578 PQ57902 PQ60106 Release IBM WebSphere InterChange Serer Additional required software To enable endpoints for all components: Jaa Runtime Enironment, Version 1.3. See Requirements for OS/400 endpoints on page 21 for more information on OS/400 requirements. To enable monitoring of Windows endpoints: Microsoft Windows Management Instrumentation (WMI). This software comes with Windows You must install it manually on Windows NT endpoints. To enable resource models: Resource models are written in JaaScript. Windows endpoints that use these resource models must hae Windows Script 5.6 installed. To enable data logging on Windows NT and Windows 2000 endpoints: ODBC drier for Microsoft Access The Microsoft Data Access Components 2.1 software on the Microsoft Web site also offers this drier. If the endpoint does not hae Microsoft Access 2000 installed: 1. Run the mdac_typ.exe file that is proided with Microsoft Data Access Components 2.1 (or later), at 2. Install Jet 4.0 Serice Pack 3. WebSphere MQ Integrator for z/os 2.1 WebSphere MQ Integrator Broker for z/os or Solaris endpoints must hae Version 1.3.1_ Search for wmi on the following Web site for more information: Go to the Web address and use the following string to search for this software: Windows Script 5.6. See the information in the left column of this row. 24 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

43 Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration (continued) Product To enable communication with z/os systems: Tioli Business Systems Manager Eent Enablement Tioli Business Systems Manager Eent Enablement proides a task serer that is required by IBM Tioli Monitoring for Business Integration: WebSphere MQ and IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator to communicate with Tioli NetView. The following patch is required for Tioli Business Systems Manager Eent Enablement, Version 1.5, to communicate with Tioli NetView: 1.5-BSM-0038 Release 1.5, Version is included on the IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software CD. Different patches are required if you install Tioli Business Systems Manager Eent Enablement on the IBM Tioli Enterprise Console to support the forwarding of eents to Tioli Business Systems Manager. See the Optional software section of this table for more information. To enable communication with z/os systems: Tioli NetView for OS/390 or Tioli NetView for z/os If you use Tioli NetView for OS/390, Version 1.3, you must apply the fixes for the following APARs: OW54528 OW52785 OW46984 Tioli NetView for OS/390: 1.3 or higher Tioli NetView for z/os: If you use Tioli NetView for OS/390, Version 1.4, you must apply the fix for APAR OW If you use Tioli NetView for OS/390, Version 1.3 or 1.4, you must apply the fix for the OA02015 APAR. If you use Tioli NetView for z/os 5.1.0, you must apply the fix for the OA02073 APAR. Optional software IBM Tioli Monitoring Web Health Console The installer optionally installs IBM Tioli Monitoring Web Health Console. Tioli Enterprise Data Warehouse The following patches and efixes are required: Fix Pack 1.1-TDW-FP02 efix 1.1-TDW-0011LA efix 1.1-TDW-0013LA For DBCS systems, an additional fix pack is required. See the IBM Support and downloads Web site at for additional information. Chapter 3. Pre-installation requirements 25

44 Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration (continued) Product Database support for the Tioli Enterprise Data Warehouse: IBM DB2 Uniersal Database Enterprise Edition Release 7.2 The following fix pack and efix are required for DB2, Version 7.2: IBM DB2 Uniersal Database Enterprise Edition, Version 7.2, Fix Pack 8 efix 1.1-TDW-0002 IBM Tioli Monitoring Warehouse Enablement Pack support This software is required to enable Tioli Enterprise Data Warehouse Install Patch ITM-FP05 in both your IBM Tioli Monitoring application and the Tioli Enterprise Data Warehouse enironment. If you are using the installer, this patch is automatically installed with IBM Tioli Monitoring. IBM Tioli Enterprise Console Version requires Fix Pack TEC-FP04 Version 3.8 requires Fix Pack 3.8-TEC-FP01 Adapter configuration facility IBM Tioli Monitoring for Business Integration uses the adapter configuration facility to send eents through the IBM Tioli Enterprise Console to Tioli Business Systems Manager. The adapter configuration facility must be separately installed on the gateways used by IBM Tioli Monitoring for Business Integration. Tioli Inentory Tioli Inentory is part of the IBM Tioli Configuration Manager, Version 4.2 product. Formerly, Tioli Inentory was a separate product. Database support for the Tioli Inentory: See right column for supported databases and ersions. Tioli Business Systems Manager Version 1.5 requires TBSM Patch 35 Version requires Fix Pack BSM , 3.8, 3.9 The adapter configuration facility is supplied with the supported IBM Tioli Enterprise Console releases. The Adapter Configuration Facility is a prerequisite for auto-discoery. Without this facility, auto-discoery fails with a message that states that wpostemsg.exe cannot be found on the endpoint. Tioli Inentory 4.0 IBM Tioli Configuration Manager 4.2 DB2 7.1, 7.2, 8.1 Oracle 8.1.6, 8.1.7, 9.i Release 2 Microsoft SQL Serer 7.0 (with Serice Pack 3), 2000 Sybase 12.0, 12.5 Use of Sybase requires installation of Fix Pack 4 for the Tioli Management Framework. 1.5, IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

45 Table 5. Required and optional software for IBM Tioli Monitoring for Business Integration (continued) Product Tioli Business Systems Manager Eent Enablement If you use Tioli Business Systems Manager in your Tioli enironment, you can install Tioli Business Systems Manager Eent Enablement on the IBM Tioli Enterprise Console to enable forwarding of eents from the IBM Tioli Enterprise Console to Tioli Business Systems Manager. When used for this purpose, Tioli Business Systems Manager Eent Enablement requires the following patches: Version 1.5 requires Patch 1.5-BSM (See the information at right.) Version requires Fix Pack BSM IBM Tioli Monitoring for Business Integration requires Tioli Business Systems Manager Eent Enablement for a different purpose: to enable communication with z/os systems. (See the Additional required software section of this table.) When used for this purpose, a different patch is required. Release 1.5, Tioli Software Installation Serice 3.7, 4.1 Tioli Software Distribution Tioli Software Distribution is part of the IBM Tioli Configuration Manager, Version 4.2 product. Formerly, Tioli Software Distribution was a separate product. On OS/400 systems, certain tasks do not run and the monitoring engine might not start if you install Tioli Framework patch 3.7-TMF-0043 after you install Tioli Monitoring for Business Integration. Patch 3.7-TMF-0043 modifies the tmemqs_user idmap that Tioli Monitoring for Business Integration creates as follows: the patch changes the idmap for OS/400 from the QMQM to the QTIVROOT authorization role. 1. Run the following command to reset the tmemqs_user idmap to QMQM or to the ID you require: widmap add_entry tmemqs_user os400 QMQM This ID enables management of WebSphere MQ on an OS/400 system. 2. Run the Display Error Log task to remoe all existing logs for the Tioli Monitoring for Business Integration product. 3. Remoe the physical file TIVMGR from the QGPL library on your OS/400 system. Tioli Software Distribution 4.0, 4.1 IBM Tioli Configuration Manager 4.2 System requirements This section describes disk space and other system requirements for installing the product. Disk space requirements for installing the Tioli enironment The following table lists disk space requirements on the Tioli management region serer, managed nodes, and endpoints, required to support installation of IBM Tioli Monitoring for Business Integration, as well as requirements for the optional IBM Tioli Monitoring Web Health Console. Chapter 3. Pre-installation requirements 27

46 Table 6. Disk space requirements for installing the Tioli enironment Element Tioli management region serer Approximately 5 GB (including temporary installation files) Managed node Approximately 1 GB Endpoint Approximately 100 MB Web Health Console (Optional) 1 GB (including temporary installation files) Disk space requirements The product requires a minimum of 1.5 GB of disk space on the Tioli management region serer and on managed nodes. Tioli Management Framework and IBM Tioli Monitoring: 500 MB. The installation depot (temporary directory): 2.6 GB. (The installer proides the option to automatically delete this directory after installation.) Note: On Windows, the depot must reside on the target computer. You cannot perform an installation of the product on Windows using a depot that is located on a remote system. On UNIX, proide a directory path that is accessible from the installation computer to the installation depot. Files that the installer places in the temporary ($TEMP or %TEMP%) directories that are defined for your operating system: 3 MB. Additional Information: Obtain the name of this directory by accessing the Tioli command line enironment (as described in Accessing the Tioli Management Framework enironment on page 81) and entering this command: wtemp. IBM Tioli Monitoring for Business Integration: 200 to 300 MB. Tioli Management Framework and IBM Tioli Monitoring: 500 MB (This includes the space required by the gateway software that enables the managed node to communicate with an endpoint.) IBM Tioli Monitoring for Business Integration: 200 to 300 MB. The endpoint daemon for Tioli Management Framework: 2 MB. The Jaa Runtime Enironment, Version 1.3.0, requires 75 MB of disk space. The Jaa Runtime Enironment is required on all endpoints for this product. You can install the Web Health Console on the Tioli management region serer and any other computers in the same network that match the following minimum requirements: The Web Health Console application requires 250 MB of disk space. The installation depot (temporary directory): 500 MB Files that the installer places in the temporary ($TEMP or %TEMP%) directories that are defined for your operating system: 100 MB. Additional Information: Obtain the name of this directory by accessing the Tioli command line enironment (as described in Accessing the Tioli Management Framework enironment on page 81) and entering this command: wtemp. The Jaa Runtime Enironment, Version 1.3.0, requires 75 MB of disk space. The Jaa Runtime Enironment is required on all endpoints for this product and is required on any computer that runs the Web Health Console. Disk space requirements for log files Allocate a minimum of 5 MB of disk space on eery managed node (including the Tioli management region serer) and endpoint for each subdirectory that will contain log files for tasks and resource models. The subdirectories for each of the IBM Tioli Monitoring for Business Integration software components are listed in the following table: Table 7. Subdirectories for log files on managed nodes and endpoints Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Log file directory on the Tioli serer and managed nodes $DBDIR/CTQ/logs Log file directory on endpoints $LCF_DATDIR/LCFNEW/CTQ/logs 28 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

47 Table 7. Subdirectories for log files on managed nodes and endpoints (continued) Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Log file directory on the Tioli serer and managed nodes $DBDIR/BIW/logs $DBDIR/BIX/logs Log file directory on endpoints $LCF_DATDIR/LCFNEW/BIW/logs $LCF_DATDIR/LCFNEW/BIX/logs Additional system requirements The following table lists additional system requirements to support IBM Tioli Monitoring for Business Integration installations: Table 8. Additional system requirements for installation of the IBM Tioli Monitoring for Business Integration software Item Database DBDIR directory Description Ensure that the Tioli database DBDIR subdirectory has a minimum of 100 MB of aailable disk space on the Tioli serer. Processes On UNIX platforms, set the maximum number of user processes to at least 200. HP-UX enironment ariable OS/400 endpoints Web Health Console On HP-UX, add /usr/lib to the SHLIB_PATH enironment ariable. For improed performance, ensure that an OS/400 iseries serer running a Monitoring for WebSphere MQ endpoint meets the following minimum standards: Has an L2 cache Is a multithreaded system Has 200 MB of memory for the Monitoring for WebSphere MQ software Has a 300 MHz CPU The IBM Tioli Monitoring Web Health Console requires 400 MB of RAM. Permissions and priileges You must hae the following to install the product: The license key for Tioli Management Framework. Obtain this key in the printed document that comes with the installation CDs for the Tioli Management Framework. On UNIX, the user who installs the product must hae root priileges. On Windows, the user must hae membership in the Administrator group. Tioli recommends that you log on as root on UNIX and Administrator on Windows. A alid host name for all managed nodes and endpoints you create. Specify the unique domain name for the host name when multiple computers in the system hae the same host name. For example, the fully qualified name of the tokyo computer might be tokyo.sales.mycompany.com, where sales is the domain name of the Sales Department s domain at the company mycompany. The full name distinguishes the Sales Department s serer from a tokyo serer in the marketing domain called tokyo.marketing.mycompany.com. Chapter 3. Pre-installation requirements 29

48 About upgrades Language requirements Key points for system layout This guide proides the following information about upgrades, depending on the type of installation you are performing: If you are performing an Ealuation installation, the installer detects existing installations of required software, and upgrades it to the required ersions. Howeer, it is best if you perform an Ealuation installation on a computer that has no Tioli software installed. See Chapter 4, Performing an Ealuation installation, on page 59 for a list of software that is installed during an Ealuation installation. If you are performing a Typical installation, the installer gies you some options about whether or not to upgrade existing software to the current ersion. See Chapter 5, Performing a Typical installation, on page 65 for a description of the options. If you are installing the product from the Tioli desktop or command line in an existing Tioli enironment, you can perform any required upgrades as described in Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79. After you complete the installation, you can enable other languages in the product. See Installing IBM Tioli Language Support for this product on page 103 for procedures regarding installing the product in these national languages: Brazilian Portuguese, Chinese (simplified), Chinese (traditional), French, German, Italian, Japanese, Korean, and Spanish. This section reiews key points regarding layout of monitoring systems. If you manage WebSphere MQ and WebSphere MQ Integrator resources with Tioli Business Systems Manager, see the IBM Tioli Monitoring for Business Integration User s Guide for installation requirements. Also, ensure that the Tioli Business Systems Manager serer is configured and the Tioli Business Systems Manager workstations are installed. Note: You install a separate instance of the Tioli Business Systems Manager task serer when you use IBM Tioli Monitoring for Business Integration to monitor z/os system resources. See Installing the task serer on page 135 for more information on this topic. Where to install IBM Tioli Monitoring for Business Integration component software Install IBM Tioli Monitoring for Business Integration: WebSphere MQ on the following computers: The Tioli management region serer (Tioli serer) All managed nodes (preferred) or at a minimum, all managed nodes that host gateways, that are used for Tioli object storage, or that host a Tioli Business Systems Manager task serer for z/os support. (The Tioli Business Systems Manager task serer is proided by Tioli Business Systems Manager Eent Enablement.) 30 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

49 Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on the following computers: The Tioli management region serer (Tioli serer) All managed nodes (preferred) or at a minimum, all managed nodes that host gateways, that are used for Tioli object storage, or that host a Tioli Business Systems Manager task serer for z/os support. (The Tioli Business Systems Manager task serer is proided by Tioli Business Systems Manager Eent Enablement.) The eent serer that processes WebSphere MQ Integrator eents, if present. If you install IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on the eent serer, you must also install the following software on the eent serer: IBM Tioli Monitoring, Version IBM Tioli Monitoring, Version Fix Pack 5 IBM Tioli Monitoring Component Serices, Version IBM Tioli Monitoring for Business Integration: WebSphere MQ Install IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer on the following computers: The Tioli management region serer (Tioli serer) All managed nodes (preferred) or at a minimum, all managed nodes that host gateways, that are used for Tioli object storage, or that host a Tioli Business Systems Manager task serer for z/os support. (The Tioli Business Systems Manager task serer is proided by Tioli Business Systems Manager Eent Enablement.) Setting up endpoints This section summarizes the contexts and targets for distribution of endpoints in IBM Tioli Monitoring for Business Integration. Endpoints in Monitoring for WebSphere MQ To set up your enironment to manage WebSphere MQ resources on distributed platforms, WebSphere MQ queue managers run on computers that are defined as Tioli endpoints. You can also set up remotely administered queue managers. Remote administration enables you to run WebSphere MQ commands on queue managers that do not reside on Tioli endpoints. For more information about remote administration, see the IBM Tioli Monitoring for Business Integration User s Guide. You must deploy endpoints to the following computers or systems: Table 9. Context for setting up endpoints Context Distributed platforms z/os systems Remote endpoint administration Target for setting up endpoints All computers running the queue managers that you want to manage The Tioli managed node on which the required Tioli Business Systems Manager task serer is installed Note: The computer that hosts the endpoint software that communicates with the z/os system must also be defined as a managed node because the Tioli Business Systems Manager task serer must be installed on a managed node. Any computer running a queue manager through which you manage other queue managers Chapter 3. Pre-installation requirements 31

50 When Tioli creates objects to represent the queue managers you want to manage, it creates the objects on the current endpoint gateway by default. You can oerride the default behaior and create queue manager objects on any managed node. You might consider doing this if you are concerned about gateway failure or if you want to locate all objects on one computer. For more information about creating queue manager objects, see IBM Tioli Monitoring for Business Integration User s Guide. Endpoints in Monitoring for WebSphere MQ Integrator You must set up endpoints on the following systems: Computers other than z/os systems that host a WebSphere MQ Integrator component: Broker Configuration Manager User Name Serer For z/os systems, you install the endpoint on a remote computer, as described in Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131. The Windows computer that hosts the Monitoring for WebSphere MQ Integrator PerfDB Serice. See the Tioli Management Framework User s Guide for more information about configuring Tioli endpoints. Endpoints In Monitoring for WebSphere InterChange Serer You must set up Endpoints on the following systems: Computers that host WebSphere InterChange Serer Computers that host WebSphere Business Integration Adapters IBM Tioli Monitoring for Business Integration and interconnected regions The installer for IBM Tioli Monitoring for Business Integration creates a single Tioli management region or adds the product to an existing Tioli management region. You cannot use the installer to create interconnected regions. Before you install IBM Tioli Monitoring for Business Integration, configure the Tioli management region to contain the eent serer, the gateways, and the Tioli endpoints that run the WebSphere MQ resources that you want to manage. How you define regions is important because of the relationship between region boundaries and eent serer boundaries. A region can hae only one eent serer. Refer to the Tioli Management Framework User s Guide for more information about configuring Tioli management regions. In Monitoring for WebSphere MQ Most Monitoring for WebSphere MQ tasks can run from one region on task endpoints in an interconnected region. Task processing between two interconnected regions requires the following: The regions must be interconnected in a two-way connection and share resources. Monitoring for WebSphere MQ must be installed on both regions. 32 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

51 For information about eent handling in interconnected regions, see Planning for eent handling. In Monitoring for WebSphere MQ Integrator You can manage multiple broker domains in a single Tioli region. When managing multiple broker domains in a single Tioli region, you need to ensure the uniqueness of the WebSphere MQ Integrator component identifiers in Tioli. See the configuration information in the IBM Tioli Monitoring for Business Integration User s Guide for more information. If you need to use multiple Tioli regions, because of naming limitations, you might want to partition your Tioli region based on WebSphere MQ Integrator broker domains. Most Monitoring for WebSphere MQ Integrator tasks can run from one region on task endpoints in an interconnected region. Task processing between two interconnected regions requires the following: The regions must be interconnected in a two-way connection and share resources. Monitoring for WebSphere MQ Integrator must be installed on both regions. For information about eent handling in interconnected regions, see Planning for eent handling. Planning for eent handling IBM Tioli Monitoring for Business Integration proides eent adapters to process and forward eents generated by IBM WebSphere MQ and IBM WebSphere MQ Integrator to an eent serer. Additionally, IBM Tioli Monitoring for Business Integration proides resource models that generate eents when conditions on the monitored resource cause an indication to be raised. You can configure eent serers in the following ways: One region and one eent serer: In this configuration, the eent serer is defined in the region to receie all eents. Multiple regions and multiple eent serers: In this configuration, each region contains its own eent serer. Each eent serer receies all eents from its local region. Optionally, you can configure an eent serer to automatically forward eents to another eent serer in another region. Connecting eent serers in this manner enables you to manage many WebSphere MQ management domains from a single eent console, een if the domains reside in different regions. Multiple regions and one eent serer: In this configuration, one eent serer receies eents from all regions. To collect eents from Tioli endpoints, you must install the Tioli Enterprise Console product only in the region hosting the eent serer. Resources must be shared between regions, and you must register the EentSerer class in all regions that do not host the eent serer. Refer to the IBM Tioli Monitoring for Business Integration reference guides for information on running configuration tasks. Eents in Monitoring for WebSphere MQ Monitoring for WebSphere MQ proides an eent adapter to process and forward eents generated by WebSphere MQ and WebSphere MQ Workflow to an eent serer. For each configuration, the eent adapter sends eents to the configured eent serer regardless of the region in which the eent serer is located. Chapter 3. Pre-installation requirements 33

52 Eents in Monitoring for WebSphere MQ Integrator Monitoring for WebSphere MQ Integrator eents can originate from seeral sources: Table 10. Eent adapters for Monitoring for WebSphere MQ Integrator Adapter name Purpose Supported adapter types Tioli Logfile Adapter MQSI Eent Adapter WebSphere MQ Integrator resource models Reports WebSphere MQ Integrator eents from system logs. Reports broker publication eents. Reports monitoring eents. The Tioli logfile adapter supports both Tioli Management Framework and non-tioli Management Framework based adapter types by specifying SererLocation and SererPort keywords. The MQSI Eent Adapter supports only the TME based adapter type that is specified by the SererLocation keyword in its configuration file. Monitor eents support only the Tioli Management Framework based adapter types that were configured using the IBM Tioli Monitoring interface. All eents are deliered to the eent serer using configuration settings in the adapter control files. Configuring adapters Consider the following points when you configure eent adapters: The log file adapters are packaged with the Tioli Enterprise Console Adapter Configuration Facility (ACF). You must use the ACF to install these adapters on gateways that hae endpoints that are managed by IBM Tioli Monitoring for Business Integration. The ACF must be installed on the same managed node as the endpoint gateway so that adapters and adapter-related files can be distributed to the endpoints. Therefore, it is important to install the Adapter Configuration Facility on the Tioli serer and eery managed node that is configured as an endpoint gateway throughout the Tioli region. The Tioli Enterprise Console User s Guide contains step-by-step procedures for installing and using the Adapter Configuration Facility to perform the arious adapter installation and configuration tasks. Configuration requirements for IBM Tioli Monitoring for Business Integration This section proides information about configuring IBM Tioli Monitoring for Business Integration. Naming conentions This section describes the naming conentions for Monitoring for WebSphere MQ Integrator. Naming conentions for Tioli labels A Tioli label is created to represent the WebSphere MQ Integrator components. The format of the label is component@hostname. If the object represents a broker, component is the broker name. If the object represents a configuration manager, component is ConfigMgr. If the object represents a user name serer, component is UserNameSerer. 34 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

53 Name limitations for resources For resource names, Monitoring for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator supports the standard IBM WebSphere MQ naming conentions. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator resources include brokers, execution groups, and message flows. Within a broker domain, these resources can be named using characters identified in the WebSphere MQ Integrator Administration Guide. Howeer, Monitoring for WebSphere MQ Integrator supports only the following characters in the WebSphere MQ Integrator resource names: Table 11. Valid and Inalid characters for the names of WebSphere MQ Integrator resources Characters supported by Monitoring for WebSphere MQ Integrator: All alphabetic characters (a to z), (A to Z) Plus sign (+) All numbers (0 to 9) Number sign (#) Underscore (_) Percent sign (%) Characters not supported by Monitoring for WebSphere MQ Integrator: Semicolon (;) Left and right parentheses (()) Left and right braces ({}) Left and right brackets ([]) Exclamation mark (!) Caret (^) Equals sign (=) Period (.) Tilde (~) Grae ( ) At sign (@) Single quote or apostrophe ( ) Space or a blank character Dollar sign ($) Hyphen ( ) Ampersand (&) Comma (,) Setting up user IDs You must set up the $root_user ID and user IDs for remote computers that run WebSphere MQ Integrator and WebSphere MQ WorkFlow. The $root_user ID is not a literal name, but a symbol to which you map a literal ID in Tioli Management Framework. Note: For information about setting up user IDs for Monitoring for WebSphere MQ see Configuring the task serer to communicate with z/os systems on page 137. Setting up the $root_user ID IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator $root_user IDs must be members of both the mqm and mqbrkrs groups. IBM Tioli Monitoring for Business Integration: WebSphere MQ WorkFlow component $root_user IDs must be members of the mqm group. Setting up user IDs for remote computers IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Many of the Monitoring for WebSphere MQ Integrator tasks run on a remote computer hosting the WebSphere MQ Integrator component. Chapter 3. Pre-installation requirements 35

54 These tasks require a user ID for remote access to the Monitoring for WebSphere MQ Integrator, WebSphere MQ Integrator, and database resources for the WebSphere MQ Integrator component. For each WebSphere MQ Integrator component being managed, the user ID that WebSphere MQ Integrator uses is the serice ID specified when the WebSphere MQ Integrator component was created or changed. This user ID must hae the following characteristics on UNIX operating systems: The user ID s natie shell as specified in the /etc/passwd file must be a shell installed with the operating system. The user ID s.profile file must hae access to the database enironment. When used with brokers that use a User Name Serer running on Windows, the MQSI Eent Adapter requires that a user ID named SYSTEM be defined on the Windows system on which the User Name Serer runs. IBM Tioli Monitoring for Business Integration: WebSphere MQ WorkFlow component The Monitoring for WebSphere WorkFlow tasks require a user ID for remote access to the Monitoring for WebSphere MQ WorkFlow, WebSphere MQ WorkFlow, and database resources for the WebSphere MQ WorkFlow component. For each WebSphere MQ WorkFlow component being managed, the user ID that WebSphere MQ WorkFlow uses is the Configuration Administrator UserID specified when the WebSphere MQ WorkFlow configuration was created. This user ID must hae the following characteristics on UNIX operating systems: The user ID s natie shell as specified in the /etc/passwd file must be a shell installed with the operating system. The user ID s.profile file must hae access to the database enironment. About starting and stopping WebSphere MQ listener To ensure that your WebSphere MQ listener stops when you specify the Stop Queue Manager option on the Control Queue Manager task, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide for information about the Stop Queue Manager option. You also hae the option of configuring your listener to stop and start along with the queue manager. Refer to the WebSphere MQ documentation to learn more about starting and stopping the queue manager s listener. About installing and using the TioliMonitor node This section proides planning information for using the TioliMonitor node that is deliered with Monitoring for WebSphere MQ Integrator. Monitoring for WebSphere MQ Integrator proides performance management functions using a combination of a WebSphere MQ Integrator node, a Windows-based data collection serice, and Tioli monitors. To use the monitors, the Windows serice must be installed and the node must be installed on the Control Center and the broker computers. You must select a Windows serer to host the Monitoring for WebSphere MQ Integrator data collection serice. This serer can be running either Windows NT or Windows The data collection serice is used to collect information from 36 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

55 instances of the WebSphere MQ Integrator node and write this information to the Windows performance database. This serice requires minimal system resources. To collect information from the TioliMonitor node instances, a dedicated User Datagram Protocol (UDP) port must be assigned to the data collection serice. You must define this port number to the serice when installing the serice. Because each instance of the node sends information to the data collection serice oer this UDP port, you must ensure that there is a communication path from each broker computer to this Windows serer for the port selected. In addition to collecting and saing node performance information, this Windows serer must also sere as the target for Tioli monitoring. For this purpose, this computer must be defined as a Tioli endpoint in the Tioli region. Enabling monitoring of WebSphere MQ and WebSphere MQ Integrator on z/os systems The IBM Tioli Monitoring for Business Integration tasks and resource models are enabled and ready to manage WebSphere MQ for z/os and WebSphere MQ Integrator for z/os resources. To use these tasks and resource models to manage WebSphere MQ Integrator for z/os resources, you must meet the following requirements: You hae installed a task serer The task serer is installed as part of the Tioli Business Systems Manager Eent Enablement product, which is proided on the IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software CD in the TBSM_EE211 directory. See Installing the task serer on page 135 for additional information. You hae installed and configured Tioli NetView Tioli NetView must be installed and configured to enable communications with the z/os systems. See the IBM Tioli Monitoring for Business Integration User s Guide for additional information. You hae installed IBM Tioli Monitoring for Business Integration on your distributed Tioli management region You hae installed the required hardware and software that are specified in the following publications: Supported operating systems on page 19 in this guide Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Program Directory for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator for z/os You hae applied the required PTF files (code fixes) that are specified in the following publications: The Program Directory for IBM Tioli Monitoring for WebSphere MQ for z/os lists all PTFs for z/os, MVS, and other Tioli Systems network and systems management products that enable them to work with this IBM Tioli Monitoring for WebSphere MQ for z/os release. The Program Directory for IBM Tioli Monitoring for WebSphere MQ Integrator for z/os lists all PTFs for z/os, MVS, and other Tioli Systems network and systems management products that enable them to work with this IBM Tioli Monitoring for WebSphere MQ Integrator for z/os release. You hae reiewed the Preentie Serice Planning (PSP) documentation Testing with field-test and early-ship customers continues after the IBM Tioli Monitoring for Business Integration for z/os program is manufactured and Chapter 3. Pre-installation requirements 37

56 ready for shipment. If problems are found, Customer Support collects them in the PSP bucket. When you receie your copy of IBM Tioli Monitoring for Business Integration for z/os, call Customer Support to request a copy of the PSP bucket. In the United States, the telephone number for Tioli Customer Support is If you hae an IBMLINK subscription, you can receie a copy of the PSP bucket through that serice. Working with the Resource Access Control Facility (RACF) The Resource Access Control Facility program proides access control in the OS/390 Security Serer and is also aailable as a separate program for the MVS enironment. IBM Tioli Monitoring for Business Integration for z/os has no RACF options. WebSphere MQ and WebSphere MQ Integrator proide Resource Access Control Facility options. For example, you can use the Resource Access Control Facility program to protect a channel or a queue. You can enable IBM Tioli Monitoring for Business Integration for z/os programs to access a protected resource. Refer to the documentation for Resource Access Control Facility and to the documentation for WebSphere MQ and WebSphere MQ Integrator for instructions on enabling access to protected resources. Backing up and restoring Tioli databases Objectie To back up existing Tioli object databases for all computers in the Tioli management region so you can use these backup copies to restore them to a known working state if you encounter a problem during installation. Background information Note: This procedure describes a routine backup method that you can use frequently. In addition to this backup, arrange a complete backup of the Tioli enironment wheneer you make significant changes to the system, such as the installation of this product. If you encounter a problem during a change operation, you can use the system backup to restore the entire Tioli enironment to a known working state. This procedure proides a stable and complete snapshot of the Tioli database and related files and a safer alternatie to manually compressing the database files in a.tar or.zip format. For example, when you sae a database to a.tar or.zip file, an error might occur if the Tioli object dispatcher is simultaneously writing to the Tioli database. This procedure also enables you to estimate the size of the backup files to ensure that you hae sufficient disk space in the target directory to complete the operation. You back up or restore databases using the wbkupdb command. In a large Tioli management region, the wbkupdb process can take a long time because backups of the managed node databases are performed serially. Concurrent backup processes are not allowed in the same Tioli management region. You must complete one wbkupdb command before you execute a second instance of the command. The backup file is saed to the default location, which is the \backups directory in the Tioli database directory. The \backups directory is created if it does not exist. 38 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

57 Tioli Management Framework must be running on the Tioli management region serer and on the managed node whose database is being restored. Otherwise the wbkupdb command cannot restore any database (managed node or Tioli management region serer). See the Tioli Management Framework Reference Manual for a description of all the capabilities of the wbkupdb command. Required authorization role backup or super Note: The default directory to which backup files are written has root write permissions only. If you cannot log in as the root administrator, you must change the location of the backup file to a directory for which you hae write access. Before you begin You must hae a alid user login name and a group name for the computer on which the backup file is stored. On UNIX, set umask to 022 for root. When you finish None Procedure You can perform backups from the command line interface (CLI) or in the Tioli desktop. You can perform restore operations from the command line interface only. Command line: Use the wbkupdb command. wbkupdb [ d deice] [ r] [node_name...] where: d deice Specifies the file or deice to which the backup file is saed or from which the backup file is retrieed. If you specify a file name with this option, you can insert a file date and time anywhere in the file name by adding the ariable %t. The ariable is replaced with a date/time stamp in the form Mondd-hhmm. For example, if you specify d /usr/backups/tmr1%t.bk, the resulting file is named TMR1Dec bk. The time is displayed in 24-hour mode. r Restores the databases for the specified nodes. node_name Specifies the node to be backed up or restored. You can specify multiple nodes. See the description of the wbkupdb command in the Tioli Management Framework Reference Manual for more options. Examples: The following example backs up the Tioli databases for all managed nodes in the Tioli management region from which the wbkupdb command is run. The backups are written to the user-defined file /usr/backups/tmr1.bk. wbkupdb -d /usr/backups/tmr1.bk Chapter 3. Pre-installation requirements 39

58 The following example backs up the database of a single managed node, sherman. In this example, the backup file is saed to the default location. wbkupdb sherman The following example restores a single managed node, sherman. The -r flag restores the backed up database on sherman. The -d flag identifies /usr/backups/tmr1.bk as the backup file to restore. wbkupdb -r -d /usr/backups/tmr1.bk sherman Tioli desktop: 1. Select Backup from the Desktop menu to display the Backup Tioli Management Region window. 2. Select one or more managed nodes from the Aailable managed nodes scrolling list. 3. Click the left-arrow option to moe them to the Backup these managed nodes area. 4. Type the name of the managed node on which the backup image or deice is located in the Sae image on node field. 5. Type the full path name for the backup file in the Deice/File field. 6. Click Estimate Backup Size to see the estimated backup size required for each managed node. Ensure that sufficient disk space exists for the target directory. 7. Click Close to display the Backup Tioli Management Region window. 8. Click Start Backup to display the Backup Status window and begin backup operation. 9. Click Close to close the Backup Tioli Management Region window and display the Tioli desktop window. Verifying that the required software is running Objectie To confirm that software required to enable Tioli transactions is running on the remote target computers that you configure during installation. Note: This procedure applies to local systems. For information about the required software for z/os systems, see Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 and Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157. Background information One of the following basic execution daemons must be running on computers where you intend to install managed nodes or endpoints: For installation on UNIX target computers, test the rexecd daemon. For installation on Windows target computers, test the Tioli Remote Execution Serice (TRIP) process. Required authorization role On UNIX, the user must hae root priileges. On Windows, the user must hae membership in the Administrators group. Before you begin None 40 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

59 When you finish Install the product using one of the following methods: Chapter 5, Performing a Typical installation, on page 65 Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79 Procedure You can perform this procedure from the command line only. Command line in UNIX: 1. Run an rexec command string against the target computer. The rexec command runs commands on remote hosts that are running the rexec serice. For example, run the following command: rexec <target_computer_name> echo test 2. Respond to the prompt for a user ID and password by typing the root ID and password. If the command is unsuccessful, you receie an error, for example, an authentication error, a notice that the serer is down, or a notice that rexec failed to run. Do not continue installing this product until you can enable the rexec daemon accessible on the target computer. Note: The syntax for the rexec command aries, depending on the operating system you are using. You might hae different syntax options than shown in the example aboe. Command line in Windows: 1. Run an rexec command string against the target computer. The rexec command runs commands on remote hosts that are running the rexec serice. For example, run the following command: rexec <target_computer_name> cmd /c echo test Note: The syntax for the rexec command aries, depending on the operating system you are using. You might hae different syntax options than shown in the example aboe. 2. Respond to the prompt for a user ID and password by typing the Administrator ID and password. 3. If the command is unsuccessful, you receie an error, for example, an authentication error, a notice that the serer is down, or a notice that the process failed to run. Do not continue installing this product until you complete these steps: a. Log on to the target computer on which you want to confirm that the Tioli Remote Execution Serice exists. b. Access the Serices user interface in the Windows control panel. c. Find the Tioli Remote Execution Serice in the Serices list and perform one of the following actions: If this serice exists and the status is Stopped, click Start. OR If this serice exists and the status is Started, resole firewall blocks or other network connectiity problems between this computer and the computer on which you are installing IBM Tioli Monitoring. For example, you can increase access priileges to resole some types communication failure. Chapter 3. Pre-installation requirements 41

60 OR If this serice does not exist, run the setup.exe executable in the TRIP directory of the software installation CD for Tioli Management Framework. Follow the instructions in the panels of the installation wizard for this serice. 42 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

61 Completing installation planning sheets A planning.html planning sheet exists in the root directory of the documentation CD for IBM Tioli Monitoring for Business Integration. Use the planning sheet to plan the installation of IBM Tioli Monitoring for Business Integration. You can open this.html file in an HTML editor, a word processor, or a spreadsheet application and type the alues for your installation plan. You can also photocopy the sheets in this document or print the sheets from the PDF ersion of this document and complete them by hand. Table 12 describes the following types of managed resources that each planning sheet coers: Managed nodes and the gateway on each managed node. Endpoints. Table 12. Managed resources and their purpose Proxy managed nodes, which are repositories for sets of managed objects. You can use proxy managed nodes when you manage applications that hae multiple objects, such as database instances in a database application. Managed resource Managed nodes Gateways Purpose Create managed nodes on serers to supplement the Tioli management region serer. A managed node runs the same software that runs on a Tioli serer. It can communicate with other managed nodes and can help the Tioli serer manage endpoints. When a managed node supplements the Tioli serer, you achiee the following benefits: The managed nodes share the processing burden of the Tioli serer. The Tioli serer works more efficiently because it performs fewer management and user administration operations. Tioli network transactions flow to multiple serers instead of to the Tioli serer only. Create gateways on managed nodes to enable the managed node to perform endpoint management operations on behalf of the Tioli management region serer. A gateway transfers large amounts of data to endpoints more efficiently. By default, the maximum amount of memory to use for storing transient data is set to 10 MB. Always enable managed nodes for IBM Tioli Monitoring for Business Integration as gateways so that they can perform endpoint management operations. When you perform a Typical installation for this product, the installer automatically establishes gateways on the managed nodes that you create during installation. Be sure to create gateways on any managed nodes that you create without using the installer. Endpoints Create endpoints on the computers that you want to manage. Endpoints communicate with the Tioli management region through a specific gateway on a managed node. Chapter 3. Pre-installation requirements 43

62 Table 12. Managed resources and their purpose (continued) Managed resource Proxy managed nodes Purpose When to use: When you monitor and manage multiple objects on a single endpoint, you can use a proxy managed node to store unique information about each object. For example, multiple database objects can exist on a single endpoint. The Tioli management region serer must hae information to identify each database object, such as the name of the database and the password for the database. When not to use: You do not need a proxy managed node if the serers in the Tioli enironment do not need to store unique information about multiple objects on a single endpoint. For example, in some cases only one managed object exists on a single endpoint. If you manage serer objects for messaging products like Lotus Domino or Microsoft Exchange, the managed object is the serer itself. The Tioli endpoint that runs on the serer and the serer object together supply complete information for the Tioli serer. No proxy managed node is required because there is only one managed serer object on the endpoint. Remember that een if a database object exists alone on an endpoint, it has unique identifiers and possibly a password that enables co-existence with other objects. The Tioli serer must hae this information. You must store this information on a gateway or consider storing it on a proxy managed node. Benefits: Proxy managed nodes are optional, but can add efficiency to the Tioli enironment. Depending on its power and location in the network, the proxy node can enable the Tioli serer to access information it needs more easily. The node also enables the Tioli serer to restore operations quicker when a gateway serer shuts down temporarily. By default, Tioli stores unique information about managed objects on the gateway. When the managed node that contains this gateway is geographically remote from the Tioli serer, the connection to the gateway can be lost. Tioli enables transfer of operations to an alternate gateway when a serer goes down. Howeer, that alternate gateway does not contain the unique information on managed objects that is required for operations that affect specific managed objects. In this case, execution of these operations must wait until the original gateway returns to serice. Optimizing a proxy managed node: When you want to ensure that the Tioli serer maintains access to unique information on managed objects, create a proxy managed node on a computer that has optimal network connectiity with the Tioli serer. For example, if an endpoint gateway serer is geographically remote from the Tioli serer, local network connectiity might be faster and more stable than remote connectiity. If so, create a proxy managed node at the same geographic site as the Tioli serer. See the Tioli Management Framework documentation for details on creating a proxy managed node. Use the following planning sheets to compile the information you need during installation: Planning sheet for creating managed nodes in Table 13 on page 45 Planning sheet for creating endpoints in Table 14 on page 46 Planning sheet for creating proxy managed nodes in Table 15 on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

63 Table 13. Planning sheet for creating managed nodes Key Concept: One managed node must exist in a Tioli management region. This principal managed node is called the Tioli management region serer. Host name Gateway name * Platform User name Password Destination of installation files Name of the target computer in the network Name of the gateway ** Operating system of the managed node root or Administrator Password of the user on the serer Path on the target computer for installation of the product Example: ision03 Example: ision03_gw Example: Solaris Example: root Example: /data/mynode * This name can include alphanumeric characters, underscores (_), hyphens (-), and periods (.). The names are case-sensitie. For example, the name GWName is different from gwname. ** You must create a gateway on all managed nodes for this product. A gateway enables the managed node to communicate with endpoints. In a Typical installation, the installer automatically creates a gateway on eery managed node that you create. The installer creates a unique name for these gateways by adding the _gw suffix to the host name. Chapter 3. Pre-installation requirements 45

64 Table 14. Planning sheet for creating endpoints An endpoint is a computer on which Tioli software is installed to enable communication with the Tioli management region serer. Host name Endpoint name * Platform User name Password Destination of installation files Name of the target computer in the network Name you assign to the endpoint Operating system of the endpoint root or Administrator Password of the user on the serer Path on the target computer for installation of the product Example: ision03 Example: ision03_ep Example: Solaris Example: root Example: /data/mynode * This name can include alphanumeric characters, underscores (_), hyphens (-), and periods (.). The names are case-sensitie. For example, the name EPName is different from epname. The endpoint name must be different than the managed node name. 46 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

65 Chapter 3. Pre-installation requirements 47

66 Table 15. Planning sheet for creating proxy managed objects Host name Managed node name Endpoint name Managed object name * Object type Name of the target computer in the network Name of the managed node you use as proxy The endpoint where one or more database instance exists Name of the managed object on the managed node Type of object associated with the proxy serer Example: my_host Example: my_host_mn Example: my_database@my_endpoint Example: Oracle 11i * This name can include alphanumeric characters, underscores (_), hyphens (-), and periods (.). The names are case-sensitie. For example, the name MNName is different from mnname. 48 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

67 Obtaining the installation files You can use CDs or files downloaded from the Web to perform an installation. This section lists the CDs and Web downloads that you need for installing IBM Tioli Monitoring for Business Integration using the installer. It also describes the directory structure you need to set up when downloading files from the Web. If you are planning to perform manual installations or upgrades (installation from the Tioli desktop or command line), see Chapter 6, Installing or upgrading the product manually in an existing Tioli enironment, on page 79 for instructions on what CDs or Web downloads you need. Using installation files from CDs When you perform an installation, the installer prompts for the CDs that it needs as you go through the installation procedure. Table 16 lists the required and optional CDs for an installation. The CDs that you need depend partly on whether you are doing a Typical or Ealuation installation, which options you select during the installation, and which IBM Tioli Monitoring for Business Integration components you are installing. Read the explanations in the table to determine which CDs you need. Table 16. CDs for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration IBM Tioli Monitoring for Business Integration installation CDs IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 1 IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 3 Tioli software CDs for an Ealuation installation Tioli Management Framework 1 of 2, Version 4.1 Tioli Management Framework 2 of 2, Version 4.1 Tioli Management Framework Language Support, Version 4.1 Tioli Management Framework Upgrade Version 3.7 to Version 4.1 IBM Tioli Monitoring, Version The Installation Disk 1 and Installation Disk 2 CDs are required for all installations. Installation Disk 3 is required for Typical installations only if you hae Tioli Management Framework Version installed and want to remain at this ersion. The installer uses this CD to apply required patches to Version This installation CD is not required for Ealuation installations. The Tioli Management Framework CDs are required if you hae no ersion of Tioli Management Framework installed. They are not required if you hae Tioli Management Framework Version installed. The language support CD is required if you want to install Tioli Management Framework Version 4.1 in a supported language other than English. This CD is required if you hae Tioli Management Framework Version installed. When you are performing an Ealuation installation, the installer requires you to upgrade Tioli Management Framework Version to Version 4.1. The IBM Tioli Monitoring CD is required for all installations. IBM Tioli Monitoring Language Support, Version IBM Tioli Monitoring Web Health Console for AIX, HP, SUN, Version 5.1 IBM Tioli Monitoring Web Health Console for Windows, Linux, Version 5.1 The language support CD is required if you want to install IBM Tioli Monitoring in a supported language other than English. Use these CDs to install the IBM Tioli Monitoring Web Health Console on the operating systems specified in the CD title. When you are performing an Ealuation installation, the installer requires you to install the Web Health Console. Chapter 3. Pre-installation requirements 49

68 Table 16. CDs for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration (continued) Tioli software CDs for a Typical installation Tioli Management Framework 1 of 2, Version 4.1 Tioli Management Framework 2 of 2, Version 4.1 Tioli Management Framework Language Support, Version 4.1 Tioli Management Framework Upgrade Version 3.7 to Version 4.1 IBM Tioli Monitoring, Version IBM Tioli Monitoring Language Support, Version IBM Tioli Monitoring Web Health Console for AIX, HP, SUN, Version 5.1 IBM Tioli Monitoring Web Health Console for Windows, Linux, Version 5.1 Component Software CDs for Typical or Ealuation installations The Tioli Management Framework CDs are required if you hae no ersion of Tioli Management Framework installed. They are not required if you hae Tioli Management Framework Version installed. The language support CD is required if you want to install Tioli Management Framework Version 4.1 in a supported language other than English. This CD is required if you hae Tioli Management Framework Version installed and you want to upgrade to Version 4.1. When you are performing a Typical installation, you can choose to remain at the current ersion. The IBM Tioli Monitoring CD is required for all installations. The language support CD is required if you want to install IBM Tioli Monitoring installed in a supported language other than English. Use these CDs to install the IBM Tioli Monitoring Web Health Console on the operating systems specified in the CD title. Installation of the IBM Tioli Monitoring Web Health Console is optional. Use the following CDs as needed, depending on which products you are monitoring. The language support CDs are required for installing in supported languages other than English. WebSphere MQ (including WebSphere MQ Workflow) IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Language Support WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Language Support WebSphere InterChange Serer IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Language Support Using installation files from the Web The installation files for IBM Tioli Monitoring for Business Integration are aailable from the Passport Adantage Web site. Passport Adantage is an IBM licensing program for distributed software. You can download installation files from Passport Adantage if you enroll in the program. Upon enrolling, you are assigned a user name and password with which to access the software files to which you are entitled. You can access Passport Adantage at the following Web site: 50 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

69 Table 17 lists the required and optional downloads for installations using the installer. The downloads that are required for an installation depend partly on whether you are doing a Typical or Ealuation installation, which options you select during the installation, and which IBM Tioli Monitoring for Business Integration components you are installing. Read the explanations in the table to determine which downloads you need. Before you perform an installation from downloaded files using the installer, you must set up a directory structure to contain the files, as described in Downloading installation files from the Web on page 54. Table 17. Web download links for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration IBM Tioli Monitoring for Business Integration installation software downloads Tioli Monitoring for Business Integration, V5.1.1: Install AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Monitoring for Business Integration, V5.1.1: Install 3 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli software downloads for an Ealuation installation Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Language Support 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Upgrade 3.7 to 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English IBM Tioli Monitoring Lang Support V5.1.1 for WinXP, WinNT, Win 2000, AIX, Solaris, Linux, HP-UX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin The Install and Install 2 downloads are required for all installations. The Install 3 download is required for Typical installations only if you hae Tioli Management Framework Version installed and want to remain at this ersion. The installer uses this downloaded file to apply required patches to Version This download is not required for Ealuation installations. The Tioli Management Framework downloads are required if you hae no ersion of Tioli Management Framework installed. They are not required if you hae Tioli Management Framework Version installed. The language support download is required if you want to install Tioli Management Framework Version 4.1 in a supported language other than English. This download is required if you hae Tioli Management Framework Version installed. When you are performing an Ealuation installation, the installer requires you to upgrade Tioli Management Framework Version to Version 4.1. The IBM Tioli Monitoring download is required for all installations. The language support download is required if you want to install IBM Tioli Monitoring in a supported language other than English. Chapter 3. Pre-installation requirements 51

70 Table 17. Web download links for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration (continued) IBM Tioli Monitoring Web Health Console V5.1.1 for HP-UX, Solaris, AIX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English IBM Tioli Monitoring Web Health Console V5.1.1 for Windows, Linux Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English Use these downloads to install the IBM Tioli Monitoring Web Health Console on the operating systems specified in the download title. When you perform an Ealuation installation, the installer requires you to install the Web Health Console. 52 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

71 Table 17. Web download links for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration (continued) Tioli software downloads for a Typical installation Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Language Support 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Upgrade 3.7 to 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English IBM Tioli Monitoring Lang Support V5.1.1 for WinXP, WinNT, Win 2000, AIX, Solaris, Linux, HP-UX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin IBM Tioli Monitoring Web Health Console V5.1.1 for HP-UX, Solaris, AIX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English IBM Tioli Monitoring Web Health Console V5.1.1 for Windows, Linux Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English The Tioli Management Framework downloads are required if you hae no ersion of Tioli Management Framework installed. They are not required if you hae Tioli Management Framework Version installed. The language support download is required if you want to install Tioli Management Framework Version 4.1 in a supported language other than English. This download is required if you hae Tioli Management Framework Version installed and you want to upgrade to Version 4.1. When you are performing a Typical installation, you can choose to remain at the current ersion. The IBM Tioli Monitoring download is required for all installations. The language support download is required if you want to install IBM Tioli Monitoring a supported language other than English. Use these downloads to install the IBM Tioli Monitoring Web Health Console on the operating systems specified in the download title. Installation of the IBM Tioli Monitoring Web Health Console is optional. Chapter 3. Pre-installation requirements 53

72 Table 17. Web download links for Ealuation or Typical installations of IBM Tioli Monitoring for Business Integration (continued) Component Software downloads for Typical or Ealuation installations Use the following downloads as needed, depending on which products you are monitoring. The language support downloads are required for installing in supported languages other than English. WebSphere MQ (including WebSphere MQ Workflow) Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere MQ Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin WebSphere MQ Integrator Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere MQ Integrator Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin WebSphere InterChange Serer Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere InterChange Serer Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Downloading installation files from the Web Objectie To obtain the installation files for IBM Tioli Monitoring for Business Integration from the Web and to set up the required directory structure to contain the files so that you can perform an installation using the installer. Background information This procedure describes how to download the installation software from the Web. The procedure also describes how to place the files in a depot structure so that the installation program can find them. You can reference a single depot located in the network to perform installations on multiple computers. Table 18 lists the Web download links for the installation files and the directories to contain the files. You need to create directories only for the downloaded files that you need. Use Table 17 on page 51 to determine which downloads are necessary for your installation. Note: You do not need to create a depot directory structure if you hae obtained installation CDs because the installation program prompts you to insert the CDs it requires during installation. See Using installation files from CDs on page 49 for more information. Table 18. Download directories for a Typical or Ealuation installation Download link Tioli Monitoring for Business Integration, V5.1.1: Install AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Download directory Any directory other than <depot> 54 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

73 Table 18. Download directories for a Typical or Ealuation installation (continued) Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Monitoring for Business Integration, V5.1.1: Install 3 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework of 2, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Language Support 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish Tioli Management Framework Upgrade 3.7 to 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English IBM Tioli Monitoring Lang Support V5.1.1 for WinXP, WinNT, Win 2000, AIX, Solaris, Linux, HP-UX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin IBM Tioli Monitoring Web Health Console V5.1.1 for HP-UX, Solaris, AIX Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English IBM Tioli Monitoring Web Health Console V5.1.1 for Windows, Linux Braz Port, French, Italian, German, Spanish, Japanese, Korean, Simp Chin, Trad Chin, Int English Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere MQ Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere MQ Integrator Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Tioli Monitoring for Business Integration: WebSphere InterChange Serer Language Support AIX HP-UX Linux Solaris Win2000 WinNT WinXP Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin <depot>/ <depot>/tmf41disk1 <depot>/tmf41disk2 <depot>/tmf41lang <depot>/tmf41upg37 <depot>/itm <depot>/itmlang <depot>/whc <depot>/whc <depot>/mq <depot>/mqlang <depot>/mqi <depot>/mqilang <depot>/wics <depot>/wicslang Required authorization role None. Before you begin Determine which Web download links you need to access by reading the explanations in Table 17 on page 51. Chapter 3. Pre-installation requirements 55

74 When you finish You are ready to install the product using the installer. Follow the instructions for a Typical or Ealuation installation. See Chapter 5, Performing a Typical installation, on page 65 or Chapter 4, Performing an Ealuation installation, on page 59. Procedure All downloadable files for IBM Tioli Monitoring for Business Integration are self-extracting archies. You can log into Passport Adantage with your assigned user name and password and download any required and optional parts. 1. Create a depot directory (<depot> on the hard drie of the computer to which you want to download the installation files. 2. Create another directory, separate from the depot directory, on the same computer. Additional Information: This separate directory is required for the main installation download, indicated in the first row of Table 17 on page 51. All other downloaded files are stored in the depot directory. 3. Create the required subdirectories within the installation depot. Additional Information: You can create all of the directories listed in Table 18 on page 54 or you can create just the subdirectories that correspond to the downloads required for your installation. (Read the explanations in Table 17 on page 51 to determine which downloads are required.) For example, if you do not plan to install the IBM Tioli Monitoring Web Health Console, you do not need to create a WHC directory. 4. Download from the Passport Adantage Web site the compressed files that contain the product software to the appropriate directories, as indicated in Table 18 on page 54. Additional Information: For example, click the links for the Install and Install 2 downloads (first two rows of Table 18 on page 54) to access the compressed files. Download the Install compressed file to the directory that you created in Step 2. Download the Install 2 compressed file into the root leel of the depot directory (<depot>/) 5. Uncompress the software packages that you downloaded within their respectie directories. 6. Perform the following additional steps if you downloaded installation files for the IBM Tioli Monitoring Web Health Console: Note: The following steps show sample commands for UNIX. $depot represents the depot directory. Use Windows Explorer to accomplish the same results on Windows systems. a. Create a new subdirectory named HCONSOLE at the root leel of the $depotdirectory ($depot/hconsole). cd $depot mkdir HCONSOLE b. Display all HCONSOLE subdirectories that exist within the <depot> directory. ls */HCONSOLE Additional Information: When you uncompress the software packages in Step 5, seeral directories, including an HCONSOLE directory, are created within each of the depot s subdirectories for IBM Tioli Monitoring for Business Integration components. For example, if you downloaded files for IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer 56 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

75 5.1.1, an HCONSOLE directory is created within the $depot/wics subdirectory when you uncompress the files. The HCONSOLE directories contain class files for installation into the IBM Tioli Monitoring Web Health Console. c. Moe the contents of each of the component subdirectories to the top-leel HCONSOLE directory that you created in Step 6a on page 56. For example: m WICS/HCONSOLE/* HCONSOLE As an alternatie to performing the preceding steps for Web Health Console files, you can run one of the following programs: On UNIX, create and run the following shell script: #!/bin/sh # Change to depot dir depot=/my/depotdir cd $depot ( echo "directory $depot does not exist" ; exit 1 ) # make the HCONSOLE dir mkdir HCONSOLE # Moe all product HCONSOLE dirs for i in */HCONSOLE ; do m $i/* HCONSOLE/. done On Windows, create and run the following.bat off set depot=\my\depotdir REM Change to depot dir cd %depot% ( echo directory %depot% does not exist EXIT /B 1 ) REM make the HCONSOLE dir if NOT EXIST HCONSOLE mkdir HCONSOLE REM Moe all product HCONSOLE dirs for /D %%i in ( * ) do ( if EXIST %depot%\%%i\hconsole ( for %%j in ( %depot%\%%i\hconsole\* ) do moe %%j %depot%\hconsole for /D %%j in ( %depot%\%%i\hconsole\* ) do moe %%j %depot%\hconsole ) ) Chapter 3. Pre-installation requirements 57

76 58 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

77 Chapter 4. Performing an Ealuation installation This chapter describes how to install an Ealuation ersion of the product using the Ealuation option in the installer. When you select the Ealuation option, the installer installs IBM Tioli Monitoring for Business Integration and a limited Tioli enironment on one computer so that you can test and ealuate the product. The Ealuation installation is not intended for use in a production enironment. Objectie To install a limited Tioli enironment and IBM Tioli Monitoring for Business Integration component software on one computer so that you can test and ealuate the product. Background information The Ealuation installation works best if the target computer does not hae any Tioli software installed. During an Ealuation installation, the installer creates one local endpoint on the computer. No software is installed on any remote computers. When you perform an Ealuation installation, the following Tioli software is installed: Tioli Management Framework, Version 4.1 IBM Tioli Monitoring, Version IBM Tioli Monitoring Component Serices, Version IBM Tioli Monitoring Web Health Console, Version During the installation procedure, you can choose to install one or more of the following IBM Tioli Monitoring for Business Integration monitoring components: WebSphere MQ WebSphere MQ Workflow WebSphere MQ Integrator WebSphere InterChange Serer Required authorization On UNIX, the user who installs the product must hae root priileges. On Windows, the user must hae membership in the Administrators group. Before you begin If you want to install from CDs, collect the following CDs from the list in Table 16 on page 49. The IBM Tioli Monitoring for Business Integration installation CDs The Tioli software CDs for an Ealuation installation, as needed. Read the explanations in the table to determine which CDs you need The component software CDs for the IBM Tioli Monitoring for Business Integration monitoring components that you want to install The language support CDs for the monitoring components that you want to install in languages other than English Copyright IBM Corp. 2002,

78 If you want to install from files downloaded from the Web, you must create an installation depot to contain the downloaded files. Refer to the following sections to determine which files you need to download from the Web and how to set up an installation depot: Using installation files from the Web on page 50 Downloading installation files from the Web on page 54 If you are installing the product on a Solaris, HP-UX, or AIX operating system, ensure that the required fix packs, patches, or maintenance packages are installed. See Table 1 on page 17 for information. Close all running applications. When you finish Complete the actiities described in Chapter 7, Completing the installation of the product, on page 93. Procedure 1. Log on to the computer where you want to install an ealuation ersion of the product. 2. Run one of the following setup executables to start the installation: For Windows, run setupbiz.bat. For UNIX, run setupbiz.sh. Additional Information: The setup executable is located in the root directory of the CD labeled IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 1. If you are installing from files downloaded from the Web, the setup executable is located in the directory where you downloaded and uncompressed installation files from the following Web download link: Tioli Monitoring for Business Integration, V5.1.1: Install AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin. 3. Click Next to display the license agreement. 4. Select I accept the terms in the license agreement. 5. Click Next. Third Party License Terms and Conditions, Notices and Information is displayed. 6. Click Next. 7. Specify the directory path where you want to install the product. 8. Click Next. 9. Specify the directory path where you want to create a depot (temporary directory) for product installation. Additional Information: The depot directory contains all the files required for installation. If you click Cancel in an installer panel always delete the temporary depot directory. You can begin installation again by running the setup executable on the installation CD. After the installation is complete, the installer proides an option to automatically delete this directory. Note: On Windows, the depot must reside on the target computer. You cannot perform an installation of the product on Windows using a depot that is located on a remote system. On UNIX, proide a directory path that is accessible from the installation computer to the installation depot. 10. Click Next to copy the files to the installation directories. 60 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

79 11. Click Next when the installer prompts you to restart the application and continue the installation. The installation options window is displayed. Figure 1. Installation options window: Ealuation/Product Demonstration option 12. Select Ealuation/Product Demonstration. 13. Click Next to display the user password window. 14. Type the password corresponding to the displayed User ID in the Password and Verify Password fields. 15. Click Next to display the language option window. 16. Select the check box next to any language you want to install. 17. Click Next to display the component selection window. Chapter 4. Performing an Ealuation installation 61

80 Figure 2. Component selection window 18. Select the monitoring components that you want to install. 19. Click Next to display the first of a series of windows, each of which prompts you for the directory location of a specified CD or CD image that contains the software to be installed. Additional Information: If you are installing from files that were downloaded from the Web, the CD images must be located in specific directories within the depot directory, as described in Downloading installation files from the Web on page 54. Figure 3. Sample prompt for a software CD 62 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

81 20. For each CD prompt window that is displayed, perform the following steps: a. Insert the specified CD into the drie if you are not installing from CD image files that were downloaded from the Web. b. Type a directory path or click Browse to specify the path to the CD or CD image. c. Click Next. d. If you are installing from CD image files that were downloaded from the Web, click No in response to the message that asks if you want to copy the files to the depot directory. Additional Information: If you are installing from CDs, each CD image is copied to the depot directory. 21. Click Next on the final CD prompt window to display the Step List window. Additional Information: When the Step List window is displayed, the installer begins installation of the software from the depot to the install location. The Step List shows the software components that the installer installs, and it displays status updates for the installation process. The first two steps might require a system restart. If you are prompted to restart the system, click Finish to restart the computer. See Appendix B, Icons and options in the Step List window, on page 193 for a description of status icons and options in the Step List window. 22. (Optional) If you want to cancel the installation while the Step List is running, perform the following steps: a. Click Stop and allow the currently running process to finish. Additional Information: If you click Cancel without allowing the currently running process to finish, the system might remain in an unpredictable state. b. Click Cancel to stop the installation and close the installer. c. Delete the temporary depot directory created by the installer. 23. (Optional) Double-click any item in the list to see details and to set processing instructions for that step in the Details window. 24. Click OK in the final prompt of the Step List. Additional Information: This final prompt is displayed when all steps in the Step List show a Passed status. If all steps do not show a Passed status, see the IBM Tioli Monitoring for Business Integration: Problem Determination Guide for troubleshooting information. 25. Click Next. 26. Select Delete the temporary files to delete the directory of temporary installation files that you specified at the beginning of the installation process. 27. Click Next. 28. Click Finish. Chapter 4. Performing an Ealuation installation 63

82 64 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

83 Chapter 5. Performing a Typical installation This chapter describes how to install the product using the Typical installation option in the installer. This installation option creates a Tioli serer and installs IBM Tioli Monitoring for Business Integration Version During a Typical installation, you can specify: Additional computers to configure as managed nodes that run the IBM Tioli Monitoring Version software. The managed nodes can share the workload with the Tioli serer. Computers that you want to monitor (endpoints) Computers on which you want to install the Web Health Console Table 19 proides an oeriew of the topics coered in this chapter. Table 19. Guidelines for a Typical installation Goal Install the product using the Typical option in the installer. If necessary, create a Windows proxy endpoint to enable the creation of Windows endpoints when installing from a UNIX-based Tioli management region serer. Refer to Installing the product using the Typical option Creating a Windows proxy endpoint on page 75 Installing the product using the Typical option Objectie To use the installation wizard with predefined default alues to automatically create a Tioli enironment and install IBM Tioli Monitoring for Business Integration. The wizard optionally creates managed resources in the Tioli enironment, as described in this procedure. Note: If you want to manage z/os systems running the WebSphere MQ component, see Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131. If you want to manage z/os systems running the WebSphere MQ Integrator component, see Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157. Background information The target computer, which becomes the Tioli management region serer, must match one of the following profiles: Has no software installed for the Tioli Management Framework OR Has Tioli Management Framework Version or a later ersion installed. You cannot install this product on systems that run preious ersions of the Tioli Management Framework. When you perform a Typical installation, the following Tioli software is installed or upgraded. In some cases, the upgrade is optional. Copyright IBM Corp. 2002,

84 Tioli Management Framework The installer installs Tioli Management Framework, Version 4.1 if no Tioli Management Framework software exists. If Version is installed, the installer asks if you want to upgrade to Tioli Management Framework, Version 4.1. You can upgrade or choose to remain at the current leel. In either case, the installer applies the required patches. (The required patches for Version and Version 4.1 are listed in Appendix A, Patches and fix packs, on page 189.) IBM Tioli Monitoring, Version If you hae a back-leel ersion installed (Tioli Distributed Monitoring Adanced Edition, Version 4.1 or higher), the installer automatically upgrades to IBM Tioli Monitoring, Version IBM Tioli Monitoring Component Serices The installer installs IBM Tioli Monitoring Component Serices, Version if no IBM Tioli Monitoring Component Serices software exists. If a back-leel ersion is installed, the installer asks if you want to upgrade to IBM Tioli Monitoring Component Serices, Version You can upgrade or choose to remain at the current leel. (Optional) IBM Tioli Monitoring Web Health Console, Version During installation, you can choose whether or not to install the Web Health Console on target computers that you specify. If a back-leel ersion already exists, the installer automatically upgrades to the current ersion. During the installation procedure, you can choose to install one or more of the following IBM Tioli Monitoring for Business Integration monitoring components: WebSphere MQ WebSphere MQ Workflow WebSphere MQ Integrator WebSphere InterChange Serer During the installation procedure, you can optionally create managed nodes (other than the Tioli serer), endpoints, and Web Health Consoles. To create Windows endpoints using the installer, at least one Windows endpoint must exist in the domain of the Tioli management region serer (the computer from which you start the installer). If you are installing from a Windows system, and no Windows endpoints exist, the installer automatically creates a Windows proxy endpoint, which enables you to create additional Windows endpoints. If you are installing from a UNIX-based system, you must create the Windows proxy endpoint by following a separate procedure. Table 20 summarizes what you need to do under arious conditions. Table 20. Procedures for creating Windows endpoints What is the operating system of the Tioli serer? Do Windows endpoints already exist in the domain of the Tioli serer? Yes No Windows Complete this procedure (Installing the product using the Typical option) only. Complete this procedure (Installing the product using the Typical option) only. The installer automatically creates one Windows proxy endpoint, which enables you to create Windows endpoints using the installer. 66 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

85 Table 20. Procedures for creating Windows endpoints (continued) UNIX-based Complete this procedure (Installing the product using the Typical option) only. 1. Complete this procedure (Installing the product using the Typical option) to Step 31 on page 74. During the procedure, specify the Windows endpoints that you want to create. 2. Create a Windows proxy endpoint by completing the procedure Creating a Windows proxy endpoint on page Return to the installer and complete the Installing the product using the Typical option procedure. The installer creates the endpoints that you specified earlier in the procedure. Required authorization On UNIX, the user who installs the product must hae root priileges. On Windows, the user who installs the product must hae membership in the Administrators group. Before you begin If you want to install from CDs, collect the following CDs from the list in Table 16 on page 49. The IBM Tioli Monitoring for Business Integration installation CDs The Tioli software CDs for a Typical installation, as needed. Read the explanations in the table to determine which CDs you need The component software CDs for the IBM Tioli Monitoring for Business Integration monitoring components that you want to install The language support CDs for the monitoring components that you want to install in languages other than English If you want to install from files downloaded from the Web, you must create an installation depot to contain the downloaded files. Refer to the following sections to determine which files you need to download from the Web and how to set up an installation depot: Using installation files from the Web on page 50 Downloading installation files from the Web on page 54 Ensure that target computers on which you plan to create managed nodes are running the following processes to enable Tioli transactions: On Windows systems, the Tioli Remote Execution Serice (TRIP) process must be running. On UNIX-based systems, the rexecd daemon must be running. See Verifying that the required software is running on page 40 for more information. See Chapter 2, Guidelines for installation and setup, on page 17 for information about additional actiities required prior to installation. Close all local applications during installation except for Tioli Management Framework, if installed. If Tioli Management Framework is installed, it must be running on the Tioli serer and on any managed nodes and endpoints that are part of the Framework. Note: For Windows installations, the installer requires that you restart the computer after the following eents: Chapter 5. Performing a Typical installation 67

86 Creation of the user ID for the Tioli Management Framework software Installation of the Tioli Management Framework software When you finish Perform the following steps on any endpoints that you installed. The command starts the monitoring engine so that you can distribute and run resource models: 1. Access the command line interface for the Tioli enironment as described in Accessing the Tioli Management Framework enironment on page Run the following command: wdmcmd -restart -e <endpoint_label> where <endpoint_label> is the name of the endpoint. Complete the actiities described in Chapter 7, Completing the installation of the product, on page 93. Before you use this product to manage resources, complete the configuration steps documented in the IBM Tioli Monitoring for Business Integration User s Guide. Procedure Note: In the following steps and on the installation windows, the term Tioli serer refers to a managed node. The term a computer to monitor refers to an endpoint. 1. Log on to the computer that you want to be the Tioli serer. 2. Run one of the following setup executables to start the installation: For Windows, run setupbiz.bat. For UNIX, run setupbiz.sh. Additional Information: The setup executable is located in the root directory of the CD labeled IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 1. If you are installing from files downloaded from the Web, the setup executable is located in the directory where you downloaded and uncompressed installation files from the following Web download link: Tioli Monitoring for Business Integration, V5.1.1: Install AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin. 3. Click Next to display the license agreement. 4. Select I accept the terms in the license agreement. 5. Click Next. Third Party License Terms and Conditions, Notices and Information is displayed. 6. Click Next. 7. Specify the directory path where you want to install the product. 8. Click Next. 9. Specify the directory path where you want to create a depot (temporary directory) for product installation. Additional Information: The depot directory contains all the files required for installation. If you click Cancel in an installer panel always delete the temporary depot directory. You can begin installation again by running the 68 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

87 setup executable on the installation CD. After the installation is complete, the installer proides an option to automatically delete this directory. Note: On Windows, the depot must reside on the target computer. You cannot perform an installation of the product on Windows using a depot that is located on a remote system. On UNIX, proide a directory path that is accessible from the installation computer to the installation depot. 10. Click Next to copy the files to the installation directories. 11. Click Next when the installer prompts you to restart the application and continue the installation. The installation options window is displayed. Figure 4. Installation options window: Typical option 12. Select Typical and click Next. 13. (Optional) Select languages that you want to enable for users of the product. Additional Information: English is always enabled for this product. The installer installs the language enablement packages for additional languages that you choose. 14. Click Next. A list of existing managed nodes is displayed. Additional Information: At least one managed node is displayed in the list. This managed node is the Tioli management region serer (referred to on the installation windows as the principal Tioli serer). The installer creates the Tioli management region serer on the computer on which you are installing this product. The installer also discoers and lists any managed nodes that were created in a preious installation of Tioli Management Framework. 15. (Optional) Click Add to create additional managed nodes. Additional Information: If you are creating a Windows managed node, the target computer must hae the Tioli Remote Execution Serice (TRIP) process running. If you are creating a UNIX managed node, the target computer must hae the rexecd daemon running. See Verifying that the required software is running on page 40 for more information. Chapter 5. Performing a Typical installation 69

88 After adding a managed node to the list, you can use the Edit and Remoe buttons to edit it or remoe it from the list. You can edit or remoe only the managed nodes that you added. You cannot edit or remoe any of the managed nodes that were originally displayed in the list. Figure 5. Basic tab for managed nodes Note: When you click OK, you sae settings for both the Basic tab and the Adanced tab. 16. Follow these steps to create a managed node: a. Specify alues for the managed node in the fields of the Basic tab: Host Name Type the fully qualified host name for the computer on which you create the managed node. For example, the fully qualified host name for tokyo might be tokyo.sales.mycompany.com. Platform Click the drop-down list and select the name of the operating system on the managed node. User Type the login user ID of the person who performs the installation on the managed node. This user ID must hae full administratie priileges (Administrator on Windows and root on UNIX) on the target computer. Password and Verify Password The login password of the user specified in the User field. b. Click the Adanced tab. Figure 6. Adanced tab for managed nodes c. Specify alues in the fields of the Adanced tab. Destination (Optional) A customer path on the target machine where you want to install the Tioli software. Otherwise, Tioli uses the default path specification. 70 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

89 Reboot You must select this check box when you add Windows managed nodes to the Tioli management region. The managed node software is actiated after you restart the Windows computer. Gateway Specify if this computer is a gateway. d. Click OK to sae your settings and return to the installer. 17. Click Next to display the product selection panel. Figure 7. Component selection window 18. Select the monitoring components that you want to install. 19. Click Next to display a list of Tioli serers. 20. Select each Tioli serer that you re going to use to communicate with endpoints that will use the product or products you selected in Step 18. Additional Information: When the product is already installed on a managed node, the row is not in edit mode. The check box is selected and you cannot modify it. 21. Click Next to display the endpoint option panel. 22. Select the endpoints that you want to monitor. 23. (Optional) You can create endpoints for Tioli to monitor and manage. Additional Information: By default the installer assigns endpoints to managed nodes wheneer possible. The installer assigns endpoints to the Tioli management region serer only when no managed node is aailable. If you want to change gateway assignments for an endpoint after installation, see Changing the gateway assignment of an endpoint on page 127. Note: For z/os proxy endpoints, see Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 or Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157. Follow these steps to specify endpoints for the installer to create: Chapter 5. Performing a Typical installation 71

90 a. Click Add. Figure 8. Basic tab for endpoints b. Specify alues for the endpoint in the fields of the Basic tab: Host Name Type the fully qualified host name for the computer on which you create the endpoint. For example, the fully qualified host name for tokyo might be tokyo.sales.mycompany.com. Label Type a unique name for the endpoint. This name can include alphanumeric characters, underscores (_), hyphens (-), and periods (.). The names are case-sensitie. For example, the name EPName is different from epname. Note: This label should be different than the name of any managed node in the Tioli management region. Platform Click the drop-down list and select the name of the operating system on the endpoint. User Type the login user ID of the person who performs the installation on the endpoint. Tioli recommends that you use Administrator for Windows, and root for UNIX. Password and Verify Password The login password of the user specified in the User field. c. Click the Adanced tab. Figure 9. Adanced tab for endpoints d. Specify alues in the fields of the Adanced tab, if necessary. Port A port number dedicated to communication with the Tioli serer. The default is IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

91 Destination The path on the target machine where you want to install the Tioli software. Reboot You must select this check box when you add Windows endpoints. The endpoint software is actiated after you restart the target Windows computer. e. Click OK to sae your settings and continue installation in the installer panels. 24. Click Next to display the Web Health Console panel. 25. (Optional) Install the Web Health Console as follows: a. Click Install the Web Health Console, then click Next to display the list of aailable managed nodes. b. Place a check mark in the Web Health Console column beside the name of each managed node on which you want to install the console. Additional Information: When you specify the installation of the Web Health Console on a pre-existing managed node, you must supply the user ID and password. The installer prompts you for this information when you click Next. If the Web Health Console is already installed, do not place a check mark here. Otherwise, the console is installed again because the installer cannot detect preious installations of the Web Health Console. 26. Click Next to display the first of a series of windows, each of which prompts you for the directory location of a specified CD or CD image that contains the software to be installed. Additional Information: If you are installing from files that were downloaded from the Web, the CD images must be located in specific directories within the depot directory, as described in Downloading installation files from the Web on page 54. Figure 10. Sample prompt for a software CD 27. For each CD prompt window that is displayed, perform the following steps: Chapter 5. Performing a Typical installation 73

92 a. Insert the specified CD into the drie if you are not installing from CD image files that were downloaded from the Web. b. Type a directory path or click Browse to specify the path to the CD or CD image. c. Click Next. d. If you are installing from CD image files that were downloaded from the Web, click No in response to the message that asks if you want to copy the files to the depot directory. Additional Information: If you are installing from CDs, each CD image is copied to the depot directory. 28. Click Next on the final CD prompt window to display the Step List window. Additional Information: When the Step List window is displayed, the installer begins installation of the software from the depot to the install location. The Step List shows the software components that the installer installs, and it displays status updates for the installation process. The first two steps might require a system restart. If you are prompted to restart the system, click Finish to restart the computer. See Appendix B, Icons and options in the Step List window, on page 193 for a description of status icons and options in the Step List window. 29. (Optional) If you want to cancel the installation while the Step List is running, perform the following steps: a. Click Stop and allow the currently running process to finish. Additional Information: If you click Cancel without allowing the currently running process to finish, the system might remain in an unpredictable state. b. Click Cancel to stop the installation and close the installer. c. Delete the temporary depot directory created by the installer. 30. (Optional) Double-click any item in the list to see details and to set processing instructions for that step in the Details window. 31. (UNIX-based Tioli management region serers only) If you specified Windows endpoints to create in Step 23 on page 71, and no Windows endpoints currently exist in the domain of the Tioli management region serer, perform the following steps: a. Click Stop at the top of the Step List. b. Perform the procedure described in Creating a Windows proxy endpoint on page 75. Additional Information: The installer creates the Windows endpoints that you specified in Step 23 on page 71 after you create the Windows proxy endpoint and successfully complete the steps in the Step List. 32. Click OK in the final prompt of the Step List. Additional Information: This final prompt is displayed when all steps in the Step List show a Passed status. If all steps do not show a Passed status, see the IBM Tioli Monitoring for Business Integration: Problem Determination Guide for troubleshooting information. 33. Click Next. 34. Select Delete the temporary files to delete the depot directory that you specified at the beginning of the installation process. 35. Click Next. 36. Click Finish. 74 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

93 Creating a Windows proxy endpoint Objectie To enable the installer to create Windows endpoints if you are installing from a UNIX-based Tioli management region serer when there are no existing Windows endpoints in the domain of the serer. This procedure is not necessary if you are installing from a Windows system. Background information The installer can create Windows endpoints for the Tioli management region serer that you are installing. Howeer, this capability exists only when you are installing the Tioli management region serer on a Windows operating system. A proxy endpoint must exist in a Windows domain to enable the installer to create Windows endpoints. When the Tioli management region serer runs on Windows and you want to create Windows endpoints, the installer automatically creates the proxy endpoint in the domain in which that serer resides. This proxy should share the same domain as the Tioli management region domain because it uses Windows Uniersal Naming Conention (UNC) methods to proide remote access to newly created Window endpoints. The proxy endpoint enables creation of Windows endpoints in any domain that has a trusted relationship with the domain that contains the proxy. The Tioli serer uses the user ID and password for the proxy endpoint to obtain access to the file system of the other Windows serers. The installer also associates the proxy endpoint with a gateway in the Tioli management region. Otherwise, the Tioli management region serer cannot use the proxy endpoint. You perform this procedure at a specific point during the installation process when a gateway has been created to associate with the proxy endpoint. With this proxy access, the Tioli serer is able to install endpoints on Windows systems in that domain and in other Windows domains in the network that hae a trusted relationship. Without a proxy endpoint, the Tioli serer cannot create Windows endpoints in that remote domain. In UNIX installations, the installer does not automatically create the proxy endpoint that Windows requires. When the Tioli management region serer you are installing runs a UNIX operating system, you must use this procedure. The procedure sets up the required proxy endpoint in the Windows domain that contains target Windows serers that you want to monitor with IBM Tioli Monitoring for Business Integration. Required authorization On UNIX systems, the user who installs the product must hae root priileges. On Windows systems, the user must hae membership in the Administrators group. Before you begin Perform the Typical installation procedure through Step 31 on page 74. Identify the Windows computer that will sere as the proxy endpoint. You need the endpoint name as well as the host name for the machine. For instance, if the host name is ision35.mycompany.com, you might want to name the endpoint ision35_ep. When you finish Complete the Typical installation steps that follow 31 on page 74. After the Typical installation process finishes, perform the procedures in Chapter 7, Completing the Chapter 5. Performing a Typical installation 75

94 installation of the product, on page 93, which include erification of the installation of all endpoints and managed nodes. Procedure You perform this procedure in the installer and in the Tioli Management Framework Endpoint Setup wizard. This procedure supplements the Typical installation process, at the point when the installer begins to process the Step List. Use this procedure only if you are installing the product on a UNIX-based serer. This procedure is not necessary if you are installing the product on a Windows-based serer. 1. Click Stop at the top of the Step List when the installer starts running Step 1. The system displays a message indicating that it will stop at the end of the current step. Figure 11. Stop deployment message 2. Click OK and wait for the step to finish processing. 3. In the Step List scroll to the TMA installation step. 4. Double-click on the TMA installation step to access the Detail window for the step. Figure 12. Detail window for TMA installation step 5. Perform the following steps: a. Click Toggle Breakpoint. b. Click OK. 76 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

95 Additional Information: This action sets a breakpoint for when the installer begins to install endpoints. A stop sign icon indicates the step at which you inserted a breakpoint. While this step is in breakpoint mode, you enable the endpoint proxy as described in Step Click Run All at the top of the Step List window. Additional Information: Processing of the steps in the Step List resumes, until the installer reaches the breakpoint and stops. Prior to the breakpoint you set in Step 5 the installer completes the creation of a gateway. To install correctly, the proxy endpoint must refer to this gateway. Otherwise the Tioli management region serer cannot recognize the proxy endpoint. 7. When the installer reaches the breakpoint you created in Step 5, install the proxy endpoint as follows. Perform these steps on the computer where you are going to install the proxy endpoint, not on the Tioli management region serer. a. Insert the CD labeled Tioli Management Framework 1 of 2, Version 4.1 into the CD drie of the computer that you want to be the endpoint. b. Run the setup executable located in the following subdirectory path of the Tioli installation directory:..\pc\lcf\winnt c. Click Next in the Tioli Management Framework Endpoint Setup window. d. Read the license agreement. e. Click Next to display the Endpoint installation options window. f. (Optional) Click Browse to change the destination directory for the software. g. Click Next to display the Tioli Remote Access Account window. h. Type the user name and password of the account through which Tioli Management Framework accesses remote file systems. If you do not require access to remote domains, click Next to skip this step. i. Click Next to access the Adanced Configuration window. j. Specify the startup and configuration options information listed in the following table: Table 21. Startup and configuration options Field name Use when... Gateway The gateway uses a port number other than the default Endpoint Other You want to specify a port for the endpoint to use other than the default. The default is Use the g <host_name_of_the_gateway> option to specify the intercepting gateway. Use the n <host_name_of_the_endpoint> option to specify the name of the endpoint you are installing as the proxy. k. Click Next to continue the installation process. Additional Information: The installer reports that communication of the proxy endpoint and the gateway was successful. The endpoint is installed and logged into a gateway. The installation process configures the endpoint system to automatically start the endpoint serice when the system starts. If the system does not start, there might be a problem with the communication between the proxy endpoint and the gateway. Remoe and then reinstall the endpoint. See the IBM Tioli Monitoring for Business Integration: Problem Determination Guide for information on how to remoe an endpoint. l. Click Next to display the Setup Complete window. Chapter 5. Performing a Typical installation 77

96 m. Click Finish to display the Restart Windows window. n. Select No to preent the restarting of the operating system. Additional Information: You can restart the system after the installation of IBM Tioli Monitoring for Business Integration is complete. When you restart the computer, the Tioli Endpoint serice is created, with the startup type set to automatic. 8. Press OK to complete the endpoint installation. 9. On the Tioli management region serer, click Run All in the installer and complete the installation steps that follow Step 31 on page 74 in the Typical installation procedure. 78 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

97 Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment This chapter describes how to install or upgrade IBM Tioli Monitoring for Business Integration using the Tioli desktop or command line. (This book refers to installations using the Tioli desktop or command line as manual installations.) These procedures enable you to install or upgrade the required base software and one or more product components without using the installer. You might find it more conenient to perform manual installations, rather than using the installer, when adding computers to your initial configuration. Note that this chapter describes only the installation of the base and component software. Depending on your configuration, additional steps might be required before you can use the product to start managing installed applications. For example, after you discoer resources to be managed, you will need to deploy resource models or eent adapters to monitor those resources. If you need to add additional computers to your configuration, refer to Chapter 8, Expanding your Tioli enironment, on page 119 for procedures that you can use to manually install managed nodes, endpoints, or Web Health Consoles.) Version or 4.1 of the Tioli Management Framework must be installed, with the required patches, in the Tioli enironment before you perform any of the procedures for installing or upgrading IBM Tioli Monitoring for Business Integration. This software comes with the installation CDs for this product. Table 22. Guidelines for installing the product from the Tioli desktop or command line Goal Access the Tioli enironment as the first step for performing any of the procedures described in this chapter. Install Tioli patches to update performance of the Tioli Management Framework software or to upgrade the software. You must hae Version or Version 4.1 installed, with required patches, before you install or upgrade the base and component software for IBM Tioli Monitoring for Business Integration. Determine which base and component software you need to install and upgrade, and in what order, based on what software is currently installed in your enironment. Based on this determination, perform installations of new software and upgrades of current software in the correct order. Refer to Accessing the Tioli Management Framework enironment on page 81 For a list of required patches, see Appendix A, Patches and fix packs, on page 189. To install the patches or to upgrade the software, follow the procedure described in Upgrading, installing Tioli patches, and installing fix packs on page 86. Road map for manual installations and upgrades For installations of new software, see Installing new Tioli software on page 83. To install patches, fix packs, or upgrades, see Upgrading, installing Tioli patches, and installing fix packs on page 86. Road map for manual installations and upgrades Table 23 on page 80 lists the procedures you must perform to manually install or upgrade the product, depending on what software is currently installed in your Tioli enironment. Before you install or upgrade any of the IBM Tioli Monitoring for Business Integration component software, you must install or upgrade to the Copyright IBM Corp. 2002,

98 required ersions of IBM Tioli Monitoring and IBM Tioli Monitoring Component Serices, as described in the first two rows of the table. The remaining rows of the table describe procedures for installing or upgrading the component software. Installation or upgrade of any indiidual component is optional. Use the following procedures to perform all installations and upgrades specified in the table: Use the procedure Installing new Tioli software on page 83 for fresh installations. Use the procedure Upgrading, installing Tioli patches, and installing fix packs on page 86 to install fix packs or to upgrade existing software to the required ersion. Table 23. Installation and upgrade procedures for manual installations of IBM Tioli Monitoring for Business Integration Required ersion of product or component IBM Tioli Monitoring, Version with Fix Pack 5 If the following ersion or predecessor product is currently installed... No ersion of IBM Tioli Monitoring and no predecessor product OR Distributed Monitoring, Version 3.7 Tioli Distributed Monitoring, Version 4.1 Adanced Edition...perform the following procedures: 1. Install IBM Tioli Monitoring, Version Install IBM Tioli Monitoring, Version Fix Pack Upgrade to IBM Tioli Monitoring, Version from Upgrade to IBM Tioli Monitoring, Version from Install IBM Tioli Monitoring, Version Fix Pack 5. IBM Tioli Monitoring Component Serices, Version IBM Tioli Monitoring for Business Integration: WebSphere MQ IBM Tioli Monitoring, Version Upgrade to IBM Tioli Monitoring, Version from Install IBM Tioli Monitoring, Version Fix Pack 5. IBM Tioli Monitoring, Version Install IBM Tioli Monitoring, Version Fix Pack 5. No ersion IBM Tioli Monitoring Component Serices, Version No ersion Tioli Manager for MQSeries, Version 2.3 Tioli Manager for MQSeries, Version 2.4 IBM Tioli Monitoring for Business Integration: WebSphere MQ Install IBM Tioli Monitoring Component Serices, Version Upgrade to IBM Tioli Monitoring Component Serices, Version from Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Not supported Upgrade to IBM Tioli Monitoring for Business Integration: WebSphere MQ from Upgrade to IBM Tioli Monitoring for Business Integration: WebSphere MQ from If you are managing WebSphere MQ on OS/400 endpoints, remoe OS/400 proxy support. See Remoing an endpoint from an OS/400 system on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

99 Table 23. Installation and upgrade procedures for manual installations of IBM Tioli Monitoring for Business Integration (continued) Required ersion of product or component IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator with Fix Pack 1 IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer If the following ersion or predecessor product is currently installed......perform the following procedures: No ersion 1. Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow No ersion 1. Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Tioli Manager for MQSeries Integrator, Version IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator No ersion 2. Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Install IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Fix Pack Install IBM Tioli Monitoring for Business Integration: WebSphere MQ if no ersion is installed. OR Upgrade to IBM Tioli Monitoring for Business Integration: WebSphere MQ from an earlier ersion. 2. Upgrade to IBM Tioli Monitoring for WebSphere MQ Integrator from Install IBM Tioli Monitoring for WebSphere MQ Integrator Fix Pack 1. Install IBM Tioli Monitoring for WebSphere MQ Integrator Fix Pack 1. Install IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Accessing the Tioli Management Framework enironment Objectie To access the Tioli Management Framework enironment so that you can use the operations and functions of IBM Tioli Monitoring software. Background information You can access the Tioli Management Framework desktop (Tioli desktop) or the Tioli command line interface in order to use the operations and functions of IBM Tioli Monitoring software. The Tioli desktop is a user interface that proides point-and-click access to IBM Tioli Monitoring for Business Integration features and functions. The Tioli desktop proides a central control point for you to organize, manage, and delegate system management operations. Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 81

100 IBM Tioli Monitoring for Business Integration also proides a command line interface (CLI) that enables you to enter commands from the keyboard. You can use these commands in shell scripts and with system utilities such as the UNIX cron utility. For more information about using commands, refer to the Tioli Management Framework Reference Guide. Required authorization role Not applicable. Before you begin Not applicable. When you finish Not applicable. Procedure There are separate logon procedures for UNIX and Windows. For a Windows operating system, use the Windows menu structure. For a UNIX operating system, use the UNIX command line. UNIX: 1. Log on to a UNIX managed node or Tioli management region serer. 2. Run the enironment initialization and setup script. If you are using the Bourne, Korn, or bash shell, run the following command:. /etc/tioli/setup_en.sh If you are using the C shell, run the following command: source /etc/tioli/setup_en.csh 3. Type the tioli command at a command prompt to bring up the Tioli logon screen. See the Tioli Management Framework Reference Guide for more information on this command. Windows NT: 1. Log on to a Windows NT managed node or Tioli management region serer. 2. Bring up the Tioli logon screen. Note: If you are using a port other than port 94, configure the shortcut to include -port <port number>. 3. Click Start Programs Tioli Tioli in the Windows task bar to access the login screen of the Tioli desktop. 4. Type the following alues in the fields of the login screen: Host Machine Specifies the Tioli managed node, including the Tioli serer where the Tioli desktop should connect Log In As Specifies the login name to the managed node Password Specifies the password for the specified login name 5. Click OK to open the Tioli desktop. 82 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

101 Installing new Tioli software Objectie To install new Tioli software products without using the installer. Background information Use this procedure to perform new installations of the latest ersions of the base product software (IBM Tioli Monitoring and IBM Tioli Monitoring Component Serices) and the IBM Tioli Monitoring for Business Integration component software. See Road map for manual installations and upgrades on page 79 to determine which new software you need to install. Install the new software on the following computers: The Tioli management region serer (Tioli serer) All managed nodes (preferred) or at a minimum, all managed nodes that host gateways, that are used for Tioli object storage, or that host a Tioli Business Systems Manager task serer The eent serer (if present) for IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. If you are using an eent serer to process WebSphere MQ Integrator eents, you must install IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator on the eent serer in addition to installing it on the Tioli serer and managed nodes. you must also install the following software on the eent serer: IBM Tioli Monitoring, Version IBM Tioli Monitoring, Version Fix Pack 5 IBM Tioli Monitoring Component Serices, Version IBM Tioli Monitoring for Business Integration: WebSphere MQ Table 24 lists the base product software and the component software, with associated information required to perform the installation procedure. Repeat the procedure for each software item required to install. Table 24. Information required to install the software Install: IBM Tioli Monitoring, Version CD name: IBM Tioli Monitoring, Version Web download: IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English IND file name: /cdrom/dm511.ind Software name: IBM Tioli Monitoring, Version Install: IBM Tioli Monitoring Component Serices, Version CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 Web download: Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin IND file name: /ITMCS/CMPTSVCS.IND Software name: IBM Tioli Monitoring Component Serices, Version Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 83

102 Table 24. Information required to install the software (continued) Install: IBM Tioli Monitoring for Business Integration: WebSphere MQ CD name: Web download: IND file name: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/MQS_511.IND Software name: IBM Tioli Monitoring for Business Integration WebSphere MQ Install: IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow CD name: Web download: IND file name: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/MQWF.IND Software name: IBM Tioli Monitoring for Business Integration WebSphere MQ Workflow Install: CD name: Web download: IND file name: Software name: IBM Tioli Monitoring for Business Integration, Version 5.1.0: WebSphere MQ Integrator IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/WMQ151.IND IBM Tioli Monitoring for Business Integration WebSphere MQ Integrator Install: IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer CD name: Web download: IND file name: IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/WICS.IND Software name: IBM Tioli Monitoring for Business Integration WebSphere InterChange Serer Required authorization role install_product Also, you must install as root on UNIX and Administrator on Windows. Before you begin Start the Tioli enironment for the installation method (command line interface or Tioli desktop) that you plan to use, as described in Accessing the Tioli Management Framework enironment on page 81. Back up the Tioli management region as described in Backing up and restoring Tioli databases on page 38. Prepare a list of all the computers on which to install the software. You can use the following command to display a list of managed nodes: 84 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

103 wlookup -a -r ManagedNode Obtain the necessary CDs or downloads. Table 24 on page 83 specifies the CD and Web download link for each software product or component. Ensure that all managed nodes are running and communicating with the Tioli serer. When you finish Before you use this product to manage resources, complete the configuration steps documented in the IBM Tioli Monitoring for Business Integration User s Guide. Procedure You can perform this procedure from the command line or from the Tioli desktop. Command line: Run the following command from the command prompt: winstall -c <source_dir> [-s <serer>] -i <IND_file> [-y] [-n] where: -c <source_dir> Specifies the complete path to the directory containing the installation image. -s <serer> Specifies the name of the managed node to use as the installation serer. By default, the installation serer is the Tioli serer. -i <IND_file> Specifies the product index file (.IND file) to reference for the installation. See Table 24 on page 83 for the name of the.ind file corresponding to the software that you are installing. -y Installs the product without requesting confirmation. -n Installs the product on all managed nodes that do not currently hae the product installed. Refer to the Tioli Management Framework Reference Manual for more information about this command. Refer to Tioli command syntax on page x for information about Tioli command line syntax. Tioli desktop: 1. Select Install from the Desktop menu. 2. Select Install Product in the menu to display the Install Product window. 3. If necessary, click OK to bypass a harmless error message about the media settings. 4. Click Select Media to display the File Browser window. 5. In the Path Name text field, enter the full path to the.ind file for the software that you are installing. Table 24 on page 83 specifies the name of the.ind file for each software product or component. Be sure to use backward slashes (\) for Windows path names instead of forward slashes (/). 6. Click Set Path. The File Browser window displays the contents of the specified media in the Files scrolling list. 7. Click Set Media & Close. 8. Select the software name from the Select Product to Install scrolling list in the Install Product window. Refer to the Software name row in Table 24 on page 83 that corresponds to the product or component software that you are installing. Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 85

104 9. Prepare the Clients to Install On list of targets for software installation: a. Disable software installation for some clients, as needed: 1) Take no action if the client is listed in the Aailable Clients scrolling list. 2) Select a client that does not require the software, but is listed in the Clients to Install On scrolling list by default. 3) Click the right arrow to moe the client to the Aailable Clients scrolling list. b. Enable software installation for some clients, as needed: 1) Take no action if the client is listed in the Clients to Install On scrolling list. 2) Select a client requires the software, but is listed in the Aailable Clients scrolling list by default. 3) Click the left arrow to moe the client to the Aailable Clients scrolling list. 10. Click Install & Close to display the Product Install window and a list of pending installation actions. 11. Click Continue Install to begin the installation process. Additional Information: The Product Install window displays the progress of the installation. View the messages in the task output window to determine whether the product installation was successful. If necessary, see the IBM Tioli Monitoring for Business Integration Problem Determination Guide for information on problem determination. 12. Click Close to close the Product Install window. 13. Select Refresh from the View menu bar. The desktop displays the icon for the product you installed. 14. As a precautionary measure, back up the Tioli management region databases as described in Backing up and restoring Tioli databases on page 38. Use a unique name for the new backup files. Upgrading, installing Tioli patches, and installing fix packs Objectie To install a Tioli software patch, fix pack, or product upgrade without using the installer. Background information Use this procedure to update or upgrade the following required and optional software for IBM Tioli Monitoring for Business Integration: Tioli Management Framework, Version or Version 4.1 You can update Tioli Management Framework, Version 4.1, by installing the required patches, listed in Table 25 on page 87. You can update Tioli Management Framework, Version 3.7.1, by installing the required patches, listed in Table 26 on page 87. The result of this procedure is that you remain at Version You can upgrade from Tioli Management Framework, Version 3.7.1, to Tioli Management Framework, Version 4.1, by installing the required fix pack, listed in Table 28 on page 88. When you perform this procedure, it is not necessary to install patches. The required base product software, IBM Tioli Monitoring and IBM Tioli Monitoring Component Serices 86 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

105 The IBM Tioli Monitoring for Business Integration component software Use Road map for manual installations and upgrades on page 79 to determine which fix packs and upgrades you need to install for the base product software and product component software. Install the fix packs or upgrade software on all computers on which the base product (IBM Tioli Monitoring and IBM Tioli Monitoring Component Serices) is installed. The following tables list information that you need while performing the installation procedure for a patch, fix pack, or upgrade. Table 25 and Table 26 list information for Tioli Management Framework patches. Table 27 on page 88 lists information for fix packs. Table 28 on page 88 lists information for upgrades. Repeat the installation procedure for each patch, fix pack, or upgrade. Table 25. Information required for installing patches for Tioli Management Framework, Version 4.1 CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 Web link: Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Patch name IND file name Software name 4.1-TMF-0013 /patches/41tmf013/41tmf013.ind Tioli Framework Patch 4.1-TMF-0013 (build 05/28) 4.1-TMF-0014 /patches371/361tmf34/tmf3134.ind Tioli Framework Patch 4.1-TMF-0014 (build 05/30) Table 26. Information required for installing patches for Tioli Management Framework, Version Note: Install the patches for Tioli Management Framework, Version 3.7.1, in the order shown. Some patches are needed only for Linux or OS/400 support. Table 41 on page 189 shows which patches apply only to Linux or OS/400. CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 3 Web link: Tioli Monitoring for Business Integration, V5.1.1: Install 3 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin Patch name IND file name Software name TMF-0034 /patches371/361tmf34/41tmf36134.ind Tier Tioli Framework Endpoints (3.6.1-TMF-0034) TMF-0062 /patches371/361tmf62/361tmf62.ind Linux Tioli Framework Endpoint Bundle (3.6.1-TMF-0062) 3.7-TMF-0021 /patches371/37tmf21/37tmf021.ind 3.7-TMF-0021 Tier Endpoint Bundles for Tier1 Gateways 3.7-TMF-0035 /patches371/37tmf35/37tmf035.ind 3.7-TMF-0035 Tioli Framework Patch 3.7-TMF-0043 /patches371/37tmf43/37tmf43.ind Tioli Management Agent 3.7 (37TMF43-85) for AS/400 Endpoint TMF-0059 /patches371/371tmf59/371tmf59.ind Tioli Framework Patch TMF-0059 (build 03/19) TMF-0066 /patches371/371tmf66/371tmf66.ind Tioli Framework Patch TMF-0066 (build 05/31) Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 87

106 Table 26. Information required for installing patches for Tioli Management Framework, Version (continued) TMF-0073 /patches371/371tmf73/371tmf73.ind Tioli Framework Fixpack TMF-0073 (build 07/25) TMF- 0074A /patches371/371tmf74a/371tmf74a.ind Tioli Framework Patch TMF-0074A (build 03/19) TMF-0083 /patches371/371tmf83/371tmf83.ind Tioli Framework Patch TMF-0083 (build 08/05) TMF-0087 /patches371/371tmf87/371tmf87.ind Tioli Framework Patch TMF-0087 (build 09/12) TMF-0097 /patches371/371tmf97/371tmf97.ind Tioli Framework Patch TMF-0097 (build 04/03) TMF-0099 /patches371/371tmf99/371tmf99.ind Tioli Framework Patch TMF-0099 (build 02/13) TMF-0114 /patches371/371tmf114/371tmf114.ind Tioli Framework Patch TMF-0114 (build 10/16) Table 27. Information required for installing fix packs Fix pack: IBM Tioli Monitoring, Version Fix Pack 5 CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 Web Link: IND file name: Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin /511ITM05.IND Software name: IBM Tioli Monitoring, Version Fix Pack 5 Fix pack: IBM Tioli Monitoring for WebSphere MQ Integrator Fix Pack 1 CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 Web Link: IND file name: Software name: Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin /51MQIFP1.IND IBM Tioli Monitoring for Business Integration WebSphere MQ Integrator FP1 Table 28. Information required for installing upgrade software Upgrade to: Tioli Management Framework, Version 4.1 From: Tioli Management Framework, Version CD name: Tioli Management Framework Upgrade Version 3.7 to Version 4.1 Web download: IND file name: Tioli Management Framework Upgrade 3.7 to 4.1, Multiplatform, International English, Brazilian Portuguese, French, German, Italian, Spanish /TMF_41.IND Software name: Tioli Management Framework Upgrade Version 3.7 to Version 4.1 Upgrade to: IBM Tioli Monitoring, Version IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

107 Table 28. Information required for installing upgrade software (continued) From: Distributed Monitoring, Version 4.1 Adanced Edition CD name: IBM Tioli Monitoring, Version Web download: IND file name: IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English /upg41to51/dm51upg.ind Software name: IBM Tioli Monitoring Upgrade, Version 4.1 (DM Adanced Edition) to Upgrade to: IBM Tioli Monitoring, Version From: IBM Tioli Monitoring, Version CD name: IBM Tioli Monitoring, Version Web download: IND file name: IBM Tioli Monitoring V5.1.1 for WinNT, Win 2000, WinXP, HP-UX, Solaris, AIX, Linux Int English /upgrade/dm51upg.ind Software name: IBM Tioli Monitoring Upgrade, Version to Upgrade to: IBM Tioli Monitoring Component Serices Upgrade, Version From: IBM Tioli Monitoring Component Serices Upgrade, Version CD name: IBM Tioli Monitoring for Business Integration, Version 5.1.1: Installation Disk 2 Web download: IND file name: Tioli Monitoring for Business Integration, V5.1.1: Install 2 AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl Braz Port French Italian German Spanish Japan Korea Simp Chin Trad Chin /ITMCS/ITMCS511.IND Software name: IBM Tioli Monitoring Component Serices Upgrade, Version to Upgrade to: IBM Tioli Monitoring for Business Integration: WebSphere MQ From: Tioli Manager for MQSeries, Version 2.4 CD name: Web download: IND file name: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/MQS_24_U.IND Software name: IBM Tioli Monitoring for Business Integration WebSphere MQ 5.1.1, Version Upgrade Upgrade to: IBM Tioli Monitoring for Business Integration: WebSphere MQ From: IBM Tioli Monitoring for Business Integration: WebSphere MQ CD name: Web download: IND file name: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software Tioli Monitoring for Business Integration: WebSphere MQ Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/MQS_51_U.IND Software name: IBM Tioli Monitoring for Business Integration WebSphere MQ 5.1.1, Version Upgrade Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 89

108 Table 28. Information required for installing upgrade software (continued) Upgrade to: IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator From: Tioli Manager for MQSeries Integrator, Version CD name: Web download: IND file name: Software name: IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software AIX HP-UX Linux Solaris Win2000 WinNT WinXP Int Engl /PRODUCT/51MQI000.IND IBM Tioli Monitoring for Business Integration WebSphere MQ Integrator, Version Upgrade Required authorization role install_product Before you begin Start the Tioli enironment for the installation method (command line interface or Tioli desktop) that you plan to use, as described in Accessing the Tioli Management Framework enironment on page 81. Back up the Tioli management region as described in Backing up and restoring Tioli databases on page 38. Prepare a list of all managed nodes on which to install the software. To display a list of all installed Tioli software by managed node, run the wlsinst -ah command from the Tioli command line. Install the patches, fix pack, or upgrade software on all managed nodes that hae the base software installed. For example, install Tioli Management Framework patches or the Tioli Management Framework upgrade software on all managed nodes that hae Tioli Management Framework installed. Obtain the necessary CDs or downloads: Table 25 on page 87 and Table 26 on page 87 specify CD and Web download links for Tioli Management Framework patches. Table 27 on page 88 specifies CD and Web download links for fix packs. Table 28 on page 88 specifies CD and Web download links for software upgrades. Ensure that all managed nodes are running and communicating with the Tioli serer. When you finish Before you use this product to manage resources, complete the configuration steps documented in the IBM Tioli Monitoring for Business Integration User s Guide. After you install the upgrade on the Tioli management region serer, perform the following procedures if any resource models were preiously distributed: On Windows endpoints: 1. Stop the IBM Tioli Monitoring engine on each endpoint by running the following command: wdmcmd -stop -e <endpoint_label> where <endpoint_label> is the name of the endpoint. 2. Wait 15 minutes after stopping the engine so that the monitoring processes can time out and die on the endpoints. 90 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

109 3. Redistribute all profiles that contain IBM Tioli Monitoring for Web Infrastructure: WebSphere Application Serer resource models. On UNIX endpoints, redistribute all profiles that contain IBM Tioli Monitoring for Web Infrastructure: WebSphere Application Serer resource models. (On UNIX endpoints, it is not necessary to stop the IBM Tioli Monitoring engine before redistributing the profiles.) Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the following command from the command prompt: wpatch -c <source_dir> -i <IND_file> [-y] [-n] where: -c <source_dir> Specifies the complete path to the directory containing the installation image. -i <IND_file> Specifies the product index file (.IND file) to reference for the installation. Table 25 on page 87 and Table 26 on page 87 specify.ind files for Tioli Management Framework patches. Table 27 on page 88 specifies.ind files for fix packs. Table 28 on page 88 specifies.ind files for software upgrades. -y Installs the software without requesting confirmation. -n Installs the patch, fix pack or upgrade software on all managed nodes that do not currently hae the software installed. Tioli desktop: 1. Select Install from the Desktop menu. 2. Select Install Patch. 3. If necessary, click OK to bypass a harmless error message about the media settings. 4. Click Select Media to display the File Browser window. 5. In the Path Name text field, enter the full path to the.ind file for the software that you are installing. Table 25 on page 87 and Table 26 on page 87 specify.ind files for Tioli Management Framework patches. Table 27 on page 88 specifies.ind files for fix packs. Table 28 on page 88 specifies.ind files for software upgrades. Be sure to use backward slashes (\) for Windows path names instead of forward slashes (/). 6. Click Set Path. The File Browser window displays the contents of the specified media in the Files scrolling list. 7. Click Set Media & Close. 8. Select the patch, fix pack, or upgrade software from the Select Patch to Install scrolling list in the Install Patch window. See the tables in the Before You Begin section for the software names of patches, fix packs, or upgrades that are displayed in the Install Patch window. Chapter 6. Installing or upgrading the product manually in an existing Tioli enironment 91

110 9. Select the target clients on which to install the software from the Aailable Clients scrolling list. 10. Click the right arrow to moe the selected clients to the Clients to Install On scrolling list. 11. Click Install & Close to display the Patch Install window and a list of pending installation actions. 12. Click Continue Install to begin the installation process. Additional Information: The Patch Install window displays the progress of the installation. View the messages in the task output window to determine whether the patch installation was successful. 13. Click Close to close the Patch Install window. 14. As a precautionary measure, back up the Tioli management region databases as described in Backing up and restoring Tioli databases on page 38. Use a unique name for the new backup files. 92 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

111 Chapter 7. Completing the installation of the product This section describes how to erify the installation and enable functionality for IBM Tioli Monitoring for Business Integration. After you complete the releant procedures in this chapter, see the IBM Tioli Monitoring for Business Integration User s Guide to learn how to begin monitoring resources: Table 29. Guidelines for completing the installation of the product Goal Verify the success of the installation of the managed nodes and endpoints. Set up the Jaa Runtime Enironment, Version on endpoints. This software enables distribution of resource models. Install the Jaa software on endpoints that do not hae it. If the Jaa software already exists on the endpoint, run a Tioli task to link the software to IBM Tioli Monitoring. (Optional) Load class files that enable you to customize the resource models that come with the IBM Tioli Monitoring for Business Integration. Refer to Verifying the installation of the product on page 94 Installing the Jaa Runtime Enironment on page 95 Linking to an existing Jaa Runtime Enironment on page 97 Loading Managed Object Format (MOF) files into Resource Model Builder on page 99 See the IBM Tioli Monitoring for Business Integration User s Guide for information on using the resource models: Enable the storage of historical data that you can use in the Tioli Enterprise Data Warehouse. Install and configure the Tioli Enterprise Data Warehouse Support Component. You must install this component first on the Tioli management region serer and then on all managed nodes. Assign authorization roles required to use the product to manage and monitor serers. Install aailable language support packages after product installation when you choose to not install language packs during installation of IBM Tioli Monitoring for Business Integration. Update enablement files for the Web Health Console when you upgrade or add components to the product. See IBM Tioli Monitoring Resource Model Builder User s Guide to learn how to use the optional Resource Model Builder tool to create custom resource models to use with IBM Tioli Monitoring for Business Integration. Installing files to enable Tioli Enterprise Data Warehouse on page 100 See the Integration with Tioli Enterprise Data Warehouse chapter in the IBM Tioli Monitoring User s Guide. See the IBM Tioli Monitoring for Business Integration User s Guide for information on required authorization roles: Installing IBM Tioli Language Support for this product on page 103 Updating Web Health Console files on page 106 Copyright IBM Corp. 2002,

112 Table 29. Guidelines for completing the installation of the product (continued) Goal Integrate Monitoring for WebSphere MQ with Tioli Inentory so that you can sae and restore WebSphere MQ configurations to and from the Tioli Inentory database. You can also clone saed WebSphere MQ configurations to Tioli endpoints in your network. You must hae ersions 4.1 or 4.2 of Tioli Inentory installed to use this feature. * 1. Install the WebSphere MQ database schema. These schemas define the tables and the iews in the Tioli Inentory database, and restore saed queue manager configuration data from the WebSphere MQ database schema. 2. Create the MQSeries Inentory policy region to enable Monitoring for WebSphere MQ to work with Tioli Inentory. Refer to For item 1: For DB2, Installing the DB2 WebSphere MQ database schema on page 109 For Microsoft SQL, Installing the Microsoft SQL WebSphere MQ database schema on page 111 For Oracle, Installing the Oracle WebSphere MQ database schema on page 112 For Sybase, Installing the Sybase WebSphere MQ database schema on page 114 For item 2: Creating the MQSeries Inentory policy region on page 115 * Version 4.1 of Tioli Inentory was a separate product. Subsequent to that ersion, Tioli Inentory became a component in the following product: IBM Tioli Configuration Manager, Version 4.2. Note: Before you use this product to manage resources, complete the configuration steps documented in the IBM Tioli Monitoring for Business Integration User s Guide. Verifying the installation of the product Objectie To erify successful installation of the product. Background information This procedure describes how to use the Tioli command line interface to list the elements of the Tioli enironment. You should complete this procedure before running the product to confirm correct installation and connectiity for all elements. Required authorization role The installation routine for IBM Tioli Monitoring for Business Integration gies administratie authorization to the user account that performs the installation. This authorization includes the ability to perform this procedure. For other users, the required authorization role for running the wep command is senior or super. Before you begin Access the Tioli enironment as described in Accessing the Tioli Management Framework enironment on page 81. When you finish If you cannot erify connection with an endpoint, see the IBM Tioli Monitoring for Business Integration Problem Determination Guide. Procedure You can perform this procedure from the Tioli desktop or from the command line. Command Line: Use the wlsinst command to list the products and patches in the Tioli enironment. The following example lists the products and patches installed, with the host name and interpreter type on which each product or patch was installed: 94 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

113 wlsinst -ah where -ah Lists all products and patches installed in the Tioli management region, including the host name and interpreter type of the computer. Run the following wep command to list the endpoints and their associated gateway: wep ls You can also run the wep command to retriee and set endpoint information, migrate an endpoint from one gateway to another, and update any endpoint data changes within a Tioli management region. Run the wep command without arguments to display the wep usage statement. Run the following wgetallinst command to list the managed nodes: wgetallinst ManagedNode See the Tioli Management Framework Reference Manual for a complete description of all options aailable for these commands. Desktop: 1. Access the Tioli desktop as described in Accessing the Tioli Management Framework enironment on page View the icons for the managed resources that you installed to erify that they exist. 3. Open the Endpoint Manager to see the list of gateways. View each gateway to see the set of endpoints managed by that gateway. Verify that all installed endpoints are listed under a gateway. Installing the Jaa Runtime Enironment Objectie To install the Jaa Runtime Enironment and link IBM Tioli Monitoring to that enironment. Background information Each endpoint in an IBM Tioli Monitoring system requires a local installation of the Jaa Runtime Enironment (JRE), Version or Solaris endpoints must hae Version 1.3.1_08. The runtime enironment enables the distribution and running of resource models. Note: Specialized software for the Jaa Runtime Enironment is required on endpoints that run the OS/400 operating system. The required software is listed in Requirements for OS/400 endpoints on page 21. On Windows, you must install the Windows Jaa Runtime Enironment for all languages must be installed, and not the Jaa Runtime Enironment U.S. English only. Otherwise, you might receie the following message: UnsupportedEncodingException: Cp500 or Cp This problem occurs when the Jaa i18n.jar file is not aailable in the Jaa jre/lib directory. Chapter 7. Completing the installation of the product 95

114 Installation images for the Jaa Runtime Enironment are aailable on the IBM Tioli Monitoring, Version 5.1.1: Tools installation CD. You can choose one of the following setup methods: Use the wdmdistrib command or the Jaa Runtime Enironment manual installation process. The Jaa software for this installation option is aailable on the product CD in compressed format. This procedure describes how to use the wdmdistrib command to install the Jaa Runtime Enironment. If the endpoint already has an appropriate ersion of the Jaa Runtime Enironment installed, perform the procedure Linking to an existing Jaa Runtime Enironment on page 97 to link IBM Tioli Monitoring to the runtime enironment. Use the Tioli Software Installation Serice to install the runtime enironment. After you install the runtime enironment, you must perform the Linking to an existing Jaa Runtime Enironment on page 97 procedure. Limitations of the Jaa installation: On Windows, you must install the Windows Jaa Runtime Enironment for all languages must be installed, and not the Jaa Runtime Enironment U.S. English only. Otherwise, you might receie the following message: UnsupportedEncodingException: Cp500 or Cp This problem occurs when the Jaa i18n.jar file is not aailable in the Jaa jre/lib directory. If you do not install and link the Jaa Runtime Enironment, the deployment of resource models fails. The use of an IBM ersion of the Jaa Runtime Enironment is recommended for support purposes. Operating system prerequisites for the Jaa Runtime Enironment are described in a readme files in the JRE directory on the Tools CD of the IBM Tioli Monitoring installation software. All ersions of the Jaa Runtime Enironment on the IBM Tioli Monitoring CD are supplied by IBM, except for the HP-UX ersion. For the HP-UX operating system, see the installation instructions for HP-UX Runtime Enironment for Jaa 2 Version 1.3.1, which can be found at the following URL: Required authorization role admin, senior, or super. Before you begin Access the Tioli enironment as described in Accessing the Tioli Management Framework enironment on page 81. Prepare the following information for installation of the Jaa Runtime Enironment: List the target computers (endpoints) for the installation of the enironment. Verify that the target computers meet the requirements that are described in readme files in the JRE directory on the Tools CD of the IBM Tioli Monitoring installation software. Ensure that the Tools CD is accessible to the computer on which you run the command. On HP-UX, you must install the following HP-UX patch bundles to enable Jaa support for this product: 96 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

115 Hardware Enablement (HEEnable11i) Base Quality Pack (GOLDBASE11i) Applications Quality Pack (GOLDAPPS11i) If you do not install the patches, point resource models stop running and receie the following error: Receiing Jaa Exception: Time already cancelled error. When you finish None Procedure You can perform this procedure from the command line. Command Line: Run the following command to install the Jaa Runtime Enironment and link it to IBM Tioli Monitoring: wdmdistrib J "JRE_location_dir" l subscriber where JRE_location_dir Specifies the complete path to the directory on a local drie where Jaa Runtime Enironment (JRE) is located on the installation CD (excluding the platform directory). Enclose the path in quotation marks. subscriber Specifies the names of the endpoints to which you want to distribute the software. See the IBM Tioli Monitoring User s Guide for full information on the wdmdistrib command. Linking to an existing Jaa Runtime Enironment Objectie To link the IBM Tioli Monitoring software to an existing Jaa Runtime Enironment. Background information In some cases, the required Jaa Runtime Enironment (Version or 1.3.1, and Version 1.3.1_08 on Solaris) might exist on Tioli endpoints before you install the IBM Tioli Monitoring for Business Integration monitoring software. In these cases, you must run the DMLinkJre task. The Tioli DMLinkJre task enables the endpoint to identify the correct path to existing Jaa software. Running the DMLinkJre task is not required when you use the wdmdistrib command to install the runtime enironment. See Installing the Jaa Runtime Enironment on page 95 for more information on this command. Required authorization role admin, itm_tasks, senior, or super Before you begin Prepare a list of the target computers (endpoints). Confirm the installation path of the Jaa Runtime Enironment on each computer. The installation path must be identical for the instance of the Jaa Runtime Enironment that is running on each endpoint. Chapter 7. Completing the installation of the product 97

116 When you finish Check the task output for messages that report path errors for the Jaa Runtime Enironment. You must correct any error conditions. Procedure You can perform this procedure from the Tioli desktop only. Tioli desktop: 1. Select TMR Connections in the Desktop menu. 2. Select Top Leel Policy Regions in the sub-menu to display the Top Leel Policy Regions window. 3. Double-click the TioliDefaultMw2kRegion icon to display the Policy Region window. Additional Information: When the Tioli enironment includes multiple, interconnected Tioli serers, and when IBM Tioli Monitoring is installed on more than one, you hae multiple policy regions with the name TioliDefaultMw2kRegion. IBM Tioli Monitoring appends the region name to each instance of TioliDefaultMw2kRegion so that they hae unique names. In this step, you should select the instance of TioliDefaultMw2kRegion corresponding to your local Tioli management region. 4. Double-click the IBM Tioli Monitoring Tasks task library icon to display the Task Library window. 5. Double-click the DMLinkJre task icon to display the Execute Task window. 6. Select the endpoint or endpoints that you want to link to the Jaa software. Note: The installation path must be identical for the instance of the Jaa Runtime Enironment that is running on each endpoint. Additional Information: Alternatiely, you can select target endpoints by selecting the profile managers that contain those endpoints. The installation path for the Jaa software on each endpoint must be the same on each target endpoint in that profile. 7. Click Execute to display the Configure Task Arguments window. 8. Type the fully qualified path to the top-leel directory of the Jaa software. Additional Information: For example, if the Jaa software is installed in the /usr/jaa/bin/jaa directory path, type this alue in the text field: /usr/jaa Note: The task alidates the link to the Jaa software and adises you of a path error. The path error becomes eident later, when the distribution of resource models to the endpoint generates an error stating that the Jaa software is missing or not installed. 9. Click Set & Execute. Additional Information: Reiew the messages that the task returns to confirm that all endpoints are successfully linked. When the DMLinkJre task is successful, distribution of a resource model completes without generating an error message. 98 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

117 Loading Managed Object Format (MOF) files into Resource Model Builder Objectie To load Managed Object Format (MOF) files into the Resource Model Builder. Background information The IBM Tioli Monitoring Resource Model Builder is a programming tool for creating, modifying, debugging, and packaging resource models for use with IBM Tioli Monitoring products. Samples of best practice resource models hae also been proided for your use within the Resource Model Builder. You can use these resource models as working examples for creating new resource models. The Frequently asked questions section of the IBM Tioli Monitoring Resource Model Builder: Problem Determination Guide describes how to get assistance with using the tool and with building custom resource models. The IBM Tioli Monitoring Resource Model Builder User s Guide describes how to use the Resource Model Builder. When you customize one of these resource models in the Resource Model Builder, you must associate the new resource model with a class file called a Managed Object Format (MOF) file. This procedure describes how to make the.mof files for IBM Tioli Monitoring for Business Integration aailable to Resource Model Builder. A.mof file is a text file that defines attributes of a managed resource. For example, a queue manager.mof file would include attributes for the queue manager name, local queue information, channel information, and many other characteristics of a queue manager. The.mof file format adheres to the platform-neutral Common Information Model (CIM) standard of the Distributed Management Task Force (DMTF) industry consortium. This standard reduces the cost and complexity of managing computer resources. The Resource Model Builder tool is aailable on Windows only and it must hae access to the resources of the Microsoft Windows Management Instrumentation (WMI) SDK. Information and software for the SDK is aailable through the Microsoft Corporation. Specifically, this procedure uses the MOF Compiler, mofcomp.exe, that comes with the SDK. The SDK comes with Windows On other platforms, you can download the SDK from the Microsoft Web site, if necessary. See the Microsoft Windows Management Instrumentation: Platform SDK online help for more information. Required authorization role You must hae log on priileges to the Windows workstation that runs the Resource Model Builder. Before you begin For Windows NT, ensure that the Microsoft Windows Management Instrumentation (WMI) SDK is installed. If not installed, obtain it from Microsoft Corporation and install it. Access the IBM Tioli Monitoring for Business Integration installation CDs that hae the following labels. They contain the.mof files: IBM Tioli Monitoring for Business Integration: WebSphere MQ Chapter 7. Completing the installation of the product 99

118 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, Version IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer When you finish See IBM Tioli Monitoring Resource Model Builder User s Guide to learn how use the optional Resource Model Builder tool. You use the Resource Model Builder to create resource models based on the standard resource models that come with IBM Tioli Monitoring for Business Integration. Procedure You can perform this procedure from the command line only. Command line: 1. Access the mofcomp.exe executable in the following directory path: %SystemRoot%\system32\wbem 2. Run the following command: mofcomp -N:\Root\Cim2 mof_file_name where mof_file_name is the name of a.mof file for IBM Tioli Monitoring for Business Integration. \Root\Cim2 refers to the namespace in the class repository that includes resource model information. Additional Information: The product.mof files are deliered on the Component Software CDs in the /WORKBENCH directory. The WORKBENCH directory may contain multiple ersions of the.mof files. For the Resource Model Builder, install only.mof files that are located in the root WORKBENCH directory. The.mof files are shipped on the following CDs: IBM Tioli Monitoring for Business Integration - WebSphere MQ IBM Tioli Monitoring for Business Integration - WebSphere MQ Integrator, Version IBM Tioli Monitoring for Business Integration - WebSphere InterChange Serer For example, the.mof files for the WebSphere InterChange Serer are named crossworlds.xmof and ITMException.xmof. Installing files to enable Tioli Enterprise Data Warehouse Objectie To prepare and configure the Tioli Data Warehouse to accept data from IBM Tioli Monitoring for Business Integration and to support reporting of that information. Background information Obtain the twh_app_install_list.cfg file for the ETL1 program. You install this file to support reporting for IBM Tioli Monitoring for Business Integration applications. Table 30 on page 101 tells where to find this file on the installation CD. Obtain each ersion of the twh_app_install_list.cfg file for the components that you want to install. Table 30 on page 101 lists the CD location of the files that correspond to specific applications that you can monitor. When you install these 100 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

119 files, Tioli Enterprise Data Warehouse can accept data from the corresponding application and generate reports that use that information. Table 30. Locations of Tioli Enterprise Data Warehouse configuration files Software Program CD name/ Directory path for the twh_app_install_list.cfg file ETL1 IBM Tioli Monitoring, Version Directory path: /tedw_app_etl/amx ETL2 IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software Directory path: /tedw_app_etl/ctq (This file corresponds to the base WebSphere MQ software) Directory path: /tedw_app_etl/biw (This file corresponds to the MQ Workflow addition) IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software Directory path: /tedw_app_etl/hmi IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software Directory path: /TEDW/tedw_app_etl/bix To assist in planning for the IBM Tioli Monitoring for Business Integration warehouse additions, especially for database sizing considerations, see the appropriate warehouse enablement pack documentation: IBM Tioli Monitoring for Business Integration: WebSphere MQ Warehouse Enablement Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Workflow Warehouse Enablement Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Warehouse Enablement Guide IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Warehouse Enablement Guide Required authorization role superadmin for the Tioli Enterprise Data Warehouse enironment. Before you begin Install Tioli Enterprise Data Warehouse and the required DB2 database software (IBM DB2 Uniersal Database Enterprise Edition) as described in the Installing and Configuring Tioli Enterprise Data Warehouse, Version 1, Release 1 Guide. When you finish Run ETL processes to extract, transform, and load data from WebSphere MQ, WebSphere MQ Integrator, Workflow, and WebSphere InterChange Serer. Generate tabular and graphical reports as described in the IBM Tioli Monitoring for Business Integration User s Guide. Install and configure the Tioli Enterprise Data Warehouse Support Component. See the Integration with Tioli Enterprise Data Warehouse chapter in the IBM Tioli Monitoring User s Guide for details. You must install this component first on the Tioli management region serer and then on all managed nodes. Procedure You perform this procedure using the Tioli Enterprise Data Warehouse installation program. Chapter 7. Completing the installation of the product 101

120 Installation wizard: 1. Log on to the computer that runs Tioli Enterprise Data Warehouse. Additional Information: On Windows, the user who runs the installer must hae membership in the Administrators group. 2. Run the setup executable in the root directory of the Tioli Enterprise Data Warehouse installation CD. Additional Information: The executable launches the installation wizard. Select the executable that matches your operating system: For Windows, setup.exe For UNIX, setup_unix.sh 3. Install the IBM Tioli Monitoring, Version warehouse pack that proides the central data warehouse ETL1 that extracts data and loads it into the central data warehouse by doing the following (This warehouse pack ships on the IBM Tioli Monitoring, Version CD): a. Click Next to display the installation options panel. b. Select Application Installation only. c. Select the directory path where you want to install the program. Additional Information: You must install the warehouse pack in the installation directory for Tioli Enterprise Data Warehouse. d. Click Next. e. Type the host name. Additional Information: The wizard requires the fully qualified host name for the computer. For example, the fully qualified host name for myhost might be myhost.mycompany.com. f. Type the user name and password for configuring DB2. g. Type the directory path for the warehouse pack configuration file. Additional Information: The twh_app_install_list.cfg configuration file for this warehouse pack is located on the CDs listed in Table 30 on page 101. h. Select Now to erify the source directory immediately. i. Click Next. j. If the wizard detects a path error, modify the source directory path and click Next again. k. Click Next. Additional Information: This procedure does not require use of the option to install additional packages. The wizard displays a summary of the program installation, including disk space required. l. Click Install. m. Click Finish in the final summary screen. Additional Information: For troubleshooting information, see the troubleshooting chapter in Installing and Configuring Tioli Enterprise Data Warehouse, Version 1, Release 1, Guide. 4. Perform the following steps to install the IBM Tioli Monitoring for Business Integration warehouse pack for WebSphere MQ, WebSphere MQ Integrator, or WebSphere MQ Workflow. A warehouse pack that proides the data mart ETL2 that extracts data from the central data warehouse for use in tabular and graphical reports. See Table 30 on page 101 for a list of the corresponding CDs. a. Repeat Steps 1 and 2 to re-launch the Tioli Enterprise Data Warehouse installation wizard. 102 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

121 b. Click Next to display the installation options panel. c. Select Application Installation only. d. Select the directory path where you want to install the program. e. Click Next. f. Type the host name. Additional Information: The wizard requires the fully qualified host name for the computer. For example, the fully qualified host name for myhost might be myhost.mycompany.com. g. Determine which warehouse pack you want to install and type the directory path for the its configuration file. h. Type the directory path of the program files. Additional Information: The corresponding twh_app_install_list.cfg configuration files are located on the CDs listed in Table 30 on page 101. i. Select Now to erify the source directory immediately. j. Click Next. k. If the wizard detects a path error, modify the source directory path and click Next again. l. Click Next. Additional Information: This procedure does not require use of the option to install additional packages. The wizard displays a summary of the program installation, including disk space required. m. Click Install. n. Click Finish in the final summary screen. Additional Information: The twh.log file lists eents that occur during the installation. This file is located in the directory containing the installed Tioli Enterprise Data Warehouse program. By default, this directory path is C:\Program Files\TWH. The Enironment tab of the Windows System Properties control panel displays the path alue for the enironment ariable TWH_TOPDIR in your installation. 5. Stop and restart the following serices for Tioli Presentation Serices: Serer for IBM Console Web Serices for the IBM Console See the Starting and stopping Tioli Presentation Serices appendix in Installing and Configuring Tioli Enterprise Data Warehouse, Version 1, Release 1 Guide for further information. 6. If necessary, perform final configuration tasks to enable reporting. See the chapter on creating reports in the IBM Tioli Monitoring for Business Integration User s Guide. Installing IBM Tioli Language Support for this product Objectie To install language support packages to enable one or more of the nine aailable national language ersions. Background information By default, IBM Tioli Monitoring for Business Integration is enabled in English. To enable other languages, install the appropriate language support pack from one Chapter 7. Completing the installation of the product 103

122 of the Language Support installation CDs for each product component. You can install multiple language support packages for a single product. The language support for ITM comes on the IBM Tioli Monitoring Language Support CD. The language support for product components comes on these CDs: IBM Tioli Monitoring for Business Integration: WebSphere MQ, Version Language Support IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, Version Language Support IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer, Version Language Support Language support packages exist for the languages listed in Table 31. The table also shows product-name prefixes and language-support suffixes. You append the string.ind to a prefix to form the complete.ind file name. For example, the following.ind files contain German language support packages for IBM Tioli Monitoring for Business Integration: MQS_DE.IND is the name of the German language support package for Monitoring for WebSphere MQ. BIW_DE.IND is the name of the German language support package for Monitoring for WebSphere MQ Workflow. HMI_DE.IND is the name of the German language support package for Monitoring for WebSphere MQ Integrator. BIX_DE.IND is the name of the German language support package for WebSphere InterChange Serer. AMW_DE.IND is the name of the German language support package for IBM Tioli Monitoring. Table 31. Language support and names of corresponding installation index (.IND) files Language Brazilian Portuguese Chinese (simplified) Chinese (traditional) Prefix for Monitoring for WebSphere MQ Prefix for Monitoring for WebSphere MQ WorkFlow component Prefix for Monitoring for WebSphere MQ Integrator Prefix for Monitoring for WebSphere InterChange Serer Prefix for IBM Tioli Monitoring MQS_PTBR BIW_PTBR HMI_PTBR BIX_PTBR AMW_PT_B MQS_ZHCH BIW_ZHCH HMI_ZHCH BIX_ZHCH AMW_ZH_C MQS_ZHTW BIW_ZHTW HMI_ZHTW BIX_ZHTW AMW_ZH_T French MQS_FR BIW_FR HMI_FR BIX_FR AMW_FR German MQS_DE BIW_DE HMI_DE BIX_DE AMW_DE Italian MQS_IT BIW_IT HMI_IT BIX_IT AMW_IT Japanese MQS_JA BIW_JA HMI_JA BIX_JA AMW_JA Korean MQS_KO BIW_KO HMI_KO BIX_KO AMW_KO Spanish MQS_ES BIW_ES HMI_ES BIX_ES AMW_ES 104 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

123 Some command line and keyword options are not translated in the language support packages. This approach aoids any programming complexities for scripts that can run under multiple locales. Run the scripts under the locale in which the retrieed data is stored. The following documents on the installation CDs for Tioli Management Framework proide more information on the role of language packs in Tioli products: Chapter 2 Internationalization in the Tioli Enterprise Installation Guide Release Notes Required authorization role install_product. Before you begin As a precautionary measure, back up the Tioli management region as described in Backing up and restoring Tioli databases on page 38. Start the command line interface or Tioli desktop as described in Accessing the Tioli Management Framework enironment on page 81. You must hae the following: A list of managed nodes on which product must be installed. The list should include all gateways. All language support CDs IBM Tioli Monitoring Language Support V5.1.1 IBM Tioli Monitoring for Business Integration: WebSphere MQ, Version Language Support IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator, Version Language Support IBM Tioli Monitoring for Business Integration: WebSphere Interchange Serer, Version Language Support When you finish The installer enables language support for the Web Health Console automatically. If you manually installed the console, see Installing the Web Health Console manually on page 128. Procedure You can perform this procedure from the Tioli desktop or from the command line. Command line: 1. Insert the language support installation CDs listed in Background information. 2. Access the Tioli command line interface as described in Accessing the Tioli Management Framework enironment on page Execute the following command: winstall -c /cdromdrie -i INDFILENAME y where INDFILENAME is the language you want to install and cdromdrie is the path to the location of the.ind files. Additional Information: When the command completes, the message Finished Product Installation is displayed. 4. Repeat Step 3 to install additional language support packages. Chapter 7. Completing the installation of the product 105

124 Refer to the Tioli Management Framework Reference Manual for more information about the winstall command. Refer to Tioli command syntax on page x for information on Tioli command line syntax. Tioli desktop: 1. Select Install in the Desktop menu. 2. Select Install Product in the sub-menu to display the Install Product window. 3. If necessary, click OK to bypass a harmless error message about the media settings. 4. Click Select Media to display the File Browser window. 5. In the Path Name text field, enter the full path to the language support files in the CD-ROM drie. Be sure to use backward slashes (\) for Windows path names instead of forward slashes (/). 6. Click Set Path to refresh the iew. Additional Information: The Directories list displays.cfg files and the Files list displays the.ind files that include the names of all nine languages. 7. Click Set Media & Close to return to the Install Product window. 8. Select the language that you want to install in the Select Product to Install list. For example, select IBM Tioli Monitoring for Business Integration, Version WebSphere MQ Integrator [de] German language to choose German language support for installation. 9. Select the target clients on which to install the language from the Aailable Clients scrolling list. 10. Click the right arrow to moe the selected clients to the Clients to Install On scrolling list. 11. Click Install & Close to launch the installation progress window. 12. Click Continue Install when the prompt is displayed. 13. Click Close when the Finished Product Installation message is displayed. 14. Repeat these steps to install another language support package. Updating Web Health Console files Objectie To update the Web Health Console files when you install a new component or upgrade IBM Tioli Monitoring for Business Integration. Background information This procedure describes how to update the class files for the Web Health Console when you add a component of the product. The class files specify the standard text that the console displays. Wheneer you add or upgrade components for your installation of IBM Tioli Monitoring for Business Integration you must perform this procedure. For example, if you upgrade the product to a later release, you must update the class files located on the computer that hosts the Web Health Console. The new class files become aailable after you restart the Web Application Serer that enables the console. When you install the Web Health Console for the first time, the installer automatically installs the required class files and this procedure is not necessary. When you install the product without using the installer, use the procedure Installing the Web Health Console manually on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

125 Required authorization role Logon priileges for the computer that hosts the Web Health Console. Before you begin Obtain the following CDs: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Component Software IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Component Software When you finish Restart the console s Web application serer to make the new class files aailable. Procedure You can perform this procedure from the command line only. Command line: 1. Copy the contents of the HCONSOLE directory of catalog files from one of the following installation CDs: For the English language updates to IBM Tioli Monitoring, copy catalog files from the IBM Tioli Monitoring V5.1.1 installation CD. For the English language updates to IBM Tioli Monitoring for Business Integration, copy catalog files from the IBM Tioli Monitoring for Business Integration installation CDs that are labeled Component Software. For other languages, copy catalog files from the IBM Tioli Monitoring for Business Integration: Language Support installation CDs. 2. Insert the contents of the HCONSOLE directory in the following resources directory on the target computer that hosts the Web Health Console: INSTALL_DIR/installedApps/dm.ear/dm.war/WEB-INF/classes/com/tioli/ \ DmForNt/resources Integrating the product with Tioli Inentory Optionally, you can integrate Tioli Manager for MQSeries with Tioli Inentory so that you can sae and restore an MQSeries configuration to and from the Tioli Inentory database. You can also clone saed MQSeries configurations to Tioli endpoints in your network. You must hae Tioli Inentory 4.0/4.1 or Inentory 4.2 which is a part of the Tioli Configuration Manager installed to use this feature. This function does not support Inentory operations for OS/400 endpoints. Once Tioli Inentory is installed, the MQSeries database schema supplied by IBM Tioli Monitoring for Business Integration: WebSphere MQ must be installed on the database. The database schema defines the tables and the iews in the Tioli Inentory database for the WebSphere MQ queue manager attributes. Also, to begin using the database after the install of the schema requires the creation of the MQSeries Inentory Policy Region on the desktop. The Create Inentory Policy Region task does the following: Creates a policy region named MQSeries Inentory in the Manager for MQSeries policy region. Creates a query library named MQSeries Inentory Queries in the MQSeries Inentory policy region. Chapter 7. Completing the installation of the product 107

126 The query library contains a number of installed SQL queries that Tioli Manager for MQSeries uses. Do not edit the installed SQL queries. If you want to run queries on the Tioli Inentory data, create your own query library and queries. Creates a task library named MQSeries Inentory Tasks in the MQSeries Inentory policy region. Tasks in the MQSeries Inentory Tasks library enable you to sae or restore MQSeries configuration data. Jobs are also proided so that you can schedule a sae or restore of MQSeries configuration data. Creates a dataless profile manager named MQSeries Inentory Profiles in the MQSeries Inentory policy region. Subscribers to this profile manager are endpoints only. The MQSeries Inentory tasks create the subscribers. You do not need to specify subscribers to this profile manager, and you should not change, delete, or rename this profile manager. The MQSeries Inentory Tasks library includes the following jobs: Schedule_Inentory_Sae Use this job to schedule the sae operation for a queue manager configuration. Schedule_Inentory_Restore Use this job to schedule the restore operation of a queue manager configuration. The following Inentory tasks are aailable from the Queue Manager Control Center dialog: Sae Saes the current queue manager configuration data to the Tioli Inentory database, replacing any preious database information. The data includes queue manager objects (queues, channels, processes, and name lists) and attributes. The queue manager must be running to perform this operation. Restore Extracts the current queue manager configuration data from the Tioli Inentory database and replaces the currently installed queue manager object definitions. The Restore operation recreates all the objects defined in the Tioli Inentory database. If objects hae been created in the queue manager that are not stored in the Tioli database, the objects are deleted from the queue manager. The queue manager must be stopped to use this operation. Clone Delete Clones a selected saed queue manager configuration to another endpoint. The clone operation enables you to create an identical queue manager with a new name on selected endpoints. Deletes queue manager configuration data from the Tioli Inentory database. You can use this operation if you deleted the queue manager, but the configuration data still exists in the Tioli Inentory database. Display Displays the saed configuration data for a selected queue manager. I Note: Version 4.0/4.1 of Tioli Inentory was a separate product. Subsequent to that ersion, Tioli Inentory became a component in the following product: IBM Tioli Configuration Manager, Version IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

127 1. To begin, you must install the Tioli Inentory 4.0/4.1 or Tioli Inentory found in IBM Tioli Configuration Manager, Version 4.2. This installation defines the database endor, inentory database name, inentory RIM objects, and base inentory tables to perform hardware scans of your endpoints. Once Tioli Inentory is installed proceed with the next step to install the WebSphere MQ schemas on top of the inentory base tables. 2. Install the WebSphere MQ database schemas based on one of the databases supported in the following list. These schemas define the WebSphere MQ tables and the iews in the Tioli Inentory database. For DB2, Installing the DB2 WebSphere MQ database schema For Microsoft SQL, Installing the Microsoft SQL WebSphere MQ database schema on page 111 For Oracle, Installing the Oracle WebSphere MQ database schema on page 112 For Sybase, Installing the Sybase WebSphere MQ database schema on page Finally, you must then create the MQSeries Inentory policy region to enable Monitoring for WebSphere MQ to work with Tioli Inentory. See Creating the MQSeries Inentory policy region on page 115. Installing the DB2 WebSphere MQ database schema Objectie To install the DB2 WebSphere MQ database schema. Background information You must perform the tasks described in this procedure for any one of the following reasons: You are installing the WebSphere MQ database schema for the first time. You are upgrading from Version or 5.1.0, and you want to use the configuration data that was preiously saed in the Tioli Inentory 4.0/4.1 database. For users who hae saed data using Tioli Inentory 3.6.x, there is no upgrade path to migrate your data to the new Inentory 4.0/4.1 or 4.2 database. You must follow the same steps described aboe as a new user installing this function for the first time. Required authorization roles super Before you begin Tioli Inentory must be installed. You must hae logon user IDs and passwords for the database. When you finish After you install the DB2 WebSphere MQ database schema, create the MQSeries Inentory policy region as described in Creating the MQSeries Inentory policy region on page 115. Procedure 1. Do one of the following: If you are installing the DB2 WebSphere MQ database schema for the first time, copy the mqs_db2_schema40.sql script from the $BINDIR/../generic_unix/TME/MQS/sql directory on the Tioli serer to a temporary directory in which you can run DB2 on the DB2 serer: Chapter 7. Completing the installation of the product 109

128 OR If you are upgrading from the preious release and hae saed configuration data in the DB2 database, copy the mqs_db2_upgrade_schema40.sql script from the directory on the Tioli serer to a temporary directory in which you can run DB2 on the DB2 serer. Note: The upgrade is adding support for Version 5.3 Queue Managers. 2. Create a connection to the DB2 serer database before running the script. Enter the following command: db2 connect to database_name user user_name using password Where: database_name Specifies the name or alias name of the Tioli Inentory database. user_name Specifies the name of the user who owns the Tioli Inentory database. password Specifies the password of the specified user. 3. Do one of the following: If you are installing the database schema for the first time, run the mqs_db2_schema40.sql script. OR If you are upgrading from the preious release, run the mqs_db2_upgrade_schema40.sql script. From the directory in which you copied the mqs_db2_schema40.sql or the mqs_db2_upgrade_schema40.sql script, enter the following command: db2 f script_name o t z mqs_db2_schema40.log Where: script_name Is mqs_db2_schema40.sql or mqs_db2_upgrade_schema40.sql. This command installs the WebSphere MQ database schema. This command also directs the output to the screen, specifies a semicolon as the delimiter at the end of a statement, and logs the output in the specified log file. The success or failure of the SQL statements is logged in the log file. 4. Test the connection between the RIM host and the RDBMS serer and erify that the WebSphere MQ database schema has been created as follows: a. On the RIM host, start an interactie SQL session. Enter the following command: db2 b. Test that the RIM host can connect to the Tioli Inentory database on the DB2 serer. Enter the following command: connect to alias_name user user_name using password Where: alias_name user_name Specifies the alias name of the database in the system database directory. Specifies the user ID that owns the serer database. 110 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

129 password Specifies the password associated with the user ID specified in the username field. c. In the DB2 session, test that the configuration repository was installed. Enter the following command: select * from AUTHINFO Results should indicate that zero rows were found. If results indicate that the iew AUTHINFO is unknown, the WebSphere MQ database schema was not installed properly. Check the log files for more information. d. To log out of the DB2 session, enter the following command: quit Installing the Microsoft SQL WebSphere MQ database schema Objectie To install the Microsoft SQL WebSphere MQ database schema. Background information You must perform the tasks described in this procedure for any one of the following reasons: You are installing the WebSphere MQ database schema for the first time. You are upgrading from Version or 5.1.0, and you want to use the configuration data that was preiously saed in the Tioli Inentory 4.0/4.1 database. For users who hae saed data using Tioli Inentory 3.6.x, there is no upgrade path to migrate your data to the new Inentory 4.0/4.1 or 4.2 database. You must follow the same steps described aboe as a new user installing this function for the first time. Required authorization roles super Before you begin Tioli Inentory must be installed. You must hae logon user IDs and passwords for the database. When you finish After you install the Microsoft SQL WebSphere MQ database schema, create the MQSeries Inentory policy region as described in Creating the MQSeries Inentory policy region on page 115. Procedure 1. Do one of the following: If you are installing the Microsoft SQL WebSphere MQ database schema for the first time, copy the mqs_ms_sql_schema40.sql script from the $BINDIR/../generic_unix/TME/MQS/sql directory on the Tioli serer to a temporary directory in which you can run isql on the RIM host. OR If you are upgrading from the preious release and hae saed configuration data in the Microsoft SQL database, copy the mqs_ms_upgrade_schema40.sql script from the directory on the Tioli serer in which you saed the configuration data to a temporary directory in which you can run isql on the RIM host. 2. Do one of the following: Chapter 7. Completing the installation of the product 111

130 If you are installing the database schema for the first time, run the mqs_ms_sql_schema40.sql script. OR If you are upgrading from a preious release, run the mqs_ms_upgrade_schema40.sql script. From the directory in which you copied the mqs_ms_sql_schema40.sql or the mqs_db2_upgrade_schema40.sql script, enter the following command: isql U database_user_id [ P password] i script_name o mqs_ms_sql_schema40.log Where: password Specifies the RDBMS password that is set for the MS SQL Serer user ID. script_name Is mqs_ms_sql_schema40.sql or mqs_ms_upgrade_schema40.sql. The WebSphere MQ database schema is installed, and output is logged to the specified log file. The success or failure of the SQL statements is logged in the log file. 3. Test the connection between the RIM host and the RDBMS serer and erify that the WebSphere MQ database schema has been installed as follows: a. From the RIM host, test that the MS SQL Serer user ID is a alid user and that the RIM host can connect to the RDBMS. Enter the following command: isql U database_user_id P password Where password is the RDBMS password that is set for the MS SQL Serer user ID. b. In the isql session, test that the configuration repository was installed. Enter the following sequence of commands: select * from AUTHINFO go Results should indicate that zero rows were found. If results indicate that the iew AUTHINFO is unknown, the WebSphere MQ database schema was not installed properly. Check the log files for more information. c. To log out of the isql session, enter the following command: exit Installing the Oracle WebSphere MQ database schema Objectie To install the Oracle WebSphere MQ database schema. Background information You must perform the tasks described in this procedure for any one of the following reasons: You are installing the WebSphere MQ database schema for the first time. You are upgrading from Version or 5.1.0, and you want to use the configuration data that was preiously saed in the Tioli Inentory 4.0/4.1 database. For users who hae saed data using Tioli Inentory 3.6.x, there is no 112 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

131 upgrade path to migrate your data to the new Inentory 4.0/4.1 or 4.2 database. You must follow the same steps described aboe as a new user installing this function for the first time. Required authorization roles super Before you begin Tioli Inentory must be installed. You must hae logon user IDs and passwords for the database. When you finish After you install the Oracle WebSphere MQ database schema, create the MQSeries Inentory policy region as described in Creating the MQSeries Inentory policy region on page 115. Procedure 1. Do one of the following: If you are installing the Oracle SQL WebSphere MQ database schema for the first time, copy the mqs_ora_schema40.sql script from the $BINDIR/../generic_unix/TME/MQS/sql directory on the Tioli serer to a temporary directory on the RDBMS serer or the RIM host. OR If you are upgrading from the preious release and hae saed configuration data in the Oracle WebSphere MQ database, copy the mqs_ora_upgrade_schema40.sql script from the directory on the Tioli serer in which you saed the configuration data to a temporary directory on the RDBMS serer or the RIM host. Note: The upgrade is adds support for Version 5.3 Queue Managers. 2. From the directory in which you copied the mqs_ora_schema40.sql or the mqs_ora_upgrade_schema40.sql script, start an SQL*Plus session and log in to the RDBMS serer as the RDBMS user ID. Enter the following command: sqlplus database_user_id/password Where password is the RDBMS password that is set for the Oracle user ID. 3. To capture the log information into a file, enter the following command: spool mqs_ora_schema40.log 4. Do one of the following: If you are installing the database schema for the first time, run the mqs_ora_schema40.sql script. OR If you are upgrading from the preious release, run the mqs_ora_upgrade_schema40.sql script. In the SQL*Plus session, enter the following Where script_name is mqs_ora_schema40.sql or mqs_ora_upgrade_schema40.sql. The script installs the WebSphere MQ database schema. The success or failure of the SQL statements is logged in the log file. 5. To log out of SQL*Plus, enter the following command: Chapter 7. Completing the installation of the product 113

132 quit 6. Test the connection between the RIM host and the RDBMS serer and erify that the WebSphere MQ database schema has been created as follows: a. From the RIM host, test that the Oracle user ID is a alid user and that the RIM host can connect to the Tioli Inentory database on the Oracle serer. Enter the following command: sqlplus database_user_id/password Where password is the RDBMS password that is set for the Oracle user ID. b. In the SQL*Plus session, test that the WebSphere MQ database schema was installed in the Oracle RDBMS. Enter the following command: select * from AUTHINFO Results should indicate that zero rows were found. If results indicate that the iew AUTHINFO is unknown, the WebSphere MQ database schema was not installed properly. Check the log files for more information. c. To log out of SQL*Plus, enter the following command: quit Installing the Sybase WebSphere MQ database schema Objectie To install the Sybase WebSphere MQ database schema. Background information You must perform the tasks described in this procedure for any one of the following reasons: You are installing the WebSphere MQ database schema for the first time. You are upgrading from Version or 5.1.0, and you want to use the configuration data that was preiously saed in the Tioli Inentory 4.0/4.1 database. For users who hae saed data using Tioli Inentory 3.6.x, there is no upgrade path to migrate your data to the new Inentory 4.0/4.1 or 4.2 database. You must follow the same steps described aboe as a new user installing this function for the first time. Required authorization roles super Before you begin Tioli Inentory must be installed. You must hae logon user IDs and passwords for the database. When you finish After you install the Sybase WebSphere MQ database schema, create the MQSeries Inentory policy region as described in Creating the MQSeries Inentory policy region on page 115. Procedure 1. Do one of the following: If you are installing the Sybase SQL WebSphere MQ database schema for the first time, copy the mqs_syb_schema40.sql script from the $BINDIR/../generic_unix/TME/MQS/sql directory in which you can run isql on the RDBMS serer or the RIM host. 114 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

133 OR If you are upgrading from the preious release and hae saed configuration data to the Sybase WebSphere MQ database, copy the mqs_syb_upgrade_schema40.sql script from the directory on the Tioli serer in which you saed the configuration data to a temporary directory in which you can run isql on the RIM host. Note: The upgrade adds support for Version 5.3 Queue Managers. 2. Do one of the following: If you are installing the database schema for the first time, run the mqs_syb_schema40.sql script. OR If you are upgrading from a preious release, run the mqs_syb_upgrade_schema40.sql script. Enter the following command: isql U database_user_id P password i script_name o mqs_syb_schema40.log Where: password Is the RDBMS password that is set for the Sybase user ID. script_name Is mqs_syb_schema40.sql or mqs_syb_upgrade_schema40.sql. The script installs the database schema and logs the output to the specified file. 3. Test the connection between the RIM host and the RDBMS serer and erify that the WebSphere MQ database schema has been created as follows: a. From the RIM host, test that the Sybase user ID is alid and that the RIM host can connect to the Sybase RDBMS. Enter the following command: isql U database_user_id P password Where password is the RDBMS password that is set for the Sybase user ID. b. In the isql session, test that the database schema was installed in the Sybase RDBMS. Enter the following sequence of commands: select * from AUTHINFO go Results should indicate that zero rows were found. If results indicate that the iew AUTHINFO is unknown, the WebSphere MQ database schema was not installed properly. Check the log files for more information. c. To log out of isql, enter the following command: quit Creating the MQSeries Inentory policy region Objectie To create the MQSeries Inentory policy region. Background information Creating the MQSeries Inentory policy region does the following: Creates a policy region named MQSeries Inentory in the Monitoring for WebSphere MQ policy region. Chapter 7. Completing the installation of the product 115

134 Creates a query library named MQSeries Inentory Queries in the MQSeries Inentory policy region. The query library contains a number of installed SQL queries that Monitoring for WebSphere MQ uses. Do not edit the installed SQL queries. If you want to run queries on the Tioli Inentory data, create your own query library and queries. For more information about creating a query library, refer to the Tioli Management Framework User s Guide. The following authorization roles are required to create queries from information in the Tioli Inentory database: senior super Query_execute Query_edit Creates a task library named MQSeries Inentory Tasks in the MQSeries Inentory policy region. Tasks in the MQSeries Inentory Tasks task library enable you to sae or restore WebSphere MQ configuration data. Jobs are also proided so that you can schedule a sae or restore of WebSphere MQ configuration data. For more information, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Creates a dataless profile manager named MQSeries Inentory Profiles in the MQSeries Inentory policy region, which contains the MQS_Scans profile that is used for Tioli Inentory scans. The MQSeries Inentory tasks create the subscribers to the MQSeries Inentory Profiles profile manager. You do not need to specify subscribers to this profile manager, and you should not change, delete, or rename this profile manager. Required authorization roles MQS_senior and super Before you begin Install the WebSphere MQ database schema using the procedure that corresponds to the database type that you use: Installing the DB2 WebSphere MQ database schema on page 109 OR Installing the Microsoft SQL WebSphere MQ database schema on page 111 OR Installing the Oracle WebSphere MQ database schema on page 112 OR Installing the Sybase WebSphere MQ database schema on page 114 When you finish For information about how to sae, clone, restore, display, and delete WebSphere MQ configurations, refer to the information on Inentory tasks in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. Procedure To create the MQSeries Inentory policy region from the desktop, follow these steps: 1. Right-click the Monitoring for WebSphere MQ icon and select Create Inentory Policy Region from the icon s context menu. 2. Complete the Create Inentory Policy Region window: a. In the Inentory Scan RIM Object Name field, do one of the following: 116 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

135 Accept the default name, indh_1, as the name of your Tioli Inentory Scan RIM Object. OR If you hae renamed or created other Tioli Inentory RIM objects for the inentory data handler, change the default alue to the name of your inentory data handler RIM object you would like to use. b. In the Inentory Query RIM Object Name field, do one of the following: Accept the default name, in_query, as the name of your Tioli Inentory Query RIM Object. OR If you hae renamed or created other Tioli Inentory Query RIM objects, change the default alue to the name of your Query RIM object you would like to use. Run the Create Inentory Policy Region task again if you want to change the Tioli Inentory Scan or Query RIM object names. Note: If your enironment contains interconnected Tioli management regions and one of those regions contains an MQSeries Inentory policy region and you want to create an MQSeries Inentory policy region in another Tioli management region, you must disconnect the region in which you want to create the MQSeries Inentory policy region. Failure to do so will cause the Create Inentory Policy Region task to fail. Chapter 7. Completing the installation of the product 117

136 118 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

137 Chapter 8. Expanding your Tioli enironment Before or after you install the product, either by using the installer or by performing manual installations, you might want to add managed nodes, endpoints, or installations of the IBM Tioli Monitoring Web Health Console to your Tioli enironment. This chapter describes how to add managed nodes, endpoints, or installations of the Web Health Console without using the installer. The following examples describe situations that require expansion of your Tioli enironment: After using the installer to set up your initial configuration, you manually installed IBM Tioli Monitoring for Business Integration component software on additional serers that are not Tioli endpoints. You need to install the Tioli endpoint software on these computers before you can use the product to manage applications. Your management enironment has expanded so you want to add Tioli managed nodes and gateways. You decide to add the managed nodes and gateways from the Tioli command line or desktop before installing all the necessary software (including IBM Tioli Monitoring for Business Integration on some or all of the additional computers). The monitoring staff at your company has grown and they need access to the IBM Tioli Monitoring Web Health Console to obsere real-time status of managed resources. You need to install the Web Health Console on additional machines and then install the IBM Tioli Monitoring for Business Integration software on these machines. Table 32 summarizes the procedures for adding managed nodes, endpoints, and installations of the Web Health Console to your Tioli enironment. Table 32. Guidelines for expanding your Tioli enironment Goal Access the Tioli enironment as the first step for performing any of the procedures described in this chapter. Install managed nodes to assist the Tioli serer with management and monitoring operations. Install endpoint software to enable target computers to communicate in the Tioli enironment. (Optional) Change the gateway assignment for an endpoint. Install the IBM Tioli Monitoring Web Health Console on computers to display real-time status of managed resources. Refer to Accessing the Tioli Management Framework enironment on page 81 Installing managed nodes through an existing Tioli enironment on page 119 Installing endpoints through an existing Tioli enironment on page 123 Changing the gateway assignment of an endpoint on page 127 Installing the Web Health Console manually on page 128 See the IBM Tioli Monitoring User s Guide for information about using the Web Health Console. Installing managed nodes through an existing Tioli enironment Objectie To install managed nodes using an existing Tioli user interface. Copyright IBM Corp. 2002,

138 Background information This procedure enables you to install and set up managed nodes without using the Typical or Ealuation installation options in the installer. This procedure uses the default settings for a managed node. See the Tioli Enterprise Installation Guide to learn how to oerride the defaults. Required authorization role super or install_client Before you begin As a precautionary measure, back up the Tioli management region as described in Backing up and restoring Tioli databases on page 38. Start the command line interface or Tioli desktop as described in Accessing the Tioli Management Framework enironment on page 81. If you hae a UNIX Tioli management region serer and you want to create Windows managed nodes, you need to install the Tioli Remote Execution Serice (TRIP) process on the Windows system. This does not apply to Windows Tioli management region serer. When you finish None Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Use the wclient command to create a managed node. wclient -c <CD_path> -d -p <policy_region> <managed_node> where -c <CD_path> Specifies the path to the Tioli Management Framework installation CD. d Sets installation ariables to their last set alues. Commonly, each installed managed node uses the same set of installation ariables. This option proides a shortcut for setting the ariables. In this case, the managed node obtains settings for the installation ariables from the Tioli serer. p <policy_region> Specifies the policy region with which the managed node will be associated. <managed_node> Specifies the host name of the new managed node. After creating a managed node on a Windows NT or Windows 2000 system, you must reboot the system to complete the installation. Each managed node must hae a gateway to enable communication with endpoints. Use the wcrtgate command to create a gateway on the managed node. The following command creates a gateway on managed node eerest using the default settings: wcrtgate -h eerest 120 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

139 After creating the gateway, you can configure its behaior as a repeater and as a ehicle for software distribution using the wrpt and wmdist commands. For additional information on these commands see the Tioli Management Framework Reference Manual. See Tioli command syntax on page x for information on Tioli command line syntax. Tioli desktop: 1. From the Tioli desktop, open the policy region where you want to create the managed node. 2. From the Create menu, click Managed Node to display the Client Install window. Additional Information: The managed node is created in the current policy region. See the Tioli Enterprise Installation Guide to learn about creating managed nodes in other policy regions. 3. In the TMR Installation Password field, type the installation password. Additional Information: If a password was not specified when the Tioli management region serer was created, leae this field empty. If a password was specified, you must use this password for each managed node. 4. Select the radio button in the Default Access Method area to indicate how the Tioli management region contacts each system: Account In the Account field, type the name and password of the priileged user to contact the system. In the Password field, type the password for this user. This option applies to UNIX, Windows NT, and Windows 2000 systems. Trusted Host (UNIX only) For trusted host access, the /.rhost file on each system must grant access to the system performing the installation by adding an entry for root@hostname, where hostname is the host name of the Tioli management region serer or managed node performing the installation. Note: You can oerride the access method when you add a single system, load systems from a file, or after the systems are added to the list. 5. Click Add Clients. 6. Configure the client as follows: a. In the Add Client field, type the name of the system you want to configure as a managed node. b. Specify the access method that the Tioli management region serer uses to contact the system: Select Use Default Access Method to use the default access method that you specified in Step 4. OR Select Account to use account access. OR Select Trusted Host Access to use trusted host access in UNIX. c. Click Add & Close to add the system to the list and return to the Client Install window. 7. Repeat Steps 5 and 6 for each computer that you want to configure as a managed node. 8. If you need to change the access method for any of the listed systems, perform the following steps in the Client Install window: a. Select the system to change. Chapter 8. Expanding your Tioli enironment 121

140 b. Click Access Method. c. Select the access method you want. d. Click Set to return to the Client Install window. 9. Click Select Media to display the File Browser window in which you specify the path to the directory that contains the installation images. 10. Use the File Browser window to naigate to the correct file. 11. Click Set Media & Close to sae your setting and display the Install Options window Additional Information: See the Tioli Management Framework User s Guide for instructions on how to use the File Browser window. Note: Normally, you use same installation image to create the Tioli management region serer and managed nodes. 12. Modify the installation options, if necessary. Additional Information: The options in this window apply to all listed systems. For details on the fields aailable in this window, see the online help. 13. Click Set to sae your changes and return to the Client Install window. 14. Click Install & Close to start the installation of the managed node. Additional Information: A new Client Install window is displayed. This window lists operations that will take place during the installation and any problems that you might want to correct before continuing the installation. 15. Click Continue Install. 16. (Windows only) Perform the following steps in the Tioli Remote Access Account window that is displayed: a. Select one of the following radio buttons: Account Defines an account other than the default access account. None Specifies that there is no Tioli remote access account. If reinstalling and there is a preious Tioli remote access account, this option does not oerwrite the original account. Use Installation Access Method Account Specifies that Tioli remote access account is the default access account. This selection grants the full rights that the default access account has. For more information about Tioli remote access account, see the Tioli Enterprise Installation Guide. b. Click Continue. Additional Information:The Client Install window returns and displays information on the progress of installation. c. Windows only: Click OK in the Confirm Reboot of Clients prompt to reboot these systems. Additional Information: You can click Close and restart the computer later, if necessary. The managed node is enabled only after you restart. 17. Click Close when the Client Install window displays the Finished client install message 18. Click Refresh in the View menu to display the icon of the managed nodes you created and erify success of this procedure. 19. (Windows only) Configure Simple Mail Transfer Protocol (SMTP) as follows. This protocol enables Tioli to generate for alerts and other messages: a. Access the Tioli command line enironment as described in Accessing the Tioli Management Framework enironment on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

141 b. Enter the following command: wmailhost hostname where hostname is the name of the network mail serer. For additional information, see the Tioli Enterprise Installation Guide. 20. Install gateway software on the managed node as follows: a. In the main Tioli desktop window, right-click EndpointManager and select Create Gateway to access the Create Gateway window. b. In the Name field, type a unique name for the gateway. It is recommended to use <host name>_gw to distinguish this gateway from other gateways and endpoints. For example, if the host name of the managed node is ision35, name the gateway ision35_gw. c. In the Port field, type the port number through which the gateway will communicate with its endpoints in TCP/IP. d. In the Managed Node Proxy field, type the name of the managed node on which the gateway will run. You can also click Managed Nodes to list the aailable managed nodes and select from the list. e. Click Create & Close. Installing endpoints through an existing Tioli enironment Objectie To install and configure the endpoint software on an endpoint using the Tioli desktop or command line interface. This procedure does not apply to the creation of endpoints on proxy mode z/os or OS/400 systems. Refer to the chapters listed in Table 33 for information about installing and configuring endpoints on these systems. Table 33. Guidelines for installing the product through an existing Tioli enironment Goal Install endpoints for the WebSphere MQ component running on proxy mode z/os systems. Install endpoints for the WebSphere MQ Integrator component running on proxy mode z/os systems. Install OS/400 endpoints for the WebSphere MQ component. Refer to Chapter 9, Installing and configuring the WebSphere MQ component for z/os, on page 131 Chapter 10, Installing and configuring the WebSphere MQ Integrator component for z/os, on page 157 Chapter 12, Setting up OS/400 endpoints for the WebSphere MQ component, on page 177 Background information Creation of endpoints during installation of the product is optional. This procedure describes how to create endpoints after you hae installed the product. You must install the endpoint software on an IBM Tioli Monitoring for Business Integration endpoint to enable communication with the Tioli serer. You perform this procedure from the Tioli serer. Note: If you hae a UNIX Tioli management region serer and you want to create Windows endpoints, the first endpoint you create must be on the actual endpoint system. Chapter 8. Expanding your Tioli enironment 123

142 You can perform this procedure in the Endpoint Setup Wizard or in the command line interface. You must proide configuration alues that match the requirements of specific operating systems as follows: For IBM Tioli Monitoring for Business Integration serer hosts that reside on UNIX machines, you must proide the root user ID and password of the host machine to install the endpoint software, as described in this procedure. For IBM Tioli Monitoring for Business Integration serer hosts that reside on Windows machines, you must hae at least one proxy endpoint in each Windows domain that contains serers that you want to manage. At the end of this procedure the endpoint is running on the IBM Tioli Monitoring for Business Integration serer host. Required authorization role admin Before you begin (Optional) Use the Planning sheet for creating endpoints in Table 14 on page 46 to prepare to perform this procedure for multiple IBM Tioli Monitoring for Business Integration endpoints. When you finish Perform the following steps on any endpoints that you installed. The command starts the monitoring engine so that you can distribute and run resource models: 1. Access the command line interface for the Tioli enironment as described in Accessing the Tioli Management Framework enironment on page Run the following command: wdmcmd -restart -e <endpoint_label> where <endpoint_label> is the name of the endpoint. Procedure This procedure describes installation of endpoints from the command line or using the Endpoint Setup Wizard in Windows. You can use the Endpoint Setup Wizard to install an endpoint on a local Windows system. Endpoint Setup Wizard (for Windows only): 1. Insert the Tioli Management Framework, Version 4.1 CD into the CD-ROM drie of the endpoint computer. 2. Run the setup executable located in the following subdirectory path: \pc\lcf\winnt 3. Click Next in the Tioli Management Framework Endpoint Setup window. 4. Read the license agreement. 5. Click Next to display the Endpoint Installation Options window. 6. (Optional) Click Browse to change the destination directory for the software. 7. Click Next to display the Tioli Remote Access Account window. 8. Type the user name and password of the account through which Tioli Management Framework accesses remote file systems. If you do not require access to remote domains, click Next to skip this step. 9. Click Next to access the Adanced Configuration window. 10. Specify the startup and configuration options information listed in the following table: 124 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

143 Field Name Use When... Gateway The gateway uses a port number other than the default Endpoint Other You want to specify a port for the endpoint to use. The default is Use the g <hostname> option to specify the intercepting gateway. Use the n <hostname of the endpoint> option to specify the name of the endpoint you are installing. 11. Click Next to continue the installation process. Additional Information: The wizard reports that communication of the endpoint and the gateway was successful. The endpoint is installed and logged into a gateway. The installation process configures the endpoint system to automatically start the endpoint serice when the system starts. If the system does not start, there might be a problem with the communication between the endpoint and the gateway. Remoe and then reinstall the endpoint. See the IBM Tioli Monitoring for Business Integration: Problem Determination Guide for information on how to remoe an endpoint. 12. Click Next to display the Setup Complete window. 13. Click Finish to display the Restart Windows window. 14. Select No. Additional Information: You can restart the system after the installation of IBM Tioli Monitoring for Business Integration is complete. When you restart the computer the Tioli Endpoint serice is created, with the startup type set to automatic. Command line: Use the winstlcf command to install an endpoint from the command line. This command enables you to remotely install endpoints on UNIX, Windows NT, and Windows 2000 systems. Partial CLI syntax for the winstlcf command is included in the following section. See the Tioli Management Framework Reference Manual for a complete description of the winstlcf command. Notes: 1. For Windows systems, in the N parameter, you must use the endpoint you created with the Endpoint Setup Wizard to create more Windows endpoints for a UNIX Tioli management region. See Endpoint Setup Wizard (for Windows only) on page 124 for more information. 2. The installation password that you specify with the winstlcf command becomes the default for all subsequent installations (unless you specify a different password with the P parameter). winstlcf [ C <locale_name>] [ d <dir_name>] [ f <file_name>] [ g <machine[+port]>] [ L <config_options>] [ l <ep_port>] [ N <endpoint>] [ n <ep_label>] [ P ] [ Y ] <host> [<user_acct> <password>] where: C <locale_name> (UNIX only) Specifies the language locale for IBM Tioli Monitoring for Business Integration endpoints that use the UNIX operating system. d <dir_name> Specifies the target directory on which to install the endpoint. The default Chapter 8. Expanding your Tioli enironment 125

144 location is /opt/tioli/lcf for UNIX and C:\Tioli\lcf for Windows NT and Windows When installing a Windows NT or Windows 2000 endpoint from a UNIX serer, forward slashes in path names are also supported. f <file_name> Specifies the file containing a list of systems on which to install endpoints. This file contains one system name per line, specifying the user ID and password to be used. Use the following format for each line in this file: host_name [ userid [ password]] g <machine[+port]> Specifies the Internet Protocol (IP) address or host name and, optionally, the port number of the gateway to which the endpoint logs in. L <config_options> Passes configuration options to the lcfd command for starting the endpoint. See the lcfd command in the Tioli Management Framework Reference Manual for a list of alid options. The example in this section shows how to specify options. If you specify multiple options or hae spaces in a single option, you must enclose the text in double quotation marks ( ). l <ep_port> Specifies the port number for the endpoint. The default port number is N <endpoint> (for Windows only) Specifies the reference endpoint from which you install other endpoints in a Windows domain. In IBM Tioli Monitoring for Business Integration specify one of the following alues for the <endpoint> in the Windows domain where you are installing the endpoint: For Windows serer endpoints in the domain of the Tioli serer, specify the hostname for the proxy endpoint (such as %HOST%_ep). For IBM Tioli Monitoring for Business Integration serer endpoints in a domain other than the domain of the Tioli serer, specify the name of the reference endpoint that you manually create, as described in Endpoint Setup Wizard (for Windows only) on page 124. n Specifies an endpoint label proided by a user. If you do not assign a name, the command generates a unique name automatically. Note: This label must be different than the one used for the managed node. P This option is useful only when you are installing on remote hosts with different passwords. If each machine has the same password or if you do not use the P option, you are prompted for a global password to use for each machine. Y Specifies that the installation proceeds without confirmation. By default, this command identifies the actions that you must take to perform the installation and requests confirmation before continuing. When you use the -Y option, the winstlcf command identifies the actions and performs the installation without requesting confirmation. <host> [<user_acct> <password>] Specifies the name of the IBM Tioli Monitoring for Business Integration serer host on which to install the endpoint. When you specify only the host name, the winstlcf command uses the root or Administrator account 126 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

145 Examples: and prompts you for the password. If you want to specify a different account and password on the host, enclose the host name, account name, and password in single quotation marks. For example, the following command installs the endpoint on the host ernon, using the DOMAIN-NT\chris account with the password pa55word: winstlcf ernon DOMAIN-NT\chris pa55word where DOMAIN-NT is the domain in which chris is located. When the Windows NT or Windows 2000 domain and the local computer use the same name for user_acct, you must proide the fully qualified name for the account. For example, if you want to specify a user account named Administrator in a domain called DOMAIN-NT, you must use the fully qualified name DOMAIN-NT\Administrator for the ariable user_acct. The following example installs and starts the endpoint software on a UNIX workstation named ernon. The C fr statement specifies that the endpoint process uses the French locale. By default, winstlcf uses the root account and prompts you for the root password on ernon. winstlcf -C fr ernon The following example installs the endpoint on a machine named cedar and prompts you for a password. The password you enter becomes the default password for all subsequent installations. winstlcf -P cedar In the following example, the winstlcf command installs the endpoint on an IBM Tioli Monitoring for Business Integration serer host named serer06 in the domain mycompany.com. The winstlcf command passes configuration options to the lcfd command to use when it starts the endpoint. The command assigns port 9131 for endpoint transactions. The g option specifies the gateway cedar and the port 1616 as the gateway to contact for initial login. The L flag specifies options for the D flag of the lcfd command. The D lcs.machine_name flag assigns the name serer06_ep to the endpoint. winstlcf -g cedar l L "-D lcs.machine_name=serer06_ep" serer06.mycompany.com Changing the gateway assignment of an endpoint Objectie To assign an endpoint to a different gateway on a managed node. Background information An endpoint communicates with the Tioli management region through gateway software that exists on a managed node. By default, the installer for IBM Tioli Monitoring for Business Integration assigns each endpoint to a gateway on a managed node wheneer possible. This configuration increases performance in the Tioli enironment by reducing traffic on the Tioli management region serer. In a typical configuration for IBM Tioli Monitoring for Business Integration, the Tioli management region serer administers a set of managed nodes. In turn, the managed nodes administer endpoints. If you use the Tioli management region serer to administer endpoints, you decrease the amount of system resources aailable for the administration of managed nodes and other operations. If you want the Tioli management region to administer endpoints, you can change the gateway assignment as described in this procedure. Chapter 8. Expanding your Tioli enironment 127

146 Required authorization role senior Before you begin Prepare the following information: List of endpoints that you want to reassign List of gateways that will host the reassigned endpoints (You can run the wgateway command to iew gateway assignments.) A plan for the new mapping of endpoints-to-gateways When you finish None Procedure You can perform this procedure from the command line. Command line: 1. Access the Tioli command line interface as described in Accessing the Tioli Management Framework enironment on page Run the following command: wep <endpoint> migrate <gateway> where <endpoint> is the name of the endpoint to migrate and <gateway> is the name of the new gateway assignment. Additional Information: When you reassign an endpoint to a new gateway, IBM Tioli Monitoring for Business Integration must be installed in the managed node that hosts that gateway. Keep in mind that gateway assignments are not permanent in the Tioli enironment. The Tioli serer might change gateway assignments during a recoery operation. Installing the Web Health Console manually Objectie To install the Web Health Console using a command line interface and the console s installation wizard. Background information This procedure enables you to install and set up the Web Health Console without using the Typical or Ealuation installation options in the installer. The Web Health Console software is aailable on one of the following CDs depending on the operating system: IBM Tioli Monitoring Web Health Console for AIX, HP, SUN, Version 5.1 IBM Tioli Monitoring Web Health Console for Windows, Linux, Version 5.1 The language support for IBM Tioli Monitoring is aailable on the IBM Tioli Monitoring, Version CD. The language support for product components is aailable on the following CDs: IBM Tioli Monitoring for Business Integration: WebSphere MQ Language Support 128 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

147 IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator Language Support IBM Tioli Monitoring for Business Integration: WebSphere InterChange Serer Language Support Required authorization role Log on priileges for the target computer. Before you begin None When you finish See the IBM Tioli Monitoring User s Guide for information on using the console. Procedure You can perform this procedure from the command line only. Command line: 1. Run the following setup executable in the IBM Tioli Monitoring installation CD to launch the installation wizard: On UNIX:./setupPLATFORM.bin where PLATFORM is the name of the operating system. On Windows: setupwin32.exe 2. Follow the instructions in the wizard panels. Additional Information: See IBM Tioli Monitoring User s Guide for more information. 3. Copy the contents of the /HCONSOLE directory of catalog files from one of the following installation CDs: For the English language, copy catalog files from the IBM Tioli Monitoring V5.1.1 installation CD. For other languages, copy catalog files from one of the Language Support installation CDs listed in Background information. 4. Insert the contents of the directory in the resources directory in the following path on the target computer: INSTALL_DIR/installedApps/dm.ear/dm.war/WEB-INF/classes/com/tioli/ DmForNt/resources where INSTALL_DIR is the directory where you installed the Web Health Console. Chapter 8. Expanding your Tioli enironment 129

148 130 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

149 Chapter 9. Installing and configuring the WebSphere MQ component for z/os This chapter describes the installation and configuration of Monitoring for WebSphere MQ for z/os. For a list of the specific operating systems, applications, and protocols that Monitoring for WebSphere MQ for z/os requires, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Program Directory and Supported operating systems on page 19. Table 34 shows the goals for installation and configuration of Monitoring for WebSphere MQ for z/os. Table 34. Goals for installation and configuration of Monitoring for WebSphere MQ for z/os Goal 1. Reiew the architecture details to ensure that you understand all prerequisites and components. 2. Install Monitoring for WebSphere MQ for z/os. 3. Configure Tioli gateways to accept longer time periods for commands. 4. Install a task serer to be used for monitoring a z/os systems. 5. Enable communications between the task serer and the z/os system. Refer to Tioli enironment for monitoring WebSphere MQ for z/os on page 132 Installing Monitoring for WebSphere MQ for z/os on page 133 Configuring timeouts for Tioli gateways on page 134 Installing the task serer on page 135 Configuring the task serer to communicate with z/os systems on page Configure z/os to send monitoring and eent data to the Tioli management region. The WebSphere MQ eent adapter for z/os requires a TCP/IP connection from the z/os system to the eent serer. The WebSphere MQ eent adapter can operate independently of the task serer and IBM Tioli NetView for z/os. 7. Start communications between the task serer and the z/os system. 8. Configure the Statistics Eent Adapter to manage the flow of System Management Facilities (SMF) statistics and accounting records to the eent serer. Configuring the IBM Tioli NetView for z/os enironment on page 141 Using IBM Tioli NetView for z/os message automation on page 144 Objectie on page 144 Creating the eent adapter configuration file on page 144 Creating the eent adapter JCL on page 147 Configuring eent queues for the queue manager on page 148 Configuring the dead-letter queue handler for z/os on page 149 Starting communication between the task serer and z/os on page 142 Setting up the Statistics Eent Adapter on page 151 Starting the Statistics Eent Adapter on page 155 Controlling statistics eents on page 155 Copyright IBM Corp. 2002,

150 Tioli enironment for monitoring WebSphere MQ for z/os A Tioli enironment for monitoring WebSphere MQ for z/os spans multiple systems, as shown in Figure 13. The list following the figure describes software requirements for each item in the figure. Figure 13. Tioli enironment for monitoring WebSphere MQ for z/os 1. Tioli management region serer 2. (Optional) A computer to host an eent serer to collect eents from z/os systems Like item 4, this computer communicates directly with z/os systems. 3. Managed node with gateway 4. Managed node with endpoint This computer communicates directly with a z/os system. 5. Target and/or focal point z/os system You can configure this z/os system to be a focal point for Tioli communication with multiple z/os systems. 6. (Optional) Additional target z/os systems operating in a sysplex and communicating through the Tioli NetView for z/os focal point Item 5 is the focal point for Tioli communication with these z/os systems. The following list summarizes the required software for each element in Figure 13: 1. The Tioli serer runs IBM Tioli Monitoring for Business Integration: WebSphere MQ. 2. This optional computer communicates directly with z/os using TCP/IP and runs the Eent serer of the Tioli Enterprise Console to proide eent filtering and correlation. 3. This managed node runs the following software: IBM Tioli Monitoring for Business Integration: WebSphere MQ. Tioli gateway software to enable communication with endpoints. 132 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

151 4. This managed node runs the following software: IBM Tioli Monitoring for Business Integration: WebSphere MQ. Tioli endpoint software to enable communication with the Tioli enironment. The Tioli Business Systems Manager task serer Note: The task serer communicates directly to a single z/os system using TCP/IP or SNA. Howeer, it can communicate with multiple NetView Operators on that one system to improe performance. TCP/IP or SNA to communicate with z/os. 5. The z/os system runs the following software: TCP/IP Tioli NetView for z/os. The purpose of Tioli NetView for z/os is to sere as a focal point for Tioli communication with multiple z/os systems. A focal point system only needs to run Tioli NetView for z/os. A focal point system does not necessarily contain WebSphere MQ components or IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os. IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os, if you are monitoring resources on this z/os system. 6. Additional target z/os systems operating and communicating through the Tioli NetView for z/os focal point run the following software: Systems Network Architecture (SNA) protocol for Tioli NetView communication between z/os systems. TCP/IP Tioli NetView for z/os. IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Note: In a sysplex, one of the z/os systems acts as the focal point. Each z/os system in the sysplex requires its own installation of Tioli NetView for z/os. See IBM Tioli Monitoring for Business Integration User s Guide for a more detailed illustration of the Tioli enironment for z/os. Installing Monitoring for WebSphere MQ for z/os Objectie To install Monitoring for WebSphere MQ for z/os. Background information Install Monitoring for WebSphere MQ for z/os on each z/os system that is running WebSphere MQ resources that you want to manage. Monitoring for WebSphere MQ for z/os software comes on the z/os software distribution tape. Distribution from the tape is performed by the System Modification Program Extended (SMP/E). The distribution process loads the following components: Table 35. Components of a Monitoring for WebSphere MQ for z/os installation Program IHSMDSCV Description IBM Tioli NetView for z/os command processor for discoering the queue managers on a z/os system Chapter 9. Installing and configuring the WebSphere MQ component for z/os 133

152 Table 35. Components of a Monitoring for WebSphere MQ for z/os installation (continued) Program IHSMCMDP IHSMDQM IHSMTECA IHSMTECZ IHSMDLQH Sample JCL Description Command processor Module that proides support for displaying queue messages WebSphere MQ eent adapter for a z/os system Statistics Eent Adapter for processing WebSphere MQ z/os System Management Facilities (SMF) records JCL that proides support for running the dead-letter queue (DLQ) handler on z/os WebSphere MQ eent adapter configuration file, the Statistics Eent Adapter configuration file, and the queue manager configuration file Required authorization role None. Before you begin Make sure the IBM Tioli NetView for z/os was installed on each z/os system. Hae a list of all systems on which you want to install the product. Read and reiew the program directory. Hae the SNMP tape in hand. When you finish Install the task serer as described in Installing the task serer on page 135. Procedure Follow the installation instructions in the IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Program Directory. The IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Program Directory comes with the software distribution tape and describes the requirements and procedures for installation. Note: On z/os, command prefix (cpf) names for queue managers cannot contain the following characters: percent sign (%), dollar sign ($), left and right parentheses ( ). Names that contain these characters can generate unpredictable results when you run tasks on queue managers. Configuring timeouts for Tioli gateways Objectie To extend the default duration for gateway transactions to match requirements of Monitoring for WebSphere MQ for z/os systems. Background information Seeral of the IBM Tioli Monitoring for Business Integration tasks may take more time to complete on z/os than the default fie-minute timeout alue that is configured on Tioli gateways. You can allocate more time to these tasks so that they complete successfully. Required authorization role senior Before you begin Prepare a list of gateways for which you want to increase timeout alues. 134 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

153 When you finish None Installing the task serer Procedure Increase the default gateway timeout alue to 600 seconds or greater on all gateways that serice endpoints that host a Tioli Business Systems Manager task serer. You can run he following command from the command line on any managed node in the Tioli management region: wgateway <gateway_name> set_session_timeout 600 where gateway_name is the name of the gateway with the timeout you want to change. For more information on the wgateway command refer to the Tioli Management Framework Reference Manual. Objectie To install the task serer that sends and receies commands and monitoring data for z/os systems. The task serer part of the Tioli Business Systems Manager Eent Enablement component. Background information Use one installation of the task serer for communication with the z/os system. See the following documents for more information on using Tioli Business Systems Manager and Tioli Business Systems Manager task serers: IBM Tioli Monitoring for Business Integration User s Guide IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator User s Guide Install the task serer on a managed node that has IP connectiity to the z/os system running the focal point NetView. The following operating systems can host this managed node: Windows NT Version 4.0 with Serice Pack 6a AIX, Versions 4.3.3, 5.1, or 5.2 Solaris 7, 8, or 9 The task serer does not run on HP-UX platforms. The task serer is installed as part of the Tioli Business Systems Manager Eent Enablement product, which is proided on the IBM Tioli Monitoring for Business Integration: WebSphere MQ, Version Component Software installation CD in the \TBSM_EE211 directory. The task serer process starts automatically when you start the operating system. The Version task serer cannot coexist with a preious ersion of the task serer or the Tioli Global Enterprise Manager topology serer. If a preious ersion of the task serer or the topology serer is installed, use the tserer remoe command to uninstall it before installing the Version task serer. Required authorization role super Chapter 9. Installing and configuring the WebSphere MQ component for z/os 135

154 Before you begin See Goals for planning and preparing for installation in Table 1 on page 17 for a checklist of actiities prior to installation. As a precautionary measure, back up the Tioli management region as described in Backing up and restoring Tioli databases on page 38. Start the Tioli desktop as described in Accessing the Tioli Management Framework enironment on page 81. Ensure that you hae the following: The installation CD that contains Tioli Business Systems Management Eent Enablement: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software The names of the managed nodes on which to install the software. Configuring the Solaris /etc/system file: If you are performing system operations in the Solaris operating system enironment, you must add the following lines to the /etc/system file: set semsys:seminfo_semmap=90 set semsys:seminfo_semmni=90 set semsys:seminfo_semopm=90 set semsys:seminfo_semume=90 set semsys:seminfo_semmns=900 set semsys:seminfo_semmnu=90 set semsys:seminfo_semmsi=90 set shmsys:shminfo_shmmax= These alues represent the number required for Tioli Business Systems Manager and the existing alues must be increased to the number displayed. After you hae added the lines to the file, restart your system. When you finish Configure the task serer. See Configuring the task serer to communicate with z/os systems on page 137. Configure communication between the z/os system and the task serer. See Configuring the IBM Tioli NetView for z/os enironment on page 141 Start communication between the z/os system and the task serer. See Starting communication between the task serer and z/os on page 142. After you install IBM Tioli Monitoring for Business Integration, complete the actiities described in Chapter 7, Completing the installation of the product, on page 93. Procedure Tioli desktop: 1. Select Install in the Desktop menu. Additional Information: This procedure describes installation of the Tioli Business Systems Manager Eent Enablement product, which contains the task serer software. The installation image is located in the following installation CD: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software. 2. Select Install Product in the menu to display the Install Product window. 3. If necessary, click OK to bypass a harmless error message about the media settings. 136 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

155 4. Click Select Media to display the File Browser window. 5. In the Path Name text field, enter the full path to the.ind file in the CD-ROM drie.. Additional Information: The file is located in the following directory path on the installation CD: \TBSM_EE211\211BSM00. The index (.IND) file contains details regarding the components of the product installation. Be sure to use backward slashes (\) for Windows path names instead of forward slashes (/) in the path name. 6. Click Set Path to display the File Browser window containing the specified media in the Files scrolling list. 7. Click Set Media & Close. 8. Select Tioli Business Systems Manager Eent Enablement in the Select Product to Install scrolling list. 9. Select the target client from the Aailable Clients scrolling list. 10. Click the left arrow to moe the selected client to the Clients to Install On scrolling list. Additional Information: Tioli installs the software on the computer in this list. 11. If necessary, select the clients on which you do not want to install the task serer from the Clients to Install On list and click the right arrow to moe them to the Aailable Clients list. 12. Click Install & Close to display the Product Install window and a list of pending installation actions. 13. Click Continue Install to begin the installation process. Additional Information: The Product Install window displays the progress of the installation. View the messages in the task output window to determine whether the product installation was successful. 14. Click Close to close the Product Install window. 15. Install the required patch for the Tioli Business Systems Manager Eent Enablement product, using the patch installation procedure described in Upgrading, installing Tioli patches, and installing fix packs on page 86. Additional Information: The patch is located in the \TBSM_EE211\211BSME31 directory of the following installation CD: IBM Tioli Monitoring for Business Integration: WebSphere MQ Component Software. The patch is called Tioli Business Systems Manager Eent Enablement E As a precautionary measure, back up the Tioli management region databases as described in Backing up and restoring Tioli databases on page 38. Use a unique name for the new backup files. Configuring the task serer to communicate with z/os systems Objectie To enable the task serer to communicate with the z/os system. Background information Use one installation of the task serer for communication with the z/os system. Use a separate installation of the task serer for WebSphere MQ integration with Tioli Business Systems Manager. See the IBM Tioli Monitoring for Business Integration User s Guide for more information on using Tioli Business Systems Manager and Tioli Business Systems Manager task serers. The following actions are included in this procedure and enable the task serer to communicate with the z/os system: Chapter 9. Installing and configuring the WebSphere MQ component for z/os 137

156 Create the user ID and group that map to the irtual ID Monitoring for WebSphere MQ tasks are run under the irtual user ID, tmemqs_user, and the irtual group, tmemqs_group. If WebSphere MQ is not installed on the computer that runs the task serer, you must ensure that the user ID and group that are mapped to tmemqs_user and tmemqs_group exists on the task serer. Gie a user account the required priileges and rights in Windows (Windows only) A user account must hae seeral priileges and rights that Windows requires to enable Tioli operations. Change TCP/IP port numbers, if other applications use these port numbers: If other applications use the default TCP/IP ports for the task serer (4020 and 4042) you must assign new, unique port numbers. Enable the task serer to reference multiple operator IDs on the z/os system The task serer achiees multithreading of communications by referencing multiple operator IDs when it sends hostcmd commands to Tioli NetView for z/os. The task serer alternates among the aailable operator IDs, inoking them concurrently to improe performance and response time. See the Tioli Business Systems Manager Administration Guide for more information on this set of commands. Required authorization role This procedure requires the following authorizations: On UNIX: root On Windows: Administrator Within Tioli: super Before you begin Install the task serer as described in Installing the task serer on page 135. You need to know the following information: New user IDs to use on the task serer New port numbers NetView operator IDs and passwords When you finish If you reassign the default z/os port number (4020), you must also customize the Tioli NetView for z/os Port keyword in the DUIFPMEM file. For more information about the Port keyword, see Tioli NetView for OS/390 Administration Reference. Procedure 1. Create a user ID and group that map to the irtual ID, if WebSphere MQ is not installed on the computer on which you installed the task serer. This user ID and group must match the user ID and group that are enabled to run tasks for Monitoring for WebSphere MQ. Additional Information: A irtual user ID, tmemqs_user, in a irtual group, tmemqs_group, runs Monitoring for WebSphere MQ tasks. When WebSphere MQ is not installed on the task serer machine, the user ID and group that are mapped to tmemqs_user and tmemqs_group for Monitoring for WebSphere MQ must exist on the computer on which you installed the task serer. In this situation, you must manually create this user ID. The user ID depends on the platform that the task serer is running on: 138 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

157 Platform User ID Group Windows MUSR_MQADMIN Administrators UNIX mqm mqm Use the appropriate operating system utilities to create the required user ID and group. For information about the default mapping for your operating system, see the Changing the mapping of the irtual user and group ID topic in the IBM Tioli Monitoring for Business Integration User s Guide. Always create ID mappings, because resource models run as the default irtual id mappings, een if you remap them. 2. (Windows only) Gie a user account the required priileges and rights in Windows by doing the following: a. Log on to the computer that runs the task serer using a user account that has Administrator priileges. b. Select Programs in the Start menu of the Windows taskbar. c. Select User Manager or User Manager for Domains for NT serers in the Administratie Tools (Common) menu to display the User Manager window. d. Select the user you want to modify in the Username list. e. Add the user to the Administrators group as follows: 1) Double-click the user name to access the Users Properties window. 2) Click Groups to access the Group Memberships window. 3) Select Administrators in the Not member of list. 4) Click Add to moe Administrators to the Member of list. 5) Click OK to return the Users Properties window. 6) Click OK to sae your changes and to return to the User Manager window. f. Select User Rights in the Policies menu to access the User Rights Policy window. g. Click Show Adanced User Rights. h. Assign the Act as part of the operating system user right to the user as follows: 1) Select Act as part of the operating system in the Right drop-down list. 2) Click Add to access the Add Users and Groups window. 3) Click Show Users. 4) Select the user in the Names list. 5) Click Add. 6) Click OK to return to the User Rights Policy window. i. Repeat Step 2h to assign the Replace a process leel token user right to the user. In Step 2h1 you select Replace a process leel token instead of Act as part of the operating system. j. Repeat Step 2h to assign the Log on as a serice user right to the user. In Step 2h1 you select Log on as a serice instead of Act as part of the operating system. k. Click OK to sae the user rights assignments. l. Click Close to close the User Manager window. m. Log off your user account to apply these changes by doing the following: 1) Click Start in the Windows taskbar and select Shut Down. 2) Select Close all programs and log on as a different user?. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 139

158 3) Click Yes. Additional Information: When you log in again, your user account has the required authorizations. 3. Change TCP/IP port numbers by doing the following if other applications use these port numbers: a. Open the serices text file in the following directory path: On AIX or Solaris: /etc On Windows: %SystemRoot%\system32\driers\etc b. Find the following entries and change the default port settings (4020 or 4042) to unique port numbers: tserer_tbsm 4020/tcp #serer z/os port tserer_ts 4042/tcp #task serer port 4. Enable the task serer to reference multiple operator IDs on the z/os system by doing the following: a. Go to the $BINDIR/TDS/EentSerice/bin directory on the task serer. b. Enter one of the following commands to enable the task serer to reference the Tioli NetView for z/os operator ID and password: On Windows, outside the bash shell: tserer hostcmdoper -u operator_id -p password The tserer command sets up the appropriate enironment and then runs the hostcmdoper command. On UNIX or within the bash shell on Windows:./hostcmdoper -u operator_id -p password where operator_id and password correspond to a NetView operator on the z/os system. The hostcmdoper command encrypts the password and stores it on disk on the task serer. See the Tioli Business Systems Manager Administration Guide for more information on this set of commands. c. Repeat 4b for each operator you want to reference. d. Run the following command to erify success of Step 4b:./hostcmdoper -s The command returns the list of operator IDs that hae been configured using the hostcmdoper command. Additional Information: Refer to the Tioli NetView for z/os Security Reference document for information about authorizing Tioli NetView operators to run UNIX commands in Tioli NetView for z/os. e. (Optional) Run the following command to delete a reference to NetView operators. This command deletes the first operator reference that you defined in Step 4b:./hostcmdoper -d operator_id 5. Restart the task serer as follows to implement your configuration changes: a. (Optional) Manually stop the task serer by doing the following: 1) Go to the $BINDIR/TDS/EentSerice/bin directory. 2) Run the following command to stop the task serer, if it is running: tserer -stop 3) Run the following command to start the task serer: tserer -start 140 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

159 Configuring the IBM Tioli NetView for z/os enironment Objectie To configure the Tioli NetView for z/os enironment for use with the Monitoring for WebSphere MQ. Background information The task serer proides the hostcmd command for communication with Tioli NetView for z/os. When you run Monitoring for WebSphere MQ tasks on a z/os system, the length of the command passed to the hostcmd command is limited to 255 characters. Exceeding the limit results in a communication failure. To aoid exceeding the 255 character limit, run the task multiple times, selecting a subset of attributes each time Before you begin Tioli NetView for z/os with the Graphical Enterprise feature must be installed. Tioli NetView Version 1 Release 3 must be started as a status focal point. Tioli NetView Version 1 Release 4 includes the status focal point capability. When you finish Configure the task serer for z/os communication as described in Starting communication between the task serer and z/os on page 142. Procedure 1. Copy the IHSMDSCV, the IHSMCMDP, and the IHSMDQM command processors to your IBM Tioli NetView for z/os data set. The IHSMDSCV command processor enables discoery of queue managers on z/os systems. 2. Define the IHSMDSCV, the IHSMCMDP, and the IHSMDQM command processors to IBM Tioli NetView for z/os by adding the following command model statements to DSICMD: IHSMDSCV CMDMDL MOD=IHSMDSCV IHSMCMDP CMDMDL MOD=IHSMCMDP IHSMDQM CMDMDL MOD=IHSMDQM 3. (Optional) Copy the WTO automation files into the partitioned data set (PDS) that is identified by the DSIPARM DD statement in the IBM Tioli NetView for z/os JCL. The IBM Tioli NetView for z/os NCCF command, AUTOTBL, actiates the Automation Table. For more information, refer to the IBM Tioli NetView for z/os product documentation. If you use the WTO option that the WebSphere MQ eent adapter for z/os proides, you might want to suppress the operator console messages that it generates to aoid operator problems with increased or difficult-to-read messages. To suppress messages, complete the following steps using the message processing facility (MPF): Either add a new MPFLSTxx member to SYS1.PARMLIB or change an existing member to contain a line similar to the following: IHSM*,SUP(YES),AUTO(YES) The aboe example preents all messages that begin with IHSM from appearing on the operator s console, but allows NetView Automation to process the messages. Use the SET MPF command to actiate the SYS1.PARMLIB member. For more information about MPF, refer to the z/os MVS System Commands manual and the IBM Tioli NetView for z/os product documentation. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 141

160 4. Modify the IBM Tioli NetView for z/os JCL so that IHSMCMDP, which runs as an IBM Tioli NetView for z/os subtask, can become a WebSphere MQ application by adding the following DD statement to the STEPLIB: DD DISP=SHR,DSN=your.mqseries.SCSQAUTH Replace your.mqseries.scsqauth with the data set name for your WebSphere MQ product library. 5. Build a new copy of the Library Lookaside Directory indexes to make the IHSMDSCV, the IHSMCMDP, and the IHSMDQM command processors aailable to Tioli NetView for z/os by running the following z/os command: F LLA,REFRESH For more information, refer to the z/os MVS System Commands manual. 6. On the IBM Tioli NetView for z/os focal point, confirm that you hae the correct information on these two IBM Tioli NetView for z/os members on the mainframe (DUIFPMEM and DUIIGHB) by doing the following: a. In DUIFPMEM: TCPANAME parameter must match the step name used by the TCPIP task. USETCPIP parameter must be YES. SOCKETS parameter must be 50. PORT parameter number must match what you hae in tserer_tbsm parameter on the computer that is running the task serer. b. In DUIIGHB, the TCPANAME parameter must match the name used by the TCPIP task. 7. Stop and restart IBM Tioli NetView for z/os to incorporate the changes to DSICMD and the JCL. Starting communication between the task serer and z/os Objectie To initiate and erify the task serer s communication with Tioli NetView for z/os on the z/os system. Background information The task serer starts automatically as a process when you start the operating system. This procedure tells how to establish communication between the task serer and Tioli NetView for z/os on the z/os system. Wheneer you stop and start the task serer, you must enter the NETCONV command again. Required authorization role This procedure requires the following authorizations: On UNIX: root On Windows: Administrator Within Tioli: super Before you begin Perform the procedure Configuring the task serer to communicate with z/os systems on page IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

161 The task serer must be running when you perform this procedure. The task serer is configured to run automatically. To erify that it is running, check the status of one of the following processes: On Windows NT, the task serer starts automatically as a Windows serice called Tioli BSM Task Serer. To reiew or alter these settings, access the Serices window through the Windows Control Panel. On AIX and Solaris, the task serer starts automatically as the daemon ihscts. To reiew or alter these settings see the following configuration files: For AIX: /etc/rc.tbsm For Solaris: /etc/rc3.d/s95tbsm and /etc/rc0.d/k05tbsm Ensure that the Tioli NetView for z/os CNMTAMEL task is running. See Tioli NetView for z/os documentation for more information. Ensure that the DUIIGHB task must be running. The DUIIGHB member must be defined as is documented for the focal point system. When you finish None Procedure 1. Start the task serer if it is not running. 2. Ensure that the Tioli NetView for z/os CNMTAMEL task is running. Additional Information: See Tioli NetView for z/os documentation for more information. 3. Run the following command on the operator console of Tioli NetView for z/os: netcon action=start ip=hostname where hostname is the IP address or the fully qualified host name of the computer on which the task serer runs. Additional Information: The following example establishes a TCP/IP connection with a task serer located on a computer whose IP address is : netcon action=start ip= This session enables TCP/IP communication with the task serer and must remain actie. Wheneer you stop and start the task serer, you must enter the NETCONV command again. 4. Verify that communication through Tioli NetView for z/os to MVS is successful by doing the following: a. Go to the $BINDIR/TDS/EentSerice/bin directory on the task serer. b. Run the following command on the task serer: tserer hostcmd "MVS D A,L" -h hostname where hostname is the IP address or the fully qualified host name of the z/os system on which the command is to be executed. The tserer command sets up the appropriate enironment and then runs the hostcmd command. This hostcmd command displays the list of all actie tasks running on the z/os system. See the Tioli Business Systems Manager Administration Guide for more information on this set of commands. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 143

162 Using IBM Tioli NetView for z/os message automation Objectie To use Tioli NetView for z/os messaging and message automation for eents on a z/os system. Background information Using IBM Tioli NetView for z/os message automation enables you to handle the eents in a z/os enironment instead of routing the eents to the eent serer. The WebSphere MQ eent adapter uses WTO messages to make messages aailable to IBM Tioli NetView for z/os. On z/os systems, the IBM Tioli NetView for z/os program can automate responses to messages from the operating system and from MVS application programs. The operating system performs its automation tasks before it sends messages to the IBM Tioli NetView for z/os program for further automation. Also, system operator commands can be sent from the operating system to the IBM Tioli NetView for z/os program. Before you begin None When you finish None Procedure To automate responses to messages, mark the messages in the z/os message processing facility (MPF) for deliery to the IBM Tioli NetView for z/os program. For more information about message automation, see the IBM Tioli NetView for z/os product documentation, and see Creating the eent adapter configuration file, Configuring the IBM Tioli NetView for z/os enironment on page 141, and Using IBM Tioli NetView for z/os message automation. Creating the eent adapter configuration file Objectie To enable the WebSphere MQ eent adapter to process WebSphere MQ eents on a z/os system, create a configuration file for each eent adapter. Background information Each eent adapter runs in its own address space, one for each queue manager. The WebSphere MQ eent adapter configuration file includes the following statements: #********************************************************************** # LICENSED MATERIALS - PROPERTY OF IBM # 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 1996, 2002 # ALL RIGHTS RESERVED. # # US GOVERNMENT USERS RESTRICTED RIGHTS # - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY # GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. # # Eent Adapter Configuration File for # IBM Tioli Monitoring for Business Integration - WebSphere MQ for z/os # # Version: # # File format: 144 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

163 # <keyword>=<alue> # where <keyword> is # SererLocation - Hostname or IP address of the TEC serer. # SererPort - Port number on which the TEC serer is listening. # EentMaxSize - Maximum length of TEC eent message. # ConnectionMode - connection_oriented OR connection_less # ErrorLogLeel - FATAL/MAJOR/MINOR. # TracingLeel - LOW/NORMAL/VERBOSE. # BufferFlushRate - number of eents/minute to send to TEC Serer # TestMode - specify YES to bypass TEC Serer(echo eents) # WTO - NO_WTO/WTO_ONLY/WTO_AND_EVENTS # #********************************************************************** SererLocation=your.eent.serer *SererPort=5529 EentMaxSize=4096 *ConnectionMode=connection_less ConnectionMode=connection_oriented EentQueueName=SED_EVENTQ TracingLeel=LOW ErrorLogLeel=MINOR BufferFlushRate=0 TestMode=NO Before you begin None When you finish None Procedure 1. From the sample data set, copy and change the sample TAMQSCFG configuration file, and sae the changed file as the name of the target queue manager QMGRNAME. 2. Type in the IP address or the fully qualified host name of the eent serer in the SererLocation= statement. 3. Specify the port number the eent serer is using in the SererPort= statement depending on where the eent serer located as follows: On UNIX: Comment out the SererPort= statement. The portmapper daemon retriees the port number. On Windows: Ensure that the SererPort= statement is not commented out. The default port number is If you want to change the port number, set the port number to the alue of the tec_rec_agent_port entry in the.tec_config file in the $BINDIR/TME/TEC directory on the eent serer. 4. Comment out one of the ConnectionMode statements. 5. If you do not receie eents from the eent adapter for WebSphere MQ, change the alue of TracingLeel to a higher leel, such as VERBOSE, and set the alue of ErrorLogLeel to MINOR. Additional Information: The output goes to the data set specified in the TECLOG DD statement. For an example, see Creating the eent adapter JCL on page 147. When TestMode is set to YES, the eents are logged in the data set identified by the TECLOG DD statement in the job that starts the eent adapter. The default is SYSOUT=A. For the distributed enironment eent adapter, the SererLocation keyword identifies the file name where the eents are logged. On z/os, the SererLocation is ignored when TestMode is set to YES. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 145

164 6. To control the generation of WTO messages, change the alue of WTO to one of the following: NO_WTO Generates eents for the eent serer and is the default. WTO operator messages are not generated. WTO_ONLY Generates only WTO operator messages. WTO_AND_EVENTS Generates both WTO operator messages and eents. Additional Information: If you configure the WebSphere MQ eent adapter to generate WTO messages to manage WebSphere MQ resources, you can also copy sample automation files into the appropriate partitioned data set and modify the samples for your system. For more information on automation files, see 3 on page 141. The syntax for filter statements on z/os is different than the syntax for filter statements on distributed platforms. Filter statements on z/os support pattern matching. An asterisk (*) in the alue field indicates that zero or more characters can match the pattern. A question mark (?) indicates that exactly one character can match the pattern. The pattern can be the alue portion of one or more keywords. You can use the asterisk (*) and the question mark (?) anywhere in the pattern, in any combination, as many times as you need. The following filter statement filters out an eent of the class MQ_UNKNOWN_OBJECT_NAME for any queue manager whose name starts with QSB: FilterMode=OUT Filter:Class=MQ_UNKNOWN_OBJECT_NAME;QMgrName=QSB* The pattern can also be the class name. The following filter statement filters out any eent that begins with MQ_UNKNOWN for any queue manager whose name begins with Q, has a B as the third character, and ends in Z: FilterMode=OUT Filter:Class=MQ_UNKNOWN*;QMgrName=Q?B*Z The following filter statement filters out all MQ_UNKNOWN_OBJECT_NAME eents: FilterMode=OUT Filter:Class=MQ_UNKNOWN_OBJECT_NAME;QMgrName=* The following filter statement passes all eents for the queue manager named QSB014 and filters out all other eents: FilterMode=IN Filter:Class=*;QMgrName=QSB If you do not require different customization for each eent adapter, you can create one configuration file for all eent adapters and define alias names for the other queue managers. For more information on configuration alues and on other options in this configuration file, refer to the Tioli Eent Integration Facility User s Guide. 146 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

165 Creating the eent adapter JCL Objectie To create the eent adapter JCL. Background information Set up one copy of the eent adapter JCL on each z/os system on which you are managing queue managers. All queue managers on the z/os system use the same JCL. To create the eent adapter JCL, copy and modify the sample TECAD JCL in the sample data set. Sae the modified JCL as the TECAD PROC member name in the PROCLIB data set. Example of the TECAD JCL: //TECAD PROC CFG=TAMQSCFG, MEMBER NAME FOR CONFIG // PRM= PARMS(E.G. PRM= -QMQM1 ) //* LICENSED MATERIALS - PROPERTY OF IBM //* 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 1997,2002 //* ALL RIGHTS RESERVED. //* //* US GOVERNMENT USERS RESTRICTED RIGHTS //* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY //* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. //* //* EVENT ADAPTER FOR //* IBM TIVOLI MONITORING FOR BUSINESS INTEGRATION - //* WEBSPHERE MQ FOR Z/OS //* //TECADAPT EXEC PGM=IHSMTECA,PARM= &PRM., // ACCT=ACCT, // TIME=1439, // REGION=64M //* //STEPLIB DD DISP=SHR,DSN=hlq.5r1m0.SIHSMODM // DD DISP=SHR,DSN=your.mqseries.SCSQAUTH // DD DISP=SHR,DSN=your.mqseries.SCSQLOAD // DD DISP=SHR,DSN=your.tcpip.LINKLIB // DD DISP=SHR,DSN=your.le370.SEDCLINK // DD DISP=SHR,DSN=your.plI.SIBMLINK //SYSUDUMP DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSTERM DD SYSOUT=* //EVTRACE DD SYSOUT=* //TECLOG DD SYSOUT=* //TECADCFG DD DISP=SHR,DSN=hlq.5r1m0.SIHSMSAM(&CFG.) //SYSTCPD DD DISP=SHR,DSN=your.tcp.INIT(TCPDATA) //* Before you begin None When you finish None Procedure Copy the JCL in Monitoring for WebSphere MQ Version and change the JCL to meet your site requirements as follows: 1. The minus sign is required before QMQM1. 2. (Optional) Use the Hhostname option to specify the host name or the domain name of the computer on which the eent adapter is installed. The eent adapter uses the host name or domain name in the eent it sends to the eent serer. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 147

166 Additional Information: Use the Hhostname option to ensure that the host name or domain name in an eent that is the same as the host name or domain name used on a queue manager icon. For example, enter the following: //* //TECADAPT EXEC PGM=IHSMTECA, // PARM=(' &PRM. -Hhostname'), 3. In the STEPLIB statements, replace hlq.5r1m0.sihsmodm with the data set name of the load library that Monitoring for WebSphere MQ for z/os proides. 4. In the STEPLIB statements, replace the your.mqseries.scsqauth and your.mqseries.scsqload entries with the data set names for your WebSphere MQ product libraries. 5. In the STEPLIB statements, insert the data set names of your.tcpip.linklib libraries for your TCP/IP product. 6. In the TECADCFG statement, replace hlq.5r1m0.sihsmsam with the data set name of the data set that contains the configuration file for the eent adapter. 7. (Optional) If you want to use the same configuration file for all eent adapters, in the TECADCFG statement, replace &CFG. with the name of the configuration file. Additional Information: Because the configuration file name is passed on the &CFG. input parameter, create a dummy DD statement for the &CFG. input parameter to aoid a JCL error message. The following example shows how you would modify your JCL to use a configuration file named MYCONFIG for all eent adapters: //DUMMY DD DISP=SHR,DSN=USER.INIT(&CFG.) //TECADCFG DD DISP=SHR,DSN=USER.INIT(MYCONFIG) 8. In the SYSTCPD statement, replace the your.tcp entry with the data set name of the data set that contains the member TCPDATA. Before you start this job, reiew the following dump, trace, and log settings: SYSUDUMP SYSPRINT SYSTERM EVTRACE TECLOG Displays a system-inoked dump Displays a job log of messages Compiles a log of runtime messages Compiles a log of eents for diagnostic purposes when TestMode is set to YES Compiles a log of eent adapter trace messages Additional Information: When the job is started, the eent adapter uses the name of the queue manager as the name of the configuration file. Configuring eent queues for the queue manager Objectie To enable the WebSphere MQ eent adapter for z/os system to correctly process eents, you must configure the four WebSphere MQ eent queues for a target queue manager to point to one eent queue, SED_EVENTQ. The SED_EVENTQ queue is the eent queue that the eent adapter for WebSphere MQ uses on a z/os system. Background information None 148 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

167 Required authorization roles MQS_senior or MQS_domain_name_senior admin Before you begin None When you finish None Procedure To configure the eent queues for a queue manager on a z/os system from the appropriate queue manager icon s context menu, click Eent Adapter Tasks, select Configure, and select OS/390 Eent Queue. Additional Information: This task starts the CSQUTIL JCL PROC that executes a CSQUTIL utility to load the TAMQMQSC configuration file. The TAMQMQSC configuration file configures the eent queues. The sample CSQUTIL PROC includes the following statements: //CSQUTIL PROC QMGR=QMGR,CONF=IHSMMQSC //* LICENSED MATERIALS - PROPERTY OF IBM //* 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 1997,2002 //* ALL RIGHTS RESERVED. //* //* US GOVERNMENT USERS RESTRICTED RIGHTS //* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY //* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. //* //* IBM TIVOLI MONITORING FOR BUSINESS INTEGRATION - //* WEBSPHERE MQ FOR Z/OS //* //STEP01 EXEC PGM=CSQUTIL,REGION=4096K,PARM= &QMGR.;,ACCT=(XXXX) //STEPLIB DD DISP=SHR,DSN=your.mqseries.SCSQANLE // DD DISP=SHR,DSN=your.mqseries.SCSQAUTH //SYSPRINT DD SYSOUT=* //SYSIN DD DSN=hlq.5r1m0.SIHSMSAM(SYSIN),DISP=SHR //* //CSQUCMD DD DISP=SHR,DSN=hlq.5r1m0.SIHSMSAM(&CONF;) // Change the JCL to meet your site requirements as follows: 1. In the STEPLIB statement, replace the your.mqseries.scsqanle and your.mqseries.scsqauth entries with the data set names for your WebSphere MQ product libraries. 2. In the SYSIN and CSQUCMD statements, replace hlq.5r1m0.sihsmsam with the data set name of the sample data set that Monitoring for WebSphere MQ for z/os proides. Configuring the dead-letter queue handler for z/os Objectie To configure the DLQ handler for use on a z/os system. Background information None Before you begin None Chapter 9. Installing and configuring the WebSphere MQ component for z/os 149

168 When you finish None Procedure 1. Copy and modify the sample IHSMDLQH JCL. 2. Sae the modified JCL as the IHSMDLQH PROC member name in the PROCLIB data set. Additional Information: Here is an example of the IHSMDLQH JCL: //IHSMDLQH PROC CNTRL=, MEMBER NAME OF CONTROL FILE // PRM= DLQ NAME AND QMGR NAME //* //* LICENSED MATERIALS - PROPERTY OF IBM //* 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 2001,2002 //* ALL RIGHTS RESERVED. //* //* US GOVERNMENT USERS RESTRICTED RIGHTS //* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY //* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. //* //* Sample job for the dead letter queue handler for //* IBM Tioli Monitoring for Business Integration - //* WebSphere MQ for z/os //* //* CNTRL is set to the name of the MQSeries DLQ control file //* //* PRM is set to the name of the dead-letter queue, followed by //* the name of the queue manager. //* //* For example: //* //* start ihsmdlqh,cntrl=dlqh1,prm= m22a.dead.queue m22a //* //DLQH EXEC PGM=CSQUDLQH, // PARM= &PRM., // ACCT=ACCT, // TIME=1439, // REGION=64M //* //STEPLIB DD DISP=SHR,DSN=your.mqs.SCSQAUTH // DD DISP=SHR,DSN=your.mqs.SCSQLOAD // DD DISP=SHR,DSN=your.mqs.SCSQANLE //SYSOUT DD SYSOUT=* //SYSIN DD DISP=SHR,DSN=your.control.dsn(&CNTRL.) //* 3. Change the JCL to meet your site requirements by doing the following: a. In the STEPLIB statements, replace the your.mqseries.scsqauth, your.mqseries.scsqload, and your.mqseries.scsqanle entries with the data set names for your WebSphere MQ product libraries. b. Replace the your.control.dsn entry with the data set name for your DLQ rules table. For information about starting the DLQ handler, refer to the information on the Start DLQ Handler task in the IBM Tioli Monitoring for Business Integration: WebSphere MQ Reference Guide. For more information about the DLQ handler on z/os, refer to the WebSphere MQ product documentation. 150 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

169 About monitoring SMF records with the Statistics Eent Adapter Monitoring for WebSphere MQ for z/os proides the Statistics Eent Adapter to enable you to monitor WebSphere MQ z/os System Management Facilities (SMF) statistics and accounting records. For more information about SMF statistics and accounting records, refer to the WebSphere MQ for z/os V5.2 Interpreting accounting and statistical data Version 1.0 support pack. The Statistics Eent Adapter reads WebSphere MQ SMF statistics and accounting records (record 115 and record 116), reformats the data into eent console format, and forwards the formatted eents to the eent serer. The Statistics Eent Adapter runs in burst mode, which means that the Statistics Eent Adapter runs periodically as needed, usually when the SMF data set fills up and is dumped to tape. The Statistics Eent Adapter sends all eents and then stops. At startup, the Statistics Eent Adapter reads a configuration file, TAMQZCFG. See the IBM Tioli Monitoring for Business Integration User s Guide for more information and a diagram that shows how the Statistics Eent Adapter retriees WebSphere MQ SMF records and forwards them as formatted eents to the eent serer. Setting up the Statistics Eent Adapter Objectie To enable collection of WebSphere MQ statistics and accounting records from the SMF data set. By default, WebSphere MQ does not generate SMF records. Background information Setting up of the Statistics Eent Adapter requires the following actions: Configuration of WebSphere MQ to generate SMF records You enable collection of WebSphere MQ statistics and accounting records in the SMF data set. By default, WebSphere MQ does not generate SMF records. Configuration of SMF to trace WebSphere MQ statistics and accounting records You configure SMF to trace WebSphere MQ records 115, 116, or both. Modification of the SMF Dump JCL to put SMF records 115 and 116 in an alternate data set that the Statistics Eent Adapter reads You modify the SMF dump JCL to identify the alternate data set in which the WebSphere MQ SMF records are to be placed. Modification of the Statistics Eent Adapter configuration file You enable the Statistics Eent Adapter to process WebSphere MQ SMF records by modifying the sample TAMQZCFG configuration file. Creation of the Statistics Eent Adapter JCL Before you begin See About monitoring SMF records with the Statistics Eent Adapter. When you finish None Procedure 1. Configure WebSphere MQ to generate SMF records by doing the following: a. Modify the CSQ4ZPRM file to include the following lines: Chapter 9. Installing and configuring the WebSphere MQ component for z/os 151

170 SMFACCT=YES SMFSTAT=YES b. Assemble and link the file. c. Put the load module into an APF library and add the library name to the STEPLIB of the WebSphere MQ JCL. For more information, refer to the WebSphere MQ product documentation. d. For each queue manager for which you want to collect SMF records, use WebSphere MQ commands similar to the following to start tracing the SMF records: START TRACE(ACCTG) DEST(SMF) CLASS(3) START TRACE(STAT) DEST(SMF) CLASS(1) You can also include this command in the CSQINP2 command file. For more information, refer to the WebSphere MQ product documentation. 2. Configure SMF to trace WebSphere MQ statistics and accounting records by modifying the SYS statement in the SMFPRMxx member of SYS1.PARMLIB to add 115 or 116, or both. For more information, refer to the WebSphere MQ product documentation. 3. Modify the SMF Dump JCL to put SMF records 115 and 116 in an alternate data set that the Statistics Eent Adapter reads by doing the following: Note: You can use any DD name, but you must use the same DD name in both of the following steps. The DD name is OUTDDMQS in this example. a. Add a DD statement similar to the following: //OUTDDMQS DD DSN=data_set_name,DISP=alue Where data_set_name is the name of the data set in which to store the WebSphere MQ SMF records, and alue can be MOD or OLD. If you specify DISP=MOD, WebSphere MQ SMF records are added to the end of the data set each time the SMF dump job is run. If you specify DISP=OLD, WebSphere MQ SMF records are replaced in the data set each time the SMF dump job is run. b. Add a statement to the SYSIN records similar to the following: OUTDD(OUTDDMQS,TYPE(115,116)) For more information, refer to the MVS System Management Facilities (SMF) manual. 4. Modify the Statistics Eent Adapter configuration file by doing the following: a. Modify the sample TAMQZCFG configuration file in the sample data set to enable the Statistics Eent Adapter to process WebSphere MQ SMF records. Additional Information: The following code proides an example of the Statistics Eent Adapter configuration file: //CSQUTIL PROC QMGR=QMGR //* LICENSED MATERIALS - PROPERTY OF IBM //* 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 1997,2002 //* ALL RIGHTS RESERVED. //* //* US GOVERNMENT USERS RESTRICTED RIGHTS //* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY //* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. //* //* IBM TIVOLI MONITORING FOR BUSINESS INTEGRATION - //* WEBSPHERE MQ FOR Z/OS //* 152 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

171 //STEP01 EXEC PGM=CSQUTIL,REGION=4096K,PARM= &QMGR.,ACCT=(XXXX) //STEPLIB DD DISP=SHR,DSN=your.mqseries.SCSQANLE // DD DISP=SHR,DSN=your.mqseries.SCSQAUTH //SYSPRINT DD SYSOUT=* //SYSIN DD DSN=hlq.5r1m0.SIHSMSAM(SYSIN),DISP=SHR //* //CSQUCMD DD DISP=SHR,DSN=hlq.5r1m0.SIHSMSAM(TAMQMQSC) // b. Make a backup copy of the TAMQZCFG file. c. Modify the copied TAMQZCFG configuration file as follows: 1) Type in the IP address or the fully qualified host name of the eent serer in the SererLocation= statement. 2) Specify the port number that the eent serer is using in the SererPort= statement as follows: For UNIX: Comment out the SererPort= statement. The portmapper daemon retriees the port number. For Windows: Ensure that the SererPort= statement is not commented out. The default port number is If you want to change the port number, set the port number to the alue of the tec_rec_agent_port entry in the.tec_config file in the $BINDIR/TME/TEC directory on the eent serer. 3) (Optional) Change the leel of error information to be logged in the ErrorLogLeel= statement to MAJOR or FATAL. Additional Information: The following logging leels are possible: MINOR logs all errors. MAJOR logs only major and fatal errors. FATAL logs only fatal errors. The output goes to the data set specified in the TECLOG DD statement in the Statistics Eent Adapter JCL, which is described in Step 5 on page ) (Optional) Change the tracing leel in the TracingLeel= statement to NORMAL or VERBOSE. Additional Information: The following logging leels are possible: Use LOW for regular operation. Use NORMAL or VERBOSE for troubleshooting purposes. The output goes to the data set specified in the TECLOG DD statement in the Statistics Eent Adapter JCL, which is described in Step 5 on page ) (Optional) Add filter statements to minimize the number of eents that are sent to the eent console. Additional Information: Filter statements support pattern matching characters. An asterisk (*) in the alue field indicates that zero or more characters can match the pattern. A question mark (?) indicates that only one character can match the pattern. The pattern can be the alue portion of one or more keywords. The asterisk (*) and question mark (?) can appear anywhere in the pattern, in any combination, and as many times as needed. The following filter statement filters out an eent of the class MQ_TASK for any queue manager name that starts with QSB: Chapter 9. Installing and configuring the WebSphere MQ component for z/os 153

172 FilterMode=OUT Filter:Class=MQTASK;QMgrName=QSB* 5. Create the Statistics Eent Adapter JCL by doing the following: a. Copy and modify the IHSMTECZ JCL in the sample data set. b. Sae the modified JCL as the IHSMTECZ PROC member name in a PROCLIB data set. Additional Information: The following example illustrates the IHSMTECZ JCL data set: //IHSMTECZ PROC CFG=TAMZSCFG MEMBER NAME FOR CONFIG //* //* LICENSED MATERIALS - PROPERTY OF IBM //* 5698-WMQ (C) COPYRIGHT TIVOLI SYSTEMS 2001, 2002 //* ALL RIGHTS RESERVED. //* //* US GOVERNMENT USERS RESTRICTED RIGHTS //* - USE, DUPLICATION OR DISCLOSURE RESTRICTED BY //* GSA ADP SCHEDULE CONTRACT WITH IBM CORPORATION. //* //* IBM TIVOLI MONITORING FOR BUSINESS INTEGRATION - //* WEBSPHERE MQ FOR Z/OS //* //* EVENT ADAPTER FOR MQSERIES STATISTICS AND ACCOUNTING //* //TECADAPT EXEC PGM=IHSMTECZ, // ACCT=ACCT, // TIME=1439, // REGION=64M //* //STEPLIB DD DISP=SHR,DSN=hlq.5r1m0.SIHSMODM // DD DISP=SHR,DSN=your.le370.SEDCLINK //SYSUDUMP DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSTERM DD SYSOUT=* //SYSLOG DD SYSOUT=* //EVTRACE DD SYSOUT=* //TECLOG DD SYSOUT=* //SMFDD DD DISP=SHR,DSN=your.smf.dataset //TECADCFG DD DISP=SHR,DSN=hlq.5r1m0.SIHSMSAM(&CFG.) //SYSTCPD DD DISP=SHR,DSN=your.tcp.INIT(TCPDATA) //* 1) Specify the TCP/IP product in a member of the partitioned data set on the SYSTCPD DD statement. For IBM TCP/IP, set the TCP=systemname parameter to the started task name of the IBM TCP/IP product, such as TCPIP. The alue of systemname is the name of a TCP/IP stack. 2) In the STEPLIB statements, replace hlq.5r1m0.sihsmodm with the data set name of the load library that Monitoring for WebSphere MQ for z/os proides. 3) In the TECADCFG statement, replace hlq.5r1m0.sihsmsam with the data set name of the data set that contains the Statistics Eent Adapter configuration file. Before you start this job, reiew the dump, trace, and log settings: SYSUDUMP Displays a system-inoked dump. SYSPRINT Displays a job log of messages. SYSTERM Compiles a log of runtime messages. 154 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

173 Starting the Statistics Eent Adapter EVTRACE Compiles a log of eents for diagnostic purposes when TestMode is set to YES. TECLOG Compiles a log of Statistics Eent Adapter trace messages. Objectie To start the Statistics Eent Adapter as needed to process the SMF records in the alternate data set. Background information See About monitoring SMF records with the Statistics Eent Adapter on page 151. Before you begin None When you finish None Controlling statistics eents Procedure The Statistics Eent Adapter can be started automatically or manually. If you hae configured the SMF dump JCL to replace the SMF records in the alternate data set each time the SMF dump is run, start the Statistics Eent Adapter automatically to ensure that you do not lose any SMF records. To do this, add the SMF TECAD JCL as a job step to the SMF Dump JCL. To start the Statistics Eent Adapter manually, start the IHSMTECZ job at the operator s console after the SMF dump job completes. Objectie To minimize the number of statistics eents receied at the eent console. Background information See About monitoring SMF records with the Statistics Eent Adapter on page 151 Tracing SMF records can produce a large amount of trace data. To minimize the number of statistics eents receied at the eent console, use procedures in this section that control statistics eents. Before you begin None When you finish None Procedure Dump the SMF records and run the Statistics Eent Adapter at least once a day. Limit the SMF data that is traced using the START TRACE command as follows: Trace either statistics or accounting data instead of tracing both types of data. Chapter 9. Installing and configuring the WebSphere MQ component for z/os 155

174 Limit tracing to specific queue managers. Use WebSphere MQ constraints. Additional Information: For more information about the START TRACE command, refer to the WebSphere MQ product documentation. Specify that the eent is not to be forwarded to the eent serer by setting filter criteria in the Statistics Eent Adapter configuration file. For more information, see 4c5 on page 153. Create new rules to exclude the eent. This forwards the eent to the eent serer where the rules engine eliminates it. For more information, refer to the Tioli Enterprise Console Rule Builder s Guide. You can create one eent console to display the statistics eents and another eent console to display accounting eents. 156 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide

175 Chapter 10. Installing and configuring the WebSphere MQ Integrator component for z/os This chapter describes installation and configuration of Monitoring for WebSphere MQ Integrator for z/os. For a list of the specific operating systems, applications, and protocols that Monitoring for WebSphere MQ Integrator for z/os requires, refer to the IBM Tioli Monitoring for Business Integration: WebSphere MQ for z/os Program Directory and to Supported operating systems on page 19. IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator (Monitoring for WebSphere MQ Integrator) allows MQSIBroker and MQSIUsrNameSr objects to represent WebSphere MQ Integrator for z/os resources that are located on a z/os system. For example, a Monitoring for WebSphere MQ Integrator task can configure or control a WMQI Broker on a z/os system. A Monitoring for WebSphere MQ Integrator resource model can monitor the status of WMQI components or MessageFlows located on a z/os system. Monitoring for WebSphere MQ Integrator communicates with WebSphere MQ Integrator for z/os resources on a z/os system as illustrated in Figure 14 on page 158. Table 36 shows the goals for installation and configuration of Monitoring for WebSphere MQ Integrator for z/os. Table 36. Goals for installing and configuring the WebSphere MQ Integrator component for z/os Goal 1. Install and set up Monitoring for WebSphere MQ Integrator for z/os, including the setup of the eent adapter that enables eent correlation. 2. Configure Tioli gateways to accept longer time periods for commands. 3. Install a task serer to be used for monitoring a z/os systems. 4. Enable communications from the task serer to the z/os system. Refer to Installing and setting up Monitoring for WebSphere MQ Integrator for z/os on page 160 Configuring timeouts for Tioli gateways on page 164 Installing the task serer on page 135 This procedure is the same for Monitoring for WebSphere MQ and Monitoring for WebSphere MQ Integrator. Configuring the task serer to communicate with z/os systems on page Enable communications from the z/os system to the task serer. 6. Start communications between the task serer and the z/os system. This procedure is the same for Monitoring for WebSphere MQ and Monitoring for WebSphere MQ Integrator. Configuring the IBM Tioli NetView for z/os enironment on page 165 Starting communication between the task serer and z/os on page 166 Copyright IBM Corp. 2002,

176 Tioli enironment for monitoring WebSphere MQ Integrator for z/os A Tioli enironment for monitoring WebSphere MQ Integrator on z/os spans multiple systems, as shown in Figure 14. The list following the figure describes software requirements for each item in the figure. Figure 14. Architecture of Monitoring for WebSphere MQ Integrator for z/os 1. Tioli management region serer 2. (Optional) A computer to host an eent serer and a computer to collect Performance Monitor data from z/os. Like item 4, these computers communicate directly with z/os systems. 3. Managed node with gateway 4. Managed node with endpoint This computer communicates directly with a z/os system. 5. Target and/or focal point z/os system You can configure this z/os system to be a focal point for Tioli communication with multiple z/os systems. 6. (Optional) Additional target z/os systems operating in a sysplex and communicating through the Tioli NetView for z/os focal point. Item 5 is the focal point for Tioli communication with these z/os systems. The following list summarizes the required software for each element in Figure 14: 1. The Tioli serer runs IBM Tioli Monitoring for Business Integration: WebSphere MQ Integrator. 2. These optional computers communicate directly with z/os using TCP/IP. The computers run the following software: The eent serer of the Tioli Enterprise Console proides eent filtering and correlation. 158 IBM Tioli Monitoring for Business Integration: Installation and Setup Guide