getting started with ibm tivoli service level...

Getting Started with IBM Tivoli ServiceLevel AdvisorVersion 1.2

SC32-0834-01

Getting Started with IBM Tivoli Service Level Advisor

Copyright Notice

© Copyright IBM Corporation 2002. All rights reserved. May only be used pursuant to aTivoli Systems Software License Agreement, an IBM Software License Agreement, orAddendum for Tivoli Products to IBM Customer or License Agreement. No part of thispublication may be reproduced, transmitted, transcribed, stored in a retrieval system, ortranslated into any computer language, in any form or by any means, electronic,mechanical, magnetic, optical, chemical, manual, or otherwise, without prior writtenpermission of IBM Corporation. IBM Corporation grants you limited permission to makehardcopy or other reproductions of any machine-readable documentation for your ownuse, provided that each such reproduction shall carry the IBM Corporation copyrightnotice. No other rights under copyright are granted without prior written permission ofIBM Corporation. The document is not intended for production and is furnished “as is”without warranty of any kind. All warranties on this document are hereby disclaimed,including the warranties of merchantability and fitness for a particular purpose.

U.S. Government Users Restricted Rights—Use, duplication or disclosure restricted by GSAADP Schedule Contract with IBM Corporation.

Trademarks

IBM, the IBM logo, Tivoli, the Tivoli logo, AIX, Tivoli Enterprise, Tivoli Enterprise Console,DB2, DB2 Universal Database, and WebSphere are trademarks or registered trademarks ofInternational Business Machines Corporation in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of MicrosoftCorporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the UnitedStates, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.Notices

References in this publication to Tivoli Systems or IBM products, programs, or services donot imply that they will be available in all countries in which Tivoli Systems or IBMoperates. Any reference to these products, programs, or services is not intended to implythat only Tivoli Systems or IBM products, programs, or services can be used. Subject tovalid intellectual property or other legally protectable right of Tivoli Systems or IBM, anyfunctionally equivalent product, program, or service can be used instead of the referencedproduct, program, or service. The evaluation and verification of operation in conjunctionwith other products, except those expressly designated by Tivoli Systems or IBM, are theresponsibility of the user. Tivoli Systems or IBM may have patents or pending patentapplications covering subject matter in this document. The furnishing of this documentdoes not give you any license to these patents. You can send license inquiries, in writing,to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, NewYork 10504-1785, U.S.A.

Contents

Preface . . . . . . . . . . . . . . viiWho Should Read This Guide . . . . . . . . viiPrerequisite and Related Documentation . . . . vii

IBM Tivoli Service Level Advisor . . . . . . viiIBM DB2 Universal Database Enterprise Edition viiiTivoli Enterprise Data Warehouse. . . . . . viiiWarehouse Packs . . . . . . . . . . . viiiIBM Console Information . . . . . . . . viiiIBM WebSphere Application Server . . . . . ix

Conventions Used in This Document . . . . . . ixAccessing Publications Online . . . . . . . . ixProviding Feedback about Publications . . . . . xContacting Customer Support . . . . . . . . x

Chapter 1. Introduction . . . . . . . . 1What is IBM Tivoli Service Level Advisor? . . . . 1How IBM Tivoli Service Level Advisor Works . . . 2IBM Tivoli Service Level Advisor in the Enterprise . 3Inside IBM Tivoli Service Level Advisor . . . . . 4

The SLM Server . . . . . . . . . . . . 4SLM Reports . . . . . . . . . . . . . 5SLM Task Drivers. . . . . . . . . . . . 5

IBM Tivoli Service Level Advisor Databases . . . . 5The Central Data Warehouse Database. . . . . 5The SLM Database . . . . . . . . . . . 6The SLM Measurement Data Mart . . . . . . 6

Chapter 2. Planning Decisions . . . . . 7Components of an SLM Deployment . . . . . . 7

Tivoli Enterprise Data Warehouse Components . . 7Warehouse Packs . . . . . . . . . . . . 9IBM Tivoli Service Level Advisor Components . . 9Deploying the SLM Solution in Your Enterprise 10Deployment Options . . . . . . . . . . 15

Selecting Port Numbers . . . . . . . . . . 18Coexistence with Other DB2 Database Applications 20Information to Gather Before Installing . . . . . 21

Information for All Installations . . . . . . 21Additional Information for Single SystemInstallations . . . . . . . . . . . . . 26Additional Information for DistributedInstallations . . . . . . . . . . . . . 27Planning for Warehouse Packs . . . . . . . 28

Chapter 3. Installing SupportingApplications . . . . . . . . . . . . 29Migrating From Previous Versions . . . . . . . 29Installing DB2 . . . . . . . . . . . . . 30

Starting a DB2 Command Prompt . . . . . . 30Step 1. Read the documentation . . . . . . 30Step 2. Verify the Root User Authority in DB2 . . 31Step 3. Ensure fully qualified host names . . . 31Step 4. On UNIX, mount the CD-ROM . . . . 33Step 5. Check the version of any existing DB2installation . . . . . . . . . . . . . 33

Step 6. Install DB2 7.2 with Fix Pack 5 . . . . 34Step 7. Upgrade to DB2 7.2 Fix Pack 6 . . . . 36Step 8. Update the JDBC Level for DB2 . . . . 37Step 9. Configure the Database Manager to useExtended Shared Memory . . . . . . . . 38

Installing Tivoli Enterprise Data Warehouse 1.1 . . 39Before Starting the Install Wizard . . . . . . 40Step 1. Start the install wizard . . . . . . . 40Step 2. Choose Single System or DistributedInstallation . . . . . . . . . . . . . 40Step 3. Select Components to Install . . . . . 42Step 4. Verify Host Name. . . . . . . . . 43Step 5. Specify local DB2 user name andpassword . . . . . . . . . . . . . . 43Step 6. Specify Tivoli Presentation ServicesInformation . . . . . . . . . . . . . 44Step 7. Install additional languages . . . . . 45Step 8. Configure remote access to the controlserver . . . . . . . . . . . . . . . 46Step 9. Configure remote access to the centraldata warehouse . . . . . . . . . . . . 47Step 10. Configure remote access to data marts 49Step 11. Install application packages . . . . . 50Step 12. Completing the install wizard . . . . 51Verifying the Tivoli Presentation ServicesInstallation . . . . . . . . . . . . . 51

Installing Tivoli Enterprise Data Warehouse 1.1 FixPack 1 . . . . . . . . . . . . . . . . 52Installing Source Application Warehouse Packs . . 52Installing IBM WebSphere Application Server . . . 53

Installing WebSphere AES 4.0.1 . . . . . . . 53Upgrading from WebSphere AES 4.0.1 . . . . 56Configuring the JDBC Driver in WebSphere . . 56Automatically Starting WebSphere After SystemRestart . . . . . . . . . . . . . . . 57Identifying the WebSphere Node Name . . . . 58

Chapter 4. Installing IBM Tivoli ServiceLevel Advisor . . . . . . . . . . . . 59Before Installing IBM Tivoli Service Level Advisor 59Creating the IBM Tivoli Service Level AdvisorApplication Databases . . . . . . . . . . . 60

Creating Databases on Linux Platforms . . . . 60Modifying Configuration Parameters BeforeCreating Databases . . . . . . . . . . . 61Database and Database Manager ConfigurationParameters . . . . . . . . . . . . . 62Creating the Databases . . . . . . . . . 63Checking Database Creation Logs and Tables . . 64Configuring ODBC Data Sources . . . . . . 64

Running the Install Wizard . . . . . . . . . 65Step 1. Start the InstallShield Program . . . . 66Step 2. Accept the Software License Agreement 67Step 3. Specify the Tivoli Common Directory . . 68Step 4. Specify the Destination Install Directory 69

iii

Step 5. Select SLM Install Options . . . . . . 70Step 6. Specify the Tivoli Presentation ServicesLocation . . . . . . . . . . . . . . 71Step 7. Specify Your WebSphere AES Location . . 72Step 8. Specify the WebSphere Node Name . . . 73Step 9. Specify SLM Database Information . . . 73Step 10. Specify the DB2 Instance HomeDirectory for SLM Databases . . . . . . . 77Step 11. Specify Additional Server Configuration 77Step 12. Specify Event Notification Methods . . 78Step 13. Confirm Your Install Options . . . . 85Step 14. Complete the Installation . . . . . . 85

Chapter 5. Additional Installation Tasks 89Configuring for Event Notification. . . . . . . 89

Configuring for Notification by SNMP . . . . 89Configuring for Notification by Tivoli EnterpriseConsole. . . . . . . . . . . . . . . 89Verifying Notification Methods . . . . . . . 90

Installing the Registration and Process ETLs . . . 90Installing the IBM Tivoli Service Level AdvisorWarehouse Pack . . . . . . . . . . . . 91Configuring the User ID and Password . . . . 92Enabling Data Collection for Source Applications 92Promoting the ETLs to Production Mode . . . 93Running the Registration ETL and Process ETL 94Purging Aged Data from the SLM MeasurementData Mart . . . . . . . . . . . . . . 95

Integrating SLM Reports into WebSphere . . . . 95Integrating into WebSphere AE . . . . . . . 95Integrating into WebSphere AES . . . . . . 98Modifying HTTP Server Ports for WebSphere . . 99Restarting WebSphere . . . . . . . . . . 99Accessing SLM Reports . . . . . . . . . 99

Installing Language Support . . . . . . . . 100

Chapter 6. Startup and ShutdownProcedures . . . . . . . . . . . . 103Starting the IBM Tivoli Service Level AdvisorSolution . . . . . . . . . . . . . . . 103

Starting the Server for IBM Console Service . . 103Starting Web Services for IBM Console . . . . 104Starting the SLM Server . . . . . . . . . 104Starting the IBM Console . . . . . . . . 105Starting IBM WebSphere Application Server . . 106Starting the IBM WebSphere AE 4.0 AdminServer . . . . . . . . . . . . . . . 107Starting the WebSphere Admin Console . . . 107Starting the IBM HTTP Services . . . . . . 107

Shutting Down the IBM Tivoli Service LevelAdvisor Solution . . . . . . . . . . . . 107

Stopping IBM HTTP Services . . . . . . . 108Stopping the IBM WebSphere AE 4.0 AdminServer . . . . . . . . . . . . . . . 108Stopping IBM WebSphere Application Server forWebSphere AES . . . . . . . . . . . 108Shutting Down the IBM Console . . . . . . 109Shutting Down the SLM Server . . . . . . 109Stopping Web Services for IBM Console . . . 109Stopping the Server for IBM Console Service 110

Chapter 7. Uninstalling IBM TivoliService Level Advisor . . . . . . . . 111Considerations Before Uninstalling . . . . . . 111Uninstalling the SLM Task Drivers . . . . . . 111Uninstalling SLM Reports . . . . . . . . . 112

Removing SLM Reports from the WebSphereEnvironment . . . . . . . . . . . . 112Completely Uninstalling SLM Reports . . . . 113

Uninstalling the SLM Server . . . . . . . . 113Uninstalling WebSphere AES 4.0.1 . . . . . . 113Uninstalling SLM Databases . . . . . . . . 114

Dropping the Databases . . . . . . . . . 114Removing ODBC Datasources . . . . . . . 114

Uninstalling the Registration and Process ETLs . . 115Uninstalling Language Support . . . . . . . 115

Chapter 8. Troubleshooting . . . . . 117Installing DB2 . . . . . . . . . . . . . 117

Instance Creation Failed During UNIX DB2Installation . . . . . . . . . . . . . 117

Updating the JDBC Level . . . . . . . . . 118Configuring ODBC Data Sources . . . . . . . 118

Verifying Successful ODBC Data SourceCreation . . . . . . . . . . . . . . 118

Creating SLM Databases. . . . . . . . . . 119Database Creation Scripts Fail . . . . . . . 119Database Uncataloged after Error Specifying aLocal Database as Remote . . . . . . . . 120

Installing IBM Tivoli Service Level Advisor . . . 120Blank Install Window or Incomplete Text . . . 120Install Screen Fonts Not Readable . . . . . 120Cleaning up Temporary ISMP Directories . . . 121Receive DYKIN0005E Error Connecting to SLMDatabases . . . . . . . . . . . . . 121DYKIN0028E Error Received at End of InstallWizard . . . . . . . . . . . . . . 121Service Exception in Install Log . . . . . . 122

Installing SLM Task Drivers . . . . . . . . 122Problem Starting IBM Console After Install . . 122

Installing SLM Reports . . . . . . . . . . 123SLM Reports with IIS Service . . . . . . . 123Cleaning Up After Failed SLM ReportsInstallation . . . . . . . . . . . . . 123

Installing and Configuring the Registration andProcess ETLs . . . . . . . . . . . . . 123

Logging in to the Data Warehouse Center . . . 123Installation of SLM ETLs Fails . . . . . . . 123

System Startup . . . . . . . . . . . . . 124Server Host Name is Not Fully Qualified . . . 124SLM Server Startup Cannot Connect to SLMDatabases . . . . . . . . . . . . . 125Signing In to the IBM Console. . . . . . . 126

Accessing SLM Reports . . . . . . . . . . 126HTTP 500 Internal Server Error or DYKAL3003EError Message . . . . . . . . . . . . 126Accessing SLM Reports in WebSphere AES 4.0 127

Uninstalling IBM Tivoli Service Level Advisor . . 128Uninstalling SLM Install Options . . . . . . 128

iv Getting Started with IBM Tivoli Service Level Advisor

Appendix A. A Two-MachineInstallation Example . . . . . . . . 129Installation Assumptions . . . . . . . . . 1291. Planning for Installation . . . . . . . . . 1312. Installing DB2 Universal Enterprise Edition . . 1313. Installing the DB2 Client . . . . . . . . . 1324. Upgrading to DB2 7.2 Fix Pack 6 . . . . . . 1335. Installing Tivoli Enterprise Data Warehouse . . 1336. Installing Tivoli Enterprise Data Warehouse 1.1Fix Pack 1 . . . . . . . . . . . . . . 1347. Installing WebSphere . . . . . . . . . . 134

Configuring the JDBC Driver for WebSphere 1368. Creating Databases for IBM Tivoli Service LevelAdvisor . . . . . . . . . . . . . . . 1369. Configuring ODBC Data Sources . . . . . . 13710. Installing the SLM Server and SLM Reports . . 13711. Installing SLM Task Drivers . . . . . . . 13912. Installing the SLM Warehouse Pack . . . . . 14013. Configuring the SLM Target ETLs . . . . . 141Populating The Warehouse Database . . . . . 141

Installing Warehouse Enablement Packs . . . 141Installing Sample Data . . . . . . . . . 142

Appendix B. A Three MachineInstallation Example . . . . . . . . 143Installation Assumptions . . . . . . . . . 1431. Planning for Installation . . . . . . . . . 1452. Installing DB2 Server on the UNIX Machines 1453. Installing DB2 Server on the Windows Machine 1474. Upgrading to DB2 7.2 Fix Pack 6 . . . . . . 1475. Configuring the Database Manager to useExtended Shared Memory . . . . . . . . . 1486. Installing the Central Data Warehouse and DataMart . . . . . . . . . . . . . . . . 1497. Installing the Control Server and ReportInterface . . . . . . . . . . . . . . . 150

8. Installing Tivoli Enterprise Data Warehouse 1.1Fix Pack 1 . . . . . . . . . . . . . . 1519. Installing WebSphere . . . . . . . . . . 151

Configuring the JDBC Driver for WebSphere 15210. Creating Databases for IBM Tivoli Service LevelAdvisor . . . . . . . . . . . . . . . 15211. Configuring ODBC Data Sources. . . . . . 15312. Installing the SLM Server and SLM Reports . . 15413. Installing SLM Task Drivers . . . . . . . 15514. Installing Target ETLs . . . . . . . . . 15615. Configuring SLM ETLs . . . . . . . . . 157Populating The Warehouse Database . . . . . 157

Installing Warehouse Packs . . . . . . . . 157Installing Sample Data . . . . . . . . . 158

Appendix C. Database Creation Tables 159Tables Created with dyk_cat_dbinst . . . . . . 159Tables Created with dyk_dm_dbinst . . . . . . 160

Appendix D. Manually Creating ODBCData Sources . . . . . . . . . . . 163

Appendix E. Migrating From PreviousVersions of IBM Tivoli Service LevelAdvisor . . . . . . . . . . . . . . 165Tasks to Complete Before Migrating IBM TivoliService Level Advisor . . . . . . . . . . 167Running the IBM Tivoli Service Level AdvisorMigration Program . . . . . . . . . . . 169Tasks to Complete After Migrating IBM TivoliService Level Advisor . . . . . . . . . . 170

Index . . . . . . . . . . . . . . . 173

Contents v

vi Getting Started with IBM Tivoli Service Level Advisor

Preface

Getting Started with IBM® Tivoli® Service Level Advisor provides information aboutTivoli’s service level management (SLM) solution, and provides step-by-stepinstructions for installing and configuring IBM Tivoli Service Level Advisor, as wellas references to the installation procedures for supporting applications.

Who Should Read This GuideThis document is written for systems administrators and Tivoli ProfessionalServices personnel who plan to install, configure, and integrate IBM Tivoli ServiceLevel Advisor and its supporting applications in the enterprise environment. Youshould be familiar with planning, installing, and configuring distributed systemsmanagement software, and be somewhat familiar with the business objectivesassociated with Tivoli’s service level management solution.

You should also have a working knowledge of IBM DB2® Universal DatabaseEnterprise Edition, in the areas of installing and configuring DB2 servers andclients, creating multiple instances of DB2, cataloging databases, and performingbackup and restore operations to protect your database resources.

You should also be familiar with the following:v HTML concepts for customizing Java™ Server Pages (JSP files) to generate

Web-based reportsv Supported Tivoli applications that are enabled for putting data into the Tivoli

Enterprise Data Warehouse (see the IBM Tivoli Service Level Advisor Release Notesfor information on supported Tivoli applications)

v Data warehouse information and design, extract, transform, and load (ETL)processes

v IBM WebSphere® Application Server, in the areas of installing, configuring, andstarting the Application Server and console

Prerequisite and Related DocumentationThe following documentation is related to the IBM Tivoli Service Level Advisorenvironment.

IBM Tivoli Service Level AdvisorProduct information for using IBM Tivoli Service Level Advisor is found in the/tsladocs directory on the IBM Tivoli Service Level Advisor Documentation CD, inPDF and HTML format.v Getting Started with IBM Tivoli Service Level Advisor

This document introduces you to IBM Tivoli Service Level Advisor and providesinformation about planning, installing, and configuring IBM Tivoli Service LevelAdvisor to run in your Tivoli enterprise environment.

v Administrator’s Guide for IBM Tivoli Service Level Advisor

This document provides information about the administrative tasks you canperform using IBM Tivoli Service Level Advisor to track and manage service levelagreements (SLAs) between your organization and customers who depend onyour enterprise for agreed upon levels of service.

vii

v Command Reference for IBM Tivoli Service Level Advisor

This document provides information on command line interface (CLI)commands available for displaying certain conditions and states inside IBMTivoli Service Level Advisor, and for performing various configuration tasksusing the scmd command.

v IBM Tivoli Service Level Advisor Release Notes

This document provides late-breaking information, such as problems andworkarounds, and patch availability. The most recent version of this file isalways available on the following Web site:http://www.tivoli.com/support/documents/

v Message information is available in a separate HTML file, dyk_messages.html,which contains detailed information for IBM Tivoli Service Level Advisormessages ordered by message number. This enables you to look up messagedetails outside of the IBM Tivoli Service Level Advisor product. The Englishlanguage version of this message HTML file is located on the IBM Tivoli ServiceLevel Advisor Documentation CD in the /tsladocs/en/html/Messages directory.

v Online user assistance for IBM Tivoli Service Level AdvisorThe online user assistance provides integrated online help topics for all IBMTivoli Service Level Advisor administrative tasks that are performed using theIBM Console. Online user assistance is displayed in the Task Assistant portion ofthe IBM Console. Specific information about performing IBM Tivoli ServiceLevel Advisor tasks is documented only in this online user assistance. Whennew products are installed that run in the IBM Console, corresponding onlinehelp topics are also installed and integrated into the existing information base.

IBM DB2 Universal Database Enterprise EditionThe publications required to support IBM DB2 are available on the IBM DB2Universal Database Enterprise Edition CD, or from this IBM Web site:

http://www.ibm.com/software/data/db2/udb

Tivoli Enterprise Data WarehouseIBM Tivoli Service Level Advisor requires Tivoli Enterprise ™ Data Warehouse tobe installed in your enterprise, to serve as the data repository for Tivoliperformance and availability monitoring applications that provide data for servicelevel management. See the following documentation on the Tivoli Enterprise DataWarehouse Documentation CD included with IBM Tivoli Service Level Advisor:v Installing and Configuring Tivoli Enterprise Data Warehouse

v Enabling an Application for Tivoli Enterprise Data Warehouse

v Tivoli Enterprise Data Warehouse Release Notes

Warehouse PacksWarehouse packs are the interfaces that load and transform data collected bysource applications into Tivoli Enterprise Data Warehouse, and from TivoliEnterprise Data Warehouse to other target applications that use the data togenerate reports and perform analyses. Refer to the IBM Tivoli Service Level AdvisorRelease Notes for the online location of the latest warehouse pack information.

IBM Console InformationIBM Tivoli Service Level Advisor requires Tivoli Presentation Services to beinstalled in your enterprise, for use with the IBM Console, the Web-based

viii Getting Started with IBM Tivoli Service Level Advisor

Administration Server graphical user interface (GUI) portion of IBM Tivoli ServiceLevel Advisor. Information on the IBM Console is available in the Administrator’sGuide for IBM Tivoli Service Level Advisor. User assistance for the IBM Console isavailable online from the IBM Console Task Assistant.

IBM WebSphere Application ServerIBM Tivoli Service Level Advisor uses IBM WebSphere Application Server for itsWeb reporting function. See “Installing IBM WebSphere Application Server” onpage 53 for information on WebSphere for use with IBM Tivoli Service LevelAdvisor, and see the official documentation provided on the WebSphere productCD included with IBM Tivoli Service Level Advisor for additional information. Youcan also find the latest WebSphere product information online at the following Website:

http://www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter

Conventions Used in This DocumentThe guide uses several typeface conventions for special terms and actions. Theseconventions have the following meaning:

Bold Lowercase and mixed-case commands, command options, andflags that appear within text appear like this, in bold. Graphicaluser interface elements, except for titles of windows and dialogsand names of keys also appear like this, in bold.

Italic Variables, values you must provide, new terms, and words andphrases that are emphasized appear like this, in italic type.

Monospace Commands, command options, and flags that appear on a separateline, code examples, output, and message text appear like this, inmonospace type. Names of files and directories, text strings youmust type, when they appear within text, names of Java methodsand classes, and HTML and XML tags also appear like this, inmonospace type.

This document uses the UNIX convention for specifying environment variables andfor directory notation. When using the Windows NT command line, replace$variable with %variable% for environment variables, and replace each forwardslash (/) with a backslash (\) in directory paths.

Note: When using the bash shell on Windows NT, you can use the UNIXconventions.

Accessing Publications OnlineYou can access many Tivoli publications online at the Tivoli Customer SupportWeb site:

http://www.tivoli.com/support/documents

These publications are available in PDF or HTML format, or both. Translateddocuments are also available for some products.

To access most of the documentation, you need an ID and password. If necessary,you can obtain these from the following Web site:

Preface ix

http://www.tivoli.com/support/getting

Providing Feedback about PublicationsWe are very interested in hearing about your experience with Tivoli products anddocumentation, and we welcome your suggestions for improvements. If you havecomments or suggestions about our products and documentation, contact us in oneof the following ways:v Send an e-mail to [email protected] Complete our customer feedback survey at the following Web site:

http://www.tivoli.com/support/survey

Contacting Customer SupportIf you have a problem with any Tivoli product, you can contact Tivoli CustomerSupport. See the Tivoli Customer Support Handbook at the following Web site:

http://www.tivoli.com/support/handbook

The handbook provides information about how to contact Tivoli CustomerSupport, depending on the severity of your problem, as well as the followinginformation:v Registration and eligibilityv Telephone numbers and e-mail addresses, depending on the country in which

you are locatedv What information you should gather before contacting support

x Getting Started with IBM Tivoli Service Level Advisor

Chapter 1. Introduction

As today’s enterprise marketplace shifts away from custom in-house businessapplication solutions to more off-the-shelf e-business applications, the Internet hasbecome a vehicle for service delivery within the enterprise as well as externally. Atthe same time, more focus is being placed on increasing productivity andmanaging costs in the enterprise, enabling the information technology (IT)infrastructure to contribute more to the overall success of the business.

What is IBM Tivoli Service Level Advisor?IBM Tivoli Service Level Advisor provides service level management (SLM)capabilities for enterprise organizations that need to measure, manage, and reporton availability and performance aspects of their internal IT infrastructure. WithIBM Tivoli Service Level Advisor, you can more quickly and efficiently obtaininformation to help you manage network and application services. This enablesyou to maintain productivity and customer satisfaction, minimize revenue impact,manage costs, and improve planning by assuring offered services.

IBM Tivoli Service Level Advisor offers intuitive, easy to use interfaces, quick andeasy customization of features, and default values where appropriate.

The SLM solution provided by IBM Tivoli Service Level Advisor also involves anumber of additional IBM and Tivoli applications:v IBM DB2 Universal Database Enterprise Edition (DB2), which provides the

database support for long term storage of measurement data used by IBM TivoliService Level Advisor.

v Tivoli Enterprise Data Warehouse, which uses the DB2 warehouse functions toestablish the central data repository used in the Tivoli SLM solution. Tivoliperformance and availability monitoring applications store their measurementdata in Tivoli Enterprise Data Warehouse, and at some later time this data issent to the local databases used by IBM Tivoli Service Level Advisor. The data isthen evaluated and analyzed, with reports and notifications issued to supportingpersonnel to assist in managing agreed upon levels of service.

v Data is moved in and out of the Tivoli Enterprise Data Warehouse central datawarehouse database with specialized routines that extract the data, transform itinto a usable format, and then load it to another database for further processing.These ETL routines are used with each Tivoli application that puts data into, ortakes data out of, the central data warehouse. In the Tivoli Enterprise DataWarehouse documentation, these ETL routines are referred to as warehouseenablement packs (warehouse packs).

v IBM WebSphere Application Server, used by IBM Tivoli Service Level Advisor togenerate reports resulting from the evaluation and trend analysis of the collectedmeasurement data. The reports are generated using customizable Java servletsthat can be integrated directly into a company’s Web site, providing ready accessto service level management data from a Web browser.

Getting Started with IBM Tivoli Service Level Advisor describes how these applicationswork together in support of the Tivoli SLM solution for the enterpriseenvironment, and guides you through the related planning, installation andconfiguration processes.

1

How IBM Tivoli Service Level Advisor WorksThe service level management capabilities of IBM Tivoli Service Level Advisorcomplement the performance and availability measurement functions of otherTivoli products, such as IBM Tivoli Monitoring for Transaction Performance. IBMTivoli Monitoring for Transaction Performance measures the response time of aWeb site, breaking a service into associated sub-applications that complete ane-business service transaction. IBM Tivoli Service Level Advisor relies on themonitoring and measuring functions of this and other Tivoli applications to gatherdata through their own facilities.

Note: IBM Tivoli Monitoring for Transaction Performance is also known as TivoliWeb Services Manager. Tivoli product names are currently in transition. Seethe IBM Tivoli Service Level Advisor Release Notes for additional informationon Tivoli product name changes.

This performance and availability data is written by the monitoring applications tothe Tivoli Enterprise Data Warehouse database, a centralized repository wherelarge amounts of raw data are summarized and stored. IBM Tivoli Service LevelAdvisor can then use its built in data collector interface to extract and analyze thisdata, determine long term trends, and generate reports of violations or trendstoward violations of guaranteed levels of service. See the Administrator’s Guide forIBM Tivoli Service Level Advisor for information on Tivoli Enterprise DataWarehouse, and refer to the documentation accompanying the Tivoli EnterpriseData Warehouse installation media.

IBM Tivoli Service Level Advisor enables you to manage the information collectedby monitoring applications against service level agreements (SLAs) associated withyour internal enterprise customers, which might be a department or division inyour organization, or some other consumer of services provided by yourenterprise. Analysis of the data collected, identification of trends in service levels,and generated reports can be associated with a specific enterprise customer.

Figure 1. IBM Tivoli Service Level Advisor analyzes performance and availability data from multiple source applicationsthat store their data in Tivoli Enterprise Data Warehouse.

2 Getting Started with IBM Tivoli Service Level Advisor

IBM Tivoli Service Level Advisor in the EnterpriseIBM Tivoli Service Level Advisor resides in the firewall protected, secure back officelayer of your enterprise. Other Tivoli applications responsible for performance andavailability monitoring might reside elsewhere in your enterprise environment. Themonitoring data they collect is stored in their local databases, completely separatedfrom IBM Tivoli Service Level Advisor. These applications and their associateddatabases are referred to as source applications and source databases.

At certain scheduled intervals this data is moved from the source databases intothe Tivoli Enterprise Data Warehouse database, a centralized repository alsolocated in the secure back office layer of your environment, that holds all of theperformance and availability monitoring data of interest from the various sourceapplications. IBM Tivoli Service Level Advisor uses Tivoli Enterprise DataWarehouse as the source for all of its data to be analyzed for guaranteeing levels ofservice in your enterprise IT infrastructure.

IBM Tivoli Service Level Advisor supports a Web application server environmentrunning in the back office layer of the enterprise, as shown in Figure 2. Userinterfaces are accessible through a Web browser, such as Internet Explorer orNetscape Communicator, requiring no additional client footprint. This deploymentscheme provides the easiest and most secure model for IBM Tivoli Service LevelAdvisor, and is suitable when integrating with other environments.

��

��

Figure 2. IBM Tivoli Service Level Advisor is deployed in the secure back office layer of the enterprise.

Chapter 1. Introduction 3

Placing IBM Tivoli Service Level Advisor in the secure back office layer of theenterprise with Tivoli Enterprise Data Warehouse eliminates the need to define asecurity infrastructure. Communication with less secure layers is done over HTTP.

Inside IBM Tivoli Service Level AdvisorThe main functional units of IBM Tivoli Service Level Advisor, as shown inFigure 3, include the following:v The SLM Server, which provides most of the service level management function

for managing orders, scheduling the frequency and times when data is collectedand evaluated, performing the evaluation and analysis of the data, andnotification if violations or trends toward violations of SLAs are detected

v The SLM Reports, which are standard Java-based report servlets that can beintegrated into a customer’s Web site using JavaServer Pages (JSP files). Thesereport servlets summarize the results of the evaluation and analysis, providinginformation in table and graph form that can be customized as desired.

v The SLM Task Drivers, that integrate with the Web-based version of the IBMConsole, Tivoli’s role-based user interface for administrative and customerservice related tasks

These three functional units of IBM Tivoli Service Level Advisor can all exist onthe same machine, or can reside on three separate machines in your enterprise, andeven in different geographical regions, spanning multiple time zones.

The SLM ServerThe SLM Server performs the main functions necessary for service levelmanagement, including:v Processing of ordersv Scheduling and performing evaluation and trend analysis of measurement data

Figure 3. IBM Tivoli Service Level Advisor includes the SLM Server, user interface task drivers, and Java-based reportservlets.


v Storing the results of the analysisv Notification of violations or trends toward violations of SLAs

SLM ReportsThe report servlets utilize the functions of the IBM WebSphere Application Serverto obtain SLA results data and generate summary reports in the form of tables andgraphs that can be displayed in a Web browser. These servlets can be used by theenterprise to create customized web pages for customers, displaying results ofevaluation and trend analyses, such as:v Actual level of service providedv Number of SLA violationsv Trends toward future violations

See the Administrator’s Guide for IBM Tivoli Service Level Advisor for moreinformation on customizing report servlets to integrate into a Web site, and learnmore about the sample JSP files that come with IBM Tivoli Service Level Advisor.

SLM Task DriversThe SLM Task Drivers integrate with the IBM Console to provide a Web-basedgraphical user interface for:v Creating offerings and ordersv Specifying schedules and defining peak times and other schedule states (such as

standard, prime, off hours, and others) for varying levels of servicev Specifying times for when evaluation and trend analysis should take place, and

defining how often the analysis is performedv Specifying breach values for metrics associated with offeringsv Managing active orders

See the Administrator’s Guide for IBM Tivoli Service Level Advisor for moreinformation on the IBM Console user interface for IBM Tivoli Service LevelAdvisor.

IBM Tivoli Service Level Advisor DatabasesIBM Tivoli Service Level Advisor depends on three main databases for itsoperation:v The central data warehouse database from Tivoli Enterprise Data Warehousev The SLM Databasev The SLM Measurement Data Mart

The Central Data Warehouse DatabaseThe Tivoli Enterprise Data Warehouse central data warehouse serves as the centralrepository for historical data for use by many applications, such as IBM TivoliService Level Advisor. Tivoli Enterprise Data Warehouse is the source for resourcerelated data, and is where the various Tivoli performance and availabilitymonitoring applications send their data for long term storage.

See the Administrator’s Guide for IBM Tivoli Service Level Advisor for moreinformation on this database, and refer to the Tivoli Enterprise Data Warehousedocumentation included with IBM Tivoli Service Level Advisor for specificinstallation and configuration details.

Chapter 1. Introduction 5

The SLM DatabaseThe SLM Database serves several purposes:v The SLM Database contains information from Tivoli Enterprise Data Warehouse

that defines possible combinations of components and metrics that are availableto the customer to be used in SLAs. It contains a list of unique resources,resource types, and metric types that exist in Tivoli Enterprise Data Warehouse.This information is referenced during the creation of offerings. See theAdministrator’s Guide for IBM Tivoli Service Level Advisor for information oncreating offerings and orders.

v The SLM Database also contains information specific to the definition andmanagement of customers and SLAs. Offerings and orders that are created usingIBM Tivoli Service Level Advisor are stored in the SLM Database, and make upthe SLAs that are managed by IBM Tivoli Service Level Advisor.

v The SLM Database stores the results of the analysis and trend evaluationprocesses, when service level objectives (SLOs) are compared to expected results.From this information, the customer can view summarized reports that indicatewhether their SLAs are being maintained.

The SLM Measurement Data MartThe SLM Measurement Data Mart is the database containing a subset of themeasurement data from Tivoli Enterprise Data Warehouse that is of interest to IBMTivoli Service Level Advisor in the evaluation and reporting of SLA conformance.It is updated on a regular basis with the latest metric data from Tivoli EnterpriseData Warehouse.


Chapter 2. Planning Decisions

Before installing IBM Tivoli Service Level Advisor into your enterpriseenvironment, you need to consider the hardware requirements, the physicallocations of where you want to install the various functional pieces of IBM TivoliService Level Advisor, and their dependencies on the other Tivoli and IBMapplications which support the Tivoli service level management (SLM) solution.IBM Tivoli Service Level Advisor and all of its supporting applications can beinstalled on a single machine in your enterprise, or across multiple machines withcertain dependencies.

Components of an SLM DeploymentIBM Tivoli Service Level Advisor is designed to run in a number of differentconfigurations, depending on how the system will be used, and which componentsneed to be scaled or isolated.

Note: For this discussion, the term component is used to describe one of the logicalentities within the IBM Tivoli Service Level Advisor installation that can beinstalled by itself on a physical machine or with one or more other logicalentities on the same physical machine.

You can install all of the components of a IBM Tivoli Service Level Advisorinstallation on a single physical machine, or you can distribute them in variouscombinations across multiple machines in your enterprise. Installing on a singlephysical machine is only recommended for use in an evaluation environment, andis not recommended for use in a normal production environment. See Appendix A,“A Two-Machine Installation Example” on page 129, and Appendix B, “A ThreeMachine Installation Example” on page 143 for examples of a minimumrecommended entry level configuration.

Before you can install IBM Tivoli Service Level Advisor, you must have a clearunderstanding of the major components of both Tivoli Enterprise Data Warehouseand IBM Tivoli Service Level Advisor, because the distribution of some of theircomponents is interdependent.

Tivoli Enterprise Data Warehouse ComponentsIf you have not already done so, you should first read and become thoroughlyfamiliar with Installing and Configuring Tivoli Enterprise Data Warehouse, specificallythe information in the Overview and Planning chapters, which discuss the variousmajor components of Tivoli Enterprise Data Warehouse, and information that youneed to know to determine how to distribute the various components of TivoliEnterprise Data Warehouse in your environment. How you deploy TivoliEnterprise Data Warehouse in your environment might affect your decisions ondistributing the components of IBM Tivoli Service Level Advisor. You should alsorefer to the Tivoli Enterprise Data Warehouse Release Notes for additional informationon hardware prerequisites, and specific database and operating system support.

IBM DB2 must be installed on all machines in your enterprise where you plan tolocate one or more components of Tivoli Enterprise Data Warehouse or IBM TivoliService Level Advisor.

7

In brief, the major components of Tivoli Enterprise Data Warehouse that arediscussed in the documentation include the following:

Tivoli Enterprise Data Warehouse control serverThe control server manages communication between the other maincomponents of Tivoli Enterprise Data Warehouse, and also controls theETL processes that move and transform data between the various sourceapplications and Tivoli Enterprise Data Warehouse, as well as the databetween Tivoli Enterprise Data Warehouse and IBM Tivoli Service LevelAdvisor. The control server must be installed on a Windows platform, anduses the following DB2 components:v DB2 Serverv The Data Warehouse Center, a component that automates data

warehouse processingv The warehouse agent, part of DB2 Warehouse Manager.v The warehouse loggerv The warehouse server

Central data warehouseThis is a DB2 database that acts as the central data repository containingthe historical data for your enterprise. Tivoli and other third partyapplications that are installed throughout your enterprise can store theirdata in the central data warehouse. IBM Tivoli Service Level Advisor thenobtains a subset of that data from the central data warehouse and stores itlocally for evaluation and trend analysis. The system where the centraldata warehouse is installed is called the central data warehouse server.

Data martsThese are separate DB2 databases that contain a subset of the historicaldata from the central data warehouse. Tivoli Enterprise Data Warehousecreates its own data marts for use with its own reporting interface. Themachine where these data marts reside is called the data mart server. IBMTivoli Service Level Advisor does not use these data marts. During theinstallation of IBM Tivoli Service Level Advisor, you will create your owndata marts for use by IBM Tivoli Service Level Advisor.

Report interfaceTivoli Enterprise Data Warehouse includes its own reporting interfacewhich contains tools and a graphical user interface that other Tivoliproducts can use to create and display reports to help analyze data in thewarehouse. IBM Tivoli Service Level Advisor has its own reportinginterface which is used to generate reports from the local evaluation andtrend analysis of metric data obtained from the central data warehouse andstored in the IBM Tivoli Service Level Advisor data marts.

Note: The report interface uses the Web console interface to the IBMConsole, part of Tivoli Presentation Services. The installation ofTivoli Enterprise Data Warehouse includes the installation of TivoliPresentation Services, which is also used by IBM Tivoli Service LevelAdvisor. If you already have a supported version of TivoliPresentation Services installed in your enterprise, you must installthe Tivoli Enterprise Data Warehouse report interface and the SLMTask Drivers component of IBM Tivoli Service Level Advisor on thatsame machine. Though Tivoli Presentation Services is supported onboth UNIX and Windows platforms, it is recommended that youinstall the report interface on a Windows system where possible.


These four main components of Tivoli Enterprise Data Warehouse might bedistributed on from one to four systems in your environment, though a typicalconfiguration might be similar to the following:v The control server on a Windows server machine running DB2 Serverv The central data warehouse and data marts together on a large database server

machine (Windows or UNIX), running DB2 Serverv The report interface on a third system, running DB2 Client or DB2 Server. If this

server is also on a Windows platform, you might consider installing it on thesame system as the control server, reducing the configuration to two machines.

Warehouse PacksA warehouse pack, the part of a Tivoli software product that provides warehousefunctionality, can be provided on the installation media for the product, on aseparate CD, or in a collection of warehouse packs. If a warehouse pack isincluded on a CD with other product install code, the warehouse pack informationis located in a separate subdirectory named tedw_apps.

Warehouse packs provide the ETL functionality between the source applications inthe enterprise and Tivoli Enterprise Data Warehouse, moving and transformingdata from various Tivoli and other third party source applications, and storing it inthe central data warehouse. These source ETLs come with each source application,and you can install them using the install program for Tivoli Enterprise DataWarehouse.

IBM Tivoli Service Level Advisor also installs its own warehouse pack, containingtarget ETLs that move and transform data from the central data warehouse into thelocal data marts used by IBM Tivoli Service Level Advisor to evaluate metric dataand analyze the data for trends and violations of service level agreements. Theinstallation of the IBM Tivoli Service Level Advisor warehouse pack also uses theTivoli Enterprise Data Warehouse install program.

All warehouse packs must be installed on the system containing the control servercomponent of Tivoli Enterprise Data Warehouse.

IBM Tivoli Service Level Advisor ComponentsThe components of IBM Tivoli Service Level Advisor have already been introducedin Chapter 1, “Introduction” on page 1, and in summary include the following:v SLM Serverv SLM Reportsv SLM Task Driversv SLM Databasev SLM Measurement Data Mart

In addition, the warehouse pack that provides the ETL functionality between thecentral data warehouse and the SLM Database and SLM Measurement Data Martis installed in the Tivoli Enterprise Data Warehouse control server, along with otherwarehouse packs for source applications.

It is possible for all of these components of IBM Tivoli Service Level Advisor to beinstalled on a single machine, or distributed on multiple machines in yourenterprise. Taking advantage of the Tivoli Enterprise Data Warehouse environmentthat will already have been established, you may choose to install various

Chapter 2. Planning Decisions 9

components of IBM Tivoli Service Level Advisor on the same systems where TivoliEnterprise Data Warehouse components have been installed.

Deploying the SLM Solution in Your EnterpriseThe various components of Tivoli Enterprise Data Warehouse and IBM TivoliService Level Advisor, along with supporting applications (DB2, WebSphere, TivoliPresentation Services, and the warehouse packs) combine together to create theoverall SLM solution for your enterprise.

The Tivoli Enterprise Data Warehouse components that are of interest to IBM TivoliService Level Advisor are the central data warehouse server and the control server.For purposes of this discussion, we will ignore the Tivoli Enterprise DataWarehouse data marts and report interface, because they are not an active part ofthe SLM solution. However, you may choose to locate your SLM Database andSLM Measurement Data Mart on the same system as the Tivoli Enterprise DataWarehouse datamarts, and you must install the SLM Task Drivers on the samesystem where Tivoli Presentation Services (and the Tivoli Enterprise DataWarehouse report interface) is located. These components will be present in theoverall solution, but they are not considered in the deployment examples thatfollow.

Combining the various components of Tivoli Enterprise Data Warehouse and IBMTivoli Service Level Advisor, the components that make up the overall SLMsolution include the following:v Tivoli Enterprise Data Warehouse control serverv Central data warehouse serverv IBM Console Server (including both the Tivoli Enterprise Data Warehouse report

interface and the IBM Tivoli Service Level Advisor SLM Task Drivers)v SLM Serverv SLM Report Server (including IBM WebSphere Application Server)v SLM Databasev SLM Measurement Data Mart

Each of the individual components is shown in Figure 4 on page 11, and isdescribed in the following sections.


The Tivoli Enterprise Data Warehouse Control ServerTivoli Enterprise Data Warehouse control server includes the control server and themanagement of the source and target ETLs, running DB2 Server on a Windowsplatform.

The warehouse packs for source ETLs are installed on this same machine from thewarehouse pack installation media, and the IBM Tivoli Service Level Advisortarget ETLs (referred to later in this document as the Registration ETL and ProcessETL) are installed on this machine from the IBM Tivoli Service Level Advisorinstallation media.

Note: The warehouse packs and target ETLs must be installed on the samephysical machine as the control server.

The control server is supported only on Windows NT and Windows 2000platforms. If the central data warehouse server is also on a Windows 2000 orWindows NT platform, you might prefer to install these two components on thesame physical machine, to eliminate the ETL processing traffic between twoseparate machines across the network in your enterprise.

Figure 4. The components of a IBM Tivoli Service Level Advisor deployment.


The Central Data Warehouse ServerThe central data warehouse server contains the central data warehouse (andtypically the Tivoli Enterprise Data Warehouse data mart server on the samemachine), running DB2 Server on a Windows or UNIX platform.

The Tivoli Enterprise Data Warehouse performance and availability schema, or datamodel, is installed on this DB2 database to personalize the central data warehousefor storing data from the various source applications.

Though other components of Tivoli Enterprise Data Warehouse and IBM TivoliService Level Advisor can reside on this same machine, you might prefer to keepthe central data warehouse on a separate machine to ease its management andmaintenance.

The IBM Console ServerThe IBM Console Server contains Tivoli Presentation Services, the Tivoli EnterpriseData Warehouse report interface, and the SLM Task Driver component of IBMTivoli Service Level Advisor, running DB2 Client or DB2 Server on a Windows orUNIX platform.

Note: It is recommended that you install Tivoli Presentation Services and the IBMConsole Server components on a Windows platform where possible. Sincethe control server is only supported on a Windows platform, you mightconsider installing the IBM Console Server on the same machine, or on adifferent Windows machine.

The IBM Console Server provides support for all task drivers, for both TivoliEnterprise Data Warehouse and IBM Tivoli Service Level Advisor. The IBMConsole is an integral part of the Tivoli user interface architecture. This distributed,device-independent, and platform independent presentation layer provides arole-based user interface for all Tivoli products. It includes both a Java version, anda Web version that can be displayed in a Web browser. IBM Tivoli Service LevelAdvisor uses the Web version for its administrative and customer servicerepresentative tasks, but also takes advantage of functions in the Java version forenabling tracing and viewing logs.

The IBM Console Server is installed as part of the Tivoli Enterprise DataWarehouse installation process, which installs the server function and both Javaand Web versions of the IBM Console, along with an HTTP server forcommunicating with other Web servers and Web browsers.

The IBM Console Server installation includes the following functional units:v Server for IBM Consolev Web Services for IBM Consolev IBM Console

The user interface task drivers for Tivoli Enterprise Data Warehouse reportgeneration (the report interface) are installed here from the Tivoli Enterprise DataWarehouse installation media, and the IBM Tivoli Service Level Advisoradministrative and customer service representative task drivers (the SLM TaskDrivers) are installed here from the IBM Tivoli Service Level Advisor installationmedia. The IBM Console Server can be installed on the same machine as othercomponents, or on a separate machine.


Note: The SLM Task Drivers component of IBM Tivoli Service Level Advisor mustbe installed on the same machine as the IBM Console Server.

The Web services provided by the IBM Console Server installation can support upto 200 simultaneous Web browser connections. This single Web services servershould be sufficient for your enterprise needs.

If the IBM Console Server is installed on a machine different from where the SLMDatabase and SLM Measurement Data Mart are located, then you must install andconfigure a DB2 Client or DB2 Server on the machine containing the IBM ConsoleServer.

Web Browser Requirements: The Web version of the IBM Console requires one ofthe following Web browsers running in your enterprise:v Internet Explorerv Netscape Communicator

Note: While both Internet Explorer and Netscape Communicator are supported,you might experience better performance and reliability using InternetExplorer as your Web browser.

Refer to the Release Notes documentation for Tivoli Enterprise Data Warehouseand IBM Tivoli Service Level Advisor for information on supported Web browserversions.

The SLM ServerThe SLM Server contains the SLM Server component of IBM Tivoli Service LevelAdvisor, running DB2 Server or DB2 Client on a Windows or UNIX platform.

The SLM Server provides the main service level functionality of IBM Tivoli ServiceLevel Advisor. Functions include offering and order creation, scheduling ofevaluation and trend analysis of measurement data from the data warehouse,managing customers and orders, and notifying support personnel and otherapplications when service level agreements are violated or trends indicating apotential violation are detected. The SLM Server is installed from the IBM TivoliService Level Advisor installation media, and can be installed on its own machineor with other components on the same machine.

If the SLM Server is installed on a machine different from the SLM Database andSLM Measurement Data Mart databases, then you must install a DB2 client or DB2Server on the machine with the SLM Server.

See the IBM Tivoli Service Level Advisor Release Notes for recommended hardwarerequirements and supported platforms for the SLM Server.

The SLM Report ServerThe SLM Report Server contains the SLM Reports component of IBM Tivoli ServiceLevel Advisor and is used to support the report servlets that are provided withIBM Tivoli Service Level Advisor. These Java-based report servlets enable acustomer to integrate tables and graphs of service level management reports intotheir company Web sites for viewing by site users using a Web browser.

The SLM Report Server runs within the IBM WebSphere Application Serverenvironment, and supports WebSphere Advanced Edition (AE) and AdvancedEdition Single-Sever (AES) versions. See the IBM Tivoli Service Level Advisor Release


Notes for recommended hardware requirements, supported platforms, andsupported versions of WebSphere for the SLM Report Server.

Note: The SLM Reports component of IBM Tivoli Service Level Advisor requiresIBM WebSphere Application Server, and must be installed on the samesystem where WebSphere is located.

Your enterprise can use an existing version of WebSphere if you already have asupported version installed in your enterprise. If not, you can install the version ofWebSphere AES 4.0.1 that is shipped with IBM Tivoli Service Level Advisor (youcan optionally upgrade to more recent versions by downloading the installationmedia from the WebSphere Web site, if desired).

If any supported version of WebSphere AES is used, IBM Tivoli Service LevelAdvisor will automatically integrate the SLM Reports into WebSphere when theSLM Reports are installed. If a supported version of WebSphere AE is installed,however, you must manually configure the report servlets to integrate intoWebSphere, following the procedure defined in this document.

Refer to the official documentation for IBM WebSphere Application Server foradditional recommendations on hardware requirements and supported platforms.

If the SLM Reports are installed on a machine different from the SLM Databaseand the SLM Measurement Data Mart databases, then you will need to install aDB2 Client or DB2 Server on the machine with the SLM Reports.

The SLM Application Database ServerThe SLM Application Database Server is the database server that contains the SLMDatabase and the SLM Measurement Data Mart databases used by IBM TivoliService Level Advisor. Depending on your deployment, these databases can becreated on the same machine as the central data warehouse, located in one DB2instance, or they can be distributed across multiple DB2 instances, on one or moremachines, for scalability, availability, and performance considerations. These DB2databases run on either a Windows or UNIX DB2 Server machine.

In a DB2 production environment you might prefer to set up multiple instances ofDB2 to enable starting and stopping of the SLM Database and SLM MeasurementData Mart for setup and configuration, without disrupting another database serverinstance. By separating the databases into different instances on different DB2management systems, the IBM Tivoli Service Level Advisor solution performsbetter and is better protected from data loss.

The installation and configuration procedures for the IBM Tivoli Service LevelAdvisor databases requires starting, stopping, and terminating the instance,thereby bringing down any applications connected to that instance. See the officialDB2 documentation for more information on creating and managing multipleinstances of DB2.

Implementing a distributed environment for the individual databases adds a levelof complexity to the creation and configuration of the databases and the TivoliSLM solution. Consult with your database administrator to determine the bestsolution for IBM Tivoli Service Level Advisor.

For each IBM Tivoli Service Level Advisor database you create, approximately 30to 50 MB of space is initially required to hold the database tables. Approximatelythe same amount of memory is also required.


See the IBM Tivoli Service Level Advisor Release Notes for recommended hardwarerequirements and supported platforms for SLM databases. Refer also to the officialdocumentation for DB2 for additional recommendations on hardwarerequirements.

Deployment OptionsYou can deploy the various components of IBM Tivoli Service Level Advisor indifferent ways according to your enterprise needs and capabilities. Both TivoliEnterprise Data Warehouse and IBM Tivoli Service Level Advisor offer manypossible combinations of deployment options. You should plan your DB2installation and the deployment for Tivoli Enterprise Data Warehouse first, sinceyou will install those first, and then decide how best to fit IBM Tivoli Service LevelAdvisor into the resulting environment.

A Widely Distributed SLM DeploymentA widely distributed SLM solution deployment would consist of all (or nearly all)components existing on different machines in your enterprise. This is essentiallythe deployment suggested in Figure 4 on page 11, with each shaded box in thefigure representing a different physical machine. Note that this configuration couldbe distributed even further by locating the Tivoli Enterprise Data Warehouse datamarts and IBM Tivoli Service Level Advisor databases on separate machines.

When considering a widely distributed deployment, you should be aware of thefollowing:v The source and target ETLs (warehouse packs) must be installed on the same

physical machine as the Tivoli Enterprise Data Warehouse control server, whichmust be on a supported Windows platform.

v The SLM Task Drivers must be installed on the same physical machine as theIBM Console Server, which includes the Web Services for IBM Consolecomponent of Tivoli Presentation Services. Since the Tivoli Enterprise DataWarehouse report interface also uses Tivoli Presentation Services, thesecomponents must all be installed on the same machine.

v The SLM Reports must be installed on the same physical machine as IBMWebSphere Application Server. WebSphere must be installed before SLM Reportsis installed.

v If the control server and the central data warehouse are installed on differentmachines, the measurement data from source applications that is processed bythe source ETLs must travel over the network from the control server to thecentral data warehouse server machine. Your enterprise should have thecapability to handle large amounts of data transfer between these machines.

v Refer to the documentation for Tivoli Enterprise Data Warehouse for anyadditional considerations regarding deployment and operation of the datawarehouse environment.

Minimum SLM DeploymentFor very small production environments, you might prefer to install all three of theIBM Tivoli Service Level Advisor install options on one machine, with all of thedatabases on the same machine, as shown in Figure 5 on page 16.

When considering a minimum deployment, you should be aware of the following:v The central data warehouse should reside in a separate DB2 instance from the

SLM Database and the SLM Measurement Data Mart application databases. Youmight prefer to keep warehouse databases separate from application databases,


for improved performance and better protection against data loss. DB2 enablesyou to have multiple instances on the same physical machine.

v Because the control server is only supported on Windows NT and Windows2000 platforms, your single machine deployment is only supported on thoseplatforms.

v Because Tivoli Presentation Services (installed as part of the Tivoli EnterpriseData Warehouse) and IBM WebSphere Application Server both use the same IBMHTTP Server port number (80) and IBM HTTP Administration port (8008) bydefault, you must manually reconfigure one of these applications to use adifferent set of ports.

Mid-Sized DeploymentsThere are a number of different possible mid-sized deployments, depending on therequirements of the enterprise. In general, almost any combination of componentsdescribed above can be installed alone or with other components.

In addition to the considerations described previously for minimum and maximumdeployments, keep in mind the following as you decide on a mid-sizeddeployment:v In general, in all but the smallest of production environments, the central data

warehouse and the SLM databases should be on separate physical DB2 servers

Figure 5. A minimum SLM Deployment on a single machine.


to ease in database management, improve performance, and minimize disruptionto other applications when the DB2 instance is terminated or shut down forconfiguration or maintenance.

v If the central data warehouse is installed on the Windows NT or Windows 2000platform, the control server can be installed on the same machine.

v Unless there is a reason for the SLM Report Server to be on a separate machinefrom the SLM Server (for example, due to Web scalability requirements), youmight prefer to install both of these on the same machine.

One possible mid-sized deployment based on these considerations is shown inFigure 6, using three separate machines.

In a more compact mid-sized deployment, as shown in Figure 7 on page 18, TivoliPresentation Services (installed as part of the Tivoli Enterprise Data Warehouse)and IBM WebSphere Application Server both use the same IBM HTTP Server portnumber (80) and IBM HTTP Administration port (8008) by default. You mustmanually reconfigure one of these applications to use a different set of ports.

Figure 6. A sample mid-sized deployment.


Additional Deployment ConsiderationsWhen you install IBM Tivoli Service Level Advisor, you are given the option toinstall the SLM Server, the SLM Task Drivers, and the SLM Reports on the samephysical machine or on multiple machines. In general, installing these options onthe same machine helps to centralize the logging information in one place, andalso shortens the backup and restore processes. If these options are installed onmultiple machines, associated logging information will be located on eachmachine. Backup and restore procedures must be repeated on each machine wherean installed SLM option is located.

Selecting Port NumbersYou must allocate port numbers for Tivoli Enterprise Data Warehouse and for IBMTivoli Service Level Advisor for the following purposes:v Communication between the control server and other components of Tivoli

Enterprise Data Warehouse and IBM Tivoli Service Level Advisor installed ondifferent machines

v Communication with the IBM Consolev Communication between the various components of IBM Tivoli Service Level

Advisor and its SLM databases, if they are distributed on multiple systemsv Communication with IBM WebSphere Application Server in support of the SLM

Reports component of IBM Tivoli Service Level Advisor.

Refer to the Planning chapter of Installing and Configuring Tivoli Enterprise DataWarehouse for specific information on port numbers used by Tivoli Enterprise DataWarehouse. Table 1 on page 19 lists the default port numbers that are used by IBM

Figure 7. Another sample mid-sized deployment.


Tivoli Service Level Advisor. You can choose to accept these defaults, or you canspecify alternate unused port numbers, if desired, during the installation process.

If you plan to install the SLM Reports and SLM Task Driver components of IBMTivoli Service Level Advisor on the same system, you may have to resolve a portconflict between Tivoli Presentation Services, which is installed with TivoliEnterprise Data Warehouse in support of the IBM Console, and WebSphere, whichis installed as a prerequisite to installing SLM Reports. Both Tivoli PresentationServices and Websphere use the same default port numbers for the IBM HTTPServer Port (80) and IBM HTTP Administration Port (8008). You should either planto select a different set of unused ports during the installation of Tivoli EnterpriseData Warehouse, or plan to modify the ports used by WebSphere after installation.

Table 1. Default port numbers used by IBM Tivoli Service Level Advisor

For the IBM Console and Tivoli Presentation Services

Defaultportnumber

Name of port inTivoli EnterpriseData WarehouseInstallShieldwizard 2

Description Can this default bechanged?

80 IBM HTTP ServerPort

Used by Tivoli PresentationServices HTTP Server forHTTP communications

Yes, during the install of thereport interface componentof Tivoli Enterprise DataWarehouse or by editing theproperties file manually afterinstall 1

8008 IBM HTTPAdministrationPort

Used by Tivoli PresentationServices for HTTPAdministration

Yes, during the install of thereport interface componentof Tivoli Enterprise DataWarehouse or by editing theproperties file manually afterinstall 1

For IBM WebSphere Application Server

Defaultportnumber

Name of portused byWebSphereinstall process


80 IBM HTTP ServerPort

Used by IBM WebSphereApplication Server for HTTPcommunications

Yes, after installingWebsphere by editing theproperties file 1

8008 IBM HTTPAdministrationPort

Used by IBM WebSphereApplication Server for HTTPAdministration

Yes, after installingWebsphere by editing theproperties file 1

For the SLM Database and SLM Measurement Data Mart DB2 databases

Defaultportnumber

Name of portused ininstallationscripts



Table 1. Default port numbers used by IBM Tivoli Service Level Advisor (continued)

50000 DB2Communicationport

Used by DB2 forcommunication with remotedatabases. This value isassumed in the install scriptsand ODBC datasourcecreation scripts, and isspecified during install ofSLM components.

Yes, by editing the installscripts before running tocreate SLM databases andODBC datasources:

v dyk_cat_dbinst

v dyk_dm_dbinst

v dyk_cat_odbc

v dyk_dm_odbc

For the SLM Server, SLM Task Drivers, and SLM Reports components of IBM Tivoli ServiceLevel Advisor

Defaultportnumber

Name of portused inInstallShieldwizard


9980 SLM ServerCommunicationPort

This is the port used forcommunication between theSLM Server, SLM TaskDrivers, and SLM Reportcomponents. This is also theport specified when bringingup the SLM Reports consolein your Web browser to viewreports.

Yes, this port number can beset during IBM Tivoli ServiceLevel Advisor installation.When components of IBMTivoli Service Level Advisorare installed on separatemachines, this port numbermust be the same on allmachines.

9990 Command LineInterface Port

This is the port used forcommunication with theCommand Line Interface.

Yes, this port can be setduring IBM Tivoli ServiceLevel Advisor installation.

For event notification

Defaultportnumber

Name of portused inInstallShieldwizard


162 SNMP TrapDestination Port

This is the SNMP Trapdestination port used by theSNMP Trap option for eventnotification.

Yes, this port number can beset during IBM Tivoli ServiceLevel Advisor installation.

5529 Tivoli EnterpriseConsole EventServer Port

This is the port that theTivoli Enterprise ConsoleEvent Server listens to forevents.

Yes, this port can be setduring IBM Tivoli ServiceLevel Advisor installation.

1 You only need to modify this port number if there is a conflict between TivoliPresentation Services and WebSphere on the same system.

2 Refer to Installing and Configuring Tivoli Enterprise Data Warehouse for additional portsused during installation.

Coexistence with Other DB2 Database ApplicationsTivoli Enterprise Data Warehouse uses the following databases:

TWH_MDThe control database on the control server

TWH_CDWThe central data warehouse database


TWH_MARTThe data mart database

IBM Tivoli Service Level Advisor uses the following databases:

DYK_CATThe SLM Database

DYK_DMThe SLM Measurement Data Mart

If you are installing IBM Tivoli Service Level Advisor in an existing DB2 instance,make sure that databases with these names do not already exist.

Information to Gather Before InstallingThe following tables can be used as a set of worksheets to help you gather theinformation you will need when you install IBM Tivoli Service Level Advisor andthe supporting applications.

Information for All InstallationsFill out Table 2 for all installations of IBM Tivoli Service Level Advisor.

Table 2. Information for all installations

Information needed Why you need to know Record your informationhere

Do you want to install to asingle system or to adistributed system?

Determines which checkliststo complete. Aftercompleting this checklist,refer to the following:

v For single system, useTable 3 on page 26

v For distributed, use Table 4on page 27

Do you want to install fromCDs or from CD imagescopied onto local or networkspace?

Copying the media to a localor shared network filesystem can speed up theinstallation and allowportions of it to rununattended. This is especiallyhelpful when performing adistributed installation.

Do you want IBM TivoliService Level Advisor toprovide support forlanguages other thanEnglish?

If so, be sure to complete theinstallation procedure forinstalling language packsupport after installing IBMTivoli Service Level Advisor.


Table 2. Information for all installations (continued)


If Tivoli Enterprise DataWarehouse is not alreadyinstalled, do you have a Webserver already installed (for adistributed install, on thesystem where you plan toinstall the SLM Reportscomponent, or on the singlesystem)?

You must uninstall or disableit. There should only be oneWeb server on a system.When the report interfacecomponent of TivoliEnterprise Data Warehouse isinstalled, it installs TivoliPresentation Services, whichprovides its own Web server.If you later plan to installWebSphere ApplicationServer on the same system insupport of SLM Reports, youwill need to resolve portconflicts.

Can each system providefully qualified host names?

This function is required forall systems wherecomponents of TivoliEnterprise Data Warehouseand IBM Tivoli Service LevelAdvisor are installed. Referto “Step 3. Ensure fullyqualified host names” onpage 31 for details onensuring fully qualified hostnames.

Does each system have therequired hardware andsoftware prerequisites,including patch levels?

It is difficult to debuginstallation problems thatresult from missingprerequisites. Refer to IBMTivoli Service Level AdvisorRelease Notes for informationon hardware and softwareprerequisites and patchlevels.

Did you check the Web sitefor the most currentinformation aboutprerequisites and requiredservice?

It is difficult to debuginstallation problems thatresult from missingprerequisites. Refer to IBMTivoli Service Level AdvisorRelease Notes for the locationof the Web site.




Is IBM DB2 installed on alltarget systems?

v If it is, check the versionand configuration of DB2to assure a successfulinstallation of IBM TivoliService Level Advisor, andalso check for databasename conflicts (see“Coexistence with OtherDB2 DatabaseApplications” on page 20

v If not, install it asdescribed in “InstallingDB2” on page 30, referringto specific DB2 installinformation in the TivoliEnterprise Data Warehousedocumentation as needed.

v You may also need toupgrade to DB2 7.2 withFix Pack 6.

Is Tivoli Enterprise DataWarehouse already installedin your enterprise?

v If it is, check the versionand configuration toassure a successfulinstallation of IBM TivoliService Level Advisor.

v If not, install it asdescribed in “InstallingTivoli Enterprise DataWarehouse 1.1” onpage 39, referring tospecific install informationin the Tivoli EnterpriseData Warehousedocumentation as needed.




Is IBM WebSphereApplication Server alreadyinstalled in your enterprise?

If so, do you know the installdirectory?

If so, do you know the nodename that WebSphereassigned to the system toidentify the machine whereWebSphere is running?

v If it is, check the versionand configuration toassure a successfulinstallation of IBM TivoliService Level Advisor. Youmay need to upgrade to asupported version (AE orAES only).

v You will be prompted forthe install directory andnode name to tell IBMTivoli Service LevelAdvisor where WebSphereis installed. Typically theinstall directory is in theform of:

– For Windows:

C:\WebSphere\AppServer

– For UNIX:

/usr/WebSphere/AppServer

See “Identifying theWebSphere Node Name”on page 58 for the

procedure to determineyour WebSphere nodename, and record it herefor later use.

v If not, install it AFTERinstalling DB2 and TivoliEnterprise DataWarehouse, as described in“Installing IBM WebSphereApplication Server” onpage 53 and be sure tofollow the additionalinstall procedures in“Integrating SLM Reportsinto WebSphere” onpage 95 after installingIBM Tivoli Service LevelAdvisor

If installing on a UNIXsystem, are you the rootuser?

If installing on a Windowssystem, do you haveAdministrator privileges?

These are required in orderto run the installationprogram.




Target directory for the TivoliCommon Directory

If IBM Tivoli Service LevelAdvisor is the first Tivoliapplication to be installed onthis machine, the TivoliCommon Directory will becreated for Tivoliapplications to place logsand message files in acommon location. If it is notthe first Tivoli applicationinstalled, the install wizardwill detect the location foryou.

Destination directory whereyou plan to install IBM TivoliService Level Advisor

You will be prompted forthis during the installprocess. Typically the installdirectory for IBM TivoliService Level Advisor is inthe form of:

v For Windows:

C:\Program Files\TSLA

v For UNIX:

/usr/TSLA

If Tivoli Presentation Servicesis installed, what is thelocation?

The install wizard searchesfor the location of TivoliPresentation Services(typically C:\PS) and if notfound it asks you for thelocation.

If you plan to enable eventnotification, whichtechnique(s) will you use:

v E-mail

v SNMP trap

v TEC Event

You will need to specifyadditional install informationif one or more of these typesof event enablement areenabled.

If you selected e-mail eventnotification, specify thefollowing:

v SMTP Server host name

v One or more e-mailaddresses to send eventinformation to

v Optionally one or moree-mail addresses to beincluded in the CC-List forthe e-mail

This information is used inconstructing the e-mails to besent with event informationto personnel responsible formonitoring and managingevent notifications.




If you selected SNMP Trapevent notification, specify thefollowing:

v Fully qualified destinationhost name of the receivingSNMP managementstation

v SNMP Trap destinationport number (default is162)

v Optionally, the communityname of the trap service

This information defineswhere SNMP trap events areto be sent for handling.

If you selected TEC Eventnotification, specify thefollowing:

v Host name where theevent server is installed

v If the event server is on aWindows machine, theport number the systemlistens to for events(default is 5529)

This information defineswhere TEC events are to besent for handling.

Additional Information for Single System InstallationsFill out Table 3 for single system installations of IBM Tivoli Service Level Advisor.

Table 3. Additional information for single-system installations


Fully qualified host name ofthe system to install on

Refer to “Step 3. Ensure fullyqualified host names” onpage 31 for information onensuring fully qualified hostnames.

User name and password toaccess the existing DB2instance on the system

Get the DB2 user name andpassword from the personwho installed or administersthe database.

Unique port numbers to beused by Tivoli PresentationServices and WebSphere forIBM HTTP Server. Defaultvalues for both products are:

v IBM HTTP Server: 80

v IBM HTTP Administration:8008

Both products use the sameport numbers by default, andwill cause port conflictswhen installed on the samemachine. You should plan tochange the set of ports foreither of these applications tounused values, for example:




Additional Information for Distributed InstallationsFill out Table 4 for distributed installations of IBM Tivoli Service Level Advisor.

Table 4. Additional information for distributed installations

Connection information for components installed on other systems. This information is notrequired if components are installed on the same system.

Remote component Information needed Record your informationhere

SLM Server Fully qualified host name

DB2 user ID and passwordfor the existing DB2 instanceon the SLM Server machine

Database port number(default is 50000)

SLM Task Drivers Fully qualified host name

DB2 user ID and passwordfor the existing DB2 instanceon the SLM Task Driversmachine


SLM Reports Fully qualified host name

DB2 user ID and passwordfor the existing DB2 instanceon the SLM Reports machine


SLM Database Fully qualified host name

DB2 user ID and passwordfor the existing DB2 instanceon the SLM Databasemachine


SLM Measurement DataMart

Fully qualified host name

DB2 user ID and passwordfor the existing DB2 instanceon the SLM MeasurementData Mart machine


For SLM Task Drivers and SLM Reports when installed on systems different from wherethe SLM Server is located



Table 4. Additional information for distributed installations (continued)

If you are installing the SLMTask Drivers or the SLMReports component on adifferent system from theSLM Server, specify thefollowing:

v Fully qualified host nameof the system where theSLM Server is installed

v The SLM Servercommunication port(default is 9980)

This information is need forthe SLM Task Drivers andSLM Reports components ofIBM Tivoli Service LevelAdvisor to communicatewith the SLM Server when itis installed on a remotesystem.

For SLM Task Drivers and SLM Reports when installed on the same system


If you are installing the SLMTask Drivers (which uses theIBM Console and TivoliPresentation Services) andthe SLM Reports (which usesWebSphere as the applicationserver) on the same system,you must make sure thatport numbers used by TivoliPresentation Services andWebSphere for IBM HTTPServer and IBM HTTPAdministration are unique.Default values for bothproducts are:



Both products use the sameport numbers by default, andwill cause port conflictswhen installed on the samemachine. You should plan tochange the set of ports foreither of these applications tounused values, for example:



Planning for Warehouse PacksThe warehouse pack for the target ETLs for IBM Tivoli Service Level Advisor isincluded on the installation media for IBM Tivoli Service Level Advisor.

You will use the installation program for Tivoli Enterprise Data Warehouse toinstall the IBM Tivoli Service Level Advisor warehouse pack, after the installationwizard for IBM Tivoli Service Level Advisor has completed successfully.

It is possible to install the IBM Tivoli Service Level Advisor warehouse packduring the installation of Tivoli Enterprise Data Warehouse, but this is notrecommended. The preferred method is to install the core application as describedin “Installing Tivoli Enterprise Data Warehouse 1.1” on page 39, and after installingIBM Tivoli Service Level Advisor, install the IBM Tivoli Service Level Advisorwarehouse pack following the procedure in “Installing the Registration and ProcessETLs” on page 90.


Chapter 3. Installing Supporting Applications

The installation of the Tivoli service level management (SLM) solution begins withthe installation of the following supporting applications:v IBM DB2 Universal Database Enterprise Edition (DB2)v Tivoli Enterprise Data Warehousev IBM WebSphere Application Server

IBM Tivoli Service Level Advisor, Version 1.2 requires that you install the followingversions of these supporting applications:

IBM DB2 7.2 with Fix Pack 5This is the base version of DB2 that is shipped with IBM Tivoli ServiceLevel Advisor

IBM DB2 7.2 Fix Pack 6This is a required upgrade that you can download from the TivoliEnterprise Data Warehouse support Web site and use to upgrade DB2 tothe supported version

Tivoli Enterprise Data Warehouse 1.1This is the base version of Tivoli Enterprise Data Warehouse that isshipped with IBM Tivoli Service Level Advisor

Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1This is a required upgrade that you can download from the TivoliEnterprise Data Warehouse support Web site and use to upgrade TivoliEnterprise Data Warehouse to the supported version

IBM WebSphere Application ServerYou can use an existing installation of WebSphere Application Server if it isone of the following supported versions:v WebSphere Advanced Edition (AE)v WebSphere Advanced Edition, Single-server (AES)

Note: WebSphere Standard Edition (SE) is no longer supported by thisversion of IBM Tivoli Service Level Advisor.

IBM WebSphere AES 4.0.1 is shipped with IBM Tivoli Service LevelAdvisor. You can upgrade to other supported versions by downloadingthem from the IBM WebSphere support web site. If you are installing in anon-English environment, you must upgrade to at least version 4.0.2.

Migrating From Previous VersionsYou may already have previous versions of DB2, Tivoli Enterprise Data Warehouse,WebSphere, databases, or source and target ETLs installed in your enterprise. Insome cases you may need to upgrade or migrate to a more recent supportedversion for proper operation of IBM Tivoli Service Level Advisor. Refer toAppendix E, “Migrating From Previous Versions of IBM Tivoli Service LevelAdvisor” on page 165 for information on specific versions of prerequisites needed,and plan to upgrade your existing installation if needed.

29

Installing DB2Before you install DB2 on any system, you need to have a clear understanding ofthe distribution of systems within your enterprise that will contain the majorcomponents of Tivoli Enterprise Data Warehouse and IBM Tivoli Service LevelAdvisor. Both Tivoli Enterprise Data Warehouse and IBM Tivoli Service LevelAdvisor require DB2 to be installed on all machines where these products will beinstalled, in either single-system or distributed configurations.

Starting a DB2 Command PromptBefore you can issue DB2 commands in a Windows or UNIX environment, youmust first set up the db2 command session environment. For Windows, you issuethe db2cmd command to begin a DB2 command prompt. For UNIX, you source thedb2profile. You will find many references to this setup procedure throughout thedocumentation.

Starting a Windows DB2 Command PromptTo start a DB2 command prompt in Windows, do the following:1. From your desktop, select Start –> Run

2. In the Run dialog that is displayed, enter the command db2cmd

Sourcing the db2profile on UNIXBefore you can issue db2 commands on UNIX systems, you must first set up theenvironment by sourcing the db2profile. To set up your environment for issuing DB2commands, do the following:1. While logged in as root, navigate to the DB2 instance owner directory

<db2_instance_dir>/sqllib

2. Run one of the following scripts:v For bash, Bourne, or Korn shells:

. db2profile

v For C shell:source db2cshrc

Step 1. Read the documentationThe documentation for Tivoli Enterprise Data Warehouse already includes detailedplanning and installation information for installing DB2, and the DB2 requirementsfor supporting IBM Tivoli Service Level Advisor are very similar. For this reason,you should refer to the Tivoli Enterprise Data Warehouse documentation for detailson installing DB2 for both Tivoli Enterprise Data Warehouse and IBM TivoliService Level Advisor, because much of that information is not repeated here.

If you have not already done so, you must first read and become thoroughlyfamiliar with the following documentation:v Installing and Configuring Tivoli Enterprise Data Warehouse, specifically the

information in the Overview and Planning chapters, which discuss the variousmajor components of Tivoli Enterprise Data Warehouse, and information thatyou need to know to determine how to distribute the various components ofTivoli Enterprise Data Warehouse in your environment. Also in Installing andConfiguring Tivoli Enterprise Data Warehouse, be sure to read and understandChapter 3, which includes useful information in the following areas:– Ensuring fully qualified host names– Mounting a CD-ROM device on UNIX systems– Installing and configuring a DB2 client or server


v Read the DB2 Quick Beginnings document for the operating system on which youare installing.

v Read Chapter 2, “Planning Decisions” on page 7 and complete the planningchecklists to make sure you have all of the information you need to perform theinstallation.

For each system where you plan to install one or more components of TivoliEnterprise Data Warehouse or IBM Tivoli Service Level Advisor, install DB2according to the steps detailed in the following sections.

Step 2. Verify the Root User Authority in DB2On UNIX operating systems, you must verify that the root user has the properauthority (SYSADM) in DB2. To verify that root belongs to the proper group, dothe following:1. Source the db2profile2. Enter the following command to see which system group name is defined as

the SYSADM control group:db2 get dbm cfg | grep SYSADM_GROUP

The output of the previous command should be similar to the following:SYSADM group name(SYSADM_GROUP) = DB2GROUP

3. Record the name of the SYSADM_GROUP (DB2GROUP in the previousexample), for reference in the following steps.

4. Issue the command groups root to verify that root is a member of that group.5. If root is not a member of that group, add the root user to the group listed in

step 3 using the user administration tools for your operating system.

Note: If the SYSADM_GROUP field is blank, use the user administration tools foryour operating system to create a system group that includes both theinstance owner and the root user. Log in as the DB2 instance owner and addthis group to the database manager configuration with the followingcommand, where <new_group_name> is the name of the group you created tocontain the instance owner and the root user:db2 update dbm cfg using SYSADM_GROUP <new_group_name>

Step 3. Ensure fully qualified host namesYour operating system must be configured to provide Tivoli Enterprise DataWarehouse, IBM Tivoli Service Level Advisor, and Tivoli Presentation Services witha fully qualified computer name rather than a short name. This is especiallyimportant in environments with many different operating systems. To ensure that asystem is configured to provide a fully qualified computer name, complete thesteps in the following sections.

On AIX systemsThe default domain name search order is as follows:1. Domain Name System (DNS) server2. Network Information Service (NIS)3. Local /etc/hosts file

If the /etc/resolv.conf file does not exist, the /etc/hosts file is used. If only the/etc/hosts file is used, the fully qualified computer name must be the first onethat is listed after the IP address.

Chapter 3. Installing Supporting Applications 31

Verify that the /etc/resolv.conf file exists and contains the appropriateinformation, such as:domain mydivision.mycompany.com

nameserver 123.123.123.123

If NIS is installed, the /etc/irs.conf file overrides the system default. It containsthe following information:hosts = bind, local

If the NSORDER environment variable is set, it overrides all of the preceding files.It contains the following information:export NSORDER=bind, local

On Linux systemsVerify that the /etc/resolv.conf file exists and contains the appropriateinformation, such as:domain mydivision.mycompany.com

nameserver 123.123.123.123

A short name is used if the /etc/nsswitch.conf file contains a line that begins asfollows and if the /etc/hosts file contains the short name for the computer:hosts: files

To correct this, follow these steps:1. Change the line in the /etc/nsswitch.conf file to:

hosts: dns nis files

2. Stop the network service3. Restart the network service

On Solaris systemsVerify that the /etc/resolv.conf file exists and contains the appropriateinformation, such as:domain mydivision.mycompany.com

nameserver 123.123.123.123

A short name is used if the /etc/nsswitch.conf file contains a line that begins asfollows and if the /etc/hosts file contains the short name for the computer:hosts: files

To correct this, follow these steps:1. Change the line in the /etc/nsswitch.conf file to:

hosts: dns nis files

2. Enter the following command to stop the inet service:/etc/init.d/inetsvc stop

3. Enter the following command to restart the inet service:/etc/init.d/inetsvc start

On Microsoft Windows NT systemsTo verify that a primary domain name system (DNS) suffix is set, follow thesesteps:1. From the Windows task bar, click Start –> Settings –> Control Panel

2. In the Control Panel window, double-click Network.


3. Click the Protocols tab.4. Select the TCP/IP protocol and then click Properties

5. Click the DNS tab6. Ensure that the field Domain contains a domain suffix. If it does not, type the

suffix, click OK, and restart the computer when prompted.

On Windows 2000 systemsTo verify that a primary domain name system (DNS) suffix is set, follow thesesteps:1. On the desktop, right-click My Computer

2. Click Properties

3. Click the Network Identification tab.4. Ensure that the field Full Computer Name contains a fully qualified domain

name. If it does not, follow these steps:a. Click Properties

b. Click More

c. In the field Primary DNS suffix for this computer, type the primary DNSsuffix, and restart the computer when prompted.

Step 4. On UNIX, mount the CD-ROMMount the CD-ROM device by inserting the DB2 product CD and doing thefollowing:1. Issue the following command:

v For AIX, issue the following command, where <mount_dir> is the mountdirectory:mount -rv cdrfs /dev/cd0 <mount_dir>

v For Solaris, the CD is automatically mounted on /cdrom/cdrom0

v For Linux, issue the following command:mount /mnt/cdrom

2. Change to the mounting directory.

Refer to Installing and Configuring Tivoli Enterprise Data Warehouse for additionaldetails on mounting the CD-ROM for supported UNIX platforms.

Step 5. Check the version of any existing DB2 installationTo use an existing version of DB2 client or server, verify that it is at least at theDB2 7.2 with Fix Pack 5 level. You can determine the level of DB2 you haveinstalled by doing the following:1. Start a DB2 command prompt2. At the command prompt, issue the following command:

db2level

The db2level command returns a block of information that includes the levelidentifier and an informational token. For example, the informational token for thebase DB2 product as well as DB2 with fix packs 4, 5, and 6 are as follows:

Table 5. DB2 version information for base DB2 and fix packs.

Informational Token DB2 Version

DB2 v7.1.0.40 Base DB2 7.2


Table 5. DB2 version information for base DB2 and fix packs. (continued)

Informational Token DB2 Version

DB2 v7.1.0.51 DB2 7.2 with fix pack 4



If you have a level prior to DB2 7.2 with Fix Pack 5, you must upgrade it at leastto this level before continuing. Refer to your available DB2 documentation foruninstalling prior versions, or upgrade your existing version to at least DB2 7.2with Fix Pack 5.

Step 6. Install DB2 7.2 with Fix Pack 5If you do not already have an installed version of DB2, you can use the version ofDB2 7.2 with Fix Pack 5 that is shipped with IBM Tivoli Service Level Advisor toinstall DB2 at this minimum required version, and then upgrade to Fix Pack 6 (alsorequired).

You must install DB2 on each system where you plan to install one or morecomponents of Tivoli Enterprise Data Warehouse or IBM Tivoli Service LevelAdvisor. Table 6 specifies which components of Tivoli Enterprise Data Warehouseand IBM Tivoli Service Level Advisor can run on DB2 client or server, andsupported platform types. Refer to the Release Notes for both products for specificsupported operating system versions.

Table 6. Supported platforms and DB2 components for a distributed installation

Component Supported operating system DB2 components required

For Tivoli Enterprise Data Warehouse:

Control server Windows NT, Windows 2000 DB2 Server

Central data warehouse Windows NT, Windows 2000,AIX, Solaris

DB2 Server

Data marts Windows NT, Windows 2000,AIX, Solaris

DB2 Server

Report interface Windows NT, Windows 2000,AIX, Solaris, Linux

DB2 Client or DB2 Server

For IBM Tivoli Service Level Advisor:

SLM Server Windows NT, Windows 2000,AIX, Solaris, Linux


SLM Task Drivers Windows NT, Windows 2000,AIX, Solaris, Linux


SLM Reports Windows NT, Windows 2000,AIX, Solaris, Linux


SLM Database Windows NT, Windows 2000,AIX, Solaris, Linux

DB2 Server


Windows NT, Windows 2000,AIX, Solaris, Linux

DB2 Server

Be sure to read the DB2 Quick Beginnings document for the operating system onwhich you are installing.


Depending on how you want to deploy the IBM Tivoli Service Level Advisor SLMdatabases (the SLM Database and SLM Measurement Data Mart), you may need toinstall DB2 on one or more additional machines, or create multiple DB2 instanceson one or more machines, or set up a server-client configuration betweenmachines. Consult the DB2 documentation for information on installing andconfiguring DB2 in these circumstances. Possible configurations might include thefollowing:v If you plan to locate the SLM Database and SLM Measurement Data Mart

together on a separate machine from the central data warehouse, install DB2 onthat machine.

v If you plan to locate the SLM Database and SLM Measurement Data Mart on thecentral data warehouse machine, with both databases together in a separateinstance of DB2, create that second instance on that machine.

v If you plan to locate the SLM Database and SLM Measurement Data Mart on thecentral data warehouse machine, but each in their own instance of DB2, createthose instances on that machine.

v If you plan to locate the SLM Database and SLM Measurement Data Mart ontwo separate machines, install DB2 on each of those machines.

Install DB2 7.2 with Fix Pack 5 on each required Windows machine by doing thefollowing:1. Insert the DB2 product CD to start the DB2 install program, and click Install.2. Using Table 6 on page 34, for a single system installation, or for components

requiring a DB2 Server in a distributed environment, verify that only DB2Enterprise Edition is checked. For components in a distributed environmentthat can run on a DB2 Client, you can select any of the following installoptions, and then click Next to continue:v DB2 Enterprise Editionv DB2 Application Development Clientv DB2 Administration Client (this is the smallest client)

3. Verify that the Typical install option is selected and click Next to continue.4. On the Destination Location dialog, accept the defaults, or specify your

desired install location, and click Next to continue.5. On the Control Server dialog, for the user name and password, you should

specify a user that does not already exist on the system. DB2 will create theuser for you with the correct roles and privileges. A typical DB2 user name andpassword is as follows:v User name: db2admin

v Password: db2admin

Note: Remember this DB2 user name and password! You will need it toinstall Tivoli Enterprise Data Warehouse and IBM Tivoli Service LevelAdvisor components on this system. For a distributed installation, youdo not have to use the same user name and password for each DB2installation.

Click Next to continue (if a message is displayed regarding creation of the userID, click Yes to continue).

6. On the Current Settings dialog, click Next to perform the installation.7. You will be asked if you need to install the OLAP starter kit. Select No and

then Continue to continue.8. When the installation completes, click Finish and then click Exit.


To install DB2 on UNIX systems, refer to IBM DB2 Universal Database for UNIXQuick Beginnings, and for a more advanced installation on Windows systems, seeIBM DB2 Universal Database Enterprise - Extended Edition for Windows QuickBeginnings. UNIX operating systems may need to be tuned to run DB2. If theoperating system is not tuned correctly, sporadic connection failures and othermisleading errors may occur. Refer to information about updating configurationparameters in these manuals for more information.

IBM Tivoli Service Level Advisor also requires that all databases be enabled for logroll-forward which is used in the backup recovery procedure.

Verifying your DB2 InstallationAfter installing DB2, perform a connection test by doing the following (either froma DB2 command prompt on Windows or from a UNIX environment where thedb2profile has been sourced):1. Issue the following command to list local databases:

db2 list database directory

2. In most cases, the command lists at least one database, even in newinstallations. If the command does not list any databases, create a dummydatabase by issuing the following command, where <name> is a dummydatabase name of your choosing:db2 create database <name>

3. Issue the following command to test for a local connection, where <name> isyour database name, and <user_name> and <password> are the DB2 user nameand password that you specified during DB2 installation:db2 connect to <name> user <user_name> using <password>

If this command is successful, DB2 is installed and ready for remote connections. Ifyou experience difficulty, refer to the DB2 documentation for troubleshootinginformation.

Ensure that DB2 settings related to LDAP are turned off. Use the db2set -allcommand to list the settings. If these settings are turned on, credential errors aregenerated.

Step 7. Upgrade to DB2 7.2 Fix Pack 6Download DB2 7.2 Fix Pack 6 from the support Web site:http://www.ibm.com/software/sysmgmt/products/support/

TivoliEnterpriseDataWarehouse.html

Be sure to read the readme file included with the fix pack. You should upgrade tothe Fix Pack 6 level before creating any databases, otherwise you must follow theinstructions in the readme to rebind the databases if you install the Fix Pack afterdatabases are created.

Install the Fix Pack on all DB2 systems to upgrade to the required level for IBMTivoli Service Level Advisor by doing the following:v For Windows:

1. Stop all services associated with DB2 by starting a DB2 command promptand issuing the following commands:db2stop force

db2admin stop


2. Navigate to the Services control panel and stop all services with DB2 in thename, along with Warehouse Server and Warehouse Logger services.

3. Navigate to the directory where you downloaded DB2 Fix Pack 6 and runsetup.exe.

Note: If you receive the following message, click Yes and continue theinstall:DB2 is currently running and locked by the following process(es):

jservice.exe

4. Follow the instructions in the install program to install the fix pack.v For UNIX:

1. While logged in as root, navigate to the DB2 instance owner<db2_instance_directory>/sqllib, where <db2_instance_directory> is thedatabase instance directory, and source the db2profile by issuing thecommand:. db2profile

2. Optionally retrieve a list of DB2 instances by issuing the command:db2ilist

3. For each instance, issue the following commands:db2 force applications all

db2 terminate

db2stop

4. While logged in as root, navigate to the DB2 Administrative Server ownerand source the db2profile

5. Enter the following command:db2admin stop

6. While logged in as root, navigate to the location where you downloaded thefix pack software, and issue the following command:./installFixPak

7. When the installation is completed successfully, update each instance withthe following command:– For Solaris:

/opt/IBMdb2/V7.1/instance/db2iupdt <instance_name>

– For AIX:/usr/lpp/db2_07_01/instance/db2iupdt <instance_name>

– For Linux:/usr/IBMdb2/V7.1/instance/db2iupdt <instance_name>

Step 8. Update the JDBC Level for DB2By default, the DB2 database management system server uses the JDBC 1.1 driversfor JDBC applications. IBM Tivoli Service Level Advisor requires DB2 to use theJDBC 2.0 drivers. If the DB2 server uses different levels of the JDBC driver thanthe clients, unpredictable results occur and IBM Tivoli Service Level Advisor mayencounter database errors.

IBM Tivoli Service Level Advisor automatically updates the JDBC level to JDBC 2.0during the installation procedure. For those machines in a distributed installationthat have Tivoli Enterprise Data Warehouse components but not IBM Tivoli ServiceLevel Advisor, you may need to manually update the JDBC level to 2.0.


Verifying the JDBC LevelTo determine if you are running DB2 at the required JDBC 2.0 level, do thefollowing, depending on your operating system:v For Windows, check the size of the db2java.zip file, located in the

<DB2_DIR>/java directory, where <DB2_DIR> is the location where DB2 isinstalled. If the size is approximately 1,347 KB, then the JDBC level is 2.0. If thesize of the db2java.zip file is approximately 1,132 KB, then the JDBC level is 1.0and you must run the usejdbc2 command to upgrade to JDBC 2.0. See“Updating the JDBC Level Manually”.

v For UNIX, log in as the instance owner and source the db2profile script, andcheck the CLASSPATH environment variable by issuing the following command:echo $CLASSPATH

If the CLASSPATH includes the string<DB2_Instance_Dir>/sqllib/java12/db2java.zip, where <DB2_Instance_Dir> isthe home of the instance of the SLM databases, then the JDBC level is properlyset to 2.0. If the CLASSPATH includes the string<DB2_Instance_Dir>/sqllib/java/db2java.zip, then the JDBC level is 1.0, andyou must run the usejdbc2 command to upgrade to JDBC 2.0. See “Updatingthe JDBC Level Manually”.

Updating the JDBC Level ManuallyIf the JDBC level was not properly updated, you can manually update the JDBClevel by doing the following, depending on your operating system:v For Windows, navigate to the <DB2_DIR>/java12 directory, where <DB2_DIR> is

the location where DB2 is installed, and issue the following command:usejdbc2

This command will copy the appropriate version of db2java.zip into the<DB2_DIR>/java directory.

v For UNIX, add the following line to the<DB2_Instance_Dir>/sqllib/userprofile script, where <DB2_Instance_Dir> is thehome of the DB2 instance where the SLM databases are located:. <DB2_Instance_Dir>/sqllib/java12/usejdbc2

If the userprofile script does not exist, add the above line to the end of thedb2profile script in the <DB2_Instance_Dir>/sqllib/ directory.

Verify that the JDBC level was correctly updated by following the instructions in“Verifying the JDBC Level”.

Step 9. Configure the Database Manager to use ExtendedShared Memory

To avoid problems with DB2 exhausting its shared memory segments on AIXsystems, you should configure the database manager to use extended sharedmemory. This is especially important if the SLM databases reside on the samemachine with any of the install options of IBM Tivoli Service Level Advisor (SLMServer, SLM Task Drivers, or SLM Reports).

To enable this support for extended shared memory, do the following:1. Add EXTSHM=ON to the /etc/environment file2. From a DB2 command prompt, run the following command:

db2set DB2ENVLIST=EXTSHM


3. Add the following lines to sqllib/db2profile:EXTSHM=ON

export EXTSHM

4. Reboot the machine to put the changes into effect.

For more information, see the DB2 documentation for configuration of sharedmemory, and consult the WebSphere online documentation for configuring forextended shared memory.

Installing Tivoli Enterprise Data Warehouse 1.1The installation and configuration of Tivoli Enterprise Data Warehouse 1.1 is fullydocumented in Chapter 3 of Installing and Configuring Tivoli Enterprise DataWarehouse that accompanies the Tivoli Enterprise Data Warehouse installationmedia. It includes procedures for installing and configuring the variouscomponents of Tivoli Enterprise Data Warehouse, on a single system or distributedacross multiple systems, including the following:v The Tivoli performance and availability schema, or data model, to personalize

the Tivoli Enterprise Data Warehouse database for use by the source applicationsand IBM Tivoli Service Level Advisor

v The control server, the central data warehouse, and the data mart database.v Installation of Tivoli Presentation Services (the three main pieces of Tivoli

Presentation Services including the Server for IBM Console, Web Services forIBM Console, and the IBM Console are referred to collectively in this documentas the IBM Console Server) on the same machine as the central data warehouseor on a separate machine as desired.

Notes:

1. It is recommended that you install Tivoli Presentation Services and the IBMConsole on a Windows machine where possible in your environment.

2. When installing Tivoli Presentation Services as part of the Tivoli EnterpriseData Warehouse installation, be careful to specify a destination directory withno blank spaces, for example, C:\PS. If you install to a directory path thatincludes a blank space, such as C:\Program Files\PS, you may experienceproblems later bringing up the IBM Console, and you will have to performthe installation again.

v Installation of the Tivoli Enterprise Data Warehouse report user interface taskdrivers on the same machine as the IBM Console Server.

The installation wizards are located in the root directory of the Tivoli EnterpriseData Warehouse installation media. Use the program appropriate to the operatingsystem on which you are installing:v For Windows: setup.exev For UNIX: setup_unix.sh

Note: Installing and Configuring Tivoli Enterprise Data Warehouse has detailedprocedures for every step of running the install wizard. If you have anyquestions or encounter any problems in installing, refer to the TivoliEnterprise Data Warehouse documentation for more details.

The following sections summarize the installation steps for Tivoli Enterprise DataWarehouse. If you encounter any problems, consult the detailed procedures andtroubleshooting information in Installing and Configuring Tivoli Enterprise DataWarehouse.


Before Starting the Install WizardBefore starting the install wizard for Tivoli Enterprise Data Warehouse, verify thefollowing for the local machine:v Has DB2 already been successfully installed, in either client or server mode,

depending on your planned component needs for this system? DB2 must bealready installed before installing Tivoli Enterprise Data Warehouse. If not, goback to “Installing DB2” on page 30 and install DB2 on this machine.

v If you plan to install the report interface of Tivoli Enterprise Data Warehouseon this machine, either as a single system install or as part of a distributedinstall, is a Web server or some other application that uses port 80 or port 8008already installed on this machine? If so, you must temporarily stop thatapplication to free up port 80 and 8008 before starting the installation, and thenrestart it after installation is completed. In addition, during the installation, youwill have to specify a different set of port numbers for IBM HTTP Server andIBM HTTP Administration for the installation and configuration of TivoliPresentation Services. Specifying ports that are already in use can cause errors orcause the install program to lock up.

Step 1. Start the install wizardTo start the Tivoli Enterprise Data Warehouse install wizard, insert the product CDand do the following:v For Windows, the installation program should start automatically. If it does not,

do the following:1. From your desktop, select My Computer

2. Open the CD-ROM drive folder3. Double-click setup.exe to start the install wizard

v For UNIX:1. Mount the CD by issuing the following command:

– For AIX, issue the following command, where <mount_dir> is the mountdirectory:mount -rv cdrfs /dev/cd0 <mount_dir>

– For Solaris, the CD is automatically mounted on /cdrom/cdrom0

– For Linux, issue the following command:mount /mnt/cdrom

2. Change to the mount directory3. Run the following command:

./setup_unix.sh

When the Welcome panel is displayed, click Next to continue. At any time, youcan click Back to proceed back through the dialogs and change your selectionsbefore the actual installation takes place, or click Cancel to close the install wizardwithout installing.

Note: For purposes of illustration, install dialog screens displayed in the followingsections are for a Windows platform install. If you are installing in UNIX,you may see slightly different displays.

Step 2. Choose Single System or Distributed InstallationOn the Setup Type dialog, shown in Figure 8 on page 41, select the type ofinstallation you want to perform:


v If you are installing all components of Tivoli Enterprise Data Warehouse on asingle machine, verify that the Single machine radio button is selected.

Note: You can only perform a single machine install on a Windows platform,because the control server component of Tivoli Enterprise Data Warehouseis only supported on Windows platforms.

v If you are installing one or more components of Tivoli Enterprise DataWarehouse on this machine or on multiple machines, verify that theCustom/Distributed radio button is selected.

The Application installation only radio button is selected when you are using theTivoli Enterprise Data Warehouse install wizard to only install warehouse packsafter Tivoli Enterprise Data Warehouse has been successfully installed. During theSingle machine or Custom/Distributed install process, you can optionally installone or more warehouse packs as part of the Tivoli Enterprise Data Warehouseinstall process. For example, you might have one or more warehouse packs forsource applications putting data into the central data warehouse, in addition to thewarehouse pack for IBM Tivoli Service Level Advisor. You could install one ormore of them during this initial installation of Tivoli Enterprise Data Warehouse. Inthis documented install procedure, however, you will install warehouse packs in aseparate procedure.

The Directory name field specifies the target install directory where the selectedcomponents of Tivoli Enterprise Data Warehouse will be installed on this machine.The default (for Windows) directory, C:\Program Files\TWH, is displayed and youcan accept this default or modify this to a target install directory of your choosing.

When you are ready, click Next to continue.

Figure 8. Specifying the type of installation for Tivoli Enterprise Data Warehouse


Step 3. Select Components to Install

Note: If you are performing a single machine installation, you can skip this stepand proceed to step “Step 4. Verify Host Name” on page 43.

If you are performing a Custom/Distributed installation, the next dialog enablesyou to select one or more components of Tivoli Enterprise Data Warehouse toinstall on this machine, as shown in Figure 9.

Check the box next to each component that you want to install on this machine.

Notes:

1. For AIX and Linux platforms, verify that the refresh of the display is completedbefore selecting the options.

2. There is a separate option, Installation scripts and tools, that you can ignore.This is a feature that is automatically included when it is required.

3. There is a separate option, Application ETL and report packages, which youcan optionally select if you also want to install warehouse packs during thisinstallation. Since we are planning to install warehouse packs in a separateprocedure, you should uncheck this check box.

In this example, the control server and report interface have been selected to beinstalled on this machine. The control server must be installed on a Windowssystem, and it is recommended to install the report interface on Windows as well,because it uses Tivoli Presentation Services and the IBM Console. You may alsowant to install the report interface on a separate machine.

When you have selected all of the options you want to install on this machine,click Next to continue.

Figure 9. Selecting components for a custom or distributed installation


Step 4. Verify Host NameThe System host name dialog is displayed, specifying the fully qualified host nameof the local machine, similar to that shown in Figure 10. Verify that this is correct,and modify it if needed. When you have verified the host name, click Next tocontinue.

Step 5. Specify local DB2 user name and passwordThe DB2 Configuration dialog is displayed, prompting you for the DB2 user nameand password for configuring DB2 on this local system. Enter the user name andpassword that were specified when DB2 was installed on this system, as shown inFigure 11 on page 44. When you have specified the user name and password, clickNext to continue.

Figure 10. Verifying the host name of the local machine


Step 6. Specify Tivoli Presentation Services Information

Note: If you are performing a Custom/Distributed installation and are notinstalling the report interface component of Tivoli Enterprise DataWarehouse on this machine, you can skip this step and the step that follows,and proceed to “Step 8. Configure remote access to the control server” onpage 46.

If you are performing a Single machine installation, or if you are installing thereport interface on this machine for a Custom/Distributed installation, and if TivoliPresentation Services is not already installed on this machine, the TivoliPresentation Services configuration dialog is displayed, as shown in Figure 12 onpage 45.

Figure 11. Specifying the DB2 access information for the local machine


This dialog shows all of the default port values that will be used to install andconfigure Tivoli Presentation Services. You can modify these values as needed oraccept the defaults as presented and click Next to continue.

Resolving port conflictsIf you are planning to install the SLM Report component of IBM Tivoli ServiceLevel Advisor on this same machine, IBM WebSphere Application Server must alsobe located on this machine as well. Because Tivoli Presentation Services andWebSphere both use the same default port numbers for IBM HTTP Server (80) andIBM HTTP Administration (8008), you have an opportunity here to change theseport numbers for Tivoli Presentation Services to avoid a later conflict withWebSphere.

If you anticipate a port conflict with WebSphere, change the port numbers on thisdialog to unused values, for example:v IBM HTTP Server: 81

v IBM HTTP Administration: 8009

Specifying the target install directoryThe Destination location Directory name field shows the default target directorywhere Tivoli Presentation Services will be installed on this machine. You canmodify this directory path or accept the default path of C:\PS.

Step 7. Install additional languages

Note: If you are performing a Custom/Distributed installation and are notinstalling the report interface component of Tivoli Enterprise DataWarehouse on this machine, you can skip this step, and proceed to “Step 8.Configure remote access to the control server” on page 46.

If you are performing a Single machine installation, or if you are installing the

Figure 12. Specifying port values for Tivoli Presentation Services installation


report interface on this machine for a Custom/Distributed installation, theAdditional Languages dialog is displayed, as shown in Figure 13.

You can optionally specify to install additional language support for the reportinterface, but for purposes of this installation discussion, language support is notincluded. Leave the check box for Yes, install additional languages unchecked,and click Next to continue.

If additional languages are needed, refer to the Tivoli Enterprise Data Warehousedocumentation for information on installing language support. Language supportis installed only on the machine where the report interface resides.

Step 8. Configure remote access to the control serverNotes:

1. If you are performing a Single machine install, you can skip the next set ofsteps and proceed to step “Step 11. Install application packages” on page 50.

2. If you are performing a Custom/Distributed install and the control server willbe located on this machine, you can skip this step and proceed to “Step 9.Configure remote access to the central data warehouse” on page 47

If you are performing a Custom/Distributed installation and the control server isnot installed (and not selected to be installed) on this machine, you must provideconfiguration information to enable remote communication between this machineand the machine where the control server is located. The remote accessconfiguration dialog is displayed, as shown in Figure 14 on page 47.

Figure 13. Optionally install language support for the report interface


Using the information you gathered in your planning worksheets, specify thefollowing fields:

User nameThis is the DB2 user name that was specified when DB2 was installed onthe machine where the control server is located.

PasswordThis is the DB2 password that was specified when DB2 was installed onthe machine where the control server is located.

Database host nameThis is the fully qualified host name of the machine where the controlserver is located.

Database portThis is the database communication port number used for communicationwith the machine where the control server is located. The default is 50000.

Specify the required values to communicate with the control server machine, andclick Next to continue.

Step 9. Configure remote access to the central datawarehouse

Notes:

1. If you are performing a Single machine install, you can skip the next set ofsteps and proceed to “Step 11. Install application packages” on page 50.

2. If you are performing a Custom/Distributed install and the central datawarehouse will be located on this machine, you can skip this step and proceedto “Step 10. Configure remote access to data marts” on page 49

Figure 14. Configuring remote access information for the control server


If you are performing a Custom/Distributed installation and the central datawarehouse is not installed (and not selected to be installed) on this machine, youmust provide configuration information to enable remote communication betweenthis machine and the machine where the central data warehouse is located. Theremote access configuration dialog is displayed, as shown in Figure 15.


User nameThis is the DB2 user name that was specified when DB2 was installed onthe machine where the central data warehouse is located.

PasswordThis is the DB2 password that was specified when DB2 was installed onthe machine where the central data warehouse is located.

Database host nameThis is the fully qualified host name of the machine where the central datawarehouse is located.

Database portThis is the database communication port number used for communicationwith the machine where the central data warehouse is located. The defaultis 50000.

Specify the required values to communicate with the central data warehousemachine, and click Next to continue.

Figure 15. Configuring remote access information for the central data warehouse


Step 10. Configure remote access to data martsNotes:

1. If you are performing a Single machine install, you can skip the next set ofsteps and proceed to “Step 11. Install application packages” on page 50.

2. If you are performing a Custom/Distributed install and the data marts will belocated on this machine, you can skip this step and proceed to “Step 11. Installapplication packages” on page 50

If you are performing a Custom/Distributed installation and the data martscomponent is not installed (and not selected to be installed) on this machine, youmust provide configuration information to enable remote communication betweenthis machine and the machine where the data marts are located. The remote accessconfiguration dialog is displayed, as shown in Figure 16.


User nameThis is the DB2 user name that was specified when DB2 was installed onthe machine where the data marts are located.

PasswordThis is the DB2 password that was specified when DB2 was installed onthe machine where the data marts are located.

Database host nameThis is the fully qualified host name of the machine where the data martsare located.

Figure 16. Configuring remote access information for data marts


Database portThis is the database communication port number used for communicationwith the machine where the data mart is located. The default is 50000.

Specify the required values to communicate with the data marts machine, and clickNext to continue.

Step 11. Install application packagesIf you are performing a Single machine install, the install wizard assumes that youmight want to also install one or more application packages (warehouse packs)during the install of Tivoli Enterprise Data Warehouse. The Application Packagesdialog is displayed, asking if you want to install application packages, as shown inFigure 17.

For this install procedure, you will install warehouse packs separately from theTivoli Enterprise Data Warehouse installation process, so leave the Yes, installapplication packages check box unchecked, and click Next to continue.

If you are performing a Distributed/Custom installation and had selected theApplication ETL and report packages install option (see Figure 9 on page 42), adialog would be displayed at this time prompting you for the source location ofthe warehouse pack that you want to install. Refer to Installing and ConfiguringTivoli Enterprise Data Warehouse for details on installing warehouse packs using theTivoli Enterprise Data Warehouse install wizard.

Installation of the IBM Tivoli Service Level Advisor warehouse pack is discussed in“Installing the Registration and Process ETLs” on page 90.

Figure 17. Select the check box if you want to install warehouse packs.


Step 12. Completing the install wizardA summary dialog is displayed, showing all of the components of Tivoli EnterpriseData Warehouse that you selected to install on this machine, similar to Figure 18.Confirm your selections and click Install to begin the installation.

After the installation program has copied files and configured the environment, theInstallation Summary window is displayed. Click Next to continue.

Note: Do not select the option to restart the system at this time. Click Next andthen click Finish.

Wait for the IBM Console to finish rebuilding the online user assistance help set.You can check for completeness by examining either of the two most recent(highest numbered n) stdoutn log files in the directory<PS_directory>\log\fwp_mcr, where <PS_directory> is the location where TivoliPresentation Services was installed. Look for the following message:FWP1734I The utility that was started by the Management Component

Repository to build the help set has completed successfully.

This help set build process might take over an hour to complete. When the helpsetbuild is complete, reboot the system. If you reboot the system before the help setbuild is complete, refer to the Tivoli Enterprise Data Warehouse Release Notes forinformation on rebuilding the help set.

Verifying the Tivoli Presentation Services InstallationImmediately after installing Tivoli Enterprise Data Warehouse, you should verifythat Tivoli Presentation Services was installed correctly. To verify TivoliPresentation Services installation, do the following:

Figure 18. Confirm your install selections before starting the install.


1. From a command prompt, navigate to <PS_Install_Dir>/bin/private/<OS>,where <PS_Install_Dir> is the directory where Tivoli Presentation Services wasinstalled, and <OS> is your operating system (for example, w32-ix86 forWindows)

2. Issue the following command:wcmd pspersist getApplicationProperty junk junk

If you receive the following message, then the installation was successful:The application property junk in block junk could not be found.

If you receive the following message, Tivoli Presentation Services was not installedcorrectly:FWP4100E The command line bundle for pspersist is not found.

This error might occur if Tivoli Enterprise Data Warehouse had been previouslyuninstalled from this machine, and Tivoli Presentation Services was not completelyremoved from the system.

To resolve this problem you must do the following:1. Uninstall Tivoli Enterprise Data Warehouse2. Completely uninstall Tivoli Presentation Services3. Reinstall Tivoli Enterprise Data Warehouse

Consult the installation documentation for Tivoli Enterprise Data Warehouse fordetails on completely uninstalling Tivoli Presentation Services before attempting toreinstall Tivoli Enterprise Data Warehouse.

Installing Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1IBM Tivoli Service Level Advisor requires Tivoli Enterprise Data Warehouse 1.1with Fix Pack 1 to be installed. Refer to the Tivoli Enterprise Data Warehouse ReleaseNotes and the Tivoli Enterprise Data Warehouse support Web site for fix packinformation.

Installing Source Application Warehouse PacksAfter successfully installing Tivoli Enterprise Data Warehouse, you can install thesource ETL (warehouse packs) for each Tivoli performance and availabilityapplication that will be writing measurement data to the central data warehouse.These warehouse packs are installed on the same machine as the control server,which uses the Data Warehouse Center component of DB2. Installation andconfiguration procedures for the warehouse packs are included on the warehousepack installation media.

See Installing and Configuring Tivoli Enterprise Data Warehouse for details oninstalling and configuring warehouse packs for each of the Tivoli applications thatare enabled for Tivoli Enterprise Data Warehouse.


Installing IBM WebSphere Application ServerIBM Tivoli Service Level Advisor uses IBM WebSphere Application Server for itsreport servlets that enable a customer to integrate SLA reports into a company Website. IBM Tivoli Service Level Advisor supports WebSphere Advanced Edition (AE)and WebSphere Advanced Edition Single-server (AES). Refer to IBM Tivoli ServiceLevel Advisor Release Notes for specific supported version levels.

You must have a supported version of IBM WebSphere Application Server installedon the machine where you plan to install the SLM Reports component of IBMTivoli Service Level Advisor. If you do not already have IBM WebSphereApplication Server installed in your enterprise, you can install WebSphere AES4.0.1 from the installation media included with IBM Tivoli Service Level Advisor.

Installing WebSphere AES 4.0.1To install WebSphere AES 4.0.1, refer to the WebSphere documentation providedwith the WebSphere installation media included with IBM Tivoli Service LevelAdvisor. Additional install information is available online at the following Website:http://www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter

Notes:

1. If you have installed WebSphere on the same machine as the IBM ConsoleServer, you must resolve any HTTP port and HTTP Admin port conflictsbetween the two applications. See “Resolving port conflicts” on page 45, orconsult the WebSphere documentation for information on modifying the HTTPport numbers.

2. If you are installing WebSphere in a non-English environment, you mustupgrade to at least WebSphere AES version 4.0.2.

3. The SLM Reports option of IBM Tivoli Service Level Advisor requires thatWebSphere Application Assembly Tool (AAT) is installed with WebSphere AES.Without AAT, installation of SLM Reports will fail. AAT is one of the selectablecomponents of the WebSphere AES installation that is included automaticallywhen you perform a Typical installation.

Install WebSphere AES 4.0.1 using the installation media included with IBM TivoliService Level Advisor, following the procedures in the following sections.

Installing on WindowsInstall IBM WebSphere Application Server AES 4.0.1 on a Windows system bydoing the following:1. Insert the Windows version of the WebSphere AES 4.0.1 product CD and run

the setup.exe program.2. On the Language dialog, select the language desired and click OK to continue.3. On both the Welcome and Installation Options dialogs, click Next to continue.4. On the Security Options panel, enter a valid user ID and password for this

machine and click Next to continue.5. On the dialogs for Product Directory, Program Folder, and Install Options, click

Next to perform the installation.6. After the installation completes, reboot the machine and select Start the

Application Server.


Installing on UNIXInstall IBM WebSphere Application Server AES 4.0.1 on a Windows system bydoing the following:1. Mount the UNIX version of the WebSphere AES 4.0.1 CD:




2. Change to the mounted directory <mount_dir>/<os version>, where <osversion>is aix for AIX, sun for Solaris, and linux for Linux.

3. Run the following command:./install.sh

4. The Welcome banner is displayed. Click Next to display a window withWebsphere AES operating system prerequisites. If everything is satisfactory,click OK to continue, or update the operating system with the required fixesby downloading them from the corresponding operating system support Website.

5. Select Typical Installation and click Next to continue.6. The Destination Directory window is displayed, showing the default

installation directory of WebSphere and the IBM HTTP Server. Accept thesedefaults and click Next to continue.

7. The Install Options window is displayed, listing the components to beinstalled. Click Install, which starts the installation. At the end, click Finish tocomplete the installation.

8. Unmount the CD as follows:v For AIX, change the directory from the mounted directory and enter umount

<mount_dir>

v For Solaris, change the directory from the mounted directory and entereject cdrom

v For Linux, change the directory from the mounted directory and entereject cdrom

9. Verify that db2profile is sourced before starting the WebSphere ApplicationServer by issuing the following command, where <Instance_Dir> is the DB2instance directory:. <Instance_Dir>/sqllib/db2profile

For example,. /home/db2inst1/sqllib/db2profile

10. Completion of the installation launches the First Steps html page if Netscapeis installed. You can use this html page to start and stop the WebsphereApplication Server, or see Chapter 6, “Startup and Shutdown Procedures” onpage 103 for the procedures to start and stop the Websphere ApplicationServer and the HTTP Server.

Configuring the WebSphere EnvironmentConfigure your WebSphere environment by doing the following:v If you are installing WebSphere Application Server in a non-English

environment, you must configure WebSphere to use UTF-8 encoding by doingthe following:


1. Upgrade to at least WebSphere AES 4.0.2 (see “Upgrading from WebSphereAES 4.0.1” on page 56), or apply APAR PQ52029 to your WebSphere 4.0.1environment.You can retrieve APAR PQ52029 at:http://www14.software.ibm.com/webapp/download/postconfig.jsp?id=4000790&pf=MultiPlatform&v=4.0.1 &e=&cat=&s=z

Note: The preceding Web address should appear as a single, concatenatedline. It appears on multiple lines in this document because of spacelimitations.

2. Set the client.encoding.override property by doing the following:– For WebSphere AE 4.0.1, 4.0.2, or 4.0.3:

a. On the WebSphere Administrative Console tree, selectNodes→Application Server→JVM Settings.

b. Scroll to the System Properties section and click Add to create a newrow in the table.

c. Type client.encoding.override in the Name column and UTF-8 in theValue column.

d. Click Apply.e. Stop and restart the WebSphere Application Server.

– For WebSphere AES 4.0.1, 4.0.2, or 4.0.3:a. Open the WebSphere Application Server Administrative Console

(default: http://localhost:9090/admin) and log on.b. On the WebSphere Administrative Console tree, select Nodes.c. Select your NodeName.d. Select Application Servers.e. Select Default Server.f. Select Process Definition.g. Select JVM Settings.h. Scroll to Advanced Settings and click the System Properties link.i. In System Properties, click New.j. Type client.encoding.override in the Name field.k. Type UTF-8 in the Value field.l. Click OK to save the changes.m. Click Exit on the WebSphere Application Server menu bar.n. In the Exit table, select Save and click OK.o. Stop and restart the WebSphere Application Server.

v Configure the JDBC Driver in WebSphere (see “Configuring the JDBC Driver inWebSphere” on page 56 for the procedure).

v You might want to configure WebSphere to autostart when the system isrestarted. See “Automatically Starting WebSphere After System Restart” onpage 57 for the procedure.

v Obtain the WebSphere node name (see “Identifying the WebSphere Node Name”on page 58) and record it in your planning worksheet for later use.

v If you have installed a supported version of IBM WebSphere Application ServerAE, you must also perform some manual configuration to integrate the reportservlets into the WebSphere environment after you install the SLM Reports


option of IBM Tivoli Service Level Advisor. See “Integrating SLM Reports intoWebSphere” on page 95 for more information about integrating SLM Reportsinto WebSphere AE.

Upgrading from WebSphere AES 4.0.1It is recommended (and required in a non-English environment) that you upgradeWebSphere 4.0.1 to version 4.0.2 or later. See the following Web site for upgradeinformation:http://www.ibm.com/software/webservers/appserv/support.html

You can upgrade WebSphere by doing the following:1. On the web page, under Support Downloads, click All e-fixes and fixpaks.2. Stop the Application Server (see “Stopping IBM WebSphere Application Server

for WebSphere AES” on page 108)3. Run the installation program by doing the following:

v For Windows:a. Extract the files from the ZIP fileb. Run install.bat

v For UNIX:a. Extract the files from the tar fileb. Run install.sh

4. You will be prompted to enter the name of your WebSphere AppServerdirectory, such as /usr/WebSphere/AppServer.

5. When asked if you want to upgrade your HTTP server, answer No (yoursystem may become unstable). See the readme file that accompanies the patchinstallation for details.

Configuring the JDBC Driver in WebSphereAfter installing WebSphere AES, configure the DB2 JDBC Driver in WebSphere bydoing the following:1. Start the WebSphere Application Server (see “Starting IBM WebSphere

Application Server” on page 106), and wait for the server to become active (inthe log file <WebSphere_Dir>/AppServer/logs/default_server_stdout.log,where <WebSphere_Dir> is the directory where WebSphere was installed, checkfor the following line:open for e-business

2. Open your Web browser and point to the following site:http://localhost:9090/admin

3. On the login page, click Submit (specifying the user ID is not necessary). TheAdministrator Console is displayed.

4. From the tree view in the left window, select Resources –> JDBC Drivers –>Db2JdbcDriver. Click on Db2JdbcDriver.

5. In the Server Class Path field, enter the path and file name of the location ofthe DB2 driver, similar to the following example, where <DB2_Instance_Dir> isthe location where DB2 instance is installed, and then click OK:<DB2_Instance_Dir>/sqllib/java12/db2java.zip

6. In the upper black menu bar, click Save.7. Select Save Configuration, and click OK.8. Exit the Administrator Console by selecting Exit from the menu bar.


9. Stop the WebSphere Application Server (see “Stopping IBM WebSphereApplication Server for WebSphere AES” on page 108)

10. Repeat steps 1 and 2 above. If you do not see any error messages, the serveris ready to connect to the database.

Note: On Unix, the root environment file must be updated. The WebSphereApplication Server will be run under root and will require access to theDB2 environment. Edit the environment .profile for the root accountand add the following content at the end of the file:#Set up DB2 environment for root user.

if [-f /home/<db2_instance_owner>/sqllib/db2profile ];then

. /home/<db2_instance_owner>/sqllib/db2profile

fi

Automatically Starting WebSphere After System RestartYou can configure the WebSphere AES Application Server to be automaticallyrestarted each time your system is restarted by doing the following:v For Windows:

1. Select Start –> Settings –> Taskbar & Start Menu

2. Select the Advanced tab3. Click Advanced... to display the Start Menu dialog.4. Under the Start Menu branch in the Folders view, expand the Programs

branch and click the Startup folder.5. Right-click in the right pane of the dialog, and select New –> Shortcut from

the context menu.6. Navigate to the <WebSphere_Dir>\bin\startServer.bat file, where

<WebSphere_Dir> is the directory in which WebSphere was installed, forexample, C:\WebSphere\AppServer.

7. Select this file to create a shortcut to the startServer.bat file in the Startupfolder.

v For UNIX:– For AIX: Edit the file /etc/inittab and append the following line to the end

of the file, where <WebSphere_Dir> is the directory where WebSphere wasinstalled:was:2:once:<WebSphere_Dir>/bin/startServer.sh > /dev/console 2>&1

– For Solaris:1. From the IBM Tivoli Service Level Advisor product CD, copy the file

tools/wastemplate/S81was to the directory location /etc/rc3.d on yoursystem.

2. Edit the file /etc/rc3.d/S81was and replace <WebSphere_Dir> with thelocation where Websphere is installed on your system.

– For Linux:1. From the IBM Tivoli Service Level Advisor product CD, copy the file

tools/wastemplate/S81was to the directory location /etc/rc3.d on yoursystem.

2. Edit the file /etc/rc3.d/S81was and replace <WebSphere_Dir> with thelocation where Websphere is installed on your system.

3. Create links to S81was as follows:ln -s /etc/rc3.d/S81was /etc/rc4.d/S81was

ln -s /etc/rc3.d/S81was /etc/rc5.d/S81was


Identifying the WebSphere Node NameDuring the installation of IBM Tivoli Service Level Advisor, if you are installing theSLM Reports option for use with WebSphere AES, you will be asked to specify thename that WebSphere assigned to the node that identifies the machine on whichWebSphere is running.

Note: This name is not necessarily your machine host name. It might be either theshort name or the fully qualified name for the machine that was assignedduring WebSphere installation. Be sure to look this name up using theprocedure provided, and do not assume it is your machine host name. Notealso that this node name is case sensitive and must be specified exactly as itwas assigned by WebSphere.

You will use this node name later when you install the SLM Reports option of IBMTivoli Service Level Advisor. See “Step 7. Specify Your WebSphere AES Location”on page 72.

Use WebSphere AES to find the correct node name to specify during IBM TivoliService Level Advisor installation. To find the node name, do the following:1. Start the IBM WebSphere Application Server (see “Starting IBM WebSphere

Application Server” on page 106)2. Start the WebSphere Administrator’s Console (see“Starting the WebSphere

Admin Console” on page 107)3. Login to the WebSphere Administrator’s Console by leaving the User ID field

blank and clicking Submit

4. In the left pane of the WebSphere Administrator’s Console window, expand theNodes node and note the host name (in either short or long form) displayed inthe expanded branch of the node. This is the value that you must enter into theNode Name field on the IBM Tivoli Service Level Advisor installation dialog.

5. Logout of the WebSphere Administrator’s Console by selecting Exit.

Record this information in your planning sheet for later use during IBM TivoliService Level Advisor installation.


Chapter 4. Installing IBM Tivoli Service Level Advisor

This chapter assumes that you have successfully installed all of the supportingapplications discussed in Chapter 3, “Installing Supporting Applications” onpage 29.

The installation of IBM Tivoli Service Level Advisor includes two main procedures:1. Create the SLM Database and SLM Measurement Data Mart DB2 databases2. Run the IBM Tivoli Service Level Advisor install wizard to perform the

installation.

Before Installing IBM Tivoli Service Level AdvisorBefore installing IBM Tivoli Service Level Advisor, verify the following:v Are you reinstalling IBM Tivoli Service Level Advisor? If so, you must first

uninstall any existing version before performing a reinstall, unless you aremigrating from a previous version or if you are performing a restore of the SLMServer option. See Chapter 7, “Uninstalling IBM Tivoli Service Level Advisor” onpage 111 for more information.

v Are you migrating IBM Tivoli Service Level Advisor from a previous version?If you currently have a previous version of IBM Tivoli Service Level Advisorinstalled in your enterprise environment, refer to Appendix E, “Migrating FromPrevious Versions of IBM Tivoli Service Level Advisor” on page 165 forinformation on migrating your environment to work with IBM Tivoli ServiceLevel Advisor version 1.2.

v Is the db2java.zip file included in your CLASSPATH system variable? Theinstall program uses this file to set up your DB2 environment. To verify this, dothe following:– On Windows 2000, select Start –> Settings –> Control Panel –> System to

display the System Properties dialog. Select the Advanced tab and selectEnvironment Variables. Examine the CLASSPATH variable and verify thatdb2java.zip is included in the path.

– On Windows NT, select Start –> Settings –> Control Panel –> System todisplay the System Properties dialog. Select the Environment tab. UnderSystem Variables, examine the CLASSPATH variable and verify thatdb2java.zip is included in the path.

– On UNIX, source the db2profile file locally, by navigating to the<db2_instance_directory>/sqllib directory, where <db2_instance_directory> isthe database instance directory, and issuing the following command:. db2profile

v Are you planning to install the SLM Reports component on this machine? Ifso, one of the supported versions of IBM WebSphere Application Server mustalready be installed on this machine.

Note: Be sure to log out of the WebSphere Administrative Console beforestarting the installation of IBM Tivoli Service Level Advisor. It is notsufficient to merely close your Web browser without logging out ofWebSphere. This enables the SLM Reports option to be successfullyintegrated into the WebSphere environment.

59

v Are you planning to install the SLM Task Drivers component on thismachine? If so, Tivoli Presentation Services must already be installed on thismachine. This should have already been completed during installation of TivoliEnterprise Data Warehouse. You should install the SLM Task Drivers on thesame machine where the IBM Console Server was installed.

v Are you planning an incremental installation? If you are planning to install theSLM Server, SLM Task Drivers, or SLM Reports component of IBM Tivoli ServiceLevel Advisor into a machine that already has one or more of these componentsinstalled, you must perform the installation to a different directory. You can onlyreinstall an option into the same directory where it was previously installed ifyou are performing a restore of that option. See the Administrator’s Guide for IBMTivoli Service Level Advisor for information on the restore process for IBM TivoliService Level Advisor.

v Is the system configured to return fully qualified host names? The machineson which you install the SLM Server, SLM task drivers, and SLM Reports mustbe configured so that their host names resolve to fully qualified names. See“Step 3. Ensure fully qualified host names” on page 31 for information onconfiguring your machine to resolve to fully qualified host names.

v Do you have sufficient authority to install? On UNIX systems, you must be theroot user to run the installation program. On Windows, you must haveAdministrator’s privileges to run the installation program.

v Are you installing on a Solaris platform? If so, verify that you have installedthe necessary Java patches from the following Web site:http://java.sun.com/products/jdk/1.3/install-solaris-patches.html

v Are you installing remotely? Remote installs are not supported. The installprogram must be run on the machine where the components are to be installed.

Creating the IBM Tivoli Service Level Advisor Application DatabasesTo create the required databases for IBM Tivoli Service Level Advisor, two scriptsare provided (see Table 10 on page 64 for the location of these files on the installCD):v dyk_cat_dbinst, which creates the SLM Databasev dyk_dm_dbinst, which creates the SLM Measurement Data Mart

Consult your database administrator before using these scripts to ensure that thecreation of the database, placement of the database information, and the defaultvalues for database configuration parameters, as discussed below, are suitable foryour DB2 database server. If you do not have a database administrator, the defaultvalues may be sufficient.

Creating Databases on Linux PlatformsIf you are creating the SLM Database and SLM Measurement Data Mart on aLinux machine, you may need to change certain environment settings beforecreating the databases.

By default, Linux is not configured with sufficient system resources to handle thelarge number of DB2 requests associated with these databases, in particular,requests to create message queues. You must increase the kernel parameterMSGMNI from its default value of 16 to 128. You can modify this parameter byissuing the following command:echo 128 > /proc/sys/kernel/msgmni


To enable this parameter to remain persistent after rebooting the system, you canadd the following line to the file /etc/sysctl.conf, and then reboot the machine:kernel.msgmni=128

Modifying Configuration Parameters Before CreatingDatabases

You might want to modify one or more configuration parameters before creatingthe database. On a UNIX platform, the script files are interactive, enabling you tomodify parameters as needed. If you are installing on a Windows platform,however, do the following to modify the script:1. Copy the entire database structure (/database) from the IBM Tivoli Service

Level Advisor installation CD to a local or system drive.2. Make the appropriate modifications to the script file as desired.3. Run the modified database creation script from the local or system drive where

you made the modifications.

By default, Linux is not set up with sufficient system resources to handle all of theDB2 requests, specifically to create the message queues. You must increase thekernel parameter MSGMNI to 128 (default is 16). You can modify this parameterby performing the following command:echo 128 > /proc/sys/kernel/msgmni

To enable this parameter to remain persistent after rebooting the system, you caninstead add the following line to the file /etc/sysctl.conf, then reboot themachine:kernel.msgmni=128

All database configuration parameters are included near the top of the windowsdatabase creation scripts. You may want to modify one or more of the followingconfiguration parameters:v Database names can be changed, however it is recommended to accept the

default database names unless these names present substantial problems. Thenames of these databases recur in a number of locations, and you must find andchange each instance during installation and configuration. If you select differentnames, bear in mind that database names in DB2 are limited to eight characters.Table 7 describes the default DB2 database names for the IBM Tivoli ServiceLevel Advisor application databases.

Table 7. Default DB2 database names

Database name and description Default DB2database name

IBM Tivoli Service Level Advisor SLM Database. Stores componenttype data from the Tivoli Enterprise Data Warehouse databasewhich is used by IBM Tivoli Service Level Advisor when creatingofferings and orders. Also stores the results of SLA evaluation andtrend analysis, and provides those results to the SLM Reports forgenerating reports.

dyk_cat

IBM Tivoli Service Level Advisor SLM Measurement Data Mart.Stores summarized measurement data from the Tivoli EnterpriseData Warehouse and makes it available to IBM Tivoli Service LevelAdvisor for evaluation and trend analysis.

dyk_dm

Chapter 4. Installing IBM Tivoli Service Level Advisor 61

If you do change these names, note the new names and keep them handy forwhen you install and configure IBM Tivoli Service Level Advisor.

v The database creation scripts create separate log files to capture all of thedatabase creation messages and a list of tables that are created for each database.You can check these log files and table lists after the scripts complete processing,to verify that the databases were created successfully. If you are running thesescripts on a Windows NT or Windows 2000 platform, the default location ofthese log files is in the system temporary folder (the TEMP environmentvariable). If you would like to change the location of the log files, edit theLOGFILE_NAME and VER_LOGFILE_NAME parameters located at the top ofthe windows database creation scripts. See “Checking Database Creation Logsand Tables” on page 64 for additional information on verifying that thedatabases were created successfully.On UNIX, the interactive scripts will prompt you for the desired log directory,and if it does not already exist, the script will offer to create the directory foryou before continuing.

Note: If you choose to have the scripts create the directory for you, the DB2instance owner must have sufficient file permissions to create thedirectory in the desired location.

Additional parameters may be modified if desired. Refer to the comments in thescript files for additional information.

Database and Database Manager Configuration ParametersSome DB2 configuration parameters are changed during the creation of the SLMDatabase and the SLM Measurement Data Mart. These configuration parametersaffect the operation of both the database and the instance to which it belongs. Thefollowing table shows the configuration parameters that are changed along withtheir default values for each SLM database. These values were chosen for thedatabases to run efficiently in a default IBM Tivoli Service Level Advisorenvironment. If you wish to change any of these values, contact your DatabaseAdministrator for values appropriate to your environment.

Table 8. SLM Database Configuration Parameters

Parametername

Default value Configurationtype

Parameter description

logfilsiz 2500 for SLMDatabase

2500 for SLMMeasurementData Mart

Database The size of the primary and secondarylog files, which determines the numberof log records that can be written beforea new log file is required.

logprimary 3 for SLMDatabase


Database The number of primary logs used forrecovery. These logs are allocated whenthe database is created.

logsecond 2 for SLMDatabase


Database The number of secondary log files usedfor database recovery. These logs areonly allocated as needed when space inthe primary log files runs out.


Table 8. SLM Database Configuration Parameters (continued)

Parametername

Default value Configurationtype

Parameter description

applheapsz 2048 for SLMDatabase


Database The amount of private memory availableto be used for an application agent orsubagent.

maxappls 200 for SLMDatabase


Database The maximum number of concurrentapplications allowed to connect to thedatabase.

maxagents 500 for SLMDatabase


Instance The maximum number of databasemanager agents available forapplications.

numdb 10 for SLMDatabase


Instance The maximum number of concurrentlyactive databases.

For more information on these and other database configuration parameters, referto IBM DB2 Universal Database Administration Guide: Performance, Chapter 13,″Configuring DB2.″

Creating the DatabasesTo create the IBM Tivoli Service Level Advisor databases, follow this process:1. Start a DB2 command line processor window:

Table 9. Starting a DB2 command line processor window

Operating System Process

UNIX Login as a DB2 instance owner, navigate to the<db2_instance_dir>/sqllib directory, where<db2_instance_dir> is the home directory of the instance, andrun the following startup script:

v For bash, Bourne, or Korn shells:

. db2profile

v For C shells:

source db2cshrc

Microsoft Windows Select Start –> Run, and enter the following command:

db2cmd

2. Insert the IBM Tivoli Service Level Advisor product CD in the CD-ROM drive.3. If you did not modify the parameters by copying the script files to a local

machine and editing the script file, start the database creation script from the


appropriate directory on the product CD. The commands in the following tableassume that you made no changes to the script.

Note: In certain circumstances or configurations, the database creation scriptsmight fail or become unstable if a database you are trying to create hasalready been remotely cataloged, for example, from a prior creation.Before running the database creation scripts, make sure that anypreviously created database has been uncataloged.

Table 10. Database creation scripts to run for each platform.

Operating system Command

Sun Solaris . <CDROM_Dir>/database/scripts/solaris2/dyk_cat_dbinst.sh

. <CDROM_Dir>/database/scripts/solaris2/dyk_dm_dbinst.sh

IBM AIX . <CDROM_Dir>/database/scripts/aix4-r1/dyk_cat_dbinst.sh

. <CDROM_Dir>/database/scripts/aix4-r1/dyk_dm_dbinst.sh

Linux . <CDROM_Dir>/database/scripts/linux-ix86/dyk_cat_dbinst.sh

. <CDROM_Dir>/database/scripts/linux-ix86/dyk_dm_dbinst.sh

Microsoft Windows <CDROM_Dir>\database\scripts\w32-ix86\dyk_cat_dbinst.bat

<DB2_instance_userID> <DB2_instance_password> [<Territory>]

<CDROM_Dir>\database\scripts\w32-ix86\dyk_dm_dbinst.bat

<DB2_instance_userID> <DB2_instance_password> [<Territory>]

For Windows, the scripts accept the following parameters passed in when theyare called:v <DB2_instance_userID>, a required parameter that specifies the valid user ID

for the DB2 instancev <DB2_instance_password>, a required parameter that specifies the valid

password for the DB2 instance user IDv <Territory>, an optional parameter that specifies the territory to be used for

data entered into this database. If this value is not entered on the commandline, the database territory defaults to US.

Checking Database Creation Logs and TablesAfter the database creation scripts finish processing, check the database logs forerror messages, and examine the list of database tables that were created. Comparethese table lists to the table lists in Appendix C, “Database Creation Tables” onpage 159. If your table information does not match the information in theappendix, check the database creation log files for error messages. After youidentify and correct the error, run the database creation scripts again.

Note: The database creation logs write over any existing log information ratherthan append to existing log information.

Configuring ODBC Data SourcesBefore installing the target ETLs (the Registration ETL and the Process ETL), youmust create and configure the ODBC data sources on the machine where the DataWarehouse Center is located and where the Registration and Process ETLs will belocated.


This information tells the Data Warehouse Center on which machines the TivoliEnterprise Data Warehouse database, the SLM Database, and SLM MeasurementData Mart are located, to manage data transfer between the warehouse and SLMapplication databases.

Two scripts are provided to automatically create the ODBC data sources for thesetwo databases:v dyk_cat_odbc.bat creates an ODBC data source named DYK_CAT for the SLM

Database.v dyk_dm_odbc.bat creates an ODBC data source named DYK_DM for the SLM

Measurement Data Mart.

These scripts assume the following:v You created the SLM Database with the default name dyk_cat.v You created the SLM Measurement Data Mart with the default name dyk_dm.v The DB2 communication port is 50000.v The ODBC data sources are created with the dyk_cat and dyk_dm aliases by

default.

To change these parameters, copy the \database\scripts\w32-ix86 directory fromthe IBM Tivoli Service Level Advisor product CD to a local or system drive, andmake the appropriate modifications to the script file. You can also refer toAppendix D, “Manually Creating ODBC Data Sources” on page 163 for instructionson manually creating ODBC data sources.

To configure ODBC data sources using these scripts, do the following:1. Select Start –>Run and run the db2cmd command to initialize a DB2 command

session.2. Insert the IBM Tivoli Service Level Advisor product CD in the CD-ROM drive.3. To create the ODBC data source named DYK_CAT for the SLM Database,

navigate to the <CD-ROM>\database\scripts\w32-ix86\ directory, where<CD-ROM> is the CD-ROM drive letter, and run the following command,where <host name> is the fully qualified host name of the local or remote DB2server where the database is located:dyk_cat_odbc.bat <host name>

4. Similarly, to create the ODBC data source named DYK_DM for the SLMMeasurement Data Mart, run the following script:dyk_dm_odbc.bat <host name>

Running the Install WizardYou can install IBM Tivoli Service Level Advisor from the installation product CD,using the following basic steps:1. Run a script from the CD root directory, which starts an InstallShield wizard.2. Specify a Tivoli Common Directory or confirm the existing location on your

machine.3. Specify a destination directory for your installation.4. Select one or more of the IBM Tivoli Service Level Advisor installation options

to install on your machine.


Note: If you install these IBM Tivoli Service Level Advisor install options onmultiple machines, or for an incremental installation, you must repeatthe install process for each machine.

5. Specify the location of the installed version of WebSphere to be used as theapplication server for SLM Reports, and specify the node name that is used byWebSphere to identify the machine on which WebSphere is running. Thismachine will be known as the SLM Report Server.

6. Specify the names of the DB2 application databases (the SLM Database and theSLM Measurement Data Mart) that were created for IBM Tivoli Service LevelAdvisor.

7. Specify port numbers for server communication and command line interfaceports.

8. Decide how you want to be notified of SLA violations and trends (using SNMPtraps, Tivoli Enterprise Console events, or e-mail), and configure these eventescalation methods.

The InstallShield wizard verifies the database connections, and then installs all theneeded files to your machine in your specified destination. Some initialconfiguration will automatically take place. A log file will be generated to logproblems if they occur.

Note: The log file, traceTSLA1.2Install.log, is not created until files are writtento disk. If the installation is canceled early, this log file will not be created.This log file does not include database connection errors. Those messagesare displayed on the console. Error information in this log file should besent to Tivoli customer support to assist in diagnosing problems.

The steps involved in running the install wizard are described in the followingsections.

Step 1. Start the InstallShield ProgramTo run the InstallShield program, perform the following steps:1. Insert the IBM Tivoli Service Level Advisor product CD into the CD-ROM

drive.v If you are on a UNIX system, source the db2profile, and mount the CD.

2. Start the installation program from the CD mount (or root) directory byentering the following for your machine’s operating system:

Table 11. InstallShield script file names for each supported platform.

Operating system Command

Microsoft Windows install.bat

UNIX (Sun Solaris, IBM AIX, Linux) ./install.sh

Note: On AIX, if you receive the following warning message when you firstlaunch the install program, you can ignore it and proceed with theinstallation:Warning : Cannot convert string

"-jdk-lucida-medium-r-normal--*-120-75-75-p-*-iso8859-1"

to type Fontstruct


The InstallShield program is started, displaying a welcome window as shownin Figure 19. The program guides you through the remainder of the installprocess. Click Next to continue. or Cancel to halt the installation.

Note: Do not attempt to stop the install program by using the X box in theupper left corner of the install wizard window. Click Cancel to halt theinstallation.

Step 2. Accept the Software License AgreementThe Software License Agreement window is displayed, as shown in Figure 20 onpage 68. You should read the terms of the license agreement as presented in thescrollable window, and, if you agree to abide by those terms, click the I accept theterms of the license agreement radio button and then click Next to continue. Youare not allowed to continue with the installation if you do not accept the terms ofthe license agreement. If you click Cancel, the installation wizard is halted.

Figure 19. The IBM Tivoli Service Level Advisor InstallShield welcome screen.


Step 3. Specify the Tivoli Common DirectoryIBM Tivoli Service Level Advisor is one of the first Tivoli products to storemessage and trace log files and failure data under a common parent directory,called the Tivoli Common Directory. Centralizing the location of log files make iteasier for you to locate log files, investigate problems, and report information toTivoli Customer Support. Upon installation, each product creates a new directorywithin the Tivoli Common Directory to contain product specific log and failuredata. The directory is named by the three-letter product identifier. For IBM TivoliService Level Advisor, this directory is located at <Tivoli_Common_Dir>/DYK.

If IBM Tivoli Service Level Advisor is the first Tivoli product that is installed onthis machine, the install wizard will create the Tivoli Common Directory for use byIBM Tivoli Service Level Advisor and other Tivoli products that are installed in thefuture.

The install wizard first checks to see if the Tivoli Common Directory has alreadybeen established on this system. If it has not already been created on this machine,the wizard displays the dialog shown in Figure 21 on page 69.

Figure 20. Accepting the terms of the license agreement


The default location for the Tivoli Common Directory is displayed as:v For UNIX:

/usr/ibm/Tivoli/common

v For Windows:%Program Files%\ibm\tivoli\common

The %Program Files% parameter is the value stored in the Windows registryvariable ProgramFilesDir located inHKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion.

You can accept this default location, or if you prefer to locate the Tivoli CommonDirectory in a different location, you can modify this dialog as desired. Click Nextto continue with the installation.

If the Tivoli Common Directory was previously created on this machine, thewizard will detect it and display where it found the location. In this case, you arenot permitted to change the location of the Tivoli Common Directory in thiswindow, because other Tivoli applications might be using it. No action is required,just click Next to continue with the installation.

Step 4. Specify the Destination Install DirectoryThe InstallShield program prompts you to specify a destination directory for whereyou want IBM Tivoli Service Level Advisor to be installed, as shown in Figure 22on page 70.

Figure 21. Specifying the location of the Tivoli Common Directory.


A default location is displayed in the Directory Name field. You can use thisdefault, or replace it with your desired destination directory. If the directory doesnot exist it will be created for you.

Note: Do not use double-byte characters, umlauted characters, or characters withspecial accent marks in the destination path.

You can also click Browse... to navigate to the desired destination directory if italready exists. After you have specified the desired destination directory, click Nextto continue, Back to return to the previous display, or Cancel to quit the installprocess.

Step 5. Select SLM Install OptionsDepending on your desired deployment, you can install one or more of thefollowing main components of IBM Tivoli Service Level Advisor on a singlemachine, or distributed across multiple machines:v SLM Serverv SLM Reports, which must be installed on the machine designated as your SLM

Report server, where WebSphere was installed. If you have WebSphere AES (anysupported version) installed, this install option will automatically integrate thereport servlets into WebSphere. If you have installed WebSphere AE 4.0, you willhave to manually integrate the report servlets into WebSphere (see “IntegratingSLM Reports into WebSphere” on page 95 for more information).

v SLM Task Drivers, which must be installed on the machine designated as yourIBM Console Server (created during the installation process for Tivoli EnterpriseData Warehouse).

Figure 22. Specify a destination directory for IBM Tivoli Service Level Advisor.


Select one or more check boxes corresponding to the desired IBM Tivoli ServiceLevel Advisor options you wish to install on the current machine, as shown inFigure 23. You can select any combination of the three features to install, takinginto account the following:v If you select the SLM Reports option, you must have already installed a

supported version of WebSphere to act as the report servlet engine on thismachine.

v If you select the SLM Task Drivers option, you must have already installed theIBM Console Server on this machine as part of the install process for the TivoliEnterprise Data Warehouse.

If your application servlet engine or the IBM Console Server is installed on anothermachine, you must repeat this install process on those machines, selecting only thecorresponding options from the window.

When you have selected the desired SLM options to install on this machine, clickNext to continue, Back to return to the previous window, or Cancel to quit theinstall.

Step 6. Specify the Tivoli Presentation Services LocationIf you selected the SLM Task Drivers component of IBM Tivoli Service LevelAdvisor to be installed on this machine, the installation program expects that TivoliPresentation Services has already been installed as part of the Tivoli EnterpriseData Warehouse installation procedure. If the installation program cannot locatewhere Tivoli Presentation Services has been installed, the dialog box shown inFigure 24 on page 72 is displayed. You can click Browse to navigate to thedirectory, for example (for Windows), C:\PS. Select the correct directory or type itin the field provided, and click Next to continue.

Figure 23. Select one or more install options for the current machine.


Step 7. Specify Your WebSphere AES LocationIf you selected the SLM Reports option to install on the current machine, you arepresented with the dialog window shown in Figure 25.

On typical Windows systems, this location defaults to C:\WebSphere\AppServer.You can enter the path name in the Directory Name field provided, or clickBrowse... to navigate to the desired location.

Figure 24. Specifying the location where Tivoli Presentation Services was installed.

Figure 25. Specifying the location of WebSphere installed on your machine.


When you have specified the location of WebSphere, click Next to continue, orclick Back to return to the previous window, or Cancel to quit the install.

Step 8. Specify the WebSphere Node NameIf you are running WebSphere AES, you are prompted to specify the node name tobe used for your SLM Report Server. This is the name that WebSphere assigned tothe node that identifies the machine on which WebSphere is running. Note thatthis node name might be in short form or long (fully qualified) form, dependingon the machine. If you have already found this node name and recorded it on yourplanning worksheet, enter that value here. Otherwise, see “Identifying theWebSphere Node Name” on page 58 for the procedure to find this node name.

After specifying the node name for the SLM Report Server, click Next to continue,or click Back to return to the previous window, or Cancel to quit the install.

Step 9. Specify SLM Database InformationThe next set of dialogs prompt you to provide database connection information forthe SLM Database and the SLM Measurement Data Mart. Figure 27 on page 74 isfirst displayed, so you can specify whether the SLM Database is installed on thismachine (local) or on a remote system elsewhere in your enterprise.

Figure 26. Specify a node name for your SLM Report Server.


In this example, assume that you indicate that the SLM Database is installedlocally on this system. You are then prompted for additional connectioninformation, as shown in Figure 28.

You can specify the following information:

Figure 27. Specify if the SLM Database is installed locally or remotely.

Figure 28. Specify connection parameters for the locally installed SLM Database.


Database NameThis is the name of the database that was assigned when the database wascreated (see “Creating the IBM Tivoli Service Level Advisor ApplicationDatabases” on page 60. The following default names are provided for thesedatabases:

Database Default Database Name

SLM Database dyk_cat

SLM Measurement Data Mart dyk_dm

If you did not change these default names in the dyk_cat_dbinst ordyk_dm_dbinst scripts when these databases were created, you can acceptthese defaults, otherwise replace these names with the correct name in theDatabase Name field.

User IDThis is the signon user ID for the database. A default user ID is provided.You can accept this default or change it to another valid user ID.

PasswordThis is the signon password for the database. Specify the DB2 password forthe specified user ID.

If the database had been installed on a different (remote) machine in yourenterprise, you would have been prompted for additional connection informationabout the remote system. Typically you will create both the SLM Database and theSLM Measurement Data Mart on the same system, and would be asked for thesame information for each database. For purposes of illustration, however, supposethat you created the SLM Measurement Data Mart on a remote system. Similar tothe connection information for the SLM Database in Figure 27 on page 74, youspecify that the database is located remotely. With a remote database, the installwizard needs to know the host name and port number, and optionally the remotedatabase instance, in addition to the database name and connection user ID andpassword, as shown in Figure 29 on page 76.


For a remote database, you are asked for the following additional information:

Database Server Host NameThis is the fully qualified host name of the machine where the database islocated.

Database Server Instance Port Number or Service NameThis is the communication port number (default is 50000) or the servicename of the server database manager instance that contains the database.

Remote Database InstanceThis is an optional field that specifies the name of the server instance thatcontains the database.

Click Next to continue, or click Back to return to the previous window, or clickCancel to quit the install.

Using the above information, the install program attempts to connect to eachdatabase. If the attempt is successful, the install continues. If the attempt fails,examine the command window where you began the IBM Tivoli Service LevelAdvisor installation program, and look for SQL error messages to determine whythe installation program was not able to connect with the database. You mustcancel the IBM Tivoli Service Level Advisor installation program, correct anyproblems found with the databases, and start the IBM Tivoli Service Level Advisorinstallation again.

Figure 29. Specifying connection information for a remote database.


Step 10. Specify the DB2 Instance Home Directory for SLMDatabases

If you are installing on UNIX, you will be presented with a dialog prompting youfor the home directory of the DB2 instance of the SLM databases on the localmachine. Enter the home directory, similar to the following:/home/db2admin

Step 11. Specify Additional Server ConfigurationWhen you install the SLM Server, you will be prompted for some additionalconfiguration information as shown in Figure 30:

v The SLM Server Communication Port (this is also needed during the install ofthe SLM Task Drivers). The default value of 9980 is provided. You can replacethis with a different port number if desired.

v Command Line Interface Port. The default value of 9990 is provided. You canreplace this with a different port number if desired.

v Specify whether or not you want your command line interface (CLI) commandsto be password protected. If you select this option, CLI commands that areissued will be password protected and must be entered by specifying anadditional parameter, –p <password>, along with the regular CLI command.For example, the scmd log help command would have to be specified as:scmd -p <password> log help

Figure 30. Specifying additional server configuration information


This is useful if you want to restrict use of CLI commands to certain personnel.If password protection is desired, select the check box provided and specify theinitial value of <password> that must be given with each CLI command.

Note: Do not use double-byte characters, umlauted characters, or characterswith special accent marks in the CLI password.

See the Command Reference for IBM Tivoli Service Level Advisor for details aboutpassword protection for CLI commands.

If you are installing the SLM Task Drivers or SLM Reports on a machine differentfrom where the SLM Server is installed, you are prompted to specify the hostname of the machine on which the SLM Server is located, and the SLM ServerCommunication Port, as shown in Figure 31. This must be the same port value thatyou entered when the SLM Server component was installed (the default value of9980, or the port number that was specified if this default was not taken).

Step 12. Specify Event Notification MethodsWhen IBM Tivoli Service Level Advisor evaluates measurement data and detectsviolations or trends toward potential violations of service level agreements, eventnotices can be sent out in several different ways to alert support personnel,enabling them to take immediate corrective action to maintain agreed upon levelsof service. Figure 32 on page 79 shows the notification options that you can select.

If you want event notification to occur, you can select one or more of the followingmethods for sending event information:v SNMP Trapv Tivoli Enterprise Console Eventv E-mail

Figure 31. Specify information for communicating remotely with the SLM Server


If you want to enable event notification, check one or more of the check boxes.When you have made your selections, click Next to provide additionalconfiguration information for each of your selected notification methods, or clickBack to return to the previous window, or Cancel to quit the install.

Notification by SNMP TrapIf you selected the SNMP Trap option for event notification, the configurationwindow shown in Figure 33 on page 80 is displayed.

Figure 32. Select one or more event notification methods if desired.


When you select this notification option, you will be prompted to provide thefollowing information:

Destination Host NameThis is the fully qualified host name of the destination machine acting asthe receiving SNMP management station for SNMP traps.

Destination PortThis is the SNMP Trap destination port number. A default value of 162 isprovided. Specify a different port number if needed.

Community NameThis is an optional field containing the SNMP trap service communityname. A default value of public is provided.

Specify the above information, or accept the provided default values, and clickNext to continue, Back to return to the previous window, or Cancel to quit theinstallation.

Notification by Tivoli Enterprise Console EventIf you selected the Tivoli Enterprise Console event option for event notification, theconfiguration window shown in Figure 34 on page 81 is displayed.

Figure 33. Configuring the SNMP Trap notification method.


When you select this notification option, you are prompted to provide thefollowing information:

Event Server Host NameThis is the fully qualified host name where the Tivoli Enterprise Consoleevent server is installed.

Event Server PortIf the event server is installed on a Windows machine, enter the portnumber that the event server uses to listen on for events. The typical portvalue is 5529. See the Tivoli Enterprise Console event server configurationfor the correct port number.

When you have entered the required information, click Next to continue, Back toreturn to the previous window, or Cancel to quit the install.

Notification by E-MailYou can select this notification method if you want to send e-mail messages to oneor more addresses when an event occurs. You must specify the SMTP Server hostname to handle the messages, and also a To-List of e-mail addresses to send themessage to, separated by commas. You can also specify an optional CC-List ofadditional e-mail addresses to be copied on the message as desired. You can eitheraccept the default messages that are provided, or you can customize the messages.

When you select this notification option, the dialog window shown in Figure 35 onpage 82 is displayed.

Figure 34. Configuring the Tivoli Enterprise Console event notification method.


Provide the following information:

SMTP Server Host NameThis is the fully qualified host name of the SMTP Server to handle thee-mail messages. This is a required field.

Note: To avoid the possibility of corrupted characters in received e-mails,the e-mail system to which you will be sending notifications mustbe capable of handling characters in the UTF-8 character set.

To-List E-mail AddressesThis is one or more e-mail addresses, separated by commas, for the peopleyou want to notify. This is a required field. No error checking is performedon the e-mail addresses entered.

CC-List E-mail AddressesThis is one or more e-mail addresses, separated by commas, for additionalpeople you want to copy on the message. This might be reserved forsupervisory personnel or other people who may not deal directly with theviolation or trend information but who want to stay informed. No errorchecking is performed on the e-mail addresses entered.

After you have specified the SMTP Server name and the desired e-mail addressesto send notifications, click Next to continue configuring e-mail notification, or clickBack to return to the previous window, or Cancel to quit the install.

Continuing with the configuration of the e-mail notification method, a secondwindow is displayed as shown in Figure 36 on page 83.

Figure 35. Configuring the e-mail event notification method (part 1 of 2)


Specify the following:

E-Mail Subject LineThis is a subject line for the e-mail message. A default subject line isprovided, both as an acceptable generic subject that you can use, as well asan example for you to copy if you want to customize your own subjectline:SLO $EventType

Note that variables are permitted in the value, preceded by the $ character.

Violation MessageThis is the text of the e-mail message that is sent when a service levelagreement (SLA) violation is detected. A default message is provided, bothas an acceptable generic message that you can use, as well as an examplefor you to copy if you want to customize your own message whenever aviolation occurs:NOTICE: A metric violation has been detected.

The details are as follows:

Customer Name: <customer_name>

Order Number: <order_number>

Order Name: <order_name>

Other Affected Orders: <affected_orders>

Schedule State: <schedule_state>

Resource: <resource_name>

Metric Violated: <metric_name>

Units: <units>

Evaluation End Date: <evaluation_end_date>

Violation Details: <violation_details>

Figure 36. Configuring the e-mail event notification method (part 2 of 2)


You can use this generic default message or replace it with your ownmessage as desired. Variables are permitted in the text, preceded by a $character.

Trend MessageThis is the text of the message that is sent when a trend toward a potentialviolation has been detected. A default message is provided, both as anacceptable generic message that you can use, as well as an example for youto copy if you want to customize your own message whenever a trendoccurs:NOTICE: A trend toward a potential metric violation has been detected.

The details are as follows:


Order Number: <order_number>




Resource: <resource_name>

Metric Predicted to be Exceeded: <metric_name>

Units: <units>

Trend Projection: <trend_projection_details>

Analysis Period: <analysis_period>

Total Samples: <total_samples>


Trend Canceled MessageThis is the text of the message that is sent when a previously identifiedtrend toward a violation no longer exists. A default message is provided,both as an acceptable generic message that you can use, as well as anexample for you to copy if you want to customize your own messagewhenever a trend is canceled:NOTICE: A previously reported trend that had projected a future

metric violation has been CANCELED.

The metric associated with the following information is no longer

trending toward a violation:


Order Number: <customer_order_ID>




Resource: <component_name>

Metric Name: <metric_name>



See the scmd escalate configure CLI command in the Command Reference for IBMTivoli Service Level Advisor for details on the variables you can include in e-mailmessages. You can use this command to reconfigure these messages at a later timeif desired.

When you have completed specifying your event notification messages, click Nextto continue, or click Back to return to the previous window, or Cancel to quit theinstall.

Step 13. Confirm Your Install OptionsA confirmation screen will prompt you to confirm your intention to install thevarious IBM Tivoli Service Level Advisor features on your machine, similar to thatshown in Figure 37.

Click Next to proceed with the install, or click Back to go back and modify yourprevious selections, or press Cancel to quit the installation.

Step 14. Complete the InstallationThe install of IBM Tivoli Service Level Advisor will start, and you will see aprogress indicator on the dialog. Any messages will be logged to the filetraceTSLA1.2Install.log, located in the Tivoli Common Directory.

Figure 37. Confirm your installation selections to initiate the install.


To exit the installation program, click Finish.

If you are installing the SLM Reports option, the installation progress indicatormay stay at 100% for several minutes while the configuration is being performed.

If you are installing the SLM Task Drivers, when the install completes, someautomatic configuration of certain files will take place, including the rebuildingand enabling of the online user assistance files. These files might take 10-30minutes to be built and enabled. You can use the system during this time, but itmight be slower than usual while these files are being processed, and all of theonline user assistance might not be available until after this processing completes.You can verify completeness by examining either of the following:v Look in the following log file:

<PS_DIR>\log\fwp_mcr\stdout<n>.txt

where

<PS_DIR>is the directory where Tivoli Presentation Services was installed on theIBM Console Server machine

<n> is a number from 0 to 4 signifying one of several rolling log files

When the online user assistance build is complete, a message is displayed,similar to the following:FWP1734I The utility that was started by the Management Component Repository

to build the help set has completed successfully.

v Bring up the Windows Task Manager and wait for CPU usage to drop,signifying the processing of user assistance files has completed.

If you did not install all three IBM Tivoli Service Level Advisor install options onthis machine, you must repeat this install process on the other machines, installing

Figure 38. The progress indicator status bar tracks the installation progress.


each of the three options as desired in your enterprise environment. Be sure toselect the correct install option for each machine.

There are a few more steps you need to perform to configure your environment forIBM Tivoli Service Level Advisor. See Chapter 5, “Additional Installation Tasks” onpage 89 for details.

Note: Do not begin to create offerings and orders until you have completed theconfiguration steps in Chapter 5, “Additional Installation Tasks” on page 89that apply to your environment, including enabling source applications andcompleting the initial running of the Registration ETL. In addition, be awarethat some internal processing will take place to initialize the SLM Server andSLM Database for creating offerings and orders, and you should wait atleast 30 minutes after the Registration ETL is initially run before attemptingto create offerings and orders, otherwise you may receive errors.


Chapter 5. Additional Installation Tasks

After you have completed the installation of IBM Tivoli Service Level Advisor asdescribed in Chapter 4, “Installing IBM Tivoli Service Level Advisor” on page 59,there are a few additional installation tasks you need to complete to configure yourenvironment for IBM Tivoli Service Level Advisor:v Configure for event notification (e-mail, SNMP trap, TEC Event)v Installing the warehouse pack for IBM Tivoli Service Level Advisorv Integrating SLM Reports into WebSpherev Installing Language Support

These tasks are described in the sections that follow.

Configuring for Event NotificationDuring the install of IBM Tivoli Service Level Advisor, you were given the optionto specify the method by which event notification would occur (see “Step 12.Specify Event Notification Methods” on page 78). Depending on which method youselected, refer to the following sections to configure for event notification.

Configuring for Notification by SNMPIf you specified to be notified by the SNMP Event method for event notification,you can load the MIB definitions file located in the <SLM_Install_Dir>/escalatedirectory, where <SLM_Install_Dir> is the directory where IBM Tivoli Service LevelAdvisor is installed.

Configuring for NetViewTo configure for SNMP traps that will be forwarded to a NetView AIX server, runthe following script file, located in <SLM_Install_Dir>/escalate, in the machinewhere NetView AIX is installed:./slmAddTrapsUnix.sh

To reverse this operation, you can run the following script:./slmRemoveTrapsUnix.sh

To configure for SNMP traps that will be forwarded to a NetView NT server, runthe following script file in the machine where NetView NT is installed:slmAddTrapsWin.bat

To reverse this operation, you can run the following script:slmRemoveTrapsWin.bat

Configuring for Notification by Tivoli Enterprise ConsoleIf you selected the Tivoli Enterprise Console (TEC) Event method for eventnotification, you will need to import, load, and compile the SLM Class Definitionfile SLM.baroc, and optionally apply the sample rule file, slm.rls, that is providedwith this installation of IBM Tivoli Service Level Advisor.

89

The rule defined in slm.rls correlates each trend or cancel event request receivedat the server with previous events that have a matching metric name, schedulestate, order element instance, and component name, and closes the correspondingevents.

Both files are located in the <SLM_Install_Dir>/escalate directory, where<SLM_Install_Dir> is the directory where IBM Tivoli Service Level Advisor isinstalled.

You will have to manually delete any previous version from the TEC graphicaluser interface before applying the new versions of these files. See Chapter 3, ″RulesBases and Rule Base Administration″ in the Tivoli Enterprise Console Rule Builder’sGuide to apply these files to your Tivoli Enterprise Console environment.

Verifying Notification MethodsRegardless of which method of event escalation and notification you selected(e-mail, SNMP trap, or Tivoli Enterprise Console event), the IBM Tivoli ServiceLevel Advisor installation program does not check for configuration errors such asan e-mail address that has been entered incorrectly.

You can perform some basic verification of the notification method by issuing thefollowing CLI command:scmd escalate test

This command sends a test event through each enabled method (e-mail, SNMPtrap, or Tivoli Enterprise Console event), and you must verify that the designatedrecipient successfully received the test event notification.

If the test event is not received, you should check server names, e-mail IDs, andport numbers to verify that the server is working correctly. You can use the scmdescalate enable command to make changes or corrections to the followingescalation parameters after installation:v e-mail addresses and SMTP server namev TEC Server name and port numberv SNMP destination, port, and community name

You can also use the scmd escalate customize command to make changes orcorrections to e-mail subject lines and messages that are sent for event notification.

See the Command Reference for IBM Tivoli Service Level Advisor for information onscmd escalate test, scmd escalate enable, and other CLI commands.

Installing the Registration and Process ETLsIBM Tivoli Service Level Advisor uses two target ETLs to move and transform datafrom the Tivoli Enterprise Data Warehouse central data warehouse database to itsapplication databases:v The Registration ETL moves component type information from the central data

warehouse to the SLM Database, where it is used during offering and ordercreation.

v The Process ETL moves measurement data from the central data warehouse tothe SLM Measurement Data Mart, where it is evaluated for service levelviolations and trends toward violations by IBM Tivoli Service Level Advisor.


These target ETLs are installed on the machine where the control server is located,using the warehouse pack install option in the Tivoli Enterprise Data Warehouseinstall wizard, and then configured for use with Tivoli Enterprise Data Warehouseand IBM Tivoli Service Level Advisor.

Installing the Registration ETL and the Process ETL involves the following steps:1. Use the Application installation only option of the Tivoli Enterprise Data

Warehouse install program to install the IBM Tivoli Service Level Advisorwarehouse pack

2. Configure the user ID and password for the central data warehouse, the SLMDatabase, and the SLM Measurement Data Mart

3. Enable data collection for all desired source applications before running theRegistration ETL

4. Schedule the Registration ETL and Process ETL to run and promote them toproduction mode.

5. Optionally run the Registration and Process ETLs to move data into the SLMDatabase and SLM Measurement Data Mart if you don’t want to wait for thescheduled run time.

Note: This install procedure references files used and databases created during theinstallation of Tivoli Enterprise Data Warehouse. Refer to the TivoliEnterprise Data Warehouse installation documentation for more information.

Installing the IBM Tivoli Service Level Advisor WarehousePack

This step installs the Registration ETL and Process ETL into the Data WarehouseCenter on the DB2 server machine where the control server is installed. Refer tothe installation procedures for Tivoli Enterprise Data Warehouse (see “InstallingTivoli Enterprise Data Warehouse 1.1” on page 39).

To install the Registration ETL and Process ETL, do the following:1. Insert the Tivoli Enterprise Data Warehouse product CD to start the Tivoli

Enterprise Data Warehouse installation program.2. On the Welcome window, click Next to continue.3. Select Application installation only from the install dialog and click Next to

continue.4. You are prompted to verify the fully qualified host name of the local machine.

The input field should contain your local machine host name by default.Verify this information and modify it if needed. Click Next to continue.

5. Enter your local DB2 user name and password. Click Next to continue.6. You are prompted to enter the path to the installation media for the

application packages. The Registration ETL and Process ETL are located on theIBM Tivoli Service Level Advisor product CD.

7. Remove the Tivoli Enterprise Data Warehouse product CD and insert the IBMTivoli Service Level Advisor product CD.

8. Click Browse and navigate to the following directory, where <Install_CD> isthe drive letter of the CD-ROM drive:<Install_CD>:\tedw_apps\dyk\

9. Select this directory.

Chapter 5. Additional Installation Tasks 91

10. On the Application Package Directory Name dialog, verify that the directoryname is specified as <CD_ROM>:\tedw_apps\dyk\, where <CD_ROM> is theCD-ROM drive letter.

11. Leave the Now radio button selected to verify the source directory, and clickNext to continue.

12. On the Additional Applications Packages dialog, verify that the Yes, installapplication packages check box is not checked, and click Next to continue.

13. On the feature summary dialog showing your selections, confirm yourselections and click Install to begin the installation.

Configuring the User ID and PasswordTo configure the user ID and password, do the following:1. From the DB2 Control Center, launch the Data Warehouse Center by selecting

Tools –> Data Warehouse Center.2. Click Advanced and if the Control Database is not set to TWH_MD, set it to that

name.3. Log into the Data Warehouse Center using your DB2 username and password.

Note: If you cannot log in, you might need to restart the Warehouse Logger andthe Warehouse Server services from the Services control panel to reconnectto the twh_md database.

4. In the left pane of the Data Warehouse Center, expand the Warehouse Sourcesand Warehouse Targets folders. To configure the user ID and password foreach source and target database, complete the following steps:a. Highlight the source or target and select Selected –> Properties or

right-click and select Properties to launch the Properties dialog.

Note: If you have multiple databases that you want to configure the sameuser ID and password, you can select either the Warehouse Sourcesor Warehouse Targets folder, then highlight all of the desireddatabases at once and set the user ID and password for all of them atthe same time.

b. On the Properties dialog, click the Database tab.c. Enter the user ID and password information for the database (the database

name will match one of the ODBC data sources that you configured. See“Configuring ODBC Data Sources” on page 64 for details.) and click OK.

Repeat the above steps for each source and target database for the RegistrationETL and the Process ETL. Table 12 shows the source and target databases toconfigure.

Table 12. Source and target databases for the Registration and Process ETLs

ETL Source Database Target Database

Registration ETL twh_cdw dyk_cat

Process ETL twh_cdw dyk_dm

Enabling Data Collection for Source ApplicationsBy default, the Registration ETL will not collect any data from the Tivoli EnterpriseData Warehouse database until one or more source applications have been enabled


for data collection. Only data types from source applications that are enabled willbe recognized by IBM Tivoli Service Level Advisor during offering and ordercreation.

Use the scmd etl enable command and the scmd etl addApplication Datacommand to enable source applications for IBM Tivoli Service Level Advisor. Forexample:scmd etl addApplicationData XYZ "XYZ Warehouse Application"

scmd etl enable XYZ

Use the scmd etl getApps command to retrieve and display a list of all of theapplications in the Tivoli Enterprise Data Warehouse database supported by IBMTivoli Service Level Advisor, and to show whether each application is enabled ordisabled for data collection. For example:scmd etl getApps

Use the scmd etl disable command to disable applications for which you do notwant to collect data. For example:scmd etl disable XYZ

Refer to the Command Reference for IBM Tivoli Service Level Advisor for details onthese CLI commands.

Promoting the ETLs to Production ModeTo promote the Registration ETL and Process ETL to production mode, do thefollowing:1. Click Subject Areas. The dialog displays several different subject areas. Of

interest to you are the areas with the prefix DYK.2. Underneath the DYK subject area, expand the Processes folder. Individual

processes for the subject area are displayed.3. Select the process and then select Selected –> Schedule or right-click and select

Schedule to launch the Schedule dialog.4. In the Schedule dialog, create a schedule by configuring the day and time that

you want to run the Registration ETL and Process ETL, and add it to the list ofschedules.

Notes:

a. As you schedule the Registration and Process ETLs to run, consider thefollowing:v The source applications will be putting their collected data into the

warehouse database according to unique schedules defined for theirenvironment. Be sure to allow enough time for the source applicationETLs to complete before running the Registration and Process ETLs.

v The Registration ETL must be scheduled to run after the last source ETLcompletes processing, and must complete its processing to move datatype information from the warehouse to the SLM Database (dyk_cat)before the Process ETL is run.

v The Process ETL must be scheduled to run after the Registration ETL hascompleted processing.See Chapter 1 of the Administrator’s Guide for IBM Tivoli Service LevelAdvisor for an overview of the source and target ETLs and theirrelationship to each other.


b. If you plan to schedule the ETL to run immediately, configure the start timefor at least several minutes from the current time to enable you to completethese steps and promote the ETLs to production mode. Once a schedule hasbeen defined, however, you can always select it later and run it on demandinstead of waiting for the set time to expire.

5. Click Add> to add the schedule to the list.6. Click OK.7. In the right pane of the Data Warehouse Center, all of the steps of the process

are displayed with the step number embedded in the step name in the form*_s<nnn>_*, where <nnn> is the step number. Highlight all of these steps.

8. When all of the steps are highlighted, promote them to production mode byselecting Selected –> Mode –> Production, or right-click and select Mode –>Production.

Running the Registration ETL and Process ETLDepending on when you set the schedule for running the Registration ETL andProcess ETL, you can either wait for the scheduled time and date to elapse for theETL to be started automatically, or you can run the ETL immediately.

Note: The Registration ETL should not be run until after the SLM Server isinstalled and you have enabled all desired source applications for which youwant data to be collected. See the scmd etl enable and scmd etladdApplicationData commands in the Command Reference for IBM TivoliService Level Advisor for details on enabling source application data.

If you choose to run the ETLs immediately, note that the Registration ETL must berun and all processing completed before running the Process ETL, otherwise errorswill occur in the data collection.

From the Data Warehouse Center, you can monitor the progress of the ETLs byselecting Warehouse –> Work in Progress and examining the Work in Progresswindow.

You can find the ETLs scheduled to be run by looking in the Status column forScheduled. You can run that ETL immediately by right-clicking on it and selectingRun Now. The names of the processes are as follows:v Registration: DYK_m05_Populate_Registration_Datamart_Processv Process: DYK_m10_Populate_Measurement_Datamart_Process

The Work in Progress window will display each step as it executes, changing thestatus appropriately. When the status for all of the ETL steps is Successful, the ETLhas completed.

Run the Registration and Process ETLs in this order:1. Open the Work In Progress window and select the scheduled entry that

contains DYK_m05_Populate_Registration_Datamart_Process

2. Right-click on the entry and select Run Now.3. Wait for all steps to complete and verify that all steps were successful before

going to the next step.4. On the Work In Progress window, select the scheduled entry that contains

DYK_m10_Populate_Measurement_Datamart_Process

5. Right-click on the entry and select Run Now.


6. Wait for all steps to complete and verify that all steps were successful.

Purging Aged Data from the SLM Measurement Data MartSimilar to the scheduling and promoting of the Registration and Process ETLs toproduction mode, you also need to schedule and promote the Purge Target ETL,DYK_m15_Purge_Measurement_Datamart_Process. This ETL can be thought of as anextension of the Process ETL, as it purges aged data from the SLM MeasurementData Mart (DYK_DM) database (data that was originally loaded by the ProcessETL). This helps prevent the SLM Measurement Data Mart from getting too largeover time.

Use the same procedure as described in “Promoting the ETLs to Production Mode”on page 93 to schedule and promote this ETL.

You can schedule this ETL to run at any time to control the removal of aged data.By default, the data will remain in the SLM Measurement Data Mart for 63 days.You can view the current expiration setting by issuing the scmd etlgetDataExpiration command, and you can modify this value by using the scmd etlsetDataExpiration <number_of_days> command.

When this ETL is run, it reads this value and purges the SLM Measurement DataMart of any measurement data records that are older than the configuredexpiration date.

See the Command Reference for IBM Tivoli Service Level Advisor for details on theseand other scmd commands.

Integrating SLM Reports into WebSphereDepending on which version of WebSphere you are using as your applicationserver for SLM reports, you must perform some manual steps to integrate the SLMReports into the WebSphere environment. The following sections assume thefollowing:v The appropriate version of WebSphere was installed successfullyv Any appropriate fix pack needed has also been installed successfully.v the SLM Reports install option of IBM Tivoli Service Level Advisor was installed

successfully on the same machine as WebSphere. This machine is referred to asthe SLM Report Server.

Integrating into WebSphere AETo integrate SLM reports into WebSphere AE 4.0.1, complete the following steps:1. Start the IBM HTTP Server and IBM HTTP Administration services if they

are not already started (see “Starting the IBM HTTP Services” on page 107).2. Start the WebSphere Admin Server (see “Starting the IBM WebSphere AE 4.0

Admin Server” on page 107).3. Open the Administrative Console (see “Starting the WebSphere Admin

Console” on page 107).4. From the menu bar of the Administrative Console, select Console –> Wizards

–> Install Enterprise Application.5. In the Specifying the Application or Module dialog, do the following:

a. Ensure that the Browse for file on node field is set to your current node.b. Click Install stand-alone module (*.war, *.jar).


c. Click Browse at the Path field to navigate to the following file, where<SLM_Reports_Dir> is the directory where SLM Reports was installedduring the IBM Tivoli Service Level Advisor installation process (see “Step5. Select SLM Install Options” on page 70):<SLM_Reports_Dir>/report/SLMReport.war

d. Select the SLMReport.war file.e. Enter the name for Application name. It can be any name of your

choosing.f. Enter SLMReport for the context root for web module.g. Click Next to continue, until the Selecting Virtual Hosts for Web Modules

dialog is displayed.h. Verify that the web modules specified in the Web Module column are

using the virtual host named default_host. If desired, you can change thisvirtual host by selecting a different virtual host that you have created.

i. Continue to click Next until you click Finish to exit the wizard.6. Open the web.xml file, located in the following directory, where <app_name> is

the name you specified in step 5e:<WebSphere_Dir>/AppServer/installedApps/<app_name>.ear/SLMReport.war/Web-inf

Edit this file using your preferred XML or text editor. You should find the partof the file that looks like the following example:<init-param id="InitParam_1">

<param-name>tsla.basedir</param-name>

<param-value>install_dir</param-value>

</init-param>

<init-param id="InitParam_2">

<param-name>tsla.programfiles</param-name>

<param-value>program_files_dir</param-value>

</init-param>

For Windows, do the following:v Change the value for install_dir to the directory where you installed IBM

Tivoli Service Level Advisor (for example, C:\TSLA).v Change the value for program_files_dir to the system location specific to

your locale. For example, the English locale would be C:\Program Files,while the German locale would be C:\Programme. You can determine theright value for your locale from the HKEY_LOCAL_MACHINE key in the registry,at SOFTWARE\Microsoft\Windows\CurrentVersion\ProgramFilesDir.

Note: Do not put quotes around the directory path even if it contains ablank space.

The resulting portion of the Windows web.xml file might look like thefollowing:<init-param id="InitParam_1">


<param-value>C:\TSLA</param-value>

</init-param>



<param-value>C:\Program Files</param-value>


</init-param>

For UNIX, do the following:v Change the value for install_dir to the directory where you installed IBM

Tivoli Service Level Advisor (for example, /usr/TSLA).v Leave the value for program_files_dir blank.

The resulting portion of the UNIX web.xml file might look the following:<init-param id="InitParam_1">


<param-value>/usr/TSLA</param-value>

</init-param>



<param-value></param-value>

</init-param>

When finished, save and close the file and restart the Web server.7. From the WebSphere Administrative Console, expand the WebSphere

Administrative Domain node in the tree. Select Nodes and then right-click onyour machine host name. From the context menu, select Regen WebserverPlugin.In the bottom section of the WebSphere Administrative Console dialog, watchfor an event message stating that the plugin regeneration has been completed.

8. Verify that the Admin DB Driver points to the correct driver, for example,COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource. To verify this, do thefollowing:a. From the left pane of the WebSphere Administrative Console, select

Resources –> JDBC Providers.b. In the General tab, click the square navigation button to the right of the

Implementation class field. The Implementation Class window isdisplayed.

c. From the Implementation Class window, select the appropriate driver, forexample, COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource, and click OK.

d. Returning to the General tab, click Apply.9. While you are still in the JDBC Providers window, configure your classpath

by doing the following:a. From the Nodes tab, click Install New.... The Install Driver window is

displayed.b. Your machine node name should be displayed. Highlight your node name

and then click Specify Driver.... The Specify the Driver Files window isdisplayed.

c. Click Add Driver... and navigate to the directory where your DB2 driver,db2java.zip, is located:v For Windows, this is typically in the <DB2_Dir>/java directory, where

<DB2_Dir> is the directory where DB2 is installed.v For UNIX, this is typically in the <DB2_Instance_Dir>/sqllib/java12

directory, where <DB2_Instance_Dir> is the directory where the DB2instance is installed.

d. Double-click the db2java.zip file to select it and return to the Specify theDriver Files window.


e. Click Set to close the Specify the Driver Files window and return to theInstall Driver window.

f. From the Install Driver window, click Install to close the Install Driverwindow and return to the Nodes tab in the JDBC Providers window.

g. From the Nodes tab, click Apply.10. Because adding a new application requires a change to the server

configuration, you must stop and restart the server for the change to takeeffect. Stop the application server and restart it again as follows:a. From the console tree, select WebSphere Administrative Domain –>

Nodes –> <your_host_name> –> Application Servers and right-click onDefault Server.

b. From the context menu, select Stop. You should receive a message whenthe default server was stopped successfully.

c. Right-click on Default Server again and select Start from the contextmenu. You should receive a message when the default server was startedsuccessfully.

11. From your Web browser, point to the following Web site:http://<myHost>/SLMReport

where <myHost> is the host name of the machine where WebSphere isinstalled.

See “Accessing SLM Reports in WebSphere AES 4.0” on page 127 fortroubleshooting information related to integrating SLM Reports with WebSphereAE.

Integrating into WebSphere AESThe integration of SLM reports into WebSphere AES is performed automaticallyduring the installation of IBM Tivoli Service Level Advisor, however if you lateruninstall WebSphere AES and reinstall it again without reinstalling IBM TivoliService Level Advisor, you must manually integrate the SLM Reports intoWebSphere by doing the following:1. From a command prompt, navigate to the <SLM_Install_Dir>/bin directory,

where <SLM_Install_Dir> is the directory where IBM Tivoli Service LevelAdvisor was installed, and run the following command:v For Windows:

aes40installwar

v For UNIX:./aes40installwar.sh

2. Edit the web.xml file as described in step 6 on page 96, to modify the location ofthe IBM Tivoli Service Level Advisor install directory and the locale-specificProgram Files directory.

3. Return to the <SLM_Install_Dir>/bin directory and run the followingcommand:v For Windows:

aes40reportgenplugin

v For UNIX:./aes40reportgenplugin.sh


Modifying HTTP Server Ports for WebSphereIf you installed WebSphere on the same machine where the IBM Console isinstalled, there may be a port conflict between WebSphere and Tivoli PresentationServices, which both use the same default port numbers for IBM HTTP Server andIBM HTTP Administration.

If you need to modify the port settings for WebSphere after installing, you can editthe following files:v IBM HTTP Server/conf/httpd.conf, change port 80 to 81 or another unused port

number.v IBM HTTP Server/conf/admin.conf, change port 8008 to 8009 or another unused

port number.

Restarting WebSphereAfter completing the installation and integration of SLM Reports option on themachine where WebSphere is installed, stop and restart WebSphere. See Chapter 6,“Startup and Shutdown Procedures” on page 103 for information on starting andstopping WebSphere.

Note: If, immediately after installing the SLM Reports option, you access theWebSphere AES Web-based Administrator Console and receive the followingmessage:Alert: The changes that were made before your session timed out have been

saved to a temporary configuration file...

Choose Cancel to avoid having the configuration information that wasmodified during the installation overwritten with the last saved temporaryfile. If this configuration information is lost, you must manually install theSLM Report WAR file.

Accessing SLM ReportsTo access SLM Reports, open your Web browser and point to the following Website:http://localhost:9080/SLMReport

The HTTP port used by WebSphere is 9080.

You can log in to the system using any of the following default user names, whichwere created for you automatically during the installation:username: customer, operations, or executive

password: password (same for all three usernames)

Each of these pre-authorized user names enables you to view different versions ofreports with different time ranges. For example, a user signed in with operationsauthority will see a list of offering components with information from the previousseven days. A user with executive authority will see information for a list ofcustomers over the previous month. A user with customer authority will see a listof customer orders over the previous month.

See the Administrator’s Guide for IBM Tivoli Service Level Advisor for information onworking with SLM Reports and customizing them for your use.


Installing Language SupportYou can install additional language support for IBM Tivoli Service Level Advisorafter all of the install options have been successfully installed. If the SLM Server,SLM Task Drivers and SLM Reports are installed on different machines, this installprocedure must be performed on each machine.

Note: On UNIX, you must be the root user to run the installation program. OnWindows, you must have Administrator’s privileges to run the installationprogram.

To install language support, do the following:1. Make sure that all of the IBM Tivoli Service Level Advisor install options were

successfully installed.2. Insert the IBM Tivoli Service Level Advisor Language Support CD into the local

machine.3. From the root directory of the install CD, run the following script:

v For Windows:install.bat

v For UNIX:./install.sh

4. You will have to specify which SLM install options are already installed on thelocal machine. Depending on your selections, the appropriate jar files will beinstalled.

5. You will also be asked to verify and enter the install directories for thefollowing:v The installation location of the IBM Tivoli Service Level Advisor Language

Pack. The default location for these files is:– For Windows: %Program Files%\tslaNLS, where %Program Files% is the

value stored in the Windows registry variable ProgramFilesDir located inHKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion.

– For UNIX: /opt/tslaNLSv The install location of the base directory for IBM Tivoli Service Level Advisor.

This is typically the directory where the SLM Server was installed, but if theSLM Server was not installed on this system, the directory can be determinedfrom the SLM_BASEDIR environment variable (set when the slmenv script isrun).

v The installation location for the Server for IBM Consolev The installation location of the WebSphere Application Server

The two latter directories are detected automatically. The language supportinstallation procedure will stop and restart these applications as necessary.

In addition, you are prompted to enter the WebSphere Application namecreated for the SLM Reports component (for WebSphere AE, see step 5e onpage 96. For WebSphere AES, this would be SLMReport).

The installation procedure installs two jar files for each language, one whichcontains Java Resource Bundles, TSLMResources_<lang>.jar (where <lang>indicates the language) and another, DYKUAHelpPSNls_<lang>@1.2.0.jar whichcontains Helpset files. For these file names, <lang> represents the language:v ja: Japanese


v ko: Koreanv de: Germanv fr: Frenchv it: Italianv es: Spanishv zh_CN: Simplified Chinesev zh_TW: Traditional Chinesev pt_BR: Brazilian Portuguese

Install creates a main logfile, traceTSLA1.2LPInstall.log in the Tivoli CommonDirectory, under /DYK/logs/LP/install. This file contains any errors or warningsthat the installation program might encounter during installation. A master copy ofthis log file is placed into the temporary directory for the current user (typically/tmp on UNIX and the value of the %TEMP% environment variable on Windows).This log file will always be generated, as it contains some debug information aswell.

The installation procedure also executes two batch scripts per language as part ofthe install for SLM Task Drivers. These scripts are created by the language packinstall program in the following directory structure:v <LP_Dir>/bin (where <LP_Dir> is the installation location that you specified for

the language pack), for checktcserver.sh, used only for AIX support for SLMTask Drivers

v <LP_Dir>/bin/<lang>, for all language-specific scripts needed for SLM TaskDrivers installation support

These are the wcmd commands used to install IBM Tivoli Presentation Servicescomponents. Do not delete these files after the installation completes, because theuninstall procedure also uses these scripts. Any errors from these commands arewritten to log files under the Tivoli Common Directory, at/DYK/logs/LP/install/LPwcmd*.log. Four such files may be created per language,similar to the following:v LPwcmd<log_lang>1.logv LPwcmd<log_lang>11.logv LPwcmd<log_lang>2.logv LPwmcd<log_lang>22.log

Each supported language is represented in <log_lang> by a one characterabbreviation for each language:v j: Japanesev k: Koreanv d: Germanv f: Frenchv i: Italianv e: Spanishv s: Simplified Chinesev t: Traditional Chinesev p: Brazilian Portuguese


Files, *1.log and *2.log contain the executed commands, and *11.log and *22.logcontain output from the command execution.

Language support must be uninstalled before it is reinstalled.

For SLM Reports, WebSphere needs to be restarted after language support hasbeen installed.


Chapter 6. Startup and Shutdown Procedures

You can use the following procedures for startup and shutdown of IBM TivoliService Level Advisor, the IBM Console, and WebSphere, referred to elsewhere inthis document.

IBM Tivoli Service Level Advisor can be started and stopped as a native service onsupported Windows platforms. On UNIX platforms, shell scripts are available forstartup and shutdown.

Note: IBM Tivoli Service Level Advisor starts automatically on all platforms afterinstallation and each time the system is restarted.

Starting the IBM Tivoli Service Level Advisor SolutionThe following sections describe the startup procedures:v “Starting the Server for IBM Console Service”v “Starting Web Services for IBM Console” on page 104v “Starting the SLM Server” on page 104v “Starting the IBM Console” on page 105v “Starting IBM WebSphere Application Server” on page 106v “Starting the IBM WebSphere AE 4.0 Admin Server” on page 107v “Starting the WebSphere Admin Console” on page 107v “Starting the IBM HTTP Services” on page 107

Starting the Server for IBM Console ServiceStart the Server for IBM Console service, as follows:v For Windows:

1. Select the Services administration tool from the Windows Control Panel:– For Windows 2000, select Start –> Settings –> Control Panel –>

Administrative Tools –> Services

– For Windows NT, select Start –> Settings –> Control Panel –> Services

2. If the Server for IBM Console service is not already started, start the serviceby doing any one of the following:– From the Services administration tool, highlight Server for IBM Console,

right-click and select Start from the context menu box.– At a command prompt, navigate to the <PS_Dir>\bin\w32-ix86 directory,

where <PS_Dir> is the directory where Tivoli Presentation Services isinstalled, and run the following command:mcr.bat

– At a command prompt, run the following command:net start ps_mcr

v For UNIX:1. To determine whether the Server for IBM Console service is already started,

run the following command:ps -efl | grep mcr

103

(For Solaris, the command is ps -ef)

If you see a process that calls mcr.sh, then this service is already started.Otherwise this service is not started.

2. If the Server for IBM Console service is not already started, start it bynavigating to the <PS_Dir>/bin/generic_unix directory, where <PS_Dir> isthe directory where Tivoli Presentation Services is installed, and running thefollowing command:./mcr.sh

Starting Web Services for IBM ConsoleStart the Web Services for IBM Console service, as follows:v For Windows:




2. If the Web Services for IBM Console service is not already started, start theservice by doing any one of the following:– From the Services administration tool, highlight Web Services for IBM

Console, right-click and select Start from the context menu box.– At a command prompt, navigate to the <PS_Dir>\bin\w32-ix86 directory,

where <PS_Dir> is the directory where Tivoli Presentation Services isinstalled, and run the following command:wc.bat

– At a command prompt, run the following command:net start ps_wc

v For UNIX:1. To determine whether the Web Services for IBM Console service is already

started, run the following command:ps -efl | grep wc


If you see a process that calls wc.sh, then this service is already started.Otherwise this service is not started.

2. If the Web Services for IBM Console service is not already started, start it bynavigating to the <PS_Dir>/bin/generic_unix directory, where <PS_Dir> isthe directory where Tivoli Presentation Services is installed, and running thefollowing command:./wc.sh

Note: You may need to restart Web Services for IBM Console after rebootingyour UNIX system.

Starting the SLM ServerStart the SLM Server as follows:v For Windows, the SLM Server is automatically started as a service at the end of

the installation process, and when the system is restarted. To manually start theSLM Server, do either of the following:


– From the Services control panel, verify that the IBM Tivoli Service LevelAdvisor service is not already started. If it is not started, highlight IBM TivoliService Level Advisor, right-click and select Start from the context menu box.

– From a command prompt, enter the following command:net start

In the list of applications that are displayed, look for IBM Tivoli ServiceLevel Advisor. If it is not in the list, issue the following command to startIBM Tivoli Service Level Advisor:net start tslm

v For UNIX, the SLM Server is automatically started at the end of the installationprocess, and when the system is restarted. To manually start the SLM Server, dothe following:1. To determine whether the the SLM Server is already started, run the

following command:ps -efl | grep slm_start


If you see a process that calls slm_start.sh, then this service is alreadystarted. Otherwise this service is not started.

2. If slm_start.sh is not found, navigate to the <SLM_Server_Install_Dir>/bindirectory, where <SLM_Server_Install_Dir> is the location where the SLMServer was installed, and run the following script (note this is not the sameas slm_start.sh):./slm_service_start.sh

On all platforms, the standard out and standard error logs for the SLM Server arelocated in the Tivoli Common Directory as tslmout.txt and tslmerr.txt,respectively. On AIX platforms, additional log files, tslmsubsysout.txt andtslmsubsyserr.txt are created in the <SLM_Server_Install_Dir>/log directory,when the subsystem is started.

Starting the IBM Console

Note: You may see an icon on your desktop named IBM Console. This is theJava-based version of the IBM Console and is only used by IBM TivoliService Level Advisor for enabling tracing and for viewing message logs.The regular administrative tasks and functions are run from the Web-basedversion of the IBM Console from within your Web browser.

To start the IBM Console, do the following:1. Open your Web browser and point it to the following location:

http://<IBM_Console_Server_machine>:<IBM_HTTP_Port>/IBMConsole

where

IBM_Console_Server_machineis the host name of the machine on which the IBM Console Server wasinstalled

IBM_HTTP_Portis the IBM HTTP port number (default is 80)

Chapter 6. Startup and Shutdown Procedures 105

2. The Sign On screen is displayed, prompting you for your user ID andpassword. You can sign on using the following values:User ID: superadmin

Password: password

From the IBM Console that displays, you can perform tasks such as:v Create schedules, offerings, customers, realms and ordersv Create and manage users and rolesv Backup and restore operations

You can also view Web-based reports on the results of SLA evaluations performedby IBM Tivoli Service Level Advisor from your Web browser. See the AdministratorsGuide for IBM Tivoli Service Level Advisor for more information on performing thesetasks.

You can also run command line interface (CLI) commands from the machine onwhich you installed the SLM Server. See the Command Reference for IBM TivoliService Level Advisor for details on the CLI commands you can run.

Starting IBM WebSphere Application ServerStart the IBM WebSphere Application Server for WebSphere AES by doing any oneof the following:v For Windows, select Start –> Programs –> IBM WebSphere –> Application

Server –> Start Application Server

v For Windows, from a command prompt, navigate to the <WebSphere_Dir>\bindirectory, where <WebSphere_Dir> is the directory where WebSphere wasinstalled, such as C:\WebSphere\Appserver, and run the following command:startServer.bat

v For UNIX, do the following:1. Source the db2profile file locally, by navigating to the

<db2_instance_directory>/sqllib directory, where <db2_instance_directory> isthe home directory of the database administrator who created the DB2instance, and run the following command:. db2profile

2. Navigate to the <WebSphere_Dir>/bin directory, where <WebSphere_Dir> is thedirectory where WebSphere was installed, such as /usr/WebSphere/Appserver,and run the following command:./startServer.sh

Additional methods of starting the IBM WebSphere Application Server AES aredocumented in the WebSphere AES documentation, including the following:v Starting from the First Steps dialog, which is displayed at the end of WebSphere

product installationv Starting from the Servers page of the Administrative Console

v Generating a startup script, possibly modifying its parameters, and running thescript

v Starting using the basic startup script, provided for backward compatibility

See the following Web site for information:www.ibm.com/software/webservers/appserv/doc/v40/aes/infocenter/was/0606a.html


Starting the IBM WebSphere AE 4.0 Admin ServerStart the IBM WebSphere Admin Server for WebSphere AE 4.0 by doing thefollowing:v For Windows, do either of the following:

– Start the WebSphere Admin Server from the Services control panel– Issue the following command from a command prompt:

net start "ibm ws adminserver 4.0"

v For UNIX, do the following:1. Verify that you are running as the root user.2. From a command prompt, navigate to the directory

<WebSphere_Dir>/AppServer/bin, where <WebSphere_Dir> is the directorywhere WebSphere was installed, and run the following command:./startupServer.sh

Starting the WebSphere Admin ConsoleAt a command prompt, start the WebSphere Administrator’s Console by doing thefollowing:v For Windows, select Start –> Programs –> IBM WebSphere –> Application

Server –> Administrator’s Console

v For UNIX, navigate to the directory <WebSphere_Dir>/bin, where<WebSphere_Dir> is the directory where WebSphere was installed, such as/usr/WebSphere/AppServer, and run the following command, where <your_hostname> is your machine host name:./adminclient.sh <your_host name>

Starting the IBM HTTP ServicesStart the IBM HTTP Server and IBM HTTP Administration services if they arenot already started by doing the following:v For Windows, you can start these from the Services control panel or by issuing

the following commands from a command prompt:net start "ibm http server"

net start "ibm http administration"

v For UNIX:1. From a command prompt, navigate to the <HTTP_Dir>/bin directory, where

<HTTP_Dir> is the location where the IBM HTTP Server was installed.Default locations for <HTTP_Dir> are as follows:– For AIX, <HTTP_Dir> = /usr/HTTPServer– For Solaris, <HTTP_Dir> = /opt/IBMHTTPD– For Linux, <HTTP_Dir> = /opt/IBMHTTPServer

2. Run the following commands:./apachectl start

./adminctl start

Shutting Down the IBM Tivoli Service Level Advisor SolutionThe following sections describe the shutdown procedures:v “Stopping IBM HTTP Services” on page 108v “Stopping the IBM WebSphere AE 4.0 Admin Server” on page 108v “Stopping IBM WebSphere Application Server for WebSphere AES” on page 108


v “Shutting Down the IBM Console” on page 109v “Shutting Down the SLM Server” on page 109v “Stopping Web Services for IBM Console” on page 109v “Stopping the Server for IBM Console Service” on page 110

Stopping IBM HTTP ServicesStop the IBM HTTP Server and IBM HTTP Administration services by doing thefollowing:v For Windows, you can stop these from the Services control panel or by issuing

the following commands from a command prompt:net stop "ibm http server"

net stop "ibm http administration"

v For UNIX:1. From a command prompt, navigate to the <HTTP_Dir>/bin directory, where

<HTTP_Dir> is the location where the IBM HTTP Server was installed.Default locations for <HTTP_Dir> are as follows:– For AIX, <HTTP_Dir> = /usr/HTTPServer– For Solaris, <HTTP_Dir> = /opt/IBMHTTPD– For Linux, <HTTP_Dir> = /opt/IBMHTTPServer

2. Run the following commands:./apachectl stop

./adminctl stop

Stopping the IBM WebSphere AE 4.0 Admin ServerStop the IBM WebSphere Admin Server for WebSphere AE 4.0 by doing thefollowing:v For Windows, do either of the following:

– Stop the WebSphere Admin Server from the Services control panel– Issue the following command from a command prompt:

net stop "ibm ws adminserver 4.0"

v For UNIX, stop the Admin Server using the Administrator’s Console as follows:1. Start the Administrator’s Console (see “Starting the WebSphere Admin

Console” on page 107).2. Select Websphere Administrative Domain –> Nodes –> <your_host_name>,

then right-click and select Stop from the context menu.3. Click OK on the confirmation message.

Stopping IBM WebSphere Application Server for WebSphereAES

Stop IBM WebSphere Application Server for WebSphere AES by doing either of thefollowing:v For Windows, from a command prompt, navigate to the <WebSphere_Dir>\bin

directory, where <WebSphere_Dir> is the directory where WebSphere AES wasinstalled, such as C:\WebSphere\Appserver, and run the following command:stopServer.bat

v For UNIX, from a command prompt, navigate to the <WebSphere_Dir>/bindirectory, where <WebSphere_Dir> is the directory where WebSphere AES wasinstalled, such as /usr/WebSphere/Appserver, and run the following command:


./stopServer.sh

Additional methods of stopping the IBM WebSphere Application Server aredocumented in the WebSphere AES documentation:v Stopping from the First Steps dialog, which is displayed at the end of

WebSphere product installationv Stopping from the Servers page of the Administrative Console

v Using the DrAdmin script

Shutting Down the IBM ConsoleClose your Web browser to shut down the IBM Console.

Shutting Down the SLM ServerShut down the SLM Server by doing the following:v For Windows:




2. Stop the SLM Server by doing either of the following:– From the Services administration tool, highlight IBM Tivoli Service Level

Advisor, right-click and select Stop from the context menu box.– At a command prompt, run the following command:

net stop tslm

v For UNIX, navigate to the <SLM_Server_Install_Dir>/bin directory, where<SLM_Server_Install_Dir> is the location where the SLM Server was installed,and run the following script:./slm_service_stop.sh

On all platforms, the standard out and standard error logs for the SLM Server arelocated in the Tivoli Common Directory as tslmout.txt and tslmerr.txt,respectively. On AIX platforms, additional log files, tslmsubsysout.txt andtslmsubsyserr.txt are created in the <SLM_Server_Install_Dir>/log directorywhen the subsystem is started.

Stopping Web Services for IBM ConsoleStop the Web Services for IBM Console service, as follows:v For Windows:




2. Stop the Web Services for IBM Console service by doing either of thefollowing:– From the Services administration tool, highlight Web Services for IBM

Console, right-click and select Stop from the context menu box.– At a command prompt, navigate to the <PS_Dir>\bin\w32-ix86 directory,

where <PS_Dir> is the directory where Tivoli Presentation Services isinstalled, and run the following command:stopwc.bat


v For UNIX, navigate to the <PS_Dir>/bin/generic_unix/ directory, where<PS_Dir> is the directory where Tivoli Presentation Services is installed, and runthe following command:./stopwc.sh

Stopping the Server for IBM Console ServiceStop the Server for IBM Console service, as follows:v For Windows:




2. Stop the Server for IBM Console service by doing either of the following:– From the Services administration tool, highlight Server for IBM Console,

right-click and select Stop from the context menu box.– At a command prompt, navigate to the <PS_Dir>\bin\w32-ix86 directory,

where <PS_Dir> is the directory where Tivoli Presentation Services isinstalled, and run the following command:stopmcr.bat

v For UNIX, from a command prompt, navigate to the <PS_Dir>/bin/generic_unixdirectory, where <PS_Dir> is the directory where Tivoli Presentation Services isinstalled, and running the following command:./stopmcr.sh


Chapter 7. Uninstalling IBM Tivoli Service Level Advisor

The uninstall of IBM Tivoli Service Level Advisor involves the following steps:v Uninstall the SLM Task Drivers, associated graphical user interface (GUI) files

and user assistance files from the IBM Console Server. Note that the SLM TaskDrivers are installed on the same machine as the IBM Console Server, but mightnot be installed on the same system as the SLM Server.

v Uninstall the SLM Reports. If you are running IBM Tivoli Service Level Advisorwith WebSphere AE 4.0, there are additional manual steps you must perform.

v Uninstall the SLM Server

Considerations Before UninstallingAs you prepare to uninstall IBM Tivoli Service Level Advisor, keep in mind thefollowing:v You might have these install options all on the same machine, or on different

machines in your enterprise environment. Be sure to run the specific uninstallprocedures for each install option on the appropriate machines.

v If multiple install options are located in the same directory on the same machine,all install options in that directory will be uninstalled at once.

v If multiple install options are located on the same machine but in differentdirectories (which you can do if you run the installation program twice on thesame machine, specifying a different install directory for each install option),then the uninstall process must be run against each directory in turn where theinstall options are located.

v The uninstall program may not be able to remove all of the files in the IBMTivoli Service Level Advisor install directories. You will have to manually deletethese files, and then delete the directories.

This uninstall procedure might not fully address the following additionalcomponents that make up the overall Tivoli Service Level Management (SLM)solution:v Registration ETL, Process ETL, Tivoli Enterprise Data Warehouse, and source

application ETLsSee the Tivoli Enterprise Data Warehouse documentation for information aboutuninstalling these components.

v IBM WebSphere Application ServerSee the documentation that accompanies your installation of WebSphere forinformation on uninstalling IBM WebSphere Application Server.

v IBM DB2See the documentation that accompanies your installation of DB2 for informationon uninstalling DB2.

Uninstalling the SLM Task DriversTo uninstall the SLM Task Drivers from the IBM Console Server, do the following:1. Verify that the Server for IBM Console service is running. For information on

starting the Server for IBM Console service, see “Starting the Server for IBMConsole Service” on page 103.

111

2. Stop the Web Services for IBM Console service. See “Stopping Web Services forIBM Console” on page 109 for details.

3. From a command prompt, navigate to the directory where IBM Tivoli ServiceLevel Advisor was installed (for example, /usr/TSLA), and issue the followingcommand:v For Windows:

uninstall

v For UNIX:./uninstall.sh

4. Start the Web Services for IBM Console service. See “Starting Web Services forIBM Console” on page 104.

Uninstalling SLM ReportsUninstalling SLM Reports includes performing two steps:v Removing SLM Reports from the WebSphere environment.v Removing the installed files from your system

Removing SLM Reports from the WebSphere EnvironmentThis is the reverse activity of integrating SLM Reports into WebSphere afterinstallation (see “Integrating SLM Reports into WebSphere” on page 95).

Removing SLM Reports from WebSphere is useful when you are performing arestore of your system (see the Administrator’s Guide for IBM Tivoli Service LevelAdvisor for information on backup and restore procedures), when you do not needto completely uninstall SLM Reports, but need to re-integrate into WebSphere.

To ONLY remove SLM Reports from the WebSphere environment and leave theinstalled files on the system, do the following:v For WebSphere AES:

1. Stop the IBM WebSphere Application Server (see“Stopping IBM WebSphereApplication Server for WebSphere AES” on page 108 for details).

2. Navigate to <WebSphere_Dir>/bin, where <WebSphere_Dir> is the directorywhere WebSphere was installed (such as /usr/WebSphere/AppServer), and runthe following command, where <node> is the WebSphere node name that wasspecified during installation (see “Identifying the WebSphere Node Name”on page 58):

– For Windows:SEAppInstall -uninstall "SLM Report Application Server" -delete true

-nodeName <node>

– For UNIX:./SEAppInstall.sh -uninstall "SLM Report Application Server" -delete true

-nodeName <node>

v For WebSphere AE:1. Start the WebSphere Admin Server (see “Starting the IBM WebSphere AE 4.0

Admin Server” on page 107)2. Open the Administrator’s Console by selecting Start –> Programs –> IBM

WebSphere –> Application Server V4.0 AE –> Administrator’s Console.3. Verify that the application server is not running (a green arrow beside the

Default Server indicates that the server is running)


4. Highlight the name of the SLM Reports application server (this is the namespecified when SLM Reports was integrated into WebSphere. See step 5e onpage 96), then right-click and select Remove from the context menu.

Completely Uninstalling SLM ReportsTo completely uninstall SLM Reports, including removing from the WebSphereenvironment AND removing installed files from the system, do the following:1. For WebSphere AE, complete the above steps to remove SLM Reports from the

WebSphere environment (this is done automatically for WebSphere AES)2. Navigate to the directory where IBM Tivoli Service Level Advisor was installed

(for example, /usr/TSLA)3. Issue the following script:

v For Windows:uninstall


Uninstalling the SLM ServerTo uninstall the SLM Server, do the following:1. Shut down the SLM Server (see “Shutting Down the SLM Server” on page 109)2. From a command prompt, navigate to the directory where IBM Tivoli Service

Level Advisor was installed (for example, /usr/TSLA), and issue the followingcommand:v For Windows:

uninstall


3. After the uninstall script has completed, reboot your Windows machine to fullyremove IBM Tivoli Service Level Advisor from the list of system services and toremove files that may have been in use during the uninstall.

Uninstalling WebSphere AES 4.0.1To uninstall WebSphere Application Server, stop all WebSphere processes, thenexecute the uninstall script located in the root directory of the WebSphereinstallation, where <WebSphere_Dir> is the location where WebSphere is installed,such as C:\WebSphere\AppServer, as follows:v For Windows:

cd <WebSphere_Dir>

uninstWAS40.exe

v For UNIX and Linux:cd <WebSphere_Dir>

./uninstall.sh

Note: Uninstalling WebSphere Application Server does not uninstall any of theother components (Web server, database server, and database client). Thesemust be uninstalled separately.

Chapter 7. Uninstalling IBM Tivoli Service Level Advisor 113

Uninstalling SLM DatabasesTo uninstall the SLM Database and the SLM Measurement Data Mart used by IBMTivoli Service Level Advisor, you need to drop the DB2 databases, and remove therelated ODBC datasources.

Dropping the DatabasesTo drop the DYK_CAT and DYK_DM databases, do the following1. Start up a DB2 command line processor (CLP) window by doing the following:

v For Windows, select Start –> Run and enter the following command:db2cmd

v For UNIX, log in as the DB2 instance owner, navigate to the<db2_instance_dir>/sqllib directory, where <db2_instance_dir> is the DB2instance directory, and run one of the following scripts:– For bash, Bourne, or Korn shells:

. db2profile

– For C shell:source db2cshrc

2. List the database directories by issuing the following command:db2 list database directory

You should see entries for DYK_CAT and DYK_DM databases (unless you hadselected different names for these databases at creation time).

3. Issue the following commands to disconnect all applications using the databaseinstance:db2stop force

db2start

4. Issue the following commands to drop the databases:db2 drop database dyk_cat

db2 drop database dyk_dm

5. If any of the databases fail to drop successfully, you may need to uncatalogthem as well by issuing the command:db2 uncatalog database <name>

Removing ODBC DatasourcesTo remove ODBC datasources related to the DYK_CAT and DYK_DM databases,do the following:1. Select Start –> Settings –> Control Panel and then:

v For Windows NT, select Data Sources (ODBC)

v For Windows 2000, select Administrative Tools –> Data Sources (ODBC)

2. Select the System DSN tab.3. Highlight the DYK_CAT entry in the System Data Sources table and click

Remove.4. Highlight the DYK_DM entry in the System Data Sources table and click

Remove.


Uninstalling the Registration and Process ETLsThere is a detailed procedure for uninstalling warehouse packs from TivoliEnterprise Data Warehouse in ″Uninstalling warehouse packs″ in Installing andConfiguring Tivoli Enterprise Data Warehouse. You should review that procedure asneeded, but in summary, you should be able to uninstall the Registration andProcess ETLs by doing the following:1. Navigate to <TEDW_Dir>/install/bin, where <TEDW_Dir> is the install location

for Tivoli Enterprise Data Warehouse, and use Wordpad or another text editorto edit the twh_app_deinstall.cfg file.

2. Change the following lines in the file:v APPLICATION_TO_DELETE=DYK

v DB2PASS=<db2_password>

v COPT_CTRL_DB2PASS=<db2_password>

v COPT_CDW_DB2PASS=<db2_password>

v COPT_MART_DB2PASS=<db2_password>

Note: The <db2_password> values entered must be applicable to the local DB2administrator for the systems on which the control server, data martserver, and central data warehouse server are located.

3. Save your changes to this file.4. Open a command prompt and navigate to <TEDW_Dir>/install/bin

5. Enter bash to launch a bash shell.6. Run the following command on the control server machine:

./twh_app_deinstall.sh -c "twh_app_deinstall.cfg"

7. Enter exit to leave the bash shell.

Uninstalling Language SupportBefore running the uninstall script, verify that the variable SLM_BASEDIR (whichdefines the location where IBM Tivoli Service Level Advisor was installed, forexample, C:\TSLA) has been set correctly in the script. The uninstall script will usethe JRE provided with the base product by default. Any other JRE like the one thatcomes with the language support CD can be used.

After the language support has been installed, the following uninstall script will becreated in the top directory where the language support was installed:v For Windows:

LPuninstall.bat

v For UNIX:LPuninstall.sh

This script will launch the LPuninstall.jar located in the _uninstlp subdirectory.

Similar to the installation process, the uninstall process creates a main logfile,traceTSLA1.2LPUninstall.log in the Tivoli Common Directory, under/DYK/logs/LP/uninstall. A master copy of this log file also exists in thetemporary directory space for the current user. Other uninstall logs are also createdin this location in the Tivoli Common Directory.

Chapter 7. Uninstalling IBM Tivoli Service Level Advisor 115

Chapter 8. Troubleshooting

This chapter provides some hints or tips on troubleshooting problems you mayencounter during installation and configuration of IBM Tivoli Service LevelAdvisor. Key areas of troubleshooting include the following:v “Installing DB2”v “Updating the JDBC Level” on page 118v “Creating SLM Databases” on page 119v “Installing IBM Tivoli Service Level Advisor” on page 120v “Installing SLM Task Drivers” on page 122v “Installing SLM Reports” on page 123v “Installing and Configuring the Registration and Process ETLs” on page 123v “System Startup” on page 124v “Accessing SLM Reports” on page 126v “Uninstalling IBM Tivoli Service Level Advisor” on page 128

Installing DB2This section includes troubleshooting problems that you may encounter related toinstalling and configuring IBM DB2 Universal Enterprise Edition Server on themachine where you locate the Tivoli Enterprise Data Warehouse database, orrelated to installing and configuring the DB2 client on one or more machinescontaining components of IBM Tivoli Service Level Advisor (SLM Server, SLM TaskDrivers, SLM Reports, or the SLM Databases). For more detailed installationtroubleshooting information, refer to IBM DB2 Universal Database Message Reference,Volume 1, Chapter 6, ″DBI Messages.″

Instance Creation Failed During UNIX DB2 InstallationIf you receive the message that the DB2 instance creation failed during installation,you can create the instance manually after the installation is complete. To create aninstance manually, do the following:1. Ensure that the database administrator account was created and that it belongs

to the proper group.2. Navigate to following directory, depending on your operating system platform:

v For AIX, /usr/lpp/db2_07_01/instancev For Solaris: /opt/IBMdb2/V7.1/instancev For Linux: /usr/IBMdb2/V7.1/instance

3. Run the following command, where <db2admin_name> is the name of thedatabase administrator account, and <new_instance_name> is the name of thenew instance, which should be identical to the <db2admin_name> parameter:db2icrt -a <SERVER | CLIENT> -u <db2admin_name> <new_instance_name>

For further information, consult IBM DB2 Universal Database Command Reference,Version 7.

117

Updating the JDBC LevelDuring installation of IBM Tivoli Service Level Advisor, the JDBC level isautomatically upgraded to the required 2.0 level. You may need to verify thecurrent level of JDBC to ensure that you are running with JDBC level 2.0, and ifnot set, you need to upgrade this manually. See “Step 8. Update the JDBC Levelfor DB2” on page 37.

Configuring ODBC Data SourcesThis section includes steps to verify ODBC data source creation as well astroubleshooting problems that you may encounter related to configuring ODBCdata sources. Configuring ODBC data sources is a manual step that is performedas a prerequisite to installing IBM Tivoli Service Level Advisor. See “ConfiguringODBC Data Sources” on page 64 for more information.

Verifying Successful ODBC Data Source CreationTo verify creation of ODBC Data Sources for IBM Tivoli Service Level Advisordatabases, from a DB2 command line, issue the following command:db2 list system odbc data sources

The output of the above command should list the ODBC data sources DYK_CATand DYK_DM. If either is missing, run the SLM ODBC data source creation scriptsas described in the section “Configuring ODBC Data Sources” on page 64, or createthe data sources manually as described in Appendix D, “Manually Creating ODBCData Sources” on page 163.

To verify that the ODBC data sources are created correctly, issue the followingcommands from a DB2 command line, where <datasource_name> is DYK_CAT orDYK_DM, <userid> is a valid DB2 user name and <password> is a valid passwordfor the specified user name:db2 connect to <datasource_name> user <userid> using <password>

If you receive errors when connecting to the ODBC Data Source (such as aSQL30081N DB2 error), verify each of the following:v The port number or service name of the remote database node must be the

correct port number on the database server as well as on the machine creatingthe ODBC Data Source. The SLM ODBC creation scripts have a default portvalue of 50000. If this port number is not correct for your system, you will notbe able to connect to the ODBC data source. Refer to “Configuring ODBC DataSources” on page 64 for information about changing this parameter within theODBC creation script. To configure this value manually, refer to Appendix D,“Manually Creating ODBC Data Sources” on page 163.

v The remote host name is a valid remote system and can be reached by thesystem containing the ODBC data source. To verify that the remote host can bereached, issue the following command, where <remote_host_name> is the hostname used when creating the ODBC data source:ping <remote_host_name>

To reconfigure the host used by the ODBC data source, issue the followingcommands from a DB2 command line:db2 uncatalog node <ODBC_node>

db2 uncatalog db <database_name>

db2 uncatalog system odbc data source <datasource_name>


db2 terminate

Rerun the SLM ODBC creation scripts as described in “Configuring ODBC DataSources” on page 64, or to configure the ODBC data source manually, refer toAppendix D, “Manually Creating ODBC Data Sources” on page 163

Note: The above tips assume you did not modify the ODBC node names in theSLM ODBC creation scripts or the database names in the SLM ODBCcreation scripts or the SLM database creation scripts.

Creating SLM DatabasesThis section includes troubleshooting problems that you may encounter related tocreating the SLM Database and the SLM Measurement Data Mart for use by IBMTivoli Service Level Advisor. In the event that the creation of the SLM Database orthe SLM Measurement Data Mart fails, check the log files that were generatedduring the database installation (see “Checking Database Creation Logs andTables” on page 64 for more details on these logs). These logs will contain specificDB2 messages that will indicate the exact nature of the database creation error.

Note: The database creation logs write over any existing log information ratherthan append to existing log information.

Database Creation Scripts FailIf, for some reason, the database creation scripts (dyk_cat_dbinst.bat ordyk_dm_dbinst.bat) fail to complete successfully, the database creation log filesdyk_cat.log or dyk_dm.log might contain errors indicating that the database couldnot be created.

The following errors can occur during database creation:v SQL1005N: The database alias <dbname> already exists in either the local

database directory or system database directory.Before you attempt to re-run the database creation scripts, do the following:1. Initiate a DB2 command session and run the following command to view all

catalogued databases:db2 list db directory

2. Verify that dyk_cat and dyk_dm are included in the listing. For each of theabove databases that do not appear in the listing, do the following:

Note: The above statement assumes the databases scripts have not beenchanged and that the default database names were used.

a. Run the following command, where <missing_db> is the missing databasename and <any_db> is a dummy catalog entry:db2 catalog db <missing_db> as <any_db>

b. Run the following command to see your new catalog entry <any_db>:db2 list db directory

c. Run the following command to drop the database:db2 drop db <any_db>

d. If the db2 drop command fails, then run the following commands:db2 uncatalog db <any_db>

db2 terminate

3. Rerun the database creation script.

Chapter 8. Troubleshooting 119

v SQL1032N: No start database manager command was issued. SQLSTATE=57019This error usually indicates that the database manager is currently stopped. Starta DB2 command line and issue the following command:db2start

Note: If the database creation script failed and the creation log contains theabove message, you must allow the database creation script to drop thedatabase before recreating it again. The script default is set to drop thedatabase before creation.

v SQL1403N: The username and/or password supplied is incorrect.SQLSTATE=08004This error indicates that either the username or the password used in thedatabase creation was incorrect, or the username is not an authorized user onthis system. Check with your database administrator for the properauthorization and group membership.

Database Uncataloged after Error Specifying a Local Databaseas Remote

While installing IBM Tivoli Service Level Advisor, the wizard prompts you forinformation about the SLM Database and the SLM Measurement Data Mart, andthe wizard then attempts to access the database to verify the connection. If youspecify the database as remote when it is actually local, the connection attempt willfail, and the IBM Tivoli Service Level Advisor install program will uncatalog thedatabase. If you restart the install wizard before manually recataloging thedatabase, you will continue to fail the database connection. Before restarting theinstall program, manually catalog the database.

Installing IBM Tivoli Service Level AdvisorThis section includes troubleshooting problems that you may encounter related toinstalling any of the install options of IBM Tivoli Service Level Advisor.

Blank Install Window or Incomplete TextDuring the install of IBM Tivoli Service Level Advisor, if you encounter a blankinstall window or a window that contains incomplete text, resize the window. Thiswill cause the window to refresh itself and display all of the text.

Install Screen Fonts Not ReadableIf you are installing on an AIX machine in the DE_DE language, you may find thatthe fonts displayed in the install dialogs are not readable. To change this, do thefollowing:1. Copy the contents of the IBM Tivoli Service Level Advisor product CD to a

temporary directory on your machine.2. Rename the following file:

java/aix4-r1/jre/lib/font.properties.UTF8

to the following:java/aix4-r1/jre/lib/font.properties.UTF8.bak

3. Run the installation from the temporary directory on your machine.


Cleaning up Temporary ISMP DirectoriesAfter installing IBM Tivoli Service Level Advisor, you may find one or moredirectories under your temporary directory (/tmp on UNIX, or %TEMP% onWindows), with a name prefix of ismp* (such as ismp001, ismp002, ismp003,...depending on how many times you perform an installation). After the installationcompletes, you can manually remove these directories to conserve space on yoursystem.

Receive DYKIN0005E Error Connecting to SLM DatabasesDuring the installation of IBM Tivoli Service Level Advisor, the install wizardprompts you for connection information on the SLM Database and SLMMeasurement Data Mart (see “Step 9. Specify SLM Database Information” onpage 73), and then attempts to connect to the databases (which should alreadyhave been created prior to starting the install wizard. See “Creating the IBM TivoliService Level Advisor Application Databases” on page 60).

If the attempt to connect to the databases fails, the following error message isreceived:DYKIN0005E Unable to make connection with the specified database. Verify that

the SLM Database and the SLM Measurement Datamart have been correctly created

and restart this installation program.

In addition to databases that might not have been created successfully, additionalpossible causes of this problem may include the following:v Any error in the input data to the install wizard, such as an incorrect server

name, DB2 password, or port numberv The DB2 server itself might be down at the time the install wizard attempts the

connection.v There is no connectivity with the database server

You may need to investigate each of these areas for the cause of the failure, andthen restart the installation wizard again.

DYKIN0028E Error Received at End of Install WizardIf you are installing IBM Tivoli Service Level Advisor on a machine where thereport interface of Tivoli Enterprise Data Warehouse and Tivoli PresentationServices has been previously uninstalled and reinstalled again, you might receivethe following error message at the end of the install process for IBM Tivoli ServiceLevel Advisor:DYKIN0028E Install Failed! The IBM Tivoli Service Level Advisor 1.2 option

encountered errors during installation. Run the uninstall program to remove the

failed installation of IBM Tivoli Service Level Advisor 1.2. The log file wcmderr2

is printed below:

The only message in the wcmderr2.log file is the following:FWP4100E The command line bundle for pspersist is not found.

This error can occur if, during the previous uninstall of Tivoli Enterprise DataWarehouse, Tivoli Presentation Services was not completely uninstalled as well.Whenever you uninstall Tivoli Enterprise Data Warehouse, you must alsocompletely uninstall Tivoli Presentation Services manually before reinstalling TivoliEnterprise Data Warehouse.


To recover from this problem, you must do the following:v Uninstall IBM Tivoli Service Level Advisorv Uninstall Tivoli Enterprise Data Warehousev Uninstall Tivoli Presentation Servicesv Reinstall Tivoli Enterprise Data Warehousev Reinstall IBM Tivoli Service Level Advisor

Consult the installation documentation for Tivoli Enterprise Data Warehouse fordetails on completely uninstalling Tivoli Presentation Services before attempting toreinstall Tivoli Enterprise Data Warehouse.

Service Exception in Install LogDuring the installationof IBM Tivoli Service Level Advisor, the wizard detects if theTivoli Common Directory has already been created on this machine. If it has notalready been created, the wizard creates the directory, and also attempts to createthe tivoli user group, to which user names are added for access to the log files.

If the tivoli group has already been created, however, the following exception willbe written to the install log:ServiceException: (error code = -110001; message = "The specified local

group already exists.

This exception is not harmful and can be ignored.

Installing SLM Task DriversThis section includes troubleshooting problems that you may encounter related toinstalling the SLM Task Drivers option of IBM Tivoli Service Level Advisor andintegrating into the IBM Console.

Problem Starting IBM Console After InstallIf you install the SLM Task Drivers option of IBM Tivoli Service Level Advisor andreceive the following message at the end of the install wizard, there may be aproblem with the operation of the IBM Console:FWP4171E Startup failed for the Tivoli Presentation Services object request broker

(ORB), com.tivoli.pf.cli.CliOrbletApp.

To recover from this error, do the following:1. Click Cancel to cancel the current installation.2. Remove any files that were left over in the IBM Tivoli Service Level Advisor

install directory after the canceled install was rolled back.3. Verify that the Server for IBM Console service is started, and restart it if

necessary (see “Starting the Server for IBM Console Service” on page 103) forprocedures.

4. Attempt to install the SLM Task Drivers again, following the procedure inChapter 4, “Installing IBM Tivoli Service Level Advisor” on page 59

The above error message is located in the wcmderr log file.


Installing SLM ReportsThis section includes troubleshooting problems that you may encounter related toinstalling the SLM Reports option of IBM Tivoli Service Level Advisor.

SLM Reports with IIS ServiceIf you are planning to install SLM Reports on a Windows platform which has theIIS service installed, disable this service before installing WebSphere. This enablesthe IBM HTTP Server installed by WebSphere to use port 80, and SLM reports canthen be viewed using this port as well.

Cleaning Up After Failed SLM Reports InstallationIf you are using WebSphere AES and the installation of the SLM Reports fails, youmust manually remove the <WebSphere_Dir>/installedApps/SLMReport.ear folder,where <WebSphere_Dir> is the directory where WebSphere was installed (such as/usr/WebSphere/AppServer), by navigating to <WebSphere_Dir>/bin and runningthe following command at a command prompt:v For Windows:

SEAppInstall -uninstall "SLM Report Application Server" -delete true

v For UNIX:./SEAppInstall.sh -uninstall "SLM Report Application Server" -delete true

Installing and Configuring the Registration and Process ETLsThis section includes troubleshooting problems that you may encounter related toinstalling and configuring the Registration and Process ETLs.

Logging in to the Data Warehouse CenterIf you launch the DB2 Data Warehouse Center (from the DB2 Control Center, selectTools –> Data Warehouse Center) but you are unable to log in to the DataWarehouse Center, restart the following two Tivoli Warehouse services from theServices control panel:v Warehouse Loggerv Warehouse Server

This enables the services to reconnect to the TWH_MD database which would havebeen disconnected if the Tivoli Enterprise Data Warehouse database server isstopped by the dyk_cat_dbinst or dyk_dm_dbinst scripts.

Installation of SLM ETLs FailsIf the installation of the SLM Registration and Process ETLs fails, the TivoliEnterprise Data Warehouse installation program might display the following errormessage:CDWIA0002W General errors were detected. Review the installation logs

to ensure that messages indicate conditions that are acceptable.

If this message occurs, examine the following log files, where <%TEMP%> is thevalue of the TEMP environment variable on the Windows platform where theControl Server was installed:v <%TEMP%>\tmptedw_1_1_install\TWHInstall.log files

The TWHInstall.log contains the following error message:


CDWIA0092E Cannot import the metadata into the DB2 Data Warehouse Center

using the .tag file.v <%TEMP%>\dyk_dwc_data.log

The dyk_dwc_data.log contains text at the very bottom of the file similar to thefollowing:*******************************************

Import ended for tag file:C:/TWH/apps/dyk/v110/etl/dyk_dwc_data.tag

Return Code/subCode = 13702/0

Method:DataResource_addRel

Message:DWC13702E A primary key already exists and cannot be updated.

The import process cannot continue.

Chkpid completed = 920

Stop time: 03/01/02 15:56:09

*******************************************

This occurs when DB2 7.2 Fix Pack 6 has not been installed prior to installingTivoli Enterprise Data Warehouse. This fix pack is required for importing ETLs.

Refer to the installation procedures in this document for information on installingDB2 7.2 with Fix Pack 6. After installing DB2 Fix Pack 6 successfully to themachine where the Control Server is located, retry the warehouse enablement packinstallation.

Related Documentation: For more information regarding the installation of Tivoliwarehouse enablement packs, see Installing and Configuring Tivoli Enterprise DataWarehouse on the Tivoli Enterprise Data Warehouse publication CD.

System StartupThis section includes troubleshooting problems that you may encounter related tostarting up the services and components of the SLM solution.

Server Host Name is Not Fully QualifiedIf you receive either of the following messages, you may need to change yoursystem configuration to return fully qualified host names:v As a result of invoking an scmd command:

DYKAL2030E Unable to connect to the Command Line Interface service on port 9990.

v You find the following messages in the msgTSLAn.log:DYKAL0009E The server host name <host name> is not a fully qualified host name.

DYKAL1020I Component startup activities have completed:0 started,

0 timed out, 0 failed.

These errors can occur if the SLM Server configuration data could not be loadedand required SLM Server services are not started.

This situation occurs if the machine that the SLM Server is installed on is no longerknown by the fully qualified host name. In this condition, the server will notproperly read necessary configuration data that is associated with the fullyqualified host name of the machine, and necessary services will not be started.Machines on which you install the SLM Server, SLM Task Drivers, and SLMReports must be configured so that their host names resolve to fully qualifiednames.


Refer to “Step 3. Ensure fully qualified host names” on page 31 for moreinformation on configuring your machine to return fully qualified host names.

SLM Server Startup Cannot Connect to SLM DatabasesIf the startup of the SLM Server is halted, and you receive the following messagein the msgTSLAn.log, you may be having problems with the SLM Server connectingto the SLM Database or SLM Measurement Data Mart:DYKAL1054E Component yourmachine.some.company.com:DS:1 failed startup with

the following error:DYKAL3002E An error occurred for sdc during

DataSource creation.

This error might also occur if you execute the CLI command scmd list, and onlythe rcc, log, and slm bundles are reported as available.

This error indicates that connection to one or both of the IBM Tivoli Service LevelAdvisor databases is not possible. Examine the related messages in the log todetermine the root cause of the failure. The most common cause of this type ofproblem is the following:v The db2start command has not been issued on the database server. You may see

the following message in the SLM Server stderr or the msgTSLAn.log files on themachine running the SLM Server:DYKAL3014E Error connecting to the database. Reason: [IBM][CLI Driver]

SQL1032N No start database manager command was issued. SQLSTATE=57019

Verify that a db2start has been issued on the database server. See the DB2documentation for more information on starting DB2.

v The jdbc driver cannot be loaded because the db2java.zip file is not on thesystem CLASSPATH. You may see the following message in the SLM Serverstderr or the msgTSLAn.log files on the machine running the SLM Server:DYKAL3013E Error loading driver COM.ibm.db2.jdbc.app.DB2Driver

Verify that the DB2 client or server option is installed on this machine and verifythe following:– If DB2 is installed and this is a Windows machine, run the following

command from a command prompt:set classpath

Examine the output of this command and ensure that the fully qualified pathto the db2java.zip file is correct. If it is not correct then navigate to theWindows environment variable dialog, correct the value, and restart the SLMServer.

– If DB2 is installed and this is a UNIX machine, then view the contents of<TSLA_Dir>/bin/private/generic_unix/runscripts/slmdbsetup.sh, where<TSLA_Dir> is the directory where IBM Tivoli Service Level Advisor wasinstalled, and verify that the paths to the db2profile and usejdbc2 scriptscontained in this file are correct. If they are not correct, edit this file with thecorrect paths and restart the SLM Server.

v Messages in the log indicate that network connectivity to the database server isnot possible. Verify that network connectivity to the database server exists byusing the ping command.

If none of the previous solutions fixes the problem, consult your databaseadministrator to determine the root cause of the database connectivity errors.


Related messages or problems: See “Accessing SLM Reports” for relatedinformation.

Related documentation: See “Creating the Databases” on page 63 for informationon SLM database installation and configuration, and see the Command Reference forIBM Tivoli Service Level Advisor for information on scmd list.

Signing In to the IBM ConsoleWhen logging into the IBM Web Console, you might receive the following error:FWP9102E Cannot load the task driver GUI due to the exception

PortfolioViewerFUGUI

To resolve this problem, restart the Server for IBM Console and Web Services for IBMConsole services (see “Starting the Server for IBM Console Service” on page 103 and“Starting Web Services for IBM Console” on page 104) and log in to the IBMConsole again.

Accessing SLM ReportsThis section addresses problems you might encounter while attempting to accessSLM reports.

HTTP 500 Internal Server Error or DYKAL3003E Error MessageIf, after signing in, you receive an HTTP 500 Internal server error (The page cannotbe displayed), you may be having problems with the SLM Report Serverconnecting to the SLM Database. You might also have this problem if you receivethe following error message:DYKAL3003E A DataSource for sdc was not found in my SLM Reports message log.

To resolve this problem, do the following:1. Search the SLM Reports stderr and msgTSLAn.log files on the machine running

the SLM Reports server for either of the following messages:v DYKAL1054E Component yourmachine.somecompany.com_servlet:DS:1 failed

startup with the following error:

DYKAL3002E An error occurred for sdc during DataSource creation.

This message can occur if the DB2 Server has not been started. Verify thatthe db2start command has been issued on the database server. See the DB2documentation for information on starting DB2.

v DYKAL3013E Error loading driver COM.ibm.db2.jdbc.app.DB2Driver.

This message can occur if the JDBC driver cannot be loaded because thedb2java.zip file is not in the WebSphere Application Server CLASSPATH.See “Configuring the JDBC Driver in WebSphere” on page 56 for moreinformation.

Upon successful recovery from this error you should be able to log onto theSLM reports and see messages similar to the following in your SLM ReportsmsgTSLAn.log:DYKAL3005I Driver loaded successfully.DYKAL3001I DataSource successfully created for sdc.DYKAL1001I Started component yourcomputer.some.company.com_servlet:DS:1.

2. Open the web.xml file, which is located in the following directory, where<app_name> is the name you specified in step 5e on page 96:


<WebSphere_Dir>/AppServer/installedApps/<app_name>.ear/SLMReport.war/Web-inf

Edit this file using your preferred XML or text editor. Verify that the file namesfor tsla.basedir and tsla.programfiles parameters are set correctly, accordingto the procedure outlined in step 6 on page 96 under “Integrating intoWebSphere AE” on page 95.

3. If the web.xml file is correct, examine the following log file for detailed errors:Default_Server_stdout.log

Possible errors include:v Missing tables in the databasev Incorrect user name or password used to connect to the database

If you find error DYKAL3014E, specifying the reason as an incorrect user nameor password, use the dsutil utility to verify that the user ID and password arecorrect. See the Command Reference for IBM Tivoli Service Level Advisor for detailson running the dsutil utility.

Related Messages or Problems: See “Server Host Name is Not Fully Qualified” onpage 124.

Related documentation: See Chapter 5, “Additional Installation Tasks” on page 89for information on integrating and accessing SLM Reports.

Accessing SLM Reports in WebSphere AES 4.0If you are having trouble accessing SLM Reports from your Web browser usingWebSphere AES 4.0, you may have an incorrect node name specified for themachine on which WebSphere is installed. To check for this, open thetraceTSLA1.2Install.log file and look for the following message:CommandExecutionException: Unable to select node: the requested node is not

available.

If this message is found, you should correct the node name by doing the following:1. Locate the script file <SLM_Install_Dir>/bin/aes40reportgenplugin, where

<SLM_Install_Dir> is the directory where IBM Tivoli Service Level Advisor wasinstalled on the SLM Report Server machine.

2. Open this script file in a text editor and locate the NODE_NAME parameter.The value for this parameter should be the node name that you found afterinstalling WebSphere AES (see “Identifying the WebSphere Node Name” onpage 58).

3. Edit this value if needed in the script file, save the file, and execute the script.4. Locate the file <WebSphere_Dir>/config/plugin-cfg.xml, where

<WebSphere_Dir> is the directory in which WebSphere was installed.5. Open this XML file in a text or XML editor and verify that it includes the

following entry:<Uri Name="/SLMReport"/>

6. Save and close this file.7. Stop the WebSphere Application Server and restart it again.

SLM Reports should now be accessible from your supported Web browser.


Uninstalling IBM Tivoli Service Level AdvisorThis section includes troubleshooting problems that you may encounter related touninstalling IBM Tivoli Service Level Advisor.

Uninstalling SLM Install OptionsIf the use of the uninstall script in the procedure outlined in Chapter 7,“Uninstalling IBM Tivoli Service Level Advisor” on page 111 does not work, and ifyou have a Java runtime environment (JRE) installed locally on the machine, tryuninstalling by issuing the following command instead of running the uninstallscript:java -jar _uninst/uninstall.jar


Appendix A. A Two-Machine Installation Example

The following procedure is intended to provide you with a consolidated set ofsteps to perform a sample IBM Tivoli Service Level Advisor solution installationthat can be used as an entry-level production environment. These procedures takeall available defaults.

The deployment consists of two machines available on the network, one containingthe central data warehouse database and associated components, and the othermachine containing IBM Tivoli Service Level Advisor and its associatedcomponents. Figure 39 shows the deployment of the major components of TivoliEnterprise Data Warehouse and IBM Tivoli Service Level Advisor in the twomachines.

Installation AssumptionsThis installation assumes the following:v For purposes of this discussion, these two machines will be referred to as the

Warehouse machine and the SLM machine.v The Warehouse machine is running only on a Windows NT or Windows 2000

platform. The SLM machine is running on either Windows NT, Windows 2000 orUNIX (AIX, Solaris, Linux) platform.

v Both machines have met all operating system configuration requirementsdefined in the Tivoli Enterprise Data Warehouse and IBM Tivoli Service Level

Figure 39. A two-machine deployment for quick installation

129

Advisor documentation (for example, see “Step 3. Ensure fully qualified hostnames” on page 31 for information on configuring your system to return fullyqualified host names)

v You have adequate authority to perform the install (root user authority onUNIX, Admininstrator authority on Windows)

v Any previous installation of Tivoli Enterprise Data Warehouse or IBM TivoliService Level Advisor has been completely removed from these machines, andthat only the operating systems are installed (no DB2 installed, no HTTP Serverinstalled).

v The machines are configured to automatically start from the product CD.v You have available the required installation media for the SLM solution,

including:– IBM DB2 7.2 with Fix Pack 5– IBM DB2 7.2 Fix Pack 6– Tivoli Enterprise Data Warehouse 1.1– Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1– IBM Tivoli Service Level Advisor 1.2– WebSphere 4.0.1 AES

Note: Source application warehouse packs are not included in this list becauseyou will have the option to conclude this quick start procedure and installyour warehouse packs separately if desired, or to use a simulated set ofdata in the warehouse to use in a non-production environment forlearning purposes.

v You have familiarized yourself with the product by reading the overviews andinstallation procedures and completed the planning process suitable for yourentry-level production environment. If you intend to use this installation as aproduction environment, you should read this complete document to ensure thatyou have performed all pertinent configuration steps successfully.

v You have read through this entire appendix before beginning the installation tobe sure you understand all of the steps.

The installation procedure consists of the following major steps, which aredescribed in more detail in the remaining sections of this appendix:1. Complete the planning worksheet for this installation2. Install DB2 server software on the Warehouse machine3. Install Tivoli Enterprise Data Warehouse and the SLM ETLs on the Warehouse

machine4. Create SLM Databases on the Warehouse machine5. Install DB2 client software on the SLM machine6. Install WebSphere on the SLM machine7. Install IBM Tivoli Service Level Advisor SLM Server and SLM Reports on the

SLM machine8. Install IBM Tivoli Service Level Advisor SLM Task Drivers on the Warehouse

machine9. Create ODBC Datasources

10. Configure the IBM Tivoli Service Level Advisor ETLs on the Warehousemachine


Performing the above steps will prepare your two-machine SLM solution forreceiving and processing data from one or more source applications that will writedata into the central data warehouse. You must perform additional steps to installand configure the various source applications and their associated warehousepacks in order to begin putting data into the central data warehouse. You canoptionally install a set of simulated data that may be useful in evaluating yourproduction environment and learning how your SLM solution works. Theseadditional steps are not included in this appendix. See “Warehouse Packs” onpage viii to find information on currently available warehouse packs.

1. Planning for InstallationPlanning worksheets exist for both Tivoli Enterprise Data Warehouse and IBMTivoli Service Level Advisor installation procedures, and should be completedbefore installing these products. For this particular installation, the planninginformation required is a subset of the full planning worksheets. Table 13 specifiesthe planning information you should gather for this installation.

Table 13. Planning sheet for this Quick Start installation

Item to plan for Your response

Fully qualified host name of the Warehousemachine

Fully qualified host name of the SLMmachine

User ID and password for the SLM machine

WebSphere node name (obtained in step 10on page 135)

2. Installing DB2 Universal Enterprise EditionInstall DB2 Universal Enterprise Edition on the Warehouse machine by doing thefollowing:1. Insert the DB2 product CD to start the DB2 install program, and click Install.2. On the DB2 product selection dialog, verify that only DB2 Enterprise Edition is

checked. Click Next to continue.3. Verify that the Typical install option is selected and click Next to continue.4. On the Destination Location dialog, accept the defaults and click Next to

continue.5. On the Control Server dialog, specify the following DB2 user name and

password and click Next to continue (if a message is displayed regardingcreation of the user ID, click Yes to continue):v User name: db2admin


6. On the Current Settings dialog, click Next to perform the installation.7. You will be asked if you need to install the OLAP starter kit. Select No and

then Continue to continue.8. When the installation completes, click Finish and then click Exit.

Appendix A. A Two-Machine Installation Example 131

3. Installing the DB2 ClientInstall the DB2 client software on the SLM machine by doing the following:v For Windows:

1. Insert the DB2 product CD to start the DB2 install program, and click Install.2. On the DB2 product selection dialog, uncheck DB2 Enterprise Edition and

select the DB2 Administration Client install option (this should be the onlyoption checked). Click Next to continue.

3. On the Installation Type and Destination Location dialogs, accept thedefaults and click Next to continue.

4. On the Control Center Server dialog, specify the following DB2 user nameand password and click Next to continue (if a message is displayedregarding creation of the user ID, click Yes to continue):– User name: db2admin

– Password: db2admin

5. On the Current Settings dialog, click Next to perform the installation.6. When the installation completes, click Finish and then click Exit.

v For UNIX:1. Before starting the installation, be sure to check the DB2 ″Quick Beginnings″

document for specific procedures that you need to complete depending onthe UNIX platform on which you are installing DB2.

2. Mount the DB2 CD:– For AIX, issue the following command, where <mount_dir> is the mount

directory:mount -rv cdrfs /dev/cd0 <mount_dir>



3. Change to the mounting directory.4. Run the following command:

./db2setup.sh

5. Using the spacebar, select DB2 Administration Client.6. Using the tab key, navigate to OK and press Enter.7. The Create DB2 Services window is displayed. Select Create DB2 Instance.8. You are prompted to enter the DB2 instance name, its group name, and the

home directory. Do either of the following:– If the db2instance user was not created before this installation, select the

default. Enter the password for both the Password and Verify Passwordfields, then navigate to OK and press Enter.

– If the user name was created before this installation, specify that username as the db2instance user, and specify its group name and homedirectory, but do not specify the password. Navigate to OK and pressEnter.

9. You are returned to the Create DB2 Services window. Navigate to OK andpress Enter.

10. In the DB2 Setup Utility window, select Continue.11. You are given a last chance warning before the installation begins. Navigate

to OK and press Enter. The installation of the DB2 Client is started.


12. The installation is completed, and a successful notice is displayed. Navigateto OK and press Enter.

13. The DB2 Setup Utility window is displayed again. Navigate to OK andpress Enter.

14. Navigate to Close and press Enter. Select OK when asked if you want toexit. This returns you to the command prompt.

15. Unmount the CD as follows:– For AIX, change the directory from the mounted directory and enter

umount <mount_dir>

– For Solaris, change the directory from the mounted directory and entereject cdrom

– For Linux, change the directory from the mounted directory and entereject cdrom

4. Upgrading to DB2 7.2 Fix Pack 6Upgrade your installation of DB2 7.2 to Fix Pack 6 by doing the following for boththe Warehouse and the SLM machine:1. Download DB2 7.2 Fix Pack 6 from the support Web site:

http://www.ibm.com/software/sysmgmt/products/support/


2. Stop all services associated with DB2 by starting a DB2 command prompt andissuing the following commands:db2stop force

db2admin stop


4. Navigate to the directory where you downloaded DB2 Fix Pack 6 and runsetup.exe.

Note: If you receive the following message, click Yes and continue the install:DB2 is currently running and locked by the following process(es):

jservice.exe

5. Follow the instructions in the install program to install the fix pack.

Be sure to perform the above procedure on both the Warehouse machine and theSLM machine.

5. Installing Tivoli Enterprise Data WarehouseOn the Warehouse machine, install Tivoli Enterprise Data Warehouse by doing thefollowing:1. Insert the Tivoli Enterprise Data Warehouse product CD. The installation

program will be automatically started.2. On the Welcome panel, click Next to continue.3. On the Setup Type dialog, verify that the Single machine radio button is

selected, and click Next to continue.4. On the Host Name dialog, verify that the fully qualified host name for the

Warehouse machine is correct, and click Next to continue.5. On the DB2 Configuration dialog, specify the following DB2 user name and

password and click Next to continue:


v User name: db2admin


6. On the Tivoli Presentation Services configuration dialog, click Next tocontinue.

7. On the Additional Languages dialog, click Next to continue.

Note: If additional languages are needed, refer to the Tivoli Enterprise DataWarehouse documentation for information on installing language packs.

8. On the Additional Applications Packages dialog, because we are installingthe IBM Tivoli Service Level Advisor warehouse pack in a separate procedure,verify that the check box is not checked and click Next to continue.


10. After the installation program has copied files and configured theenvironment, the Installation Summary window is displayed. Click Next tocontinue.

11. The installation will proceed. When the wizard completes, do not select theoption to restart the system at this time. Click Next and then click Finish.

12. Wait for the IBM Console to finish rebuilding the online user assistance helpset. You can check for completeness by examining the most recent (highestnumbered n) stdoutn log file in the directory <PS_directory>\log\fwp_mcr,where <PS_directory> is the location where Tivoli Presentation Services wasinstalled. Look for the following message:FWP1734I The utility that was started by the Management Component


13. Reboot the system to complete the installation.

6. Installing Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1IBM Tivoli Service Level Advisor requires Tivoli Enterprise Data Warehouse 1.1with Fix Pack 1 to be installed on the Warehouse machine. Refer to the TivoliEnterprise Data Warehouse Fix Pack 1 Readme and the Tivoli Enterprise DataWarehouse support Web site for fix pack information.

7. Installing WebSphereThis procedure installs WebSphere Advanced Edition Single Server (AES), Version4.0.1, that is shipped with IBM Tivoli Service Level Advisor. If you have anotherversion of WebSphere, consult the accompanying WebSphere documentation foradditional install information.

To install Websphere AES 4.0.1 on the SLM machine, do the following:v For Windows:

1. Insert the Windows version of the WebSphere AES 4.0.1 product CD and runthe setup.exe program.

2. On the Language dialog, select the language desired and click OK tocontinue.

3. On both the Welcome and Installation Options dialogs, click Next tocontinue.

4. On the Security Options panel, enter a valid user ID and password for thismachine and click Next to continue.


5. On the dialogs for Product Directory, Program Folder, and Install Options,click Next to perform the installation.

6. After the installation completes, reboot the machine and select Start theApplication Server.

7. You might want to configure WebSphere to autostart when the system isrestarted. See “Automatically Starting WebSphere After System Restart” onpage 57 for the procedure.

8. Configure the JDBC Driver in WebSphere (see “Configuring the JDBC Driverin WebSphere” on page 56 for the procedure).

9. If you are installing WebSphere AES 4.0.1 in a non-English environment, youmust upgrade to at least WebSphere AES 4.0.2. See “Upgrading fromWebSphere AES 4.0.1” on page 56 for details.

10. Obtain the WebSphere node name (see “Identifying the WebSphere NodeName” on page 58) and record it in the planning worksheet in Table 13 onpage 131 for later use (step 8 on page 138). You might be able to obtain thenode name quickly by doing the following:a. Open a Web browser and point to http://<host name>:9090/admin,

where <host name> is the host name of your local machine (the SLMmachine)

b. The WebSphere Application Server Login window is displayed. Enterany name in the user ID field, or leave it blank, and click Submit.

c. The WebSphere Administrative Console is displayed. In the left pane,click the plus sign next to Nodes. The WebSphere node name will bedisplayed under Nodes. Write it down for later use.

v For UNIX:1. Mount the UNIX version of the WebSphere AES 4.0.1 CD:

– For AIX, issue the following command, where <mount_dir> is the mountdirectory:mount -rv cdrfs /dev/cd0 <mount_dir>



2. Change to the mounted directory <mount_dir>/<os version>, where<osversion> is aix for AIX, sun for Solaris, and linux for Linux.


4. The Welcome banner is displayed. Click Next to display a window withWebsphere AES operating system prerequisites. If everything is satisfactory,click OK to continue, or update the operating system with the requiredfixes by downloading them from the corresponding operating systemsupport Web site.



7. The Install Options window is displayed, listing the components to beinstalled. Click Install, which starts the installation. At the end, click Finishto complete the installation.

8. Unmount the CD as follows:


– For AIX, change the directory from the mounted directory and enterumount <mount_dir>





10. Completion of the installation launches the First Steps html page ifNetscape is installed. You can use this html page to start and stop theWebsphere Application Server, or see Chapter 6, “Startup and ShutdownProcedures” on page 103 for the procedures to start and stop the WebsphereApplication Server and the HTTP Server.

Configuring the JDBC Driver for WebSphereAfter the Websphere and HTTP Server are started, configure the JDBC Driver forWebSphere by doing the following:1. Open your Web browser and point to the following Web site:

http://<host name>:9090/admin

2. Sign on using admin as the user ID.3. The Administrative Console is displayed. Expand Resources in the navigation

tree in the left pane.4. Expand JDBC Drivers and select DB2Jdbc Driver.5. In the Server Class Path field, enter the path and file name of the location of

the DB2 driver, similar to the following example, where<db2_client_install_directory> is the location where the DB2 client is installed,and then click OK:<db2_client_install_directory>\java12\db2java.zip

Note: If you installed DB2 using the defaults, <db2_client_install_directory>should be entered as C:\Program Files\sqllib.

6. A hotspot, Configuration needs to be saved, is displayed. Click this hotspot tosave the configuration, then log off using Exit.

7. Stop the WebSphere Application Server and restart it using the proceduresdefined in Chapter 6, “Startup and Shutdown Procedures” on page 103.

8. Creating Databases for IBM Tivoli Service Level AdvisorThis installation procedure creates the two databases used by IBM Tivoli ServiceLevel Advisor, the SLM Database and the SLM Measurement Data Mart. In thisinstallation, these databases are created on the Warehouse machine in the sameDB2 instance as the Tivoli Enterprise Data Warehouse database.

Note: The installation of Tivoli Enterprise Data Warehouse must be completedbefore beginning this installation procedure.

To create these two databases on the Warehouse machine, do the following:


1. Insert the IBM Tivoli Service Level Advisor product CD in the Warehousemachine.

2. At a command prompt, run the following command to start a DB2 commandprompt session:db2cmd

3. On the IBM Tivoli Service Level Advisor product CD, navigate to thedatabase\scripts\w32-ix86 directory.

4. In the DB2 command prompt session, run the following command to create theSLM Database:dyk_cat_dbinst.bat db2admin db2admin

5. In the DB2 command prompt session, run the following command to create theSLM Measurement Data Mart:dyk_dm_dbinst.bat db2admin db2admin

9. Configuring ODBC Data SourcesTo configure ODBC data sources on the Warehouse machine, do the following:1. Insert the IBM Tivoli Service Level Advisor product CD in the CD-ROM drive

of the Warehouse machine.2. Select Start –>Run and run the db2cmd command to initialize a DB2 command

session. A window titled DB2 CLP will be started. Steps 3-4 should be executedin that window.

3. To create the ODBC datasource named DYK_CAT for the SLM Database,navigate to the <CD-ROM>\database\scripts\w32-ix86\ directory, where<CD-ROM> is the CD-ROM drive letter, and run the following command,where <Warehouse_hostname> is the fully qualified host name of the Warehousemachine (see your planning information in Table 13 on page 131):dyk_cat_odbc.bat <Warehouse_hostname>

4. Similarly, to create the ODBC datasource named DYK_DM for the SLMMeasurement Data Mart, run the following command:dyk_dm_odbc.bat <Warehouse_hostname>

10. Installing the SLM Server and SLM ReportsInstall the SLM Server and SLM Reports options of IBM Tivoli Service LevelAdvisor on the SLM machine by doing the following:v For Windows:

1. Insert the IBM Tivoli Service Level Advisor product CD.2. From the IBM Tivoli Service Level Advisor product CD, run install.bat.3. On the Welcome dialog, Next to continue.4. On the License Agreement dialog, select the I accept the terms in the

license agreement radio button and click Next to continue.5. On the Directory dialogs, accept the default locations for the Tivoli

Common Directory and the location where IBM Tivoli Service LevelAdvisor will be installed, and click Next to continue.

6. On the Product Installation Options dialog, deselect the SLM Task Driverscheck box, leaving the other install options checked. Click Next to continue.

7. On the WebSphere Directory dialog, accept the default location for theWebSphere Application Server, and click Next to continue.


8. On the WebSphere Node Name dialog, enter the WebSphere node name(see your planning sheet, in Table 13 on page 131 above). Click Next tocontinue.

Note: This node name is case-sensitive and must be entered exactly asfound.

9. On the SLM Database dialog, select the Remote radio button (because thedatabase is created on the Warehouse machine), and click Next to continue.

10. On the next dialog, accept the defaults that are presented in the fields, butin the Password field, enter the DB2 password db2admin, and in theDatabase Server Host Name field, enter the fully qualified host name of theWarehouse machine, which is where the SLM Database was created. ClickNext to continue.

11. On the SLM Measurement Data Mart dialog, select the Remote radiobutton (because the database is created on the Warehouse machine), andclick Next to continue.

12. On the next dialog, accept the defaults that are presented in the fields, butin the Password field, enter the DB2 password db2admin, and in theDatabase Server Host Name field, enter the fully qualified host name of theWarehouse machine, which is where the SLM Measurement Data Mart wascreated. Click Next to continue.

13. On the SLM Server port dialog, accept the defaults and click Next tocontinue. Do not enable password protection.

14. On the SLA Notification Selection dialog, if you need to set up SLAnotification, see “Step 12. Specify Event Notification Methods” on page 78,otherwise click Next to continue.

15. On the feature summary dialog, click Next to proceed with the installation.16. After the installation and configuration is complete, click Finish.17. Stop the WebSphere Application Server and restart it using the procedures

defined in Chapter 6, “Startup and Shutdown Procedures” on page 103.v For UNIX:

1. Mount the IBM Tivoli Service Level Advisor product CD:– For AIX, issue the following command, where <mount_dir> is the mount





3. On the Welcome dialog, Next to continue.4. On the License Agreement dialog, select the I accept the terms in the

license agreement radio button and click Next to continue.5. On the Directory dialogs, accept the default locations for the Tivoli

Common Directory and the location where IBM Tivoli Service LevelAdvisor will be installed, and click Next to continue.


7. On the WebSphere Directory dialog, click Next to continue.


8. On the WebSphere Node Name dialog, enter the WebSphere node name(see your planning sheet, in Table 13 on page 131 above). Click Next tocontinue.

9. On the SLM Database dialog, select the Remote radio button (because thedatabase is created on the Warehouse machine), and click Next to continue.

10. On the next dialog, accept the defaults that are presented in the fields, butin the Password field, enter the DB2 password db2admin, and in theDatabase Server Host Name field, enter the fully qualified host name of theWarehouse machine, which is where the SLM Database was created. ClickNext to continue.

11. On the SLM Measurement Data Mart dialog, select the Remote radiobutton (because the database is created on the Warehouse machine), andclick Next to continue.

12. On the next dialog, accept the defaults that are presented in the fields, butin the Password field, enter the DB2 password db2admin, and in theDatabase Server Host Name field, enter the fully qualified host name of theWarehouse machine, which is where the SLM Measurement Data Mart wascreated. Click Next to continue.

13. On the DB2 Instance directory dialog, enter the home directory of the DB2instance of the SLM databases on the local machine. If you installed DB2using the default db2admin user name, specify the home directory as/home/db2admin.

14. On the SLM Server port dialog, click Next to continue.15. On the SLA Notification Selection dialog, if you need to set up SLA

notification, see “Step 12. Specify Event Notification Methods” on page 78,otherwise click Next to continue.

16. On the feature summary dialog, click Next to proceed with the installation.17. After the installation and configuration is complete, click Finish.18. Unmount the CD as follows:

– For AIX, change the directory from the mounted directory and enterumount <mount_dir>




11. Installing SLM Task DriversOn the Warehouse machine, install the SLM Task Drivers by doing the following:1. Insert the IBM Tivoli Service Level Advisor product CD and run install.bat.2. On the Welcome dialog, Next to continue.3. On the License Agreement dialog, select the I accept the terms in the license

agreement radio button and click Next to continue.4. On the Directory dialogs, accept the default locations for the Tivoli Common

Directory and the location where IBM Tivoli Service Level Advisor SLM TaskDrivers will be installed, and click Next to continue.

5. On the Product Installation options dialog deselect the SLM Server and SLMReports check boxes, and verify that the IBM Tivoli Service Level Advisorand SLM Task Drivers check boxes are checked. Click Next to continue.


6. On the SLM Database dialog, select the Local radio button, and click Next tocontinue.

7. On the next dialog, accept the defaults that are presented in the fields, but inthe Password field, enter the DB2 password db2admin. Click Next to continue.

8. On the SLM Server Host Name dialog enter the fully qualified host name ofthe SLM machine, and click Next to continue.

9. On the feature summary dialog, click Next to perform the installation.10. After the files have been copied, click Next to restart Tivoli Presentation

Services.11. Wait for the IBM Console to finish rebuilding the online user assistance help

set. You can check for completeness by examining the most recent (highestnumbered n) stdoutn log file in the directory <PS_directory>\log\fwp_mcr.Look for the following message:FWP1734I The utility that was started by the Management Component



12. Installing the SLM Warehouse PackUse the install program for Tivoli Enterprise Data Warehouse to install the DYKwarehouse pack for IBM Tivoli Service Level Advisor target ETLs (the Registrationand Process ETLs):1. Insert the Tivoli Enterprise Data Warehouse product CD into the Warehouse

machine. The installation program will be automatically started.2. On the Welcome panel, click Next to continue.3. On the Setup Type dialog, verify that the Application installation only radio

button is selected, and click Next to continue.4. On the Host Name dialog, verify that the fully qualified host name for the

Warehouse machine is correct, and click Next to continue.5. On the DB2 Configuration dialog, specify the following DB2 user name and

password and click Next to continue:v User name: db2admin


6. On the Application Packages dialog, select the check box to install applicationpackages, and click Next to continue. This will enable you to install theRegistration and Process ETLs for IBM Tivoli Service Level Advisor.

7. Remove the Tivoli Enterprise Data Warehouse product CD and insert the IBMTivoli Service Level Advisor product CD.

8. On the Installation Path dialog, click Browse and select the CD-ROM drive inthe bottom drop-down menu.

9. Double-click tedw_apps, then double-click dyk, then click OK.10. On the Application Package Directory Name dialog, verify that the directory

name is specified as <CD_ROM>:\tedw_apps\dyk\, where <CD_ROM> is theCD-ROM drive letter, and click Next to continue.

11. On the Application Packages dialog, verify that the check box is not selected,and click Next to continue.



13. Configuring the SLM Target ETLsOn the Warehouse machine, do the following:1. Start the DB2 Control Center and select Tools –> Data Warehouse Center.2. Click Advanced and change the control database to TWH_MD.3. Log in to the Data Warehouse Center with the default user name db2admin and

password db2admin.4. For each Warehouse Source and Warehouse Target, right-click and select

Properties from the context menu. On the Database tab, enter the default username db2admin and password db2admin.

Note: Configure multiple databases using the same user ID and password atthe same time by selecting either the Warehouse Sources or WarehouseTargets folder, highlight all desired databases at once, and set the userID and password for all the databases at the same time.

5. You need to enable source applications for which you want to collect andevaluate data in IBM Tivoli Service Level Advisor. Only data from enabledsource applications will be accepted for evaluation and analysis. See “EnablingData Collection for Source Applications” on page 92 for more information onenabling source applications.

6. Continue in the Data Warehouse Center to promote the ETLs to productionmode. See “Promoting the ETLs to Production Mode” on page 93 for theprocedure.

Populating The Warehouse DatabaseAt this point in the Quick Start installation, the base SLM solution has beeninstalled. The central data warehouse is in place, the two databases used by IBMTivoli Service Level Advisor are created, the Registration and Process ETLs areinstalled and configured to move data from the warehouse to the SLM databases,the SLM Server is installed and in communication with the databases, the SLMTask Drivers are integrated into the IBM Console, and the SLM Reports option isintegrated into the WebSphere Application Server environment.

The next steps involve populating the Tivoli Enterprise Data Warehouse databasewith data that can be used by IBM Tivoli Service Level Advisor. Depending onwhat you want to achieve in this environment, you can do either of the following:v Install one or more warehouse enablement packs that enable source applications

to write data into the warehouse database, for use in a production environmentv Install a set of sample data that simulates a production environment, enabling

you to learn more about using IBM Tivoli Service Level Advisor beforeintroducing it into your production environment.

Installing Warehouse Enablement PacksIf you have a source application installed that can store data into the TivoliEnterprise Data Warehouse database, and this source application is supported byIBM Tivoli Service Level Advisor (see “Enabling Data Collection for SourceApplications” on page 92), you can install one or more warehouse packs thatprovide the warehouse functionality for the assocuated source applications in yourenterprise. See “Installing Source Application Warehouse Packs” on page 52 andrefer to Installing and Configuring Tivoli Enterprise Data Warehouse and thewarehouse pack implementation guide for the source application, for moreinformation on installing and configuring warehouse packs.


Installing Sample DataIf you do not have a source application that can put data into the warehousedatabase, you can load the Tivoli Enterprise Data Warehouse database with a set ofsample data that simulates the execution of a normal ETL putting data into thewarehouse database, and performs the generation of an SLA and the evaluation ofthe SLA data. For more information on installing and working with this sampledata, refer to the IBM Tivoli Service Level Advisor Support Web site (see the IBMTivoli Service Level Advisor Release Notes for information on accessing theSupport Web site).


Appendix B. A Three Machine Installation Example

The following procedure is intended to provide you with a consolidated set ofsteps to perform an IBM Tivoli Service Level Advisor solution installation that canbe used as an entry-level production environment. These procedures take allavailable defaults.

The deployment consists of three machines available on the network:v A Windows machine containing the Tivoli Enterprise Data Warehouse Control

Server and report interface task drivers, the IBM Console, and the IBM TivoliService Level Advisor SLM Task Drivers component.

v A UNIX machine containing the Tivoli Enterprise Data Warehouse central datawarehouse and data mart

v A second UNIX machine containing the IBM Tivoli Service Level Advisor SLMServer and SLM Reports components, and its associated databases

Figure 40 shows the deployment of the major components of Tivoli Enterprise DataWarehouse and IBM Tivoli Service Level Advisor in the three machines.

Installation AssumptionsThis installation assumes the following:

Figure 40. A three-machine deployment on UNIX and Windows

143

v For purposes of this discussion, the two UNIX machines will be referred to asthe Warehouse machine and the SLM machine, and the Windows machine will bereferred to as the Control machine.

v The Warehouse machine and SLM machine are running on a UNIX (AIX, Solaris,Linux) platform. The Control machine is running on a Windows NT or Windows2000 platform.

v All machines have met all operating system configuration requirements definedin the Tivoli Enterprise Data Warehouse and IBM Tivoli Service Level Advisordocumentation (for example, see “Step 3. Ensure fully qualified host names” onpage 31 for information on configuring your system to return fully qualified hostnames)

v Any previous installation of Tivoli Enterprise Data Warehouse or IBM TivoliService Level Advisor has been completely removed from these machines, andthat only the operating systems are installed (no DB2 installed, no HTTP Serverinstalled). For this scenario, migration issues are not included.

v The machines are configured to automatically start from the product CD.v You have available the required installation CDs for the SLM solution, including:

– IBM DB2 7.2 with Fix Pack 5– IBM DB2 7.2 Fix Pack 6– Tivoli Enterprise Data Warehouse 1.1– Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1– IBM Tivoli Service Level Advisor 1.2– WebSphere 4.0.1 AES

Note: Source application warehouse packs are not included in this list becauseyou will have the option to conclude this quick start procedure and installyour warehouse packs separately if desired, or to use a simulated set ofdata in the warehouse to use in a non-production environment forlearning purposes.

v You have familiarized yourself with the product by reading the overviews andinstallation procedures and completed the planning process suitable for yourentry-level production environment. If you intend to use this installation as aproduction environment, you should read this complete document to ensure thatyou have performed all pertinent configuration steps to have a successfulproduction environment.

v You have read through this entire appendix before beginning the installation tobe sure you understand all of the steps.

The installation procedure consists of the following major steps, which aredescribed in more detail in the remaining sections of this appendix:v Complete the planning worksheet for this installationv On the Control (Windows) machine:

– Install DB2 7.2 server with Fix Pack 5– Upgrade DB2 to Fix Pack 6– Install the Tivoli Enterprise Data Warehouse 1.1 control server– Install the Tivoli Enterprise Data Warehouse 1.1 Report Interface and the IBM

Console (Tivoli Presentation Services)– Install the Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1– Configure ODBC Datasources– Install the IBM Tivoli Service Level Advisor SLM Task Drivers component


– Install the IBM Tivoli Service Level Advisor target ETLs– Configure and schedule the target ETLs

v On the Warehouse (UNIX) machine:– Install DB2 7.2 server with Fix Pack 5– Upgrade DB2 to Fix Pack 6– Install the Tivoli Enterprise Data Warehouse 1.1 Central Data Warehouse and

Data Mart– Install the Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1

v On the SLM (UNIX) machine:– Install DB2 7.2 server with Fix Pack 5– Upgrade DB2 to Fix Pack 6– Create the SLM Databases– Install WebSphere Application Server– Install the IBM Tivoli Service Level Advisor SLM Server and SLM Reports

components

Performing the above steps will prepare your three-machine SLM solution forreceiving and processing data from one or more source applications that will writedata into the central data warehouse. You must perform additional steps to installand configure the various source applications and their associated warehousepacks in order to begin putting data into the central data warehouse. You canoptionally install a set of simulated data that may be useful in evaluating yourproduction environment and learning how your SLM solution works. Theseadditional steps are not included in this appendix. See “Warehouse Packs” onpage viii to find information on currently available warehouse packs.

1. Planning for InstallationPlanning worksheets exist for both Tivoli Enterprise Data Warehouse and IBMTivoli Service Level Advisor installation procedures, and should be completedbefore installing these products. For this particular installation, the planninginformation required is a subset of the full planning worksheets. Table 14 specifiesthe planning information you should gather for this installation.

Table 14. Planning sheet for this Quick Start installation

Item to plan for Your response

Fully qualified host name of the Warehousemachine

Fully qualified host name of the SLMmachine

Fully qualified host name of the Controlmachine

User ID and password for the SLM machine

WebSphere node name (see step 10 onpage 135)

2. Installing DB2 Server on the UNIX MachinesInstall DB2 Universal Enterprise Edition Server software on both the Warehouseand SLM machines by doing the following:

Appendix B. A Three Machine Installation Example 145

1. Before starting the installation, be sure to check the DB2 ″Quick Beginnings″document for specific procedures that you need to complete depending on theUNIX platform on which you are installing DB2.

2. Insert the DB2 product CD and mount it as follows:v For AIX, issue the following command, where <mount_dir> is the mount





./db2setup

5. On the DB2 product selection dialog, use the tab key to navigate to DB2 UDBEnterprise Edition and select it using the space bar.

6. Using the tab key, navigate to OK and press Enter to continue.7. The Create DB2 Services dialog is displayed. This includes entries to create

DB2 Instance and DB2 Administration Server. Using the tab key, navigate toCreate DB2 Instance, and select it using the spacebar.

8. The Authentication dialog for DB2 Instance is displayed. Specify theusername as db2admin, the home directory as /home/db2admin or/export/home/db2admin (depending on the directory where the home file systemis mounted), and the password as db2admin. Verify the password again, andusing the tab key, navigate to OK and press Enter.

9. The Fenced User dialog is displayed. Accept all defaults (except you maywant to change the home directory, similar to the previous step). Specify thepassword as db2fenc1 and specify it again to verify it. Using the tab key,navigate to OK and press Enter.

10. The DB2 Warehouse Control Database dialog is displayed. Choose the optionto not create the Control Database (this is created on the Control machine).Navigate to OK and press Enter.

11. The DB2 Warehouse Control Database setup dialog is displayed. Accept alldefaults, and navigate to OK and press Enter.

12. The Create DB2 Services dialog is displayed again. This time, navigate toCreate Administration Server, and select it using the spacebar. Navigate toOK and press Enter.

13. The Administration Server dialog is displayed. Accept all defaults. Specifythe password as db2as and specify it again to verify it. Navigate to OK andpress Enter.

14. A notice is displayed, informing you that DB2SYSTEM will be set to the hostname. Navigate to OK and press Enter.

15. The Create DB2 Services dialog is displayed once more. Navigate to OK andpress Enter.

16. The DB2 Setup Utility dialog is displayed. Navigate to Continue and pressEnter.

17. A warning is displayed indication that this is your last chance to makecorrections or changes before the installation begins. Navigate to OK andpress Enter to start the installation of the DB2 Server.


18. The installation will take a few minutes to complete. If the installation fails,examine the log at /tmp/db2setup.log for specific error messages, and correctany problems before attempting to install again.

19. You are returned to the command prompt. Unmount the CD as follows:v For AIX, change the directory from the mounted directory and enter umount

<mount_dir>




Be sure to run this install procedure on both the Warehouse and SLM (UNIX)machines.

3. Installing DB2 Server on the Windows MachineInstall the DB2 server software on the Control (Windows) machine by doing thefollowing:1. Insert the DB2 product CD to start the DB2 install program, and click Install.2. On the DB2 product selection dialog, check DB2 Enterprise Edition install

option (this should be the only option checked). Click Next to continue.3. On the Installation Type and Destination Location dialogs, accept the defaults

and click Next to continue.4. On the Control Center Server dialog, specify the following DB2 user name and

password and click Next to continue (if a message is displayed regardingcreation of the user ID, click Yes to continue):v User name: db2admin


5. On the Current Settings dialog, click Next to perform the installation.6. When the installation completes, click Finish and then click Exit.7. Reboot the system to complete the installation

4. Upgrading to DB2 7.2 Fix Pack 6You can download DB2 7.2 Fix Pack 6 from the Tivoli Enterprise Data Warehousesupport Web site:http://www.ibm.com/software/sysmgmt/products/support/


Upgrade your installation of DB2 7.2 to Fix Pack 6 by doing the following for allthree machines:v For Windows:

1. Stop all services associated with DB2 by starting a DB2 command promptand issuing the following commands:db2stop force

db2admin stop


3. Navigate to the directory where you downloaded DB2 Fix Pack 6 and runthe following program:


setup.exe

Note: If you receive the following message, click Yes and continue theinstall:DB2 is currently running and locked by the following process(es):

jservice.exe

4. Follow the instructions in the install program to install the fix pack.v For UNIX:

1. Verify that the root user is a member of the db2iadm1 group. If not, add theroot user to this group using admintool or a similar tool.

2. While logged in as root, su to the DB2 instance owner and source thedb2profile by starting a db2 command prompt and issuing the command:. ./db2profile

3. Enter the following commands for each instance:db2 force applications all

db2 terminate

db2stop

Repeat these steps for each instance.

Note: To retreive a list of instances, enter the following command:db2ilist

4. While logged in as root, su to the DB2 Administrative Server owner andsource the db2profile

5. While logged in as root, navigate to the location where you unzipped the fixpack image and run the following command:./installFixPak

6. After the installation has completed successfully, update each instance withthe following command:– For Solaris:

/opt/IBMdb2/V7.1/instance/db2iupdt <instance_name>

– For AIX:/usr/lpp/db2_07_01/instance/db2iupdt <instance_name>

– For Linux:/usr/IBMdb2/V7.1/instance/db2iupdt <instance_name>

Be sure to perform the above procedure on the Control, Warehouse, and SLMmachines.

5. Configuring the Database Manager to use Extended Shared MemoryTo enable this support for extended shared memory, do the following on theWarehouse and SLM machines (this may not be required on all UNIX platforms):1. Add EXTSHM=ON to the /etc/environment file2. From a DB2 command prompt, run the following command:

db2set DB2ENVLIST=EXTSHM

3. Add the following lines to sqllib/db2profile:EXTSHM=ON

export EXTSHM

4. Reboot the Warehouse machine to put the changes into effect.


Be sure to perform these steps on both the Warehouse and the SLM machines.

6. Installing the Central Data Warehouse and Data MartOn the Warehouse machine, install the Tivoli Enterprise Data Warehouse CentralData Warehouse and Data Mart by doing the following:1. Insert the Tivoli Enterprise Data Warehouse product CD and mount it as

follows:v For AIX, issue the following command, where <mount_dir> is the mount





./setup_unix.sh

4. On the Welcome panel, click Next to continue.5. The Setup Type dialog is displayed. Select the Custom/Distributed radio

button, change the name of the target install directory if desired, and clickNext to continue.

6. The Features dialog is displayed. Select the Central Data Warehouse andData mart options, and click Next to continue.

Note: For AIX and Linux platforms, verify that the refresh of the panel iscompleted before selecting the options.

7. The Host Name dialog is displayed. Enter the fully qualified host name (oraccept the default if it is correct) of the local (Warehouse) machine and clickNext to continue.

8. On the DB2 Configuration dialog, specify the following DB2 user name andpassword and click Next to continue:v User name: db2admin




10. A dialog is displayed prompting you for information for remote access to DB2on the Control machine. Specify the values for username, password, hostname, and port number of the Control machine (the Windows machine whereyou plan to install the Tivoli Enterprise Data Warehouse control server), andclick Next to continue.


12. Wait for the installation to complete. Click Finish to finish the installation.13. You are returned to the command prompt. Unmount the CD as follows:

v For AIX, change the directory from the mounted directory and enter umount<mount_dir>





7. Installing the Control Server and Report InterfaceOn the Control (Windows) machine, install the Tivoli Enterprise Data Warehousecontrol server and Report Interface, along with Tivoli Presentation Services and theIBM Console by doing the following:1. Insert the Tivoli Enterprise Data Warehouse product CD. The installation

program will be automatically started.2. On the Welcome panel, click Next to continue.3. The Setup Type dialog is displayed. Select the Custom/Distributed radio

button, change the name of the target install directory if desired, and clickNext to continue.

4. The Features dialog is displayed. Select the Tivoli Enterprise Data Warehousecontrol server and Report interface options, and click Next to continue.

Note: For AIX and Linux platforms, verify that the refresh of the panel iscompleted before selecting the options.

5. The Host name dialog is displayed. Verify that the fully qualified host namefor the Control machine is correct, and change it if needed. Click Next tocontinue.

6. On the DB2 Configuration dialog, specify the following DB2 user name andpassword and click Next to continue:v User name: db2admin


7. The wizard checks to see if Tivoli Presentation Services is installed, and if not,a dialog is displayed. For purposes of this install scenario, assume that noother HTTP server is already installed on this machine, and accept all defaultvalues for port numbers and directory name. Click Next to continue.

Note: If another HTTP server exists for this machine, you must change theIBM HTTP Server Port to another port, such as 81, and the IBM HTTPAdministration Port to another port, such as 8009 to avoid conflicts,and verify that the existing HTTP server is stopped for this install.



9. A dialog is displayed prompting you for information for remote access to DB2on the Warehouse machine (where the Central Data Warehouse is installed).Specify the values for username, password, host name, and port number ofthe Warehouse machine, and click Next to continue.

10. A dialog is displayed prompting you for information for remote access to DB2databases containing data marts on the Warehouse machine (where the TivoliEnterprise Data Warehouse Data mart is installed). Specify the values forusername, password, host name, and port number of the Warehouse machine,and click Next to continue.



12. After the installation program has copied files and configured theenvironment, the Installation Summary window is displayed. Click Next tocontinue.

13. Do not select the option to restart the system at this time. Click Next and thenclick Finish.

14. Wait for the IBM Console to finish rebuilding the online user assistance helpset. You can check for completeness by examining the most recent (highestnumbered n) stdoutn log file in the directory <PS_directory>\log\fwp_mcr,where <PS_directory> is the location where Tivoli Presentation Services wasinstalled. Look for the following message:FWP1734I The utility that was started by the Management Component



8. Installing Tivoli Enterprise Data Warehouse 1.1 Fix Pack 1IBM Tivoli Service Level Advisor requires Tivoli Enterprise Data Warehouse 1.1with Fix Pack 1 to be installed. Refer to the Tivoli Enterprise Data Warehouse Fix Pack1 Readme and the Tivoli Enterprise Data Warehouse support Web site for fix packinformation. Install the fix pack on both the Warehouse and the Control machines.

9. Installing WebSphereThis procedure installs WebSphere Advanced Edition Single Server (AES), Version4.0.1, that is shipped with IBM Tivoli Service Level Advisor. If you have anotherversion of WebSphere, consult the accompanying WebSphere documentation foradditional install information.

To install Websphere AES 4.0.1 on the SLM machine, do the following:1. Mount the UNIX version of the WebSphere AES 4.0.1 CD:




2. Change to the mounted directory <mount_dir>/<os version>, where <osversion>is aix for AIX, sun for Solaris, and linux for Linux.


4. The Welcome banner is displayed. Click Next to display a window withWebsphere AES operating system prerequisites. If everything is satisfactory,click OK to continue, or update the operating system with the required fixesby downloading them from the corresponding operating system support Website.



7. The Install Options window is displayed, listing the components to beinstalled. Click Install, which starts the installation. At the end, click Finish tocomplete the installation.


8. Unmount the CD as follows:v For AIX, change the directory from the mounted directory and enter umount

<mount_dir>





10. Completion of the installation launches the First Steps html page if Netscapeis installed. You can use this html page to start and stop the WebsphereApplication Server, or see Chapter 6, “Startup and Shutdown Procedures” onpage 103 for the procedures to start and stop the Websphere ApplicationServer and the HTTP Server.

Configuring the JDBC Driver for WebSphereAfter the Websphere and HTTP Server are started, configure the JDBC Driver forWebSphere by doing the following:1. Open your Web browser and point to the following Web site:

http://<host name>:9090/admin

2. Sign on using admin as the user ID.3. The Administrative Console is displayed. Expand Resources in the navigation

tree in the left pane.4. Expand JDBC Drivers and select DB2Jdbc Driver.5. In the Server Class Path field, enter the path and file name of the location of

the DB2 driver, similar to the following example, where<db2_server_install_directory> is the location where the DB2 server is installed onthis machine, and then click OK:<db2_server_install_directory>\java12\db2java.zip

Note: If you installed DB2 using the defaults, <db2_server_install_directory>should be entered as C:\Program Files\sqllib.

6. A hotspot, Configuration needs to be saved, is displayed. Click this hotspot tosave the configuration, then log off using Exit.


10. Creating Databases for IBM Tivoli Service Level AdvisorThis installation procedure creates the two databases used by IBM Tivoli ServiceLevel Advisor, the SLM Database and the SLM Measurement Data Mart. In thisinstallation, these databases are created on the SLM (UNIX) machine.

Note: The installation of Tivoli Enterprise Data Warehouse must be completedbefore beginning this installation procedure.


To create these two databases on the SLM machine, source the db2profile and dothe following:1. Insert the IBM Tivoli Service Level Advisor product CD and mount it as

follows:v For AIX, issue the following command, where <mount_dir> is the mount




2. Change to the mounting directory.3. Navigate to database/scripts/<OS_type>, where <OS_type> is one of the

following:v For AIX: aix4-r1

v For Solaris: solaris2

v For Linux: linux-ix86

4. Run the following command:./dyk_cat_dbinst.sh

5. Specify the db2 user name as db2admin

6. Specify the db2 password as db2admin

7. Accept the default of dyk_cat for the database name8. Specify the home directory for the DB2 user.9. Accept the default territory of US or change this to another if desired.

10. Specify the name and path of the log file11. Specify the name and path of the verification log file12. Enter Y in response to the next two prompts13. Enter Y to enable log retain

The SLM Database (dyk_cat) database is then created. Repeat this procedure tocreate the SLM Measurement Data Mart (dyk_dm) database, running thedyk_dm_dbinst.sh script in step 4 and specifying the database name as dyk_dm instep 7.

11. Configuring ODBC Data SourcesTo configure ODBC data sources on the Control machine, do the following:1. Insert the IBM Tivoli Service Level Advisor product CD in the CD-ROM drive

of the Control machine.2. Select Start –>Run and run the db2cmd command to initialize a DB2 command

session. A window titled DB2 CLP will be started. Steps 3-4 should be executedin that window.

3. To create the ODBC data source named DYK_CAT for the SLM Database,navigate to the <CD-ROM>\database\scripts\w32-ix86\ directory, where<CD-ROM> is the CD-ROM drive letter, and run the following command,where <SLM_hostname> is the fully qualified host name of the SLM machine,where the database is located:dyk_cat_odbc.bat <SLM_hostname>

4. Similarly, to create the ODBC data source named DYK_DM for the SLMMeasurement Data Mart, run the following script:


dyk_dm_odbc.bat <SLM_hostname>

12. Installing the SLM Server and SLM ReportsInstall the SLM Server and SLM Reports options of IBM Tivoli Service LevelAdvisor on the SLM machine by sourcing the db2profile and doing the following:1. Mount the IBM Tivoli Service Level Advisor product CD:





3. On the Welcome dialog, Next to continue.4. On the License Agreement dialog, select the I accept the terms in the license


Directory and the location where IBM Tivoli Service Level Advisor will beinstalled, and click Next to continue.


7. On the WebSphere Directory dialog, click Next to continue.8. Obtain the WebSphere node name (see “Identifying the WebSphere Node

Name” on page 58). You might be able to obtain the node name quickly bydoing the following:a. Open a Web browser and point to http://<host name>:9090/admin, where

<host name> is the host name of your local machine (the SLM machine)b. The WebSphere Application Server Login window is displayed. Enter any

name in the user ID field, or leave it blank, and click Submit.c. The WebSphere Administrative Console is displayed. In the left pane, click

the plus sign next to Nodes. The WebSphere node name will be displayedunder Nodes. Write it down for later use.

9. On the WebSphere Node Name dialog, enter the WebSphere node name youfound in the previous step. Click Next to continue.

Note: This node name is case-sensitive and must be entered exactly as foundin the previous step.

10. On the SLM Database dialog, select the Local radio button (because thedatabase is created on the SLM machine), and click Next to continue.


12. On the SLM Measurement Data Mart dialog, select the Local radio button(because the database is created on the SLM machine), and click Next tocontinue.



14. On the DB2 Instance directory dialog, enter the home directory of the DB2instance of the SLM databases on the local machine. If you installed DB2using the default db2admin user name, specify the home directory as/home/db2admin.

15. On the SLM Server port dialog, click Next to continue.16. On the SLA Notification Selection dialog, if you need to set up SLA

notification, see “Step 12. Specify Event Notification Methods” on page 78,otherwise click Next to continue (for this sample installation, you can justcontinue without specifying any event notification options).

17. On the feature summary dialog, click Next to proceed with the installation.18. After the installation and configuration is complete, click Finish.19. Unmount the CD as follows:

v For AIX, change the directory from the mounted directory and enter umount<mount_dir>




13. Installing SLM Task DriversOn the Control (Windows) machine, install the SLM Task Drivers component ofIBM Tivoli Service Level Advisor by doing the following:1. Insert the IBM Tivoli Service Level Advisor product CD and run install.bat.2. On the Welcome dialog, Next to continue.3. On the License Agreement dialog, select the I accept the terms in the license


Directory and the location where IBM Tivoli Service Level Advisor will beinstalled, and click Next to continue.

5. On the Product Installation options dialog deselect the SLM Server and SLMReports check boxes, and verify that the IBM Tivoli Service Level Advisorand SLM Task Drivers check boxes are checked. Click Next to continue.

6. On the SLM Database dialog, select the Remote radio button (because thedatabase is created on the SLM machine), and click Next to continue.

7. On the next dialog, accept the defaults that are presented in the fields, but inthe Password field, enter the DB2 password db2admin, and in the DatabaseServer Host Name field, enter the fully qualified host name of the SLMmachine, which is where the SLM Database was created. Click Next tocontinue.

8. On the SLM Server Host Name dialog enter the fully qualified host name ofthe SLM machine, and click Next to continue.

9. On the feature summary dialog, click Next to perform the installation.10. After the files have been copied, click Next to restart Tivoli Presentation

Services.11. Wait for the IBM Console to finish rebuilding the online user assistance help

set. You can check for completeness by examining the most recent (highestnumbered n) stdoutn log file in the directory <PS_directory>\log\fwp_mcr.Look for the following message:


FWP1734I The utility that was started by the Management Component



14. Installing Target ETLsThe Process and Registration ETLs that move data from the Tivoli Enterprise DataWarehouse database into the SLM Database and SLM Measurement Data Martdatabases for use by IBM Tivoli Service Level Advisor are installed on the Controlmachine where the Tivoli Enterprise Data Warehouse control server is installed.This installation assumes that the installation of Tivoli Enterprise Data Warehousewas completed successfully.

On the Control machine, install the Registration and Process ETLs by doing thefollowing:1. Insert the Tivoli Enterprise Data Warehouse product CD. The installation

program will be automatically started.2. On the Welcome panel, click Next to continue.3. On the Setup Type dialog, select the Application installation only radio

button, and click Next to continue.4. On the Host Name dialog, verify that the fully qualified host name for the

Control machine is correct, and click Next to continue.5. On the DB2 Configuration dialog, specify the following DB2 user name and

password and click Next to continue:v User name: db2admin


6. A dialog is displayed prompting you for information for remote access to DB2on the Warehouse machine (where the Central Data Warehouse is installed).Specify the values for username, password, host name, and port number ofthe Warehouse machine, and click Next to continue.

7. A dialog is displayed prompting you for information for remote access to DB2databases containing data marts on the SLM machine (where the SLMDatabase and SLM Measurement Data Mart are installed). Specify the valuesfor username, password, host name, and port number of the SLM machine,and click Next to continue.

8. A dialog is displayed prompting you to enter the path to the installationmedia for the application packages. The target ETLs for IBM Tivoli ServiceLevel Advisor are installed from the IBM Tivoli Service Level Advisor productCD. Remove the Tivoli Enterprise Data Warehouse product CD and insert theIBM Tivoli Service Level Advisor product CD.

9. On the Installation Path dialog, click Browse and select the CD-ROM drive inthe bottom drop-down menu.

10. Double-click tedw_apps, then double-click dyk, then click OK.11. On the Application Package Directory Name dialog, verify that the directory

name is specified as <CD_ROM>:\tedw_apps\dyk\, where <CD_ROM> is theCD-ROM drive letter, and click Next to continue.

12. On the Additional Applications Packages dialog, verify that the check box isnot checked and click Next to continue.


14. Wait for the installation to complete, and click Finish.



15. Configuring SLM ETLsOn the Control machine, do the following:1. Start the DB2 Control Center and select Tools –> Data Warehouse Center.2. Click Advanced and change the control database to TWH_MD.3. Log in to the Data Warehouse Center with the default user name db2admin and

password db2admin.4. For each Warehouse Source and Warehouse Target, right-click and select

Properties from the context menu. On the Database tab, enter the default username db2admin and password db2admin.

Note: Configure multiple databases using the same user ID and password atthe same time by selecting either the Warehouse Sources or WarehouseTargets folder, highlight all desired databases at once, and set the userID and password for all the databases at the same time.

5. You need to enable source applications for which you want to collect andevaluate data in IBM Tivoli Service Level Advisor. Only data from enabledsource applications will be accepted for evaluation and analysis. See “EnablingData Collection for Source Applications” on page 92 for more information onenabling source applications.

6. Continue in the Data Warehouse Center to promote the ETLs to productionmode. See “Promoting the ETLs to Production Mode” on page 93 for theprocedure.

Populating The Warehouse DatabaseAt this point in the Quick Start installation, the base SLM solution has beeninstalled. The central data warehouse is in place, the two databases used by IBMTivoli Service Level Advisor are created, the Registration and Process ETLs areinstalled and configured to move data from the warehouse to the SLM databases,the SLM Server is installed and in communication with the databases, the SLMTask Drivers are integrated into the IBM Console, and the SLM Reports option isintegrated into the WebSphere Application Server environment.

The next steps involve populating the Tivoli Enterprise Data Warehouse databasewith data that can be used by IBM Tivoli Service Level Advisor. Depending onwhat you want to achieve in this environment, you can do either of the following:v Install one or more warehouse enablement packs that enable source applications

to write data into the warehouse database, for use in a production environmentv Install a set of sample data that simulates a production environment, enabling

you to learn more about using IBM Tivoli Service Level Advisor beforeintroducing it into your production environment.

Installing Warehouse PacksIf you have a source application installed that can store data into the TivoliEnterprise Data Warehouse database, and this source application is supported byIBM Tivoli Service Level Advisor (see “Enabling Data Collection for SourceApplications” on page 92), you can install one or more warehouse packs thatprovide the warehouse functionality for the assocuated source applications in yourenterprise. See “Installing Source Application Warehouse Packs” on page 52 andrefer to Installing and Configuring Tivoli Enterprise Data Warehouse and the


warehouse pack implementation guide for the source application, for moreinformation on installing and configuring warehouse packs.

Installing Sample DataIf you do not have a source application that can put data into the warehousedatabase, you can load the Tivoli Enterprise Data Warehouse database with a set ofsample data that simulates the execution of a normal ETL putting data into thewarehouse database, and performs the generation of an SLA and the evaluation ofthe SLA data. For more information on installing and working with this sampledata, refer to the IBM Tivoli Service Level Advisor Support Web site (see the IBMTivoli Service Level Advisor Release Notes for information on accessing theSupport Web site).


Appendix C. Database Creation Tables

The following table information is created when you successfully create the SLMDatabase (dyk_cat) and SLM Measurement Data Mart (dyk_dm) using thedyk_cat_dbinst and dyk_dm_dbinst script file (see “Creating the IBM Tivoli ServiceLevel Advisor Application Databases” on page 60).

Compare your table information in the table verification logs to the followingtables to verify that the databases were created successfully. If the tableinformation does not match, check the database creation output log file for anyerrors that may have occurred during any of the following:v Dropping of a databasev Database creationv Database connectionv Database object creation, such as tables, indexes, and constraints

When you have identified and corrected the error, run the dyk_cat_dbinst anddyk_dm_dbinst scripts again.

Tables Created with dyk_cat_dbinstPlease verify that the proper tables were created for the db2admin and MM schemas

Table/View Schema Type Creation time------------------------------- --------------- ----- --------------------------ACCOUNT DB2ADMIN T 2002-07-18-18.19.46.935001AGREEMENT_VIOL DB2ADMIN T 2002-07-18-18.19.55.618001BASE_ELMT_PROPS DB2ADMIN V 2002-07-18-18.20.01.897001CONSUMER DB2ADMIN T 2002-07-18-18.19.53.685001CONSUMER_REALM DB2ADMIN T 2002-07-18-18.19.54.096001CUST_ORDER DB2ADMIN T 2002-07-18-18.19.54.366001ELMT_MPROP_OFFRGID_VIEW DB2ADMIN V 2002-07-18-18.20.03.629001ELMT_MPROP_VIEW DB2ADMIN V 2002-07-18-18.20.03.780000ELMT_PROP DB2ADMIN T 2002-07-18-18.19.49.599001ELMT_PROP_VIEW DB2ADMIN V 2002-07-18-18.20.03.109001ID_GENERATOR DB2ADMIN T 2002-07-18-18.19.59.073001METRIC DB2ADMIN T 2002-07-18-18.19.55.968000METRIC_DEF DB2ADMIN T 2002-07-18-18.19.49.189001METRIC_DEF_VIEW DB2ADMIN V 2002-07-18-18.20.03.509001MONITORING_RESULT DB2ADMIN T 2002-07-18-18.19.56.509001MSCHED_VIEW DB2ADMIN V 2002-07-18-18.20.03.419001OFFERING_ORDER DB2ADMIN T 2002-07-18-18.19.59.483001OFFRG_DEF_VIEW DB2ADMIN V 2002-07-18-18.20.02.858001OFFRG_ELMT DB2ADMIN T 2002-07-18-18.19.52.814001OFFRG_ELMT_LCLE DB2ADMIN T 2002-07-18-18.19.56.820001OFFRG_ELMT_PROPS DB2ADMIN V 2002-07-18-18.20.02.418001OFFRG_PROP DB2ADMIN T 2002-07-18-18.19.53.325000OFFRG_PROP_SHOWSUBSCRIBER DB2ADMIN V 2002-07-18-18.20.02.558001OFFRG_PROP_VIEW DB2ADMIN V 2002-07-18-18.20.03.229001ORDER_DEF_VIEW DB2ADMIN V 2002-07-18-18.20.02.888001ORDER_ELMT DB2ADMIN T 2002-07-18-18.19.54.797001ORDER_ELMT_PROPS DB2ADMIN V 2002-07-18-18.20.02.578001ORDER_PROP DB2ADMIN T 2002-07-18-18.19.55.137001ORDER_PROP_VIEW DB2ADMIN V 2002-07-18-18.20.03.309001OUTAGE DB2ADMIN T 2002-07-18-18.19.57.160001PROP_DEF DB2ADMIN T 2002-07-18-18.19.48.347001PROP_DEF_VIEW DB2ADMIN V 2002-07-18-18.20.02.748001QUARTER_DATE DB2ADMIN T 2002-07-18-18.20.00.074001

159

REALM DB2ADMIN T 2002-07-18-18.19.51.742001RESULTVIEW DB2ADMIN V 2002-07-18-18.20.04.000001SCHEDULE DB2ADMIN T 2002-07-18-18.19.50.250001SCHEDULE_HIERARCHY DB2ADMIN T 2002-07-18-18.20.00.265001SCHEDULE_LCLE DB2ADMIN T 2002-07-18-18.19.50.751001SCHEDULE_MILESTONE DB2ADMIN T 2002-07-18-18.19.51.151001SCHEDULE_PERIOD DB2ADMIN T 2002-07-18-18.19.51.532001SCHEDULE_STATE DB2ADMIN T 2002-07-18-18.19.59.864001SCHEDULE_STATE_VIEW DB2ADMIN V 2002-07-18-18.20.01.086001SCOPE_PROP_SPEC_VIEW DB2ADMIN V 2002-07-18-18.20.01.607001SCOPE_PROP_VIEW DB2ADMIN V 2002-07-18-18.20.01.386001SCOPE_SE_VIEW DB2ADMIN V 2002-07-18-18.20.03.970001SD_TXN DB2ADMIN T 2002-07-18-18.19.57.581001SO_LISTENER DB2ADMIN T 2002-07-18-18.19.58.432001SPEC_DEF DB2ADMIN T 2002-07-18-18.19.48.878001SVC_ELMT DB2ADMIN T 2002-07-18-18.19.47.997001SVC_ELMT_MANAGER DB2ADMIN T 2002-07-18-18.19.47.186001SVC_OFFRG DB2ADMIN T 2002-07-18-18.19.52.203001SVC_OFFRG_LCLE DB2ADMIN T 2002-07-18-18.19.52.493001SVC_OFFRG_VIEW DB2ADMIN V 2002-07-18-18.20.04.451001SVC_SCOPE DB2ADMIN T 2002-07-18-18.19.47.456000TABLE_LOCK DB2ADMIN T 2002-07-18-18.20.00.445001TREND DB2ADMIN T 2002-07-18-18.19.57.931001TRENDVIEW DB2ADMIN V 2002-07-18-18.20.04.320001USER_INFO DB2ADMIN T 2002-07-18-18.19.58.752001VIOLATIONVIEW DB2ADMIN V 2002-07-18-18.20.04.170001

59 record(s) selected.

Table/View Schema Type Creation time------------------------------- --------------- ----- --------------------------ATTRDOM MM T 2002-07-18-18.20.04.731001ATTRRUL MM T 2002-07-18-18.20.05.071001ATTRTYP MM T 2002-07-18-18.20.05.382001COMP MM T 2002-07-18-18.20.05.602000COMPATTR MM T 2002-07-18-18.20.06.073001COMPPATH MM T 2002-07-18-18.20.06.514001COMPRELN MM T 2002-07-18-18.20.06.834001COMPTYP MM T 2002-07-18-18.20.07.235001EXTRACT_FILTER MM T 2002-07-18-18.20.07.585001HISTORY MM T 2002-07-18-18.20.08.066001MGRP MM T 2002-07-18-18.20.08.416001MGRPMBR MM T 2002-07-18-18.20.09.127001MGRPTYP MM T 2002-07-18-18.20.09.678001MSMTRUL MM T 2002-07-18-18.20.09.979001MSMTTYP MM T 2002-07-18-18.20.10.229001MSRC MM T 2002-07-18-18.20.10.529001MUNIT MM T 2002-07-18-18.20.10.790000MUNITCAT MM T 2002-07-18-18.20.11.130001RELNRUL MM T 2002-07-18-18.20.11.381001RELNTYP MM T 2002-07-18-18.20.11.651001SCHEMA_VER MM T 2002-07-18-18.20.12.001001TRANSLATED_TERM MM T 2002-07-18-18.20.12.052001


Tables Created with dyk_dm_dbinstPlease verify that the proper tables were created for the DYK schema

Table/View Schema Type Creation time------------------------------- --------------- ----- --------------------------COMPPATH DYK T 2002-07-18-18.22.12.645001DATA_EXP DYK T 2002-07-18-18.22.13.346000EVALUATOR_TABLE DYK T 2002-07-18-18.22.12.985001EXP_LOG DYK T 2002-07-18-18.22.13.446001


EXTRACT_LOG DYK T 2002-07-18-18.22.12.755001MSMT_AVL DYK T 2002-07-18-18.22.12.304000MSMT_MMA DYK T 2002-07-18-18.22.11.613001MSMT_TOT DYK T 2002-07-18-18.22.11.974001SCHEMA_VER DYK T 2002-07-18-18.22.11.233001STAGE_MSMT DYK T 2002-07-18-18.22.11.333001


Appendix C. Database Creation Tables 161

Appendix D. Manually Creating ODBC Data Sources

IBM Tivoli Service Level Advisor provides scripts to automatically create ODBCdata sources for the SLM Database and the SLM Measurement Data Mart (see“Configuring ODBC Data Sources” on page 64). If you do not want to use theautomated scripts to create ODBC data sources, you can create them manually bydoing the following:1. Select Start –> Settings –> Control Panel and then:

v For Windows NT, select Data Sources (ODBC)

v For Windows 2000, select Administrative Tools –> Data Sources (ODBC)

2. Select the System DSN tab.3. Click Add....4. From the list of drivers, select IBM DB2 ODBC Driver and click Finish.5. Enter the name of the data source that you are defining. Table 15 shows the

data source names for the Tivoli Enterprise Data Warehouse database and theSLM databases.

Note: The installation procedure for Tivoli Enterprise Data Warehouse mayalready have configured the ODBC datasource for Tivoli Enterprise DataWarehouse. If not, then include that database in this procedure.

Table 15. Databases and their data source and alias names

Database Data Source Name Data Source Alias

Tivoli Enterprise DataWarehouse

twh_cdw twh_cdw

SLM Database dyk_cat dyk_cat


dyk_dm dyk_dm

6. If the actual database is on the same machine as the machine on which you areconfiguring the data source, or if it has been defined previously for a differentdata source, then select the alias from the drop-down list and click OK. Youcan use the same name for the alias as the data source name, as shown inTable 15.

7. If the database resides on a machine other than the machine on which you aredefining the ODBC data source, and is not in the drop-down list, do thefollowing:a. Enter the data source name and click Add.... The Add Database Wizard is

launched.b. Select Manually configure a connection to a database and click Next.c. Select TCP/IP as the protocol and click Next.d. Enter the fully qualified host name where the database resides and enter the

port number (typically 50000 for DB2), and click Next.e. Enter the database name (the alias will automatically be filled in) and click

Finish.

The data source is now defined. Repeat this procedure for each data source (seeTable 15) that you are defining.

163

Appendix E. Migrating From Previous Versions of IBM TivoliService Level Advisor

If you have a previous installation of IBM Tivoli Service Level Advisor, there are anumber of tasks you will need to complete to migrate your SLM Solutionenvironment to be compatible with IBM Tivoli Service Level Advisor version 1.2.

The general procedure for migrating the SLM Solution to Version 1.2 includes thefollowing:1. Prepare the environment to run the IBM Tivoli Service Level Advisor migration

program2. Run the IBM Tivoli Service Level Advisor migration program, which is

included in the normal IBM Tivoli Service Level Advisor install program3. Complete additional migration tasks after running the IBM Tivoli Service Level

Advisor migration program

In addition to upgrading the various components of IBM Tivoli Service LevelAdvisor to the latest levels, updates need to be made to the DB2 database support,a fix pack for Tivoli Enterprise Data Warehouse must be installed, and updates toWebSphere Application Server might be required. Table 16 shows a comparison ofthe SLM Solution environments between IBM Tivoli Service Level Advisor version1.1 and version 1.2. Refer to the IBM Tivoli Service Level Advisor Release Notes forinformation on specific supported versions of these applications.

Note: If you are migrating from an environment with IBM Tivoli Service LevelAdvisor Fix Pack 1 installed (represented here as Version 1.1.1), theenvironment will already have been updated with Tivoli Enterprise DataWarehouse Fix Pack 1 and DB2 7.2 Fix Pack 6, so these tasks do not need tobe performed again.

Table 16. Comparison of SLM Solution environments between Version 1.1 and version 1.2

SLM SolutionComponent

IBM Tivoli Service Level Advisor

Version 1.1 (or 1.1.1)


Version 1.2

Hardwareplatforms

There is no change to hardware platform support due to migrating theSLM Solution to IBM Tivoli Service Level Advisor. See the IBM TivoliService Level Advisor Release Notes for details on supported hardwareplatforms.

Operating Systemplatforms

There is no change to operating system platform support due tomigrating the SLM Solution to IBM Tivoli Service Level Advisor. Seethe IBM Tivoli Service Level Advisor Release Notes for details onsupported operating systems.

IBM DB2UniversalDatabaseEnterprise Edition

DB2 7.2 with Fix Pack 5Note: Version 1.1.1 alreadyincludes upgrading to DB2 7.2 FixPack 6.

DB2 7.2 with Fix Pack 6. Note thatin a distributed environment, allmachines with SLM Solutioncomponents must be upgraded tothe same level of DB2 and FixPack.

165

Table 16. Comparison of SLM Solution environments between Version 1.1 and version1.2 (continued)





Version 1.2

Tivoli EnterpriseData Warehouse

Version 1.1.0 base installationNote: Version 1.1.1 of IBM TivoliService Level Advisor alreadyincludes upgrading to TivoliEnterprise Data Warehouse FixPack 1.

Version 1.1.0 base installation plusFix Pack 1

WebSphereApplication Server

Advanced Edition Single-server(AES)

Advanced Edition (AE)

Standard Edition (SE) 3.5

Advanced Edition Single-server(AES)

Advanced Edition (AE)

(Standard Edition is no longersupported for this release. Usersmust upgrade to AE or AESversions.)

SourceApplicationWarehouse Packs

There is no impact to installed source application warehouse packswhen IBM Tivoli Service Level Advisor is migrated to version 1.2.

IBM Tivoli ServiceLevel AdvisorDYK WarehousePack (Target ETLs)

Version 1.1 DYK Registration andProcess ETLs

Version 1.2 DYK Registration andProcess ETLs (will need touninstall previous version andinstall the new version)

SLM Database andSLM MeasurementData Mart

Version 1.1 of these databases Database tables and formats willbe automatically updated toversion 1.2 by the IBM TivoliService Level Advisor migrationprocess.

SLM Server Version 1.1 of this component This component is automaticallyupdated to version 1.2 by the IBMTivoli Service Level Advisormigration process. For distributedinstallations, this component mustbe upgraded before SLM Reportsand SLM Task Drivers.

SLM Reports Version 1.1 of this component This component is automaticallyupdated to version 1.2 by the IBMTivoli Service Level Advisormigration process. If usingWebSphere AE, users mustreintegrate SLM Reports manually.

SLM Task Drivers Version 1.1 of this component This component is automaticallyupdated to version 1.2 by the IBMTivoli Service Level Advisormigration process. TivoliPresentation Services for the IBMConsole is upgraded during theinstall of the Tivoli EnterpriseData Warehouse Fix Pack 1.


Table 16. Comparison of SLM Solution environments between Version 1.1 and version1.2 (continued)





Version 1.2

User customizedFiles

Version 1.1 of these files:

v slm.rls file for TEC Eventnotification

v SNMP Trap formats

v SLM Report customized JSPfiles for reports

During the IBM Tivoli ServiceLevel Advisor migration process,these files are copied andrenamed. Users will need tocustomize the version 1.2 filesagain to maintain customization,referring to the renamed files asneeded.

For the SNMP trap formats, youmust run scripts to uninstall the1.1 version and install the 1.2version.

Message and tracelogs

Log files are located in variousplaces in the SLM Solutionenvironment

Log files are located in the TivoliCommon Directory. Log files fromVersion 1.1 remain in their currentlocation

Language Pack Optionally installed at version 1.1level

If used, version 1.1 must beuninstalled before version 1.2 isinstalled.Note: Some files from version 1.1may need to be removedmanually. See step 7 on page 168.

In performing the migration of your SLM Solution environment to version 1.2, theassumption is made that there are no changes to the distribution of TivoliEnterprise Data Warehouse or IBM Tivoli Service Level Advisor components. Allcomponents in the current environment are expected to remain on their existingmachines in the version 1.2 environment. If you choose to uninstall existingcomponents and reinstall them on different machines in your enterprise, forexample, to consolidate components onto fewer machines, or to distributecomponents on additional machines, then you should treat this as a newinstallation and follow the documented procedures for backing up and uninstallingthe existing environment, and installing the new distributed environment as a newinstallation.

Tasks to Complete Before Migrating IBM Tivoli Service Level AdvisorBefore running the IBM Tivoli Service Level Advisor install program to performthe migration of IBM Tivoli Service Level Advisor components to version 1.2,complete the following tasks:1. Backup the entire SLM Solution, using the documented procedures. This

includes backing up and saving any customized files you may have, for eventnotification or SLM Report customization of JSP files. Refer to the backupprocedures in the Administrator’s Guide for IBM Tivoli Service Level Advisor andInstalling and Configuring Tivoli Enterprise Data Warehouse.

2. Verify that you have enough temporary disk space. The IBM Tivoli ServiceLevel Advisor install program uses approximately 300Kb of space under%TEMP% on Windows, or under /tmp on UNIX machines.

Appendix E. Migrating From Previous Versions of IBM Tivoli Service Level Advisor 167

3. Shut down the SLM Server and WebSphere Application Server usingdocumented procedures (see “Shutting Down the IBM Tivoli Service LevelAdvisor Solution” on page 107)

4. Install DB2 7.2 Fix Pack 6 on all DB2 Server and DB2 Client machines in thedistributed SLM Solution, using the documented procedure in “Step 7. Upgradeto DB2 7.2 Fix Pack 6” on page 36.

Note: If you are migrating from IBM Tivoli Service Level Advisor with FixPack 1, this step should have already been completed. You can check theversion of DB2 installed by starting a DB2 command prompt and issuingthe db2level command. See Table 5 on page 33 for version information.

5. Install Tivoli Enterprise Data Warehouse Fix Pack 1. Refer to the TivoliEnterprise Data Warehouse Fix Pack 1 Readme and the Tivoli Enterprise DataWarehouse support Web site for more information.

Note: If you are migrating from IBM Tivoli Service Level Advisor with FixPack 1, this step should have already been completed.

6. Verify that the DYK Target ETLs are taken out of production mode, anduninstall them from the Tivoli Enterprise Data Warehouse control server,following the documented procedure. See “Uninstalling the Registration andProcess ETLs” on page 115 for more information.

7. If you have a language pack installed, it must be uninstalled. See “UninstallingLanguage Support” on page 115 for more information.After uninstalling version 1.1 of the language pack, several files may still needto be uninstalled manually (note that these should not simply be deleted),before running the migration program and installing version 1.2 of thelanguage pack.Examine the <PS_Dir>/cd directory for the following files that may not havebeen uninstalled, where <PS_Dir> is the where the IBM Console Server wasinstalled:TSLMResources_ko.jar

[email protected]

To remove these files from your system, do the following:a. Navigate to the following directory:

v For Windows, navigate to <PS_Dir>\bin\private\w32-ix86

v For UNIX, navigate to <PS_Dir>/bin/private/generic_unix

b. Run the following command, where <filename> is the name of the file to beremoved:wcmd cds uninstall <filename>

c. Repeat the above command for each file to be removed.d. Stop the Web Services for IBM Consolee. Stop and then restart the Server for IBM Consolef. Restart Web Services for IBM Console

After completing the above steps, check <PS_Dir>/cd again and verify that thefiles have been removed before continuing with the migration process. SeeChapter 6, “Startup and Shutdown Procedures” on page 103 for information onstarting and stopping IBM Console services.

8. If your environment uses WebSphere Advanced Edition (AE), remove SLMReports version 1.1 from WebSphere, following the documented procedure (see


“Removing SLM Reports from the WebSphere Environment” on page 112 formore information). If you are using WebSphere AES, this step is not necessary.

9. If your environment uses WebSphere Application Server Standard Edition (SE),you must remove SLM Reports version 1.1 and then upgrade it to eitherWebSphere Advanced Edition (AE) or WebSphere Advanced EditionSingle-server (AES).To remove SLM Reports 1.1 from WebSphere Application Server SE, do thefollowing:a. Start the IBM WebSphere Admin Server:

v For Windows, you can do any one of the following:– Select Start –> Programs –> IBM WebSphere –> Application Server

V3.5 –> Start Admin Server

– From the Services control panel (Start –> Settings –> Control Panel –>Services), right-click on IBM WS AdminServer and select Start fromthe context menu

– From a command prompt, issue the command:net start "IBM WS AdminServer"

v For UNIX, do the following:1) Verify that you are running as the root user2) From a command prompt, navigate to the directory

<WebSphere_Dir>/AppServer/bin, where <WebSphere_Dir> is thedirectory where WebSphere was installed, and run the followingcommand:./startupServer.sh

b. Open the Administrator’s Console by selecting Start –> Programs –> IBMWebSphere –> Application Server V3.5 –> Administrator’s Console

c. Verify that the application server is not running (indicated by a blue circlebeside the Default Server)

d. Highlight the SLMReport application server, then right-click and selectRemove from the context menu.

Refer to the official WebSphere support Web site for product downloads,installation and upgrade information for the supported versions of WebSphereApplication Server.

Note: If you have any customized JSP files for SLM Reports, these files shouldhave already been manually backed up during the documented backupprocedure for IBM Tivoli Service Level Advisor.

Running the IBM Tivoli Service Level Advisor Migration ProgramAfter you have completed the steps in the previous section, you should be ready torun the IBM Tivoli Service Level Advisor install program to perform the migrationof the components of IBM Tivoli Service Level Advisor to version 1.2.

If you have SLM components (the SLM Server, SLM Reports, and SLM TaskDrivers, the SLM Database and the SLM Measurement Data Mart) installed onmultiple machines, or in multiple directories, you must run this install program oneach machine and for each directory that contains an SLM component.

Note: For a distributed installation of IBM Tivoli Service Level Advisor, migratethe SLM Server component before migrating the SLM Reports or SLM Task


Drivers components, and verify that migration of the SLM databases wascompleted successfully before you attempt to use the migrated version ofIBM Tivoli Service Level Advisor.

To perform the migration of IBM Tivoli Service Level Advisor components usingthe install program, complete the following steps:1. Start the IBM Tivoli Service Level Advisor install program as if you were

performing a new installation (see “Step 1. Start the InstallShield Program” onpage 66). Only those install dialogs needed for migration will be displayed.

2. When prompted, enter the directory where one or more SLM components areinstalled on this machine. The installation program will then determine whichcomponents are installed in that directory on this machine, and will performthe migration on them.The install program performs the following migration tasks:v Determines which components are installed locally, and automatically

migrates them to version 1.2v Creates the Tivoli Common Directory if not already created. Log files for

version 1.2 are stored in the Tivoli Common Directory under the \DYKsubdirectory for IBM Tivoli Service Level Advisor.

v The SLM Database and SLM Measurement Data Mart are automaticallymigrated to version 1.2

Note: If any errors are encountered during database migration, messageswill be written to the stderr log, and the databases will remainunchanged at their version 1.1 level to preserve existing data. Themigration of other SLM components will continue, but you will needto complete the migration of the databases manually.

v If you are using WebSphere AES, the SLM Reports for version 1.2 areautomatically integrated into WebSphere. If you are using WebSphere AE,you will need to manually integrate SLM Reports into WebSphere.

v Passwords that were stored in the database for version 1.1 are encrypted.v Files that were located in the <SLM_Install_Dir>/tec directory for IBM Tivoli

Service Level Advisor version 1.1 are moved to<SLM_Install_Dir>/escalate for version 1.2. These files include theslm.baroc file and slm.rls file (which is renamed to slm.rls.bak). Wherepossible, the install program will remove the /tec directory.

v During the migration, the rebuilding of the online help information takesplace, which may cause the SLM Task Drivers component to install slowly.The rebuilding of the help information files might take up to an hour ormore to complete.

Follow the rest of the install program prompts and complete the migration of IBMTivoli Service Level Advisor. Repeat this procedure for each machine in yourdistributed environment as needed.

Tasks to Complete After Migrating IBM Tivoli Service Level AdvisorAfter running the IBM Tivoli Service Level Advisor install program to migrateSLM components to version 1.2, do the following to complete the migrationprocedure:1. Immediately after running the migration program for the SLM Server

component, you must verify that the migration of the SLM databases


completed successfully. You can check the status of the database migration byexamining the following log files, located in the \DYK subdirectory of the TivoliCommon Directory:\logs\install\sladbupdateOut.log

\logs\install\sladbupdateErr.log

These log files contain the DB2 output and error messages from the SLMdatabase migration, and there will be many messages in thesladbupdateOut.log file. You can identify error messages by the DB2 messageID in the format of SQLxxxxN, followed by the specific message text, forexample:SQL1403N The username and/or password supplied is incorrect. SQLSTATE=08004

Messages with a DB2 message ID in the form of SQLxxxxW indicates normalmigration activity and does not indicate a migration failure.

If the database migration failed, correct any errors that you find in the logs,then start up a DB2 command prompt (see “Starting a DB2 Command Prompt”on page 30), navigate to the<SLM_Install_Dir>/bin

directory, where <SLM_Install_Dir> is the location where IBM Tivoli ServiceLevel Advisor was installed, and run the following database migration scriptbefore continuing:v For Windows:

sladbupdate.bat

v For UNIX:./sladbupdate.sh

Check the logs again to verify that database migration was successful beforecontinuing.

2. Install the DYK warehouse pack for IBM Tivoli Service Level Advisor version1.2, using the Tivoli Enterprise Data Warehouse installation program asdocumented in “Installing the Registration and Process ETLs” on page 90.

3. If your environment uses WebSphere Advanced Edition (AE), you mustmanually integrate SLM Reports into WebSphere, using the procedure in“Integrating into WebSphere AE” on page 95.

4. If you had customized JSP files, be sure to also re-customize JSP files forversion 1.2, referring to the version 1.1 JSP files that you have backed up asneeded. When you complete these steps, restart the WebSphere ApplicationServer.

5. If you had configured for event notification using SNMP traps, you mustremove the traps formatted for version 1.1 and install the traps formatted forversion 1.2. See “Configuring for Notification by SNMP” on page 89 for details.

6. If you had configured for event notification using Tivoli Enterprise ConsoleEvents, files that were located in the <SLM_Install_Dir>/tec directory for IBMTivoli Service Level Advisor version 1.1 have been moved to<SLM_Install_Dir>/escalate for version 1.2. These include the slm.baroc file

and slm.rls file (which is renamed to slm.rls.bak). For version 1.2, new slotshave been added to the SLA-Trend-Event and SLA-Trend-Cancel-Event classdefinition (see the slm.baroc file for information on the events class definition).


If you had customized slm.rls for version 1.1, you should refer to slm.rls.bakand the class definition information in slm.baroc to re-customize your slm.rlsfile for version 1.2 before applying it.

7. Install any language packs needed for version 1.2, following the documentedinstallation procedure in “Installing Language Support” on page 100

If you experience problems during migration, check the log files located in the\DYK subdirectory of the Tivoli Common Directory, and see Chapter 8,“Troubleshooting” on page 117 for assistance.


Index

Special characters%Program Files% 69

Aapplication package

warehouse pack, installing 50

Bback office layer 3backup and restore

for distribute SLM deployment 18breach value 5

CCD, mounting on UNIX 33central data repository 1, 5central data warehouse 8, 12centralized repository 3classpath 59CLI viii

specifying password protection 77specifying port 77

CLI port numbers 66client.encoding.overide, configure for

WebSphere 54command line interface viii

password protection 77port, specifying 77

command prompt, starting onWindows 30

communicationCLI port numbers 66server port numbers 66

component 7configuring event notification

methods 85considerations

deployment 15control server 8, 11, 39customer support x

contacting xcustomers, managing 13

Ddata

measurement from warehouse to SLMDatabase 6

purging aged, from SLMMeasurement Data Mart 95

data collectionenabling 91, 92

data collector 2data mart 8data model 12, 39data warehouse center 15, 39

Data Warehouse Center 7, 8, 39importing etl 91

databaseconfiguration parameters 61, 62connections, verifying 66creating 63creating on Linux 60creating SLM 60creation tables 159default names 75deployment 15log files 62logs and tables 64ODBC datasource, uninstall 114other applications, coexisting with 20script 63SLM Measurement Data Mart 6source and target for etl 92specifying information 73uninstalling 114verifying connection 76verifying creation 159

database parametersapplheapsz 62, 63logfilsiz 62, 63logprimary 62, 63logsecond 62, 63maxagents 62, 63maxappls 62, 63numdb 62, 63

database scripts 60databases 5

planning 14DB2 vii, 1

checking version of 33coexisting with other applications 20command prompt, starting 30documentation viiidocuments viiiextended shared memory,

configuring 38installing 29, 33troubleshooting 117verifying the install 36

DB2 client 35SLM Server 13SLM Task Drivers 13

DB2 ClientSLM Reports 13

DB2 instance 12multiple 35planning 14specifying home directory 77

DB2, installing 30db2java.zip 59db2level 33db2profile

sourcing on UNIX 59db2profile, sourcing 30default database names 75

deploymentmid-sized 16minimum 15options 15SLM options on one machine 15widely distributed 15

destination install directory 69distributed installation

SLM solution 4documentation

tsladocs directory viiWebSphere ix

documentsaccessing online ixDB2 viiifeedback xprerequisite viirelated vii

dyk_cat 20, 75, 159dyk_cat_dbinst 60, 63, 75

tables created with 159dyk_cat_odbc script 64dyk_dm 20, 75, 159dyk_dm_dbinst 60, 63, 75

tables created with 160dyk_dm_odbc script 64dyk_messages.html viii

Ee-mail 81e-mail notification 78e-mail notification, verifying 90enabling source application 90environment variables

logflie_name 62notation for ixver_logfile_name 62

escalation methods 66etl 1

configuring user ID andpassword 92

importing 91importing into Data Warehouse

Center 91installing source 52installing target 90odbc datasources 64promote to production mode 93promoting to production mode 91running 94scheduling to run 93source and target 15troubleshooting install 123

ETL 9target, installing 90uninstall 115

etl, registration 11etl, source and target 11etl,process 11evaluation 4, 5, 6, 13

173

evaluations 2event escalation 66event notification 78

configuring 85configuring TEC event 89e-mail 81SNMP trap 79TEC event 80verifying 90

extended shared memoryconfigure for DB2 38

Ffix pack 34, 36, 52fix packs 29fully qualified

node name in WebSphere 73fully qualified names

resolving host names 60

Hhelp

online, building after install 51help files

rebuilding after install 86help set

build during install 51home directory

specifying DB2 instance 77host name

fully qualified, ensuring 31host names

resolving to fully qualified 60HTTP 4

port conflict with Websphere 15HTTP server 12HTTP Server

starting 107stopping 108

IIBM Console viii, 4, 5, 39

desktop icon 105help viiiJava and Web versions 12Java version 105starting 105stopping 109

IBM Console Server 7IBM DB2 vii, viii, 1IBM HTTP Server


IBM Tivoli Monitoring for TransactionPerformance 2

IBM Tivoli Service Level Advisorcomponents 7components of 9installing 59overview 2publication CD viitroubleshooting install 120

IBM WebSphere vii, ix, 1

installadditional tasks 89, 90configuring for event notification 89

NetView 89SNMP 89

gathering information 21prerequisites 29Tivoli Presentation Services 44Tivoli Presentation Services,

verifying 51verifying DB2 36warehouse pack for target ETLs 90

installationoverview 65planning 7

installingcompleting the install 85DB2 30, 33IBM Tivoli Service Level Advisor 59incrementally 65incrementally, SLM options 60language support 100process etl 90quick start 129, 143

control center 150DB2 client 132, 147etl, configuring 141, 157JDBC driver for WebSphere 136,

152ODBC data sources 137, 153SLM databases 136, 152SLM etl 133, 156SLM Reports 137, 154SLM Server 137, 154SLM Task Drivers 139, 155warehouse 133, 156warehouse report interface 150warehouse, populating 141, 157WebSphere 134, 151

quick start,DB2 131, 145registration etl 90running 66sample warehouse data 142, 158selecting SLM options 70SLM databases 35SLM Reports 59source etl 52specifying destination directory 69specifying SLM database

information 73Tivoli Enterprise Data Warehouse 39Tivoli Enterprise Data

Warehouse,report interface 39Tivoli Presentation Services 39warehouse enablement pack 141, 157WebSphere 53

Interner Explorer 13Internet Explorer 3

JJava resource bundles 100Java Server Pages viiJava servlets 1JavaServer Pages 4JDBC

configuring for WebSphere 56

JDBC (continued)updating level 37

JDBC leveltroubleshooting 118

JSP files vii, 4

Llanguage support

installing 100uninstalling 115

levels of serviceguaranteed 2

license agreement 67log

traceTSLA1.2Install 66, 85, 127traceTSLA1.2LPInstall 101traceTSLA1.2LPUninstall 115tslminstall 66

loggingfor distributed SLM deployment 18

logs 12

Mmemory

extended shared, configure forDB2 38

messageshtml file viii

migration 29, 59, 165

NNetscape 3, 13NetView

event notification, configuringSNMP 89

node nameidentifying in WebSphere 58specified by WebSphere 66specifying in WebSphere 73

Oodbc data source

configuring 64ODBC data source

manually creating 163ODBC data sources 92

troubleshooting 118ODBC datasource

verifying creation 118ODBC datasource, uninstalling 114offering,stored in SLM Database 6offerings

creating 5online help viii

building 51rebuilding after install 86

online publicationsaccessing ix

order,stored in SLM Database 6orders 13

creating 5


Ppassword protection

CLI commands 77planning

databases 14DB2 instances 14Tivoli Enterprise Data Warehouse 12WebSphere 13worksheets 21

portCLI 77conflict, resolving 44conflicts, resolving 40modifying for WebSphere 99SLM server 77

port conflict 15port numbers

command line interface 66server communication 66

port numbers, selecting 18prerequisite documents viiPresentation Services 71process etl 11

configuring odbc datasources 64installing 90scheduling 93source and target database 92

production modepromoting etl 91, 93

publication CDIBM Tivoli Service Level Advisor vii

publicationsaccessing online ixDB2 viiifeedback xprerequisite viiproviding feedback xrelated viiTivoli Enterprise Data

Warehouse viiipurging aged data 95

Rregistration etl 11

configuring odbc datasources 64installing 90scheduling 93source and target database 92

reinstalling 59related documents viireport interface 8report servlets 4reports 2, 5restoring

SLM Reports and WebSphere 112SLM Server 59

role-based user interface 12root

user authority, verifying forinstall 31

user, on UNIX 60

Sschedule 5, 13

data collection 4etl to run 93

schema 12, 39scmd viii

escalate configure 85escalate testscmd

escalate enable 90etl addApplicationData 91, 92etl disable 92etl enable 91, 92etl getApps 92

Server for IBM Console 12starting 103stopping 110

service level agreement vii, 2service level management 4service level objective 6service transaction 2shutdown 103SLA vii, 2, 4, 6SLA results 5SLA results, stored in SLM Database 6SLM class definition file 89SLM database

troubleshooting 119SLM Database 5, 6, 9, 14

creating 60install 35install information 73

SLM database server 7SLM databases 5

creating 60DB2 instance home directory 77specifying information 73

SLM Measurement Data Mart 5, 6, 9, 14creating 60install 35install information 73purging aged data 95

SLM reports 1SLM Reports 4, 5, 7, 9, 13, 70

accessing 99customer, executive, operations

users 99default user names 99deployment with WebSphere 15installing 59integrating into WebSphere 53, 55,

59, 95integrating into WebSphere AE 95integrating into WebSphere AES 98node name in WebSphere 58removing from WebSphere 112specifying WebSphere location 72troubleshooting 123, 126uninstall,complete 113uninstalling 112

SLM Server 4, 7, 9, 13, 70communication port 77, 78configuring 77home directory on UNIX 77overview 4restoring 59starting 104stopping 109

SLM Server (continued)uninstalling 113

SLM solution 1distributed installation 4

SLM solution, deploying 10SLM Task Drivers 4, 5, 9, 12, 70

deployment 15distributed install 78troubleshooting 122

SLM Task Drivers,uninstalling 111slm.baroc 89slm.rls 89slmenv 100SLO 6SNMP

event notification, configuring 89SNMP trap 78, 79SNMP trap notification, verifying 90Solaris

installing Java patches 60source application

enabling 90enabling for data collection 91, 92

source application,installing warehouseenablement pack 52

source applications 2, 3writing data to warehouse 2

source databases 3source ETL 9sourcing the db2profile 30starting

IBM Console 105IBM HTTP Server 107Server for IBM Console 103SLM Server 104SLM solution 103Web Services for IBM Console 104WebSphere Admin Server 107WebSphere Administrator’s

Console 107WebSphere Application Server 106

startup 103troubleshooting 124

stoppingIBM Console 109IBM HTTP Server 108Server for IBM Console 110SLM Server 109SLM Solution 107Web Services for IBM Console 109WebSphere Admin Server 108WebSphere Application Server 108

supportcontacting x

Ttarget ETL 9Task Assistant viiitask drivers 12TEC event 78, 80

notification, configuring 89TEC event notification, verifying 90TEC rule file 89tedwdocs viiiTivoli

source applications 2

Index 175

Tivoli Common Directory 68Tivoli Customer Support x

contacting xTivoli Enterprise Console event 78Tivoli Enterprise Data Warehouse 1, 2,

5, 7central data warehouse 8control server 8, 11data mart 8documentation viiiimporting etl 91installing 29report interface 8

Tivoli Presentation Services 71install, verifying 51installing 39, 44

Tivoli Web Services Manager 2traceTSLA1.2Install log 127traceTSLA1.2Install.log 66, 85traceTSLA1.2LPInstall log 101traceTSLA1.2LPUninstall log 115tracing 12trend

event notification 78notifying 66

trend analysis 5, 6, 13trends 2, 4, 5, 13troubleshooting 117

blank install window 120cleanup temporary ISMP

directories 121connecting to SLM Databases 121data warehouse center 123database creation scripts 119DYKAL3003E message 126DYKIN0028E at end of install

wizard 121etl install and configuration 123etl installation 123fully qualified host name 124HTTP 500 error 126IBM Console, sign in 126IBM Console, starting 122IIS Service, SLM Reports 123incomplete text 120install screen fonts unreadable 120installing DB2 117installing IBM Tivoli Service Level

Advisor 120instance creation 117JDBC level, updating manually 38ODBC data sources 118server host name 124service exception 122SLM Database connection 125SLM database creation 119SLM Reports 123, 126SLM Reports install fail 123SLM Server startup 125SLM Task Drivers 122system startup 124uninstalling 128UNIX DB2 install 117updating JDBC level 118verifying JDBC level 38

tslminstall log 66twh_cdw 20

twh_mart 20twh_md 20typeface conventions ix

Uuninstall

database 114ETL 115ODBC datasource 114

uninstalling 111language support 115SLM Reports 112SLM Reports, complete 113SLM Server 113SLM Task Drivers 111troubleshooting 128WebSphere AES 4.0.1 113

uninstalling previous versions 59UNIX

root user 31sourcing the db2profile 30

updating JDBC level 37user assistance viii

building after install 51rebuilding files after installation 86

UTF-8, configure for WebSphere 54

Vverifying

event notification method 90version

checking DB2 33violation

event notification 78notifying 66

violations 2, 4, 5, 13

Wwarehouse 3

agent 8configure user IDs for source and

target databases 92logger 8moving data via ETL 1server 8warehouse pack 9

warehouse enablement pack 1, 11installing 52, 91, 141, 157

warehouse pack 9installing (application packages) 50planning for install 28target ETLs, installing 90

warehouse sample data, installing 142,158

Web application server 3web browser 13

Internet Explorer 3Netscape 3

Web browser connections 12Web Services for IBM Console 12


Websphererestarting 99

WebSphere vii, 1, 5auto starting 57configuring JDBC driver 56documentation ixenvironment, configure 54installed version 66installing 29, 53integrating SLM Reports 59, 95integrating SLM Reports into 55node name 58node name, specifying 73planning 13port conflict with HTTP 15ports, modifying 99removing SLM Reports 112specifying install location 72uninstalling, AES 4.0.1 113upgrading to 4.0.2 56

WebSphere Admin Serverstarting 107stopping 108

WebSphere Administrator’s Consolestarting 107

WebSphere AEintegrating SLM Reports 95

WebSphere AESintegrating SLM Reports 98

WebSphere Application Serverstarting 106stopping 108

Windowsadministrator privilege 60command prompt, starting 30


Printed in U.S.A.

SC32-0834-01

getting started with ibm tivoli service level...

Documents