Tivoli Business Systems Manager

Tioli Business Systems Manager Version 3.1 Installation and Configuration Guide SC32-9089-00

Tioli Business Systems Manager Version 3.1 Installation and Configuration Guide SC32-9089-00

Note Before using this information and the product it supports, read the information in Notices on page 321. First edition (October 2004) This edition applies to Version 3, Release 1 of IBM Tioli Business Systems Manager and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2000, 2004. All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents About this guide........... xi Publications..............xi IBM Tioli Business Systems Manager library..xi Related publications.......... xii Accessing publications online....... xii Ordering publications.......... xiii Accessibility.............. xiii Tioli technical training.......... xiii Support information........... xiii Participating in newsgroups........ xi Conentions used in this guide....... xi Typeface conentions.......... xi Operating system-dependent ariables and paths x Terminology..............x Part 1. Specifications and Requirements........... 1 Chapter 1. Serer and Console Specifications............ 3 Installation CDs.............3 Tioli Business Systems Manager Components...4 Required Components..........4 Optional Components..........7 Consoles...............7 Prerequisite Software...........7 Serer Specifications............8 Database Serer............8 Console Serer.............9 Eent Handler Serer (optional)......10 History Serer (optional).........11 Host Integration Serer (optional)...... 11 Health Monitor Serer (optional)......12 Health Monitor Client Specifications.....12 Console Specifications...........13 Tioli Business Systems Manager Console...13 Web Console Specifications........14 Executie Dashboard Specifications.....14 Eent Enablement Specifications.......15 Recommended Configurations........15 Alternate Two Serer Configuration for Tioli Business Systems Manager, Enterprise edition.. 16 Serer Test/Quality Assurance Systems.....17 Hardware and Software Requirements....18 Chapter 2. Data Source Specifications 19 z/os Data Source Software Requirements....19 Distributed Data Sources Software Requirements..20 External Data Interface Supported Leels....22 Part 2. Installing Tioli Business Systems Manager......... 23 Chapter 3. Installation Oeriew.... 25 Installation Considerations.........25 Installation Checklist...........26 Installing Base Serices.........26 Installing the Console..........28 Switching from LocalOS User Registry to LightWeight Directory Access Protocol....29 Chapter 4. Installing Prerequisite Software.............. 31 MKS Toolkit..............31 Microsoft SQL Serer...........31 SQL Serer 2000 Enterprise Edition.....32 Installing SQL Serer 2000 Enterprise Edition 32 Installing SQL Serer 2000 Serice Pack 3a..33 Disabling Selected SQL Serer 2000 Query Analyzer Options..........34 Configuring SQL Serer........34 Installing SQL Serer 2000 Client Tools....35 Installation............35 Disabling Selected SQL Serer 2000 Query Analyzer Options..........35 Host Integration Serer Client........36 Installing the Host Integration Serer Client..36 Configuring the Host Integration Serer Client 36 Chapter 5. Installing and Configuring Base Serices........... 39 The Database Serer...........39 Prerequisites.............39 Installation.............39 Verification.............41 Configuring the Database Serer......42 The Console Serer............42 Prerequisites.............42 Installation.............42 Verification.............45 Configuration............45 Configuring WebSphere Application Serer to use LDAP.............46 The Eent Handler Serer.........48 Prerequisites.............48 Installation.............48 Verification.............49 Configuration............49 Running the makemscomponents command 49 Configuring the ASITECListenerSc Serice.50 Chapter 6. Installing Consoles.... 51 Tioli Business Systems Manager Console....51 Installing the Console..........51 Distributing the Console in a Tioli Management Enironment.............52 Silently Installing the Console.......52 Copyright IBM Corp. 2000, 2004 iii

Uninstalling the Console.........52 Web Console..............52 Executie Dashboard...........53 Chapter 7. Optional Components... 55 Host Integration Serer..........55 Host Integration Serer Security......55 Installing LU6.2 Support.........56 Configuring SNA Serices Using PU2.1 Node 56 Installing the Host Integration Serer....57 Validating LU6.2 Support.........62 Configuring Communication Serices.....63 Installing Eent Handler Serer (Configuration 1)..........63 Installing Eent Handler Serer (Configuration 2)..........64 Installing Eent Handler Serer Using IP Communication Serices.........65 Adding Additional Operating Systems....66 IP Communication Support.......67 The History Serer............67 Prerequisites.............68 Installation.............68 Configuring SQL on the History Serer....69 History Serer Setup..........70 Moing Data from the Database Serer to the History Serer............71 Description of the History BCP Jobs.....71 History Serer Jobs..........72 Database Serer Jobs.........73 Configuring the Reporting System.......74 Adding Report Users..........74 Local OS Authentication........74 LDAP Authentication.........75 Reporting System User Authentication....75 History Serer Web Application Image Folder Access...............77 Installing the Reporting System on Windows Serer 2003.............77 Health Monitor.............78 Installing the Health Monitor Serer.....78 Verification.............80 Configuring the Health Monitor Serer....80 Configuring the Health Monitor Serice...80 Required Serices..........80 Using the SQL Query Analyzer to Configure Staged Eent Status.........82 Monitoring Database Queues......83 Installing the Health Monitor Client.....84 Common Listener............85 Configuring the Common Listener......85 CL_Options Table Properties........86 Agent Listener.............86 EIF Sender...............87 The Failoer Process...........88 Problem Management and Automatic Ticketing and Change Management...........88 Automated Business Systems........89 XML Toolkit..............89 Installing the XML Toolkit........89 Chapter 8. Installing and Configuring Source/390 Components....... 91 Install Tioli Business Systems Manager Components..............91 z/os Performance............91 Source/390 Address Spaces........91 Running Multiple Copies of Source/390 on a z/os Image.............91 Startup Parameter Considerations.......91 Source/390 Object Pump Startup Parameters..92 Source/390 Dataspace Startup Parameters...99 Source/390 Object Serer Startup Parameters 100 Common Parameters for LU6.2 and TCP/IP Interfaces............. 100 LU6.2 Interface........... 101 TCP/IP Interface.......... 101 Optional Parameters for TCP/IP Interface 102 Optional DD Names for the Source/390 Object Serer........... 104 Setting Parameters for Language Support.. 105 SNA Serices Definitions When Using SNA... 105 Source/390 Security........... 106 Defining an OMVS Segment....... 106 OPERCMDS Security Definition...... 108 Custom Version of the IRXANCHR Table.... 108 Source/390 Commands.......... 109 Bulk Discoery............. 109 Configuring the GTMAOPE0 Utility..... 109 Configuring the ASIMVSIPListenerSc Serice 111 Configuring Discoery Load SQL Serer Job.. 111 Chapter 9. Installing and Configuring z/os Data Sources......... 113 Tioli NetView for OS/390 and z/os.....113 1. Install Tioli Business Systems Manager Components.............114 2. Determine NetView for z/os Started Tasks 114 3. Customize eery NetView for z/os Started Task...............115 a. Update NetView for z/os Started Task JCL...............115 b. Configure NetView Parameter Members 115 c. Modify Security Settings for NetView.. 119 d. Define Program to Program Interface Connection............ 120 e. Define NETCONV Link....... 120 f. Reiew NetView Tuning Considerations 120 4. Customize Data Sources........ 122 a. IMS Data Source......... 122 b. DB2 Data Source......... 123 c. DB2 PM/PE Data Source....... 123 d. MainView Data Sources....... 123 e. ASG-TMON Data Sources...... 124 f. CICSPlex SM Data Source...... 124 g. Systems Automation V2.1 or V2.2 Data Source.............. 124 h. Coexistence Issues with SA and CICSPlex SM Data Sources.......... 124 5. Restart NetView.......... 126 i IBM Tioli Business Systems Manager: Installation and Configuration Guide

6. Continue with Data Source Installation and Customization Steps.......... 126 IMS................ 126 1. Install Tioli Business Systems Manager for IMS Components........... 126 2. Perform IMS Region Configuration for IMS Regions.............. 127 a. Install IMS AO Exit........ 127 b. Modify IMS Setup......... 129 3. Perform Initial Discoery (optional).... 130 4. Configure NetView Components..... 130 a. Configure NetView........ 130 5. Configure z/os Components (optional)... 130 a. Install the IHS$MPF exit....... 130 6. Modify Tioli Business Systems Manager Windows Settings........... 131 a. Configure SQL Serer Job...... 131 7. Restart NetView.......... 131 8. Verify Installation.......... 131 a. Verify Host Customization...... 131 b. Verify End-to-End Connectiity.... 131 c. Verify IMS Rediscoery....... 132 d. Verify IMS Eent Monitoring..... 132 e. Verify Poll Monitors........ 132 f. Verify Console Commands...... 132 9. Disable Logging of Eents Sent to the Tioli Business Systems Manager Pump PPI Receier. 132 DB2 Uniersal Database for z/os and OS/390, and DB2 Performance Monitor/Performance Expert.. 132 1. Install Tioli Business Systems Manager for DB2 components........... 133 2. Confirm z/os security configuration.... 133 3. Configure DB2 for each DB2 subsystem or data sharing group.......... 133 DB2 Security........... 134 4. Configure NetView Components..... 135 a. Configure NetView........ 135 b. Make the DB2 modules aailable to NetView............. 135 c. Additional steps for DB2 data sharing support............. 135 d. Additional steps for DB2 Version 8 support............. 136 5. Perform Initial Discoery (optional).... 136 6. Restart NetView.......... 136 7. Verify Installation.......... 136 a. Verify Host Customization...... 136 b. Verify End-to-End Connectiity.... 137 c. Verify DB2 Rediscoery....... 137 d. Verify DB2 Eent Monitoring..... 137 e. Verify Poll Monitors........ 137 f. Verify Console Commands...... 137 8. Disable Logging of Eents Sent to the Tioli Business Systems Manager Pump PPI Receier. 137 9. Configure DB2 Performance Monitor/Performance Expert....... 137 Automation.............. 138 NetView for z/os........... 138 System Automation for OS/390...... 139 1. Install Tioli Business Systems Manager Components............ 139 2. Customize System Automation for OS/390 140 3. Perform Initial Discoery (Optional)... 140 4. Configure NetView Components.... 140 5. Configure z/os components..... 141 6. Restart NetView......... 141 7. Verify installation......... 141 8. Disable Logging of Eents Sent to the Tioli Business Systems Manager Pump PPI Receier............. 142 OPS/MVS............. 142 AF/OPERATOR and Auto OPERATOR.... 143 Job Schedulers............. 143 Tioli Workload Scheduler for z/os..... 143 Installing Tioli Workload Scheduler for z/os.............. 143 Configuring Tioli Workload Scheduler for z/os.............. 144 Installing Unicenter CA-7........ 146 Configuring Unicenter CA-7...... 146 Installing ASG-Zeke.......... 151 Configuring ASG-Zeke........ 151 BMC CONTROL-M for OS/390...... 158 Installing BMC CONTROL-M for OS/390 158 Configuring BMC CONTROL-M for OS/390 159 IBM Tioli OMEGAMON XE for MVS, CICS, DB2 and IMS Using the OMEGAMON Classic Interface. 160 Defining Virtual 3270 Pool Terminals.... 160 Configuring LOGMODE Entries..... 161 Configuring the Source/390 Object Pump for IBM Tioli OMEGAMON XE....... 161 Configuring Tioli OMEGAMON XE for MVS, CICS, DB2 and IMS Using the OMEGAMON Classic Interface........... 161 Setting Exceptions and Creating the Tioli OMEGAMON Profile......... 162 Resource Management Facility....... 163 Configuring Resource Measurement Facility.. 163 Source/390 Object Pump Startup Parameters 163 CICSPlex System Manager......... 163 Installing CICSPlex System Manager.... 164 Configuring CICSPlex System Manager... 164 Configuring NetView Components.... 164 Configuring CICSPlex SM Resources... 164 Defining System Aailability Monitoring Alerts.............. 165 Defining MAS Resource Monitoring Alerts 166 Sample Alert Definitions....... 166 Configuring Windows Components for CICSPlex Discoery......... 167 Registry Modifications........ 167 Configuring Scheduling Jobs...... 167 Configuring the CICSPlex SM Discoery.. 167 Additional Configuration for Data sets... 168 Base CICS Discoery........... 168 1. Install Tioli Business Systems Manager for Base CICS Discoery Components..... 169 2. Determine if CICS EXCI Application is Required.............. 169 3. Install CICS EXCI Application and Resources (optional).............. 169 a. Define EXCI Application to CICS.... 170 Contents

b. Update CICS Definitions....... 170 4. Configure z/os Components...... 170 a. Define Access for the CICS VSAM File.. 170 b. Define Access for the Generic EXCI Interface............. 171 c. Define Access for CICS Commands... 171 d. Modify the IHSCFTP Template JCL... 171 e. Modify IHSCBCPJ Discoery JCL.... 171 5. Configuring Windows Components for CICSPlex Discoery.......... 171 6. Submit Job and Verify Output...... 171 7. Schedule Job as Required....... 172 8. Install the CICS Transient Data Exit Program 172 Tioli NetView for OS/390 RODM and Tioli NetView for z/os RODM......... 173 Configuring z/os Components...... 173 Configuring Windows Discoery Components 174 Configuring SQL Serer Jobs...... 174 Storage Management........... 175 Configuring System-Managed Storage.... 175 Configuring z/os Components..... 176 Configuring Windows Discoery Components............ 177 Enabling Interal Monitoring...... 177 Configuring Data Facility Systems Managed Storage Hierarchical Storage Manager.... 179 Enabling the HSM Monitor/Tuner Interface 179 Configuring HSM Monitor/Tuner Workstation............ 179 Modifying an Existing MON9999 Routine 179 Configuring Extended Remote Copy Discoery 180 Configuring z/os Components..... 180 Registry Modifications........ 180 Configuring SQL Serer Jobs...... 180 ASG TMON for CICS.......... 180 1. Perform CICS Initial Discoery (optional).. 181 2. Configure ASG TMON........ 181 a. Configure ASG TMON for CICS to Use z/os Syslog............ 181 b. Determine ASG-TMON for CICS Messages to be Monitored.......... 181 3. Configure NetView Components..... 182 a. Configure NetView........ 182 4. Restart NetView.......... 182 ASG TMON for DB2........... 182 1. Configure Tioli Business Systems Manager for DB2.............. 182 2. Configure ASG TMON........ 182 a. Configure ASG TMON for DB2 to Use z/os Syslog............ 182 3. Configure NetView Components..... 183 a. Configure NetView........ 183 4. Restart NetView.......... 183 ASG-TMON for MVS........... 183 1. Configure ASG-TMON for MVS..... 184 a. Create a User ID for ASG-TMON for MVS 184 b. Customize ASG-TMON for MVS Exceptions............ 184 2. Configure Tioli Business Systems Manager 184 a. Customize the IHSZTMIN Parameter Member............. 184 b. Customize IHSZTMEV Parameter Member 184 3. Configure NetView Components..... 184 a. Configure NetView........ 184 b. Define TAF SRCLUs for NetView.... 184 4. Restart NetView.......... 185 BMC MAINVIEW for CICS......... 185 1. Perform CICS Initial Discoery (optional).. 185 2. Configure BMC MAINVIEW...... 185 a. Configure BMC MAINVIEW for CICS to Use z/os Syslog.......... 185 b. Create a Journal Log User Exit Routine 185 c. Configure BMC MAINVIEW for CICS to Specify Correct Target........ 185 3. Configure NetView Components..... 186 a. Configure NetView........ 186 4. Restart NetView.......... 186 MAINVIEW for DB2........... 186 1. Configure Tioli Business Systems Manager for DB2.............. 186 2. Configure BMC MAINVIEW...... 186 a. Configure BMC MAINVIEW for DB2 to Use z/os Syslog.......... 186 b. Configure BMC MAINVIEW for DB2 Background Exception Sampler to use WTO. 186 c. Configure BMC MAINVIEW for DB2 to Specify Correct Target........ 187 3. Configure NetView Components..... 187 a. Configure NetView........ 187 4. Restart NetView.......... 187 MAINVIEW for OS/390.......... 187 1. Configure BMC MAINVIEW for OS/390 to use z/os Syslog........... 187 2. Configure NetView Components..... 187 a. Configure NetView........ 187 3. Restart NetView.......... 187 MAINVIEW for IMS........... 188 1. Configure Tioli Business Systems Manager for IMS.............. 188 2. Configure BMC MAINVIEW...... 188 a. Configure BMC MAINVIEW for IMS to Use z/os Syslog.......... 188 b. Configure BMC MAINVIEW for IMS to Specify Correct Target........ 188 3. Configure NetView Components..... 188 a. Configure NetView........ 188 4. Restart NetView.......... 188 WebSphere for z/os and WebSphere for OS/390 189 Configuring WebSphere for z/os and WebSphere for OS/390......... 189 Configuring z/os Components..... 189 Registry Modifications........ 189 Communication Between z/os and the Tioli Business Systems Manager Serers...... 189 Defining the Logical Unit Name...... 189 Setting the User ID for z/os Tasks..... 190 Starting Task Serer Manually or Automatically 190 Configuring z/os Task Authentication.... 190 Enabling Task Serer z/os Support..... 192 Installing and Configuring Distributed Data Sources............... 192 i IBM Tioli Business Systems Manager: Installation and Configuration Guide

Associating Tioli Enterprise Console Eents with Common Listener Resources........ 192 Chapter 10. Installing and Configuring Components on Tioli Enterprise Console.............. 193 Installing and Configuring Tioli Business Systems Manager Eent Enablement........ 193 Installing Tioli Business Systems Manager Eent Enablement........... 193 Installing Distributed Components from the Tioli Desktop........... 194 Installing Distributed Components from the Command Line........... 195 Additional Installation Options..... 196 Configuring Eent Enablement...... 196 Configuring the Solaris /etc/system File.. 196 Tioli Task Support......... 197 Mapping Tioli Enterprise Console Eent Seerity to Tioli Business Systems Manager Alerts.............. 198 Setting User Rights......... 198 Configuring TCP/IP Port Numbers.... 199 Configuring for Network Address Translation 199 Configuring Multiple Tioli Object Serers 200 Configuring the Task Serer...... 200 Configuring the Serer.Properties File... 201 Configuring Eent Enablement..... 201 Tioli Enterprise Console Status Integration.. 203 Status Integration Interfaces...... 203 Configuring the Status Integration.... 204 Eent Integration Facility (EIF) Sender Eent Definition............ 206 Handling Tioli Enterprise Console Duplicate Eents.............. 206 Tioli Enterprise Console Optional Rulebase Configuration............. 207 IBM Tioli Serice Leel Adisor Eents for the Executie Dashboard.......... 207 Associating Tioli Enterprise Console Eents with Common Listener Resources..... 208 The Tioli Business Systems Manager for 390 Eents and Tioli Enterprise Console Interface. 208 Tioli Enterprise Console Eent Format.. 209 Message Selection and Filtering within the Source/390 Object Serer....... 209 Eent Logging........... 224 Implementation and Configuration on the z/os Host............ 225 Object Serer Operator Commands for the EIF Interface............ 227 Chapter 11. Installing and Configuring Distributed Data Sources...... 229 Tioli Distributed Monitoring and IBM Tioli Monitoring.............. 229 IBM Tioli Monitoring For Products...... 229 Intelligent Monitor for Tioli NetView..... 229 Installing Intelligent Monitor for Tioli NetView 230 Adapter Configuration......... 230 Console Start Configuration....... 231 Installation on Tioli Business Systems Manager............. 231 Installing the Tioli NetView Web Console 232 Start Fix Pack for Version 7.1...... 232 Post-Installation Checklist....... 232 Starting the Intelligent Monitor for Tioli NetView.............. 233 Intelligent Monitor for HP OpenView..... 233 Installing Intelligent Monitor for HP OpenView 233 Starting the Intelligent Monitor for HP OpenView............ 234 Configuration............ 234 Starting Intelligent Monitor for HP OpenView 235 Intelligent Monitor for NetIQ AppManager, Unicenter TNG, and BMC PATROL...... 236 NetIQ AppManager.......... 236 Installing Intelligent Monitor for NetIQ AppManager Serer......... 236 Configuring Eent Discoery...... 237 Starting the Eent Discoery Serice... 237 Uninstalling Intelligent Monitor for NetIQ AppManager Serer......... 237 Unicenter TNG............ 238 Installing Intelligent Monitor for Unicenter TNG.............. 238 Configuring Eent Discoery...... 239 Configuring Delta Discoery in Intelligent Monitor for Unicenter TNG...... 239 Starting the Eent Discoery Serice in Intelligent Monitor for Unicenter TNG... 239 Uninstalling Intelligent Monitor for Unicenter TNG.............. 240 BMC PATROL............ 240 Installing Intelligent Monitor for BMC PATROL............. 240 Configuring Eent Discoery...... 241 Configuring the Listening Serice in Intelligent Monitor for BMC PATROL... 241 Uninstalling Intelligent Monitor for BMC PATROL............. 242 Chapter 12. National Language Support.............. 243 Installing National Language Support for Intelligent Monitor for NetIQ AppManager, BMC PATROL and Unicenter TNG........ 243 Prerequisites............. 243 Installing National Language Support for Intelligent Monitor for NetIQ AppManager.. 243 Installing National Language Support for Intelligent Monitor for BMC PATROL.... 244 Installing National Language Support for Intelligent Monitor for Unicenter TNG.... 244 Installing National Language Support for Intelligent Monitor V3.1 for Tioli NetView and HP OpenView.............. 245 Prerequisites............. 245 Installing National Language Support for Intelligent Monitor for NetView...... 245 Contents ii

Installing National Language Support for Intelligent Monitor for HP OpenView.... 246 Installing National Language Support for Other Features and Components in a Non-Tioli Management Enironment (TME)...... 247 Prerequisites............. 247 National Language Support Components.... 247 Windows Operating System Enironment... 247 UNIX Operating System Enironment.... 248 Additional Installation Information..... 248 Additional Information for Populating the Tioli Business Systems Manager Databases.... 249 Prerequisites............ 249 Configuring Microsoft SQL Serer for Loading Database Resources.......... 250 Installing Language Support for Other Features and Components in a Tioli Management Enironment (TME)........... 250 Older Versions of Eent Enablement Language Support:.............. 251 Uninstalling National Language Support.... 251 Prerequisites............. 251 Uninstalling National Language Support... 251 Remoing National Language Support Resources from the Databases....... 252 Uninstalling Language Support from a Tioli Management Enironment........ 252 Uninstalling National Language Support for Intelligent Monitor for NetIQ AppManager.. 253 Uninstalling National Language Support for Intelligent Monitor for BMC PATROL.... 253 Uninstalling National Language Support for Intelligent Monitor for Unicenter TNG.... 253 Uninstalling National Language Support for Intelligent Monitor for NetView...... 254 Uninstalling National Language Support for Intelligent Monitor for HP OpenView.... 254 Globalization Issues........... 255 Using the Executie Dashboard in Hebrew and Arabic............... 255 Problems When Issuing Scripts...... 255 Traditional Chinese Bold and Italic Font Display Problems.............. 255 Traditional Chinese Bold and Italic Font Display Problems when Installing Intelligent Monitor............. 256 Simplified Chinese Bold and Italic Font Display 256 Japanese Bold and Italic Font Display Problems 257 Accelerator Key Labels Shown in the English Language.............. 257 IBM World Type Font......... 257 Command Line Display and Bidirectional Languages............. 258 Time Zone Display in Console Preferences.. 258 Chapter 13. Uninstalling Tioli Business Systems Manager..... 259 Uninstalling Tioli Business Systems Manager Base Serices............... 259 Uninstalling the Console......... 260 Part 3. Upgrading Tioli Business Systems Manager........ 263 Chapter 14. Upgrading Oeriew... 265 Upgrading Considerations......... 265 Upgrading Scenarios........... 266 Upgrading Checklist........... 267 Upgrading Base Serices........ 267 Upgrading the Console......... 273 Switching from LocalOS User Registry to LDAP 274 Upgrading Using Three Systems....... 274 Prerequisites............. 274 Upgrading Using Three Systems...... 274 Chapter 15. Upgrading SQL Serer 7.0 279 Chapter 16. Upgrading Data Sources 281 Upgrading Tioli NetView for OS/390 and Tioli NetView for z/os............ 281 Upgrading Tioli Business Systems Manager for IMS Components............ 281 Upgrading DB2 Uniersal Database for z/os and OS/390 Components........... 282 Upgrading System Automation for OS/390 and System Automation for z/os........ 283 Upgrading Tioli Workload Scheduler..... 284 Upgrading CICSPlex SM......... 286 Upgrading Tioli NetView for OS/390 and Tioli NetView for z/os RODM......... 287 Chapter 17. Using the 3.1 health monitor client to monitor 2.1.1 and 3.1 components............ 289 Chapter 18. Upgrading National Language Support......... 291 Chapter 19. Moing Your Preferences and Workspace Files........ 293 Prerequisites.............. 293 Upgrading.............. 293 Cleaning Up Preferences......... 294 Cleaning Up Workspaces......... 295 Chapter 20. Upgrading Distributed Line of Business Rules to Automated Business Systems......... 297 Oeriew............... 297 Upgrading Automated Business Systems.... 297 Adding Rules that Cannot be Upgraded.... 299 Appendix A. Configuring Network Communications Using Firewalls... 301 Appendix B. Silently Installing and Uninstalling the Console...... 303 iii IBM Tioli Business Systems Manager: Installation and Configuration Guide

Silent Installation............ 303 Generation and Modification of Template... 303 Generation and Modification of Response File 304 Silently Uninstalling the Console....... 305 Appendix C. Using an SQL Account Other Than sa........... 307 Appendix D. Distributing the Console in a Tioli Managed Enironment... 309 Distributing an Software Package Block.... 309 Remoing the Console Using the Tioli Desktop 310 Appendix E. Installing Tioli Business Systems Manager Using the Built-in Screen Reader........... 311 Installing Tioli Business Systems Manager Base Serices...............311 Installing the Tioli Business Systems Manager Console...............311 New Messages............. 313 Changed Messages........... 314 Deleted Messages............ 315 Support information........ 317 Searching knowledge bases......... 317 Search the information center on your local system or network........... 317 Search the Internet.......... 317 Obtaining fixes............. 317 Contacting IBM Software Support...... 318 Determine the business impact of your problem 319 Describe your problem and gather background information............. 319 Submit your problem to IBM Software Support 319 Notices.............. 321 Trademarks.............. 322 Index............... 325 Appendix F. Summary of Messages Used for Automation........ 313 Contents ix

x IBM Tioli Business Systems Manager: Installation and Configuration Guide

About this guide Publications IBM Tioli Business Systems Manager is an enterprise management product that monitors the data processing resources that are critical to a business application. It enables end-to-end monitoring of systems, subsystems, applications, and other resources in your enterprise, from z/os systems to distributed systems. Tioli Business Systems Manager proides your operations and support organizations, application owners, and management with a iew of the system components as they relate to your oerall business. This section lists publications in the Tioli Business Systems Manager library and related documents. It also describes how to access Tioli publications online and how to order Tioli publications. IBM Tioli Business Systems Manager library This following publications are in the IBM Tioli Business Systems Manager library: IBM Tioli Business Systems Manager Planning Guide, SC32-9088, proides an introduction to the Tioli Business Systems Manager product. It also contains planning and design information to consider when implementing a Tioli Business Systems Manager solution. This document is written for network planners, system designers, systems administrators, and others who are responsible for planning and implementing the product. IBM Tioli Business Systems Manager Installation and Configuration Guide, SC32-9089, proides the installation and configuration tasks necessary for the implementation of Tioli Business Systems Manager. This document is written for system administrators and others who are responsible for installing and configuring Tioli Business Systems Manager. IBM Tioli Business Systems Manager Introducing the Consoles, SC32-9086, proides an introduction to the Tioli Business Systems Manager console, Web console, executie dashboard, and the reporting system. This document is written for operators and administrators. IBM Tioli Business Systems Manager Administrator s Guide, SC32-9085, describes administratie tasks for Tioli Business Systems Manager. This document is written for system administrators and others who perform administratie tasks for Tioli Business Systems Manager. IBM Tioli Business Systems Manager Problem and Change Management Integration Guide, SC32-9130, describes how to write request processors to enable the problem, change, and automatic ticket integration function proided with Tioli Business Systems Manager to work with problem and change management applications. This document is written for system programmers. IBM Tioli Business Systems Manager Command Reference, SC32-1243, describes the commands aailable for use with Tioli Business Systems Manager. This document is written for system administrators and others who run commands and scripts for Tioli Business Systems Manager. Copyright IBM Corp. 2000, 2004 xi

IBM Tioli Business Systems Manager Message Reference, SC32-9087, describes the messages for Tioli Business Systems Manager. This document is written for system programmers, network planners, operations managers, system designers, system administrators, network operators, and others who need message information for Tioli Business Systems Manager. IBM Tioli Business Systems Manager Troubleshooting Guide, SC32-9084, describes troubleshooting tasks to diagnose problems with Tioli Business Systems Manager. This document is written for system administrators and others who perform diagnostic tasks for Tioli Business Systems Manager. IBM Tioli Business Systems Manager Release Notes, GI11-4029, describes what is new for this release of the Tioli Business Systems Manager product. IBM Tioli Business Systems Manager Guide for Warehouse Pack, Version 3.1.0.0, using Tioli Data Warehouse, Version 1.2, SC32-9114, describes how to use the warehouse enablement pack to extract data from the Tioli Business Systems Manager database and load it into the Tioli Data Warehouse database, where it can be accessed using reporting and data analysis tools. This document is written for administrators and others who plan for and install the warehouse pack, use and maintain the warehouse pack and its reports, or create new reports. An index is proided for searching the Tioli Business Systems Manager library. If you hae Adobe Acrobat on your system, you can use the Search command to locate specific text in the library. For more information about using the index to search the library, see the online help for Acrobat. Related publications The Tioli Software Glossary includes definitions for many of the technical terms related to Tioli software. The Tioli Software Glossary is aailable at the following Tioli software library Web site: http://www.ibm.com/software/tioli/library/ Access the glossary by clicking the Glossary link on the left pane of the Tioli software library window. Accessing publications online The documentation CD contains the publications that are in the product library. The format of the publications is PDF and HTML. IBM posts publications for this and all other Tioli products, as they become aailable and wheneer they are updated, to the Tioli software information center Web site. Access the Tioli software information center by first going to the Tioli software library at the following Web address: http://www.ibm.com/software/tioli/library/ Scroll down and click the Product manuals link. In the Tioli Technical Product Documents Alphabetical Listing window, click the Tioli Business Systems Manager link to access the product library at the Tioli software information center. xii IBM Tioli Business Systems Manager: Installation and Configuration Guide

Accessibility Note: If you print PDF documents on other than letter-sized paper, set the option in the File Print window that allows Adobe Reader to print letter-sized pages on your local paper. Ordering publications You can order many Tioli publications online at the following Web site: Tioli technical training Support information http://www.elink.ibmlink.ibm.com/public/applications/publications/ cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: In the United States: 800-879-2755 In Canada: 800-426-4968 In other countries, see the following Web site for a list of telephone numbers: http://www.ibm.com/software/tioli/order-lit/ Accessibility features help users with a physical disability, such as restricted mobility or limited ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For information about installing the Tioli Business Systems Manager product using the built-in screen reader, see the IBM Tioli Business Systems Manager Installation and Configuration Guide. For information about the shortcut keys that can be used with the Tioli Business Systems Manager console, see the Accessibility appendix in IBM Tioli Business Systems Manager Introducing the Consoles. For Tioli technical training information, refer to the following IBM Tioli Education Web site: http://www.ibm.com/software/tioli/education If you hae a problem with your IBM software, you want to resole it quickly. IBM proides the following ways for you to obtain the support you need: Searching knowledge bases: You can search across a large collection of known problems and workarounds, Technotes, and other information. Obtaining fixes: You can locate the latest fixes that are already aailable for your product. Contacting IBM Software Support: If you still cannot sole your problem, and you need to work with someone from IBM, you can use a ariety of ways to contact IBM Software Support. For more information about these three ways of resoling problems, see Support information on page 317. About this guide xiii

Participating in newsgroups User groups proide software professionals with a forum for communicating ideas, technical expertise, and experiences related to the product. They are located on the Internet and are aailable using standard news reader programs. These groups are primarily intended for user-to-user communication and are not a replacement for formal support. To access a newsgroup, use the instructions appropriate for your browser. IBM Tioli Business Systems Manager: news://news.software.ibm.com/ibm.software.tioli.business-systems-manager IBM Tioli Enterprise Console : news://news.software.ibm.com/ibm.software.tioli.enterprise-console IBM Tioli Serice Leel Adisor: news://news.software.ibm.com/ibm.software.tioli.serice-leel-adisor IBM Tioli Switch Analyzer: news://news.software.ibm.com/ibm.software.tioli.switch-analyzer IBM Tioli NetView for UNIX and IBM Tioli NetView for Windows : news://news.software.ibm.com/ibm.software.tioli.netiew-unix-windows IBM Tioli NetView for z/os: news://news.software.ibm.com/ibm.software.netiew Conentions used in this guide This guide uses seeral conentions for special terms and actions and for operating system-dependent commands and paths Typeface conentions This guide uses the following typeface conentions: Bold Italic Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) Keywords and parameters in text Words defined in text Emphasis of words (words as words) New terms in text (except in a definition list) xi IBM Tioli Business Systems Manager: Installation and Configuration Guide

Terminology Variables and alues you must proide Monospace Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options Operating system-dependent ariables and paths This guide uses the UNIX conention for specifying enironment ariables and for directory notation. When using the Windows command line, replace $ariable with %ariable% for enironment ariables and replace each forward slash (/) with a backslash (\) in directory paths. The names of enironment ariables are not always the same in Windows and UNIX. For example, %TEMP% in Windows is equialent to $tmp in UNIX. Note: If you are using the bash shell on a Windows system, you can use the UNIX conentions. For a list of terms and definitions for Tioli and other IBM products, refer to the IBM terminology Web site: http://www.ibm.com/ibm/terminology/ For breity and readability, the term Tioli NetView for z/os refers to both the Tioli NetView for z/os product and the Tioli NetView for OS/390 product. About this guide x

xi IBM Tioli Business Systems Manager: Installation and Configuration Guide

Part 1. Specifications and Requirements This part describes the minimum software requirements needed to install IBM Tioli Business Systems Manager and includes hardware recommendations that are based on the currently aailable serer class systems. It includes the following chapters: Chapter 1, Serer and Console Specifications, on page 3 Chapter 2, Data Source Specifications, on page 19 Copyright IBM Corp. 2000, 2004 1

2 IBM Tioli Business Systems Manager: Installation and Configuration Guide

Chapter 1. Serer and Console Specifications Installation CDs This chapter describes the specifications required to install Tioli Business Systems Manager and includes the following sections: Installation CDs Tioli Business Systems Manager Components on page 4 Prerequisite Software on page 7 Serer Specifications on page 8 Console Specifications on page 13 Eent Enablement Specifications on page 15 Recommended Configurations on page 15 Serer Test/Quality Assurance Systems on page 17 Table 1 describes Tioli Business Systems Manager Version 3.1 CDs. Table 1. CD Name Tioli Business Systems Manager Base Serices Description Tioli Business Systems Manager Base Serer installation XML toolkit Tioli Business Systems Manager Distributed Edition Tioli Business Systems Manager Distributed Eent Enablement Intelligent Monitors Warehouse Enablement Pack (WEP) Tioli Business Systems Manager Documentation Tioli Business Systems Manager documentation IBM WebSphere Application Serer for Windows NT and Windows 2000 IBM WebSphere Application Serer for Windows 2003 IBM WebSphere Application Serer Fix Packs for Windows IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for Windows NT, Windows 2000 and Windows XP Warehouse Enablement Pack documentation If you are using Windows 2000, you are asked to insert this CD during the console serer installation. If you are using Windows 2003, you are asked to insert this CD during the console serer installation. WebSphere Fix Packs Tioli Business Systems Manager console for Windows IBM WebSphere Application Serer, Version Tioli Business Systems Manager console for 5 Application Clients 1.3 for AIX AIX IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for Solaris Tioli Business Systems Manager console for Solaris IBM WebSphere Application Serer, Version Tioli Business Systems Manager console for 5 Application Clients 1.3 for Linux Linux Copyright IBM Corp. 2000, 2004 3

Table 1. (continued) CD Name IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for Windows NT, Windows 2000 and Windows XP Software Package Block for Tioli Configuration Manager IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for AIX Software Package Block for Tioli Configuration Manager IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for Solaris Software Package Block for Tioli Configuration Manager IBM WebSphere Application Serer, Version 5 Application Clients 1.3 for Linux Software Package Block for Tioli Configuration Manager Tioli Business Systems Manager Language Pack Description Software Package Block for software distribution of Tioli Business Systems Manager console for Windows Software Package Block for software distribution of Tioli Business Systems Manager console for AIX Software Package Block for software distribution of Tioli Business Systems Manager console for Solaris Software Package Block for software distribution of Tioli Business Systems Manager console for Linux Tioli Business Systems Manager Language Pack Tioli Business Systems Manager Components Required Components The following table lists Tioli Business Systems Manager, Enterprise edition components: Table 2. List of Tioli Business Systems Manager, Enterprise edition components Component Description Notes Database serer Console serer Where all eent data is processed and stored and where propagation occurs. Additionally, if you are using distributed feeds, this is usually where the agent listener, task serer, and eent enablement run. Runs the serices required to support the end user clients. You must install the database serer component on the database serer machine. See Database Serer on page 8 for serer specifications. You must install the console serer component on the console serer machine. High olume enironments can hae multiple console serers. See Recommended Configurations on page 15 for more information.see Console Serer on page 9 for serer specifications. 4 IBM Tioli Business Systems Manager: Installation and Configuration Guide

Table 2. List of Tioli Business Systems Manager, Enterprise edition components (continued) Component Description Notes Eent Handler serer SNA Serer/Host Integration Serer Common Listener Receies data from and sends commands to the z/os operating system. This serer is only required if you are connecting to a z/os enironment. This serer is only required if you are using SNA to send eents to the client. You do not hae to install Tioli Business Systems Manager on this serer, just the prerequisites. Collects data from the data sources in a distributed enironment. We recommend installing the eent handler component on a separate eent handler serer machine. Only 35 LPARs can be connected to an eent handler serer. If you are using more than 35 LPARs, you need multiple eent handler serers. See Eent Handler Serer (optional) on page 10 for serer specifications. We recommend installing the common listener component on the console serer machine. Distributed TEC Listener Required only if you are using Automated Business Systems, the XML toolkit, or one of the Intelligent Monitors. Installs the Agent Listener and Task Serer. The Agent Listener processes eents sent to Tioli Business Systems Manager by a Tioli Enterprise Console system that has installed the Tioli Business Systems Manager Eent Enablement library. You must hae a JDBC drier installed on the same machine. If you are using Tioli Enterprise Console, install the Distributed TEC Listener component on the database serer machine. When you install this component, the Agent Listener and Task Serer serices are installed. EIF Sender Required only if you are using Tioli Enterprise Console. Sends state change and status change eents to the Tioli Enterprise Console. Required only if you are using Tioli Enterprise Console and you want two way communication with the Tioli Enterprise Console or you want eents sent on state changes. You must hae a JDBC drier installed on the same machine. We recommend installing the EIF Sender component on the database serer machine. Must hae a JDBC drier installed on the same machine. The following table lists Tioli Business Systems Manager, Distributed edition components: Chapter 1. Serer and Console Specifications 5

Table 3. List of Tioli Business Systems Manager, Distributed edition components Component Description Notes Database serer Console serer Where all eent data is processed and stored and where propagation occurs. This is where the agent listener and task serer run and where Eent Enablement is installed. Runs the serices required to support the end user clients. You must install the database serer component on the database serer machine. See Database Serer on page 8 for serer specifications. You must install the console serer component on the console serer machine. Common Listener Collects data from the data sources in a distributed enironment. High olume enironments can hae multiple console serers. See Recommended Configurations on page 15 for more information. See Console Serer on page 9 for serer specifications. We recommend installing the common listener component on the console serer machine. Distributed TEC Listener EIF Sender Required only if you are using Automated Business Systems, the XML toolkit, or one of the Intelligent Monitors. Installs the Agent Listener and Task Serer. The Agent Listener processes eents sent to Tioli Business Systems Manager by a Tioli Enterprise Console system that has installed the Tioli Business Systems Manager Eent Enablement library. Required only if you are using Tioli Enterprise Console. Sends state change and status change eents to the Tioli Enterprise Console. You must hae a JDBC drier installed on the same machine. Install the Distributed TEC Listener component on the database serer machine. When you install this component, the Agent Listener and Task Serer serices are installed. You must hae a JDBC drier installed on the same machine. We recommend installing the EIF Sender component on the database serer machine. Required only if you are using Tioli Enterprise Console and you want two way communication with the Tioli Enterprise Console or you want eents sent on state changes. You must hae a JDBC drier installed on the same machine. 6 IBM Tioli Business Systems Manager: Installation and Configuration Guide

Optional Components The following table lists the optional components: Table 4. List of optional components Component Description Notes History Serer/Reporting System Health Monitor Serer and Client The history serer contains the archie resource repository used by Tioli Business Systems Manager. This repository maintains an audit trail of all actions and eents that occurred during Tioli Business Systems Manager processing. It also is the Web serer for the reporting system. Monitors the status and aailability of Tioli Business Systems Manager and displays the performance and aailability of its components. If you hae a history serer, you must install the reporting system component on the history serer. If you do not hae a history serer, you can install the Reporting System component on the database serer. Using the reporting system without a history serer can cause seere performance degradation for console users, and is not recommended in a production enironment. See History Serer (optional) on page 11 for serer specifications. See Health Monitor Serer (optional) on page 12 for serer specifications. Consoles You can iew Tioli Business Systems Manager in three different ways: Prerequisite Software Tioli Business Systems Manager console (hereafter, console) See Console Specifications on page 13 for specifications. Web console See Web Console Specifications on page 14 for specifications. Executie dashboard See Executie Dashboard Specifications on page 14 for specifications. The following list includes the prerequisite software required for installing Tioli Business Systems Manager: (See Serer Specifications on page 8 for more detailed information.) If you are installing Tioli Business Systems Manager z/os (PID 5698-A21), you must also install Tioli Business Systems Manager, Distributed Product (PID 5724-C51). Microsoft SQL Serer 2000 Enterprise edition with Serice Pack 3a. Microsoft SQL Serer 2000 Drier for JDBC. This is required to be installed only on machines that hae the Distributed TEC Listener, EIF Sender, or the common listener installed. Microsoft Windows 2000 Resource Kit. Microsoft Windows Support Tools from the Windows installation CD. MKS Toolkit for System Administrators 8.6 or 8.7. Chapter 1. Serer and Console Specifications 7

Serer Specifications WebSphere Application Serer Version 5.0.2.6 is proided with Tioli Business Systems Manager V3.1 and must be installed as part of Tioli Business Systems Manager installation. TCP/IP as proided by the supported operating systems for connectiity. Microsoft Host Integration Serer 2000 Client feeds is used for mainframe connectiity for SNA configurations and for code page translations for IP connectiity. z/os 1.4 or later (only if you are going to monitor z/os data sources). IBM Tioli NetView for z/os 5.1 (only if you are going to monitor z/os data sources). See Tioli NetView for OS/390 and z/os on page 113 for details. If you use Tioli Data Warehouse and want to use the Tioli Business Systems Manager Warehouse Enablement Pack, you must use the Tioli Business Systems Manager Warehouse Enablement Pack 3.1.0.0. Please refer to the IBM Tioli Business Systems Manager: Warehouse Enablement Pack V3.1.0.0 Implementation Guide for more information. Web browser. Use either Microsoft Internet Explorer 6.0 or higher or Mozilla 1.4 or higher (on Linux or AIX enironments). Macromedia Flash. The executie dashboard uses Macromedia Flash, which can be dynamically downloaded if needed. The VCRedist.exe file must be installed on eery machine that uses Intelligent Monitor for BMC PATROL, NetIQ AppManager, or Unicenter TNG. Installation of seeral Windows-based serers is critical to Tioli Business Systems Manager. Note: Hardware recommendations are based on distributing the Tioli Business Systems Manager serer serices across the maximum number of machines. Database Serer Table 5. Hardware and software requirements for the database serer Microsoft Windows 2000 Microsoft Windows 2003 Processor Quad Pentium III Xeon, 2.0 GHz For small, distributed-only implementations (fewer than 30 eents a minute), a Dual Processor machine is acceptable. Memory System Drie Data Drie Supported Operating Systems Windows 2000 operating system plus 2 GB free disk space 6 GB RAM Windows 2003 operating system plus 2 GB free disk space 108 GB free disk space for database backups and log files Windows 2000 Adanced Serer Edition with Serice Pack 4 Windows Serer 2003 Enterprise Edition 8 IBM Tioli Business Systems Manager: Installation and Configuration Guide