================================================================================ README Welcome to Tivoli Decision Support For Storage Management Analysis and Tivoli Storage Management Decision Support Loader Version 1.1.1. This document is made available via ftp for customers owning version 1.1.0. The second section, 'Important: Upgrading from Version 1.1.0 -> 1.1.1', is critical to successful installation. Licensed Materials - Property of IBM (C) Copyright Tivoli Systems Inc., an IBM Company 1999. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure is restricted by GSA ADP Schedule Contract with IBM Corporation. ================================================================================ This README contains the following sections: * Known problems with TDS 2.1 core installation * Important: Upgrading from Version 1.1.0 -> 1.1.1 * Install Latest Tivoli Storage Manager ODBC Driver * Install Latest Oracle ODBC driver * Tivoli Decision Support Version 2.1 Core Product Patch is Required * Tivoli Decision Support for Storage Management Analysis APARS Fixed in Present Release * Using DB2 with Storage Management Analysis * Tivoli Storage Manager APAR IC25316 Fix is Required * Crystal Report Limitation * Decision Support Loader Installation and Configuration * Decision Support Loader Fixes * Reports Fail to Open for Database Implementation * The Full README Text for Tivoli Decision Support 2.1 * Contacting the Tivoli System Customer Support Center ********************************************************************** * Known problems with TDS 2.1 core installation * ********************************************************************** Workarounds/Patches for the TDS 2.1 core product are available on the following ftp site: ftp://ftp.tivoli.com/support/patches/patches_2.1 ********************************************************************** * Important: Upgrading from Version 1.1.0 -> 1.1.1 * ********************************************************************** Check the website for the latest releases and comments prior to attempting an installation or update. http://www.tivoli.com/support/storage_mgr/adsercli.htm In order to upgrade to the current version, 1.1.1, uninstall the guide, Tivoli Decision Support for Storage Management Analysis, by highlighting the guide within the Administrator program and delete the guide. See Tivoli Decison Support documentation for complete details. Unzip the ftp image to a temp directory. Run setup from the ftp image and select option one to install the complete Tivoli Decision Support for Storage Management Analysis. Complete the product installation. Storage Management Decision Support Loader must be upgraded as well. Find SmTds.dll in the current installation directory and replace it with SmTds.dll from the new image file. Additionally, to correct an incorrent default initialization file, open the Loader and goto the Advanced Setup Options dialog box. Click on the text "Click here to revert to default settings for options available in this dialog box." Save the configuration file. ********************************************************************** * Install Latest Tivoli Storage Manager ODBC Driver * ********************************************************************** Install the ODBC driver packaged with the latest TSM client from http://www.tivoli.com/support/storage_mgr/adsercli.htm ********************************************************************** * Install Latest Oracle ODBC Driver * ********************************************************************** ODBC driver shipped with Oracle 8.1.5 client has known problems. Look for the latest fixes available on Oracle's website. ********************************************************************** * Tivoli Decision Support Ver 2.1 Core Product Patch is Required * ********************************************************************** Check for the latest core product release (version 2.1) for information: http://www.tivoli.com/support/storage_mgr/adsercli.htm As of this release, there is(are) patch(es) required for installation. Additionally, ensure you have read and applied any recommendations from the 2.1 readme file. ********************************************************************** * Tivoli Decision Support for Storage Management Analysis * * APARS Fixed in Present Release * ********************************************************************** APAR# IC25447 The APAR corrects the default configuration file packaged with the Tivoli Storage Management Decision Support Loader. APAR# IC25448 The APAR improves report functionality for TDS version 2.1. ********************************************************************** * Using DB2 with Storage Management Analysis * ********************************************************************** If you will be using DB2 with Storage Management Analysis, do the following: After you have installed Tivoli Decision Support and setup DB2, open the "\Util\Tivoli Decision Support for Storage Management Analysis" folder. Execute swaprpts.bat to install the DB2 version of Crystal Reports. For a network installation, swaprpts.bat is in the shared data folder. ********************************************************************** * Tivoli Storage Manager APAR IC25316 Fix is Required * ********************************************************************** The fix for APAR IC25316 must be applied to Tivoli Storage Manager Version 3.7 for full functionality of the Storage Management Analysis guide. Some reports may not function correctly without this fix. You can find the fix at the following location: ftp://service.boulder.ibm.com/storage/tivoli-storage-management/ /maintenance/server/v3r7/ ********************************************************************** * Crystal Report Limitation * ********************************************************************** In the Storage Management Analysis Release Notes, there is section called "Using Crystal Reports" that describes how to enter date parameters for Crystal Reports. This is a workaround for a known date problem. See the hints section within the Discovery Interface for Crystal Report details. Additionally, the network installation of TDS may have difficulties with certain Crystal Reports. Do not use commas in the parameter fields for Crystal Reports. Wildcard (*) use is recommended. ********************************************************************** * Tivoli Storage Management Decision Support Loader Installation * * and Configuration * ********************************************************************** 1. If the Decision Support Loader fails to initialize, install MS Active X Control Pad, available from: http://www.microsoft.com. 2. If you do not see the TSM ODBC driver in the ODBC Data Sources Drivers list, install the TSM client software. 3. The TSM Decision Support Loader is designed to retrieve data from the TSM database via the TSM ODBC driver and populate one of following RDBMSs: DB2 5.2 MS SQL 7.0 Oracle 8.1.5 4. Set up TSM Decision Support Loader by executing the setup.exe file and following the setup instructions. 5. User must have access to TSM server(s) and one of the RDBMSs listed in step 3, each configured for TSM Decision Support Loader. 6. Configure ODBC Data sources, found in Control Panel, for each TSM server and the RDBMS. 7. Run TSMDSL, located under Tivoli Decision Support in Program Files menu, and click on Cancel button before timer runs out. The Autostart feature allows unattended TSMDSL scheduling, e.g., use of the NT 'at' command. 8. Configure the Data source feature for the RDBMS installed for use with TSMDSL. 9. Configure Server List feature to include the TSM servers which user wants to collect data from. 10. Save the configuration file for future use by clicking on the "Save" button. 11. Log files may be viewed at any time via a web browser linked to the application directory, TSMLog.htm. ********************************************************************** * Decision Support Loader Fixes * ********************************************************************** Default Configuration File Problem The default configuration file fix is included with this release. DLL Problem SmTds.dll, Version 1.1.1, is included with this release, fixing the pruning problem associated with version 1.1.0. ********************************************************************** * Reports Fail to Open for Database Implementation * ********************************************************************** If any of the following reports fail to open correctly, please call Tivoli Customer Support for a fix: TSM_clmsg001.ppr TSM_cl010.ppr TSM_cl011.ppr TSM_cl017.ppr TSM_cl018.ppr ********************************************************************** * WHERE TO FIND DOCUMENTATION * ********************************************************************** The documentation for Tivoli Decision Support, Tivoli Decision Support For Storage Management Analysis, and Tivoli Storage Management Decision Support Loader is available in PDF format on the product CDROMs. You view PDF files with the Adobe Acrobat Reader, which you can download from the following Web site: http://www.adobe.com/prodindex/acrobat/readstep.html ********************************************************************** CONTACTING THE TIVOLI SYSTEMS CUSTOMER SUPPORT CENTER * ********************************************************************** How to contact Tivoli Customer Support : ---------------------------------------- Note: Whenever contacting Tivoli Customer Support, please have your customer identification information available. · Access the Tivoli Customer Support home page at http://www.support.tivoli.com. After you link to and submit the customer registration form, you can access many customer support services on the World Wide Web. Refer to the Customer Support Handbook for a listing of Tivoli Customer Support services, hours of operation, and contact numbers. This handbook is available online at http://www.support.tivoli.com. · Send an e-mail to support@tivoli.com. · In the United States, call Tivoli Customer Support at 1-800-TIVOLI-8. · Outside the United States, refer to your Customer Support Handbook for a list of support numbers in your country. This handbook is available online at http://www.support.tivoli.com. ********************************************************************** TIVOLI(R) DECISION SUPPORT 2.1 Readme.txt ********************************************************************** (C) COPYRIGHT TIVOLI Systems, Inc. 1999 ============================================================ CONTENTS (11 November 1999) ============================================================ · How to Use This Document · Introduction · Documentation · Accessing the Tivoli Decision Support 2.1 Documentation · Installation · Patches · Troubleshooting, Software Defects, Limitations, and Workarounds · Updates for Tivoli Decision Support Discovery Guides . 30 September 1999 · Tivoli Decision Support for Server Performance Prediction 1.0.1 - Distributed Monitoring Patches . 27 August 1999 · To View the .PDF Documentation, Download the Latest Version of Adobe Acrobat Reader · 21 JULY 1999 · DB2 Support · TDS for Event Management Version 1.0.1 · TDS for Software Deployment and Analysis Version 1.0.1 · 16 JUNE 1999 · Guide Cannot Be Installed · 07 MARCH 1999 · Scheduling Cube Builds (For Windows 95 and Windows 98) · Calculating Relative Dates in a Report · INTERSOLV Inc. ODBC Driver Version 3.01 for Sybase · Contacting the Tivoli Systems Customer Support Center ============================================================ HOW TO USE THIS DOCUMENT ============================================================ · To view Readme.txt on screen in Notepad or WordPad, maximize the Notepad or WordPad window. You may need to activate the word wrap feature in WordPad by selecting Word Wrap on the Edit menu. · To print Readme.txt, open it in Notepad or another word processor, then select the Print command on the File menu. If you use another word processor, select the contents of the document, and format the text in 10 point Courier to ensure proper spacing in your printout. ============================================================ INTRODUCTION ============================================================ This Readme.txt file covers the following topics for Tivoli Decision Support: · What documentation to review before starting the the installation procedure · How to start the installation procedure · Where to find a listing of the software defects, limitations, and workarounds · How to contact the Tivoli Systems Customer Support Center New features for Tivoli Decision Support 2.1 are described in the following documents that can be accessed from the Tivoli Decision Support 2.1 CD-ROM and as online documents after Tivoli Decision Support 2.1 has been installed on your machine: · Tivoli Decision Support 2.1 User's Guide · Tivoli Decision Support 2.1 Administrator's Guide · Tivoli Decision Support 2.1 Installation Guide · Release Notes for Tivoli Decision Support Version 2.1 · Tivoli Decision Support 2.1 Advanced Topics (This document will be availabe from the Tivoli Customer Support web site after 15 December 1999) For additional information, see the Documentation section of this readme.txt file. ============================================================ DOCUMENTATION ============================================================ Accessing the Tivoli Decision Support 2.1 Release Notes: -------------------------------------------------------- The Release Notes can be accessed in the following locations: The root folder of the CD-ROM: d:\Release_Notes.pdf The Tivoli Decision Support installation folder: d:\Program Files\Tds 2.1\Release_Notes.pdf Installing the Adobe Acrobat Reader version 4.0: ------------------------------------------------ Use the Adobe Acrobat Reader version 4.0 to view the Release Notes. You can install the Adobe Acrobat Reader version 4.0 by starting the Tivoli Decision Support 2.1 setup program on the Tivoli Decision Support 2.1 CD-ROM (d:\setup.exe) and selecting the Adobe Acrobat Reader checkbox using the procedures described in the Tivoli Decision Support 2.1 Installation Guide. You can also download the Adobe Acrobat Reader from www.adobe.com. Accessing the TDS 2.1 Product Documentation --------------------------------------------- The following TDS 2.1 product documentation (includes the Tivoli Discovery Administrator and the Tivoli Discovery Interface) can be accessed on your system after Tivoli Decision Support has been installed: Note: This document references several folders. The following are the default file paths for these folders: Your CD-ROM drive: The default - d:\ (where d is the letter of CD-ROM drive) The Tivoli Decision Support 2.1 installation folder: The default location - C:\Program Files\Tds 2.1 (where c:\Program Files\Tds 2.1 is the drive and folder on which you installed Tivoli Decision Support 2.1) =· Tivoli Decision Support 2.1 Installation Guide Filename on the CD-ROM: d:\Docs\Pdf\install.pdf (where d is the letter of CD-ROM drive) Filename on your machine: c:\Program Files\Tds 2.1\Docs\Pdf\install.pdf Description: Provides installation procedures for Tivoli Decision Support 2.1 and its components in stand-alone and network mode. =. Tivoli Decision Support 2.1 User's Guide Filename on the CD-ROM: d:\Docs\Pdf\install.pdf Filename on you machine: d:\Program Files\Tds 2.1\Docs\Pdf\user-gd.pdf Description: Describes TDS features, concepts, and provides procedures for using the TDS Discovery Interface. =· Tivoli Decision Support 2.1 Administrator Guide Filename on the CD-ROM: d:\Docs\Pdf\admin-gd.pdf Filename on your system: d:\Program Files\Tds 2.1\Docs\Pdf\admin-gd.pdf Description: Describes how to use the TDS Discovery Administrator. =· Tivoli Decision Support 2.1 Advanced Topics Download this document from the Tivoli Customer Support web site. Description: Describes how to use the TDS Discovery Administrator to customize cubes and reports. This document will be availabe from the Tivoli Customer Support web site after 15 December 1999. See the "How to contact Tivoli Customer Support" section for additional information. =· Other Discovery Guides Filename on your system: d:\Program Files\Tds 2.1\Guide docs Note: The Release Notes for a guide are also provided in PDF format in the root directory of the CD-ROM on which the guide is delivered. You can also obtain copies of the release notes and the technical reference for Tivoli Decision Support discovery guides by navigating to the Tivoli Decision Support web site (http://www.support.tivoli.com) as described in the "How to contact Tivoli Customer Support" section. Description: During the installation process for a Discovery Guide, the documentation is copied to your system. ============================================================ Installation ============================================================ Prerequisites: -------------- Before installing the Tivoli Decision Support product, review the installation prerequisites and procedures in the Tivoli Decision Support 2.1 Installation Guide: Tivoli Decision Support 2.1 CD-ROM: d:\Docs\PDF\Install.PDF It is recommended that this document be printed and used to guide the installer through the installation process. Patches: -------- After installing Tivoli Decision Support 2.1, access the Tivoli Systems Customer Support web site by navigating to the Tivoli Decision Support web site (http://www.support.tivoli.com) as described in the "How to contact Tivoli Customer Support" section. Review the readme.txt file for each patch to determine if the patch is required. =============================================================== Troubleshooting, Software Defects, Limitations, and Workarounds =============================================================== IMPORTANT: The Tivoli Decision Support 2.1 Release Notes provide a summary of important new features, any defects and workarounds, and changes to the product were not included in the bound documentation. Also refer to the Tivoli Decision Support 2.1 Installation Guide for detailed hardware and software requirements and detailed installation and configuration procedures. Refer to the Documentation section of this readme.txt file information on how to access this documentation on the Tivoli Decision Support 2.1 CD-ROM. ============================================================ UPDATES FOR TIVOLI DECISION SUPPORT DISCOVERY GUIDES ============================================================ Review this section before installing a Tivoli Decision Support Discovery Guide. -------------- 30 September 1999 -------------- Tivoli Decision Support for Server Performance Prediction (SPP) 1.0.1 - Distributed Monitoring Patches -------------------------------------------- Before using the SPP guide, you must install the DM patches and the DM Rollup Module provided in the following directory on the Tivoli Decision Support for SPP 1.0.1 CD-ROM: d:\Tivoli Distributed Monitor patches (where d: is the drive letter of your CD-ROM drive) The DM patch and DM Rollup Module patches include installation documentation. These documents are available in the patch subdirectories. -------------- 27 AUGUST 1999 -------------- To View the .PDF Documentation, Download the Latest Version of Adobe Acrobat Reader -------------------------------------------- If you encounter problems when opening the release notes or any other .PDF file that is delivered with a Tivoli Decision Support Guide or the Tivoli Decision Support product, you may have to download and install the latest version of the Adobe Acrobat Reader. Navigate to the Adobe web site (www.adobe.com), and download the latest version of the Adobe Acrobat Reader. ------------ 21 JULY 1999 ------------ DB2 Support Provided by TDS Guides ---------------------------------- The following guides provide support for DB2: · TDS for Event Management Version 1.0.1 · TDS for Software Deployment and Analysis Version 1.0.1 Differences Between the 1.0 and 1.0.1 Releases of the Event Management Guide ------------------------------------------------------------- This release of the Event Management guide provides support for DB2. The DB2 version of the guide is installed by selecting the following installation option: [Tivoli Decision Support for Event Management (DB2 Only)] ----- Note: If you have already installed and are working with the 1.0 version of the Event Management guide that supports Sybase and Oracle, DO NOT reinstall the guide. ----- The 1.0 version of the Event Management guide that supports Sybase and Oracle HAS NOT BEEN CHANGED in the 1.0.1 release. The Sybase/Oracle version of the guide is installed by selecting the following installation option: [Tivoli Decision Support for Event Management] Updated Release Notes The Release Notes have also been updated to include the DB2 information. See the "Documentation" section of this readme.txt file for additional information. Differences Between the 1.0 and 1.0.1 Releases of the Software Deployment Analysis Guide ------------------------------------------------------------- This release of the Software Deployment Analysis guide provides support for DB2. The DB2 version of the guide is installed by selecting the following installation option: [Tivoli Decision Support for Software Deployment Analysis (DB2 Only)] ----- Note: If you have already installed and are working with the 1.0 version of the Software Deployment Analysis guide that supports Sybase and Oracle, DO NOT reinstall the guide. ----- The 1.0 version of the Software Deployment Analysis guide that supports Sybase and Oracle HAS NOT CHANGED in the 1.0.1 release. The Sybase/Oracle version of the guide is installed by selecting the following installation option: [Tivoli Decision Support for Software Deployment Analysis] If you have already installed the 1.0 version of the guide that supports Sybase and Oracle, do not reinstall the guide. Updated Release Notes The Release Notes have also been updated to include the DB2 information. See the "Documentation" section of this readme.txt file for additional information. ------------ 16 JUNE 1999 ------------ Guide Cannot Be Installed ------------------------- After installing TDS, the following message appears in a Severe message box when you attempt to install a guide: · Unable to find the registry entry for TDS. Guide cannot be installed! 1. Click OK to close the Severe message box, and exit the guide setup program. 2. Start the Tivoli Discover Administrator or the Tivoli Discovery Interface. The Choose Shared Source Path dialog box appears. 3. Type the file path to the TDS shared source files in Shared Source Path text box. OR Click Browse, and select the file path to the TDS shared source files. Note: Contact your system administrator for the location of the TDS shared source files. 4. Click OK. The Import Discovery Guide dialog box appears. 5. Click NO. The Add Data Source dialog box appears. 6. Click NO. The TDS application you started in Step 2 appears. 7. Exit the application. 8. Install the guide using the installation procedure described in the guide release notes. ------------- 07 MARCH 1999 ------------- Calculating Relative Dates in a Report -------------------------------------- The Date Range parameter for a cube determines the time period that you want to examine. This parameter uses explicit values, a start date and end date, or a calculated value (for example, the last three months and the last six months). The calculated values are relative to the current date. The current period for a TDS cube is set using one of the following methods: - Use the Date Range parameter and the _dt.txt to set the current period as shown in the following table: If the Date Range parameter is defined then the resulting date in the for a query using... _dt.txt is the... --------------------- ------------------------------- Explicit Date Range ----> End Date Calculated Values ----> Calculated End Date No Date Range Parameter in the Cube ----> Date the Cube is Built Note: is defined as the name of the cube that is being built - If you want to use the date in the _dt.txt as the current period, then you must create a new query in the cube model. This query must use the _dt.txt as a local data file. Also, the Set the current period option must be set only for this query. - Use the Date Range parameter, but do not use the _dt.txt . This selects only records between the specific start date and end date, and sets the current period to the most recent date in the data. - Do not use either the Date Range parameter or the _dt.txt. This selects all the records, and sets the current period to the most recent date in the data. - Use the _dt.txt, but do not use the Date Range parameter. This selects all the records, and sets the current period to the date of the current cube build. For more information on how to set the current period and select records, see the TDS Administrator Guide document. INTERSOLV Inc. ODBC Driver Version 3.01 for Sybase -------------------------------------------------- If you experience problems with the INTERSOLV ODBC driver version 3.01 for Sybase, contact Tivoli Customer Support, and request the updated INTERSOLV ODBC driver version 3.01 for Sybase. For more information about this issue, please contact Tivoli Customer Support by sending an email to support@tivoli.com or by visiting the Tivoli Customer Support web site at http://www.support.tivoli.com. Please be sure to include your customer identification information. ============================================================ CONTACTING THE TIVOLI SYSTEMS CUSTOMER SUPPORT CENTER ============================================================ How to contact Tivoli Customer Support : ---------------------------------------- Note: Whenever contacting Tivoli Customer Support, please have your customer identification information available. · Access the Tivoli Customer Support home page at http://www.support.tivoli.com. After you link to and submit the customer registration form, you can access many customer support services on the World Wide Web. Refer to the Customer Support Handbook for a listing of Tivoli Customer Support services, hours of operation, and contact numbers. This handbook is available online at http://www.support.tivoli.com. · Send an e-mail to support@tivoli.com. · In the United States, call Tivoli Customer Support at 1-800-TIVOLI-8. · Outside the United States, refer to your Customer Support Handbook for a list of support numbers in your country. This handbook is available online at http://www.support.tivoli.com. How to provide comments and suggestions about our documentation: ---------------------------------------------------------------- We at Tivoli are very interested in hearing from you about your experience with Tivoli products, documentation, and services. We welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please send e-mail to pubs@tivoli.com. ---End Readme.txt---