Installation and User s Guide

Tivoli Data Protection for Informix Installation and User s Guide Version3Release7 SH26-4095-00

Tivoli Data Protection for Informix Installation and User s Guide Version3Release7 SH26-4095-00

Note Before using this information and the product it supports, read the general information under Notices on page v. First Edition (September 1999) This edition applies to version 3, release 7 of Tivoli Data Protection for Informix, 5697 DPI. This edition also applies to any subsequent releases until otherwise indicated in new editions or technical newsletters. Make sure that you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office that serves your locality. IBM welcomes your comments. You can send your comments to the following address: International Business Machines Corporation RCF Processing Department M86/050 5600 Cottle Road San Jose, CA 95193-0001 U.S.A. You can send us comments about this book electronically: v Internet: starpubs@us.ibm.com v Fax (US): 1-800-426-6209 When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1999. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Notices.......................... v Trademarks........................ vi About This Book...................... ix Chapter 1. Introducing Tivoli Data Protection for Informix........ 1 What Informix Databases are Supported?.............. 1 What Platforms are Supported?.................. 1 Chapter 2. Installing TDP for Informix on UNIX............ 3 Installation Requirements.................... 3 Hardware Requirements................... 3 Software Requirements................... 4 Installation Instructions for AIX.................. 4 Installation Instructions for Sun Solaris............... 5 Defining the Environment Variables................ 6 Editing the Client Options Files.................. 7 Editing the Client System Options File............... 7 Assigning a Management Class for a Backup............ 8 Registering TDP for Informix with the Tivoli Storage Manager Server..... 9 Initializing the Password.................... 9 Uninstalling TDP for Informix................... 10 Chapter 3. Configuring TDP for Informix.............. 11 Step 1: Editing the Configuration File................ 11 For Informix IDS 7..................... 11 Step 2: Ensuring ON-Bar Compatibility............... 11 Chapter 4. Problem Determination................ 13 Index.......................... 15 Copyright IBM Corp. 1999 iii

iv Tivoli Data Protection for Informix: Installation and User s 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 give 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 (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, 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. 1999 v

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 wish 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 Information Enabling Requests Dept. M13 5600 Cottle Road San Jose CA 95193-0001 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 document 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. 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. If you are viewing this information in softcopy, the photographs and color illustrations may not appear. Trademarks The following terms are trademarks of the IBM Corporation in the United States, or other countries, or both: AIX IBM Informix is a registered trademark of the Informix Software, Inc. Sun, Solaris, Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Tivoli and Tivoli ADSM are trademarks of Tivoli Systems Inc. in the United States, or other countries, or both. vi Tivoli Data Protection for Informix: Installation and User s Guide

UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. Other company, product, and service names may be trademarks or service marks of others. Notices vii

viii Tivoli Data Protection for Informix: Installation and User s Guide

About This Book This publication is for the system administrator, database administrator, system programmer, or user who is responsible for installing, starting, or using the Tivoli Data Protection for Informix. This publication assumes that you understand the general concepts of the operating systems, networking capabilities, internet capabilities, and databases for your enterprise. This publication provides information to help you install TDP for Informix. The following publications provide additional information. Table 1. Related Books Title Tivoli Storage Manager Using the Application Program Interface Tivoli Storage Manager Installing the Clients Tivoli Storage Manager for UNIX Using the Backup-Archive Clients Order Number SH26-4107 SH26-4102 SH26-4105 The following table indicates which Web site to access for additional information. When you enter the address, do not enter blank spaces in the address. Table 2. Product Web Sites Product Tivoli Storage Management Informix Web Site http://www.tivoli.com/tsm http://www.informix.com Copyright IBM Corp. 1999 ix

x Tivoli Data Protection for Informix: Installation and User s Guide

Chapter 1. Introducing Tivoli Data Protection for Informix Tivoli Data Protection for Informix (TDP for Informix) contains a library which implements the Open Group Backup Services API (XBSA) functions. It uses the Tivoli Storage Manager base application program interface (API) library. The TDP for Informix library allows you to back up and restore Informix server databases and logical logs. Backups are stored on the Tivoli Storage Manager server. TDP for Informix helps protect and manage Informix server data by allowing you to back up and restore data by using the Informix ON-Bar utility. TDP for Informix communicates with the Informix ON-Bar utility for backup and restore services. ON-Bar provides: v Parallel backup and restore v Automatic backup of logical logs For more information on the Informix Server, see the following URL: http://www.informix.com/informix/products/ ON-Bar uses the Open Group Backup Services API (XBSA) to communicate with the Tivoli Storage Manager. For more information on the Open Group Backup Services API, see the following URL: http://www.opengroup.org/ What Informix Databases are Supported? The following Informix databases are supported: v Informix 7 Informix Dynamic Server v Informix 8 Extended Parallel option (AIX only) v Informix 9 Universal Data option What Platforms are Supported? TDP for Informix supports the following platforms: v AIX (IBM) v Solaris (Sun) Copyright IBM Corp. 1999 1

2 Tivoli Data Protection for Informix: Installation and User s Guide

Chapter 2. Installing TDP for Informix on UNIX This section provides information on the client environment that must exist before you install the Tivoli Data Protection for Informix. This also provides instructions for installing TDP for Informix on UNIX. For installation instructions, see the README.INF file for your platform and the following: v For Solaris, see Installation Instructions for Sun Solaris on page 5. v For AIX, see Installation Instructions for AIX on page 4. Installation Requirements Hardware Requirements This section contains hardware and software requirements for the installation of TDP for Informix. The following hardware is required: For Solaris: v A SPARCstation or compatible workstation v Disk space: 10 MB v Memory: 32 MB For AIX: v RISC System/6000 v Disk space: 10 MB v Memory: 32 MB Copyright IBM Corp. 1999 3

Software Requirements Note: For the most current operating systems that are supported, see the README.INF file on the CD-ROM. The following operating systems are supported: v Solaris 2.6 v AIX 4.3 The following Informix servers are supported: v Informix 7 Informix Dynamic Server (IDS) v Informix 8 Extended Parallel option (AIX only) v Informix 9 Universal Data Option (UDO) Installation Instructions for AIX Note: Before installing TDP for Informix, review the README.INF file for the most current installation information. These instructions step you through the installation of TDP for Informix and assume that AIX version 4.3 is the operating system. The default installation paths for AIX are as follows: v TDP for Informix in /usr/tivoli/tsm/client/informix/bin v Base TSM API in /usr/tivoli/tsm/client/api/bin The following packages are available on the installation CD-ROM: tivoli.tsm.client.informix.aix43.32bit Installs TDP for Informix. tivoli.tsm.client.api.aix43.32bit Installs the Tivoli Storage Manager base API. The following steps show a sample installation that uses smitty: 1. Log in as the root user. 2. Insert the TDP for Informix CD-ROM into the CD-ROM reader. 3. From the AIX command line, type smitty install and press Enter. 4. Select Install and Update Software and press Enter. 5. Select Install and Update from ALL Available Software and press Enter. 6. At the INPUT device/directory for software prompt, press the F4 key and select the CD-ROM device that contains the installation CD-ROM, and press Enter. 7. At the SOFTWARE to Install prompt, press the F4 key and select the filesets you want to install and press Enter. 8. Select any options and press Enter to begin the installation. 4 Tivoli Data Protection for Informix: Installation and User s Guide

9. Define the environment variables. See Defining the Environment Variables on page 6. 10. Edit the client options files. See Editing the Client Options Files on page 7. 11. Register your workstation with the server. See Registering TDP for Informix with the Tivoli Storage Manager Server on page 9. 12. Initialize the password. See Initializing the Password on page 9. Installation Instructions for Sun Solaris Note: Before installing TDP for Informix, review the README.INF file for the most current installation information. The default installation paths for Solaris are as follows: v TDPI in /opt/tivoli/tsm/client/informix/bin v Base TSM API in /opt/tivoli/tsm/client/api/bin The following packages are available on the installation CD-ROM: TDPinfmx Installs TDP for Informix. TIVsmCapi Installs the Tivoli Storage Manager base API. Follow the steps below to install the Tivoli Storage Manager base API and TDP for Informix. Replace the word cdrom with the file system of the CD-ROM drive on your system. 1. Log in as the root user. 2. Insert the CD-ROM that contains the TDP for Informix package into the CD-ROM drive and mount it to /cdrom. 3. Enter the following command to install the Tivoli Storage Manager base API: pkgadd -d /cdrom/tsmcli/solaris TIVsmCapi (this is uncompressed) 4. Enter the following command to install TDP for Informix: pkgadd -d /cdrom/tsmcli/solaris TDPinfmx (this is uncompressed) 5. Define the environment variables. See Defining the Environment Variables on page 6. 6. Edit the client options files. See Editing the Client Options Files on page 7. 7. Register your workstation with the server. See Registering TDP for Informix with the Tivoli Storage Manager Server on page 9. 8. Initialize the password. See Initializing the Password on page 9. Chapter 2. Installing TDP for Informix on UNIX 5

Defining the Environment Variables The following environment variables are used to point to files that TDP for Informix uses: DSMI_CONFIG The fully qualified name for the client user option file (dsm.opt). DSMI_DIR Points to the Tivoli Storage Manager API installed path. This environment variable needs to be defined only if the Tivoli Storage Manager API is installed under a different path from the default path. DSMI_INF_DIR Points to the Tivoli Storage Manager for Informix install path. This environment variable needs to be defined only if the Tivoli Storage Manager for Informix is installed under a different path from the default path. DSMI_LOG Points to the directory that contains the API error log file (dsierror.log) file. For the error log file, create a directory for the error log to be created in, then let the DSMI_LOG environment variable point to that directory. The following example shows how to set up these environment variables for Solaris: export DSMI_DIR=/opt/tivoli/tsm/client/api/bin export DSMI_LOG=/home/user_a/logdir export DSMI_INF_DIR=/opt/tivoli/tsm/client/informix/bin export DSMI_CONFIG=/opt/tivoli/tsm/client/api/bin/dsm.opt The following example shows how to set up these environment variables for AIX: export DSMI_DIR=/usr/tivoli/tsm/client/api/bin export DSMI_LOG=/home/user_a/logdir export DSMI_INF_DIR=/usr/tivoli/tsm/client/informix/bin export DSMI_CONFIG=/usr/tivoli/tsm/client/api/bin/dsm.opt You can add these environment variable statements to the user s.profile file. 6 Tivoli Data Protection for Informix: Installation and User s Guide

Editing the Client Options Files TDP for Informix and the Tivoli Storage Manager Server communicate using the Tivoli Storage Manager API. The communications protocol and option parameters are specified in the dsm.opt and dsm.sys options files. For additional information on specifying the communication method, see Installing the Clients. During the initial installation and set up of Tivoli Storage Manager on your workstation, you are provided with a sample client system options file that is called dsm.sys.smp. The dsm.sys.smp file contains just the communication options, and a sample include-exclude list. These basic options are the ones you need to get started quickly. Tivoli Storage Manager also provides a sample client user options file (dsm.opt.smp) to help you get started quickly. The client system options file resides in your Tivoli Storage Manager API installation directory. The sample options files that are distributed with the Tivoli Storage Manager API can be used for TDP for Informix. Editing the Client System Options File Tivoli Storage Manager uses the following options in the client system options file (dsm.sys): v SERVERNAME option (to identify the Tivoli Storage Manager server) v COMMMETHOD option (to identify the communication method) v PASSWORDACCESS option (specify GENERATE to automatically generate the TSM password) For other options you can specify in dsm.sys, see Tivoli Storage Manager Installing the Clients. The root user should edit the dsm.sys file. It must refer to the correct Tivoli Storage Manager server and communication method. Chapter 2. Installing TDP for Informix on UNIX 7

Assigning a Management Class for a Backup When you back up a database, the default management class for your node is used. You can override the default value with a different value that is specified in the include option. This option is placed in the include-exclude options file. The file name of the include-exclude options file is placed in the client system s options file. For more information, see Installing the Clients. There are object naming conventions for the ON-Bar files. For a database backup, use the following naming convention: /dbservername/dbservername/dbspacename/level For a log backup, use the following naming convention: /dbservername/dbservername/server_number/unique_logid For a database back up, an example of the include statement is as follows: Include /dbservera/dbservera/dbspacea/* InformixDbMgmt For a logical log back up, an example of the include statement is as follows: Include /dbservera/dbservera/55/* InformixLogMgmt 8 Tivoli Data Protection for Informix: Installation and User s Guide

Registering TDP for Informix with the Tivoli Storage Manager Server Before backing up to and recovering from a Tivoli Storage Manager Server, you must have a Tivoli Storage Manager registered node name and a password. The process of setting up a node name and password is called registration. Once the TDP for Informix node is registered with a Tivoli Storage Manager Server, you can begin using the TDP for Informix to back up and restore your Informix databases and logical logs. If your workstation has a node name assigned to the Tivoli Storage Manager backup-archive client, we recommend that you use a different node name for TDP for Informix. For information about performing the registration process, see Installing the Clients. Initializing the Password Note: The root user must run the tdpipswd program before using TDP for Informix. Follow the steps below to initialize the password: 1. Start the tdpipswd program. This program is located in the directory pointed to by the DSMI_INF_DIR environment variable. This program sets up a connection with the server that you specified in the dsm.opt file. The following screen displays: Tivoli Data Protection for Informix Backup Password file Initialization program >> this must be run by the ROOT user if updating the value << 2. You can keep your current password or enter a new password. a. To keep your current password, press Enter without a value when you see the Enter your new password prompt. The following message is displayed: Your password has been accepted. b. To enter a new password, enter the new password when you see the Enter your new password prompt. Enter your new password again when you see the Enter your new password again prompt. The following message is displayed: Your new password has been accepted. Chapter 2. Installing TDP for Informix on UNIX 9

Uninstalling TDP for Informix For AIX: To uninstall TDP for Informix, follow these steps. 1. Log in as the root user. 2. From the AIX command line, enter the following: smitty remove 3. The following prompt displays: SOFTWARE name [] PREVIEW only? (remove operation will NOT occur) yes REMOVE dependent software? no EXTEND file systems if space needed? no Enter the software name. If you select no for PREVIEW, a prompt screen displays. ARE YOU SURE? Continuing may delete information you may want to keep. This is your last chance to stop before continuing. Press Enter to continue. Press Cancel to return to the application. You can continue or cancel the operation. For Solaris: Follow these steps to uninstall TDP for Informix: 1. Log in as the root user. 2. Issue these commands: pkgrm TDPinfmx pkgrm TIVsmCapi 10 Tivoli Data Protection for Informix: Installation and User s Guide

Chapter 3. Configuring TDP for Informix This section steps you through the setup of TDP for Informix. Some steps require that you, as the Informix database administrator, and the Tivoli Storage Manager administrator exchange information. The steps are: v Step 1 Edit the configuration file v Step 2 Ensure ON-Bar compatibility Step 1: Editing the Configuration File For Informix IDS 7 After the Informix ON-Bar product is installed, you need to edit the Informix configuration file. A sample configuration file is shipped on the Informix CD-ROM named onconfig.std. The Informix file (onconfig.std) is located in directory $informixdir/etc. Copy onconfig.std to onconfig. Edit the onconfig file. This step is required only if you are using Informix IDS 7. The onconfig file contains a parameter BAR_BSALIB_PATH which sets the value for the TDP for Informix library. The parameter should be set as follows: BAR_BSALIB_PATH=/usr/tivoli/tsm/client/informix/bin/bsashr10.o (for AIX) BAR_BSALIB_PATH=/opt/tivoli/tsm/client/informix/bin/libTDPinf.so (for Solaris) Step 2: Ensuring ON-Bar Compatibility After installing ON-Bar, make sure that it is compatible with the current version of the Tivoli Storage Manager client. Copy sm_versions.std to sm_versions. Edit the sm_versions file before running oninit. Follow these steps: 1. Edit the file $INFORMIXDIR/etc/sm_versions. 2. Create a line for the current Tivoli Storage Manager level: 1 3.7.0 adsm 3 The fields in this line are: 1 Always use 1. 3.7.0 Tivoli Storage Manager version.release.level adsm Name used to identify TSM for On-Bar. 3 Tivoli Storage Manager version If the current Tivoli Storage Manager version is not in this table, you will get an error about an incompatible version. Copyright IBM Corp. 1999 11

12 Tivoli Data Protection for Informix: Installation and User s Guide

Chapter 4. Problem Determination ON-Bar might report an unspecified XBSA error 96. This indicates that a Tivoli Storage Manager error occurred that could not be explained with the currently defined XBSA return codes. The explanation for the error will be in the dsierror.log file which is specified by the DSMI_LOG environment variable. If there are any license violations, these will be documented in the tsmlic.log file. For other Tivoli Storage Manager API return codes, see Tivoli Storage Manager Using the Application Program Interface. Copyright IBM Corp. 1999 13

14 Tivoli Data Protection for Informix: Installation and User s Guide

Index A AIX supported 1 C client options files editing 7 configuration file, editing 11 configuring TDP for Informix 11 D databases supported 1, 4 dsm.opt file 7 dsm.sys file 7 E environment variables, defining 6 H hardware requirements 3 I include-exclude option 7, 8 Informix databases supported 1 installing TDP for Informix defining environment variables 6 hardware requirements 3 Informix databases supported 4 installing on UNIX 3 on AIX 4 on Sun Solaris 5 software requirements 4 M management class assigning for backup 8 N naming convention 8 O ON-Bar utility ensuring compatibility 11 use of 1 P password program 9 platforms supported 1 R registering TDP for Informix with the TSM server 9 S sample files 7 software requirements 4 Sun Solaris supported 1 T tdpipswd program 9 Tivoli Data Protection for Informix communicating with the server 7 configuring 11 databases supported 1 defining environment variables 6 editing the configuration file 11 hardware requirements 3 Informix databases supported 4 installing on AIX 4 installing on Sun Solaris 5 installing on UNIX 3 introducing 1 platforms supported 1 registering with the server 9 software requirements 4 Copyright IBM Corp. 1999 15

16 Tivoli Data Protection for Informix: Installation and User s Guide

Part Number: CT7UINA Program Number: 5697 DPI Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber. SH26-4095-00 CT7UINA