IBM Tivoli Storage Manager for Windows

Version 6.3

Installation Guide

GC23-9785-03

IBM Tivoli Storage Manager for Windows

Version 6.3

Installation Guide

GC23-9785-03

Note: Before using this information and the product it supports, read the information in Notices on page 143.

This edition applies to Version 6.3 of IBM Tivoli Storage Manager (product number 5608-E01, 5608-E02, 5608-E03, 5608-E07) and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. This edition replaces GC23-9785-02. Copyright IBM Corporation 1993, 2011. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Preface . . . . . . . . . . . . . . . v
Who should read this guide . . . . Installable components . . . . . . Publications . . . . . . . . . . Tivoli Storage Manager publications . Support information . . . . . . . Getting technical training . . . . Searching knowledge bases . . . Contacting IBM Software Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v . v viii viii . x . x . xi xiii

| Configuring server options for server database | maintenance . . . . . . . . . . . . . . 45

Starting the server instance . . . . . . . . Starting the server by using Windows services. Stopping the server . . . . . . . . . . . Registering licenses . . . . . . . . . . . Preparing the system for backups . . . . . . Running multiple server instances on a single system . . . . . . . . . . . . . . . Monitoring the server . . . . . . . . . . . . . . . 46 47 48 48 48

. 49 . 50

New for Tivoli Storage Manager Version 6.3 . . . . . . . . . . . . . xv

Chapter 4. Installing a Tivoli Storage Manager server fix pack . . . . . . . 53

| Applying a fix pack to Tivoli Storage Manager V6 in
a clustered environment . . . . . . . . . . 54

Part 1. Installing and upgrading the | server . . . . . . . . . . . . . . . 1

Chapter 1. Planning to install the IBM Tivoli Storage Manager server . . . . . 3
What you should know first . . . . . . . . . 3 System requirements for the Tivoli Storage Manager server. . . . . . . . . . . . . . . . . 4 Running the installation prerequisite checker . . . 6 Work sheet for planning details for the Tivoli Storage Manager server . . . . . . . . . . . . . 6 Capacity planning . . . . . . . . . . . . 7 Estimating space requirements for the database . . 7 Recovery log space requirements . . . . . . 10 Monitoring space utilization for the database and recovery logs . . . . . . . . . . . . . 22 Server naming best practices. . . . . . . . . 23

| | | | | | |

Chapter 2. Installing the Tivoli Storage Manager server components . . . . . 25

Installing Tivoli Storage Manager by using the installation wizard . . . . . . . . . . Installing Tivoli Storage Manager by using the console installation wizard . . . . . . . Installing Tivoli Storage Manager in silent mode Installing silently using a batch script . . Server language locales . . . . . . . . Configuring a language package . . . . . . . . . . . 26 . . . . . 27 28 31 31 32

| | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 5. Upgrading to Tivoli Storage Manager Version 6.3 . . . . . . . . . 57

Upgrading from Tivoli Storage Manager Version 6.1 to 6.3 . . . . . . . . . . . . . . . . Upgrading from Tivoli Storage Manager Version 6.2 to 6.3 . . . . . . . . . . . . . . . . Upgrading Tivoli Storage Manager by using the installation wizard . . . . . . . . . . . . Upgrading Tivoli Storage Manager by using the console installation wizard . . . . . . . . . Upgrading Tivoli Storage Manager in silent mode Upgrading silently by using a batch script . . . Configuring Remote Execution Protocol on Windows Server 2008 . . . . . . . . . . . Upgrading Tivoli Storage Manager server V6.1 to V6.3 in a clustered environment . . . . . . . Upgrading Tivoli Storage Manager server V6.2 to V6.3 in a clustered environment . . . . . . . Removing GSKit Version 7 after upgrading to Tivoli Storage Manager V6.3 . . . . . . . . . . . 57 60 62 63 64 67 67 68 69 71

Chapter 6. Reverting from Version 6.3 to the previous Version 6 server. . . . 73

Steps for reverting to the previous server version. Additional recovery steps if you created new storage pools or enabled data deduplication . . . 73 . 75

Chapter 3. Taking the first steps after you install Tivoli Storage Manager . . . 33
Creating the user ID and directories for the server instance . . . . . . . . . . . . . . Configuring Tivoli Storage Manager . . . . . Configuring Tivoli Storage Manager using the configuration wizard . . . . . . . . . Configuring the server instance by using the Management Console . . . . . . . . . Configuring the server instance manually . . . 34 . 35 . 36 . 37 . 39

Chapter 7. Uninstalling Tivoli Storage Manager . . . . . . . . . . . . . . 77

Uninstalling and reinstalling Tivoli Storage Manager 78

Part 2. Installing and upgrading Tivoli Monitoring for Tivoli Storage Manager . . . . . . . . . . . . . 81

Copyright IBM Corp. 1993, 2011

iii

| | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager . . . . . . 83

Planning to install . . . . . . . . . . . . 84 Installation scenarios . . . . . . . . . . 85 System requirements for Tivoli Monitoring for Tivoli Storage Manager . . . . . . . . . 88 Capacity planning . . . . . . . . . . . 90 Installation work sheet . . . . . . . . . 91 Running the prerequisite checker . . . . . . 93 Installing using the installation wizard . . . . . 93 Taking the first steps after installation . . . . . 95 Creating and configuring the agent instance . . . 95 Creating and configuring the agent instance on Windows systems . . . . . . . . . . . 96 Next steps after creating and configuring the agent instance . . . . . . . . . . . . . . . 97 Installing monitoring agents . . . . . . . . . 98 Installing monitoring agents on Tivoli Storage Manager servers . . . . . . . . . . . . 99 Installing monitoring agents on existing IBM Tivoli Monitoring servers . . . . . . . . 100 Installing monitoring agents and application support files on existing IBM Tivoli Monitoring servers . . . . . . . . . . . . . . 101 Installing software for custom BIRT reports . . . 102 Uninstalling Tivoli Monitoring for Tivoli Storage Manager . . . . . . . . . . . . . . . 102 Uninstalling Tivoli Monitoring for Tivoli Storage Manager . . . . . . . . . . . . . . 102

| | |

Installing the Administration Center . . . . . Installing the Administration Center using the installation wizard. . . . . . . . . . Installing the Administration Center using the console installation wizard . . . . . . . Installing the Administration Center in silent mode . . . . . . . . . . . . . . Configuring LDAP user authentication . . . . Verifying the Administration Center installation Starting and stopping the Tivoli Integrated Portal server . . . . . . . . . . . . . . . Defining Administration Center users to the Tivoli Integrated Portal . . . . . . . . . . . Uninstalling the Administration Center . . . .

. 116 . 117 . 118 . 118 . 119 121 . 122 . 123 . 124

Chapter 11. Upgrading the Administration Center to Version 6.3 . 127

Upgrading the Administration Center . . . . Obtaining user account information in a Version 6.1 or later Administration Center . . . . . Obtaining user account information in a Version 5.5 Administration Center . . . . . . . . Defining administrative user accounts to the Version 6.3 Administration Center . . . . . Server connections to the Administration Center . 128 . 129 . 129 . 130 130

Part 4. Appendixes . . . . . . . . 133

Appendix A. Installation log files . . . 135 Appendix B. Services associated with the Tivoli Storage Manager server . . 139 Appendix C. Accessibility features for the Tivoli Storage Manager product family. . . . . . . . . . . . . . . 141 Notices . . . . . . . . . . . . . . 143
Trademarks . . . . . . . . . . . . . . 145

Chapter 9. Upgrading Tivoli Monitoring for Tivoli Storage Manager to Version 6.3 . . . . . . . . . . . 105
| Upgrade scenarios. . . . . . . . . . . . 105
Upgrading to version 6.3 on Windows systems . . 107

| Upgrading the monitoring agent . . . . . . . 108

Part 3. Installing and upgrading the Administration Center . . . . . 111

Chapter 10. Installing and configuring the Administration Center . . . . . . 113
Administration Center system requirements . . . 114

Glossary . . . . . . . . . . . . . 147 Index . . . . . . . . . . . . . . . 149

| Running the installation prerequisite checker . . . 114 | Administration Center work sheet . . . . . . 115

iv

IBM Tivoli Storage Manager for Windows: Installation Guide

Preface
This publication contains installation and configuration instructions for the Tivoli Storage Manager server and client API, server languages, and other Tivoli Storage Manager components. Instructions for installing the Tivoli Storage Manager license, device driver, storage agent, the Tivoli Integrated Portal and Administration Center, and Tivoli Monitoring for Tivoli Storage Manager are also included in this publication.

Who should read this guide

This publication is intended for a system administrator installing and configuring a Version 6.3 Tivoli Storage Manager server, the Administration Center, or Tivoli Monitoring for Tivoli Storage Manager, or upgrading from Tivoli Storage Manager Version 6.1 or 6.2. If you are upgrading an existing 5.5.x Tivoli Storage Manager server to Tivoli Storage Manager Version 6.3, see the Upgrade and Migration Guide for V5 Servers. If you are upgrading a Tivoli Storage Manager Version 6.1 or Version 6.2 server to a newer version, see Chapter 5, Upgrading to Tivoli Storage Manager Version 6.3, on page 57. If you are upgrading an existing Tivoli Storage Manager Version 6.3 server to a later level of Version 6.3, see Chapter 4, Installing a Tivoli Storage Manager server fix pack, on page 53. If you are installing Tivoli Monitoring for Tivoli Storage Manager, see Chapter 8, Installing Tivoli Monitoring for Tivoli Storage Manager, on page 83. If you are upgrading Tivoli Monitoring for Tivoli Storage Manager, see Chapter 9, Upgrading Tivoli Monitoring for Tivoli Storage Manager to Version 6.3, on page 105. If you are installing the Administration Center, see Chapter 10, Installing and configuring the Administration Center, on page 113. If you are upgrading the Administration Center, see Chapter 11, Upgrading the Administration Center to Version 6.3, on page 127.

Installable components
The IBM Tivoli Storage Manager server, client API, and licenses are required components. Other, optional components and products are also available in separate packages. You can install the following components for Tivoli Storage Manager V6.3: v Tivoli Storage Manager server v Tivoli Storage Manager server languages v Tivoli Storage Manager licenses v Tivoli Storage Manager devices
Copyright IBM Corp. 1993, 2011

v Tivoli Storage Manager storage agent v Tivoli Storage Manager Administration Center v Tivoli Monitoring for Tivoli Storage Manager | | | | | | | | It is not possible to do the following items: v Install a Tivoli Storage Manager server and Tivoli Monitoring for Tivoli Storage Manager on the same system v Install a Tivoli Storage Manager server and the Administration Center on the same system It is possible to install the Administration Center and Tivoli Monitoring for Tivoli Storage Manager on the same system. To use them together, they must both be Version 6.3. Table 1 describes all the installable components. These components are located in several different installation packages.
Table 1. Tivoli Storage Manager installable components Tivoli Storage Manager component: Server (required) Description: Additional information:

Includes the database, Refer to the Tivoli Storage Manager server overview in the management console, Administrator's Guide. client API, GSKit, and tools to help you configure and manage Tivoli Storage Manager. Each language pack (one See Server language locales on page 31. for each language) contains language-specific information for the server and the management console. Refer to the chapter on managing server operations in the Includes support for all Administrator's Guide. Tivoli Storage Manager licensed features. After you install this package, you must configure the licenses you have purchased. Extends Tivoli Storage Manager media management capability. The Tivoli Storage Manager device driver is preferred for use with the Tivoli Storage Manager server. The device driver is required for use with automated library devices and optical disk devices, unless you are using Windows Removable Storage Manager to manage media. The device driver is not installed by default when the Tivoli Storage Manager devices component is selected. You must select Yes on the device window to install the Tivoli Storage Manager device driver. Refer to the chapter on adding devices in the Administrator's Guide. A list of devices supported by this driver is available from the Tivoli Storage Manager website, at http://www.ibm.com/ support/entry/portal/Overview/Software/Tivoli/ Tivoli_Storage_Manager.

Language pack (optional)

Licenses (required)

Devices (optional)

vi

IBM Tivoli Storage Manager for Windows: Installation Guide

Table 1. Tivoli Storage Manager installable components (continued) Tivoli Storage Manager component: Storage agent (optional) Description: Additional information:

Installs the component that Refer to the Storage Agent User's Guide. allows client systems to write data directly to, or read data directly from, storage devices that are attached to a storage area network (SAN). Remember: The IBM Tivoli Storage Manager for Storage Area Networks is a separately licensed product. Installs the following components automatically to help you configure and manage Tivoli Storage Manager: v Tivoli Integrated Portal v Integrated Solutions Console v WebSphere Application Server Refer to Administration Center system requirements on page 114.

Administration Center (optional)

| | |

v Tivoli Storage Manager client performance monitor Optional components such as Tivoli Common Reporting are also available. Remember: The Administration Center is on a separate DVD. Tivoli Monitoring for Provides reports and real Tivoli Storage Manager time monitoring (optional) information about Tivoli Storage Manager servers and client activity. Remember: Tivoli Monitoring for Tivoli Storage Manager is on a separate DVD. Refer to Chapter 8, Installing Tivoli Monitoring for Tivoli Storage Manager, on page 83.

Preface

vii

Publications
Publications for the IBM Tivoli Storage Manager family of products are available online. The IBM Tivoli Storage Manager product family includes IBM Tivoli Storage FlashCopy Manager, IBM Tivoli Storage Manager for Space Management, IBM Tivoli Storage Manager for Databases, and several other storage management products from IBM Tivoli. To search all publications, go to the Tivoli Storage Manager information center at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3. You can download PDF versions of publications from the Tivoli Storage Manager information center or from the IBM Publications Center at http://www.ibm.com/ shop/publications/order/. Go to Tivoli Documentation Central to find information centers that contain official product documentation for current and previous versions of Tivoli products, including the Tivoli Storage Manager product family. You can find Tivoli Documentation Central at https://www.ibm.com/developerworks/wikis/display/ tivolidoccentral/Home. You can also order some related publications from the IBM Publications Center website. The website provides information about ordering publications from countries other than the United States. In the United States, you can order publications by calling 1-800-879-2755.

Tivoli Storage Manager publications

The following tables list the publications that make up the Tivoli Storage Manager library.
Table 2. Tivoli Storage Manager server publications Publication title IBM Tivoli Storage Manager for AIX Installation Guide IBM Tivoli Storage Manager for AIX Administrator's Guide IBM Tivoli Storage Manager for AIX Administrator's Reference IBM Tivoli Storage Manager for HP-UX Installation Guide IBM Tivoli Storage Manager for HP-UX Administrator's Guide IBM Tivoli Storage Manager for HP-UX Administrator's Reference IBM Tivoli Storage Manager for Linux Installation Guide IBM Tivoli Storage Manager for Linux Administrator's Guide IBM Tivoli Storage Manager for Linux Administrator's Reference IBM Tivoli Storage Manager for Oracle Solaris Installation Guide IBM Tivoli Storage Manager for Oracle Solaris Administrator's Guide IBM Tivoli Storage Manager for Oracle Solaris Administrator's Reference IBM Tivoli Storage Manager for Windows Installation Guide IBM Tivoli Storage Manager for Windows Administrator's Guide IBM Tivoli Storage Manager for Windows Administrator's Reference IBM Tivoli Storage Manager for z/OS Media Installation and User's Guide

Order number GC23-9781 SC23-9769 SC23-9775 GC23-9782 SC23-9770 SC23-9776 GC23-9783 SC23-9771 SC23-9777 GC23-9784 SC23-9772 SC23-9778 GC23-9785 SC23-9773 SC23-9779 SC27-4018

viii

IBM Tivoli Storage Manager for Windows: Installation Guide

Table 2. Tivoli Storage Manager server publications (continued) Publication title IBM Tivoli Storage Manager Upgrade and Migration Guide for V5 Servers IBM Tivoli Storage Manager Integration Guide for Tivoli Storage Manager FastBack Table 3. Tivoli Storage Manager storage agent publications Publication title IBM Tivoli Storage Manager for SAN for AIX Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for HP-UX Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Linux Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Oracle Solaris Storage Agent User's Guide IBM Tivoli Storage Manager for SAN for Windows Storage Agent User's Guide Table 4. Tivoli Storage Manager client publications Publication title IBM Tivoli Storage Manager for UNIX and Linux: Backup-Archive Clients Installation and User's Guide IBM Tivoli Storage Manager for Windows: Backup-Archive Clients Installation and User's Guide IBM Tivoli Storage Manager Using the Application Programming Interface Order number SC23-9791 SC23-9792 SC23-9793 Order number SC23-9797 SC23-9798 SC23-9799 SC23-9800 SC23-9553 Order number GC27-4017 SC27-2828

IBM Tivoli Storage Manager for Space Management for UNIX and Linux: SC23-9794 Users Guide IBM Tivoli Storage Manager HSM for Windows Administration Guide Table 5. Tivoli Storage Manager data protection publications Publication title IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SQL Server Installation and Users Guide Order number GC27-4010 SC23-9795

IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC27-4019 UNIX and Linux Installation and Users Guide IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for SC27-4020 Windows Installation and Users Guide IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft Exchange Server Installation and Users Guide GC27-4009

IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino SC27-4021 UNIX and Linux Installation and Users Guide IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino for Windows Installation and Users Guide IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SAP Installation and Users Guide for DB2 SC27-4022 SC33-6341

Preface

ix

Table 5. Tivoli Storage Manager data protection publications (continued) Publication title IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SAP Installation and Users Guide for Oracle IBM Tivoli Storage Manager for Virtual Environments Installation and Users Guide IBM Tivoli Storage Manager for Microsoft SharePoint Guide Order number SC33-6340 SC27-2898 N/A

Table 6. IBM Tivoli Storage Manager troubleshooting and tuning publications Publication title IBM Tivoli Storage Manager Problem Determination Guide IBM Tivoli Storage Manager Performance Tuning Guide IBM Tivoli Storage Manager Client Messages and Application Programming Interface Return Codes IBM Tivoli Storage Manager Server Messages and Error Codes IBM Tivoli Storage Manager for Mail: Data Protection for Microsoft Exchange Server Messages IBM Tivoli Storage Manager for Databases: Data Protection for Microsoft SQL Server Messages IBM Tivoli Storage Manager for Databases: Data Protection for Oracle Messages IBM Tivoli Storage Manager for Mail: Data Protection for Lotus Domino Messages IBM Tivoli Storage Manager for Enterprise Resource Planning: Data Protection for SAP Messages Order number GC23-9789 GC23-9788 SC27-2878 SC27-2877 GC27-4011 GC27-4012 SC27-4014 SC27-4015 SC27-4016

Note: You can find information about IBM System Storage Archive Manager at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3/ c_complydataretention_ovr.html.

Support information
You can find support information for IBM products from various sources. Start at the IBM Support Portal: http://www.ibm.com/support/entry/portal/. You can select the products that you are interested in and search for a wide variety of relevant information.

Getting technical training

Information about Tivoli technical training courses is available online. Go to the following websites to sign up for training, ask questions, and interact with others who use IBM storage products. Tivoli software training and certification Choose from instructor led, online classroom training, self-paced Web classes, Tivoli certification preparation, and other training options at http://www.ibm.com/software/tivoli/education/

IBM Tivoli Storage Manager for Windows: Installation Guide

Tivoli Support Technical Exchange Technical experts share their knowledge and answer your questions in webcasts at http://www.ibm.com/software/sysmgmt/products/support/ supp_tech_exch.html. Storage Management community Interact with others who use IBM storage management products at http://www.ibm.com/developerworks/servicemanagement/sm/ index.html Global Tivoli User Community Share information and learn from other Tivoli users throughout the world at http://www.tivoli-ug.org/. IBM Education Assistant View short "how to" recordings designed to help you use IBM software products more effectively at http://publib.boulder.ibm.com/infocenter/ ieduasst/tivv1r0/index.jsp

Searching knowledge bases

If you have a problem with your Tivoli Storage Manager family product, there are several knowledge bases that you can search. Begin by searching the Tivoli Storage Manager Information Center at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3. From this website, you can search the current Tivoli Storage Manager documentation.

Searching the Internet

If you cannot find an answer to your question in the IBM Tivoli Storage Manager information center, search the Internet for the information that might help you resolve your problem. To search multiple Internet resources, go to the IBM support website at http://www.ibm.com/support/entry/portal/. You can search for information without signing in. Sign in using your IBM ID and password if you want to customize the site based on your product usage and information needs. If you do not already have an IBM ID and password, click Sign in at the top of the page and follow the instructions to register. From the support website, you can search various resources including: v IBM technotes v IBM downloads v IBM Redbooks publications v IBM Authorized Program Analysis Reports (APARs) Select the product and click Downloads to search the APAR list. If you still cannot find a solution to the problem, you can search forums and newsgroups on the Internet for the latest information that might help you find problem resolution. An independent user discussion list, ADSM-L, is hosted by Marist College. You can subscribe by sending an email to [email protected]. The body of the message must contain the following text: SUBSCRIBE ADSM-L your_first_name your_family_name.
Preface

xi

To share your experiences and learn from others in the Tivoli Storage Manager and Tivoli Storage FlashCopy Manager user communities, go to the following wikis: Tivoli Storage Manager wiki http://www.ibm.com/developerworks/wikis/display/ tivolistoragemanager Tivoli Storage FlashCopy Manager wiki https://www.ibm.com/developerworks/mydeveloperworks/wikis/home/ wiki/Tivoli Storage FlashCopy Manager

Using IBM Support Assistant

IBM Support Assistant is a complimentary software product that can help you with problem determination. It is available for some Tivoli Storage Manager and Tivoli Storage FlashCopy Manager products. To learn about which products are supported, go to the IBM Support Assistant download web page at http://www.ibm.com/software/support/isa/ download.html. IBM Support Assistant helps you gather support information when you must open a problem management record (PMR), which you can then use to track the problem. The product-specific plug-in modules provide you with the following resources: v Support links v Education links v Ability to submit problem management reports You can find more information at the IBM Support Assistant website: http://www.ibm.com/software/support/isa/ You can also install the stand-alone IBM Support Assistant application on any workstation. You can then enhance the application by installing product-specific plug-in modules for the IBM products that you use. Find add-ons for specific products at http://www.ibm.com/support/docview.wss?uid=swg27012689.

Finding product fixes

A product fix to resolve your problem might be available from the IBM software support website. You can determine what fixes are available by checking the IBM software support website at http://www.ibm.com/support/entry/portal/. v If you previously customized the site based on your product usage: 1. Click the link for your product, or a component for which you want to find a fix. 2. Click Downloads, and then click Fixes by version. v If you have not customized the site based on your product usage, click Downloads and search for your product.

xii

IBM Tivoli Storage Manager for Windows: Installation Guide

Receiving notification of product fixes

You can receive notifications about fixes, flashes, upgrades, and other news about IBM products. To sign up to receive notifications about IBM products, follow these steps: 1. From the support page at http://www.ibm.com/support/entry/portal/, click Sign in to create, manage, or view your subscriptions in the Notifications pane. 2. Sign in using your IBM ID and password. If you do not have an ID and password, click register now and complete the registration process. 3. Click Manage all my subscriptions in the Notifications pane. 4. Click the Subscribe tab and then click Tivoli. 5. Select the products for which you want to receive notifications and click Continue. 6. Specify your notification preferences and click Submit.

Contacting IBM Software Support

You can contact IBM Software Support if you have an active IBM subscription and support contract and if you are authorized to submit problems to IBM. To obtain help from IBM Software Support, complete the following steps: 1. Ensure that you have completed the following prerequisites: a. Set up a subscription and support contract. b. Determine the business impact of your problem. c. Describe your problem and gather background information. 2. Follow the instructions in Submitting the problem to IBM Software Support on page xiv.

Setting up a subscription and support contract

Set up a subscription and support contract. The type of contract that you need depends on the type of product you have. For IBM distributed software products (including, but not limited to, IBM Tivoli, Lotus, and Rational products, as well as IBM DB2 and IBM WebSphere products that run on Microsoft Windows or on operating systems such as AIX or Linux), enroll in IBM Passport Advantage in one of the following ways: v Online: Go to the Passport Advantage website at http://www.ibm.com/ software/lotus/passportadvantage/, click How to enroll, and follow the instructions. v By telephone: You can call 1-800-IBMSERV (1-800-426-7378) in the United States. For the telephone number to call in your country, go to the IBM Software Support Handbook web page at http://www14.software.ibm.com/webapp/ set2/sas/f/handbook/home.html and click Contacts.

Preface

xiii

Determining the business impact

When you report a problem to IBM, you are asked to supply a severity level. Therefore, you must understand and assess the business impact of the problem you are reporting.
Severity 1 Critical business impact: You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. Significant business impact: The program is usable but is severely limited. Some business impact: The program is usable with less significant features (not critical to operations) unavailable. Minimal business impact: The problem causes little impact on operations, or a reasonable circumvention to the problem has been implemented.

Severity 2 Severity 3 Severity 4

Describing the problem and gathering background information

When explaining a problem to IBM, it is helpful to be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions: v What software versions were you running when the problem occurred? v Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. v Can the problem be re-created? If so, what steps led to the failure? v Have any changes been made to the system? For example, hardware, operating system, networking software, and so on. v Are you using a workaround for this problem? If so, be prepared to explain it when you report the problem.

Submitting the problem to IBM Software Support

You can submit the problem to IBM Software Support online or by telephone. Online Go to the IBM Software Support website at http://www.ibm.com/ support/entry/portal/Open_service_request/Software/ Software_support_(general). Sign in to access IBM Service Requests and enter your information into the problem submission tool. By telephone For the telephone number to call in your country, go to the IBM Software Support Handbook at http://www14.software.ibm.com/webapp/set2/sas/ f/handbook/home.html and click Contacts.

xiv

IBM Tivoli Storage Manager for Windows: Installation Guide

New for Tivoli Storage Manager Version 6.3

This section summarizes changes that have been made to IBM Tivoli Storage Manager V6.3. These changes affect the Tivoli Storage Manager server, the Administration Center, Tivoli Monitoring for Tivoli Storage Manager, and the upgrade from V6.1 to V6.3 and from V6.2 to V6.3. Any updates that have been made to the information since the previous edition are marked with a vertical bar ( | ) in the left margin. The following installation-related features are new for Tivoli Storage Manager in V6.3. For a complete list of new V6.3 features, see the "Whats new in the products" topic in the Tivoli Storage Manager information center at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | End user license agreement (EULA) The license agreement no longer needs to be accepted for the Administration Center and for the Tivoli Monitoring for Tivoli Storage Manager feature. The Tivoli Storage Manager V6.3 server installation wizard now has a separate license agreement for the following products: v Tivoli Storage Manager v Tivoli Storage Manager Extended Edition v System Storage Archive Manager v Tivoli Storage Manager for Storage Area Networks Installation prerequisite checker The Tivoli Storage Manager prerequisite checker is an independent tool that can be run before starting the Tivoli Storage Manager installation. The prerequisite checker scans your system for various installation requirements and produces a summary of checks that were completed. It can be used in graphical user interface (GUI) and console mode only. The tool checks installation requirements for the Tivoli Storage Manager server, the Administration Center, and Tivoli Monitoring for Tivoli Storage Manager. For details, see Running the installation prerequisite checker on page 6. Performance Monitor The Performance Monitor is a component that is installed with the Tivoli Storage Manager Administration Center to monitor the performance of Tivoli Storage Manager clients. For details about Performance Monitor, search the Tivoli Storage Manager information center at http://publib.boulder.ibm.com/infocenter/tsminfo/ v6r3. Processor value unit counting For those users who purchased Tivoli Storage Manager based on an IBM processor value unit (PVU)-based licensing program, client node processor information and a report help summarize the estimated licenses. For details about processor value unit counting, search the Tivoli Storage Manager information center at http://publib.boulder.ibm.com/infocenter/ tsminfo/v6r3. Tivoli Integrated Portal V2.1 With Tivoli Integrated Portal V2.1, you can now access the Administration
Copyright IBM Corp. 1993, 2011

xv

| | | |

Center using Internet Explorer 8 and Mozilla Firefox 3.5. All browsers used with Tivoli Integrated Portal 1.1.1 are supported in this latest version For Administration Center system requirements, see the following website: http://www.ibm.com/support/docview.wss?uid=swg21515628.

xvi

IBM Tivoli Storage Manager for Windows: Installation Guide

Part 1. Installing and upgrading the server

Install and upgrade the Tivoli Storage Manager server.

Copyright IBM Corp. 1993, 2011

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

Install the Tivoli Storage Manager server component on the computer that manages storage devices and the Tivoli Storage Manager client code on every workstation that transfers data to Tivoli Storage Manager server-managed storage. Tivoli Storage Manager server maintenance releases, client software, and publications are available from the Tivoli Storage Manager website at http://www.ibm.com/support/entry/portal/Overview/Software/Tivoli/ Tivoli_Storage_Manager. | | | | | | | Allow approximately this much time to silently install a Tivoli Storage Manager Version 6.3 server, using this guide: 15 - 30 minutes Your environment might produce different results than that obtained in the labs. A silent upgrade from V6.2 to V6.3 takes approximately: 10 - 35 minutes Your environment might produce different results than that obtained in the labs.

What you should know first

Before installing IBM Tivoli Storage Manager for the first time, be familiar with your operating systems, storage devices, communication protocols, and system configurations. | | | | | | | | | | | | If you are upgrading a Tivoli Storage Manager server, refer to the following documentation: v V5.5 to V6.3, the Upgrade and Migration Guide for V5 Servers. v V6.1 to V6.3, Upgrading from Tivoli Storage Manager Version 6.1 to 6.3 on page 57. v V6.2 to V6.3, Upgrading from Tivoli Storage Manager Version 6.2 to 6.3 on page 60. v V6.3 to a later level of V6.3, Chapter 4, Installing a Tivoli Storage Manager server fix pack, on page 53. You can install the Tivoli Storage Manager server on a domain controller. The Tivoli Storage Manager server can have heavy processor usage, however, and that might affect and stall other applications. Restriction: You cannot install and run the Version 6.3 server on a system that already has DB2 installed on it, whether DB2 was installed by itself or as part of some other application. The Version 6.3 server requires the installation and use of the DB2 version that is packaged with the Version 6.3 server. No other version of DB2 can exist on the system. Users who are experienced DB2 administrators can choose to perform advanced SQL queries and use DB2 tools to monitor the database. However, do not use DB2 tools to change DB2 configuration settings from those that are preset by Tivoli
Copyright IBM Corp. 1993, 2011

Storage Manager, or alter the DB2 environment for Tivoli Storage Manager in other ways, such as with other products. The Tivoli Storage Manager Version 6.3 server has been built and tested extensively using the data definition language (DDL) and database configuration that Tivoli Storage Manager deploys. Attention: Do not alter the DB2 software that is installed with Tivoli Storage Manager installation packages and fix packs. Do not install or upgrade to a different version, release, or fix pack of DB2 software because doing so can damage the database.

System requirements for the Tivoli Storage Manager server

The Tivoli Storage Manager server can require a large amount of memory, network bandwidth, and processor resources. In many cases, the server performs best when other applications are not installed on the same system.

Hardware requirements
These tables list the minimum hardware and software requirements for the installation of a Tivoli Storage Manager server. Use these requirements as a starting point. You can find the most current information at Tivoli Storage Manager Supported Operating Systems. Table 7 describes the minimum hardware requirements needed for your Windows system. For more details about planning disk space, see Capacity planning on page 7.
Table 7. Hardware requirements Type of hardware Hardware Disk Space Hardware requirements An AMD64 or Intel EMT-64 processor v At least 3 GB of free disk storage (for a typical installation) v 200 MB temporary directory space v 2 GB partition size in the C:\ drive v 300 MB in the instance directory Significant additional disk space is required for database and log files. The size of the database depends on the number of client files to be stored and the method by which the server manages them. The default active log space is 16 GB, the minimum that is needed for most workloads and configurations. Allocate at least three times the active log space for the archive log (48 GB). Ensure that you have sufficient resources if you are using deduplication or expect a heavy client workload. For optimal performance and to facilitate I/O, specify at least four separate directories or Logical Unit Numbers (LUNs) to be used by the database and logs. By making these specifications, I/O is balanced across multiple directories or mounts.

| |

Ensure that you see the capacity planning section for more details about disk space.

IBM Tivoli Storage Manager for Windows: Installation Guide

Table 7. Hardware requirements (continued) Type of hardware Memory Hardware requirements 64-bit Windows systems v 12 GB. v 16 GB if you are using deduplication.

| | |

v At least 32 GB for heavily used servers. Using 32 GB or more of memory enhances performance of the Tivoli Storage Manager server database inventory. v If you plan to run multiple instances, each instance requires the memory listed for one server. Multiply the memory for one server by the number of instances planned for the system.

Software requirements
Table 8 describes the minimum software requirements needed for your Windows system.
Table 8. Software requirements Type of software Operating System Minimum software requirements One of the following operating systems: v Microsoft Windows Server 2008: Standard, Enterprise, or Datacenter x64 Edition (64-bit) v Microsoft Windows Server 2008 R2: Standard, Enterprise, or Datacenter Edition Communication At least one of the following communication protocols (installed by protocol default with the current Windows operating systems): v Named Pipes v TCP/IP Version 4 or Version 6 Web browser A web browser to retrieve an online installation package. The following browsers are supported: v Microsoft Internet Explorer 7.0 or later v Firefox 3.5 or later Your browser must support the server code page. If your browser does not support the server code page, the windows might be unreadable. If your browser meets these requirements but does not correctly display a Tivoli Storage Manager web-based interface, consider using a different browser. System functions The Windows system functions, such as Device Manager, are supported on the 64-bit Tivoli Storage Manager Console. Normal Windows system functions are available for the 64-bit server using the Manage Computer function of the Windows system.

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Running the installation prerequisite checker

The installation prerequisite checker is an optional tool that verifies the operating system, the amount of free disk space for the installation, and other prerequisites. To ensure that your system environment is appropriate for the installation, you can run the prerequisite checker before each installation. Tip: The prerequisite checker verifies only the minimum memory that is necessary. More memory is required for additional tasks. The prerequisite checker presents a summary of results at the end of the check. Any changes that are required in your environment before the installation are listed. Any new directories that are required for the installation are created. To run the prerequisite checker, complete the following steps. 1. Ensure that the appropriate installation package is downloaded and that its files are extracted. A prerequisite checker is part of the installation package. 2. Choose the graphical interface (the default) or console method to start the installation, and follow the wizard instructions to complete the installation: v Issue this command to start the installation wizard using a graphical interface:
prereqcheck.exe

Or, double-click the prereqcheck.exe file. v Issue this command to start the installation wizard using the console method:
prereqcheck.exe -i console

3. Select the language for the prerequisite checker user interface. 4. In the welcome and disclaimer panels, review the statements and accept them. If the Prerequisite Results page indicates that your system passed the checks, you are ready to start the installation. If an error message is shown in the Prerequisite Results page, make the required corrections before continuing with the installation. The summary page lists the errors and directs you to an error log file. If you used the default directory, the log file can be found at this location: The installation directory; look for the file prereqcheck.log

Work sheet for planning details for the Tivoli Storage Manager server
You can use the work sheet to help you plan the amount and location of storage needed for the Tivoli Storage Manager server. You can also use it to keep track of names and user IDs.
Item The database Active log Archive log Optional: Log mirror for the active log Space required Location

IBM Tivoli Storage Manager for Windows: Installation Guide

Item Optional: Secondary archive log (failover location for archive log)

Space required

Location

Item The instance user ID for the server, which is the ID you use to start and run the Tivoli Storage Manager server The home directory for the server, which is the directory that contains the instance user ID The database instance name The instance directory for the server, which is a directory that contains files specifically for this server instance (the server options file and other server-specific files) Server name, use a unique name for each server

Names and user IDs

Location

| | | | | | | | | | | | | | | | | | | | | | | |

Capacity planning
Capacity planning for Tivoli Storage Manager includes database and recovery log requirements. In Tivoli Storage Manager, the term recovery log refers to the active log, the active log mirror, the archive log, and the archive failover log. The active log, the archive log, and the failover archive log are also known as transaction logs.

Estimating space requirements for the database

To estimate space requirements for the database, you can use the maximum number of files that can be in server storage at one time or you can use storage pool capacity. Consider using at least 25 GB for the initial database space. Provision file system space appropriately. A database size of 25 GB is adequate for a test environment or a library-manager-only environment. For a production server supporting client workloads, the database size is expected to be larger. For information about sizing the database in a production environment based on the number of files and on storage pool size, see the following topics.

Estimating database space requirements based on the number of files

If you can estimate the maximum number of files that might be in server storage at a time, you can use that number to estimate space requirements for the database. To estimate space requirements for the database based on the maximum number of files in server storage, use the following guidelines: v 600 - 1000 bytes for each stored version of a file. v 100 - 200 bytes for each cached file, copy storage pool file, active-data pool file, and deduplicated file.
Chapter 1. Planning to install the IBM Tivoli Storage Manager server

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v Additional space is required for database optimization to support varying data-access patterns and to support server back-end processing of the data. The amount of additional space is equal to 50% of the estimate for the total number of bytes for file objects. In the following example for a single client, the calculations are based on the maximum values in the preceding guidelines. The calculations do not take into account the possible use of file aggregation. In general, aggregating small files reduces the amount of required database space. File aggregation does not affect space-managed files. Calculations are presented in the following steps: 1. Calculate the number of file versions: a. Calculate the number of backed-up files: As many as 500,000 client files might be backed up at a time. Storage policies call for keeping up to three copies of backed up files:
500,000 files x 3 copies = 1,500,000 files

b. Calculate the number of archive files. As many as 100,000 client files might be archived copies. c. Calculate the number of space-managed files. As many as 200,000 client files might be migrated from client workstations. Using 1000 bytes per file, the total amount of database space required for the files that belong to the client is 1.8 GB:
(1,500,000 + 100,000 + 200,000) x 1000 = 1.8 GB

2. Calculate the number of cached files, copy storage-pool files, active-data pool files, and deduplicated files a. Calculate the number of cached copies. Caching is enabled in a 5 GB disk storage pool. The high and low migration thresholds of the pool are 90% and 70%. Thus, 20% of the disk pool, or 1 GB, is occupied by cached files. If the average file size is about 10 KB, approximately 100,000 files are in cache at any one time:
100,000 files x 200 bytes = 19 MB

b. Calculate the number of copy storage-pool files. All primary storage pools are backed up to the copy storage pool:
(1,500,000 + 100,000 + 200,000) x 200 bytes = 343 MB

c. Calculate the number of active storage-pool files. All the active client-backup data in primary storage pools is copied to the active-data storage pool. Assume that 500,000 versions of the 1,500,000 backup files in the primary storage pool are active:
500,000 x 200 bytes = 95 MB

d. Calculate the number of deduplicated files. Assume that a deduplicated storage pool contains 50,000 files:
50,000 x 200 bytes = 10 MB

Based on the preceding calculations, about 0.5 GB of additional database space is required for the clients cached files, copy storage-pool files, and active-data pool files, and deduplicated files. 3. Calculate the amount of additional space that is required for database optimization. To provide optimal data access and management by the server, additional database space is required. The amount of additional database space is equal to 50% of the total space requirements for file objects.
(1.8 + 0.5) x 50% = 1.2 GB

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

4. Calculate the total amount of database space that is required for the client is approximately 3.5 GB:
1.8 + 0.5 + 1.2 = 3.5 GB

5. Calculate the total amount of database space that is required for all clients. If the client that was used in the preceding calculations is typical and you have 500 clients, for example, you can use the following calculation to estimate the total amount of database space required for all clients:
500 x 3.5 = 1.7 TB

Tip: In the preceding examples, the results are estimates. The actual size of the database might differ from the estimate because of factors such as the number of directories and the length of the path and file names. Periodically monitor your database and adjust its size as necessary. During normal operations, the Tivoli Storage Manager server might require temporary database space. This space is needed for the following reasons: v To hold the results of sorting or ordering that are not already being kept and optimized in the database directly. The results are temporarily held in the database for processing. v To give administrative access to the database through one of the following methods: A DB2 open database connectivity (ODBC) client A Java database connectivity (JDBC) client Structured Query Language (SQL) to the server from an administrative-client command line Consider using an additional 50 GB of temporary space for every 500 GB of space for file objects and optimization. See the guidelines in the following table. In the example used in this topic, a total of 1.7 TB of database space is required for file objects and optimization for 500 clients. Based on that calculation, 200 GB is required for temporary space. The total amount of required database space is 1.9 TB.
Database size < 500 GB 500 GB and < 1 TB 1 TB and < 1.5 TB 1.5 and < 2 TB 2 and < 3 TB 3 and < 4 TB Minimum temporary-space requirement 50 GB 100 GB 150 GB 200 GB 250 - 300 GB 350 - 400 GB

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Estimating database space requirements based on storage pool capacity

To estimate database space requirements based on storage pool capacity, use a ratio of 1 - 5%. For example, if you require 200 TB of storage pool capacity, the size of your database is expected to be 2 - 10 TB. As a general rule, make your database as large as possible to prevent running out of space. If you run out of database space, server operations and client-store operations can fail.

Recovery log space requirements

In Tivoli Storage Manager, the term recovery log comprises the active log, the archive log, the active log mirror, and the archive failover log. The amount of space that you require for the recovery log depends on various factors, including, for example, the amount of client activity with the server.

Active and archive log space

When estimating space requirements for active and archive logs, include some extra space for contingencies such as occasional heavy workloads and failovers. Consider the following general guidelines for estimating the size of the active log: v The suggested starting size for the active log is 16 GB. v Ensure that the active log is at least large enough for the amount of concurrent activity that the server typically handles. As a precaution, try to anticipate the largest amount of work that the server will handle at one time. Provision the active log with extra space that can be used if needed. Twenty percent is a reasonable amount of extra space to consider. v Monitor used and available active log space. Adjust the size of the active log as needed, depending upon factors such as client activity and the level of server operations. For details about changing the size of the active log, see the Administrator's Guide. v Ensure that the directory that holds the active log is as large as, or larger than, the size of the active log. A directory that is larger than the active log can accommodate failovers, if they occur. The suggested starting size for the archive log is 48 GB. The archive log directory must be large enough to contain the log files generated since the previous full backup. For example, if you perform a full backup of the database every day, the archive log directory must be large enough to hold the log files for all the client activity that occurs during 24 hours. To recover space, the server deletes obsolete archive log files after a full backup of the database. If the archive log directory becomes full and a directory for archive failover logs does not exist, log files remain in the active log directory. This condition can cause the active log directory to fill up and stop the server. When the server restarts, some of the existing active-log space is released. Monitor archive log utilization and the space in the archive log directory. If the space in the archive log directory fills up, it can indicate the following problems: v The server is unable to perform full database backups. Investigate and resolve this problem. v Other applications are writing to the archive log directory, exhausting the space required by the archive log. Do not share archive log space with other applications including other Tivoli Storage Manager servers. Ensure that each server has a separate storage location that is owned and managed by that specific server.

10

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

For guidance about the layout and tuning of the active log and archive log, see the Performance Tuning Guide. Example: Estimating active and archive log sizes for basic client-store operations: Basic client store operations include backup, archive, and space management. Log space must be sufficient to handle all store transactions that are in progress at one time. To determine the sizes of the active and archive logs for basic client-store operations, use the following calculation:
number of clients x files stored during each transaction x log space needed for each file

This calculation is used in the example in the following table.

Table 9. Basic client-store operations Item Example values Description The number of client nodes that back up, archive, or migrate files every night. The default value of the server option TXNGROUPMAX is 4096. The value of 3053 bytes for each file in a transaction represents the log bytes that are needed when backing up files from a Windows client where the file names are 12 120 bytes. This value is based on the results of tests performed under laboratory conditions. The tests consisted of backup-archive clients performing backup operations to a random-access disk (DISK) storage pool. DISK pools result in more log use than sequential-access storage pools. Consider a value larger than 3053 bytes if the data being stored has file names that are longer than 12 - 120 bytes. Active log: Suggested size 19.5 GB
1

Maximum number of client nodes 300 that back up, archive, or migrate files concurrently at any time Files stored during each transaction Log space that is required for each file 4096 3053 bytes

Use the following calculation to determine the size of the active log. One GB equals 1,073,741,824 bytes. (300 clients x 4096 files stored during each transaction x 3053 bytes for each file) 1,073,741,824 bytes = 3.5 GB Increase that amount by the suggested starting size of 16 GB: 3.5 + 16 = 19.5 GB

Archive log: Suggested size

58.5 GB

Because of the requirement to be able to store archive logs across three server database-backup cycles, multiply the estimate for the active log by 3 to estimate the total archive log requirement. 3.5 x 3 = 10.5 GB Increase that amount by the suggested starting size of 48 GB: 10.5 + 48 = 58.5 GB

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

11

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 9. Basic client-store operations (continued) Item

1

Example values

Description

The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that does not use deduplication, 16 GB is the suggested minimum size for an active log. The suggested minimum size for an archive log in a production environment that does not use deduplication is 48 GB. If you substitute values from your environment and the results are larger than 16 GB and 48 GB, use your results to size the active log and archive log. Monitor your logs and adjust their size if necessary.

Example: Estimating active and archive log sizes for clients that use multiple sessions: If the client option RESOURCEUTILIZATION is set to a value that is greater than the default, the concurrent workload for the server increases. To determine the sizes of the active and archive logs when clients use multiple sessions, use the following calculation:
number of clients x sessions for each client x files stored during each transaction x log space needed for each file

This calculation is used in the example in the following table.

Table 10. Multiple client sessions Item Maximum number of client nodes that back up, archive, or migrate files concurrently at any time Possible sessions for each client Files stored during each transaction 300 Example values 1000 Description The number of client nodes that back up, archive, or migrate files every night.

The setting of the client option RESOURCEUTILIZATION is larger than the default. Each client session runs a maximum of three sessions in parallel. The default value of the server option TXNGROUPMAX is 4096. The value of 3053 bytes for each file in a transaction represents the log bytes needed when backing up files from a Windows client where the file names are 12 - 120 bytes. This value is based on the results of tests performed under laboratory conditions. Tests consisted of clients performing backup operations to a random-access disk (DISK) storage pool. DISK pools result in more log use than sequential-access storage pools. Consider a value larger than 3053 bytes if the data being stored has file names that are longer than 12 - 120 bytes.

4096

4096 3053

Log space that is required for 3053 each file

12

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 10. Multiple client sessions (continued) Item Active log: Suggested size Example values 26.5 GB
1

Description The following calculation was used for 300 clients. One GB equals 1,073,741,824 bytes. (300 clients x 3 sessions for each client x 4096 files stored during each transaction x 3053 bytes for each file) 1,073,741,824 = 10.5 GB Increase that amount by the suggested starting size of 12 GB: 10.5 + 12 = 22.5 GB The following calculation was used for 1000 clients. One GB equals 1,073,741,824 bytes. (1000 clients x 3 sessions for each client x 4096 files store during each transaction x 3053 bytes for each file) 1,073,741,824 = 35 GB Increase that amount by the suggested starting size of 16 GB: 35 + 16 = 51 GB

51 GB

Archive log: Suggested size

79.5 GB

153 GB

Because of the requirement to be able to store archive logs across three server-database backup cycles, the estimate for the active log is multiplied by 3: 10.5 x 3 = 31.5 GB 35 x 3 = 105 GB Increase those amounts by the suggested starting size of 48 GB: 31.5 + 48 = 79.5 GB 105 + 48 = 153 GB

The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that does not use deduplication, 16 GB is the suggested minimum size for an active log. The suggested minimum size for an archive log in a production environment that does not use deduplication is 48 GB. If you substitute values from your environment and the results are larger than 16 GB and 48 GB, use your results to size the active log and archive log. Monitor your active log and adjust its size if necessary.

Example: Estimating active and archive log sizes for simultaneous write operations: If client backup operations use storage pools that are configured for simultaneous write, the amount of log space that is required for each file increases. The log space that is required for each file increases by about 200 bytes for each copy storage pool that is used for a simultaneous write operation. In the example in the following table, data is stored to two copy storage pools in addition to a primary storage pool. The estimated log size increases by 400 bytes for each file. If you use the suggested value of 3053 bytes of log space for each file, the total number of required bytes is 3453.
Chapter 1. Planning to install the IBM Tivoli Storage Manager server

13

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
1

This calculation is used in the example in the following table.

Table 11. Simultaneous write operations Item Example values Description The number of client nodes that back up, archive, or migrate files every night. The default value of the server option TXNGROUPMAX is 4096. 3053 bytes plus 200 bytes for each copy storage pool. The value of 3053 bytes for each file in a transaction represents the log bytes that are needed when backing up files from a Windows client where the file names are 12 - 120 bytes. This value is based on the results of tests performed under laboratory conditions. The tests consisted of backup-archive clients performing backup operations to a random-access disk (DISK) storage pool. DISK pools result in more log use than sequential-access storage pools. Consider a value larger than 3053 bytes if the data being stored has file names that are longer than 12 - 120 bytes. Active log: Suggested size 20 GB
1

Maximum number of client nodes 300 that back up, archive, or migrate files concurrently at any time Files stored during each transaction Log space that is required for each file 4096 3453 bytes

Use the following calculation to determine the size of the active log. One GB equals 1,073,741,824 bytes. (300 clients x 4096 files stored during each transaction x 3453 bytes for each file) 1,073,741,824 bytes = 4.0 GB Increase that amount by the suggested starting size of 16 GB: 4 + 16 = 20 GB

Archive log: Suggested size

60 GB

Because of the requirement to be able to store archive logs across three server database-backup cycles, multiply the estimate for the active log by 3 to estimate the archive log requirement: 4 GB x 3 = 12 GB

Increase that amount by the suggested starting size of 48 GB: 12 + 48 = 60 GB The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that does not use deduplication, 16 GB is the suggested minimum size for an active log. The suggested minimum size for an archive log in a production environment that does not use deduplication is 48 GB. If you substitute values from your environment and the results are larger than 16 GB and 48 GB, use your results to size the active log and archive log. Monitor your logs and adjust their size if necessary.

14

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Example: Estimating active and archive log sizes for basic client store operations and server operations: Migration of data in server storage, identification processes for data deduplication, reclamation, and expiration might run concurrently with client store operations. Administrative tasks such as administrative commands or SQL queries from administrative clients can also run concurrently with client store operations. Server operations and administrative tasks that run concurrently can increase the active log space that is required. For example, migration of files from the random-access (DISK) storage pool to a sequential-access disk (FILE) storage pool uses approximately 110 bytes of log space for each file that is migrated. For example, suppose that you have 300 backup-archive clients and each one of them backs up 100,000 files every night. The files are initially stored on DISK and then migrated to a FILE storage pool. To estimate the amount of active log space that is required for the data migration, use the following calculation. The number of clients in the calculation represents the maximum number of client nodes that back up, archive, or migrate files concurrently at any time.
300 clients x 100,000 files for each client x 110 bytes = 3.1 GB

Add this value to the estimate for the size of the active log that calculated for basic client store operations. Example: Estimating active and archive log sizes under conditions of extreme variation: Problems with running out of active log space can occur if you have many transactions that complete quickly and some transactions that take much longer to complete. A typical case occurs when many workstation or file-server backup sessions are active and a few very large database server-backup sessions are active. If this situation applies to your environment, you might need to increase the size of the active log so that the work completes successfully. Example: Estimating archive log sizes with full database backups: The Tivoli Storage Manager server deletes unnecessary files from the archive log only when a full database backup occurs. Consequently, when you estimate the space that is required for the archive log, you must also consider the frequency of full database backups. For example, if a full database backup occurs once a week, the archive log space must be able to contain the information in the archive log for a full week. The difference in archive log size for daily and full database backups is shown in the example in the following table.
Table 12. Full database backups Item Example values Description The number of client nodes that back up, archive, or migrate files every night. The default value of the server option TXNGROUPMAX is 4096.

Maximum number of client nodes 300 that back up, archive, or migrate files concurrently at any time Files stored during each transaction 4096

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

15

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 12. Full database backups (continued) Item Log space that is required for each file Example values 3453 bytes Description 3053 bytes for each file plus 200 bytes for each copy storage pool. The value of 3053 bytes for each file in a transaction represents the log bytes needed when backing up files from a Windows client where the file names are 12 - 120 bytes. This value is based on the results of tests performed under laboratory conditions. Tests consisted of clients performing backup operations to a random-access disk (DISK) storage pool. DISK pools result in more log use than sequential-access storage pools. Consider a value larger than 3053 bytes if the data being stored has file names that are longer than 12 - 120 bytes. Active log: Suggested size 20 GB
1

Use the following calculation to determine the size of the active log. One GB equals 1,073,741,824 bytes.(300 clients x 4096 files per transaction x 3453 bytes per file) 1,073,741,824 bytes = 4.0 GB Increase that amount by the suggested starting size of 16 GB: 4 + 16 = 20 GB

Archive log: Suggested size with a full database backup every day

60 GB

Because of the requirement to be able to store archive logs across three backup cycles, multiply the estimate for the active log by 3 to estimate the total archive log requirement: 4 GB x 3 = 12 GB Increase that amount by the suggested starting size of 48 GB: 12 + 48 = 60 GB

Archive log: Suggested size with a full database every week

132 GB

Because of the requirement to be able to store archive logs across three server database-backup cycles, multiply the estimate for the active log by 3 to estimate the total archive log requirement. Multiply the result by the number of days between full database backups: (4 GB x 3 ) x 7 = 84 GB Increase that amount by the suggested starting size of 48 GB: 84 + 48 = 132 GB

The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that does not use deduplication, 16 GB is the suggested minimum size for an active log. The suggested starting size for an archive log in a production environment that does not use deduplication is 48 GB. If you substitute values from your environment and the results are larger than 16 GB and 48 GB, use your results to size the active log and archive log. Monitor your logs and adjust their size if necessary.

16

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Example: Estimating active and archive log sizes for data deduplication operations: If you deduplicate data, you must consider its effects on space requirements for active and archive logs. The following factors affect requirements for active and archive log space: The amount of deduplicated data The effect of data deduplication on the active log and archive log space depends on the percentage of data that is eligible for deduplication. If the percentage of data that can be deduplicated is relatively high, more log space is required. The size and number of extents Approximately 1,500 bytes of active log space are required for each extent that is identified by a duplicate-identification process. For example, if 250,000 extents are identified by a duplicate-identification process, the estimated size of the active log is 358 MB:
250,000 extents identified during each process x 1,500 bytes for each extent = 358 MB

Consider the following scenario. Three hundred backup-archive clients back up 100,000 files each night. This activity creates a workload of 30,000,000 files. The average number of extents for each file is two. Therefore, the total number of extents is 60,000,000, and the space requirement for the archive log is 84 GB:
60,000,000 extents x 1,500 bytes for each extent = 84 GB

A duplicate-identification process operates on aggregates of files. An aggregate consists of files that are stored in a given transaction, as specified by the TXNGROUPMAX server option. Suppose that the TXNGROUPMAX server option is set to the default of 4096. If the average number of extents for each file is two, the total number of extents in each aggregate is 8192, and the space required for the active log is 12 MB:
8192 extents in each aggregate x 1500 bytes for each extent = 12 MB

The timing and number of the duplicate-identification processes The timing and number of duplicate-identification processes also affects the size of the active log. Using the 12 MB active-log size that was calculated in the preceding example, the concurrent load on the active log is 120 MB if 10 duplicate-identification processes are running in parallel:
12 MB for each process x 10 processes = 120 MB

File size Large files that are processed for duplicate identification can also affect the size of the active log. For example, suppose that a backup-archive client backs up an 80 GB, file-system image. This object can have a high number of duplicate extents if, for example, the files included in the file system image were backed up incrementally. For example, assume that a file system image has 1.2 million duplicate extents. The 1.2 million extents in this large file represent a single transaction for a duplicate-identification process. The total space in the active log that is required for this single object is 1.7 GB:
1,200,000 extents x 1,500 bytes for each extent = 1.7 GB

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

17

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Active log: Suggested 1.7 GB size that is required for the deduplication of a single large object during a single duplicateidentification process

If other, smaller duplicate-identification processes occur at the same time as the duplicate-identification process for a single large object, the active log might not have enough space. For example, suppose that a storage pool is enabled for deduplication. The storage pool has a mixture of data, including many relatively small files that range from 10 KB to several hundred KB. The storage pool also has few large objects that have a high percentage of duplicate extents. To take into account not only space requirements but also the timing and duration of concurrent transactions, increase the estimated size of the active log by a factor of two. For example, suppose that your calculations for space requirements are 25 GB (23.3 GB + 1.7 GB for deduplication of a large object). If deduplication processes are running concurrently, the suggested size of the active log is 50 GB. The suggested size of the archive log is 150 GB. The examples in the following tables show calculations for active and archive logs. The example in the first table uses an average size of 700 KB for extents. The example in the second table uses an average size of 256 KB. As the examples show, the average deduplicate-extent size of 256 KB indicates a larger estimated size for the active log. To minimize or prevent operational problems for the server, use 256 KB to estimate the size of the active log in your production environment.
Table 13. Average duplicate-extent size of 700 KB Item Size of largest single object to deduplicate Example values 800 GB 4 TB Description The granularity of processing for deduplication is at the file level. Therefore, the largest single file to deduplicate represents the largest transaction and a correspondingly large load on the active and archive logs. The deduplication algorithms use a variable block method. Not all deduplicated extents for a given file are the same size, so this calculation assumes an average size for extents. Using the average extent size (700 KB), these calculations represent the total number of extents for a given object. The following calculation was used for an 800 GB object: (800 GB 700 KB) = 1,198,372 bits The following calculation was used for a 4 TB object: (4 TB 700 KB) = 6,135,667 bits 8.6 GB The estimated active log space that are needed for this transaction.

Average size of extents Extents for a given file

700 KB

700 KB

1,198,372 bits

6,135,667 bits

18

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 13. Average duplicate-extent size of 700 KB (continued) Item Active log: Suggested total size 66 GB Example values
1

Description After considering other aspects of the workload on the server in addition to deduplication, multiply the existing estimate by a factor of two. In these examples, the active log space required to deduplicate a single large object is considered along with previous estimates for the required active log size. The following calculation was used for multiple transactions and an 800 GB object: (23.3 GB + 1.7 GB) x 2 = 50 GB Increase that amount by the suggested starting size of 16 GB: 50 + 16 = 66 GB The following calculation was used for multiple transactions and a 4 TB object: (23.3 GB + 8.6 GB) x 2 = 63.8 GB Increase that amount by the suggested starting size of 16 GB: 63.8 + 16 = 79.8 GB

79.8 GB

Archive log: Suggested size

198 GB

239.4 GB

Multiply the estimated size of the active log by a factor of 3. The following calculation was used for multiple transactions and an 800 GB object: 50 GB x 3 = 150 GB Increase that amount by the suggested starting size of 48 GB: 150 + 48 = 198 GB The following calculation was used for multiple transactions and a 4 TB object: 63.8 GB x 3 = 191.4 GB Increase that amount by the suggested starting size of 48 GB: 191.4 + 48 = 239.4 GB

The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that uses deduplication, 32 GB is the suggested minimum size for an active log. The suggested minimum size for an archive log in a production environment that uses deduplication is 96 GB. If you substitute values from your environment and the results are larger than 32 GB and 96 GB, use your results to size the active log and archive log. Monitor your logs and adjust their size if necessary.

Table 14. Average duplicate-extent size of 256 KB Item Size of largest single object to deduplicate Example values 800 GB 4 TB Description The granularity of processing for deduplication is at the file level. Therefore, the largest single file to deduplicate represents the largest transaction and a correspondingly large load on the active and archive logs.

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

19

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 14. Average duplicate-extent size of 256 KB (continued) Item Average size of extents Extents for a given file Example values 256 KB 256 KB Description The deduplication algorithms use a variable block method. Not all deduplicated extents for a given file are the same size, so this calculation assumes an average extent size. Using the average extent size, these calculations represent the total number of extents for a given object. The following calculation was used for multiple transactions and an 800 GB object: (800 GB 256 KB) = 3,276,800 bits The following calculation was used for multiple transactions and a 4 TB object: (4 TB 256 KB) = 16,777,216 bits Active log: Suggested 4.5 GB size that is required for the deduplication of a single large object during a single duplicateidentification process Active log: Suggested total size 71.6 GB
1

3,276,800 bits

16,777,216 bits

23.4 GB

The estimated size of the active log space that is required for this transaction.

109.4 GB

After considering other aspects of the workload on the server in addition to deduplication, multiply the existing estimate multiplied by a factor of 2. In these examples, the active log space required to deduplicate a single large object is considered along with previous estimates for the required active log size. The following calculation was used for multiple transactions and an 800 GB object: (23.3 GB + 4.5 GB) x 2 = 55.6 GB Increase that amount by the suggested starting size of 16 GB: 55.6 + 16 = 71.6 GB The following calculation was used for multiple transactions and a 4 TB object: (23.3 GB + 23.4 GB) x 2 = 93.4 GB Increase that amount by the suggested starting size of 16 GB: 93.4 + 16 = 109.4 GB

20

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 14. Average duplicate-extent size of 256 KB (continued) Item Archive log: Suggested size Example values 214.8 GB
1

Description
1

328.2 GB

The estimated size of the active log multiplied by a factor of 3. The following calculation was used for an 800 GB object: 55.6 GB x 3 = 166.8 GB Increase that amount by the suggested starting size of 48 GB: 166.8 + 48 = 214.8 GB The following calculation was used for a 4 TB object: 93.4 GB x 3 = 280.2 GB Increase that amount by the suggested starting size of 48 GB: 280.2 + 48 = 328.2 GB

The example values in this table are used only to illustrate how the sizes for active logs and archive logs are calculated. In a production environment that uses deduplication, 32 GB is the suggested minimum size for an active log. The suggested minimum size for an archive log in a production environment that uses deduplication is 96 GB. If you substitute values from your environment and the results are larger than 32 GB and 96 GB, use your results to size the active log and archive log. Monitor your logs and adjust their size if necessary.

Active-log mirror space

The active log can be mirrored so that the mirrored copy can be used if the active log files cannot be read. There can be only one active log mirror. Creating a log mirror is a suggested option. If you increase the size of the active log, the log mirror size is increased automatically. Mirroring the log can affect performance because of the doubled I/O activity that is required to maintain the mirror. The additional space that the log mirror requires is another factor to consider when deciding whether to create a log mirror. If the mirror log directory becomes full, the server issues error messages to the activity log and to the db2diag.log. Server activity continues.

Archive-failover log space

The archive failover log is used by the server if the archive log directory runs out of space. Specifying an archive failover log directory can prevent problems that occur if the archive log runs out of space. If both the archive log directory and the drive or file system where the archive failover log directory is located become full, the data remains in the active log directory. This condition can cause the active log to fill up, which causes the server to halt.

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

21

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Monitoring space utilization for the database and recovery logs

To determine the amount of used and available active log space, you issue the QUERY LOG command. To monitor space utilization in the database and recovery logs, you can also check the activity log for messages.

Active log
If the amount of available active log space is too low, the following messages are displayed in the activity log: ANR4531I: IC_AUTOBACKUP_LOG_USED_SINCE_LAST_BACKUP_TRIGGER This message is displayed when the active log space exceeds the maximum specified size. The Tivoli Storage Manager server starts a full database backup. To change the maximum log size, halt the server. Open the dsmserv.opt file, and specify a new value for the ACTIVELOGSIZE option. When you are finished, restart the server. ANR0297I: IC_BACKUP_NEEDED_LOG_USED_SINCE_LAST_BACKUP This message is displayed when the active log space exceeds the maximum specified size. You must back up the database manually. To change the maximum log size, halt the server. Open the dsmserv.opt file, and specify a new value for the ACTIVELOGSIZE option. When you are finished, restart the server. ANR4529I: IC_AUTOBACKUP_LOG_UTILIZATION_TRIGGER The ratio of used active-log space to available active-log space exceeds the log utilization threshold. If at least one full database backup has occurred, the Tivoli Storage Manager server starts an incremental database backup. Otherwise, the server starts a full database backup. ANR0295I: IC_BACKUP_NEEDED_LOG_UTILIZATION The ratio of used active-log space to available active-log space exceeds the log utilization threshold. You must back up the database manually.

Archive log
If the amount of available archive log space is too low, the following message is displayed in the activity log: ANR0299I: IC_BACKUP_NEEDED_ARCHLOG_USED The ratio of used archive-log space to available archive-log space exceeds the log utilization threshold. The Tivoli Storage Manager server starts a full automatic database backup.

Database
If the amount of space available for database activities is too low, the following messages are displayed in the activity log: ANR2992W: IC_LOG_FILE_SYSTEM_UTILIZATION_WARNING_2 The used database space exceeds the threshold for database space utilization. To increase the space for the database, use the EXTEND DBSPACE command, the EXTEND DBSPACE command, or the DSMSERV FORMAT utility with the DBDIR parameter.

22

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

ANR1546W: FILESYSTEM_DBPATH_LESS_1GB The available space in the directory where the server database files are located is less than 1 GB. When a Tivoli Storage Manager server is created with the DSMSERV FORMAT utility or with the configuration wizard, a server database and recovery log are also created. In addition, files are created to hold database information used by the database manager. The path specified in this message indicates the location of the database information used by the database manager. If space is unavailable in the path, the server can no longer function.You must add space to the file system or make space available on the file system or disk.

Server naming best practices

Use these descriptions as a reference when you install or upgrade a Tivoli Storage Manager server.

Instance user ID
The instance user ID is used as the basis for other names related to the server instance. The instance user ID is also called the instance owner. For example: tsminst1 The instance user ID is the user ID that must have ownership or read/write access authority to all directories that you create for the database and the recovery log. The standard way to run the server is under the instance user ID. That user ID must also have read/write access to the directories that are used for any FILE device classes.

Database instance name

The database instance name is the name of the server instance as it appears in the registry. For example: Server1

Instance directory
The instance directory is a directory that contains files specifically for a server instance (the server options file and other server-specific files). It can have any name that you want. For easier identification, use a name that ties the directory to the instance name. You can use a name that includes the name of the server instance as it appears (or will appear) in the registry. Default server instance names have the form Serverx. For example: d:\tsm\server1 The instance directory stores the following files for the server instance: v The server options file, dsmserv.opt v Device configuration file, if the DEVCONFIG server option does not specify a fully qualified name v Volume history file, if the VOLUMEHISTORY server option does not specify a fully qualified name

Chapter 1. Planning to install the IBM Tivoli Storage Manager server

23

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v Volumes for DEVTYPE=FILE storage pools, if the directory for the device class is not fully specified, or not fully qualified v User exits v Trace output (if not fully qualified)

Database name
The database name is always TSMDB1, for every server instance. This name cannot be changed.

Server name
The server name is an internal name for Tivoli Storage Manager, and is used for operations that involve communication among multiple Tivoli Storage Manager servers. Examples include server-to-server communication and library sharing. The server name is also used when you add the server to the Administration Center so that it can be managed using that interface. Use a unique name for each server. For easy identification in the Administration Center (or from a QUERY SERVER command), use a name that reflects the location or purpose of the server. If you use the wizard, the default name that is suggested is the host name of the system that you are using. You can use a different name that is meaningful in your environment. If you have more than one server on the system and you use the wizard, you can use the default name for only one of the servers. You must enter a unique name for each server. For example: TUCSON_SERVER1 TUCSON_SERVER2 For more information about server names, see Tivoli Storage Manager Administrator's Guide.

Directories for database space and recovery log

The directories can be named according to local practices. For easier identification, consider using names that tie the directories to the server instance. For example, for the archive log: f:\server1\archlog

24

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 2. Installing the Tivoli Storage Manager server components

To install the Tivoli Storage Manager 6.3 server, you can use the graphical installation wizard, the console wizard, or the command line in silent mode. Using the Tivoli Storage Manager installation software, you can install the following components: v Tivoli Storage Manager Server Tip: The Tivoli Storage Manager client application programming interface (API) and the Global Security Toolkit (GSKit) are automatically installed when you select the server component. Tivoli Storage Manager Server Languages Tivoli Storage Manager License Tivoli Storage Manager Devices Tivoli Storage Manager Storage Agent Refer to the Storage Agent User's Guide for more details about storage agents.

v v v v

1. If you are installing the products using the Tivoli Storage Manager DVD, complete the following steps: Log on as an administrator. Insert the Tivoli Storage Manager server DVD. Use Windows Explorer to go to the DVD drive, double-click the DVD, and then double-click install.exe. To access Windows Explorer, go to Start > Programs > Accessories or right-click the Start button. The Tivoli Storage Manager server DVD browser window opens. 2. If you downloaded the program from Passport Advantage as an executable file, complete the following steps. a. Verify that you have enough space to store the installation files when they are extracted from the product package. See the download document for the space requirements: v Tivoli Storage Manager: http://www.ibm.com/support/ docview.wss?uid=swg24030522 v Tivoli Storage Manager Extended Edition: http://www.ibm.com/ support/docview.wss?uid=swg24030528 v System Storage Archive Manager: http://www.ibm.com/ support/docview.wss?uid=swg24030531 b. Change to the directory where you placed the executable file. Tip: In the next step, the files are extracted to the current directory. Be sure to extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files. c. Either double-click the executable file, or enter the following command on the command line to extract the installation files. The files are extracted to the current directory.
package_name.exe

| | | | | |

Copyright IBM Corp. 1993, 2011

25

| | | |

The package_name is typically a name such as CZ1N9ML. The package is large, so the extraction takes some time. 3. Optional: After all the files have been extracted, locate this file and run it to ensure that your system meets all requirements: prereqcheck.exe See Running the installation prerequisite checker on page 6 for details. 4. Select one of the following ways of installing Tivoli Storage Manager: Installation wizard Installing Tivoli Storage Manager by using the installation wizard Command-line console wizard Installing Tivoli Storage Manager by using the console installation wizard on page 27 Silent mode Installing Tivoli Storage Manager in silent mode on page 28 5. After you install Tivoli Storage Manager and before you customize it for your use, go to the Tivoli Storage Manager website: http://www.ibm.com/support/ entry/portal/Overview/Software/Tivoli/Tivoli_Storage_Manager. Click Support and downloads and apply any applicable fixes.

Installing Tivoli Storage Manager by using the installation wizard

Using the installation wizard is one method of installing Tivoli Storage Manager. To install Tivoli Storage Manager by using the installation wizard, complete the following steps: 1. To start the wizard without saving your responses, enter the following command:
install.exe

| | | | | | | | | | | | | | | | | | |

Or, double-click the install.exe file. To start the wizard and save your responses to later use for a silent installation, enter the following command and specify the -r option.
install.exe -r C:\path_name\response.rsp

where path_name is the full directory path to where you want the response file to be created. If you do not specify a fully qualified name, the response file is placed in a temporary directory. 2. Select the language for your installation and follow the wizard, selecting Next to step through the wizard. Select the product that you are entitled to use and a license agreement is displayed. You can select only one product on the page. If you select Tivoli Storage Manager, Tivoli Storage Manager Extended Edition, or System Storage Archive Manager, you are asked if you will be using LAN-free or library sharing. If you select YES, you must accept the Tivoli Storage Manager for Storage Area Networks license. This is in addition to the license for the product that you chose on the previous page. Select the components that you want to install. Components include the server, languages, license, device driver, and storage agent. There is no default, so you must make a selection. If you previously installed a server, ensure that you select the same directory when you install a language pack, license, or device

26

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | |

driver. If you previously installed a storage agent, ensure that you select the same directory if you return to install a device driver. A server and a storage agent cannot be installed on the same workstation. The Tivoli Storage Manager client application programming interface (API), DB2 Version 9.7, and IBM Global Security Kit (GSKit) Version 8 are automatically installed when you select the server component. If there were any errors during the installation, the summary page lists the errors and directs you to an error log file. The log for a new server installation is stored in this location: The directory that was chosen for installation; look for the files log.txt and logs.zip. After you install a new Tivoli Storage Manager server, you must configure it. See Chapter 3, Taking the first steps after you install Tivoli Storage Manager, on page 33.

Installing Tivoli Storage Manager by using the console installation wizard

Using the console installation wizard is one method of installing Tivoli Storage Manager. To install Tivoli Storage Manager by using the console installation wizard, complete these steps: 1. To start the wizard without saving your responses, enter the following command:
install.exe -i console

| | | | | | | | | | | | | | | | | | | | | |

To start the wizard and save your responses, enter the following command and specify the -r option.
install.exe -i console -r C:\path_name\response.rsp

where path_name is the full directory path to where you want the response file to be created. If you do not specify a fully qualified name, the response file is placed in a temporary directory. The Tivoli Storage Manager installation wizard starts. 2. Select the language for your installation and follow the wizard, selecting Next to step through the wizard. Select the product that you are entitled to use and a license agreement is displayed. You can select only one product on the page. If you select Tivoli Storage Manager, Tivoli Storage Manager Extended Edition, or System Storage Archive Manager, you are asked if you will be using LAN-free or library sharing. If you select YES, you must accept the Tivoli Storage Manager for Storage Area Networks license. This is in addition to the license for the product that you chose on the previous page. Select the components that you want to install. Components include the server, languages, license, device driver, and storage agent. There is no default, so you must make a selection. If you previously installed a server, ensure that you select the same directory when you install a language pack, license, or device driver. If you previously installed a storage agent, ensure that you select the same directory if you return to install a device driver. A server and a storage agent cannot be installed on the same workstation.
Chapter 2. Installing the Tivoli Storage Manager server components

27

| | |

The Tivoli Storage Manager client application programming interface (API), DB2 Version 9.7, and IBM Global Security Kit (GSKit) Version 8 are automatically installed when you select the server component. If there were any errors during the installation, the summary page lists the errors and directs you to an error log file. The log for a new server installation is stored in this location: The directory that was chosen for installation; look for the files log.txt and logs.zip. After you install a new Tivoli Storage Manager server, you must configure it. See Chapter 3, Taking the first steps after you install Tivoli Storage Manager, on page 33.

Installing Tivoli Storage Manager in silent mode

Using silent mode is one method of installing Tivoli Storage Manager. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Pass the variables in Table 15 into this file to define the silent installation: install.exe
Table 15. Variables for the silent installation Variable v -DIBM_TSM_LICENSE_ACCEPTED=true v -DIBM_TSMEE_LICENSE_ACCEPTED=true v -DIBM_SSAM_LICENSE_ACCEPTED=true v -DIBM_TSMSAN_LICENSE_ACCEPTED=true (required) Description Specify one or two variables or the installation stops. It also stops if you specify more than two variables. The wizard installs the license agreement for the Tivoli Storage Manager product that is selected. Tip: If two products are specified, the wizard checks that one of them is the Tivoli Storage Manager for Storage Area Networks license: IBM_TSMSAN_LICENSE_ACCEPTED=true. If one variable is not, the wizard stops. Enter the instance credentials used by the installation wizard to redefine the database instance. Use quotation marks around your credentials when you pass them into the command line. Specify multiple instances by separating them with a comma. Tip: An instance cannot be in both the INSTANCE_CRED and the INSTANCE_OMIT parameters. All of the instances that exist when an installation package is reinstalled must be listed in either the INSTANCE_CRED or the INSTANCE_OMIT parameters. Or, the silent installation fails.

For command line: -DINSTANCE_CRED="instance1 userid1 password1, instance2 userid2 password2" (required for reinstallation only) For response file: INSTANCE_CRED=instance1 userid1 password1, instance2 userid2 password2 (required for reinstallation only)

28

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 15. Variables for the silent installation (continued) Variable For command line:DINSTANCE_OMIT="instance3, instance4" (optional for reinstallation only) For response file: INSTANCE_OMIT=instance3, instance4 (optional for reinstallation only) Description Enter any instances that will not be recreated as part of the installation. Use this variable if you have an instance that exists but is not used. Use it if you have removed the instance user ID, forgotten the password, or otherwise do not want to create the instance as part of a reinstallation. Use quotation marks around your credentials when you pass them into the command line. Specify multiple instances by separating them with a comma. Tip: An instance cannot be in both the INSTANCE_CRED and the INSTANCE_OMIT parameters. All of the instances that exist when an installation package is reinstalled must be listed in either the INSTANCE_CRED or the INSTANCE_OMIT parameters. Or, the silent installation fails. -DINSTALL_DEVICES=1 (optional) -DINSTALL_LICENSE=1 (required for base packages) Install the Tivoli Storage Manager device driver. Install the Tivoli Storage Manager server license component. This variable should only be specified if the package being installed includes Tivoli Storage Manager server license files or the installation might fail. This option is typically only required for a first-time installation of the base release package. This option should not be used when installing most fix packs and interim fix packages because they do not include the server licenses. Specify the installation directory if you want to change it. The default directory is C:\Program Files\Tivoli\TSM. Install the Tivoli Storage Manager server component. Install the Tivoli Storage Manager storage agent.

-DUSER_INSTALL_DIR=install_directory (optional) -DINSTALL_SERVER=1 (optional) -DINSTALL_STAGENT=1 (optional)

Chapter 2. Installing the Tivoli Storage Manager server components

29

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 15. Variables for the silent installation (continued) Variable -DINSTALL_language_pack=1 (optional) Description Install a specific language pack. You can install the following server language-packs during the silent installation, using these variables: v INSTALL_GERMAN v INSTALL_SPANISH v INSTALL_FRENCH v INSTALL_ITALIAN v INSTALL_BRPORTUGUESE v INSTALL_KOREAN v INSTALL_JAPANESE v INSTALL_RUSSIAN v INSTALL_SCHINESE v INSTALL_TCHINESE For example, to install the German language pack, use this variable: -DINSTALL_GERMAN=1

Tip: After you start the silent installation, it immediately closes the foreground window and runs in the background. To receive a return code from the silent installation, run it using a batch script. See Installing silently using a batch script on page 31. v To enable a component during silent installation, append it to the install.exe command on a single line. For example:
install.exe -i silent -DIBM_TSM_LICENSE_ACCEPTED=true -DINSTALL_SERVER=1 -DINSTALL_LICENSE=1 -DINSTALL_ENGLISHUTF8=1

Or, for a reinstallation:

install.exe -i silent -DINSTANCE_CRED="server1 server1 server1" -DINSTANCE_OMIT="server2" -DIBM_TSM_LICENSE_ACCEPTED=true -DINSTALL_SERVER=1

v Alternatively, the component variables can be placed into a response file. The path to this response file can then be passed into the install.exe command. To create this file, use the same variables that are in Table 15 on page 28. Remove the -D and separate the options on individual lines. Do not use quotation marks. For example:
INSTANCE_CRED=server1 server1 server1 INSTANCE_OMIT=server2 IBM_product_LICENSE_ACCEPTED=true INSTALL_SERVER=1 INSTALL_SPANISH=1

v To use an existing response file, enter the following command:

install.exe -i silent -f response_file

where the response_file is the full directory path to a file that you previously created in the Tivoli Storage Manager installation process. The response file contains variables you selected in a prior installation, using the GUI or console

30

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | |

wizard. You might see a difference between response files, depending on which installation mode you used (GUI or console). Remember: If you previously installed a server, ensure that you select the same directory when you install a language pack, license, or device driver. If you previously installed a storage agent, ensure that you select the same directory if you return to install a device driver. Check the path in this registry: HKEY_LOCAL_MACHINE\SOFTWARE\IBM\ADSM\CurrentVersion. If the value for Path is set, you must select that same path to install other components. Fix any errors before continuing. See the following log for more information: The directory that was chosen for the installation (look for the file log.txt). After you install a new Tivoli Storage Manager server, you must configure it. See Chapter 3, Taking the first steps after you install Tivoli Storage Manager, on page 33.

Installing silently using a batch script

To receive a return code from the silent installation, run it using a batch script. To create and run a batch script, complete the following steps: 1. Create a file and name it install.bat. The file name must end with .bat, not .bat.txt. | | | 2. Choose an installation option (with or without a response file) and enter the command into the install.bat file. Save it. For example:
install.exe -i silent -DIBM_TSM_LICENSE_ACCEPTED=true -f response_file

3. To run the batch file, open a command prompt. Issue this command:
install.bat

4. After the installation is complete, issue the following command to retrieve the return code:
echo %ERRORLEVEL%

Fix any errors before continuing. The installation log is stored in the directory that was chosen for the installation (look for the files log.txt and logs.zip). To continue on and configure Tivoli Storage Manager, see Chapter 3, Taking the first steps after you install Tivoli Storage Manager, on page 33.

Server language locales

Translations for the Tivoli Storage Manager server allow the server to display messages and help in languages other than U.S. English. The translations also allow for the use of locale conventions for date, time, and number formatting. | | | The language package is automatically installed for the following default language option that is installed for Tivoli Storage Manager server messages and help: v LANGUAGE AMENG For languages or locales other than the default, install the language package of your choice. You can use the languages shown in the following tables:

Chapter 2. Installing the Tivoli Storage Manager server components

31

Table 16. Server languages for Windows Language Chinese, Simplified Chinese, Traditional English French German Italian Japanese (Shift-JIS) Korean Portuguese, Brazilian Russian Spanish LANGUAGE option value chs cht ameng fra deu ita jpn kor ptb rus esp

Notes: For further information about setting the LANGUAGE option, see the Administrator's Reference.

| | | | | | | |

Tivoli Storage Manager Console language support With the Microsoft Management Console (MMC) snap-in, you can manage Tivoli Storage Manager Windows and non-Windows resources across the network. To use the Tivoli Storage Manager Management Console, install the Version 1.2 or later MMC package. Tivoli Storage Manager includes only the American English version of the MMC package, which is installed automatically with the Tivoli Storage Manager server. To enable other language support for the Tivoli Storage Manager Console, you must install the appropriate language version of MMC. Restriction: For Administration Center users, some characters might not be displayed properly if the web browser version is not the same language as the server. If this problem occurs, use a browser version that uses the same language as the server.

Configuring a language package

After you configure a language package, the IBM Tivoli Storage Manager server displays messages and help in languages other than U.S. English. Installation packages are provided with Tivoli Storage Manager. To enable support for a given locale, complete one of the following tasks: v Set the LANGUAGE option in the server options file to the name of the locale that you want to use. For example: To use the ita locale, set the LANGUAGE option to ita. See Server language locales on page 31. If the locale successfully initializes, it controls the date, time, and number formatting for the server. If the locale does not successfully initialize, the server uses the U.S. English message files and the date, time, and number format.

32

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 3. Taking the first steps after you install Tivoli Storage Manager
After installing Tivoli Storage Manager Version 6.3, prepare for the configuration. Then, either use the configuration wizard to configure the Tivoli Storage Manager instance or configure the instance manually. Configure the Tivoli Storage Manager server instance by completing the following steps: 1. Create the directories and user ID for the server instance. See Creating the user ID and directories for the server instance on page 34. 2. Configure a Tivoli Storage Manager instance. Select one of the following options: v Use the Tivoli Storage Manager configuration wizard on your local system. See Configuring Tivoli Storage Manager using the configuration wizard on page 36. v Use the Management Console for a quick configuration. See Configuring the server instance by using the Management Console on page 37. v Manually configure the new Tivoli Storage Manager instance. See Configuring the server instance manually on page 39. Complete the following steps during a manual configuration. a. Set up your directories and create the Tivoli Storage Manager instance. See Creating the server instance on page 39. b. Create a new server options file by copying the sample file in order to set up communications between the server and clients. See .Configuring server and client communications on page 40. c. Issue the DSMSERV FORMAT command to format the database. See Formatting the database and log on page 43. d. Create a Windows service. See Creating a Windows service for the server instance on page 43. e. Configure your system for database backup. See Preparing the database manager for backup on page 38. 3. Configure options that control when the server runs database reorganization. See Configuring server options for server database maintenance on page 45. 4. Start the Tivoli Storage Manager server instance. See Starting the server instance on page 46. 5. Register your license. See Registering licenses on page 48. 6. Prepare your system for database backups. See Preparing the system for backups on page 48. 7. Monitor the server. See Monitoring the server on page 50.

| |

Copyright IBM Corp. 1993, 2011

33

Creating the user ID and directories for the server instance

Create the user ID for the Tivoli Storage Manager server instance and create the directories that the Tivoli Storage Manager server instance needs for database and recovery logs. Review the information about planning space for the server before completing this task. 1. Create the user ID that will own the server instance. You use this user ID when you create the server instance in a later step. Create a user ID that will be the owner of the Tivoli Storage Manager server instance. A user ID can own more than one Tivoli Storage Manager server instance. Identify the user account that will own the Tivoli Storage Manager server instance. When the server is started as a Windows service, this is the account that the service will log on to. The user account must have administrative authority on the system. One user account can own more than one server instance. If you have multiple servers on one system and want to run each server with a different user account, create a new user account in this step. a. Create the user ID. Restriction: The user ID must comply with the following rule: In the user ID, only lowercase letters (a-z), numerals (0-9), and the underscore character ( _ ) can be used. The user ID must be 8 characters or less, and cannot start with ibm, sql, sys, or a numeral. 1) Use the following command to create the user ID:
net user user_ID * /add

You are prompted to create and verify a password for the new user ID. 2) Issue the following commands to add the new user ID to the DB2 and Administrators groups:
net localgroup Administrators user_ID /add net localgroup DB2ADMNS user_ID /add net localgroup DB2USERS user_ID /add

b. Log in to the system, using the new user ID and password. c. For all directories that were created for the server instance, ensure that the user ID for the server instance has read/write access. The directories to check include the instance directory and all database and log directories. 2. Create directories that the server requires. Ensure that you are logged in under the new user ID you just created. You need unique, empty directories for each of the items shown in the following table. Create the database directories, the active log directory, and the archive log directory on different physical volumes. See the planning information for details.

34

IBM Tivoli Storage Manager for Windows: Installation Guide

Item

Example commands for creating the directories mkdir d:\tsm\server1

Your directories

The instance directory for the server, which is a directory that will contain files specifically for this server instance (the server options file and other server-specific files) The database directories

mkdir mkdir mkdir mkdir

d:\tsm\db001 e:\tsm\db002 f:\tsm\db003 g:\tsm\db004

Active log directory Archive log directory Optional: Directory for the log mirror for the active log Optional: Secondary archive log directory (failover location for archive log)

mkdir h:\tsm\log mkdir i:\tsm\archlog mkdir j:\tsm\logmirror

mkdir k:\tsm\archlogfailover

| | | |

When a server is initially created, with the DSMSERV FORMAT utility or with the configuration wizard, a server database and recovery log is created. In addition, files are created to hold database information used by the database manager. 3. Log off the new user ID.

Configuring Tivoli Storage Manager

After you have installed Tivoli Storage Manager Version 6.3 and prepared for the configuration, configure the Tivoli Storage Manager server instance. Configure a Tivoli Storage Manager server instance by selecting one of the following options: v Use the Tivoli Storage Manager configuration wizard on your local system. See Configuring Tivoli Storage Manager using the configuration wizard on page 36. v Use the Management Console. See Configuring the server instance by using the Management Console on page 37. v Manually configure the new Tivoli Storage Manager instance. See Configuring the server instance manually on page 39. Complete the following steps during a manual configuration. 1. Set up the directories and create the Tivoli Storage Manager instance. See Creating the server instance on page 39. 2. Create a new server options file by copying the sample file in order to set up communications between the Tivoli Storage Manager server and clients. See .Configuring server and client communications on page 40. 3. Issue the DSMSERV FORMAT command to format the database. See Formatting the database and log on page 43.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

35

4. Configure your system for database backup. See Preparing the database manager for backup on page 38.

Configuring Tivoli Storage Manager using the configuration wizard

The wizard offers a guided approach to configuring a server. By using the graphical user interface (GUI), you can avoid some configuration steps that are complex when done manually. Start the wizard on the system where you installed the Tivoli Storage Manager server program. Before beginning the configuration wizard, you must complete all preceding steps to prepare for the configuration, including installing Tivoli Storage Manager, creating the database and log directories, and creating the directories and user ID for the server instance. 1. Ensure that the following requirements are met: v The system must have one of the following protocols enabled. Ensure that the port that the protocol uses is not blocked by a firewall. Secure Shell (SSH). Ensure that the port is set to the default value, 22. Also ensure that the SSH daemon service has access rights for connecting to the system by using localhost. Remote shell (RSH). Remote Execution Protocol (REXEC). You might also need to disable User Account Control (at least while running this wizard). If you choose not to disable User Account Control, you must ensure that one of the other protocols is configured to allow the wizard to run. See Configuring Remote Execution Protocol on Windows Server 2008 on page 37 for instructions. Windows server message block (SMB) SMB is the interface used by File and Print Sharing (also known as CIFS). To use the SMB protocol, you must ensure that File and Print Sharing is enabled, and that port 445 is not blocked by your firewall. v You must be able to log on to the system using a protocol that is enabled on the system, by using either the user ID that you created for the server instance, or some other user ID that exists on the system. When using the wizard, you must provide the user ID and password to access the system. 2. Start the local version of the wizard: Double-click the dsmicfgx.exe program in installation_directory\server. The default directory is C:\Program Files\Tivoli\TSM. Follow the instructions to complete the configuration. The wizard can be stopped and restarted, but the server is not operational until the entire configuration process is complete.

36

IBM Tivoli Storage Manager for Windows: Installation Guide

Configuring Remote Execution Protocol on Windows Server 2008

Configure your Remote Execution Protocol (REXEC) settings by using these procedures. You must configure the User Account Control feature before running the wizard. 1. Enable Sharing for Guest or Everyone accounts. 2. Disable password-protected sharing: a. Click Start > Settings > Control Panel > Networking and Internet > Sharing and Discovery. b. Click the down arrow to display the password-protected sharing list. c. Click Turn off password protected sharing. d. Click Apply and exit. 3. Disable the User Account Control if you are using a different Administrator user account to connect to a Windows Server 2008 system. To disable User Account Control, complete the following steps: a. Click Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > Security Options. b. Double-click User Account Control. c. Run all administrators in Administrator Approval Mode and select Disable. d. Restart your system.

Configuring the server instance by using the Management Console

You can configure the Tivoli Storage Manager server instance by using the Management Console. To configure the Tivoli Storage Manager server by using the Management Console, complete the following steps after installing the Tivoli Storage Manager server and Tivoli Storage Manager client. For detailed instructions, see the Administrator's Guide. 1. Start > Programs > Tivoli Storage Manager > Management Console . The Tivoli Storage Manager Console window opens, with the Initial Configuration Task List displayed. Standard configuration is selected by default. 2. Click Start. The Server Initialization wizard opens. | | | | | | | | 3. To proceed through the wizard panels, click Next. Accept the default settings that are provided. Enter the logon account information for the server service. You must use an instance user ID that has permissions for starting the server service. The user account must have administrative authority on the system and must be a member of the DB2ADMNS and DB2USERS groups. If you do not specify an authorized user account, some wizards will not start. For detailed instructions, see the server initialization wizard topic in the Administrator's Guide. 4. Start the Tivoli Storage Manager server instance. See Starting the server instance on page 46. 5. Register your license. See Registering licenses on page 48. 6. Prepare your system for database backups. See Preparing the system for backups on page 48. 7. Monitor the server. See Monitoring the server on page 50.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

37

Preparing the database manager for backup

To back up the data in the database to Tivoli Storage Manager, you must enable the database manager and configure the Tivoli Storage Manager application programming interface (API). If you use the Tivoli Storage Manager configuration wizard to create a Tivoli Storage Manager server instance, you do not have to complete these steps. If you are configuring an instance manually, complete the following steps before issuing either the BACKUP DB or the RESTORE DB commands. Attention: If the database is unusable, the entire Tivoli Storage Manager server is unavailable. If a database is lost and cannot be recovered, it might be difficult or impossible to recover data managed by that server. Therefore, it is critically important to back up the database. However, even without the database, fragments of data or complete files might easily be read from storage pool volumes that are not encrypted. Even if data is not recovered, security can be compromised. For this reason, sensitive data must always be encrypted by the Tivoli Storage Manager client or the storage device, unless the storage media is physically secured. In the following commands, the examples use server1 for the database instance and d:\tsmserver1 for the Tivoli Storage Manager server directory. Replace these values with your actual values in the commands. 1. Create a file called tsmdbmgr.env in the d:\tsmserver1 directory with the following contents:
DSMI_CONFIG=d:\tsmserver1\tsmdbmgr.opt DSMI_LOG=d:\tsmserver1

2. Set the DSMI_ api environment-variable configuration for the database instance: a. Open a DB2 command window. One method is to go to the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed Tivoli Storage Manager in a different location, go to the db2\bin subdirectory in your main installation directory. Then, issue this command:
db2cmd

b. Issue this command:

db2set -i server1 DB2_VENDOR_INI=d:\tsmserver1\tsmdbmgr.env

3. Create a file called tsmdbmgr.opt in the d:\tsmserver1 directory with the following contents:
************************************************* nodename $$_TSMDBMGR_$$ commmethod tcpip tcpserveraddr localhost tcpport 1500 passwordaccess generate errorlogname d:\tsmserver1\TSMDBMGR_TSMSERVER1.log

Tip: Ensure that you enter the same tcpport as the server is using. This is specified in the dsmserv.opt file. 4. Stop and start the database instance: a. Open a DB2 command window. One method of doing this is by going to the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed Tivoli Storage Manager in a different location, go to the db2\bin subdirectory in your main installation directory. Then, issue this command:
db2cmd

b. Set the database instance:

set db2instance=server1

38

IBM Tivoli Storage Manager for Windows: Installation Guide

c. Stop DB2:
db2stop

d. Start DB2:
db2start

5. Enter the following command on one line:

"c:\program files\tivoli\tsm\server\dsmsutil.exe" UPDATEPW /NODE:$$_TSMDBMGR_$$ /PASSWORD:TSMDBMGR /VALIDATE:NO /OPTFILE: "d:\tsmserver1\tsmdbmgr.opt"

Configuring the server instance manually

After installing Tivoli Storage Manager Version 6.3, you can configure Tivoli Storage Manager manually instead of using the configuration wizard.

Creating the server instance

Create a Tivoli Storage Manager instance by issuing the db2icrt command. You can have one or more server instances on one workstation. Important: Before you run the db2icrt command, ensure that the user and the instance directory of the user exists. If there is no instance directory, you must create it. The instance directory stores the following files for the server instance: v The server options file, dsmserv.opt v Device configuration file, if the DEVCONFIG server option does not specify a fully qualified name v Volume history file, if the VOLUMEHISTORY server option does not specify a fully qualified name v Volumes for DEVTYPE=FILE storage pools, if the directory for the device class is not fully specified, or not fully qualified v User exits v Trace output (if not fully qualified) 1. Log in as an administrator and create a Tivoli Storage Manager instance, using the db2icrt command. Enter the following command on one line. The user account that you specify becomes the user ID that owns the Version 6.3 server (the instance user ID). |
db2icrt -s ese -u user_account instance_name

For example, if the user account is tsminst1 and the server instance is Server1, enter the following command: |
db2icrt -s ese -u tsminst1 server1

You are prompted for the password for user ID tsminst1. Later, when you create and format the database, you use the instance name that you specified with this command, with the -k option. 2. Change the default path for the database to be the drive where the instance directory for the server is located. Complete the following steps: a. Click Start > Programs > IBM DB2 > DB2TSM1 > Command Line Tools > Command Line Processor. b. Enter quit to exit the command-line processor.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

39

A window with a command prompt should now be open, with the environment properly set up to successfully issue the commands in the next steps. c. From the command prompt in that window, issue the following command to set the environment variable for the server instance that you are working with:
set db2instance=instance_name

The instance_name is the same as the instance name that you specified when you issued the db2icrt command. For example, to set the environment variable for the Server1 server instance, issue the following command:
set db2instance=server1

d. Issue the command to set the default drive:

db2 update dbm cfg using dftdbpath instance_location

For example, if the instance directory is d:\tsm\server1, the instance location is drive d:. Enter the command:
db2 update dbm cfg using dftdbpath d:

3. Create a new server options file. See Configuring server and client communications.

Configuring server and client communications

After installing Tivoli Storage Manager, you can set up client and server communications by specifying options in the Tivoli Storage Manager server and client options files. Set these server options before you start the server. When you start the server, the new options go into effect. If you modify any server options after starting the server, you must stop and restart the server to activate the updated options. Use the Server Options utility that is available from the Tivoli Storage Manager Console to view and specify server communications options. This utility is available from the Service Information view in the server tree. By default, the server uses the TCP/IP and Named Pipes communication methods. Tip: If you start the server console and see warning messages that a protocol could not be used by the server, either the protocol is not installed or the settings do not match the Windows protocol settings. For a client to use a protocol that is enabled on the server, the client options file must contain corresponding values for communication options. From the Server Options utility, you can view the values for each protocol. For more information about server options, see the Administrator's Reference. Setting TCP/IP options: Select from a range of TCP/IP options for the Tivoli Storage Manager server or retain the default. The following is an example of a list of TCP/IP options you can use to set up your system.

40

IBM Tivoli Storage Manager for Windows: Installation Guide

commmethod tcpport tcpwindowsize tcpnodelay

tcpip 1500 0 yes

Tip: You can use TCP/IP Version 4, Version 6, or both. TCPPORT The server TCP/IP port address. The default value is 1500. TCPWINDOWSIZE Specifies the size of the TCP/IP buffer that is used when sending or receiving data. The window size that is used in a session is the smaller of the server and client window sizes. Larger window sizes use additional memory but can improve performance. To use the default window size for the operating system, specify 0. TCPNODELAY Specifies whether or not the server sends small messages or lets TCP/IP buffer the messages. Sending small messages can improve throughput but increases the number of packets sent over the network. Specify YES to send small messages or NO to let TCP/IP buffer them. The default is YES. TCPADMINPORT Specifies the port number on which the server TCP/IP communication driver is to wait for requests other than client sessions. The default value is 1500. SSLTCPPORT (SSL-only) Specifies the Secure Sockets Layer (SSL) port number on which the server TCP/IP communication driver waits for requests for SSL-enabled sessions for the command-line backup-archive client and the command-line administrative client. SSLTCPADMINPORT Specifies the port address on which the server TCP/IP communication driver waits for requests for SSL-enabled sessions for the command-line administrative client. Setting Named Pipes options: The Named Pipes communication method is ideal when running the server and client on the same Windows machine. Named Pipes require no special configuration. Here is an example of a Named Pipes setting:
commmethod namedpipename namedpipe \\.\pipe\adsmpipe

| | | | | | |

COMMMETHOD can be used multiple times in the IBM Tivoli Storage Manager server options file, with a different value each time. For example, the following example is possible:
commmethod tcpip commmethod namedpipe

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

41

Setting shared memory options: You can use shared memory communications between clients and servers on the same system. To use shared memory, TCP/IP Version 4 must be installed on the system. The following example shows a shared memory setting:
commmethod shmport sharedmem 1510

In this example, SHMPORT specifies the TCP/IP port address of a server when using shared memory. Use the SHMPORT option to specify a different TCP/IP port. The default port address is 1510. | | | | | | | | COMMMETHOD can be used multiple times in the IBM Tivoli Storage Manager server options file, with a different value each time. For example, the following example is possible:
commmethod tcpip commmethod sharedmem

Setting SNMP DPI subagent options: Tivoli Storage Manager implements a simple network management protocol (SNMP) subagent. You can configure the SNMP subagent to send traps to an SNMP manager, such as NetView, and to provide support for a Management Information Base (MIB). For details about configuring SNMP for use with Tivoli Storage Manager, see the Administrator's Guide. The subagent communicates with the snmp daemon, which in turn communicates with a management application. The snmp daemon must support the DPI protocol. The subagent process is separate from the Tivoli Storage Manager server process, but the subagent gets its information from a server options file. When the SNMP management application is enabled, it can get information and messages from servers. Use the following SNMP DPI options as an example of a SNMP setting. You must specify the COMMMETHOD option. For details about the other options, see the Administrator's Reference.
commmethod snmpheartbeatinterval snmpmessagecategory snmp 5 severity

42

IBM Tivoli Storage Manager for Windows: Installation Guide

Formatting the database and log

Use the DSMSERV FORMAT command to initialize a server instance. No other server activity is allowed while initializing the database and recovery log. | | | | | After you set up server communications, you are ready to initialize the database. Ensure that you log in by using the instance user ID. Do not place the directories on file systems that might run out of space. If certain directories (for example, the archive log) become unavailable or full, the server stops. See Capacity planning on page 7 for more details. Important: The installation program creates a set of registry keys. One of these keys points to the directory where a default server, named SERVER1, is created. To install an additional server, create a directory and use the DSMSERV FORMAT utility, with the -k parameter, from that directory. That directory becomes the location of the server. The registry tracks the installed servers.

Setting the server code page

If the system uses a locale other than the English regional locale, set the DB2CODEPAGE system environment variable to 819 for each server instance. Before you issue the DSMSERV FORMAT command, log on to the system as the server instance owner and issue this command:
db2set -i instance_name DB2CODEPAGE=819

For example:
db2set -i server1 DB2CODEPAGE=819

Initializing a server instance

Use the DSMSERV FORMAT command to initialize a server instance. For example, issue the following command:
dsmserv -k server2 format dbdir=d:\tsm\db001 activelogsize=8192 activelogdir=e:\tsm\activelog archlogdir=f:\tsm\archlog archfailoverlogdir=g:\tsm\archfaillog mirrorlogdir=h:\tsm\mirrorlog

For more information, see the Administrator's Reference.

Creating a Windows service for the server instance

Install the Tivoli Storage Manager server as a Windows service during manual configuration of the Tivoli Storage Manager server. After you have completed formatting the database and log, you are ready to create a Windows service for your server instance. | | | | | | | | | Important: The standard way to start the server is by using the instance user ID. By using the instance user ID, you simplify the setup process and avoid potential issues. However, in some cases, it might be necessary to use another user ID to start the server. For example, you might want to use the administrator user ID to ensure that the server can access specific devices. To allow a user other than the instance user ID to start the server, the user ID must have administrative authority on the system and must be a member of the DB2ADMNS and DB2USERS groups. The user ID that is used to start the server must have appropriate authorizations; otherwise, the server does not function as expected. 1. Change to the C:\Program Files\Tivoli\TSM\console directory, or if you installed Tivoli Storage Manager in a different location, go to the console
Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

43

| |

subdirectory in your main installation directory. The install.exe file in this directory installs the Tivoli Storage Manager server as a Windows service. 2. Install the Windows service by using the same server name and user ID that you used to start the Tivoli Storage Manager server. Issue the following command:
install "TSM server_instance_name" "C:\Program Files\Tivoli\TSM\server\dsmsvc.exe" instance_owner instance_owner_password

where: v TSM server_instance_name is the name of the service that is being installed. v server_instance_name is the instance name that was specified when you issued the db2icrt command. v instance_owner is the instance owner account; this account will own the service. v instance_owner_password is the password for the instance owner account. If a different name was used for the server instance, or there are multiple server instances running on the system, modify the service name. After installing the Windows service, manually change the service to an automatic startup type. Do this by going to Windows Administrative Tools > Services. | | | | | | | | | | | | | | | | | | | | | | | | | | | | Example. To install the Windows service for the server1 server instance, enter the following command on one line. The example uses rudy as the instance owner and s21ret as the instance owner account.
C:\>cd "\Program Files\Tivoli\TSM\console" C:\Program Files\Tivoli\TSM\console>install "TSM server1" "C:\Program Files\Tivoli\TSM\server\dsmsvc.exe" rudy s21ret

Preparing the database manager for backup

To back up the data in the database to Tivoli Storage Manager, you must enable the database manager and configure the Tivoli Storage Manager application programming interface (API). If you use the Tivoli Storage Manager configuration wizard to create a Tivoli Storage Manager server instance, you do not have to complete these steps. If you are configuring an instance manually, complete the following steps before issuing either the BACKUP DB or the RESTORE DB commands. Attention: If the database is unusable, the entire Tivoli Storage Manager server is unavailable. If a database is lost and cannot be recovered, it might be difficult or impossible to recover data managed by that server. Therefore, it is critically important to back up the database. However, even without the database, fragments of data or complete files might easily be read from storage pool volumes that are not encrypted. Even if data is not recovered, security can be compromised. For this reason, sensitive data must always be encrypted by the Tivoli Storage Manager client or the storage device, unless the storage media is physically secured. In the following commands, the examples use server1 for the database instance and d:\tsmserver1 for the Tivoli Storage Manager server directory. Replace these values with your actual values in the commands. 1. Create a file called tsmdbmgr.env in the d:\tsmserver1 directory with the following contents:

44

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

DSMI_CONFIG=d:\tsmserver1\tsmdbmgr.opt DSMI_LOG=d:\tsmserver1

2. Set the DSMI_ api environment-variable configuration for the database instance: a. Open a DB2 command window. One method is to go to the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed Tivoli Storage Manager in a different location, go to the db2\bin subdirectory in your main installation directory. Then, issue this command:
db2cmd

b. Issue this command:

db2set -i server1 DB2_VENDOR_INI=d:\tsmserver1\tsmdbmgr.env

3. Create a file called tsmdbmgr.opt in the d:\tsmserver1 directory with the following contents:
************************************************* nodename $$_TSMDBMGR_$$ commmethod tcpip tcpserveraddr localhost tcpport 1500 passwordaccess generate errorlogname d:\tsmserver1\TSMDBMGR_TSMSERVER1.log

Tip: Ensure that you enter the same tcpport as the server is using. This is specified in the dsmserv.opt file. 4. Stop and start the database instance: a. Open a DB2 command window. One method of doing this is by going to the C:\Program Files\Tivoli\TSM\db2\bin directory, or if you installed Tivoli Storage Manager in a different location, go to the db2\bin subdirectory in your main installation directory. Then, issue this command:
db2cmd

b. Set the database instance:

set db2instance=server1

c. Stop DB2:
db2stop

d. Start DB2:
db2start

5. Enter the following command on one line:

"c:\program files\tivoli\tsm\server\dsmsutil.exe" UPDATEPW /NODE:$$_TSMDBMGR_$$ /PASSWORD:TSMDBMGR /VALIDATE:NO /OPTFILE: "d:\tsmserver1\tsmdbmgr.opt"

Configuring server options for server database maintenance

To help avoid problems with database growth and server performance, the server automatically monitors its database tables and reorganizes them when needed. Before starting the server for production use, set server options to control when reorganization runs. If you plan to use deduplication, ensure that the option to run index reorganization is enabled. Table and index reorganization requires significant processor resources, active log space, and archive log space. Because database backup takes precedence over reorganization, select the time and duration for reorganization to ensure that the processes do not overlap and reorganization can complete. For more information about scheduling reorganization, see Administrator's Guide.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

45

| | | | | | | | | | | | | | | | | | | | | | | | | | | | |

If you update these server options while the server is running, you must stop and restart the server before the updated values take effect. 1. Edit the server options file, which is located in the server instance directory. Follow these guidelines when editing the server options file: v Remove the asterisk at the beginning of the line to activate an option. v Begin entering an option in any column. v Enter only one option per line. The entire option with its value must be on only one line. v If you have multiple entries for an option in the file, the server uses the last entry. 2. If you plan to use deduplication, enable the ALLOWREORGINDEX server option. Add the following option and value to the server options file:
allowreorgindex yes

3. Set two server options that control when reorganization starts and how long it runs. Select a time and duration so that reorganization runs when you expect that the server is least busy. These server options control both table and index reorganization processes. a. Set the time for reorganization to start by using the REORGBEGINTIME server option. Specify the time using the 24-hour system. For example, to set the start time for reorganization as 8:30 p.m., specify the following option and value in the server options file:
reorgbegintime 20:30

b. Set the interval during which the server can start reorganization. For example, to specify that the server can start reorganization for 4 hours after the time set by the REORGBEGINTIME server option, specify the following option and value in the server options file:
reorgduration 4

4. If the server was running while you updated the server options file, stop and restart the server.

Starting the server instance

Verify that the server instance is correctly set up by starting the Tivoli Storage Manager instance. Remember: Starting the server is an operating system-level operation and has certain restrictions. If you do not have the permissions to use the dsmserv program, you cannot start it. If you do not have authority to read/write files in the instance directory, you cannot start that instance of the server. If you do not have authority to the server DB2 database, you cannot start that instance of the server. To start the server from the C:\Program Files\Tivoli\TSM server directory, enter: dsmserv -k server_instance where server_instance is the name of your server instance. Server1 is the default for the first instance of the Tivoli Storage Manager server.

46

IBM Tivoli Storage Manager for Windows: Installation Guide

Starting the server by using Windows services

You can use the Tivoli Storage Manager Management Console (a Microsoft Management Console snap-in), or the Windows Services Control Manager to start the server. To start the Tivoli Storage Manager server by using the Tivoli Storage Manager Management Console, the name of server instance must be one of the standards: Server1, Server2, Server3, or Server4. If you created the server instance by using the Tivoli Storage Manager Management Console, the name of the server instance is automatically one of the standard values. If a different method was used to create the server instance, the instance name must be one of the standard values so that you can start it using Windows services. | | Specify the instance user ID and start the server as a Windows service by using one of the following methods. v To start the server by using the Tivoli Storage Manager Management Console, complete the following steps. Optionally, you can set the server start mode and options. 1. From the Start menu, click Programs > Tivoli Storage Manager > Management Console. 2. Start the console monitor. It is important to monitor server activity with the administrative client by using the console monitor because the Tivoli Storage Manager server can issue requests that require action. a. Expand the tree until the server that you want to work with is displayed. Then, expand the server and the Reports tree under the selected server. b. Select Monitor and right-click it. Then, click Start. 3. Start the server as a Windows service. a. Expand the tree until the server that you want to work with is displayed. Then, expand the server and the Reports tree under the selected server. b. Select Service Information. c. Select the server in the right pane and right-click it. Then, click Properties. d. In the Log on as pane, enter the user ID that owns the server DB2 instance and has permissions for starting the server service. Then, enter and confirm the password for that user ID. e. Select the server in the right pane and right-click it. Then, click Start. 4. Optional: Set the server start mode and options. a. Expand the tree until the server that you want to work with is displayed. Then, expand the server and the Reports tree under the selected server. b. Select Service Information. c. Select the server in the right pane and right-click it. Then, click Properties. d. In the Startup type field, select Manual or Automatic. e. Check the Log output to file check box. Use the default console.log file name or specify another file name. v To start the server by using the Windows Services Control Manager, complete the following steps: 1. From the Start menu, click Programs > Administrative Tools > Services. You should see your service listed in the Services section of the page. 2. Select your service in the list, right-click it, and then click Start.
Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

| | |

47

| |

3. Set the service Startup Type and Log on account information. a. Select your service in the list, right-click it, and then click Properties. b. Select Automatic, Manual, or Disabled as the Startup Type. c. Specify the account under which the service logs on. The account must own the server DB2 instance and have permissions to start the service. To see the start and stop completion messages that are logged in the Windows Application log, use the Windows Event Viewer in Administrative Tools.

Stopping the server

You can stop the server without warning if an unexpected problem requires you to return control to the operating system. To avoid losing administrative and client node connections, stop the server only after current sessions have completed or been canceled. To stop the server, issue the following command from the Tivoli Storage Manager command prompt:
halt

The server console stops. Tip: If you start the Tivoli Storage Manager server as a service, after you stop it, the database service continues to run.

Registering licenses
Immediately register any Tivoli Storage Manager licensed functions that you purchase so you do not lose any data after you start server operations, such as backing up your data. Use the REGISTER LICENSE command for this task.

Preparing the system for backups

To prepare the system for automatic and manual database backups, you must specify the device class to be used. Before you begin the setup, ensure that you have defined a tape or file device class. See the defining device classes section of the Administrator's Guide. To set up your system for database backups, issue the SET DBRECOVERY command to specify a device class to be used for the backups. You can also change the device class to be used for database backups with the SET DBRECOVERY command. Perform the following setup procedure: 1. If you did not use the configuration wizard (dsmicfgx) to configure the server, ensure that you have completed the steps to manually configure the system for database backups. 2. Select the device class to be used for backups of the database. Issue the following command from a IBM Tivoli Storage Manager administrative command line.
set dbrecovery device_class_name

48

IBM Tivoli Storage Manager for Windows: Installation Guide

The device class that you specify is used by the database manager for database backups. If you do not specify a device class with the SET DBRECOVERY command, the backup fails. For example, to specify that the DBBACK device class is to be used, issue this command:
set dbrecovery dbback

When you are ready to back up your database, see the BACKUP DB command in the Administrator's Reference.

Running multiple server instances on a single system

You can create more than one server instance on your system. Each server instance has its own instance directory, and database and log directories. Multiply the memory and other system requirements for one server by the number of instances planned for the system. The set of files for one instance of the server is stored separately from the files used by another server instance on the same system. Use the steps in Creating the server instance on page 39 for each new instance, optionally creating the new instance user. To manage the system memory that is used by each server, use the DBMEMPERCENT server option to limit the percentage of system memory. If all servers are equally important, use the same value for each server. If one server is a production server and other servers are test servers, set the value for the production server to a higher value than the test servers. | | | | | | | | | | | | | | | | | | | | If you are upgrading from Tivoli Storage Manager Version 6.1 to V6.2 or V6.3 and have multiple servers on your system, you must run the upgrade wizard only once. The upgrade wizard collects the database and variables information for all of your original server instances. If you are upgrading from Tivoli Storage Manager Version 6.1 to V6.3, all instances that exist in DB2 Version 9.5 are dropped and recreated in DB2 Version 9.7. The wizard issues the db2 upgrade db dbname command for each database. The database environment variables for each instance on your system are also reconfigured during the upgrade process. A typical Tivoli Storage Manager installation involves one server instance on the Tivoli Storage Manager server computer. You might want to install a second instance if you are configuring in a clustered environment. You might also want to run more than one server on a large computer if you have multiple tape libraries or a disk-only configuration. After you install and configure the first Tivoli Storage Manager server, use the Server Initialization wizard to create additional Tivoli Storage Manager server instances on the same computer. For information about the Server Initialization wizard, see the Tivoli Storage Manager Administrator's Guide. By using the Server Initialization wizard, you can install up to four Tivoli Storage Manager server instances on a single system or cluster.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

49

Monitoring the server

When you start using server in production operation, monitor the space used by the server to ensure that the amount of space is adequate. Make adjustments as needed. 1. Monitor the active log, to ensure that the size is correct for the workload that is handled by the server instance. When the server workload is up to its typical expected level, and the space that is used by the active log is 80 - 90% of the space that is available to the active log directory, you might need to increase the amount of space. Whether you need to increase the space depends on the types of transactions in the server's workload, because transaction characteristics affect how the active log space is used. The following transaction characteristics can affect the space usage in the active log: v The number and size of files in backup operations Clients such as file servers that back up large numbers of small files can cause large numbers of transactions that complete during a short period of time. The transactions might use a large amount of space in the active log, but for a short period of time. Clients such as a mail server or a database server that back up large chunks of data in few transactions can cause small numbers of transactions that take a long time to complete. The transactions might use a small amount of space in the active log, but for a long period of time. v Network connection types Backup operations that occur over fast network connections cause transactions that complete more quickly. The transactions use space in the active log for a shorter period of time. Backup operations that occur over relatively slower connections cause transactions that take a longer time to complete. The transactions use space in the active log for a longer period of time. If the server is handling transactions with a wide variety of characteristics, the space that is used for the active log might go up and down by a large amount over time. For such a server, you might need to ensure that the active log typically has a smaller percentage of its space used. The extra space allows the active log to grow for transactions that take a very long time to complete, for example. 2. Monitor the archive log to ensure that space is always available. Remember: If the archive log becomes full, and the failover archive log becomes full, the active log can become full and the server will stop. The goal is to make enough space available to the archive log so that it never uses all its available space. You are likely to notice the following pattern: a. Initially, the archive log grows rapidly as typical client-backup operations occur. b. Database backups occur regularly, either as scheduled or done manually. c. After at least two full database backups occur, log pruning occurs automatically. The space used by the archive log decreases when the pruning occurs. d. Normal client operations continue, and the archive log grows again.

50

IBM Tivoli Storage Manager for Windows: Installation Guide

e. Database backups occur regularly, and log pruning occurs as often as full database backups occur. With this pattern, the archive log grows initially, then decreases, then might grow again. Over a period of time, as normal operations continue, the amount of space used by the archive log should reach a relatively constant level. If the archive log continues to grow, consider taking one or both of these actions: v Add space to the archive log. This might mean moving the archive log to a different file system. For information about moving the archive log, see the Tivoli Storage Manager Administrator's Guide. v Increase the frequency of full database backups, so that log pruning occurs more frequently. 3. If you defined a directory for the failover archive log, determine whether any logs get stored in that directory during normal operations. If the failover log space is being used, consider increasing the size of the archive log. The goal is that the failover archive log is used only under unusual conditions, not in normal operation. For details about monitoring, see the Administrator's Guide.

Chapter 3. Taking the first steps after you install Tivoli Storage Manager Version 6.3

51

52

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 4. Installing a Tivoli Storage Manager server fix pack

Tivoli Storage Manager maintenance updates, which are also referred to as fix packs, bring your server up to the current maintenance level. | | | | | To install a fix pack or interim fix to the server, install the server at the level on which you want to run it. You do not have to start the server installation at the base release level. For example, if you currently have V6.1.2.1 installed, you can go directly to the latest fix pack for V6.3. You do not have to start with the V6.3.0 installation if a maintenance update is available. You must have the Tivoli Storage Manager license package installed. The license package is provided with the purchase of a base release. After the fix pack or interim fix is installed, install the license for the server. Refer to the chapter on upgrading Tivoli Storage Manager for more information. | | | | | | | Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license. Visit this website: http://www.ibm.com/support/entry/portal/Overview/ Software/Tivoli/Tivoli_Storage_Manager for the following information: v A list of the latest maintenance and download fixes. Click Support and downloads and apply any applicable fixes. v Details about obtaining a base license package. Search for Warranties and licenses. v Supported platforms and system requirements. Click Server requirements. To install a fix pack or interim fix, complete the following steps. To preserve your server instances and database, do not uninstall your previous version of Tivoli Storage Manager. Attention: Do not alter the DB2 software that is installed with Tivoli Storage Manager installation packages and fix packs. Do not install or upgrade to a different version, release, or fix pack of DB2 software because doing so can damage the database. 1. Ensure that the Tivoli Storage Manager server is not running during the maintenance update. 2. Obtain the package file for the fix pack or interim fix that you want to install from the Tivoli Storage Manager FTP downloads site: ftp:// public.dhe.ibm.com/storage/tivoli-storage-management/maintenance/server. 3. Change to the directory where you placed the executable file. Then, either double-click the following executable file or enter the following command on the command line to extract the installation files. Tip: The files are extracted to the current directory. Ensure that the executable file is in the directory where you want the extracted files to be located.
Copyright IBM Corp. 1993, 2011

53

6.x.x.x-TIV-TSMALL-platform.exe

4. 5. 6.

7.

where: platform denotes the operating system that Tivoli Storage Manager is to be installed on. Ensure that you have backed up your Tivoli Storage Manager database. See the Administrator's Guide for more details. Halt the server before installing a fix pack or interim fix. Ensure that extra space is available in the installation directory The installation of this fix pack might require additional temporary disk space in the installation directory of the server. The amount of additional disk space can be as much as that required for installing a new database as part of a Tivoli Storage Manager installation. The Tivoli Storage Manager installation wizard displays the amount of space that is required for installing the fix pack and the available amount. If the required amount of space is greater than the available amount, the installation stops. If the installation stops, add the required disk space to the file system and restart the installation. Select one of the following ways of installing Tivoli Storage Manager. Important: After a fix pack is installed, it is not necessary to go through the configuration again. You can stop after completing the installation, fix any errors, then restart your servers. Installation wizard Installing Tivoli Storage Manager by using the installation wizard on page 26 Command-line console wizard Installing Tivoli Storage Manager by using the console installation wizard on page 27 Silent mode Installing Tivoli Storage Manager in silent mode on page 28

Fix any errors before continuing. The installation log, installFixPack.log, is stored in the following location: coi\plan\tmp | | | | | | | | | | | | | |

Applying a fix pack to Tivoli Storage Manager V6 in a clustered environment

To install a fix pack on a Tivoli Storage Manager V6 server installation in a Windows clustered environment, several steps are required. To install a fix pack or interim fix to the server, install the server at the level on which you want to run it. You do not have to start the server installation at the base release level. For example, if you currently have V6.1.2.1 installed, you can go directly to the latest fix pack for V6.3. You do not have to start with the V6.3.0 installation if a maintenance update is available. Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the

54

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license. 1. Disable automatic failback. You must disable automatic failback so that no groups automatically fail back during the installation. The cluster service then restarts automatically. a. In the Failover Cluster Manager window, select Services and Applications and right-click the cluster group. b. Select Properties. c. On the Failover tab in the Properties window, select Prevent failback and click OK. d. If multiple groups exist, repeat the preceding steps to disable automatic failback. 2. Determine the first server on which to install the fix pack. 3. Move the cluster groups from the node where the fix pack is to be installed. 4. Stop the cluster server node. In the Component Services window, right-click Cluster Service and click Stop. 5. Install the Tivoli Storage Manager fix pack. For details, see Installing a Tivoli Storage Manager fix pack. Tip: Tivoli Storage Manager is still running and available on another node. If the DB2 installation attempts to access an offline instance near the end of the installation, you might receive error message SQL5005C. This message does not indicate an installation failure. 6. Take the Tivoli Storage Manager server and the DB2 resources offline: a. In the Failover Cluster Manager window, in the left pane, select Services and Applications and then select the cluster group. The resources for the group are displayed in the right window pane. In the Other Resources section, SERVER1 and the Tivoli Storage Manager server are displayed. b. In the Other Resources section, right-click the Tivoli Storage Manager Instance(x) Server, where x represents the instance number. Select Take this resource Offline. Repeat this step for SERVER1. 7. Restart the cluster service on the current node. In the Component Services window, right-click Cluster Service and click Start. 8. Move the cluster groups to the current node: a. In the Failover Cluster Manager window, click Services and Applications. b. Right-click the cluster group and select Move this service or application to another node. The Current Owner column changes to the current node. c. Optional: If multiple groups exist, move the other cluster groups to the current node, repeat steps 8a and 8b. 9. Start the DB2 resources: a. In the Failover Cluster Manager window, in the left window pane, select Services and Applications, and then select the cluster group. b. In the right window pane, right-click SERVER1 and select Bring this service online. Repeat this step for each Tivoli Storage Manager Instance (x) Server, where x represents the instance number. 10. Stop the cluster service on the second node. In the Component Services window, right-click Cluster Service and click Stop. 11. Install the Tivoli Storage Manager fix pack. Tivoli Storage Manager is now running and available on the first node. If the DB2 installation attempts to

Chapter 4. Installing a Tivoli Storage Manager fix pack

55

| | | | | | | | | | | | | | | | | |

access an offline instance before the installation is completed, you might receive error message SQL5005C. This message does not indicate an installation failure. 12. Restart the cluster service on this node. From the Component Services window, right-click Cluster Service and click Start. 13. Move the cluster groups back to the servers that you want to use: a. In the Failover Cluster Manager window, click Services and Applications. b. Right-click the group that you want to move and select Move this service or application to another node. The Current Owner column changes to the selected node. c. For any other nodes that must be moved to the owners that you want to use, repeat step 13b. This step reverts the Microsoft Cluster Server environment to its initial configuration. 14. Restart automatic failback processing: a. In the Failover Cluster Manager window, right-click the cluster group. b. Select Properties. c. On the Failover tab of the Cluster Group Properties window, select Allow failback, and click OK.

56

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 5. Upgrading to Tivoli Storage Manager Version 6.3

You can upgrade directly to Tivoli Storage Manager Version 6.3 from any version of Tivoli Storage Manager 6.1 or 6.2. Multiple server instances on a system all use the same installed code, so all the server instances on a system must be upgraded at the same time.
Table 17. Upgrade information To upgrade from this version V6.3 V6.2 To this version Later version of 6.3 V6.3 See this information Installing a Tivoli Storage Manager server fix pack Upgrading from Tivoli Storage Manager Version 6.2 to 6.3 Upgrading from Tivoli Storage Manager Version 6.1 to 6.3 IBM Tivoli Storage Manager Upgrade and Migration Guide for V5 Servers

V6.1

V6.3

V5.5

V6.3

To return to an earlier version of Tivoli Storage Manager after an upgrade, you must have a full database backup of that original version and the installation code for the server of that original version.

Upgrading from Tivoli Storage Manager Version 6.1 to 6.3

You can upgrade directly to Tivoli Storage Manager Version 6.3 from Tivoli Storage Manager Version 6.1. Multiple server instances on a system all use the same installed code, so all the server instances on a system must be upgraded at the same time. The upgrade process recreates your server instances, recatalogs the databases for each instance, and upgrades each database, by using information saved from your previous installation. As a server and database are moved into Tivoli Storage Manager Version 6.3, the validity of the data is checked against constraints that are enforced in the new database. Tip: If you have multiple servers on your system, run the installation wizard only once. For more information about running multiple servers, see Running multiple server instances on a single system on page 49. Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license.

Copyright IBM Corp. 1993, 2011

57

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

1. Plan for system hardware and software requirements. See Chapter 1, Planning to install the IBM Tivoli Storage Manager server, on page 3. Restriction: You cannot upgrade your server to run on an operating system that is different from the operating system it currently runs on. 2. If you are installing the program from Passport Advantage, ensure that the executable file for the installation package is in the directory where you want the installation package to be located. Extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files. 3. For special instructions or specific information for your operating system, review the release notes: http://publib.boulder.ibm.com/infocenter/tsminfo/ v6r3/topic/com.ibm.itsm.relnotes.doc/relnote_server630.html. Alternatively, review the readme file found on the Tivoli Storage Manager installation DVD or in the directory in which the package was extracted. Attention: If the server that you are upgrading is at a release level earlier than V6.1.5.10, review Technote 1452146. The technote describes improvements to how the server performs database reorganization, and configuration changes that you might be required to make. 4. Locate the following file and run it to ensure that your system meets all requirements: prereqcheck.exe See Running the installation prerequisite checker on page 6 for details. 5. Back up the V6.1 server database and configuration files. 6. Back up the Deployment Engine by issuing the following commands:
cd "C:\Program Files\IBM\Common\acsi" setenv.cmd cd "C:\Program Files\IBM\Common\acsi\bin" de_backupdb.cmd

7. Ensure that all client activity and server processes are stopped. 8. Stop each server instance on the system by issuing this Tivoli Storage Manager command from an administrative command line or the server console:
halt

9. In the server instance directory of your installation, delete or rename the nodelock file. The nodelock file contains the previous licensing information for your installation. This licensing information is replaced when the upgrade is complete. 10. To create a list of current server instances, issue the following command: a. Open Windows Services. Go to Start > Programs > Administrative Tools > Services b. Find your existing server instances by looking for DB2-DB2TSM1 names, for example: DB2-DB2TSM1-SERVER1. Keep a record of each server name and each user ID associated with that server instance. The user ID is the name that is listed under Log On As. Keep a record of the database path for each instance. Verify that the database default paths are correct before performing the upgrade. 11. For each existing server instance, gather information about the corresponding DB2 instance. Note the default database path, database name, database alias, database path, and any DB2 variables configured for the instance.

58

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

12. Ensure that you have the user ID and password for each server instance because you need these for the upgrade. 13. Install the latest Tivoli Storage Manager server code, by using a wizard or silent mode. By using one of the wizards, you are guided to perform the upgrade steps in the correct order and you might be prompted for your server instance credentials. Until the new version is installed and any required licenses are registered again, clients cannot connect to the server. If you use the installation wizard or console installation wizard for the upgrade, ensure that the following requirements are met: v The system must have one of the following protocols enabled. Ensure that the port that the protocol uses is not blocked by a firewall. Secure Shell (SSH). Ensure that the port is set to the default value, 22. Also ensure that the SSH daemon service has access rights for connecting to the system by using localhost. Remote shell (RSH). Remote Execution Protocol (REXEC). You might need to disable User Account Control, at least while running the wizard. If you choose not to disable User Account Control, you must ensure that one of the other protocols is configured to allow the wizard to run. For instructions, see Configuring Remote Execution Protocol on Windows Server 2008 on page 37. Windows server message block (SMB) SMB is the interface used by File and Print Sharing (also known as CIFS). To use the SMB protocol, you must ensure that File and Print Sharing is enabled, and that port 445 is not blocked by your firewall. v You must be able to log on to the system by using a protocol that is enabled on the system, by using either the user ID that you created for the server instance, or some other user ID that exists on the system. When using the wizard, you must provide the user ID and password to access the system. If a connection cannot be established by using SSH, RSH, or REXEC, manually upgrade the Tivoli Storage Manager server instance from Version 6.1. For details, see http://www.ibm.com/support/docview.wss?uid=swg27018195. To install the latest server code, use one of the following methods: Installation wizard Upgrading Tivoli Storage Manager by using the installation wizard on page 62 Command-line console wizard Upgrading Tivoli Storage Manager by using the console installation wizard on page 63 Silent mode Upgrading Tivoli Storage Manager in silent mode on page 64 The DB2CKUPGRADE script conducts checks and creates logs for each database. These logs contain the results of the DB2CKUPGRADE command for each database. The log names have the following structure: <installation_directory> db2ckupgrade_<instance_name>_<db_name>.log The wizard automatically corrects some errors in the database during the upgrade to Version 6.3 and DB2 Version 9.7. You might need to correct other errors manually. For more details about database errors, see the Problem Determination Guide and search for DB2 log files. Run the upgrade again after you fix any errors.
Chapter 5. Upgrading the server from V6 to V6.3

59

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

14. Verify that the upgrade was successful by starting the server. See Starting the server instance on page 46. Perform some basic operations and query information about the system to confirm that all information transferred correctly. 15. Reregister previously registered licenses and register new licenses by using the REGISTER LICENSE command. For more information about the REGISTER LICENSE command, see the REGISTER LICENSE section in the IBM Tivoli Storage Manager Administrator's Reference. Restriction: You cannot register licenses for Tivoli Storage Manager for Mail, Tivoli Storage Manager for Databases, Tivoli Storage Manager for ERP, and Tivoli Storage Manager for Space Management. 16. Back up the Deployment Engine again by issuing the following commands:
cd "C:\Program Files\IBM\Common\acsi" setenv.cmd cd "C:\Program Files\IBM\Common\acsi\bin" de_backupdb.cmd

Upgrading from Tivoli Storage Manager Version 6.2 to 6.3

You can upgrade directly to Tivoli Storage Manager V6.3 server from any version of 6.2. Multiple server instances on a system all use the same installed code, so all the server instances on the system must be upgraded at the same time. To upgrade to Tivoli Storage Manager V6.3 server, you must have the Tivoli Storage Manager license package installed. The license package is provided with the purchase of a base release. For information about obtaining a base license package, see the Passport Advantage website at http://www.ibm.com/software/lotus/passportadvantage/ pacustomers.html. For information about supported platforms and system requirements, see the Tivoli Storage Manager support website at http://www.ibm.com/support/ search.wss?rs=663&tc=SSGSG7&atrn=Keywords&atrv=ServerRequirements. Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license. To upgrade Tivoli Storage Manager server to V6.3, complete the following steps. Attention: To preserve your server instances and database, do not uninstall your previous version of Tivoli Storage Manager. 1. For special instructions or specific information for your operating system, review the release notes: http://publib.boulder.ibm.com/infocenter/tsminfo/ v6r3/topic/com.ibm.itsm.relnotes.doc/relnote_server630.html. Attention: If the server that you are upgrading is at a release level earlier than V6.2.3.00, review Technote 1452146. The technote describes improvements to how the server performs database reorganization, and configuration changes that you might be required to make.

60

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

2. If you are installing the products by using the Tivoli Storage Manager DVD, complete the following step: Log on as an administrator. Insert the Tivoli Storage Manager server DVD. Use Windows Explorer to go to the DVD drive, double-click the DVD, and then double-click install.exe. To access Windows Explorer, go to Start > Programs > Accessories. The Tivoli Storage Manager server DVD browser window opens. 3. If you downloaded the program from Passport Advantage as an executable file, complete the following step. a. Verify that you have enough space to store the installation files when they are extracted from the product package. See the download document for the space requirements: Tivoli Storage Manager: http://www.ibm.com/support/ docview.wss?uid=swg24025642 Tivoli Storage Manager Extended Edition: http:// www.ibm.com/support/docview.wss?uid=swg24025643 System Storage Archive Manager: http://www.ibm.com/ support/docview.wss?uid=swg24025644 4. If you downloaded the program from Passport Advantage, ensure that the executable file for the installation package is in the directory where you want the installation package to be located. Be sure to extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files. 5. If you downloaded the program from Passport Advantage, change to the directory where you placed the executable file. To extract the installation files, double-click the following executable file or enter the following command on the command line.
6.x.x.x-TIV-TSMALL-platform.exe

where: platform denotes the operating system that Tivoli Storage Manager is to be installed on. 6. The remaining steps apply to all upgrades, including those that use the Tivoli Storage Manager DVD and that use Passport Advantage. Locate the following file and run it to ensure that your system meets all requirements: prereqcheck.exe See Running the installation prerequisite checker on page 6 for details. 7. Back up the Tivoli Storage Manager server database and configuration files. Ensure that at least one full database backup is available on site. If you must restore the database after a failed upgrade, having an on-site backup database saves time. For more information about database backups, see the Tivoli Storage Manager Administrator's Guide. 8. Back up the Deployment Engine by issuing the following commands:
cd "C:\Program Files\IBM\Common\acsi" setenv.cmd cd "C:\Program Files\IBM\Common\acsi\bin" de_backupdb.cmd

9. For each existing server instance, gather information about the corresponding DB2 instance. Note the default database path, database name, database alias, database path, and any DB2 variables configured for the instance. 10. Before upgrading Tivoli Storage Manager, stop the server.
Chapter 5. Upgrading the server from V6 to V6.3

61

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

11. In the server instance directory of your installation, delete or rename the nodelock file. The nodelock file contains the previous licensing information for your installation. This licensing information is replaced when the upgrade is complete. 12. Select one of the following ways of upgrading Tivoli Storage Manager. Important: After Tivoli Storage Manager is upgraded, it is not necessary to go through the configuration again. You can stop after completing the upgrade itself, fix any errors, then restart your servers. Installation wizard Upgrading Tivoli Storage Manager by using the installation wizard Command-line console wizard Upgrading Tivoli Storage Manager by using the console installation wizard on page 63 Silent mode Upgrading Tivoli Storage Manager in silent mode on page 64 13. Reregister previously registered licenses and register new licenses by using the REGISTER LICENSE command. For more information about the REGISTER LICENSE command, see the REGISTER LICENSE section in the IBM Tivoli Storage Manager Administrator's Reference. Restriction: You cannot register licenses for Tivoli Storage Manager for Mail, Tivoli Storage Manager for Databases, Tivoli Storage Manager for ERP, and Tivoli Storage Manager for Space Management. 14. Back up the Deployment Engine again by issuing the following commands:
cd "C:\Program Files\IBM\Common\acsi" setenv.cmd cd "C:\Program Files\IBM\Common\acsi\bin" de_backupdb.cmd

Inspect the log file, log.txt, and correct any errors. If you installed Tivoli Storage Manager by using the default directory, the installation log file is stored in the following location: The directory that was selected for installation; look for the files log.txt and logs.zip.

Upgrading Tivoli Storage Manager by using the installation wizard

Using the installation wizard is one method of upgrading Tivoli Storage Manager from Version 6. See Chapter 5, Upgrading to Tivoli Storage Manager Version 6.3, on page 57 for an overview of the upgrade steps, before starting the upgrade. To upgrade Tivoli Storage Manager from Version 6 by using the installation wizard, complete the following steps: 1. To start the wizard without saving your responses, enter the following command:
install.exe

Or, double-click the install.exe file. To start the wizard and save your responses to later use for a silent installation, enter the following command and specify the -r option.

62

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

install.exe -r C:\path_name\response.rsp

where path_name is the full directory path to where you want the response file to be created. If you do not specify a fully qualified name, the response file is placed in a temporary directory. 2. Select the language for your installation and follow the wizard, selecting Next to step through the wizard. Select the product that you are entitled to use and a license agreement is displayed. You can select only one product on the page. If you select Tivoli Storage Manager, Tivoli Storage Manager Extended Edition, or System Storage Archive Manager, you are asked if you will be using LAN-free or library sharing. If you select YES, you must accept the Tivoli Storage Manager for Storage Area Networks license. This is in addition to the license for the product that you chose on the previous page. Select the components that you want to install. Components include the server, languages, license, device driver, and storage agent. There is no default, so you must make a selection. If you previously installed a server, ensure that you select the same directory when you install a language pack, license, or device driver. If you previously installed a storage agent, ensure that you select the same directory if you return to install a device driver. A server and a storage agent cannot be installed on the same workstation. The Tivoli Storage Manager client application programming interface (API), DB2 Version 9.7, and IBM Global Security Kit (GSKit) Version 8 are automatically installed when you select the server component. At the end of the upgrade, a summary is provided. If errors occurred during the upgrade, another summary page lists the errors and directs you to an error log file. The installation log is stored in the following location: The directory that was chosen for installation; look for the files log.txt and logs.zip.

Upgrading Tivoli Storage Manager by using the console installation wizard

Using the console installation wizard is one method of upgrading Tivoli Storage Manager from Version 6. See Chapter 5, Upgrading to Tivoli Storage Manager Version 6.3, on page 57 for an overview of the upgrade steps, before starting the upgrade. To upgrade the Tivoli Storage Manager server from Version 6 by using the console installation wizard, complete the following steps: 1. To start the wizard without saving your responses, enter the following command:
install.exe -i console

To start the wizard and save your responses, enter the following command and specify the -r option.
install.exe -i console -r C:\path_name\response.rsp

where path_name is the full directory path to where you want the response file to be created. If you do not specify a fully qualified name, the response file is placed in a temporary directory.

Chapter 5. Upgrading the server from V6 to V6.3

63

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

2. Select the language for your installation and follow the wizard, selecting Next to step through the wizard. Select the product that you are entitled to use and a license agreement is displayed. You can select only one product on the page. If you select Tivoli Storage Manager, Tivoli Storage Manager Extended Edition, or System Storage Archive Manager, you are asked if you will be using LAN-free or library sharing. If you select YES, you must accept the Tivoli Storage Manager for Storage Area Networks license. This is in addition to the license for the product that you chose on the previous page. Select the components that you want to install. Components include the server, languages, license, device driver, and storage agent. There is no default, so you must make a selection. If you previously installed a server, ensure that you select the same directory when you install a language pack, license, or device driver. If you previously installed a storage agent, ensure that you select the same directory if you return to install a device driver. A server and a storage agent cannot be installed on the same workstation. The Tivoli Storage Manager client application programming interface (API), DB2 Version 9.7, and IBM Global Security Kit (GSKit) Version 8 are automatically installed when you select the server component. At the end of the upgrade, a summary is provided. If errors occurred during the upgrade, another summary page lists the errors and directs you to an error log file. The installation log is stored in the following location: The directory that was chosen for installation; look for the files log.txt and logs.zip.

Upgrading Tivoli Storage Manager in silent mode

Using silent mode is one method of upgrading Tivoli Storage Manager from Version 6. See Chapter 5, Upgrading to Tivoli Storage Manager Version 6.3, on page 57 for an overview of the upgrade steps, before starting the upgrade. Pass the variables in Table 18 into this file to define the silent upgrade: install.exe
Table 18. Variables for the silent upgrade Variable v -DIBM_TSM_LICENSE_ACCEPTED=true v -DIBM_TSMEE_LICENSE_ACCEPTED=true v -DIBM_SSAM_LICENSE_ACCEPTED=true v -DIBM_TSMSAN_LICENSE_ACCEPTED=true (required) Description Specify one or two variables or the installation stops. It also stops if you specify more than two variables. The wizard installs the license agreement for the Tivoli Storage Manager product that is selected. Tip: If two products are specified, the wizard checks that one of them is the Tivoli Storage Manager for Storage Area Networks license: IBM_TSMSAN_LICENSE_ACCEPTED=true. If one variable is not, the wizard stops.

64

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 18. Variables for the silent upgrade (continued) Variable For command line: -DINSTANCE_CRED="instance1 userid1 password1, instance2 userid2 password2" (required) For response file: INSTANCE_CRED=instance1 userid1 password1, instance2 userid2 password2 (required) Description Enter the instance credentials used by the upgrade wizard to redefine the database instance in an upgrade from V6.1. Use quotation marks around your credentials when you pass them into the command line. Specify multiple instances by separating them with a comma. install.exe -i silent -DIBM_TSM_LICENSE_ACCEPTED=true -DINSTALL_SERVER=1 -DINSTALL_LICENSE=1 -DINSTALL_DEVICES=1 -DINSTANCE_CRED= "instance1 userid1 password1, instance2 userid2 password2" To find the existing server instances, either issue the db2ilist command (from any path), or open Windows Services and go to Start > Programs > Administrative Tools > Services. Using Windows Services, you can find your server instances by looking for DB2-DB2TSM1 names, for example: DB2-DB2TSM1-SERVER1. The user ID is the name that is listed under Log On As. Tip: An instance cannot be in both the INSTANCE_CRED and the INSTANCE_OMIT parameters. All of the instances that exist when an installation package is upgraded must be listed in either the INSTANCE_CRED or the INSTANCE_OMIT parameters. Or, the silent upgrade fails. For command line:DINSTANCE_OMIT="instance3, instance4" (optional) For response file: INSTANCE_OMIT=instance3, instance4 (optional) Enter any instances that will not be recreated as part of the upgrade from V6.1. Use this variable if you have an instance that exists but is not used. Use it if you have removed the instance user ID, forgotten the password, or otherwise do not want to create the instance as part of a upgrade. Use quotation marks around your credentials when you pass them into the command line. Specify multiple instances by separating them with a comma. Tip: An instance cannot be in both the INSTANCE_CRED and the INSTANCE_OMIT parameters. All of the instances that exist when an installation package is upgraded must be listed in either the INSTANCE_CRED or the INSTANCE_OMIT parameters. Or, the silent upgrade fails. -DINSTALL_DEVICES=1 (optional) Upgrade the Tivoli Storage Manager device driver.

Chapter 5. Upgrading the server from V6 to V6.3

65

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 18. Variables for the silent upgrade (continued) Variable -DINSTALL_LICENSE=1 (required for base packages) Description Upgrade the Tivoli Storage Manager server license component. This variable should be specified only if the package being upgraded includes Tivoli Storage Manager server license files or the installation might fail. This option is typically only required for a first-time upgrade of the base release package. This option should not be used when installing most fix packs and interim fix packages because they do not include the server licenses. Upgrade the Tivoli Storage Manager server component. Upgrade the Tivoli Storage Manager storage agent. A server and a storage agent cannot be installed on the same workstation. -DINSTALL_language_pack=1 (optional) Upgrade a specific language pack. You can install the following server language-packs during the silent installation, using these variables: v INSTALL_GERMAN v INSTALL_SPANISH v INSTALL_FRENCH v INSTALL_ITALIAN v INSTALL_BRPORTUGUESE v INSTALL_KOREAN v INSTALL_JAPANESE v INSTALL_RUSSIAN v INSTALL_SCHINESE v INSTALL_TCHINESE For example, to install the German language pack, use this variable: -DINSTALL_GERMAN=1

-DINSTALL_SERVER=1 (optional) -DINSTALL_STAGENT=1 (optional)

Tip: After you start the silent upgrade, it immediately closes the foreground window and runs in the background. To receive a return code from the silent upgrade, run it using a batch script. See Upgrading silently by using a batch script on page 67. v To enable a component for a silent upgrade, append it to the install.exe command on a single line. For example:
install.exe -i silent -DIBM_TSM_LICENSE_ACCEPTED=true -DINSTALL_SERVER=1 -DINSTALL_LICENSE=1 -DINSTALL_ENGLISHUTF8=1

v Alternatively, the component variables can be placed into a response file. The path to this response file can then be passed into the install.exe command. To create this file, use the same variables that are in Table 18 on page 64.

66

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Remove the -D and separate the options on individual lines. Do not use quotation marks. For example:
INSTANCE_CRED=server1 server1 server1 INSTANCE_OMIT=server2 IBM_product_LICENSE_ACCEPTED=true INSTALL_SERVER=1 INSTALL_SPANISH=1

v To use an existing response file, enter the following command:

install.exe -i silent -f response_file

where the response_file is the full directory path to a file that you previously created in the Tivoli Storage Manager installation process. The response file contains variables you selected in a prior installation, using the GUI or console wizard. You might see a difference between response files, depending on which installation mode you used (GUI or console). Fix any errors before continuing. See the following log for more information: The upgrade directory; look for the file log.txt.

Upgrading silently by using a batch script

To receive a return code from the silent upgrade, run it using a batch script. To create and run a batch script, complete the following steps: 1. Create a file and name it install.bat. The file name must end with .bat, not .bat.txt. 2. Choose an installation option (with or without a response file) and enter the command into the install.bat file. Save it. For example:
install.exe -i silent -DIBM_TSM_LICENSE_ACCEPTED=true -f response_file

3. To run the batch file, open a command prompt. Issue this command:
install.bat

4. After the installation is complete, issue the following command to retrieve the return code:
echo %ERRORLEVEL%

Fix any errors before continuing. The installation log is stored in the directory that was chosen for the installation (look for the files log.txt and logs.zip).

Configuring Remote Execution Protocol on Windows Server 2008

Configure your Remote Execution Protocol (REXEC) settings by using these procedures. You must configure the User Account Control feature before running the wizard. 1. Enable Sharing for Guest or Everyone accounts. 2. Disable password-protected sharing: a. Click Start > Settings > Control Panel > Networking and Internet > Sharing and Discovery. b. Click the down arrow to display the password-protected sharing list. c. Click Turn off password protected sharing. d. Click Apply and exit.

Chapter 5. Upgrading the server from V6 to V6.3

67

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

3. Disable the User Account Control if you are using a different Administrator user account to connect to a Windows Server 2008 system. To disable User Account Control, complete the following steps: a. Click Control Panel > Administrative Tools > Local Security Policy > Security Settings > Local Policies > Security Options. b. Double-click User Account Control. c. Run all administrators in Administrator Approval Mode and select Disable. d. Restart your system.

Upgrading Tivoli Storage Manager server V6.1 to V6.3 in a clustered environment

To upgrade Tivoli Storage Manager from V6.1 to V6.3 in a Windows clustered environment, several steps are required. Some steps in this procedure require that you run the Microsoft Management Console (MMC). When you do so, you might get error message ANRU1203E. Continue by clicking OK > NEXT. You might be required to repeat this step several times. Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license. 1. Ensure that the cluster is running on the primary node. Unless otherwise noted, complete the following steps on the primary node. 2. In the Failover Cluster Manager window, take the Tivoli Storage Manager server and the DB2 server offline: a. In the left pane, select Services and Applications, and then select the cluster group. The resources for the group are displayed in the right pane. In the Other Resources section, SERVER1 and the Tivoli Storage Manager servers are displayed. b. Right-click TSM Instance(x) Server. Select Take this resource Offline. Repeat this step for SERVER1. 3. In the Failover Cluster Manager window, record the network name and IP address, and then delete them: a. In the left pane, under Services and applications, ensure that the cluster group is still selected. b. In the center pane, in the Summary window, under Server Name, expand the network name to view the IP address. Record the network name and IP address. c. Delete the network name, including the IP address. d. In the center pane, under Other Resources, delete TSM Instance(x) Server. 4. Ensure that all nodes in the cluster are running. 5. To remove DB2 clustering from the instance, for each Tivoli Storage Manager instance in the cluster, issue the following command:
db2mscs -u:instancename

68

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

6. In the Failover Cluster Manager window, verify that nothing but the shared disks remains in the cluster. 7. Move the cluster from the primary node to the node being updated. On each secondary node, go to the MMC. The MMC provides a choice of resources to delete. Delete the server instance and the registry entries for the server and console. Do not remove any files. Exit the MMC before moving to the next node. 8. Starting with the primary node, switch the cluster to the node being updated, and install Tivoli Storage Manager V6.3 on each node in the cluster. Important: Before installing the server, ensure that no windows are opened to DB2 directories; otherwise, the DB2 installation fails. 9. Ensure that the primary node owns the cluster resources and that all nodes in the cluster are running. From the MMC on the primary node, run the Cluster Configuration wizard. If you have multiple instances, repeat this procedure for each instance that you plan to reuse. Update these instances in the same order that was used originally. The MMC names the first server instance SERVER1, the second SERVER2, and so on. 10. Move the cluster resources to the next node to be configured. To initialize and configure the server, in MMC, run the Initial Configuration wizard on the appropriate node. When the last node in the cluster is added, the MMC creates cluster entries for Tivoli Storage Manager. Tip: When configuring on the second node, you might see message ANRU1119E: "A problem was encountered while interpreting Tivoli Storage Manager administration results. The wizard will not continue. Report this to Tivoli Storage Manager technical support." If you see this message, click OK > Finish.

Upgrading Tivoli Storage Manager server V6.2 to V6.3 in a clustered environment

The process for upgrading Tivoli Storage Manager from V6.2 to V6.3 in a Windows clustered environment is similar to installing a fix pack. Remember: Before upgrading the Tivoli Storage Manager server, ensure that you retain the Tivoli Storage Manager server base release installation media from the currently installed version. If you installed Tivoli Storage Manager from a DVD, ensure that the DVD is available. If you installed Tivoli Storage Manager from a downloaded package, ensure that the downloaded files are available. If the upgrade fails, and the server license module is uninstalled, the server base release installation media are required to reinstall the license. 1. Disable automatic failback. The reason for disabling automatic failback is that, during the installation, you must restart the server. The cluster service then restarts automatically. Automatic failback must be disabled so that no groups automatically fail back. a. In the Failover Cluster Manager window, select Services and Applications and right-click the cluster group. b. Select Properties. The Properties window for the cluster group opens. c. On the Failover tab, select Prevent failback and click OK. d. If multiple groups exist, repeat the preceding steps to disable automatic failback. 2. Determine the first server on which to install Tivoli Storage Manager V6.3.
Chapter 5. Upgrading the server from V6 to V6.3

69

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

3. Move the cluster groups off the node where V6.3 is to be installed. 4. Stop the cluster server node. In the Component Services window, right-click Cluster Service and click Stop. 5. Install Tivoli Storage Manager V6.3. For details, see Installing the Tivoli Storage Manager server components. Tip: Tivoli Storage Manager is still running and available on another node. If the DB2 installation attempts to access an offline instance, near the end of the installation, you might receive error message SQL5005C. This message does not indicate an installation failure. 6. Take the Tivoli Storage Manager server and the DB2 resources offline: a. In the Failover Cluster Manager window, in the left panel, select Services and Applications and then select the cluster group. The resources for the group are displayed in the right window panel. In Other Resources, SERVER1 and the Tivoli Storage Manager server are displayed. b. In Other Resources, right-click the Tivoli Storage Manager Instance(x) Server. Select Take this resource Offline. Repeat this step for SERVER1. 7. Restart the cluster service on the current node. In the Component Services window, right-click Cluster Service and click Start. 8. Move the cluster groups to the current node: a. In the Failover Cluster Manager window, click Services and Applications. b. Right-click the cluster group and select Move this service or application to another node. The Current Owner column changes to the current node. c. If multiple groups exist, to move the other cluster groups to the current node, repeat steps 8a and 8b. 9. Bring the DB2 resources online: a. In the Failover Cluster Manager window, in the left window panel, select Services and Applications, and then select the cluster group. b. In the right window panel, right-click SERVER1 and select Bring this service online. Repeat this step for each Tivoli Storage Manager Instance (x) Server. 10. Stop the cluster service on the second node. For example, from the Component Services window, right-click Cluster Service and click Stop. 11. On the second node, install Tivoli Storage Manager V6.3. Tivoli Storage Manager is now running and available on the first node. If the DB2 installation attempts to access an offline instance, near the end of the installation, you might receive error message SQL5005C. This message does not indicate an installation failure. 12. Restart the cluster service on this node. From the Component Services window, right-click Cluster Service and click Start. 13. Move the cluster groups back to the preferred servers: a. In the Failover Cluster Manager window, click Services and Applications. b. Right-click the group that you want to move and select Move this service or application to another node. The Current Owner column changes to the selected node. c. For any other nodes that must be moved to their preferred owners, repeat step 13b. This step reverts the Microsoft Cluster Server environment to its initial configuration. 14. If automatic failback was turned off in step 1, turn it back on: a. In the Failover Cluster Manager window, right-click the cluster group.

70

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

b. Select Properties. The Cluster Group Properties window opens. c. On the Failover tab, select Allow failback, and click OK.

Removing GSKit Version 7 after upgrading to Tivoli Storage Manager V6.3

The Tivoli Storage Manager installation wizard upgrades GSKit Version 8 and later. GSKit Version 7 is not removed or upgraded when you upgrade to Tivoli Storage Manager Version 6.3, even if it was installed with an earlier version of Tivoli Storage Manager. If you no longer need GSKit Version 7 and want to free up space on your system, you can remove it after the upgrade to Tivoli Storage Manager Version 6.3. Attention: Removing GSKit7 might affect other programs on your system that rely on it. 1. Back up your registry. a. Click Start, then click Run. b. Type Regedit. Click OK. c. To save a copy of your registry, select File > Export. d. If you must later restore the registry, select File > Import. See your Windows documentation for additional details. 2. Locate the directory where the GSKit is installed. The default directory is C:\Program Files\IBM\gsk7\. 3. Remove the GSKit installation directory, gsk7, and all subfiles and directories. Right-click the folder and click Delete. 4. Remove the GSKit 7 registry key and all subkeys and values. Attention: Removing the wrong key can cause system problems such as not being able to restart the workstation. a. Click Start, then click Run. b. Type Regedit. Click OK. c. The GSKit registry key is located in this directory: HKEY_LOCAL_MACHINE\ SOFTWARE\IBM. Right-click the registry key, HKEY_LOCAL_MACHINE\SOFTWARE\ IBM\GSK7, and click Delete.

Chapter 5. Upgrading the server from V6 to V6.3

71

72

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 6. Reverting from Version 6.3 to the previous Version 6 server

If you have to revert to the previous version of the server after an upgrade, you must have a full database backup from your original version, the server installation media for your original version, and key configuration files. By carefully following the preparation steps before upgrading the server, it might be possible to revert to the previous version of the Tivoli Storage Manager server with minimal loss of data. You must have the following items from the earlier version of the server: v Server database backup v Volume history file v Device configuration file v Server options file Use the same instructions whether you are reverting within releases or to an earlier release, for example, from 6.2.2 to 6.2.0 or from 6.2.2 to 6.1.2. The downlevel version must match the version that you used before the upgrade to 6.3. Attention: If you specified the REUSEDELAY parameter, backup-archive client data might be lost when you revert the server to a previous version.

Steps for reverting to the previous server version

Complete the following steps on the system that has the Version 6.3 server. 1. Back up the Version 6.3 database and save the contents of the instance directory, including the volume history file, the device configuration file, and server options file. Keep these files if you want to return to the Version 6.3 version of the server. 2. Remove the database from the database manager, then delete the database and recovery log directories. a. Manually remove the database. One way to do this is by issuing this command:
dsmserv removedb tsmdb1

b. If you must reuse the space that is occupied by the database and recovery log directories, you can now delete these directories. 3. Use the installation program to uninstall the Version 6.3 server. Uninstallation removes the server and the database manager, with their directories. 4. Reinstall the version of the server program that you were using before the upgrade to Version 6.3. This version must match the version that your server was running when you created the database backup that you will restore in a later step. For example, if the server was at version 6.2.2.0 before the upgrade, and you intend to use the database backup that was in use on this server, you must install the 6.2.2.0 fix pack to be able to restore the database backup. 5. Copy the following files to the directory for server information. v Device configuration file v Volume history file
Copyright IBM Corp. 1993, 2011

73

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v The server options file (typically dsmserv.opt) 6. If you are reverting to a version at or earlier than 6.1.2, complete the following steps. a. Locate the instance file: Instance.dat in the Tivoli Storage Manager server installation directory b. Recreate each of the instances in the instance file by issuing the db2icrt command:
installation_directory \db2\instance\db2icrt InstanceName -s ese u InstanceUser,password

c. Recreate the variables in the instance file by issuing the db2set -i command. Issue this command for each variable in your instance file. Ensure that the variable is in quotation marks:
installation_directory\db2\instance\db2set i InstanceName "Variable"

7. Format the database by using the DSMSERV FORMAT utility. For details, see the information for the version of the server that you are reinstalling. Information for Version 6.2 is available at this information center: http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2. Information for Version 6.1 is available at this information center: http://publib.boulder.ibm.com/infocenter/tsminfo/v6. 8. Restore the database using the backup that was created in the preparation steps before the upgrade. 9. If you enabled data deduplication for any FILE-type storage pools that existed before the upgrade, or if you moved data that existed before the upgrade into new storage pools while using the Version 6.3 server, you must perform additional recovery steps. For more details, refer to Additional recovery steps if you created new storage pools or enabled data deduplication on page 75. 10. If the REUSEDELAY parameter setting on storage pools is less than the age of the database that you restored, restore volumes on any sequential-access storage pools that were reclaimed after that database backup. Use the RESTORE VOLUME command. If you do not have a backup of a storage pool, audit the reclaimed volumes by using the AUDIT VOLUME command, with the FIX=YES parameter to resolve inconsistencies. For example:
audit volume volume_name fix=yes

11. If client backup or archive operations were performed using the Version 6.3 server, audit the storage pool volumes on which the data was stored. 12. If you were using active-data pools before upgrading to Version 6.3, you must recreate them. The amount of time required to recreate the active-data pools might be significant, depending on the number and size of the active-data pools to be recreated.

74

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Additional recovery steps if you created new storage pools or enabled data deduplication
If you created new storage pools, enabled data deduplication for any FILE-type storage pools, or did both while your server was running as a Version 6.3 server, you must complete additional steps to return to the previous server version. To complete this task, you must have a complete backup of the storage pool, which must have been created before the upgrade to Version 6.3. Use this information if you did either or both of the following actions while your server was running as a Version 6.3 server: v You enabled the data deduplication function for any storage pools that existed before the upgrade to Version 6.3 program. Data deduplication applies only to storage pools that use a FILE device type. v You created new, primary storage pools after the upgrade, and moved data that had been stored in other storage pools into the new storage pools. Perform these steps after the server is again restored to V6.1 or V6.2. v For each storage pool for which you enabled the data deduplication function, restore the entire storage pool by using the RESTORE STGPOOL command. v For storage pools that you created after the upgrade, determine what action to take. Data that was moved from existing, V6.1 or V6.2 storage pools into the new storage pools might be lost because the new storage pools no longer exist in your restored V6.1 or V6.2 server. Possible recovery depends on the type of storage pool: If data was moved from V6.1 or V6.2 DISK-type storage pools into a new storage pool, space that was occupied by the data that was moved was probably reused. Therefore, you must restore the original, V6.1 or V6.2 storage pools, by using the storage pool backups that were created before the upgrade to Version 6.3. If no data was moved from V6.1 or V6.2 DISK-type storage pools into a new storage pool, then audit the storage pool volumes in these DISK-type storage pools. If data was moved from V6.1 or V6.2 sequential-access storage pools into a new storage pool, that data might still exist and be usable in storage pool volumes on the restored V6.1 or V6.2 server. The data might be usable if the REUSEDELAY parameter for the storage pool was set to a value that prevented reclamation while the server was running as a Version 6.3 server. If any volumes were reclaimed while the server was running as a Version 6.3 server, restore those volumes from storage pool backups that were created before the upgrade to Version 6.3.

Chapter 6. Reverting from Version 6.3 to the previous Version 6 server

75

76

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 7. Uninstalling Tivoli Storage Manager

You can use the following procedures to uninstall Tivoli Storage Manager. Before you remove Tivoli Storage Manager, there are several steps to complete to ensure that you do not lose your backup and archive data. If you are running on 64-bit Windows Server 2008, ensure that you have created at least one Tivoli Storage Manager server instance before uninstalling Tivoli Storage Manager, or the uninstallation of DB2 might fail. See Chapter 3, Taking the first steps after you install Tivoli Storage Manager, on page 33 for details about creating a server instance. Attention: Do not use the Add/Remove Programs tool in the Windows Control Panel to uninstall Tivoli Storage Manager. Use only the uninstallation procedure described in this section. Complete the following steps before you uninstall Tivoli Storage Manager: v Complete a full database backup. v Save a copy of the volume history and device configuration files. v Store the output volumes in a safe location. Important: Uninstalling Tivoli Storage Manager removes all components of the Tivoli Storage Manager server Version 6.3. It is not possible to uninstall a single component of the product by itself. For example, you cannot uninstall only the Tivoli Storage Manager device driver and leave the Tivoli Storage Manager server. v To uninstall Tivoli Storage Manager using the standard method, complete the following steps: 1. Change to this directory: C:\Program Files\Tivoli\TSM\_uninst 2. Use one of the following methods to uninstall Tivoli Storage Manager: To use the installation wizard (GUI) to uninstall Tivoli Storage Manager, double-click the .exe file or enter the following command:
"Uninstall Tivoli Storage Manager.exe"

To use the console to uninstall Tivoli Storage Manager, enter this command:
"Uninstall Tivoli Storage Manager.exe" -i console

To silently uninstall Tivoli Storage Manager, enter this command:

"Uninstall Tivoli Storage Manager.exe" -i silent

3. Follow the prompts to uninstall Tivoli Storage Manager. v To uninstall Tivoli Storage Manager using silent mode with a batch script, complete the following steps: Tip: If you do not use a batch script, this uninstallation method immediately closes the foreground window and runs in the background. You will not receive a return code. 1. Create a file and name it uninstall.bat. The file name must end with .bat, not .bat.txt. 2. Type this command into the uninstall.bat file and save it:
"Uninstall Tivoli Storage Manager.exe" -i silent

3. Double-click the uninstall.bat file or start it using a command prompt.

Copyright IBM Corp. 1993, 2011

77

4. If you are using a command prompt, after the uninstallation is complete, issue the following command to retrieve the return code:
echo %ERRORLEVEL%

See Chapter 2, Installing the Tivoli Storage Manager server components, on page 25 for Tivoli Storage Manager Version 6.3 installation steps to reinstall the components.

Uninstalling and reinstalling Tivoli Storage Manager

If you plan to manually reinstall Tivoli Storage Manager instead of using the wizard, there are a number of steps to take to preserve your server instance names and database directories. During an uninstallation, any server instances you had set up are removed, but the database catalogs for those instances still exist. If you are using the wizard to upgrade from Tivoli Storage Manager Version 6.1 or Version 6.2, it is not necessary to complete these steps, the wizard completes them automatically. To manually uninstall and reinstall Tivoli Storage Manager complete the following steps: 1. Make a list of your current server instances before proceeding to the uninstallation. a. Open Windows Services. Go to Start > Programs > Administrative Tools > Services b. Find your existing server instances by looking for DB2-DB2TSM1 names, for example: DB2-DB2TSM1-SERVER1. Keep a record of each server name and each user ID associated with that server instance. The user ID is the name that is listed under Log On As. 2. Run the following commands for every server instance:
db2 attach to server1 db2 get dbm cfg show detail db2 detach

Keep a record of the database path for each instance. 3. Uninstall Tivoli Storage Manager. See Chapter 7, Uninstalling Tivoli Storage Manager, on page 77. After uninstalling Tivoli Storage Manager, check the Control Panel > Add or Remove Programs to verify that Tivoli Storage Manager DB2 is uninstalled. 4. When you uninstall any version of Tivoli Storage Manager 6.1 or later, including a fix pack, an instance file is created. The instance file is created to help reinstall Tivoli Storage Manager. Check this file and use the information when you are prompted for the instance credentials when reinstalling. In silent installation mode, you provide these credentials using the INSTANCE_CRED variable. You can find the instance file in the following location: Instance.dat in the Tivoli Storage Manager server installation directory 5. Reinstall Tivoli Storage Manager. See Chapter 2, Installing the Tivoli Storage Manager server components, on page 25. 6. Recreate your server instances. See Creating the server instance on page 39. Tip: The installation wizard configures the server instances but you must verify that they exist. If they do not exist, you must manually configure them. 7. Catalog the database. Log in to each server instance as the instance user, one at a time, and issue the following commands:

78

IBM Tivoli Storage Manager for Windows: Installation Guide

set db2 db2 db2 db2

db2instance=server1 catalog database tsmdb1 attach to server1 update dbm cfg using dftdbpath instance_drive detach

8. Verify that Tivoli Storage Manager recognizes the server instance by listing your directories. Your home directory appears if you did not change it. Your instance directory does appear if you used the configuration wizard. Issue this command:
db2 list database directory

If you see TSMDB1 listed, you can start the server.

Chapter 7. Uninstalling Tivoli Storage Manager

79

80

IBM Tivoli Storage Manager for Windows: Installation Guide

Part 2. Installing and upgrading Tivoli Monitoring for Tivoli Storage Manager
Install and upgrade Tivoli Monitoring for Tivoli Storage Manager.

Copyright IBM Corp. 1993, 2011

81

82

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | |

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

Tivoli Monitoring for Tivoli Storage Manager brings together multiple components, to provide real-time monitoring, and historical reporting for your Tivoli Storage Manager servers.

Report A should be generated using criteria A,B, and C. Reports B and C should A should be generReport be run 4 times daily. ated using criteria A,B, and Report C. Reports B and C should A should be generReports E and F should run 4 times daily. ated using criteria A,B, and be be terminated after one hour. C. Reports B and C should Report A should be generbe Reports E and F should run 4 times daily. ated using criteria A,B, and Reports G and H should be be terminated after one hour. C. mailed to personnel S, T, Reports E and F should Reports B and C should A should be generReport be run and K. be terminated after one hour. 4 times daily. ated using criteria A,B, and Reports G and H should be mailed to personnel S, T, C. Reports E and F should Reports B and C should A should be generReports G and H should be and K. be run 4 times daily. Report ated using criteria A,B, and mailed to personnel S,be terminated after one hour. T, C. and K. Reports E and F should Reports B and C should Reports G and H should be be run 4 times daily. mailed to personnel S,be terminated after one hour. T, and K. Reports E and F should Reports G and H should be mailed to personnel S,be terminated after one hour. T, and K. Reports G and H should be mailed to personnel S, T, and K.

Tivoli Enterprise Portal monitoring

Tivoli Common Reporting

Report on Monitoring Machine A is functioning at a Report on Monitoring B level. Machine A is functioning at a Report on Monitoring Machine B is functioning at a B level. B level with some issues. functioning at a Machine A is Machine B is functioning at a B level. There are two with some that B level machines issues. need immediate attention.functioning at a Machine B is There are two with some that B level machines issues. Machine C needs maintenenc need immediate attention. Machine D is terminal. two machines that There are Machine C needs maintenenc need immediate attention. Machine D is terminal. Machine C needs maintenenc Machine D is terminal.

Historical reports

Tivoli Enterprise Tivoli Enterprise Portal server Monitoring server

Tivoli Data Warehouse

DB2 database

Tivoli Monitoring for Tivoli Storage Manager agent instances

Tivoli Storage Manager server

Tivoli Storage Manager server

Tivoli Storage Manager server

| | |

Figure 1. Tivoli Monitoring for Tivoli Storage Manager components that provide the reporting and monitoring capabilities

Copyright IBM Corp. 1993, 2011

83

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

To build a system that can monitor data and produce reports, complete the following tasks: 1. Install Tivoli Monitoring for Tivoli Storage Manager, which includes these components: v DB2 v IBM Tivoli Monitoring, which includes: Tivoli Enterprise Portal server Tivoli Data Warehouse Tivoli Enterprise Monitoring server Summarization Pruning agent Warehouse Proxy agent Tivoli Monitoring for Tivoli Storage Manager agent Note: If you plan to monitor more than five Tivoli Storage Manager servers, you must install an agent on each of the servers that you intend to monitor. If you intend to monitor more than five servers, install additional agents. Otherwise, you can use the agent that was installed as part of the installation package. 3. Create and configure the agent instance to point to the Tivoli Storage Manager servers that you want to monitor. 4. To view historical reports, install the Administration Center, including the Tivoli Common Reporting component. 2. Note: The Administration Center, Tivoli Monitoring for Tivoli Storage Manager, and the monitoring agents must all be at version 6.3, but can be used to monitor any V5.4 - V6.3 Tivoli Storage Manager server. Related tasks Installing using the installation wizard on page 93 Chapter 10, Installing and configuring the Administration Center, on page 113 Creating and configuring the agent instance on page 95

Planning to install
Be sure to review all applicable planning information, including system requirements, capacity planning, and installation scenarios, before installing. Before you install the software, complete these tasks: Choose an installation scenario that best suits your needs. Read the system requirements that are required for your operating system. Review the capacity planning information. Review the installation work sheet and note the user IDs, passwords, and other values that are required during installation. 5. Optional: Run the prerequisite checker to verify the readiness of your installation environment. 1. 2. 3. 4. You must install the Administration Center, including the Tivoli Common Reporting component, on the same system where you installed Tivoli Monitoring for Tivoli Storage Manager. You can install either one first, but you must select the Tivoli Common Reporting component during the Administration Center installation.

84

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

If you installed the Administration Center without the Tivoli Common Reporting component, you must rerun the Administration Center installer to install the Tivoli Common Reporting component and to view historical reports. Install the Administration Center and Tivoli Monitoring for Tivoli Storage Manager on a system that is different than the system where the Tivoli Storage Manager server is installed. Note: The Administration Center, Tivoli Monitoring for Tivoli Storage Manager, and the monitoring agents must all be at version 6.3, but can be used to monitor any V5.4 - V6.3 Tivoli Storage Manager server.

Installation scenarios
Before installing Tivoli Monitoring for Tivoli Storage Manager, choose the scenario that best meets the needs of your company.
Table 19. Installation scenarios Scenario Number Scenario 1 Description Use this scenario for a new installation with a plan to monitor and report on 1-5 Tivoli Storage Manager servers. Tasks that you must complete Perform all the tasks in this scenario on the same system: 1. Install Tivoli Monitoring for Tivoli Storage Manager. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. 2. Configure the agent instance that was installed as part of the Tivoli Monitoring for Tivoli Storage Manager installation package. The approximate configuration time is 10 minutes. 3. Install the Administration Center on the same system as the Tivoli Monitoring for Tivoli Storage Manager. Ensure that you select the Tivoli Common Reporting component during installation. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

85

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 19. Installation scenarios (continued) Scenario Number Scenario 2 Description Use this scenario for a new installation with a plan to monitor and report on more than 5 Tivoli Storage Manager servers. Tasks that you must complete 1. Install Tivoli Monitoring for Tivoli Storage Manager. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. 2. Install additional agents on each Tivoli Storage Manager server that you want to monitor, and configure your agents to point to the Tivoli Enterprise Monitoring server host installed in Step 1. The approximate installation time is 15 - 30 minutes per additional agent, and 10 minutes additional configuration time per agent. 3. Install the Administration Center on the same system as the Tivoli Monitoring for Tivoli Storage Manager. Ensure that you select the Tivoli Common Reporting component during the installation. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.

86

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 19. Installation scenarios (continued) Scenario Number Scenario 3 Description Use this scenario when you install the software into an existing IBM Tivoli Monitoring environment with a plan to monitor up to 5 Tivoli Storage Manager servers. Tasks that you must complete Prerequisite: You must have IBM Tivoli Monitoring version 6.2.2 FP2 installed. 1. Install the new agent on the IBM Tivoli Monitoring server where Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server are installed. During the agent installation, you must specify the same directory that you did when you installed IBM Tivoli Monitoring. The approximate installation time is 15 30 minutes per additional agent, and 10 minutes additional configuration time per agent. 2. Configure each agent. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers. Scenario 4 Use this scenario when you install the software into an existing IBM Tivoli Monitoring environment with a plan to monitor more than 5 Tivoli Storage Manager servers. Prerequisite: You must have IBM Tivoli Monitoring version 6.2.2 FP2 installed. 1. Install the new agent on the Tivoli Storage Managerserver that you want to monitor and configure the agent instance to point to the system where the Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server are installed. During the agent installation, you must specify the same directory that you did when you installed IBM Tivoli Monitoring. The approximate installation time is 15 30 minutes per additional agent, and 10 minutes additional configuration time per agent. 2. Configure each agent. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.
Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

87

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Related tasks Installing using the installation wizard on page 93 Related reference Installation work sheet on page 91

System requirements for Tivoli Monitoring for Tivoli Storage Manager

Review the hardware and software requirements applicable for your system before you install Tivoli Monitoring for Tivoli Storage Manager. Related tasks Capacity planning on page 90 Running the prerequisite checker on page 93 Related reference Installation work sheet on page 91

System requirements
There are hardware and software requirements your system must meet before you install Tivoli Monitoring for Tivoli Storage Manager on a Windows system.

Hardware requirements
These tables list the minimum hardware and software requirements needed to install Tivoli Monitoring for Tivoli Storage Manager. Use these requirements as a starting point, but you can find the latest information at http://www.ibm.com/ support/docview.wss?uid=swg21425842. Table 20 describes the hardware requirements for the Tivoli Monitoring for Tivoli Storage Manager.
Table 20. Hardware requirements Type of hardware Hardware Hardware requirements v Dual core Intel Pentium compatible processor or multiprocessor-based computer with a 2 GHz or greater processor v Network interface card v Remote registry service must be enabled. For more information visit the Microsoft website. Disk space v 10 GB free space in the home directory where the warehouse data is stored (minimum). v 30 GB free disk space (minimum). Requirements increase as historical data is gathered and stored in Tivoli Data Warehouse. Memory v 3 GB minimum v If Tivoli Storage Manager monitoring agents are installed on the IBM Tivoli Monitoring server, memory requirements increase quickly as the number of Tivoli Storage Manager servers are monitored from that one IBM Tivoli Monitoring server. v If a Tivoli Storage Manager monitoring agent is installed on a Tivoli Storage Manager server, there is only a single instance of the agent running on the Tivoli Storage Manager server and no increases in memory requirements are needed by the IBM Tivoli Monitoring server.

88

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 20. Hardware requirements (continued) Type of hardware Monitor Hardware requirements Set your monitor resolution to 1024 x 768 (minimum) to view the entire window.

Software requirements
Table 21 describes the minimum software requirements for Tivoli Monitoring for Tivoli Storage Manager.
Table 21. Software requirements Type of software Operating system Minimum software requirements v Windows 2008 x86 32-bit v Windows 2008, 2008 R2 x64 Important: If you are installing a Tivoli Monitoring for Tivoli Storage Manager agent, and you previously installed an IBM Tivoli Monitoring server, you must install the Tivoli Monitoring for Tivoli Storage Manager agent on the existing Tivoli Enterprise Monitoring server. Tivoli Monitoring for Tivoli Storage Manager can only be used with IBM Tivoli Monitoring, version 6.2 FP1 or later. Web browser A web browser is required to use the Tivoli Common Reporting interface. Access Tivoli Common Reporting and the Administration Center with the Tivoli Integrated Portal. The browser can be installed on the same or separate system. The following browsers can be used: v Microsoft Internet Explorer 6.x v Microsoft Internet Explorer 7 v Microsoft Internet Explorer 8 v Firefox version 3.5 v Firefox version 3.6 cannot be used with Windows Server 2008 IBM Java version 5 is required to start Tivoli Enterprise Portal. Oracle Java is not supported. If the Common Reporting portlet is blank when opened in Internet Explorer 7, the default security settings might be too restrictive. Complete these steps to modify the security settings: 1. In an Internet Explorer version 7 window, click Tools > Internet Options, and on the Security tab, click Custom level. 2. Locate the Miscellaneous category, disable the Access data sources across domains option, and click OK to apply the changes. Tip: If your browser still does not display correctly, consider using a different browser. To avoid potential compatibility issues with web browsers you can view the Tivoli Enterprise Portal remotely using the Java Web Start applet: 1. Connect to http://hostname:1920. 2. Click IBM Tivoli Enterprise Portal Webstart Client to start the Java Web Start client. 3. Optionally create a desktop shortcut to launch the Tivoli Enterprise Portal in the future.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

89

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 21. Software requirements (continued) Type of software Minimum software requirements

Communication You must have at least one of the following communication protocols: Protocol v Named Pipes v TCP/IP Version 4 or Version 6 X Window System or X11 GUI Other software You must have an X11 Windows server running.

Eclipse 3.3 and Business Intelligence and Reporting Tools (BIRT), version 2.2.1 are required for creating custom BIRT reports.

Related tasks Capacity planning Running the prerequisite checker on page 93 Installing using the installation wizard on page 93 Related reference Installation work sheet on page 91

Capacity planning
Planning for Tivoli Monitoring for Tivoli Storage Manager includes determining how many servers that you want to monitor, how many agents and agent instances are required, and how much memory, and space is necessary for growth over time. The following list provides planning guidelines so you can anticipate the growth of your system over time, depending on how many agents are in your environment: v Each agent instance running on any server, whether it is a Tivoli Storage Manager agent or a Tivoli Monitoring for Tivoli Storage Manager requires approximately 150 MB of memory. v Each agent instance running on any server, whether it is a Tivoli Storage Manager agent, or a Tivoli Monitoring for Tivoli Storage Manager, requires up to 15% CPU resources during data collection. v During a one year period, the data WAREHOUS can grow to approximately 500 GB for each Tivoli Storage Manager server that is being monitored using the installation defaults. This value depends on the number of nodes backing up and archiving to that server, and the frequency that backups are occurring. Enabling pruning on the monitoring server can reduce that amount by approximately 50 percent. Related tasks Running the prerequisite checker on page 93 Related reference Installation work sheet on page 91

90

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | |

Installation work sheet

Use this work sheet to record information that you need when you install and administer Tivoli Monitoring for Tivoli Storage Manager.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

91

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 22. Tivoli Monitoring for Tivoli Storage Manager installation work sheet
Item DB2 user IDs db2admin Description Database administrator This is the Tivoli Data Warehouse user name and password. This user has permission to perform all the administrative tasks in DB2. encryption key The encryption key must be the same for all agents accessing the Tivoli Enterprise Monitoring server. Tivoli Enterprise Portal user name and password. User name: Password: Default value* db2admin Your value

The password must meet the password complexity requirements of the security policy.

IBMTivoliMonitoringEncryptionKey Must be exactly 32 characters in length. Valid characters are A-Z, a-z, 0-9, @ and #. User name: sysadmin Password: The password must meet the password complexity requirements of the security policy.

sysadmin

ITMUser

Tivoli Data Warehouse user name and password. This user has access to read the information from the WAREHOUS database.

User name: Password:

ITMuser

The password must meet the password complexity requirements of the security policy.

Instance name

You can specify the name of the agent instance. If you intend to monitor more than one Tivoli Storage Manager server, you will need agent instance names for all instances. This is the group that the DB2 instance user ID belongs to. You can specify which directory that you The default value is /home. want to store the DB2 instance information. This is where the database is stored by default. If you specify /home, the instance information is stored in /home/db2inst1. If you specify /information/db2, the instance information is stored in /information/db2/db2inst1. Ensure that there is enough space available in this directory and that the directory has write-access.

db2grp1 DB2 home directory

DB2 port

Default port number

The default port number is: 50000. Valid port numbers are 1024 - 65535.

*Best practices are to use the default values listed here. If you change these values ensure that you document them because they are needed later.

Related tasks Running the prerequisite checker on page 93 Installing using the installation wizard on page 93 Capacity planning on page 90

92

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Running the prerequisite checker

The installation prerequisite checker is an optional tool that verifies the operating system, the amount of free disk space for the installation, and other prerequisites. To ensure that your system environment is appropriate for the installation, you can run the prerequisite checker before each installation. Tip: The prerequisite checker verifies only the minimum memory that is necessary. More memory is required for additional tasks. The prerequisite checker presents a summary of results at the end of the check. Any changes that are required in your environment before the installation are listed. Any new directories that are required for the installation are created. To run the prerequisite checker, complete the following steps. 1. Ensure that the appropriate installation package is downloaded and that its files are extracted. A prerequisite checker is part of the installation package. 2. Choose the graphical interface (the default) or console method to start the installation, and follow the wizard instructions to complete the installation: v Issue this command to start the installation wizard using a graphical interface:
prereqcheck.exe

Or, double-click the prereqcheck.exe file. v Issue this command to start the installation wizard using the console method:
prereqcheck.exe -i console

3. Select the language for the prerequisite checker user interface. 4. In the welcome and disclaimer panels, review the statements and accept them. If an error message is shown in the Prerequisite Results page, make the required corrections before continuing with the installation. The summary page lists the errors and directs you to an error log file. Related tasks Installing using the installation wizard

Installing using the installation wizard

You can install Tivoli Monitoring for Tivoli Storage Manager using the installation wizard. Important: Do not use a domain ID to install. The Windows user ID that you use when installing must be a local ID with administrator privileges, and cannot be a domain ID. To install Tivoli Monitoring for Tivoli Storage Manager, complete these steps: 1. Confirm that you have the required access privileges, including user IDs and passwords. See Installation work sheet on page 91. 2. Ensure that you have satisfied all system requirements. See System requirements for Tivoli Monitoring for Tivoli Storage Manager on page 88. 3. Start the installation wizard using one of these methods:

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

93

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

v If you are installing using the DVD, insert the DVD into a DVD drive, navigate to that drive, and click the install.exe file to begin the installation wizard. Tip: You can run the prereqcheck.exe file to ensure that your system meets all requirements. v You can also download the program from the Passport Advantage site or the Tivoli Storage Manager FTP downloads site at ftp://public.dhe.ibm.com/ storage/tivoli-storage-management/maintenance/, and complete these steps to start the installation wizard: a. Verify that the executable file is in the directory where you want the extracted files to be located, and that there is enough space to store the installation files when they are extracted. For space requirements see the Passport Advantage download document. Important: 1) Extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files. 2) Ensure that there are no spaces, and no non-ASCII characters in the file name or path. 3) Use short path names for the directory to avoid problems with the 255 character path limit on Windows systems. For example: C:\tsm_images. b. Navigate to the directory where you placed the executable or package file, and extract the installation files. c. Locate the prereqcheck.exe file, and run it to ensure that your system meets all requirements. d. Double-click the install.exe file, and follow the wizard instructions to complete the installation. Tips: a. If you are installing into an existing IBM Tivoli Monitoring environment, you must specify the existing IBM Tivoli Monitoring instance directory. The default directory is C:\IBM. b. You cannot change the installation directory after you click Next. You must uninstall and begin again to change the installation directory. c. If there were any errors during the installation, the summary page lists the errors and directs you to an error log file. If you installed using the default directory, the log file can be found at: C:\IBM\logs.txt. d. The logs.zip file contains all of the installation log files for or all of the different components, and can be found at: install_dir/. For example, C:\IBM\logs.zip, if you installed using the default directory. After you have completed the installation, you must install the Administration Center, including the Tivoli Common Reporting component. See Chapter 10, Installing and configuring the Administration Center, on page 113. While the Administration Center installation is running, you can create and configure the agent instance. See Creating and configuring the agent instance on page 95.

94

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Related tasks Running the prerequisite checker on page 93 Chapter 10, Installing and configuring the Administration Center, on page 113 Creating and configuring the agent instance

Taking the first steps after installation

After you installed Tivoli Monitoring for Tivoli Storage Manager, you must create and configure an agent instance for each Tivoli Storage Manager server that you want to monitor. To run reports on the servers that you create agent instances for, you must also install the Administration Center, including the Tivoli Common Reporting component. One Tivoli Monitoring for Tivoli Storage Manager agent is automatically installed as part of the full first installation. This agent instance is a template that is used to create agent instances for each Tivoli Storage Manager servers that you want to monitor. It is not necessary to install additional agents unless you intend to monitor more than five Tivoli Storage Manager servers. If you want to monitor more than five servers, you must install an agent directly on each server that you want to monitor. Complete these two steps after you have completed installation: 1. Create an agent instance and configure it to point to the Tivoli Storage Manager server that you want to monitor. If you have multiple servers that you want to monitor, you must create instances for each server and configure each instance to point to the server that you want to monitor. v See Creating and configuring the agent instance on Windows systems on page 96. 2. Install the Administration Center, including the Tivoli Common Reporting component. See Chapter 10, Installing and configuring the Administration Center, on page 113. If you installed the Administration Center without the Tivoli Common Reporting component, you must rerun the Administration Center installer to install the Tivoli Common Reporting component, or you cannot view historical reports. Related tasks Chapter 10, Installing and configuring the Administration Center, on page 113 Creating and configuring the agent instance

Creating and configuring the agent instance

After you install Tivoli Monitoring for Tivoli Storage Manager, you must create and configure the agent instance to begin collecting data. If your environment has less than five Tivoli Storage Manager servers, you can use the monitoring agent template that was installed as part of the Tivoli Monitoring for Tivoli Storage Manager installation to create and configure up to five agent instances. If your environment has more than five Tivoli Storage Manager servers, you must install additional monitoring agents on each Tivoli Storage Manager servers that you want to monitor.
Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

95

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

This configuration provides the most efficient use of memory on both the Tivoli Storage Manager server, and the IBM Tivoli Monitoring server. Related tasks Creating and configuring the agent instance on Windows systems Next steps after creating and configuring the agent instance on page 97

Creating and configuring the agent instance on Windows systems

After installing the agent, you must create and configure an agent instance for each Tivoli Storage Manager server that you intend to monitor. To monitor multiple Tivoli Storage Manager servers from the same Tivoli Monitoring server, create an instance of the agent using the following method for each Tivoli Storage Manager server that you want to monitor. If you install the Tivoli Monitoring for Tivoli Storage Manager agent on the Tivoli Storage Manager servers, you do this task once, for each Tivoli Storage Manager server where the Tivoli Monitoring for Tivoli Storage Manager agent is installed. If you are installing an agent in an existing IBM Tivoli Monitoring server, and your Tivoli Enterprise Monitoring server, the Tivoli Enterprise Portal server, the Tivoli Enterprise Portal, and the data warehouse components are on a separate system, install an agent on each of those systems and configure it to communicate with the Tivoli Monitoring for Tivoli Storage Manager agent. See Installing monitoring agents on existing IBM Tivoli Monitoring servers on page 100. To configure the Tivoli Monitoring for Tivoli Storage Manager agent instance, complete the following steps: 1. Click Start > All Programs > IBM Tivoli Monitoring > Manage Tivoli Monitoring Services. 2. In the Manage Tivoli Enterprise Monitoring Services - TEMS Mode window, double-click Monitoring Agent for Tivoli Storage Manager template. 3. Specify the instance name and click OK. For example, inst1. 4. Complete the following fields for the Tivoli Storage Manager server to be monitored: a. In the Server Address field, enter the server address for the Tivoli Storage Manager server. b. In the Port Number field, enter the port number that is used to communicate with the Tivoli Storage Manager server. c. In the TSM Administrator field, enter the Tivoli Storage Manager administrator ID that is used to access the Tivoli Storage Manager server. d. In the TSM Administrator Password field, enter the password, twice for the Tivoli Storage Manager system administrator ID. e. Click OK to save the settings. 5. The Manage Tivoli Enterprise Monitoring Services page displays the new Tivoli Monitoring for Tivoli Storage Manager agent instance. 6. To start the Tivoli Monitoring for Tivoli Storage Manager agent instance, right-click the agent instance in the list, and select Start. Tip: If the agent was installed separately on an existing IBM Tivoli Monitoring server, you might need to stop and restart the Tivoli Enterprise Portal server to allow it to pick up and apply the new agent configuration settings. From the

96

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Manage Tivoli Monitoring Services window, select the Tivoli Enterprise Portal server, right-click and select stop, wait for it to stop, and then right-click and select Start. Related tasks Next steps after creating and configuring the agent instance

Next steps after creating and configuring the agent instance

After you installed Tivoli Monitoring for Tivoli Storage Manager, the Administration Center, including the Tivoli Common Reporting component, and created and configured your agent instance, you can verify that everything is installed and configured correctly. 1. To verify that the installation and configuration were successful, and that you are collecting data, complete these steps: a. Log in to the Tivoli Enterprise Portal: v Click Start > All Programs > IBM Tivoli Monitoring > Manage Tivoli Monitoring Services. b. Navigate to the Tivoli Storage Manager agent instance. If you created multiple instances of the agent, click each agent instance listed under the Tivoli Storage Manager branch in the navigation panel. The dashboard view displays data about each Tivoli Storage Manager server that you created an agent instance for. You can also navigate to the Agent Log workspace and look for messages such as TSM login succeeded. If you see a message that indicates that the login failed, you probably specified an incorrect ID or password when configuring your agent instance. If there is no data being collected, see the information about resolving problems with Tivoli Monitoring for Tivoli Storage Manager, in the Problem Determination Guide. 2. To begin working with reports complete these steps: a. Open a web browser and enter the following address:
https://hostname:port/ibm/console

where port is the port number specified when you installed the Tivoli Integrated Portal. The default port is 16311. b. Navigate to Reporting > Common Reporting > Work with Reports > Public Folders > Tivoli Products > Tivoli Storage Manager. 3. Optional: After you determine that you are successfully collecting data, you can review the pruning and retention values to ensure that they are appropriate for your organization. Pruning can significantly reduce the size of your database, in some cases by as much as 50 percent. a. Log in to the Tivoli Enterprise Portal. b. From the main menu, click Edit > History Configuration > Tivoli Storage Manager. c. Highlight the rows containing the groups that you want to modify. The summarization and pruning fields below the table become active. d. Select the summarization and pruning values that you want to modify, specify how long you want to keep the data, and click OK. The following table is one example of a modified pruning setup.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

97

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 23. Example of a modified pruning setup in the Configuration Controls Summarization value Yearly Quarterly Monthly Weekly Daily Hourly Pruning value Yearly Quarterly Monthly Weekly Daily Hourly Detailed data Specify a numeric value 3 4 12 31 7 1 31 Years, months, days Years Months Months Days Days Days Days

These settings are only examples. Your selections can vary depending on the data that you collect, how often you collect it, how long you keep it, and how often you prune it. To test the data that is being collected, start with a short interval. After you are sure that the data is being collected correctly, you can adjust the collection interval and pruning values to suit the needs or your company. Depending on the intervals that you chose, it can be a few days before your data is available for reports. Remember: Pruning removes data that is older than a specified time range. You cannot run reports on data that was removed through pruning. For additional information about running BIRT reports, or creating customized Cognos reports, see the section about monitoring operations in the Administrator's Guide. If you experience issues with your installation such as data not displaying in your reports, or other issues, review the information in the Problem Determination Guide about resolving problems with Tivoli Monitoring for Tivoli Storage Manager.

Installing monitoring agents

You can install Tivoli Monitoring for Tivoli Storage Manager agents on any remote Tivoli Storage Manager server that you want to monitor. The Tivoli Monitoring for Tivoli Storage Manager agent gathers data from each Tivoli Storage Manager server, and sends it to the Tivoli Monitoring server. You can monitor up to five Tivoli Storage Manager servers using the monitoring agent that was included as part of the Tivoli Monitoring for Tivoli Storage Manager installation package. If you want to monitor more than five Tivoli Storage Manager servers, you must install a monitoring agent on each of the servers that you want to monitor. Creating and configuring a single agent instance on the Tivoli Storage Manager server, instead of the monitoring server, can help to avoid an increase in memory requirements on the monitoring server. Remember: To use the agent in an existing Tivoli Monitoring environment, you must install the agent on the existing Tivoli Enterprise Monitoring server.

98

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Restriction: You can only use Tivoli Monitoring for Tivoli Storage Manager with the IBM Tivoli Monitoring, version 6.2.2 FP2, or later. See the system requirements for your platform for additional requirements. Related tasks Installing monitoring agents on Tivoli Storage Manager servers Installing monitoring agents on existing IBM Tivoli Monitoring servers on page 100 Installing monitoring agents and application support files on existing IBM Tivoli Monitoring servers on page 101

Installing monitoring agents on Tivoli Storage Manager servers

You can install a Tivoli Monitoring for Tivoli Storage Manager agent on any remote Tivoli Storage Manager server that you want to monitor. Important: Do not use a domain ID to install or configure agents. The Windows user ID that you use when installing must be a local ID with Administrator privileges, and cannot be a domain ID. To install the Tivoli Monitoring for Tivoli Storage Manager agent on the Tivoli Storage Manager server, complete these steps: 1. Start the installation wizard from the DVD or package file. 2. Accept the license agreement and click Next. 3. On the Component Selection page, select Tivoli Monitoring for Tivoli Storage Manager agent, and click Next. 4. Follow the wizard instructions to specify the installation location, language, and encryption key. For each agent that you install, you must specify the same encryption key that you entered during installation of the monitoring server. The default encryption key is: IBMTivoliMonitoringEncryptionKey. Requirement: If you are installing into an existing IBM Tivoli Monitoring environment, you must choose the same directory where IBM Tivoli Monitoring is installed. For example, if you installed IBM Tivoli Monitoring in the /opt/IBM/ITM directory, then you must specify /opt/IBM/ITM as the destination folder for this installation. 5. You are presented with the installation summary of your configuration. Select one of the following tasks: v Click Next to start the installation. v Click Previous to make corrections or changes. At the end of the installation, the Installation Results page displays. If there were any errors during the installation, the summary panel lists the errors and directs you to an error log file. 6. Click Finish. After you have installed the agent you must create and configure the agent instance. See: Creating and configuring the agent instance.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

99

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Installing monitoring agents on existing IBM Tivoli Monitoring servers

You can install additional Tivoli Monitoring for Tivoli Storage Manager agents on an existing Tivoli Enterprise Monitoring server. Before you install additional Tivoli Monitoring for Tivoli Storage Manager agents, ensure that all of these agents are stopped before proceeding with the agent installation: v v v v Tivoli Enterprise Monitoring server Tivoli Enterprise Portal server Warehouse summarization and pruning agent Warehouse proxy agent

Important: Do not use a domain ID to install or configure agents. The Windows user ID that you use when installing must be a local ID with Administrator privileges, and cannot be a domain ID. Restriction: You can only use Tivoli Monitoring for Tivoli Storage Manager with the IBM Tivoli Monitoring, version 6.2.2 FP2, or later. See the system requirements for your platform for additional requirements. To install the agent in an existing Tivoli Monitoring environment, complete these steps: 1. Start the installation wizard from the DVD or package file. 2. Accept the license agreement and click Next. 3. On the Component Selection page, select Tivoli Monitoring for Tivoli Storage Manager agent, and click Next. 4. Follow the wizard instructions to specify the installation location, language, and encryption key. For each agent that you install, you must specify the same encryption key that you entered during installation of the monitoring server. The default encryption key is: IBMTivoliMonitoringEncryptionKey. Requirement: If you are installing into an existing IBM Tivoli Monitoring environment, you must choose the same directory where IBM Tivoli Monitoring is installed. For example, if you installed IBM Tivoli Monitoring in the /opt/IBM/ITM directory, then you must specify /opt/IBM/ITM as the destination folder for this installation. 5. You are presented with the installation summary of your configuration. Select one of the following tasks: v Click Next to start the installation. v Click Previous to make corrections or changes. At the end of the installation, the Installation Results page displays. If there were any errors during the installation, the summary panel lists the errors and directs you to an error log file. 6. Click Finish. After you install the agent, you must create and configure the agent instance. See Creating and configuring the agent instance on page 95.

100

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Installing monitoring agents and application support files on existing IBM Tivoli Monitoring servers
If you have an existing IBM Tivoli Monitoring system that does not have Tivoli Monitoring for Tivoli Storage Manager installed, you must run the agent-only installation wizard, which installs the agent application support files, to monitor Tivoli Storage Manager servers. Important: Do not use a domain ID to install or configure agents. The Windows user ID that you use when installing must be a local ID with Administrator privileges, and cannot be a domain ID. Restriction: You can only use Tivoli Monitoring for Tivoli Storage Manager with the IBM Tivoli Monitoring, version 6.2.2 FP2, or later. See the system requirements for your platform for additional requirements. In this procedure, you complete the following tasks for an existing IBM Tivoli Monitoring system that does not have Tivoli Monitoring for Tivoli Storage Manager installed: v Install the monitoring agent on the Tivoli Storage Manager servers that you want to monitor, and configure it to point to the existing IBM Tivoli Monitoring server. See Installing monitoring agents on Tivoli Storage Manager servers on page 99. v Install the Tivoli Monitoring for Tivoli Storage Manager Agent only package files on the existing IBM Tivoli Monitoring server, to obtain the necessary application support files. Important: You must install the application support files using the Tivoli Monitoring for Tivoli Storage Manager agent only installation wizard. You cannot simply copy the files directly from the package. Complete these steps to install the agent-only package, which includes the application and support files: 1. Start the installation wizard from the DVD or package file. 2. Accept the license agreement and click Next. 3. On the Component Selection page, select Tivoli Monitoring for Tivoli Storage Manager agent, and click Next. 4. Follow the wizard instructions to specify the installation location, language, and encryption key. For each agent that you install, you must specify the same encryption key that you entered during installation of the monitoring server. The default encryption key is: IBMTivoliMonitoringEncryptionKey. Requirement: If you are installing into an existing IBM Tivoli Monitoring environment, you must choose the same directory where IBM Tivoli Monitoring is installed. For example, if you installed IBM Tivoli Monitoring in the /opt/IBM/ITM directory, then you must specify /opt/IBM/ITM as the destination folder for this installation. 5. You are presented with the installation summary of your configuration. Select one of the following tasks: v Click Next to start the installation. v Click Previous to make corrections or changes. At the end of the installation, the Installation Results page displays. If there were any errors during the installation, the summary panel lists the errors and directs you to an error log file.
Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

101

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

6. Click Finish. Note: You do not have to create and configure an agent instance on the existing IBM Tivoli Monitoring server. Therefore, performance is not impacted by the installation of the agent on the IBM Tivoli Monitoring server.

Installing software for custom BIRT reports

You can create your own reports using the Business Intelligence and Reporting Tools (BIRT) software. Ensure that you have fulfilled the IBM JDK and JRE requirements listed in the software requirements section for installing optional software. See System requirements on page 88. For help regarding setup, configuration, and troubleshooting of BIRT reports visit: BIRT Report Designer, v2.2.1, for Tivoli Common Reporting To create your own custom reports using BIRT and Tivoli Common Reporting, complete the following steps: 1. Download and install BIRT, version 2.2.1, All-In-One software by using one of the following websites: v For the BIRT software that you need to download and install, go to the following IBM Tivoli Integrated Service Management Library web site: BIRT Report Designer, v2.2.1, for Tivoli Common Reporting v If you cannot access the Integrated Service Management Library, you can obtain the software from the BIRT website: BIRT Report Downloads 2. Import the data, configure the data source, and customize the reports following the directions in Customizing Tivoli Common Reporting Report Designs found at: Customizing Tivoli Common Reporting Report Designs Related information Tivoli Common Reporting Information Center

Uninstalling Tivoli Monitoring for Tivoli Storage Manager

You can uninstall Tivoli Monitoring for Tivoli Storage Manager if it is no longer needed.

Uninstalling Tivoli Monitoring for Tivoli Storage Manager

You can uninstall Tivoli Monitoring for Tivoli Storage Manager using the command line, or the graphical user interface. If you plan to reinstall, this procedure helps to ensure that all previous versions and directories have been deleted from your system. 1. Select Start > Programs > IBM Tivoli Monitoring > Manage Tivoli Enterprise Monitoring Services, and look in the Status column to determine which agents are started. 2. Stop all Tivoli Monitoring for Tivoli Storage Manager agents. Select each agent and click Actions > Stop, or you can also click the stoplight icon. You can double-click the agent to toggle from start to stop, but care should be taken not to accidentally start an already stopped agent.

102

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | |

3. Choose one of these uninstallation methods: v To uninstall using the graphical interface click Start > Control Panel > Programs > Programs and Features, select IBM Tivoli Monitoring for Tivoli Storage Manager, and follow the menus to uninstall the software. v To uninstall using the command-line interface, open a command prompt window, navigate to installation_directory\_uninst directory, and issue the uninstall.exe command. The installation_directory is the location you selected to install Tivoli Monitoring for Tivoli Storage Manager. For example: C:\IBM\_uninst. If IBM Tivoli Monitoring for Tivoli Storage Manager no longer displays in the Programs menu, but you still have some of the components on your system, you can manually remove those components: v Click Start > Control Panel > Add / Remove Programs > IBM Tivoli Monitoring > Change/Remove, and follow the prompts. v To remove the agent select IBM Tivoli Monitoring for storage > Change/Remove, and follow the prompts. v To remove DB2 select DB2 Enterprise Server Edition - DBCOPY1 > Change/Remove, and follow the prompts. v Remove the installation directory. For example: C:\IBM. v Restart your system.

Chapter 8. Installing Tivoli Monitoring for Tivoli Storage Manager

103

104

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 9. Upgrading Tivoli Monitoring for Tivoli Storage Manager to Version 6.3
You can upgrade Tivoli Monitoring for Tivoli Storage Manager from V6.1 and V6.2 to V6.3. | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Upgrade scenarios
Before upgrading Tivoli Monitoring for Tivoli Storage Manager, choose the scenario that best meets the needs of your company.
Table 24. Upgrade scenarios Upgrade scenario number Scenario 1

Description Use this scenario for an upgraded installation, with a plan to monitor and report on 1-5 Tivoli Storage Manager servers.

Tasks that you must perform Perform all of the tasks in this scenario on the same system: 1. Install Tivoli Monitoring for Tivoli Storage Manager. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. 2. Configure the agent instance that was installed as part of the IBM Tivoli Monitoring for Tivoli Storage Manager installation package. The approximate configuration time is 10 minutes. 3. Install the Administration Center on the same system as the Tivoli Monitoring for Tivoli Storage Manager server. Ensure that you select the Tivoli Common Reporting component during installation. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.

Copyright IBM Corp. 1993, 2011

105

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Table 24. Upgrade scenarios (continued) Upgrade scenario number Scenario 2

Description Use this scenario for an upgraded installation, with a plan to monitor and report on more than 5 Tivoli Storage Manager servers.

Tasks that you must perform 1. Install Tivoli Monitoring for Tivoli Storage Manager. The approximate installation time is 45 - 90 minutes. 2. Install additional agents on each Tivoli Storage Manager server, and configure your agents to point to the Tivoli Enterprise Monitoring server host installed in Step 1. The approximate installation time is 15 - 30 minutes per additional agent, an 10 minutes additional configuration time per agent. 3. Install the Administration Center on the same system as the Tivoli Monitoring for Tivoli Storage Manager server. Ensure that you select the Tivoli Common Reporting component during installation. The approximate installation time is 45 - 90 minutes, depending on the speed of your system. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.

Scenario 3

Use this scenario for upgrading an existing IBM Tivoli Monitoring environment, with a plan to monitor up to 5 Tivoli Storage Manager servers.

Prerequisite: You must have IBM Tivoli Monitoring version 6.2.2 FP2 installed. Install the new agent on the IBM Tivoli Monitoring server where Tivoli Enterprise Monitoring server and Tivoli Enterprise Portal server are installed. During the agent installation, you must specify the same directory as you did when you installed IBM Tivoli Monitoring. Configure each agent. Notes: 1. You cannot install IBM Tivoli Monitoring for Tivoli Storage Manager on the same system where Tivoli Storage Manager server is installed. 2. However, you can install the monitoring agent on any remote Tivoli Storage Manager server that you want to monitor, even if you intend to monitor less than 5 servers.

106

IBM Tivoli Storage Manager for Windows: Installation Guide

Upgrading to version 6.3 on Windows systems

You can upgrade Tivoli Monitoring for Tivoli Storage Manager to version 6.3 using the Tivoli Monitoring for Tivoli Storage Manager installation wizard. Before you begin the upgrade: v Review the upgrade scenarios, and choose the one that best suits your needs. v Perform a backup of your existing system. v Export any BIRT or Cognos reports that have been customized. v If you have uninstalled a previous version of Tivoli Monitoring for Tivoli Storage Manager, before you reinstall, confirm that you have performed a successful uninstallation before reinstalling. That includes ensuring that the DB2 users, db2inst1 and db2fenc1 do not exist. To learn more about uninstalling see Uninstalling Tivoli Monitoring for Tivoli Storage Manager on page 102. Important: v The Windows user ID that you use when creating the Tivoli Enterprise Portal server database must be a local ID with administrator privileges, and cannot be a domain ID. v Do not alter the DB2 software that is installed with IBM Tivoli Monitoring for Tivoli Storage Manager installation packages and fix packs. Do not install or upgrade to a different version, release, or fix pack of DB2 software because doing so can damage the database. IBM Tivoli Monitoring for Tivoli Storage Manger can only use components and versions that are installed as part of the IBM Tivoli Monitoring for Tivoli Storage Manager installation. To upgrade Tivoli Monitoring for Tivoli Storage Manager, complete these steps: 1. Confirm that you have the required access privileges, including user IDs and passwords. See Installation work sheet on page 91. 2. Ensure that you have satisfied all system requirements. See System requirements for Tivoli Monitoring for Tivoli Storage Manager on page 88. 3. Stop all IBM Tivoli Monitoring agents that are running on the system. 4. Start the installation wizard using one of these methods: v If you are installing using the DVD, insert the DVD into a DVD drive, navigate to that drive, and click the install.exe file to begin the installation wizard. | | Tip: You can run the prereqcheck.exe file to ensure that your system meets all requirements. v You can also download the program from the Passport Advantage site or the Tivoli Storage Manager FTP downloads site at ftp://public.dhe.ibm.com/ storage/tivoli-storage-management/maintenance/, and complete these steps to start the installation wizard: a. Verify that the executable file is in the directory where you want the extracted files to be located, and that there is enough space to store the installation files when they are extracted. For space requirements see the Passport Advantage download document. Important: 1) Extract the installation files to an empty directory. Do not extract to a directory that contains previously extracted files, or any other files.

| | | | | | |

Chapter 9. Upgrading Tivoli Monitoring for Tivoli Storage Manager to V6.3

107

| | | | | | | |

2) Ensure that there are no spaces, and no non-ASCII characters in the file name or path. 3) Use short path names for the directory to avoid problems with the 255 character path limit on Windows systems. For example: C:\tsm_images. b. Navigate to the directory where you placed the executable or package file, and extract the installation files. c. Locate the prereqcheck.exe file, and run it to ensure that your system meets all requirements. d. Double-click the install.exe file, and follow the wizard instructions to complete the installation. Tips: a. If you are installing into an existing IBM Tivoli Monitoring environment, you must specify the existing IBM Tivoli Monitoring instance directory. The default directory is C:\IBM. b. You cannot change the installation directory after you click Next. You must uninstall and begin again to change the installation directory. c. If there were any errors during the installation, the summary page lists the errors and directs you to an error log file. If you installed using the default directory, the log file can be found at: C:\IBM\logs.txt. d. The logs.zip file contains all of the installation log files for or all of the different components, and can be found at: install_dir/. For example, C:\IBM\logs.zip, if you installed using the default directory. After you complete the upgrade, you must install the Version 6.3 Administration Center, including the Tivoli Common Reporting component. See Chapter 10, Installing and configuring the Administration Center, on page 113. Remember: The data source and all previous reports are overwritten during the Administration Center installation. If you customized any BIRT or Cognos reports that you want to save, you must export them before you install the Administration Center. After the installation is complete, you can import the customized reports. While the Administration Center installation is running, you can create and configure the agent instance. See Creating and configuring the agent instance on page 95.

| | |

| | | | | | | | | | |

Upgrading the monitoring agent

You can upgrade monitoring agents that are at an earlier version without having to uninstall them. To upgrade your existing monitoring agents to version 6.3, complete these steps: 1. Review the upgrade scenarios and the capacity planning information to determine whether you should install additional agents on an existing IBM Tivoli Monitoring system, or on a remote Tivoli Storage Manager that you want to monitor. 2. Stop all existing monitoring agents. From the Manage Tivoli Enterprise Monitoring Services window, select each monitoring agent instance, and click Actions > Stop.

108

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | |

Tip: You can also right-click, and select Stop, or click the stoplight icon at the top of the page. 3. Install a version 6.3 monitoring agent on the remote Tivoli Storage Manager that you want to monitor, or on an existing IBM Tivoli Monitoring system. For details see Installing additional agents. 4. Return to the Manage Tivoli Enterprise Monitoring Services window, select each monitoring agent instance, right-click, and select Start.

Chapter 9. Upgrading Tivoli Monitoring for Tivoli Storage Manager to V6.3

109

110

IBM Tivoli Storage Manager for Windows: Installation Guide

Part 3. Installing and upgrading the Administration Center

Use the Administration Center to administer Tivoli Storage Manager and Tivoli Monitoring for Tivoli Storage Manager from a supported browser anywhere in your network.

Copyright IBM Corp. 1993, 2011

111

112

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 10. Installing and configuring the Administration Center

Use the Administration Center to administer Tivoli Storage Manager and Tivoli Monitoring for Tivoli Storage Manager from a supported browser anywhere in your network. | | | | A standard installation without Tivoli Common Reporting takes approximately 35 minutes. If you install the Tivoli Common Reporting feature, the installation takes approximately 90 minutes. The installation time depends on the speed of your processor and the memory in your system. Use the following steps to install the Tivoli Integrated Portal and Administration Center. If you are upgrading the Administration Center, see Chapter 11, Upgrading the Administration Center to Version 6.3, on page 127. 1. Install your Tivoli Storage Manager Version 6.3 servers. See Chapter 2, Installing the Tivoli Storage Manager server components, on page 25. Give each server a unique name. 2. Start your Tivoli Storage Manager Version 6.3 server. See Starting the server instance on page 46. 3. Download and install the Administration Center. See Installing the Administration Center on page 116. 4. Verify the Administration Center installation. See Verifying the Administration Center installation on page 121. 5. Define your Tivoli Integrated Portal users. See Defining Administration Center users to the Tivoli Integrated Portal on page 123. 6. Add connections for the Tivoli Storage Manager servers that you want to manage. See Server connections to the Administration Center on page 130. Important: The IBM Deployment Engine (DE) is automatically installed with the Administration Center. Do not uninstall the Deployment Engine. Uninstalling this component can cause problems when upgrading the Administration Center. | | | | | The Administration Center directory (C:\IBM\tivoli) contains the following directories: v Tivoli Integrated Portal (C:\IBM\tivoli\tipv2) v Tivoli Common Reporting (C:\IBM\tivoli\tipv2Components\TCRComponent) v Administration Center (C:\IBM\tivoli\tsmac) Related tasks Chapter 11, Upgrading the Administration Center to Version 6.3, on page 127 Creating and configuring the agent instance on page 95

Copyright IBM Corp. 1993, 2011

113

Administration Center system requirements

The Tivoli Storage Manager server can require a large amount of memory, network bandwidth, and processor resources. In many cases, the server performs best when other applications are not installed on the same system. If the system meets the combined requirements for the server and the Administration Center, it can support both applications. If you plan to use the Administration Center to manage an environment with a large number of servers or administrators, consider installing the Administration Center on a separate system. For Administration Center system requirements, see the following website: http://www.ibm.com/support/docview.wss?uid=swg21515628. Important: The following platform is supported for Tivoli Integrated Portal Version 2.1 and the Administration Center for Tivoli Storage Manager Version 6.3: v Windows (32-bit and 64-bit) | | | | | | | | | | | | | | | | | | | | | | | | |

Running the installation prerequisite checker

The installation prerequisite checker is an optional tool that verifies the operating system, the amount of free disk space for the installation, and other prerequisites. To ensure that your system environment is appropriate for the installation, you can run the prerequisite checker before each installation. Tip: The prerequisite checker verifies only the minimum memory that is necessary. More memory is required for additional tasks. The prerequisite checker presents a summary of results at the end of the check. Any changes that are required in your environment before the installation are listed. Any new directories that are required for the installation are created. To run the prerequisite checker, complete the following steps. 1. Ensure that the appropriate installation package is downloaded and that its files are extracted. A prerequisite checker is part of the installation package. 2. Choose the graphical interface (the default) or console method to start the installation, and follow the wizard instructions to complete the installation: v Issue this command to start the installation wizard using a graphical interface:
prereqcheck.exe

Or, double-click the prereqcheck.exe file. v Issue this command to start the installation wizard using the console method:
prereqcheck.exe -i console

3. Select the language for the prerequisite checker user interface. 4. In the welcome and disclaimer panels, review the statements and accept them. If the Prerequisite Results page indicates that your system passed the checks, you are ready to start the installation.

114

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Item Installation location

If an error message is shown in the Prerequisite Results page, make the required corrections before continuing with the installation. The summary page lists the errors and directs you to an error log file. If you used the default directory, the log file can be found at this location: The installation directory; look for the file prereqcheck.log

Administration Center work sheet

Use this work sheet to record information that you need to install the Administration Center.
Table 25. Administration Center installation work sheet
Description Specify the base directory path for the installation. Subdirectories are automatically created for the Administration Center itself, the Tivoli Integrated Portal application, and other components. You can create a new directory or install into an existing Tivoli Integrated Portal instance. Migration If the installer detects a Version 6.2.x Administration Center, you can automatically migrate the existing user preferences and Tivoli Storage Manager server connections to the new Administration Center. Use this optional feature to view historical reports and real-time monitoring information for your Tivoli Storage Manager environment. Tip: To migrate an existing Tivoli Common Reporting installation to the current version, select the following wizard options: v Migrate a Version 6.2.x Administration Center v Install Tivoli Common Reporting Cognos port number Client Performance Monitor If you install Tivoli Common Reporting, you must specify a port number for the IBM Cognos Content Database. Use the Client Performance Monitor to view and analyze performance data for client backup and restore operations. The "time interval" setting specifies how long state information is kept for ongoing client operations. The "operation save time" setting specifies how long operational data is kept for historical reporting. Tip: To use this feature, some additional parameters must be specified in the client options file. For more information, see the Using the Application Programming Interface publication. Port number: 1527 An existing Administration Center is not migrated Default value C:\IBM\tivoli\ Your value

Tivoli Common Reporting

Tivoli Common Reporting is not installed

Port number: 5129 Time interval: 24 hours Operation save time: 14 days

Chapter 10. Installing the Administration Center

115

| | | | | | | | | | | | | | | |

Table 25. Administration Center installation work sheet (continued)

Item Description Default value Port number: 16310 Password: No default value User ID: tipadmin Tip: If you are installing into an existing Tivoli Integrated Portal instance, you must specify an existing user account that has the iscadmins role assigned. For a new installation, you must also specify the port number that is used to access the Administration Center through a web browser. Your value Administrator Create the user account that is used to manage access to the Administration Center. For example, you can account log on with this user ID to create and manage information additional administrative user accounts.

Installing the Administration Center

To install the Administration Center, you can use the graphical installation wizard, the console wizard, or the command line in silent mode. | | | | Using the Administration Center installation software, install the Tivoli Storage Manager Administration Center. The client performance monitor is installed as part of the Administration Center and more information about this is available within the Administration Center. 1. If you are installing the Administration Center using the DVD, complete the following steps: Log on as an administrator. Insert the Tivoli Storage Manager Administration Center DVD. Use Windows Explorer to go to the DVD drive, double-click the DVD, and then double-click install.exe. To access Windows Explorer, go to Start > Programs > Accessories or right-click Start. The DVD browser window opens. 2. If you are installing the Administration Center from the Tivoli Storage Manager FTP downloads site, obtain the package file here: ftp://public.dhe.ibm.com/ storage/tivoli-storage-management/maintenance/admincenter/. Change to the directory where you placed the executable file and complete the following steps: Important: The files are extracted to the current directory. Ensure that the executable file is in an empty directory. Do not extract the files into a directory where another Administration Center installation package or any other files are located. Either double-click the following executable file or enter the following command on the command line to extract the installation files.
6.3.0.0-TIV-TSMAC-platform.exe

| | | | | |

where platform denotes the operating system that the Administration Center is to be installed on. 3. Optional: After all the files have been extracted, locate this file and run it to ensure that your system meets all requirements: prereqcheck.exe See Running the installation prerequisite checker on page 6 for details. 4. Ensure that there are no processes using install_dir/tipv2/java. To check, issue this command:

116

IBM Tivoli Storage Manager for Windows: Installation Guide

Use a process monitor or explorer tool. 5. Select one of the following ways to install the Administration Center: Installation wizard Installing the Administration Center using the installation wizard Command-line console wizard Installing the Administration Center using the console installation wizard on page 118 Silent mode Installing the Administration Center in silent mode on page 118

Installing the Administration Center using the installation wizard

Using the installation wizard is one method of installing the Administration Center. To install the Administration Center using the installation wizard, complete the following steps: 1. To start the wizard, enter the following command:
install.exe

Or, double-click the install.exe file. The Administration Center installation wizard starts. 2. Select the language for your installation and follow the prompts. Tivoli Integrated Portal, the Administration Center, and the Client Performance Monitor are installed by default. The default Tivoli Integrated Portal user name is tipadmin. You must specify a password for this ID, or for a new ID you create. You use the ID and password later to log on to the Tivoli Integrated Portal and the Administration Center. Important: Save the user name and password or you are unable to uninstall the Administration Center. At the end of the installation, a summary is provided. Make a note of the port number that is listed in the summary panel. It might be different from the one that you entered in the wizard, depending on port availability and your system requirements. You need this port to log on to the Administration Center. | | | | Tip: A file named TSM_Administration_Center.htm is created in the Administration Center installation directory. Open this file in a web browser to automatically connect to the Administration Center. A desktop shortcut is also created for this file. If there are any errors during the installation, another summary page lists the errors and directs you to an error log file. The installation log is stored in this location: The directory that was chosen for installation (look for the file log.txt).

Chapter 10. Installing the Administration Center

117

Installing the Administration Center using the console installation wizard

Using the console installation wizard is one method of installing the Administration Center. To install the Administration Center using the console installation wizard, complete these steps: 1. To start the wizard, enter this command:
install.exe -i console

2. Select the language for your installation and follow the prompts. Tivoli Integrated Portal, the Administration Center, and the Client Performance Monitor are installed by default. The default Tivoli Integrated Portal user name is tipadmin. You must specify a password for this ID, or for a new ID you create. You use the ID and password later to log on to the Tivoli Integrated Portal and the Administration Center. Important: Save the user name and password or you are unable to uninstall the Administration Center. At the end of the installation, a summary is provided. Make a note of the port number that is listed in the summary panel. It might be different from the one that you entered in the wizard, depending on port availability and your system requirements. You need this port to log on to the Administration Center. | | | | Tip: A file named TSM_Administration_Center.htm is created in the Administration Center installation directory. Open this file in a web browser to automatically connect to the Administration Center. A desktop shortcut is also created for this file. If there are any errors during the installation, another summary page lists the errors and directs you to an error log file. The installation log is stored in this location: The directory that was chosen for installation (look for the file log.txt). | | | | | | | | | | | | |

Installing the Administration Center in silent mode

Use the silent installation option to automatically install the Administration Center and the optional Tivoli Common Reporting feature without any user interaction. To run a silent installation, complete the following steps: 1. Create a response file. A sample response file named sample_response.txt is located in the Tivoli Storage Manager installation media root directory. Use this sample file as a template to create your response file. 2. To start a silent installation, enter the following command on a single line:
install[.sh|.exe] -i silent -f full_path_name_to_response_file

Tip: After you start the silent installation, it immediately closes the foreground window and runs in the background. To receive a return code from the silent installation, run it using a batch script. See Installing silently using a batch script on page 31 for more details.

118

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

If there are any errors during the installation, another summary page lists the errors and directs you to an error log file. The installation log is stored in this location: The directory that was chosen for installation (look for the file log.txt).

Configuring LDAP user authentication

To use a Lightweight Directory Access Protocol (LDAP) server to authenticate access to the Administration Center, you must complete some additional configuration tasks after you install the Administration Center. Tips: v If you use a non-root user account to install the Administration Center, you must manually start the Tivoli Integrated Portal server after you complete the installation. For more information, see Starting and stopping the Tivoli Integrated Portal server on page 122. v Before you change the user authentication method, you must import the Secure Sockets Layer (SSL) certificate. To change the user authentication method from the local operating system to LDAP federated repositories, complete the following steps: 1. Open a web browser and log on to the Administration Center with a user account that has administrator privileges. To ensure that you are viewing all of the available tasks, click the View list in the upper left corner of the page and select All tasks. 2. Click Settings > WebSphere Administrative Console > Launch WebSphere administrative console. 3. In the WebSphere administrative console window, click Security > Global security. 4. From the Available realm definitions list, select Federated Repositories and click Configure. 5. Under Related Items, click Manage repositories. 6. Add the LDAP repository that you want to use for authentication by clicking Add and entering the following parameters: Repository identifier A unique identifier for the repository within the cell, for example: LDAP1. Directory type The type of server that you want to connect to. Primary host name The host name of the primary LDAP server. This host name is either an IP address or a domain name service (DNS) name. Port The LDAP server port. The default value is 389, which is not a Secure Sockets Layer (SSL) connection. Port 636 can be an SSL connection. For some LDAP servers, you can specify a different port for a non-SSL or SSL connections. If you do not know the port to use, contact your LDAP server administrator.

Bind distinguish name The distinguished name (DN) for the application server to use when binding to the LDAP repository. If no name is specified, the application server binds anonymously. In most cases, bind DN and
Chapter 10. Installing the Administration Center

119

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

bind password are needed. However, when anonymous bind can satisfy all of the required functions, bind DN and bind password are unnecessary. Bind password The password that the application server uses when binding to the LDAP repository. 7. Click OK. 8. In the message box, click Save directly to the master configuration. 9. In the repository identifier column, click the identifier for the repository that you want to use. 10. On the configuration panel, under Additional Properties, click the LDAP entity types. 11. In the Entity Type column, click the link for Group, OrgContainer, and PersonAccount. Complete the search bases field. The search bases field specifies the search bases that are used to search this entity type. The search bases specified must be sub-trees of the base entry in the repository. The following example search bases have o=ibm,c=us as the base entry in the repository:
o=ibm,c=us or cn=users,o=ibm,c=us or ou=austin,o=ibm,c=us

You can use a semicolon to delimit the search bases. For example:
ou=austin,o=ibm,c=us;ou=raleigh,o=ibm,c=us

12. Click OK and then click Save to the master configuration. You must save to the master configuration every time that you update the search bases field. 13. Return to the federated repositories page and click Supported Entity Types under Additional Properties. 14. In the Entity type column, click the link for Group, OrgContainer, and PersonAccount and complete the base entry for the default parent and Relative Distinguished Name properties fields. a. In the Base entry for the default parent field, enter the same value that you entered in the Search bases field in step 11. b. In the Relative Distinguished Name properties field, enter the appropriate LDAP attribute name. In most cases, the values for this field are cn for Group, o;ou;dc;cn for OrgContainer, and uid for PersonAccount. 15. Click OK and then click Save to the master configuration. You must save to the master configuration every time that you update the base entry for the default parent field. 16. Return to the federated repositories page and click Apply, then click Save to the master configuration. 17. Under Repositories in the realm, click Add base entry to Realm. 18. On the repository reference page, select the repository that you created in step 6 on page 119 from the repository list. 19. Enter the distinguished name of a base entry that uniquely identifies the repository in the realm. You must enter the information in the Distinguished name of a base entry uniquely identifying this set of entries in the realm field. In most instances, this value is the same value that you entered in the Search bases field in step 11. 20. In the Distinguished name of a base entry in this repository field, enter the distinguished name of the base entry within the repository. In most instances, this value is the same value that you entered in the Distinguished name of a base entry that uniquely identifies this set of entries in the realm field.

120

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | | | | | | | | | | | | | | | | |

21. Click OK and then click Save to the master configuration. You must save to the master configuration every time that you update the distinguished name of a base entry. The base entry identifies the set of entries in the realm field. Two repositories are displayed under repositories in the realm on the federated repositories page; the repository you added, and a default repository. 22. Change the realm name or leave the value in the Realm name field as it is. 23. In the primary administrative user name field, enter the name of a user that you added in the repository. The named user is granted administrative privileges for the Tivoli Integrated Portal server. 24. Click the server identity that is stored in the repository. 25. In the server user ID or the administrative user node field, enter the ID that you entered in the primary administrative user name field. Enter the password for the user ID. 26. Select the default file repository that shows File in the Repository type column and remove it. 27. Click OK and then click Save to the master configuration. 28. Return to the secure administration, applications, and infrastructure page. 29. In the available realm definition list, select Federated repositories and click Set as current. 30. Click Apply and then click Save to the master configuration. 31. Stop and restart the Tivoli Integrated Portal server.

Verifying the Administration Center installation

After you install the Administration Center, verify the installation by opening the Administration Center and logging in. Complete the following steps: 1. If you used a non-root user account to install the Administration Center, start the Tivoli Integrated Portal server. For more information, see Starting and stopping the Tivoli Integrated Portal server on page 122. 2. Open the Administration Center by entering one of the following addresses in a supported web browser:

http://workstation_name:non_secure_port/ibm/console

Or:
https://workstation_name:secure_port/ibm/console

The workstation_name is the network name or IP address of the computer on which you installed the Administration Center. The non_secure_port is the HTTP port and the secure_port is the HTTPS port. Attention: Use the port number that was shown in the summary panel of the installation wizard, which might be different from the port that you specified in the wizard. If you use an incorrect port, no warning messages are shown but you are not able to complete all Administration Center tasks.
Chapter 10. Installing the Administration Center

121

| | |

The default HTTP port is 16310. The default HTTPS port is 16311. If you use a different port number from the default, the secure port typically appears as the non-secure port plus 1. Look in the following file to see the port that is being used. In this file, WC_defaulthost contains the value for the HTTP port and WC_adminhost_secure contains the value for the HTTPS port. TIP_HOME\properties\TIPPortDef.properties where TIP_HOME is the home directory for the Tivoli Integrated Portal installation. The default for TIP_HOME is C:\IBM\tivoli\tipv2.

| | | | | | | |

Tips: v If you use http://workstation_name:16310/ibm/console to connect to the Administration Center, you are automatically redirected to the secure port and address. v A file named TSM_Administration_Center.htm is created in the Administration Center installation directory. Open this file in a web browser to automatically connect to the Administration Center. A desktop shortcut is also created for this file. 3. To get started, log in using the Tivoli Integrated Portal user ID and password that you created during the Administration Center installation. Save this password in a safe location because it is also needed to uninstall the Administration Center. 4. After you successfully log in, the Tivoli Integrated Portal welcome page is shown. Expand the Tivoli Storage Manager folder in the Work Items list and click Getting Started to display the Tivoli Storage Manager welcome page. This page provides instructions for using the Administration Center.

Starting and stopping the Tivoli Integrated Portal server

If you use a root user account to install the Administration Center, the IBM Tivoli Integrated Portal server starts automatically. If you use a non-root user account for the installation or if you later shut down the system, you must manually start the Tivoli Integrated Portal server. Use the Windows Services utility or the command line to start and stop Tivoli Integrated Portal servers. | | | | | | | | | | | Tip: If you connect to the Administration Center system using Terminal Services, and you do not have the optional Tivoli Common Reporting feature installed, use the Windows Services utility to start the Tivoli Integrated Portal server. If you start the server from the command line, the server stops when you log off the Terminal Services session. If the Tivoli Common Reporting feature is installed, you must use the command line to start and stop the server. To use the Windows Services utility, complete the following steps: 1. Open the utility by going to Settings > Control Panel > Administrative Tools > Services. 2. Select the following service: v Tivoli Integrated Portal - V2.1_TIPProfile_Port_port

122

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | |

where port is the port number that you entered earlier. Ensure that you have the correct port number based on the information in the wizard summary panel. The default HTTP port is 16310. The default HTTPS port is 16311. If you are using a port number other than the default, the secure port typically appears with 1 as the last number. See Verifying the Administration Center installation on page 121 for more details. When you start and stop the Tivoli Integrated Portal using the command line, the variables in the commands have these meanings: v TIP_HOME is the Tivoli Integrated Portal installation directory. The default for TIP_HOME is C:\IBM\tivoli\tipv2. v TCR_HOME is the Tivoli Common Reporting installation directory. The default for TCR_HOME is C:\IBM\tivoli\tipv2Components\ TCRComponent. v tip_admin is the administrator user ID for the Administration Center. v tip_pw is the password for the administrator. v tip_profile is the DB2 profile name for the administrator.

| | |

| | | | | | | | | | | | | | | | | | | | |

Start or stop the Tivoli Integrated Portal server from the command line by using one of the following methods. If Tivoli Common Reporting is installed: Change to the TCR_HOME\bin directory and issue one of the following commands: v To start Tivoli Common Reporting and a Tivoli Integrated Portal server, issue this command:
startTCRserver.cmd

v To stop Tivoli Common Reporting and a Tivoli Integrated Portal server, issue this command:
stopTCRserver.cmd tip_admin tip_pw

If Tivoli Common Reporting is not installed: Change to the TIP_HOME\bin directory and issue one of the following commands: v To start a Tivoli Integrated Portal server, issue this command:
startServer.bat server1

v To stop a Tivoli Integrated Portal server, issue the following command on a single line:
stopServer.bat server1 -username tip_admin -password tip_pw -profileName tip_profile

Defining Administration Center users to the Tivoli Integrated Portal

When you install the Administration Center, you must define the users to the Tivoli Integrated Portal. You can create a separate Tivoli Integrated Portal user ID for each Tivoli Storage Manager administrator, or for a group of administrators. Give each Tivoli Storage Manager administrator their own Tivoli Integrated Portal administrator ID. Creating separate Tivoli Integrated Portal administrator IDs can help you control access for administrators who manage different servers, or have different privilege

Chapter 10. Installing the Administration Center

123

classes. After logging in using this ID, they can use their Tivoli Storage Manager administrator name and password to manage connections for the servers they manage. Complete the following steps to define Administration Center users to the Tivoli Integrated Portal: In the navigation tree, expand Users and Groups. Click Manage Users. Click Create. Click Group Membership. Select Group name, then click Search. Add TSM_AdminCenter to the Current groups list. Click Close. The TSM_AdminCenter group is a shell for you to populate with users. You must manually enter the user credentials. 8. Complete the form and click Create. 1. 2. 3. 4. 5. 6. 7.

Uninstalling the Administration Center

Uninstall the Administration Center either by using one of two wizards or in silent mode. | | | | Tip: To uninstall a version 6.2 Administration Center, see the instructions at the following website: http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2. To uninstall a version 6.1 Administration Center, see the instructions at the following website: http://publib.boulder.ibm.com/infocenter/tsminfo/v6. To uninstall the current version of the Administration Center using the standard method, complete the following steps: | 1. Change to this directory: C:\IBM\tivoli\tsmac\_uninst. 2. Use one of the following methods to uninstall the Administration Center: v To use the installation wizard (GUI) to uninstall the Administration Center, double-click the .exe file or enter the following command:
"uninstall.exe"

Tip: Ensure that you have your Administration Center user name and password to uninstall the Administration Center. v To use the console to uninstall the Administration Center, enter this command:
"uninstall.exe" -i console

Tip: Ensure that you have your Administration Center user name and password to uninstall the Administration Center. v To silently uninstall the Administration Center, issue the following command. Sample response files (uninstall_response.txt) are available with the Administration Center installation driver. Use one of the sample files to run a silent installation. Ensure that you enter the full path name to the sample response file.
"uninstall.exe" -i silent -f path_name_to_response_file

3. Follow the prompts to uninstall the Administration Center. To uninstall the current version of the Administration Center using silent mode with a batch script, complete the following steps:

124

IBM Tivoli Storage Manager for Windows: Installation Guide

Tip: If you do not use a batch script, this uninstallation method immediately closes the foreground window, and runs in the background. You will not receive a return code. 1. Create a file and name it uninstall.bat. The file name must end with .bat, not .bat.txt. 2. Type this command into the uninstall.bat file and save it:
"uninstall.exe" -i silent

3. Double-click the uninstall.bat file or start it using a command prompt. 4. If you are using a command prompt, after the uninstallation is complete, issue the following command to retrieve the return code:
echo %ERRORLEVEL%

See Chapter 10, Installing and configuring the Administration Center, on page 113 for the installation steps to reinstall the Administration Center.

Chapter 10. Installing the Administration Center

125

126

IBM Tivoli Storage Manager for Windows: Installation Guide

Chapter 11. Upgrading the Administration Center to Version 6.3

To administer IBM Tivoli Storage Manager Version 6.3 and later servers, you must upgrade to the Administration Center Version 6.3. The upgrade process consists of installing the new version and completing some manual configuration tasks. If you are installing the Administration Center for the first time, see Chapter 10, Installing and configuring the Administration Center, on page 113. The IBM Tivoli Integrated Portal is a graphical user interface (GUI) framework. The Administration Center is installed into the Tivoli Integrated Portal as a plug-in. Restriction: The Administration Center Version 6.3 is only compatible with the Tivoli Integrated Portal Version 2.1. If you have earlier versions of these applications installed, you must upgrade them both. You can automatically migrate server connection information from a Version 6.2 Administration Center during the installation process. However, some manual configuration is still required after you complete the installation. Tip: If there is enough disk space, consider temporarily maintaining both the previous and current versions of the Administration Center. This coexistence strategy provides a functioning Administration Center during the upgrade and ensures that the configuration settings of the previous version remain available. To support coexistence, assign non-conflicting ports for each Administration Center instance. You can use the same port definitions and run only one instance at a time, or you can assign separate ports and run the two instances concurrently. | | | | | You can also install the Administration Center into an existing Tivoli Integrated Portal Version 2.1 instance. This option also applies to fix packs. Previous versions of the Administration Center are not automatically removed during an upgrade installation. You can manually uninstall a previous version after you complete and verify the upgrade installation. Related tasks Chapter 10, Installing and configuring the Administration Center, on page 113 Chapter 9, Upgrading Tivoli Monitoring for Tivoli Storage Manager to Version 6.3, on page 105

Copyright IBM Corp. 1993, 2011

127

Upgrading the Administration Center

To upgrade from a previous version of the Administration Center, you must install the new version and then recreate the previous Tivoli Integrated Portal or Integrated Solutions Console user accounts. In some cases, you must also recreate the previous Tivoli Storage Manager server connections. To upgrade the Administration Center, complete the following steps: 1. If you do not plan to automatically migrate a Version 6.2 Administration Center during the installation process, obtain information about the previously defined Tivoli Storage Manager server connections: v For a version 5.5 or earlier Administration Center, save the tsmservers.xml file that is located in the Administration Center installation directory. v For a Version 6.1 or 6.2 Administration Center, download the server connections file. From the navigation tree in the Administration Center interface, expand Tivoli Storage Manager and click Manage Servers > Download Connection File. Tip: For more details about the server connections file, see the online help for the Manage Servers page. 2. Collect the administrative user account information from the previous Administration Center. For more information, see Obtaining user account information in a Version 5.5 Administration Center on page 129 or Obtaining user account information in a Version 6.1 or later Administration Center on page 129. 3. Install the Version 6.3 Administration Center. Important: v If you have Tivoli Monitoring for Tivoli Storage Manager installed, the upgrade overwrites any existing reports and data source connections. | | v Extract the installation files into an empty directory. Do not extract to a directory that contains previously extracted files, or any other files. 4. Recreate the previous configuration in the new Administration Center: a. Define each Integrated Solutions Console or Tivoli Integrated Portal user account. For more information, see Defining administrative user accounts to the Version 6.3 Administration Center on page 130. b. Edit the tsmservers.xml server connections file to specify the TIPRealm domain for each iscuser definition:
<iscuser id="TIPRealm/userID" />

| | |

c. Upload the server connections file. From the navigation tree in the Administration Center interface, expand Tivoli Storage Manager and click Manage Servers > Upload Connection File. When administrators log on to the Tivoli Integrated Portal, they are prompted to provide a Tivoli Storage Manager administrative user ID and password for the servers that they manage. Tip: If administrators manage a large number of Tivoli Storage Manager servers, they can edit the tsmservers.xml file and add the Tivoli Storage Manager administrative credentials.

128

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | |

Adding administrative credentials to the tsmservers.xml file prevents an administrator from having to provide the credentials after logging on to the Tivoli Integrated Portal, but including the passwords in the file can create a security exposure. 5. Optional: Uninstall the previous version of the Administration Center. To uninstall a Version 6.2 Administration Center, see the instructions at the following website: http://publib.boulder.ibm.com/infocenter/tsminfo/v6r2. To uninstall a Version 6.1 Administration Center, see the instructions at the following website: http://publib.boulder.ibm.com/infocenter/tsminfo/v6.

Obtaining user account information in a Version 6.1 or later Administration Center

To access the Version 6.3 Administration Center, a Tivoli Integrated Portal user account is required. Tivoli Integrated Portal or Integrated Solutions Console user accounts that are defined in a previous version of the Administration Center must be manually recreated after upgrading to the latest version. Complete the following steps to obtain information about the defined user IDs: 1. In the navigation tree, expand Users and Groups and click Manage Users. 2. In the "Search by" list, select User ID. 3. In the "Search for" list, enter an asterisk (*). 4. Click Search. The table shows all the defined user IDs. Capture this information for later use. 5. Determine the password for each of these user IDs.

Obtaining user account information in a Version 5.5 Administration Center

To access the Version 6.3 Administration Center, a Tivoli Integrated Portal user account is required. Integrated Solutions Console user accounts that are defined in a previous version of the Administration Center must be manually recreated after upgrading to the latest version. Complete the following steps to obtain information about the defined user IDs: 1. In the navigation tree, expand Console Settings and click User and Group Management. 2. In the "Search" list, select Users. 3. In the "Search by" list, select uid. 4. In the "Search" field, enter an asterisk (*). 5. Click Search. The table shows all the defined user IDs. Capture this information for later use. 6. Determine the password for each of these user IDs.

Chapter 11. Upgrading the Administration Center to Version 6.3

129

Defining administrative user accounts to the Version 6.3 Administration Center

When you upgrade the Administration Center to Version 6.3, you must define the previous user accounts to the IBM Tivoli Integrated Portal. Consider creating a separate Tivoli Integrated Portal user account for each Tivoli Storage Manager administrator. The administrators can then log on and use their Tivoli Storage Manager administrative credentials to create connections for the servers that they manage. Complete the following steps to define the administrative user accounts: 1. In the navigation tree, expand Users and Groups. 2. Click Manage Users. 3. Click Create. 4. Click Group Membership. 5. Select Group name, then click Search. 6. Add TSM_AdminCenter to the Current groups list. 7. Click Close. The TSM_AdminCenter group is a shell for you to populate with users. You must manually enter the user credentials. 8. Complete the form and click Create. | | | | | | | | | | | | | | | | | | | | | | | | | |

Server connections to the Administration Center

To use the Administration Center, administrators must create connections to one or more Tivoli Storage Manager servers. You can download a file that contains information about existing server connections from the Administration Center. You can then upload the file to quickly redefine server connections after an upgrade installation. The Administration Center stores Tivoli Storage Manager server connection information in a file named tsmservers.xml. This file is located in the Administration Center installation directory. When you install the Version 6.3 Administration Center you can choose to automatically migrate the configuration of an existing Version 6.2 Administration Center: v If you select this option, the tsmservers.xml file is copied from the previous installation. v If you do not select this option, or if you are upgrading an earlier version of the Administration Center, you can manually upload the connections file after you complete the installation. By default, the tsmservers.xml file does not include Tivoli Storage Manager administrative user IDs and passwords for each server connection. Server connections that do not include these administrative credentials are treated as incomplete connections, which cannot be used until the credentials are provided. After you upload the tsmservers.xml file, you can handle the incomplete server connections in two ways: v Leave the connections in the incomplete state. When administrators log on to the Tivoli Integrated Portal, they are prompted to provide the administrative credentials for the servers that they manage.

130

IBM Tivoli Storage Manager for Windows: Installation Guide

| | | | | | |

v Use the Change Password action in the Manage Servers table to specify the administrative credentials for one or more server connections. Tip: You can also edit the tsmservers.xml file directly and add the administrative credentials, if this is permitted by the security policies of your company. For more information, see the Administration Center online help for the Manage Servers page.

Chapter 11. Upgrading the Administration Center to Version 6.3

131

132

IBM Tivoli Storage Manager for Windows: Installation Guide

Part 4. Appendixes

Copyright IBM Corp. 1993, 2011

133

134

IBM Tivoli Storage Manager for Windows: Installation Guide

Appendix A. Installation log files

If you experience errors during installation, these errors are recorded in several log files that are distributed in various locations. Table 26 shows the files that are created when you install or uninstall Tivoli Storage Manager and recommends which files to check when looking for information that might help you troubleshoot problems:
Table 26. Contents of the log.zip file File Name The log.txt file contains information about the following Environment Checks: v Platform v Version v Architecture v Prerequisites Description Contains general information about an installation. Review this log file when any installation failures occur. Location This file is located in: the InstallAnywhere location that you specified. The InstallAnywhere exit codes show you the state of the installation. The codes are in the log.txt file and can also be called by command. You can retrieve the exit codes after the installation is completed. The exit codes are for both the Tivoli Storage Manager installation and upgrade wizards and the Tivoli Monitoring for Tivoli Storage Manager installation wizard. To use the command line, issue the following command: echo %ERRORLEVEL% See Table 27 on page 136 for all the InstallAnywhere exit codes. logs.zip This file is located in: The Tivoli Storage Manager server logs.zip file contains the the InstallAnywhere location that you specified. following subdirectories: v coi: contains installation log files v de: contains deployment engine log files v ia: contains the log.txt file and native installer log files, for example, tsm_server.log, tsm_license.log, and db2_inst.log DE_Install.log Contains information about the Deployment Engine (DE) installation. Review this log file if the DE installation fails. db2setup.log db2_uninst.log Contains information about the DB2 installation Contains information about the DB2 uninstallation coi\plan\logs coi\plan\logs de\root

| | | | | | | |

Copyright IBM Corp. 1993, 2011

135

Table 26. Contents of the log.zip file (continued) File Name DB2.log Description Location

Contains information about the coi\plan\install or coi\plan\uninstall installation and uninstallation commands. Return codes can be retrieved from this log file, but not for DB2. If installation or uninstallation completed, the executePackage or remove-package scripts for a component are available. Installation log files. Review these log files if the Administration Center installation or uninstallation fails. For log information about additional Administration Center components, see the Problem Determination Guide. v coi\plan\install\logs v coi\plan\install\MachinePlan_host_name\ 00001_eWAS v coi\plan\install\MachinePlan_host_name\ 00002_TIP v coi\plan\install\MachinePlan_host_name\ 00003_TSM_AdminCenter or v install_root\_uninst\plan\install\ MachinePlan_host_name\00001_eWAS v install_root\_uninst\plan\install\ MachinePlan_host_name\00002_TIP

Administration Center installation log files

v install_root\_uninst\plan\install\ MachinePlan_host_name\00003_TSM_AdminCenter

For information about exit codes for the Tivoli Storage Manager server, Administration Center, or Tivoli Monitoring for Tivoli Storage Manager wizards, see Table 27. Tip: Some of the exit codes for a silent installation might be different than the exit codes for a GUI or console installation. For example, an exit code of 1 for a silent installation means that the installation completed successfully without warnings or errors. However, for a GUI or console installation, an exit code of 1 means that the installation completed, but that one or more of the actions from the installation sequence caused a warning or non-fatal error. See the Problem Determination Guide for the latest information.
Table 27. InstallAnywhere exit codes Code 0 1 -1 1000 1001 2000 2001 2002 2003 Description Success: The installation completed successfully without any warnings or errors. The installation completed successfully, but one or more of the actions from the installation sequence caused a warning or a non-fatal error. One or more of the actions from the installation sequence caused an unrecoverable error. The installation was canceled by the user. The installation includes an invalid command-line option. Unhandled error. The installation failed the authorization check, might indicate an expired version. The installation failed a rules check. A rule placed on the installer itself failed. An unresolved dependency in silent mode caused the installer to exit.

136

IBM Tivoli Storage Manager for Windows: Installation Guide

Table 27. InstallAnywhere exit codes (continued) Code 2004 2005 2006 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 4000 4001 Description The installation failed because not enough disk space was detected during the execution of the Install action. The installation failed while trying to install on a Windows 64-bit system, but installation did not include support for Windows 64-bit systems. The installation failed because it was launched in a UI mode that is not supported by this installer. Unhandled error specific to a launcher. The installation failed due to an error specific to the lax.main.class property. The installation failed due to an error specific to the lax.main.method property. The installation was unable to access the method specified in the lax.main.method property. The installation failed due to an exception error caused by the lax.main.method property. The installation failed because no value was assigned to the lax.application.name property. The installation was unable to access the value assigned to the lax.nl.java.launcher.main.class property. The installation failed due to an error specific to the lax.nl.java.launcher.main.class property. The installation failed due to an error specific to the lax.nl.java.launcher.main.method property. The installation was unable to access the method specified in the lax.nl.launcher.java.main.method property. A component to start Java could not be found at the directory specified by the java.home system property. An incorrect path to the installer jar caused the relauncher to launch incorrectly.

Appendix A. Installation log files

137

138

IBM Tivoli Storage Manager for Windows: Installation Guide

Appendix B. Services associated with the Tivoli Storage Manager server

When you start the Tivoli Storage Manager server as a service, other services automatically start. These services are associated with the database manager, DB2. The following services are associated with the Tivoli Storage Manager server.
Service name TSM Server_instance Purpose The service for the Tivoli Storage Manager server instance that is named Server_instance. For example: TSM Server1 Comments Set the start and stop options for this service to start and stop the server instance automatically. Each server instance runs as a separate service. This service is automatically started when the service for the Tivoli Storage Manager server instance is started. The DB2 service is not stopped automatically when you stop the service for the server. The system has one of these services for each server-instance service that is started on the system. DB2 Governor (DB2TSM1) A DB2 service that is created at installation time, and is required for all server instances. A DB2 service that is created at installation time, and is required for all server instances. A DB2 service that is created at installation time, and is required for all server instances. A DB2 service that is created at installation time, and is required for all server instances. Do not change the options for this service. Do not change the options for this service. Do not change the options for this service. Do not change the options for this service.

| | | | | | | | |

DB2 - DB2TSM1 - SERVER_INSTANCE

The DB2 service for the server instance that is named Server_instance. For example: DB2 - DB2TSM1 SERVER1

DB2 License Server (DB2TSM1)

DB2 Management Server (DB2TSM1)

DB2 Remote Command Server (DB2TSM1)

| | | | | | |

Servers upgraded from V6.1.0 or V6.1.1: On a system that is running the Tivoli Storage Manager V6.1.0 or V6.1.1 server program, an additional service named DB2 - DB2TSM1 - DB2TSM-0 is displayed in the list of services. When the V6.1.0 or V6.1.1 server program is upgraded to a later version, that service is renamed to DB2 DB2TSM1 - DB2TSM. This service does not affect the operation of the Tivoli Storage Manager server instances that you configure. DB2TSM is a nonfunctional DB2 instance.

Copyright IBM Corp. 1993, 2011

139

140

IBM Tivoli Storage Manager for Windows: Installation Guide

Appendix C. Accessibility features for the Tivoli Storage Manager product family
Accessibility features help users who have a disability, such as restricted mobility or limited vision, to use information technology products successfully.

Accessibility features
The following list includes the major accessibility features in the Tivoli Storage Manager family of products: v Keyboard-only operation v Interfaces that are commonly used by screen readers v Keys that are discernible by touch but do not activate just by touching them v Industry-standard devices for ports and connectors v The attachment of alternative input and output devices The Tivoli Storage Manager Information Center, and its related publications, are accessibility-enabled. The accessibility features of the information center are described at http://publib.boulder.ibm.com/infocenter/tsminfo/v6r3/topic/ com.ibm.help.ic.doc/iehs36_accessibility.html.

Keyboard navigation
On Windows, the Tivoli Storage Manager product family follows Microsoft conventions for all keyboard navigation and access. Drag and Drop support is managed using the Microsoft Windows Accessibility option known as MouseKeys. For more information about MouseKeys and other Windows accessibility options, please refer to the Windows online help (keyword: MouseKeys). On other operating systems, these products follow the operating-system conventions for keyboard navigation and access.

Vendor software
The Tivoli Storage Manager product family includes certain vendor software that is not covered under the IBM license agreement. IBM makes no representation about the accessibility features of these products. Contact the vendor for the accessibility information about its products.

IBM and accessibility

See the IBM Human Ability and Accessibility Center for more information about the commitment that IBM has to accessibility.

Copyright IBM Corp. 1993, 2011

141

142

IBM Tivoli Storage Manager for Windows: Installation Guide

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan Ltd 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
Copyright IBM Corp. 1993, 2011

143

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who want to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. This information is for planning purposes only. The information herein is subject to change before the products described become available. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample

144

IBM Tivoli Storage Manager for Windows: Installation Guide

programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows: (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. If you are viewing this information in softcopy, the photographs and color illustrations may not appear.

Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml. Intel, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.

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

Notices

145

146

IBM Tivoli Storage Manager for Windows: Installation Guide

Glossary
A glossary is available with terms and definitions for the IBM Tivoli Storage Manager server and related products. The glossary is located in the Tivoli Storage Manager information center: http://publib.boulder.ibm.com/ infocenter/tsminfo/v6r3

Copyright IBM Corp. 1993, 2011

147

148

IBM Tivoli Storage Manager for Windows: Installation Guide

Index A
accessibility features 141 activating server 46 activating server options 40 active log space requirements 10 Administration Center backward compatibility 127 configuring server 33, 35 console installation wizard 118 default port 117, 118 DISPLAY 117, 118 installation 117, 118 installation log 117, 118 installation wizard 117 installing 117, 118 LD_LIBRARY_PATH_64 117, 118 overview 113 port 117, 118 prerequisite checker 6, 114 secure port 117, 118 SELINUX 117, 118 server connection to 130 system requirements 114 Tivoli Storage Manager installation uninstalling 121, 124 upgrading 127, 128 verifying 121 verifying prerequisites 6, 114 work sheet 115 Administration Centerreporting 108 administrative commands HALT 48 REGISTER LICENSE 48 agent Tivoli Monitoring for Tivoli Storage installing 98 Tivoli Monitoring for Tivoli Storage existing server 100 agents Tivoli Monitoring for Tivoli Storage installing 99 API 38, 44 API configuration 38, 44 archive failover log space description 21 archive log space requirements 10 archive log directory 34

C
capacity planning database space requirements estimates based on number of files 7 estimates based storage pool capacity 10 starting size 7 recovery log space requirements active and archive logs 10 active log mirror 21 Tivoli Monitoring for Tivoli Storage Manager 90 client nodes reverting to previous server version data affected 73 client options for shared memory communications 42 clustered environment applying a fix pack to a V6.x server 54 upgrading from V6.1 to V6.3 68 upgrading from V6.2 to V6.3 69 commands administrative, SET DBRECOVERY 48 DSMSERV FORMAT 43 commands, administrative HALT 48 REGISTER LICENSE 48 communication methods Named Pipes 41 setting 40 Shared Memory 42 SNMP 42 TCP/IP 40 components installable v configuring 33, 35, 39 communication protocols 40 data source 108 data source after upgrade 128 configuring Tivoli Storage Manager server minimal 37 configuring, manually 33, 35, 39 configuring, server instance 35 configuring, wizard 33, 35, 36 console installation wizard 27, 63 Console language support 31 create server instance 33, 35 creating and configuring the agent instance 95 Credential Vault 127 custom reporting 102 customer support contact xiii

121

Manager, Manager, installing on

Manager,

B
BACKUP DB command 38, 44 backup-archive client installable package vi backups database 48 batch script 31, 67

D
data deduplication effects when reverting to previous server version data source 108 database backups 48 error logs 135 installing 43 73

Copyright IBM Corp. 1993, 2011

149

database (continued) name 23 database directories 34 database manager 38, 44 database manager (DB2TSM1) 139 DB2 installation logs 135 db2icrt command 39 Deployment Engine backup 57, 60 device driver, Tivoli Storage Manager directories naming for server 23 directories, instance 34 disability 141 disk space 4 DISPLAY variable 27, 62, 63 DSMSERV FORMAT command 43 dsmserv.v6lock 48

vi

E
education see Tivoli technical training x enabling client/server communications error logs DB2 135 installation 135 expiration server option 46 40

F
first steps 33 fix packs 53 fixes 25, 116 fixes, obtaining xii, xiii FORMAT, DSMSERV 43

InstallAnywhere exit codes 135 installation work sheet for Tivoli Monitoring for Tivoli Storage Manager 91 installation log 26, 27, 62, 63 installation wizard 26, 62 installing Administration Center 116 BIRT 102 database 43 device support 25 fix packs 53 graphical user interface using 26 minimum requirements for 4 prerequisite checker 6, 93, 114 recovery log 43 server 3, 25 Tivoli Monitoring for Tivoli Storage Manager 84, 93 Tivoli Storage Manager reporting and monitoring 85 Tivoli Storage Manager server 27 verifying prerequisites 6, 93, 114 what to know before 3 work sheet for the Administration Center 115 installing agents on existing IBM Tivoli Monitoring servers 101 installing overview 83 installing the Administration Center silently 118 installing the Tivoli Storage Manager Administration Center 118 installing the Tivoli Storage Manager server 28 silently 28 instance directories 34 instance user ID 23 Integrated Solutions Console users 129 interim fix 53 Internet, searching for problem resolution xi, xii

G
group 34 GSKit removing Version 7 Version 7 71 Version 8 71 71

K
keyboard 141 KILL command 48 knowledge bases, searching xi

H
HALT command 48 halting the server 48 hardware requirements Administration Center 114 Tivoli Monitoring for Tivoli Storage Manager Tivoli Storage Manager 4 home directory 39

L
LANGUAGE option 31, 32 language support 32 languages, set 32 LD_LIBRARY_PATH_64 variable 27, 62, 63 LDAP federated repositories authentication 119 license, Tivoli Storage Manager 48 licenses installable package vi Linux installation SELinux AVC denial 135 log files installation 135

88

I
IBM Publications Center viii IBM Support Assistant xii IBM Tivoli Monitoring installing an agent on an existing server installable components vi 100

150

IBM Tivoli Storage Manager for Windows: Installation Guide

M
maintenance updates 53 memory requirements 4, 88 Microsoft Management Console starting server 47 monitoring logs 50 multiple servers upgrading multiple servers 49

Q
quick configuration 37

R
recovery log archive failover log space 21 installing 43 REGISTER LICENSE command 48 Remote Execution Protocol 37, 67 removing the Tivoli Storage Manager server 77 Reporting and monitoring feature prerequisite checker 6, 114 verifying prerequisites 6, 114 reports installing Tivoli Monitoring for Tivoli Storage Manager upgrading 105 upgrading Tivoli Monitoring 107 requirements for installation 4 responses saving 26, 27, 62, 63 reverting to previous server version 73 REXEC 37, 67

N
Named Pipes 41 names, best practices database name 23 directories for server instance user ID 23 server instance 23 server name 23 23

93

O
options communications 40 starting the server 46 options, client SSLTCPADMINPORT 41 SSLTCPPORT 41 TCPADMINPORT 41 TCPPORT 41 TCPWINDOWSIZE 41

S
SELINUX 26, 27, 62, 63 server after upgrade reverting to previous server version 73 before upgrade importance of preparation steps 73 naming best practices 23 starting using Windows services 47 stopping 48 server connections in the Administration Center server database reorganization options 45 server instance 35, 39 server instance, creating 39 server instances naming 23 naming best practices 23 server license 48 server, Tivoli Storage Manager activating 46 halting 48 options 40 setting up 46 starting 46 services on Windows systems database manager (DB2TSM1) 139 DB2 139 server 139 SET DBRECOVERY 48 setting server options 40 shared memory client options 42 shared memory communications method 42 silent installation Administration Center 118 batch file 31, 67 Tivoli Storage Manager 28 silent upgrade Tivoli Storage Manager 64 SNMP communication method 42

P
Passport Advantage xiii, 25 performance ulimits, setting for optimal performance 46 planning installing Tivoli Monitoring for Tivoli Storage Manager installing Tivoli Storage Manager reporting and monitoring 85 upgrading Tivoli Monitoring for Tivoli Storage Manager 105 planning, capacity database space requirements estimates based on number of files 7 estimates based storage pool capacity 10 starting size 7 recovery log space requirements active log mirror 21 recovery log space requirementsv 10 prerequisite checker installation 6, 93, 114 running 6, 93, 114 problem determination describing problem for IBM Software Support xiv determining business impact for IBM Software Support xiv submitting a problem to IBM Software xiv publications download viii order viii search viii Tivoli Storage Manager viii

130

84

Index

151

software requirements Administration Center 114 Tivoli Monitoring for Tivoli Storage Manager 88 Tivoli Storage Manager 4 software support describing problem for IBM Software Support xiv determining business impact for IBM Software Support xiv submitting a problem xiv Software Support contact xiii SSLTCPADMINPORT option 41 SSLTCPPORT option 41 starting server 46 stopping server 48 storage pools reverting to previous server version 73 summary of amendments Version 6.3 xv support contract xiii support information x support subscription xiii

U
U.S. English 32 ulimits 46 uninstalling 77, 78 Administration Center 124 Tivoli Monitoring for Tivoli Storage Manager 102 Tivoli Monitoring for Tivoli Storage Manager on Windows 102 Tivoli Storage Manager 77 uninstalling and reinstalling 78 upgrade scenarios Upgrading Tivoli Monitoring for Tivoli Storage Manager 105 upgrading 63 installation wizard using 62 Tivoli Monitoring for Tivoli Storage Manager 107 V6.1 to V6.3 in a clustered environment 68 V6.2 to V6.3 in a clustered environment 69 upgrading the Tivoli Storage Manager server 64 silently 64 upgrading, from 5.5 57 upgrading, from 6.1 57 upgrading, from 6.2 57, 60 upgrading, to Version 6.3 57, 60 User Account Control 37, 67 user ID 34

T
TCP/IP setting options 40 Version 4 40 Version 6 40 TCPNODELAY option 41 TCPPORT option 41 TCPWINDOWSIZE option 41 technical changes xv Tivoli Integrated Portal 108, 121 backward compatibility 127 console help server start 122 stop 122 console server start 122 stop 122 overview 113 users 123, 129, 130 Tivoli Monitoring for Tivoli Storage Manager prerequisite checker 93 verifying prerequisites 93 what to configure after installing 95 Tivoli Storage Manager installation 26 server changes xv upgrade 63 upgrading 62 Version 6.3 xv Tivoli Storage Manager device driver, installable package Tivoli Storage Manager fix packs 53 Tivoli Storage Manager server prerequisite checker 6, 114 verifying prerequisites 6, 114 Tivoli Storage Manager support site 25 Tivoli Storage Manager, setting up 46 Tivoli technical training x training, Tivoli technical x translation features 31 translations 31

W
Windows creating and configuring the Tivoli Monitoring for Tivoli Storage Manager agent instance 96 system requirements 4 uninstalling Tivoli Monitoring for Tivoli Storage Manager 102 Windows clustered environment applying a fix pack to a V6.x server 54 upgrading from V6.1 to V6.3 68 upgrading from V6.2 to V6.3 69 Windows Server 2008 37, 67 Windows service 34 creating 43 Windows services Tivoli Storage Manager server 139 Windows Services Control Manager starting server 47 work sheet installing the Administration Center 115 server space planning 6

vi

152

IBM Tivoli Storage Manager for Windows: Installation Guide

Product Number: 5608-E01, 5608-E02, 5608-E03, 5608-E07

Printed in USA

GC23-9785-03