IBM Tivoli Monitoring For Applications

v Appendix C, “Patches” on page 131Lists required patches.v Appendix D, “Uninstalling the product” on page 133Describes uninstallation of the product.v Appendix E, “Accessibility” on page 139Describes accessibility features of the product.v Appendix F, “Notices” on page 141Provides information on copyrights and trademarks.PublicationsThis section lists publications in the IBM Tivoli Monitoring for Applications libraryand any other related documents. It also describes how to access Tivolipublications online, how to order Tivoli publications, and how to submit commentson Tivoli publications.IBM Tivoli Monitoring for Applications libraryThe following documents are available in the IBM Tivoli Monitoring forApplications library.v IBM Tivoli Monitoring for Applications: Siebel eBusiness Applications User’s Guide,SC23-4819-00Provides information about how to use IBM Tivoli Monitoring for Applications:Siebel eBusiness Applications to manage Siebel resources.v IBM Tivoli Monitoring for Applications: mySAP.com User’s Guide, SC23-4812-00vvvvvxProvides information about how to use IBM Tivoli Monitoring for Applications:mySAP.com to manage mySAP.com resources.IBM Tivoli Monitoring for Applications: Siebel eBusiness Applications Reference Guide,SC23-4818-00Provides detailed information about IBM Tivoli Monitoring for Applications:Siebel eBusiness Applications resource models, tasks, and commands.IBM Tivoli Monitoring for Applications: mySAP.com Reference Guide, SC23-4813-00Provides detailed information about IBM Tivoli Monitoring for Applications:mySAP.com resource models, tasks, and commands.IBM Tivoli Monitoring for Applications Installation and Setup Guide, GC23-4810-00Provides instructions for installing Tivoli Manager for Applications and setting itup to manage endpoint resources.IBM Tivoli Monitoring for Applications, Release Notes, GI11-0941-00Describes product features and provides information about the latest changes tothe installation requirements and procedures. The release notes also describeknown limitations related to installation and explain how to work around eachlimitation.IBM Tivoli Monitoring for Applications: Siebel eBusiness Applications: Limitations andWorkarounds Supplement, SC23-4817-00Provides the latest information about known product limitations andworkarounds. To ensure that the information is the latest available, thisdocument is provided only on the Web, where it is updated on a regular basis.You can access the Limitations and Workarounds document through the IBMTivoli Monitoring for Applications link on the Tivoli Information Center Website:IBM Tivoli Monitoring for Applications: Installation and Setup Guide

c manuals/td/TD PROD LIST.htmlv IBM Tivoli Monitoring for Applications: mySAP.com: Limitations and WorkaroundsSupplement, SC23-4806-00Provides the latest information about known product limitations andworkarounds. To ensure that the information is the latest available, thisdocument is provided only on the Web, where it is updated on a regular basis.You can access the Limitations and Workarounds document through the IBMTivoli Monitoring for Applications link on the Tivoli Information Center an/public manuals/td/TD PROD LIST.htmlRelated publicationsThe following documents provide related information:v IBM Tivoli Monitoring: Workbench User’s Guide, SH19-4571Describes how to use the IBM Tivoli Monitoring Workbench to create newresource models and to modify existing ones.v IBM Tivoli Monitoring User’s Guide, SH19-4569Describes how to use the IBM Tivoli Monitoring user interface.v IBM Tivoli Monitoring Collection Reference, SH19-4570Describes the resource models that come with IBM Tivoli Monitoring software.v Tivoli Management Framework User’s Guide, GC31-8433-04Describes the Tivoli environment, including profiles and profile management.v Tivoli Management Framework Reference Manual, SC31-8434-04Provides detailed information about Tivoli commands.v Tivoli Management Framework, Version 3.7.1: Installation Guide, GC32-0395-01Provides information and procedures for installing and upgrading TivoliManagement Framework (Tivoli management region server, managed nodes,gateways, and endpoints), and provides the procedures for installing andupgrading Tivoli Enterprise products.v Tivoli Management Framework, Version 3.7.1: Planning for Deployment Guide,GC32-0393-01Explains how to plan for deploying your Tivoli environment, and describesTivoli Management Framework and its services.v Tivoli Enterprise Console User’s Guide, Version 3.7.1, GC32-0667-01Describes how to use the Tivoli Enterprise Console to correlate events anddetermine the severity and relationship of those events.v Tivoli Enterprise Console, Version 3.7: Rule Builder’s Guide, GC32-0669-00Provides information about developing rules for managing events with TivoliEnterprise Console with a text editor and a graphical rule builder.v TME 10 Software Installation Service User’s Guide, sis36gaDescribes how to use the Tivoli Software Installation Service (SIS) to installTivoli products.v Tivoli Business Systems Manager, Version 1.5: User’s GuideDescribes how to use the Tivoli Business Systems Manager product.v Tivoli Business Systems Manager Console, Version 1.5: User’s GuideDescribes how to use the Tivoli Business Systems Manager console.v Tivoli Enterprise Data Warehouse documentationAbout this guidexi

Describes how to use Tivoli Enterprise Data Warehouse to compile historicaldata to monitor your system and to help you make strategic managementdecisions regarding your network.The Tivoli Glossary includes definitions for many of the technical terms related toTivoli software. The Tivoli Glossary is available, in English only, at the followingWeb ary/termsm03.htmAccessing softcopy publicationsThe publications for this product are available in PDF and HTML formats throughthe following media:v IBM Tivoli Monitoring for Applications: Version 5.1.0 Documentation CDThe Documentation CD contains all of the English language publications for thisproduct, except for the Web-only Limitations and Workarounds supplements. Toaccess the publications, use a Web browser to open the start.html file, which islocated in the root directory of the CD.v Tivoli Information CenterIBM posts publications for this product and all other Tivoli products, as theybecome available and whenever they are updated, to the Tivoli InformationCenter Web public manuals/td/TD PROD LIST.htmlClick the IBM Tivoli Monitoring for Applications link to access the ents/Using the guide onlineThis document is available on the IBM Tivoli Monitoring for Messaging andCollaboration, Version 5.1.0: Documentation CD in PDF and HTML formats. Refer tothe readme.txt file on the CD for instructions on downloading the Acrobat Reader,Version 3.0 or later, to view, save, and print the manual.Use your HTML browser to open the start.html file on the CD to access the .htmldocumentation files. Every navigation page also includes a link at the bottom todownload the Acrobat reader for viewing, saving, and printing the files.Viewing online helpOnline help is available in several forms:v Desktop — Access online help by clicking the Help buttons in dialog boxes.v Commands — You can display command syntax and parameter information forcommand line interface (CLI) commands by typing the name of the command ata command prompt and pressing the Enter key.Ordering publicationsYou can order many Tivoli publications online at the following Web cations/publications/cgibin/pbi.cgiYou can also order by telephone by calling one of these numbers:v In the United States: 800-879-2755v In Canada: 800-426-4968xiiIBM Tivoli Monitoring for Applications: Installation and Setup Guide

In other countries, see the following Web site for a list of telephone numbers:http://www.tivoli.com/inside/store/lit order.htmlProviding feedback about publicationsIf you have comments or suggestions about our products and documentation,contact us in one of the following ways:v Send an e-mail to pubs@tivoli.com.v Complete our customer feedback survey at the following Web ilityAccessibility features help users who have physical disabilities, such as restrictedmobility or limited vision, to use software products successfully. With this product,you can use assistive technologies to hear and navigate the interface. You can alsouse the keyboard instead of the mouse to operate features of the graphical userinterface.For additional information, see the appendix on Appendix E, “Accessibility” onpage 139.Contacting Customer SupportIf you have a problem with any Tivoli product, you can contact IBM CustomerSupport for Tivoli products. See the Tivoli Customer Support Handbook at thefollowing Web site:http://www.tivoli.com/support/handbook/The handbook provides information about how to contact Customer Support,depending on the severity of your problem, and the following information:v Registration and eligibilityv Telephone numbers and e-mail addresses, depending on the country in whichyou are locatedv What information you should gather before contacting Customer SupportConventions used in this guideThis guide uses several conventions for special terms and actions and forcommand syntax.Typeface conventionsThis guide uses the following typeface conventions:BoldCommands, keywords, file names, authorization roles, URLs, orother information that you must use literally appear like this, inbold. Names of windows, dialogs, and other controls also appearlike this, in bold.ItalicsVariables and values that you must provide appear like this, initalics. Words and phrases that are emphasized also appear like this,in italics.MonospaceCode examples, output, and system messages appear like this, ina monospace font.About this guidexiii

Tivoli command syntaxThe commands in this book use the following special characters to define Tivolicommand syntax: Indicates that the text enclosed in the angle brackets is a variable that yousupply.[]Identifies optional elements. Elements that do not have brackets aroundthem are required.Indicates you can specify multiple values for the previous element.Separate multiple values by a space, unless the command informationspecifies differently.If the ellipsis for an element follows a closing bracket ( ] ), use the syntaxwithin the brackets to specify multiple values. For example, to specify twoadministrators for the option [–a admin]., use –a admin1 –a admin2.If the ellipsis for an element is within brackets, use the syntax of the lastelement to specify multiple values. For example, to specify two hosts forthe option [–h host.], use –h host1 host2. Indicates mutually exclusive information, meaning you can use the elementon either the left or right of the vertical bar, but not both.{}Delimits a set of mutually exclusive elements when a command requiresone of them, but not multiple elements. Brackets ([ ]) are around elementsthat are optional.\A backslash indicates that a command continues on the next line.In addition to the special characters, Tivoli command syntax uses the typefaceconventions described in “Typeface conventions” on page xiii.The following examples illustrate the typeface conventions used in Tivolicommand syntax:v wcrtpr [–a admin]. [–s region] [–m resource]. nameThe name argument is the only required element for the wcrtpr command. Thebrackets around the options indicate that they are optional. The ellipsis after the–a admin option means that you can specify multiple administrators multipletimes. The ellipsis after the –m resource option means that you can specifymultiple resources multiple times.v wchkdb [–o outfile] [–u] [–x] {–f infile –i object.}The –f, –i, and object elements are mutually exclusive. The braces that surroundthe –f, –i, and object elements indicate that you are including required elements.If you specify the object argument, you can specify more than one object.When you reference an object in a command issued from the command line, thereference is not an absolute object reference like those used in programming.Instead, the reference is a user-friendly name. This user-friendly name derives froma name given to the object by the user of the application, such as when creating apolicy region.xivIBM Tivoli Monitoring for Applications: Installation and Setup Guide

Chapter 1. OverviewThis document describes installation and setup of IBM Tivoli Monitoring forApplications, monitoring and management software for business-critical hardwareand software. This document includes information on the following topics:vvvvDetermining the proper installation for your environmentInformation about a typical Tivoli environmentGuidelines and worksheets for planning your installation and setupProcedures for using the installation wizard or the Tivoli desktop to install yourmonitoring productv Problem determination information for the installation wizardv Guidelines for migrating from Tivoli Manager for R/3, Version 2.2Choosing an installation methodThe IBM Tivoli monitoring products offer several options for installing thesoftware, depending on the complexity of your environment and your knowledgeof Tivoli management systems. Your choices include the following:Installation wizardThe installation wizard (referred to in the rest of this guide as the installer)creates a complete Tivoli environment, if none exists, and installs theproduct. The installer also installs supplemental software, such as the Javarun-time environment and language packs. Use the installer if you eitherhave no previous Tivoli software installations or you have TivoliManagement Framework, Version 3.7, Revision A or Revision B, installed.If you use the installer, you must choose between a Typical or Custominstallation path. Use the following criteria to determine which path youwant to take:Use the Typical installation path when the following conditions are true:v You want to install the product on a target computer that matches one ofthe following profiles:– Has no software installed for the Tivoli Management Framework.—OR—– Has one of the following versions of the Tivoli ManagementFramework installed: Version 3.7 (Revision A or Revision B) orVersion 3.7.1. You cannot install this product on systems that runprevious versions of the Tivoli Management Framework.v You are a first-time Tivoli user.v Your environment matches the “Elements of a Basic installation” onpage 2.Use the Custom installation path if you want to use the Planner tool thatoffers a tree view of the entire installation and provides additional controlover directory paths and naming conventions. See Chapter 5, “Performinga Custom installation” on page 33. Use the Custom installation option ifyou are installing the Tivoli management region server on a UNIXcomputer and you want to create Windows endpoints.1

Tivoli desktop and command line interfaceUse one of these options if you are a current Tivoli user with earlierversions of the Tivoli Management Framework. You might also want to useone of these options if you have expert knowledge of the Tivolienvironment and plan to extensively customize your installation. Themanual installation method enables you to create interconnected Tivolimanagement region servers and to create environments with more than 50endpoints.Chapter 6, “Installing the product manually” on page 55 provides manualinstallation instructions. For further information, see the documentation onthe Tivoli Management Framework software CDs that come with IBMTivoli Monitoring for Applications.The Tivoli Software Installation Service (SIS)Go to http://www.tivoli.com/support for information about obtaining andusing SIS.Migrating from previous Tivoli productsThe following migration options exist for Tivoli Distributed Monitoring and TivoliManager for R/3:v Migrate or upgrade pre-existing software:Note: The installer automatically migrates this software to IBM TivoliMonitoring for Applications. When you perform a manual installation ofthe product, you must manually install the upgrade patch as described inChapter 6, “Installing the product manually” on page 55.– Upgrade previous versions of IBM Tivoli Monitoring to the required Version5.1.1. See “Upgrading IBM Tivoli Monitoring manually” on page 67.– Migrate Tivoli Manager for R/3 software as described in Chapter 8,“Migrating from previous versions of IBM Tivoli Monitoring for Applications,Version 5.1.0: mySAP.com” on page 93.v Map tasks in the Tivoli Manager for R/3 product to IBM Tivoli Monitoring forApplications.You use configuration tasks in the new product in the same way that you usedthem in Tivoli Manager for R/3. The program code in the new tasks haschanged to work with IBM Tivoli Monitoring for Applications, but the names ofthe tasks and their general purpose remains the same.v Map monitors to resource models. See Chapter 8, “Migrating from previousversions of IBM Tivoli Monitoring for Applications, Version 5.1.0: mySAP.com”on page 93.IBM Tivoli Monitoring for Applications: Siebel eBusiness Applications does notsupport concurrency with Tivoli Distributed Monitoring. You must uninstallTivoli Manager for Siebel before using IBM Tivoli Monitoring for Applications:Siebel eBusiness Applications resource models.Elements of a Basic installationThis section describes a basic Tivoli environment. The installer creates a basicTivoli environment during the Typical installation.During the Typical or Custom installation, you can create the following elements:2IBM Tivoli Monitoring for Applications: Installation and Setup Guide

v One required Tivoli management region server to monitor endpoints. The Tivoliserver runs the Tivoli Management Framework and IBM Tivoli Monitoringsoftware.v A managed node computer system on which Tivoli Management Framework isinstalled. Each managed node has gateway software that increases performancein the Tivoli environment by reducing traffic on the Tivoli management regionserver. The IBM Tivoli Monitoring software also runs on a managed node.v Up to 5

Changing the gateway assignment of an endpoint 88 Integrating IBM Tivoli Monitoring for Applications with Tivoli Business Systems Manager .89 Chapter 8. Migrating from previous versions of IBM Tivoli Monitoring for Applications, Version 5.1.0: . Siebel eBusiness Applications to manage Siebel resources.