Академический Документы
Профессиональный Документы
Культура Документы
SC32-9064-04
Tivoli Storage Manager
®
SC32-9064-04
Note
Before using this information and the product it supports, read the general information under “Notices” on page 95.
This edition applies to Version 5, Release 5, Modification 1.0, of IBM Tivoli Storage Manager for Databases Data
Protection for Oracle for AIX, Linux, HP-UX, or Solaris (product number 5608-APD) and to all subsequent releases
until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 1997, 2008. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Summary of changes . . . . . . . . . v 3. Define Tivoli Storage Manager options in the
| Technical changes for Version 5.5.1 . . . . . . . v dsm.opt and dsm.sys files . . . . . . . . . 47
Required options . . . . . . . . . . . 48
About this guide . . . . . . . . . . vii Other options to consider . . . . . . . . . 49
4. Define Tivoli Storage Manager policy
Who should read this guide . . . . . . . . . vii
requirements . . . . . . . . . . . . . . 51
Publications . . . . . . . . . . . . . . vii
5. Initialize the password with a Tivoli Storage
IBM Tivoli Storage Manager library . . . . . vii
Manager server . . . . . . . . . . . . . 53
Accessing terminology online . . . . . . . ix
Accessing publications online . . . . . . . ix
Ordering publications . . . . . . . . . . ix Chapter 4. Using RMAN and Data
Tivoli Technical Training . . . . . . . . . ix Protection for Oracle. . . . . . . . . 55
Accessibility . . . . . . . . . . . . . . x Invoking RMAN. . . . . . . . . . . . . 55
Support information . . . . . . . . . . . . x Scripts . . . . . . . . . . . . . . . . 56
IBM Tivoli Storage Manager Web site . . . . . x Script example . . . . . . . . . . . . 56
IBM Tivoli Storage Manager for Databases Web Using the Duplex Copy function . . . . . . . 56
site . . . . . . . . . . . . . . . . x Removing old backups . . . . . . . . . . 58
Conventions used in this book . . . . . . . . x Example . . . . . . . . . . . . . . 58
Typeface conventions . . . . . . . . . . x
Reading syntax diagrams . . . . . . . . . . xi Chapter 5. Using the utilities . . . . . 59
Command line syntax and characteristics . . . . 59
Chapter 1. Introducing Data Protection TDPOCONF . . . . . . . . . . . . . . 60
for Oracle . . . . . . . . . . . . . . 1 Password command . . . . . . . . . . 60
Understanding Tivoli Storage Manager . . . . . 1 Showenvironment command . . . . . . . 61
Overview of Data Protection for Oracle . . . . . 2 TDPOSYNC . . . . . . . . . . . . . . 62
RMAN and Data Protection for Oracle . . . . . 2 Considerations . . . . . . . . . . . . 63
LAN-free data transfer . . . . . . . . . . 3 Syncdb Command . . . . . . . . . . . 64
Migration and coexistence . . . . . . . . . 3
Appendix A. Quick configuration guide 67
Chapter 2. Installing Data Protection for
Oracle . . . . . . . . . . . . . . . 5 Appendix B. Using the Tivoli Storage
AIX . . . . . . . . . . . . . . . . . 6 Manager scheduler . . . . . . . . . 69
AIX environment (64-bit) . . . . . . . . . 6 Setting up a schedule . . . . . . . . . . . 69
HP-UX . . . . . . . . . . . . . . . . 9 Part I: On the Tivoli Storage Manager server . . 70
HP-UX PA-RISC environment (64-bit) . . . . . 9 Part II: On the client machine (NodeA1) . . . . 70
HP-UX Itanium 2 environment (64-bit) . . . . 12
Linux . . . . . . . . . . . . . . . . 15 Appendix C. Support information . . . 73
Linux x86 environment (32-bit) . . . . . . . 15 What to do when you encounter a problem . . . 73
Linux x86_64 environment . . . . . . . . 18 Searching knowledge bases . . . . . . . . . 75
| Linux Itanium 64 environment . . . . . . . 21 Searching the information center . . . . . . 75
Linux on POWER environment . . . . . . . 24 Searching the Internet . . . . . . . . . . 75
Linux zSeries environment (64-bit) . . . . . . 27 Obtaining fixes . . . . . . . . . . . . . 75
Solaris . . . . . . . . . . . . . . . . 30 Receiving weekly support updates . . . . . . 76
Solaris SPARC environment (32-bit) . . . . . 30 Contacting IBM Software Support . . . . . . . 76
Solaris SPARC environment (64-bit) . . . . . 33 Determining the business impact . . . . . . 77
Solaris x86 environment (32-bit) . . . . . . 36 Describing problems and gathering information 78
Solaris x86_64 environment . . . . . . . . 39 Submitting problems . . . . . . . . . . 78
iv IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Summary of changes
This section summarizes changes made to the Data Protection for Oracle product
and this publication. Changes to the text since the SC32-9064-03 version are
indicated by vertical lines (|) in the margin to the left of the change.
vi IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
About this guide
The subject of this publication is Data Protection for Oracle, a component of the IBM
Tivoli Storage Manager for Databases product.
Data Protection for Oracle performs online or offline backups of Oracle 9i and
Oracle 10g databases to Tivoli Storage Manager storage. This integration with the
RMAN Media Management API maximizes the protection of data, thus providing
a comprehensive storage management solution.
Publications
This section lists related IBM Tivoli Storage Manager publications. It also describes
how to access Tivoli® publications online and how to order Tivoli publications.
viii IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Accessing terminology online
The Tivoli Software Glossary includes definitions for many of the technical terms
related to Tivoli software. The Tivoli Software Glossary is available at the following
Tivoli software library Web site:
http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm
The IBM Terminology Web site consolidates the terminology from IBM product
libraries in one convenient location. You can access the Terminology Web site at the
following Web address:
http://www.ibm.com/ibm/terminology
IBM® posts publications for this and all other Tivoli products, as they become
available and whenever they are updated, to the Tivoli software information center
Web site. Access the Tivoli software information center by first going to the Tivoli
software library at the following Web address:
http://www.ibm.com/software/tivoli/library/
Scroll down and click the Product manuals link. In the Tivoli Technical Product
Documents Alphabetical Listing window, click the <Tivoli Storage Manager> link
to access the product library at the Tivoli software information center.
Note: If you print PDF documents on other than letter-sized paper, set the option
in the File → Print window that allows Adobe Reader to print letter-sized
pages on your local paper.
Ordering publications
You can order many Tivoli publications online at the following Web site:
http://www.elink.ibmlink.ibm.com/public/applications/
publications/cgibin/pbi.cgi
http://www.ibm.com/software/tivoli/education
Support information
If you have a problem with your IBM software, you want to resolve it quickly. IBM
provides the following ways for you to obtain the support you need:
v Searching knowledge bases: You can search across a large collection of known
problems and workarounds, Technotes, and other information.
v Obtaining fixes: You can locate the latest fixes that are already available for your
product.
v Contacting IBM Software Support: If you still cannot solve your problem, and
you need to work with someone from IBM, you can use a variety of ways to
contact IBM Software Support.
For more information about these three ways of resolving problems, see
Appendix C, “Support information,” on page 73.
By accessing the Tivoli Storage Manager home page, you can access subjects that
interest you. You can also keep up-to-date with the newest Tivoli Storage Manager
product information.
Typeface conventions
This guide uses the following typeface conventions:
Bold
v Commands, keywords, authorization roles, or other information that you
must use.
x IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
v Example: Log on to the server as root user.
italics
v Values or variables that you must provide.
v Emphasized words and phrases.
v Example: The node name of the production node and backup node must not
be the same.
bold italics
v Options and parameters.
v Example: Specify the value for the compression option.
monospace
v Directories, parameters, URLs, and output examples.
v Example: The product is installed in the /usr/tivoli/tsm/client/ba/bin
directory.
UPPER CASE
v Environment variables associated with Tivoli Storage Manager, operating
systems, or Oracle Server.
v Example: Make sure the DSM_DIR environment variable is set correctly.
Required Choices:
A
When two or more items are in a stack and B
one of them is on the line, you must specify C
one item.
xii IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Syntax Diagram Description Example
Defaults:
A
Defaults are above the line. The default is
selected unless you override it. You can B
override the default by including an option C
from the stack below the line.
With the use of RMAN, Data Protection for Oracle allows you to perform the
following functions:
v Full and incremental backup function for the following while online or offline:
– Databases
2 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
– Tablespaces
– Datafiles
– Archive log files
– Control files
v Full database restores while offline
v Tablespace and datafile restore while online or offline
Before enabling LAN-free support, you must install the Tivoli Storage Manager
Managed System for SAN Storage Agent on the same system as Data Protection
for Oracle. See the IBM Tivoli Storage Manager for SAN for your operating
environment for more information about LAN-free requirements.
Attention: A root user must install the Tivoli Storage Manager API before
installing Data Protection for Oracle on the workstation where the target database
resides.
After Data Protection for Oracle is installed, see Chapter 3, “Configuring Data
Protection for Oracle,” on page 43 for detailed task instructions you must perform
before attempting to back up data..
Note: If you would like to configure Data Protection for Oracle using default
settings, see Appendix A, “Quick configuration guide,” on page 67 for
instructions.
Important
See the readmedporc_enu.htm file that is shipped on the product installation
media for the most current information.
Hardware requirements
| v Any RS/6000, pSeries or IBM System p, iSeries or IBM System i, or compatible
| workstation as supported by AIX
v Disk space: 8 MB
v Memory: 64 MB (128 MB or more recommended)
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
v One of the following levels of Oracle Server:
– Oracle9i Version 9.2 (64-bit)
– Oracle 10g Release 1 (64-bit)
– Oracle 10g Release 2 (64-bit)
| – Oracle 11g (64-bit) on AIX 5.3 (64-bit) only
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
6 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on AIX 64-bit
All installables on the CD reside under the /cdrom/usr/sys/inst.images directory.
Table 1. AIX 5L 64-bit Default Installation Directories
AIX Default Installation Directories
Data Protection for Oracle 64-bit /usr/tivoli/tsm/client/oracle/bin64
Data Protection for Oracle /usr/tivoli/tsm/client/oracle/bin64
Utilities
Tivoli Storage Manager API /usr/tivoli/tsm/client/api/bin64
64-bit
Table 2. Data Protection for Oracle AIX 5L 64-bit, Utilities, Languages, and Tivoli Storage
Manager API Package Names
Package Package Name
Data Protection for Oracle 64-bit tivoli.tsm.client.oracle.aix.64bit
Data Protection for Oracle tivoli.tsm.client.oracle.tools.aix.64bit
Utilities
Electronic License Agreement tivoli.tsm.loc.client.oracle.aix.64bit.ela
Data Protection for Oracle tivoli.tsm.client.oracle.msg.aix.64bit.xx_XX
Languages
Tivoli Storage Manager API tivoli.tsm.client.api.aix.64bit
64-bit
Tivoli Storage Manager API tivoli.tsm.msg.xx_XX.client.api.64bit
Languages
Follow these instructions to install Data Protection for Oracle. This example
assumes that your CD drive is /dev/cd0.
1. Insert the CD containing the client package into the CD drive.
2. Log in as the root user.
3. Enter smitty install at the command prompt.
4. Select Install and Update Software. Press Enter.
5. Select Install and Update from ALL Available Software. Press Enter.
6. Enter /dev/cd0 in the Entry Field for INPUT device / directory for software.
Press Enter.
7. Highlight the SOFTWARE to install option. Press F4 to list available software.
8. Select the installable packages by performing the following:
a. Highlight the Data Protection for Oracle package
(tivoli.tsm.client.oracle.aix.64bit) and press F7.
b. Highlight the Data Protection for Oracle utilities package
(tivoli.tsm.client.oracle.tools.aix.64bit) and press F7.
c. Highlight the Tivoli Storage Manager API package
(tivoli.tsm.client.api.aix.64bit) and press F7.
d. If you want to install Data Protection for Oracle in a language other than
English, highlight the desired language package
(tivoli.tsm.client.oracle.msg.aix.64bit.xx_XX) and press F7. Make sure
the Tivoli Storage Manager API language package for the desired language
(tivoli.tsm.msg.xx_XX.client.api.64bit) is also installed.
8 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
HP-UX
Hardware requirements
v Any HP 9000 Series 700 or 800 workstation
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle9i Version 9.2 (64-bit)
– Oracle 10g Release 1 (64-bit)
– Oracle 10g Release 2 (64-bit)
| – Oracle 11g (64-bit)
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
Table 4. Data Protection for Oracle 64-bit and Tivoli Storage Manager installable files and
packages
Component Installable file or package
Data Protection for Oracle 64-bit base code, TDPOracle64.bin
license, utilities
Data Protection for Oracle Languages TDPOracle.msg.xx_XX.bin
Tivoli Storage Manager API TIVsmCapi64
Tivoli Storage Manager API Languages TIVsmC.msg.xx_XX
To install:
1. Log in as the root user:
# su
Password:
10 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| Note: xx_XX represents the country code for the language contents of the
| package.
| 5. Change to the /cdrom/oracle/hpux11 directory where the Data Protection for
| Oracle installable file resides on the CD:
| $ cd /cdrom/oracle/hpux11
|
|
| 6. Enter the name of the installable file (TDPOracle64.bin) on the command line
| and press Enter to install the Data Protection for Oracle product, utilities, and
| license:
| $ TDPOracle64.bin
||
| To install in console mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDPOracle64.bin.
7. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the installable file for the desired language
(TDPOracle.msg.xx_XX.bin) on the command line and press Enter:
$ TDPOracle.msg.xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmC.msg.xx_XX) is also installed.
8. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib
Hardware requirements
v An HP Integrity server with an Itanium 2 processor
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle 10g Release 1 (64-bit)
– Oracle 10g Release 2 (64-bit)
| – Oracle 11g (64-bit)
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
12 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on HP-UX Itanium 2 64-bit
All installable files reside under the /cdrom/oracle/hpuxia/ directory.
Table 5. HP-UX Itanium 2 64-bit Default Installation Directories
HP-UX Default Installation Directories
Data Protection for Oracle 64-bit /opt/tivoli/tsm/client/oracle/bin64
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Utilities
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Messages
Tivoli Storage Manager API /opt/tivoli/tsm/client/api/bin64
Table 6. Data Protection for Oracle 64-bit and Tivoli Storage Manager installable files and
packages
Component Installable file or package
Data Protection for Oracle 64-bit base code, TDPOracle64.bin
license, utilities
Data Protection for Oracle Languages TDPOracle64.msg.xx_XX.bin
Tivoli Storage Manager API TIVsmCapi64
Tivoli Storage Manager API Languages TIVsmC.msg.xx_XX
To install:
1. Log in as the root user:
# su
Password:
| To install in console mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDPOracle64.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDPOracle64.bin.
7. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPOracle.msg.xx_XX.bin) on the command line and press
Enter:
$ TDPOracle.msg.xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmC.msg.xx_XX) is also installed.
8. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib
14 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Linux
Hardware requirements
v Any Intel x86 (or compatible) 32-bit workstation
v Disk space: 8 MB
v Memory: 64 MB (128 MB or more recommended)
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle9i Version 9.2 (32-bit)
– Oracle 10g Release 1 (32-bit)
– Oracle 10g Release 2 (32-bit)
| – Oracle 11g (32-bit)
Table 7. Supported Oracle Server and operating system combinations for Linux x86 32-bit
Oracle 9i Version 9.2 Oracle 10g Release 1 Oracle 10g Release 2
(32-bit) (32-bit) (32-bit)
Asianux 2.0 (32-bit) U U U
SuSE Linux Enterprise U U U
Server 9 (32-bit)
SuSE Linux Enterprise U
Server 10 (32-bit)
Linux Red Flag Advanced U U
Server 4.1 (32-bit)
Communication methods
v TCP/IP
Table 9. Data Protection for Oracle Linux x86 and Tivoli Storage Manager installable files
and packages
Component Installable file or package
Data Protection for Oracle 32-bit base code, TDP-Oracle.i386.bin
license, and utilities
Data Protection for Oracle Languages TDPOracle.msg.xx_XX.bin
Tivoli Storage Manager API 32-bit TIVsm-API.i386.rpm
Tivoli Storage Manager API Languages TIVsm-.msg.xx_XX.i386.rpm
This installation procedure is designed to install directly from the Data Protection
for Oracle CD:
1. Log in as the root user.
2. Mount the Data Protection for Oracle CD to /cdrom:
$ mount <device name> /cdrom
| Note: xx_XX represents the country code for the language contents of the
| package.
| 5. Change to the <cdrom>/oracle/linux86 directory where the Data Protection for
| Oracle installable file resides on the CD:
| $ cd <cdrom>/oracle/linux86
||
| 6. Enter the name of the installable file (TDP-Oracle.i386.bin) on the command
| line and press Enter to install Data Protection for Oracle:
16 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| $ TDP-Oracle.i386.bin
|
|
| To install in console mode, enter the following command and press Enter:
| $ TDP-Oracle.i386.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDP-Oracle.i386.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDP-Oracle.i386.bin -i gui
|
|
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDP-Oracle.i386.bin.
7. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPOracle.msg.xx_XX.bin) on the command line and press
Enter:
$ TDPOracle.msg.xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsm-.msg.xx_XX.i386.rpm) is also installed. Note that the libobk.so
library file is located automatically based on the link that the installation
program places in the /usr/lib directory.
Hardware requirements
v Any Intel EM64T or Opteron AMD64 (or compatible) processor
v Disk space: 8 MB
v Memory: 64 MB (128 MB or more recommended)
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle9i Version 9.2 (64-bit)
– Oracle 10g Release 1 (64-bit)
– Oracle 10g Release 2 (64-bit)
| – Oracle 11g (64-bit)
Table 10. Supported Oracle Server and operating system combinations for Linux x86_64
| Oracle 9i Version Oracle 10g Oracle 10g Oracle 11g
| 9.2 (64-bit) Release 1 (64-bit) Release 2 (64-bit) (64-bit)
Asianux 2.0 (64-bit) U U U
SuSE Linux Enterprise U U U
Server 9 (64-bit)
SuSE Linux Enterprise U
Server 10 (64-bit)
| Red Hat Enterprise Linux U
| 5 (64-bit)
Communication methods
v TCP/IP
18 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on Linux x86_64
All installable files reside under the /cdrom/oracle/linux86_64 directory.
Table 11. Linux x86_64 Default Installation Directories
Linux Default Installation Directories
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Linux x86_64
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Utilities
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Messages
Tivoli Storage Manager API /opt/tivoli/tsm/client/api/bin64
Table 12. Data Protection for Oracle Linux x86_64 and Tivoli Storage Manager installable
files and packages
Component Installable file or package
Data Protection for Oracle Linux x86_64 base TDP-Oracle.x86_64.bin
code, license, utilities
Data Protection for Oracle Languages TDPOracle.msg.xx_XX.x86_64.bin
Tivoli Storage Manager API Linux x86_64 TIVsm-API64.i386.rpm
Tivoli Storage Manager API Languages TIVsm-msg.xx_XX.i386.rpm
This installation procedure is designed to install directly from the Data Protection
for Oracle CD:
1. Log in as the root user on the machine with the accessible CD device.
2. Mount the Data Protection for Oracle CD to /cdrom:
$ mount <device name> /cdrom
3. Mount /cdrom to the /cdrom directory on the Linux zSeries machine. The /cdrom
directory must already exist on the Linux zSeries machine:
$ mount -o soft hostname:/cdrom /cdrom
Note: hostname is the machine with the accessible CD device identified in Step
1.
| 4. Change to the <cdrom>/oracle/linux86_64/api directory where the installation
| package resides on the CD:
| $ cd <cdrom>/oracle/linux86_64/api
||
| 5. Issue the following command to install the Tivoli Storage Manager API:
| $ rpm -i TIVsm-API64.x86_64.rpm
||
| To install in console mode, enter the following command and press Enter:
| $ TDP-Oracle.x86_64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDP-Oracle.x86_64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDP-Oracle.x86_64.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different from TDP-Oracle.x86_64.bin.
8. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPOracle.msg.xx_XX.bin) on the command line and press
Enter:
$ TDPOracle.msg.xx_XX.x86_64.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsm-msg.xx_XX.x86_64.rpm) is also installed.
Note: The libobk.so library file is located automatically based on the link that the
installation program places in the /usr/lib64 directory.
20 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| Linux Itanium 64 environment
| This section contains operating system, hardware, software, and communication
| requirements for installing Data Protection for Oracle in a Linux Itanium 64
| environment.
| Hardware requirements
| v Any Intel Itanium 64-bit Symmetric Multiprocessor or uniprocessor based PC
| architecture (or compatible)
| v Disk space: 20 MB
| v Memory: 128 MB (or more)
| Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
| v One of the following levels of Oracle Server:
| – Oracle 10g Release 1 (64-bit)
| – Oracle 10g Release 2 (64-bit)
| Communication methods
| v TCP/IP
|
| This installation procedure is designed to install directly from the Data Protection
| for Oracle CD:
| 1. Log in as the root user on the machine with the accessible CD device.
| 2. Mount the Data Protection for Oracle CD to /cdrom:
| $ mount <device name> /cdrom
|
|
| 3. Mount /cdrom to the /cdrom directory on the Linux zSeries machine. The /cdrom
| directory must already exist on the Linux zSeries machine:
| $ mount -o soft hostname:/cdrom /cdrom
||
| Note: hostname is the machine with the accessible CD device identified in Step
| 1.
| 4. Change to the <cdrom>/oracle/linuxia64/api directory where the Tivoli
| Storage Manager API installation package resides on the CD:
| $ cd <cdrom>/oracle/linuxia64/api
||
| 5. Issue the following command to install the Tivoli Storage Manager API:
| $ rpm -i TIVsm-API64.ia64.rpm
||
22 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| Note: xx_XX represents the country code for the language contents of the
| package.
| 6. Change to the <cdrom>/oracle/linuxia64 directory where the Data Protection
| for Oracle installable file resides on the CD:
| $ cd <cdrom>/oracle/linuxia64
|
|
| To install in console mode, enter the following command and press Enter:
| $ TDP-Oracle.ia64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDP-Oracle.ia64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDP-Oracle.ia64.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDP-Oracle.ia64.bin.
| 8. If you want to install Data Protection for Oracle in a language other than
| English, enter the name of the Data Protection for Oracle installable file for the
| desired language (TDPOracle.msg.xx_XX.ia64.bin) on the command line and
| press Enter:
| $ TDPOracle.msg.xx_XX.ia64.bin
||
| Make sure the Tivoli Storage Manager API language package for the desired
| language (TIVsm-msg.xx_XX.ia64.rpm) is also installed.
| Note: The libobk.so library file is located automatically based on the link that the
| installation program places in the /usr/lib64 directory.
|
Hardware requirements
v Any iSeries™, pSeries®, or Power 5 (or compatible) processor
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v Oracle 10g Release 2 (64-bit)
Communication methods
v TCP/IP
24 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on Linux on POWER
All installable files reside under the /cdrom/oracle/linuxppc64 directory.
Table 15. Linux on POWER Default Installation Directories
Linux Default Installation Directories
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Linux on POWER
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Utilities
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin64
Messages
Tivoli Storage Manager API /opt/tivoli/tsm/client/api/bin64
Table 16. Data Protection for Oracle Linux on POWER and Tivoli Storage Manager
installable files and packages
Component Installable file or package
Data Protection for Oracle Linux on POWER TDP-Oracle64.ppc64.bin
base code, license, utilities
Data Protection for Oracle Languages TDP-Oracle64.msg.xx_XX.ppc64.bin
Tivoli Storage Manager API Linux on TIVsm-API.ppc64.rpm
POWER
Tivoli Storage Manager Languages TIVsm-msg.xx_XX.ppc64.rpm
This installation procedure is designed to install directly from the Data Protection
for Oracle CD:
1. Log in as the root user on the machine with the accessible CD device.
2. Mount the Data Protection for Oracle CD to /cdrom:
$ mount <device name> /cdrom
3. Mount /cdrom to the /cdrom directory on the Linux machine. The /cdrom
directory must already exist on the Linux machine:
$ mount -o soft hostname:/cdrom /cdrom
Note: hostname is the machine with the accessible CD device identified in Step
1.
| 4. Change to the <cdrom>/oracle/linuxppc64/api directory where the Tivoli
| Storage Manager API installation package resides on the CD:
| $ cd <cdrom>/oracle/linuxppc64/api
||
| Note: xx_XX represents the country code for the language contents of the
| package.
| 6. Change to the <cdrom>/oracle/linuxppc64 directory where the Data Protection
| for Oracle installable file resides on the CD:
| $ cd <cdrom>/oracle/linuxppc64
|
|
| To install in console mode, enter the following command and press Enter:
| $ TDP-Oracle64.ppc64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDP-Oracle64.ppc64.bin -i silent
||
| To install in GUI mode, enter the following command and press Enter:
| $ TDP-Oracle64.ppc64.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDP-Oracle64.ppc64.bin.
8. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDP-Oracle64.msg.xx_XX.ppc64.bin) on the command line
and press Enter:
$ TDP-Oracle64.msg.xx_XX.ppc64.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsm-msg.xx_XX.ppc64.rpm) is also installed.
Note: The libobk.so library file is located automatically based on the link that the
installation program places in the /usr/lib64 directory.
26 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Linux zSeries environment (64-bit)
This section contains operating system, hardware, software, and communication
requirements for installing Data Protection for Oracle in a Linux zSeries 64-bit
environment.
Hardware requirements
v A zSeries 900 or 800 server (64-bit)
v Disk space: 8 MB
v Memory: 64 MB (128 MB or more recommended)
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
v Tivoli Storage Manager API Version 5.5.0 (or later)
Note: To view Data Protection for Oracle in a language other than English, you
must install the Tivoli Storage Manager Language package of the desired
language.
| v Java 1.4 (or later) is required to run the installer program.
v Oracle 10g Release 1 (64-bit)
v Oracle 10g Release 2 (64-bit)
Communication methods
v TCP/IP
Table 18. Data Protection for Oracle Linux zSeries (64-bit environment) and Tivoli Storage
Manager installable files and packages
Component Installable file or package
Data Protection for Oracle Linux zSeries base TDP-Oracle.s390x.bin
code, license, utilities
Data Protection for Oracle Languages TDP-Oracle.msg.xx_XX.s390x.bin
Tivoli Storage Manager API Linux zSeries TIVsm-API64.s390.rpm
Tivoli Storage Manager Languages TIVsm-msg.xx_XX.s390.rpm
This installation procedure is designed to install directly from the Data Protection
for Oracle CD:
1. Log in as the root user on the machine with the accessible CD device.
2. Mount the Data Protection for Oracle CD to /cdrom:
$ mount <device name> /cdrom
3. Mount /cdrom to the /cdrom directory on the Linux machine. The /cdrom
directory must already exist on the Linux machine:
$ mount -o soft hostname:/cdrom /cdrom
Note: hostname is the machine with the accessible CD device identified in Step
1.
| 4. Change to the <cdrom>/oracle/linuxz64/api directory where the Tivoli Storage
| Manager API installation package resides on the CD:
| $ cd <cdrom>/oracle/linuxz64/api
||
| 5. Issue the following command to install the Tivoli Storage Manager API:
| $ rpm -i TIVsm-API.s390.rpm
||
28 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| Note: xx_XX represents the country code for the language contents of the
| package.
| 6. Change to the <cdrom>/oracle/linuxz64 directory where the Data Protection for
| Oracle installable file resides on the CD:
| $ cd <cdrom>/oracle/linuxz64
|
|
| To install in console mode, enter the following command and press Enter:
| $ TDP-Oracle.s390x.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDP-Oracle.s390x.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDP-Oracle.s390x.bin -i gui
||
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDP-Oracle.s390x.bin.
8. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDP-Oracle.msg.xx_XX.s390x.bin) on the command line and
press Enter:
$ TDP-Oracle.msg.xx_XX.s390x.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsm-msg.xx_XX.s390.rpm) is also installed.
Note: The libobk.so library file is located automatically based on the link that the
installation program places in the /usr/lib64 directory. This is the default
link:
/usr/lib64/libobk.so /opt/tivoli/tsm/client/oracle/bin64/libobk.so
Hardware requirements
v A SPARC 32-bit (or compatible) workstation.
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0
| v Java 1.4 (or later) is required to run the installer program.
v Oracle9i Version 9.2 (32-bit)
Communication method
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
30 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on Solaris SPARC 32-bit
All installable files reside under the /cdrom/oracle/solaris directory.
Table 19. Solaris SPARC 32-bit Default Installation Directories
Solaris Default Installation Directories
Data Protection for Oracle 32-bit /opt/tivoli/tsm/client/oracle/bin
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin
Utilities
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin
Messages
Tivoli Storage Manager API /opt/tivoli/tsm/client/api/bin
32-bit
Table 20. Data Protection for Oracle 32-bit and Tivoli Storage Manager installable files and
packages
Component Installable file or package
Data Protection for Oracle 32-bit base code, TDPoracle32.bin
license, utilities
Data Protection for Oracle Languages TDPoracle32xx_XX.bin
Tivoli Storage Manager API 32-bit TIVsmCapi.pkg
Tivoli Storage Manager API Languages TIVsmClXx.pkg
Perform these instructions to install the Tivoli Storage Manager API, Data
Protection for Oracle, and the Data Protection for Oracle license package. This
example assumes that your CD drive is /cdrom and that you are installing the
Data Protection for Oracle 32-bit product.
1. Insert the CD containing the package into the CD drive.
2. Log in as the root user.
| 3. Issue this command to install the Tivoli Storage Manager API:
| $ pkgadd -d /cdrom/oracle/solaris/api/TIVsmCapi.pkg
||
| Note: Xx represents the country code for the language contents of the package.
| 4. Change to the /cdrom/oracle/solaris directory where the Data Protection for
| Oracle installable file resides on the CD:
| $ cd /cdrom/oracle/solaris
||
| 5. Enter the name of the installable file (TDPoracle32.bin) on the command line
| and press Enter to install Data Protection for Oracle:
| $ TDPoracle32.bin
||
| To install in console mode, enter the following command and press Enter:
| To install in silent mode, enter the following command and press Enter:
| $ TDPoracle32.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDPoracle32.bin -i gui
|
|
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDPoracle32.bin.
6. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPoracle32xx_XX.bin) on the command line and press
Enter:
$ TDPoracle32xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmClXx.pkg) is also installed.
7. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib32 as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib32
32 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Solaris SPARC environment (64-bit)
This section contains operating system, hardware, software, and communication
requirements for installing Data Protection for Oracle in a Solaris SPARC 64-bit
environment.
Hardware requirements
v A SPARC 64-bit (or compatible) workstation
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle9i Version 9.2 (64-bit)
– Oracle 10g Release 1 (64-bit)
– Oracle 10g Release 2 (64-bit)
| – Oracle 11g (64-bit)
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
Table 22. Data Protection for Oracle 64-bit and Tivoli Storage Manager installable files and
packages
Component Installable file or package
Data Protection for Oracle 64-bit base code, TDPoracle64.bin
license, utilities
Data Protection for Oracle Languages TDPoracle64xx_XX.bin
Tivoli Storage Manager API 64-bit TIVsmCapi.pkg
Tivoli Storage Manager API Languages TIVsmClXx.pkg
Perform these instructions to install the Tivoli Storage Manager API, Data
Protection for Oracle, and the Data Protection for Oracle license package. This
example assumes that your CD drive is /cdrom and that you are installing the
Data Protection for Oracle 64-bit product.
1. Insert the CD containing the client package into the CD drive.
2. Log in as the root user.
3. Issue this command to install the Tivoli Storage Manager API:
$ pkgadd -d /cdrom/oracle/solaris/api/TIVsmCapi.pkg
Note: Xx represents the country code for the language contents of the package.
| 4. Change to the /cdrom/oracle/solaris directory where the Data Protection for
| Oracle installable file resides on the CD:
| $ cd /cdrom/oracle/solaris
||
| 5. Enter the name of the installable file (TDPoracle64.bin) on the command line
| and press Enter to install Data Protection for Oracle:
| $ TDPoracle64.bin
||
| To install in console mode, enter the following command and press Enter:
34 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| $ TDPoracle64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ TDPoracle64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDPoracle64.bin -i gui
|
|
| If the installable file was downloaded from the FTP site, the filename might be
| different from TDPoracle64.bin.
6. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPoracle64xx_XX.bin) on the command line and press
Enter:
$ TDPoracle64xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmClXx.pkg) is also installed.
7. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib
Hardware requirements
v Any Intel x86 (or compatible) 32-bit workstation.
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v Oracle 10g Release 1 (32-bit)
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
36 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Installing Data Protection for Oracle on Solaris x86 32-bit
All installable files reside under the /cdrom/oracle/solarisx86 directory.
Table 23. Solaris x86 32-bit Default Installation Directories
Solaris Default Installation Directories
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin
Solaris x86
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin
Utilities
Data Protection for Oracle /opt/tivoli/tsm/client/oracle/bin
Messages
Tivoli Storage Manager API /opt/tivoli/tsm/client/api/bin
Table 24. Data Protection for Oracle x86 32-bit and Tivoli Storage Manager installable files
and packages
Component Installable file or package
Data Protection for Oracle 32-bit base code, TDPoraclex86.bin
license, utilities
Data Protection for Oracle Languages TDPoraclex86.xx_XX.bin
Tivoli Storage Manager API 32-bit TIVsmCapi.pkg
Tivoli Storage Manager API Languages TIVsmClXx.pkg
Perform these instructions to install the Tivoli Storage Manager API, Data
Protection for Oracle, and the Data Protection for Oracle license package. This
example assumes that your CD drive is /cdrom and that you are installing the
Data Protection for Oracle Solaris x86 32-bit product.
1. Insert the CD containing the client package into the CD drive.
2. Log in as the root user.
| 3. Issue this command to install the Tivoli Storage Manager API:
| $ pkgadd -d /cdrom/oracle/solarisx86/api/TIVsmCapi.pkg
||
| Note: Xx represents the country code for the language contents of the package.
| 4. Change to the /cdrom/oracle/solarisx86 directory where the Data Protection
| for Oracle installable file resides on the CD:
| $ cd /cdrom/oracle/solarisx86
||
| 5. Enter the name of the installable file (TDPoraclex86.bin) on the command line
| and press Enter to install Data Protection for Oracle:
| $ TDPoraclex86.bin
||
| To install in console mode, enter the following command and press Enter:
| To install in silent mode, enter the following command and press Enter:
| $ TDPoraclex86.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ TDPoraclex86.bin -i gui
|
|
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDPoraclex86.bin.
6. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPoraclex86.xx_XX.bin) on the command line and press
Enter:
$ TDPoraclex86.xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmClXx.pkg) is also installed.
7. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib
38 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Solaris x86_64 environment
This section contains operating system, hardware, software, and communication
requirements for installing Data Protection for Oracle in a Solaris x86_64
environment.
Hardware requirements
v Any Intel EM64T or Opteron AMD64 (or compatible) processor
v Disk space: 8 MB
v Memory: 96 MB
Software requirements
| v Tivoli Storage Manager server Version 5.4.0 (or later)
| v Tivoli Storage Manager API Version 5.5.0 (or later)
| v Java 1.4 (or later) is required to run the installer program.
v One of the following levels of Oracle Server:
– Oracle 10g Release 1
- Consult your Oracle documentation for details regarding support for
Release 1.
– Oracle 10g Release 2 (64-bit)
Communication methods
v TCP/IP
| v Shared memory
| Note: Data Protection for Oracle and the Tivoli Storage Manager server must be
| installed on the same machine in order for shared memory to work.
| TCP/IP must also be installed on the machine.
Table 26. Data Protection for Oracle x86_64 and Tivoli Storage Manager installable files and
packages
Component Installable file or package
Data Protection for Oracle x64 base code, TDPoraclex86_64.bin
license, utilities
Data Protection for Oracle Languages TDPoraclex86_64.xx_XX.bin
Tivoli Storage Manager API x64 TIVsmCapi.pkg
Tivoli Storage Manager API Languages TIVsmClXx.pkg
Perform these instructions to install the Tivoli Storage Manager API, Data
Protection for Oracle, and the Data Protection for Oracle license package. This
example assumes that your CD drive is /cdrom and that you are installing the
Data Protection for Oracle Solaris x86_64 product.
1. Insert the CD containing the client package into the CD drive.
2. Log in as the root user.
| 3. Issue this command to install the Tivoli Storage Manager API:
| $ pkgadd -d /cdrom/oracle/solarisx86_64/api/TIVsmCapi.pkg
||
| Note: Xx represents the country code for the language contents of the package.
| 4. Change to the /cdrom/oracle/solarisx86_64 directory where the Data
| Protection for Oracle installable file resides on the CD:
| $ cd /cdrom/oracle/solarisx86_64
||
| 5. Enter the name of the installable file (TDPoraclex86_64.bin) on the command
| line and press Enter to install Data Protection for Oracle:
| $ ./TDPoraclex86_64.bin
||
| To install in console mode, enter the following command and press Enter:
40 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
| $ ./TDPoraclex86_64.bin -i console
|
|
| To install in silent mode, enter the following command and press Enter:
| $ ./TDPoraclex86_64.bin -i silent
|
|
| To install in GUI mode, enter the following command and press Enter:
| $ ./TDPoraclex86_64.bin -i gui
|
|
| If the installable file was downloaded from the FTP site, the filename might be
| different than TDPoraclex86_64.bin.
6. If you want to install Data Protection for Oracle in a language other than
English, enter the name of the Data Protection for Oracle installable file for the
desired language (TDPoraclex64.xx_XX.bin) on the command line and press
Enter:
$ TDPoraclex64.xx_XX.bin
Make sure the Tivoli Storage Manager API language package for the desired
language (TIVsmClXx.pkg) is also installed.
7. Link the Oracle target database instance with Data Protection for Oracle by
performing the following steps:
a. Set the Oracle LD_LIBRARY_PATH option to specify $ORACLE_HOME/lib as
the first entry:
LD_LIBRARY_PATH=$ORACLE_HOME/lib
or
$ ln -s /usr/lib/em64t/libobk.so $ORACLE_HOME/lib/libobk.so
Note: If you would like to configure Data Protection for Oracle using default
settings, see Appendix A, “Quick configuration guide,” on page 67 for
instructions.
The TDPO_OPTFILE variable must be specified in upper case characters only. See
“Scripts” on page 56 for further information. Note that the allocate channel entry
is divided on two lines after the parms option to accommodate page formatting.
If a fully qualified path name is not provided, Data Protection for Oracle uses the
tdpo.opt file located in the Data Protection for Oracle default installation directory.
If this file does not exist, Data Protection for Oracle fails.
Considerations
v It is strongly recommended that you use the tdpo.opt file exclusively instead of
default parameters.
v RMAN and the tdpoconf and tdposync utilities use the options defined in the
tdpo.opt file.
v By default, the tdpo.opt file is located in the directory where Data Protection for
Oracle is installed.
v Data Protection for Oracle supports options (specified in the tdpo.opt file) in
both upper case or lower case type. However, the TDPO_OPTFILE variable
must be specified in upper case characters only.
44 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
string of 1 to 64 characters. It is recommended that you use a node name
that is different from the backup-archive client node name.
Be aware that it is the Tivoli Storage Manager API (and not Data Protection
for Oracle) that negotiates which login credentials (nodename, password)
to use with the Tivoli Storage Manager server. As a result, certain option
settings affect password management. For example, when the tdpo_node
option is specified (in the tdpo.opt file) and passwordaccess prompt is
specified (in the dsm.sys file), the Tivoli Storage Manager API uses the
value of the tdpo_node option and ignores the value of the nodename
option (specified in the dsm.sys file). However, when the tdpo_node option
is not specified and passwordaccess prompt is specified, the Tivoli Storage
Manager API attempts to automatically generate a password (by default),
even though passwordaccess prompt is specified. In this situation,
processing ends and an error message displays. To avoid receiving an error
message, make sure you follow these recommendations:
v When passwordaccess prompt is specified in the dsm.sys file, specify the
tdpo_node option in the tdpo.opt file.
v When passwordaccess generate is specified in the dsm.sys file, do NOT
specify the tdpo_node option in the tdpo.opt file.
To restore data from one Oracle server to another Oracle server using Data
Protection for Oracle, be aware of the following tdpo_node considerations:
v The value of the tdpo_node option in the tdpo.opt file on the target
Oracle server must equal the value of the tdpo_node option in the
tdpo.opt file on the source Oracle server.
v If passwordaccess prompt is specified for the backup, then
passwordaccess prompt must be specified for the restore. For example, if
passwordaccess prompt is specified in the dsm.sys file on the target
Oracle server, run the tdpoconf password command to create the
password locally on the source Oracle server.
v If passwordaccess generate is specified for the backup, then
passwordaccess generate must be specified for the restore. Be aware that
if the password for the Data Protection for Oracle node is unknown (due
to the passwordaccess generate setting), you can reset the password for
the production node on the Tivoli Storage Manager server. Then, after
the password is reset, use the new password to run the tdpoconf
password command on both the production machine (to set the
password for the next backup) and the alternate machine (to set the
password for the restore).
v Data Protection for Oracle and the Tivoli Storage Manager API must be
at the same levels on both the source Oracle server and the target Oracle
server.
tdpo_date_fmt
This option specifies the format you want to use to display dates. You can
specify a number between 0 and 5 inclusively. The default value is 1.
0 Use the locale-specified date format.
1 MM/DD/YYYY (Default)
2 DD-MM-YYYY
3 YYYY-MM-DD
4 DD.MM.YYYY
5 YYYY.MM.DD
Note: It is recommended that you review “Using the Duplex Copy function” on
page 56 for specific details on using management class options.
The following information is needed to register Data Protection for Oracle with the
Tivoli Storage Manager server:
v The Data Protection for Oracle node name
This is the node name that identifies the instance on which Data Protection for
Oracle is installed. It is recommended that you use a separate and unique node
name for Data Protection for Oracle. This prevents any confusion with an
existing Tivoli Storage Manager backup-archive client on the same workstation.
v The initial password
This is the password you want to use, if a password is required.
46 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
v The policy domain to which your client node belongs.
A policy domain contains policy sets and management classes that control how
Tivoli Storage Manager manages the objects you back up. Rather than binding
Data Protection for Oracle backups to a different management class, it is
recommended that a unique policy domain be defined for Data Protection for
Oracle node names. These backups can be bound to the default management
class within this unique policy domain. Rather than binding a different
management class for Oracle backups, it is also recommended that you specify a
different domain for Oracle backups with a separate management class.
v The authority to enable compression.
The Tivoli Storage Manager administrator can specify the server to compress
files. If the Tivoli Storage Manager administrator specifies that the compression
decision belongs to the client (compression client), you must specify compression
yes in the client system options file (dsm.sys) in order for the Data Protection for
Oracle node to be able to compress objects before sending them to the Tivoli
Storage Manager server.
| v The authority to delete backup data from Tivoli Storage Manager storage.
| The Data Protection for Oracle node can only delete backed up data from Tivoli
| Storage Manager storage if the Tivoli Storage Manager administrator registers
| the node with backdelete authority. Specify the following option to allow
| backdelete authority:
| backdelete yes
| Note that when backdelete no is specified and a deletion request is made, the
| request fails and an error message displays. Therefore, specify backdelete yes for
| the object to be immediately removed from the Tivoli Storage Manager server
| when the next inventory expiration occurs. This expiration also makes the
| previously used storage space available for new use.
48 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
the name does not have to be the actual name of a Tivoli Storage Manager
server, the name must match the name specified by the servername option
in the dsm.opt file.
tcpserveraddress
Specify the TCP/IP address (in the stanza) for the Tivoli Storage Manager
| server to be used for Oracle backups. When the Tivoli Storage Manager
| server that is specified with the tcpserveraddress option uses a non-default
| port for communication, specify the correct port in the stanza with the
| tcpport option.
commmethod
Specify the communication method for Data Protection for Oracle to
communicate with the Tivoli Storage Manager server. Note that this option
requires other Tivoli Storage Manager options, depending on the
communication method you specify.
Specify this option in the Tivoli Storage Manager client user options file (dsm.opt
by default) located in the directory specified by the dsmi_orc_config option:
servername
Specify a Tivoli Storage Manager server stanza name that matches the
name specified by the servername option in your client system options file
(dsm.sys by default) that is used to contact Data Protection for Oracle for
backup services.
The FORMAT parameter in the RMAN script can also be used to assist
with object naming. For example, if the FORMAT parameters (in the
RMAN script) specified the following values for databases and logs:
format ’DB_%u_%p_%c’
format ’LOG_%u_%p_%c’
The include statement in the dsm.sys file (used by the Oracle node) would
be as follows:
INCLUDE /adsmorc/.../DB* mgmtclassnameforDBs
INCLUDE /adsmorc/.../LOG* mgmtclassnameforLogs
| Make sure the FORMAT parameter specifies a unique name for the
| backup. If the object name already exists on the Tivoli Storage Manager
| server, the backup might fail with a RC=8 error recorded in the sbtio.log
| file.
enableclientencryptkey
When enableclientencryptkey is set to yes, Data Protection for Oracle
provides 128-bit transparent encryption of Oracle databases during backup
and restore processing. One random encryption key is generated per
session and is stored on the Tivoli Storage Manager server with the object
in the server database. Although Tivoli Storage Manager manages the key,
a valid database must be available in order to restore an encrypted object.
50 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
You can specify the databases you want encrypted by adding an include
statement with the include.encrypt option in the dsm.sys file.
For example, to enable transparent encryption, set the following options in
the client system options file, dsm.sys:
1. Specify enableclientencryptkey yes.
2. Specify encryptiontype AES128 (recommended) or DES56.
3. Specify the objects to encrypt. This example encrypts all data:
include.encrypt /adsmorc/.../*
Thus, the encryption options in this client system options file, dsm.sys
would be as follows:
enableclientencryptkey yes
encryptiontype aes128
include.encrypt /adsmorc/.../*
| After a completed backup operation, view the encryption status for a
| backup object in the Tivoli Storage Manager server activity log file. Run
| the Tivoli Storage Manager server QUERY ACTLOG command in the
| Tivoli Storage Manager server administrative client window. A message
| similar to the following will be available:
| 02/04/08
| 16:23:08
| ANE4991I (Session: 7, Node: ANDREW) TDP Oracle AIX
| ANU0599 TDP for Oracle: (426106): =>() ANU2526I Backup
| details for backup piece /dp_oracle//2jj7sk9s_1_1 (database
| "testdb"). Total bytes sent: 770703360. Total processing
| time: 00:00:48. Throughput rate: 15680.00Kb/Sec.
| Compressed: Yes, 68%. Encryption: None. LAN-Free: No.
| (SESSION: 7)
||
See IBM Tivoli Storage Manager Using the Application Program Interface for
more details regarding the enableclientencryptkey option.
Note: Data Protection for Oracle stores all objects as backup objects on Tivoli
Storage Manager storage, so an archive copy group is not required, although
it can exist.
52 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
See your Tivoli Storage Manager administrator or see the Tivoli Storage Manager
Administrator’s Guide for more information on defining or updating Tivoli Storage
Manager policy domains and copy groups.
Invoking RMAN
Invoke RMAN to back up and restore an Oracle database. In this example, the
catalog database contains a registered target database. Invoke RMAN with this
command:
$> rman target xxx/yyy@target rcvcat aaa/bbb@catalog
cmdfile bkdb.scr msglog bkdb.log
Note: In the above example, RMAN creates a log file (bkdb.log) in the current
working directory. If an error occurs, you will see the error stack in the log
file.
| After a completed backup or restore operation, view the throughput rate and
| encryption status for a backup object in the Tivoli Storage Manager server activity
| log file. Run the Tivoli Storage Manager server QUERY ACTLOG command in the
| Tivoli Storage Manager server administrative client window. A message similar to
| the following will be available:
| 02/04/08
| 16:23:08
| ANE4991I (Session: 7, Node: ANDREW) TDP Oracle AIX
| ANU0599 TDP for Oracle: (426106): =>() ANU2526I Backup
| details for backup piece /dp_oracle//2jj7sk9s_1_1 (database
| "testdb"). Total bytes sent: 770703360. Total processing
| time: 00:00:48. Throughput rate: 15680.00Kb/Sec.
| Compressed: Yes, 68%. Encryption: None. LAN-Free: No.
| (SESSION: 7)
||
Script example
This backup script allocates two parallel connections to the Tivoli Storage Manager
server. The Tivoli Storage Manager server views these connections as two separate
sessions:
run
{
allocate channel t1 type ’sbt_tape’ parms
’ENV=(TDPO_OPTFILE=/ora91/scripts/tdpo.opt)’;
allocate channel t2 type ’sbt_tape’ parms
’ENV=(TDPO_OPTFILE=/ora91/scripts/tdpo.opt)’;
backup
filesperset 5
format ’df_%t_%s_%p’
(database);
Note: To back up to Tivoli Storage Manager using Data Protection for Oracle, you
must specify type ’sbt_tape’ in the RMAN script or within the global
RMAN configuration settings.
This restore script allocates one parallel connection to the Tivoli Storage Manager
server:
run
{
allocate channel t1 type ’sbt_tape’ parms
’ENV=(TDPO_OPTFILE=/home/oracle/tdpo.opt)’;
restore database;
recover database;
alter database open;
}
Notes:
1. The allocate channel entry is divided on two lines after the parms option to
accommodate page formatting.
2. The Oracle database must be in mount mode for the restore to succeed.
56 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
database for Data Protection for Oracle to use the duplex copy feature. Refer
to your Oracle documentation regarding the use of this Oracle parameter.
Considerations
The duplex copy feature does not use include statements. It only uses the
management classes specified in the tdpo.opt file.
You will receive an error message if you specify set duplex 4 in the RMAN
backup script and do not define a sufficient number of tdpo_mgmt_class
options in the tdpo.opt file.
In order to place duplicate copies on different media:
– Make sure the storage pool information for each backup copy group within
the management classes is not the same.
– Make sure backups from these different storage pools are not migrated to the
same storage pool at a later time.
Be aware that duplicate data will be sent across the network.
Be aware that if you specify set duplex 4 and allocate one channel in the RMAN
backup script, RMAN will start four sessions to the Tivoli Storage Manager
server. Likewise, if you specify set duplex 4 and allocate two channels in the
RMAN backup script, RMAN will start eight sessions to the Tivoli Storage
Manager server.
The duplex copy feature sends the backup copies simultaneously. If the backup
destination is tape, the number of sessions will be multiples of the duplex
value. As a result, make sure RMAN does not start more sessions than the
maximum mount points allowed by the Tivoli Storage Manager server. The
node definition option on the Tivoli Storage Manager server (maxnummp)
determines the maximum number of mount points a client node is allowed to
use on the Tivoli Storage Manager server during a backup operation. You can
view the maximum mount points allowed by the Tivoli Storage Manager server
for a particular node by entering the query node command from a Tivoli
Storage Manager Administrative Client prompt:
q node f=d
See the appropriate Tivoli Storage Manager Administrator’s Reference for more
information regarding this option.
Note: Make sure to use the same tdpo.opt file that was used for the original
backup. This enables the backup objects to be found on the Tivoli Storage
Manager server.
Example
To remove an old backup, issue this command from the RMAN prompt:
run
{
allocate channel for delete type ’sbt_tape’ parms
’ENV=(TDPO_OPTFILE=/orc91/scripts/tdpo.opt)’;
See the Oracle RMAN manual for more information on the change command and
its options.
58 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Chapter 5. Using the utilities
This chapter describes how to use the Data Protection for Oracle utilities (tdpoconf
and tdposync) from the command line interface. These utilities are located in the
directory where Data Protection for Oracle is installed.
v The tdpoconf utility is used for password maintenance and general Data
Protection for Oracle setup and maintenance.
v The tdposync utility is used to delete the Oracle backups on the Tivoli Storage
Manager server which are not in the RMAN catalog. This occurs when backups
have inadvertently not been deleted from the Tivoli Storage Manager server.
Password command
Use the password command to create a new password or change an existing
password on the Tivoli Storage Manager server. You are prompted to enter both
the old and new passwords when you invoke this utility.
Syntax
TDPOCONF PASSWord
installed tdpo.opt
-TDPO_OPTFILE=
pathname
Optional parameters
-TDPO_OPTFILE=pathname
This parameter specifies the fully qualified path name to the tdpo.opt file.
If you choose not to specify this option, the default path is used.
Example
This is an output example of the tdpoconf password command:
60 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
***************************************************************
* IBM Tivoli Storage Manager for Databases Utility *
* Password file initialization/update program *
* *
***************************************************************
Showenvironment command
Use the showenvironment command to query the Tivoli Storage Manager server
using the options set in –TDPO_OPTFILE, the tdpo.opt file in the default
installation directory, or the default values set by Data Protection for Oracle. The
screen output displays information about the Tivoli Storage Manager API and
Tivoli Storage Manager server. This command is useful when troubleshooting Data
Protection for Oracle setup. If, for example, the password file is not initialized
properly, tdpoconf showenvironment reports this error immediately and prevents
complications that can arise if this error were to go undetected.
Note: For initial setup, it is recommended that you direct the output to a file with
the –outfile option to ensure that the desired environment is set correctly
before using RMAN.
Syntax
TDPOCONF SHOWENVironment
installed tdpo.opt
-TDPO_OPTFILE=
pathname
-OUTfile= pathname
Optional parameters
-TDPO_OPTFILE=pathname
This parameter specifies the fully qualified path name to the tdpo.opt file.
This is the options file that is used by the utilities and the Data Protection
for Oracle library.
-OUTfile=pathname
This parameter specifies the fully qualified path name to the output file.
The formatted text of this file is the same content that appears as output to
the screen.
Example
Below is an output example of the tdpoconf showenvironment command:
| DATA PROTECTION FOR ORACLE INFORMATION
| Version: 5
| Release: 5
| Level: 1
| Sublevel: 0
| Platform: 32bit TDPO Linux86
|
| TSM SERVER INFORMATION
Note: The Server Name: value above identifies the Tivoli Storage Manager server
stanza in the dsm.sys file, not the actual name of the Tivoli Storage Manager
server.
TDPOSYNC
Attention: Deleted files and inactive files cannot be restored! When using this
utility to delete files, ensure that you do not log on under the wrong node name,
query a different database than intended, and delete files in error. Double-check
the node name listed at the top of the PICK window. See “Optional parameters”
on page 64 and “PICK Window” on page 65 for further details.
The tdposync utility checks for items on the Tivoli Storage Manager server that are
not in the RMAN catalog. This utility allows you to repair such discrepancies
between the Tivoli Storage Manager server and the RMAN catalog. By thus
removing unwanted objects in Tivoli Storage Manager storage, you can reclaim
space on the server.
When an RMAN deletion script is run, RMAN deletes entries in the recovery
catalog before confirmation from the Tivoli Storage Manager server. In cases where
objects are not found on the Tivoli Storage Manager server, RMAN tries to delete
backup sets from the Tivoli Storage Manager server and fails. However, the entries
in the RMAN catalog for these objects are still removed. When this happens,
RMAN can no longer identify these backups through the catalog even though the
file still exists on the Tivoli Storage Manager server. This utility therefore
synchronizes the contents of the servers.
Be aware that when the RMAN catalog contains backups marked as expired,
RMAN still considers these objects as existing. If tdposync is invoked against these
objects, it will recognize these objects in the RMAN catalog and on the Tivoli
Storage Manager server and consider them to be in sync. Therefore, it is necssary
to delete these objects from the RMAN catalog in order for them to be deleted
from the Tivoli Storage Manager server. Use the Oracle crosscheck command to
verify whether the backups exist. Then, use the Oracle delete expired command to
remove their record from the RMAN catalog.
62 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
5. Prompts you to do one of the following:
v Delete any files found causing the discrepancy.
v Delete all files.
v Exit the program without deleting files from the Tivoli Storage Manager
server.
Considerations
The following information must be considered before using the tdposync
command:
v Resynchronize Oracle catalogs with the target databases before running the
tdposync syncdb command. First, connect to the target database and the catalog
database. The following is an example:
$ rman target xxx/yyy@targetdb rcvcat xxx/yyy@catalogdb
When you are connected to both databases, type resync catalog at the RMAN
prompt.
| v If the information for sqlplus that you provide to tdposync is incorrect (such as
| logon, password, or connect string information), sqlplus stops at its logon
| screen. You will need to log on again at the prompt using the RMAN catalog
| owner ID, password, and connect string. For example:
| login/password@connectstring
Syntax
TDPOSYNC syncdb
installed tdpo.opt
-TDPO_OPTFILE=
pathname
1
-NUMCATalogs=
number
Optional parameters
-TDPO_OPTFILE=pathname
This parameter specifies the fully qualified path name to the tdpo.opt file.
This is the options file that is used by the utilities and the Data Protection
for Oracle library. This file contains the information for the Tivoli Storage
Manager server name and address that tdposync needs for synchronizing.
Note: For syncdb TDPO_OPTFILE, you must specify the same options file
values that were used to perform the original backup operations.
-NUMCATalogs=number
This parameter specifies the number of Oracle catalog databases that you
want to synchronize and prompts you for information for each catalog that
exists on your node. Specify this option only when you use multiple Oracle
catalogs to back up multiple target databases to the same Tivoli Storage
Manager server under the same file space, node name, and owner name.
According to the number you specify for -numcatalogs, you are prompted
for the user name, password, and connect string for each. If you do not
specify -numcatalogs, the default is 1, and you are prompted only once.
For each catalog, you are prompted for the following information:
v Catalog # User Name:
v Catalog # Password:
v Catalog # Connect String:
You are also prompted for the following date information to narrow your search:
v From Date: (MM/DD/YYYY)
v To Date: (MM/DD/YYYY)
If no dates are specified, Data Protection for Oracle displays all objects that are not
in sync.
Example
This is an output example of the tdposync syncdb command:
Catalog 1 User Name: rman
64 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
From Date (MM/DD/YYYY): 01/01/2007
PICK Window
The PICK window provides the following useful information to help you decide if
the files displayed are indeed out of synchronization with the Oracle catalog:
v The node with which you are querying the Tivoli Storage Manager server
v The date of the file backup
v The size of the backup
v The backup name (/fs//backup file name)
Attention: Use caution when selecting files for deletion. If you are unsure that
the files in question are really out of synchronization, do further research before
deleting them. Once you delete files, they cannot be restored.
Files selected for deletion are marked by a plus (+). To delete selected files:
1. Enter OK at the PICK prompt.
A warning message appears to confirm deletion of the selected files.
2. Enter Yes to delete the selected files from the Tivoli Storage Manager server.
Attention: The deletion process is irreversible. Use caution when selecting files
for deletion.
v More information about this option and the dsm.opt file is available on
page 47.
5. Change to the /usr/tivoli/tsm/client/api/bin64 directory and create a
symbolic link to /usr/tivoli/tsm/client/ba/bin/dsm.sys. Edit the dsm.sys
file to include another server stanza with the following options:
SErvername tdpo
COMMMethod TCPip
TCPServeraddress x.x.x.x
PASSWORDAccess generate
passworddir /home/<oracle user>
nodename TDPONodeName
Replace x.x.x.x with the IP address of the Tivoli Storage Manager server to
which Data Protection for Oracle will back up data. Replace <oracle user> with
the Oracle User ID of the target Oracle database instance.
v More information about the dsm.sys file, these options, and their
relationship with Data Protection for Oracle is available on page 47.
6. Register the node to the Tivoli Storage Manager server with the following
command:
REG NODE hostname_oracle password maxnummp=2
Where hostname is the name of the machine where Data Protection for Oracle
is installed and password is the password for this node.
backup
filesperset 5
format ’df_%t_%s_%p’
(database);
Note that the allocate channel entry is divided on two lines after the parms
option to accommodate page formatting.
v More information about RMAN backup scripts is available on page 55.
68 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Appendix B. Using the Tivoli Storage Manager scheduler
This section describes how to use the Tivoli Storage Manager scheduler with Data
Protection for Oracle to automate online backups of Oracle server databases. The
example illustrates the use of the Tivoli Storage Manager Version 5.5
backup-archive client scheduler.
Considerations
The Tivoli Storage Manager backup–archive client must reside on the same
machine as Data Protection for Oracle for the Tivoli Storage Manager scheduler
to function.
After Data Protection for Oracle has been registered to a Tivoli Storage Manager
server and installed on the Oracle server, perform these steps:
1. On the Tivoli Storage Manager server:
a. Define a schedule to run an AIX, HP-UX, Linux, or Solaris scheduler
backup script (schedbkdb.scr) in the policy domain to which Data
Protection for Oracle is registered.
b. Associate the Data Protection for Oracle node to the defined schedule.
2. On the machine where Data Protection for Oracle is installed:
a. Create a single dsm.sys file from which to associate nodes for your client,
Data Protection for Oracle, and scheduled backups.
b. Create the scheduler backup script (schedbkdb.scr). This is the script that
the Tivoli Storage Manager scheduler invokes directly.
c. Create a command script (mysched.scr). This is the script that contains the
Oracle environment information and invokes the RMAN backup script.
d. Create the RMAN backup script (bkdb.scr). This is the script that actually
performs the Oracle RMAN backup.
e. Start the scheduler.
Setting up a schedule
For consistency, this procedure uses specific information. However, you can define
a command file with any set of commands you choose. This allows you to use the
same command file to define schedules on other Tivoli Storage Manager servers.
All command information is presented as command-line interface entries.
2. Issue the following command to associate the Data Protection for Oracle node
to the backup schedule defined in Step 1:
define association PolicyA1 daily_orcbkup NodeA1
The following message must display before proceeding to Part II:
ANR2510I Node NodeA1 associated with schedule orc_dailybkup
in policy domain PolicyA1.
Summary:
v A backup schedule is now defined on the Tivoli Storage Manager server.
v The backup schedule will run the scheduler backup script (schedbkdb.scr),
which will run the command script (mysched.scr), which will run the RMAN
backup script (bkdb.scr) located in the /home/oracle/sched directory.
v The backup is performed once a day around 9:00 PM.
v The backup schedule can start on any day of the week.
v You can run the Tivoli Storage Manager query schedule and query
association commands to confirm that the schedule and node association are
set correctly.
It is recommended that the password expiration for the Data Protection for Oracle
node (NodeA1) be set to not expire. Otherwise the password will become out of
sync between Data Protection for Oracle and the scheduler. This can be done by
specifying passwordaccess generate. However, if passwordaccess prompt is already
specified, you can prevent password expiration by issuing the following command:
update node NodeA1 passexp=0
Scheduling Data Protection for Oracle backups with the Tivoli Storage Manager
scheduler requires special configuration issues to be addressed. This procedure
addresses this issue by creating a dsm.sys file from which to associate nodes for
your client, Data Protection for Oracle, and scheduled backups:
1. Create a dsm.sys file in the /usr/tivoli/tsm/client/ba/bin directory (if one
does not already exist) and add the following servername stanzas:
70 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
a. Add a servername stanza for the file system backups associated with your
Tivoli Storage Manager backup-archive client.
For example:
servername TSMbackup
commmethod tcpip
tcpserveraddress site.xyzinc.com
tcpport 1500
nodename client
passwordaccess generate
Replace <oracle user> with the Oracle User ID of the target Oracle database
instance.The servername TSMOracle setting must be specified in the dsm.opt
file associated with Data Protection for Oracle. The default directory
location is /usr/tivoli/tsm/client/oracle/bin64. This dsm.opt file can
have a unique name, such as dsmoracle.opt. Make sure the dsmi_orc_config
option specifies the user options file (dsmoracle.opt in Step 1b) associated
with Data Protection for Oracle. For example:
dsmi_orc_config /usr/tivoli/tsm/client/oracle/bin64/dsmoracle.opt
c. Add a servername stanza for the scheduled backups associated with Data
Protection for Oracle.
For example:
servername DPSched
commmethod tcpip
tcpserveraddress site.xyzinc.com
tcpport 1500
nodename NodeA1
passwordaccess generate
passworddir /home/<oracle user>
Replace <oracle user> with the Oracle User ID of the target Oracle database
instance.
2. Make sure there is a symbolic link to this dsm.sys file so that the file is
available to the Tivoli Storage Manager API directory (/usr/tivoli/tsm/
client/api/bin64).
3. Create the scheduler backup script (schedbkdb.scr) in the /usr/tivoli/tsm/
client/oracle/sched/ directory. This is the scheduler backup script that was
defined for the scheduler in Step 1 in “Part I: On the Tivoli Storage Manager
server” on page 70. This scheduler backup script will run the command script
(mysched.scr), which will run the RMAN backup script (bkdb.scr). This is an
example of the scheduler backup script (schedbkdb.scr):
#!/bin/ksh
su - OracleUser -c /home/oracle/sched/mysched.scr
backup
format ’df_%t_%s_%p_%u_%c’
(database); }
6. Login as the root user to the machine where Data Protection for Oracle is
installed as node name NodeA1.
7. Start the scheduler in the inittab. Use the servername parameter to specify the
correct stanza to use in the dsm.sys file:
dsmc sched -servername=DPSched
72 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Appendix C. Support information
If you have a problem with your IBM software, you want to resolve it quickly. This
section describes the following options for obtaining support for IBM software
products:
v “What to do when you encounter a problem”
v “Searching knowledge bases” on page 75
v “Obtaining fixes” on page 75
v “Receiving weekly support updates” on page 76
v “Contacting IBM Software Support” on page 76
Look for the libobk link(s) in the system's respective 32-bit or 64-bit library
directory.
c. Verify that the link points to a file that exists. For example:
$ORACLE_HOME/lib/libobk.a -> /opt/tivoli/tsm/client/oracle/bin64/libobk64.a
or
$ORACLE_HOME/lib/libobk.so -> /usr/lib/sparcV9/libobk.so
/usr/lib/sparcV9/libobk.so -> /opt/tivoli/tsm/client/oracle/bin64/libobk64.so
Make sure that the final link destination is the correct bit level and points to
a file that exists.
6. If the problem persists, gather the following information:
v A problem description file that includes the command you used and the
session output you received when the problem occurred.
Note that this command provides one previous hour of activity. Since the
activity log should be obtained for the time period immediately prior to the
failed operation until a few moments after the failed operation, you can
specify the following settings to obtain activity for the exact time of failure:
query actlog begindate=MM/DD/YYYY begintime=HH:MM:SS
v The Data Protection for Oracle trace file
To generate the Data Protection for Oracle trace file, add the following lines
in your tdpo.opt file:
tdpo_trace_flags orclevel0 orclevel1 orclevel2
tdpo_trace_file /home/oracle/rman/tdpo.out
where:
orclevel0
Traces out function exit points when errors occur.
orclevel1
Traces out normal function entry and exit points.
orclevel2
Traces out more detailed information.
74 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Note: Any path and file name can be specified for the tdpo_trace_file and
tracefile options. However, the directory must exist and have writable
rights.
To search multiple Internet resources for your product, go to this product support
web site: http://www.ibm.com/software/sysmgmt/products/support/
IBMTivoliStorageManager.html and look for the section to search the support
knowledge base. From this section, you can search a variety of resources including:
v IBM technotes
v IBM downloads
v IBM Redbooks™
v Forums and newsgroups
You can also search the IBM Tivoli Storage Manager: Problem Determination Guide for
helpful diagnostic information at this Web site: http://publib.boulder.ibm.com/
infocenter/tivihelp/v1r1
/topic/com.ibm.itsmm.doc/update/main.html
Obtaining fixes
A product fix might be available to resolve your problem. To determine what fixes
are available for your IBM software product, follow these steps:
1. Go to the IBM Software Support Web site at http://www.ibm.com/software/
support.
2. Click Downloads and drivers in the Support topics section.
3. Select the Software category.
4. Select a product in the Sub-category list.
5. In the Find downloads and drivers by product section, select one software
category from the Category list.
6. Select one product from the Sub-category list.
7. Type more search terms in the Search within results if you want to refine your
search.
8. Click Search.
9. From the list of downloads returned by your search, click the name of a fix to
read the description of the fix and to optionally download the fix.
If you experience problems with the My support feature, you can obtain help in
one of the following ways:
Online
Send an e-mail message to erchelp@ca.ibm.com, describing your problem.
By phone
Call 1-800-IBM-4You (1-800-426-4968).
Before contacting IBM Software Support, your company must have an active IBM
software maintenance contract, and you must be authorized to submit problems to
IBM. The type of software maintenance contract that you need depends on the
type of product you have:
v For IBM distributed software products (including, but not limited to, Tivoli,
Lotus®, and Rational® products, as well as DB2® and WebSphere® products that
run on Windows® or UNIX® operating systems), enroll in Passport Advantage®
in one of the following ways:
76 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Online
Go to the Passport Advantage Web site at http://www.lotus.com/
services/passport.nsf/WebDocs/
Passport_Advantage_Home and click How to Enroll.
By phone
For the phone number to call in your country, go to the IBM Software
Support Web site at http://techsupport.services.ibm.com/guides/
contacts.html and click the name of your geographic region.
v For customers with Subscription and Support (S & S) contracts, go to the
Software Service Request Web site at https://techsupport.services.ibm.com/
ssr/login.
v For customers with IBMLink, CATIA, Linux, OS/390, iSeries, pSeries, zSeries,
and other support agreements, go to the IBM Support Line Web site at
http://www.ibm.com/services/us/index.wss/so/its/a1000030/dt006.
v For IBM eServer™ software products (including, but not limited to, DB2 and
WebSphere products that run in zSeries, pSeries, and iSeries environments), you
can purchase a software maintenance agreement by working directly with an
IBM sales representative or an IBM Business Partner. For more information
about support for eServer software products, go to the IBM Technical Support
Advantage Web site at http://www.ibm.com/servers/eserver/techsupport.html.
If you are not sure what type of software maintenance contract you need, call
1-800-IBMSERV (1-800-426-7378) in the United States. From other countries, go to
the contacts page of the IBM Software Support Handbook on the Web at
http://techsupport.services.ibm.com/guides/contacts.html and click the name
of your geographic region for phone numbers of people who provide support for
your location.
You can also list all Tivoli package names with this command:
swlist | grep Tivoli
– Linux:
rpm -qa "TDP*"
rpm -qa "TIVsm-API*"
– Solaris:
pkginfo -l <Data Protection for Oracle installable file>
pkginfo -l TIVsmCapi
You can also list all Tivoli package names with this command:
pkginfo -l | grep Tivoli
Submitting problems
You can submit your problem to IBM Software Support in one of two ways:
Online
Click Submit and track problems on the IBM Software Support site at
78 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
http://www.ibm.com/software/support/probsub.html. Type your
information into the appropriate problem submission form.
By phone
For the phone number to call in your country, go to the contacts page of
the IBM Software Support Handbook at http://
techsupport.services.ibm.com/guides/contacts.html and click the name
of your geographic region.
If the problem you submit is for a software defect or for missing or inaccurate
documentation, IBM Software Support creates an Authorized Program Analysis
Report (APAR). The APAR describes the problem in detail. Whenever possible,
IBM Software Support provides a workaround for you to implement until the
APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the
IBM product support Web pages daily, so that other users who experience the
same problem can benefit from the same resolutions.
For more information about problem resolution, see Searching knowledge bases
and Obtaining fixes.
ANU0055E Write failure on license file (licensefile). ANU0103E Invalid option for the specified
Explanation: An attempt to write to the license file command:
failed. Explanation: This message displays the command that
System action: Processing ends. was entered, up to and including the option that was
User response: Make sure enough space exists on the detected as invalid for the command.
workstation to write to the license file. If enough space System action: Processing ends.
exists, run the command again. User response: Re-enter the command specifying valid
command options.
ANU0056E Data in the license file (licensefile) is not
in a valid format. ANU0104E Invalid option:
Explanation: An attempt to read information from the Explanation: This message displays the command that
license file failed. was entered, up to and including the invalid option
System action: Processing ends. that was detected.
User response: Install the product again. System action: Processing ends.
84 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
ANU0156E Could not load the Tivoli Storage ANU0200E File (filename) could not be opened for
Manager API. reading.
Explanation: The Tivoli Storage Manager API could Explanation: An attempt was made to open a file for
not be loaded. reading. This attempt failed.
System action: Processing ends. System action: Processing ends.
User response: Ensure the Tivoli Storage Manager API User response: None
is correctly installed. Run the Data Protection for Oracle
application client with the /TRACEFLAGS=API
ANU0201E File (filename) could not be opened for
/TRACEFILE=filename options and view the tracefile
writing.
to determine why it could not be loaded. Another
Explanation: An attempt was made to open a file for
possible cause is that the TSMAPI.DLL does not exist in
writing. This attempt failed.
the system directory. Re-install the Tivoli Storage
System action: Processing ends.
Manager API, if this is the case.
User response: None
ANU0167E The fully-qualified file name is too ANU0207E Directory path (directorypath) is too long.
long. Explanation: An attempt was made to use a directory
Explanation: An attempt was made to use a path that was too long. This attempt failed.
fully-qualified file name that was too long. This System action: Processing ends.
attempt failed. User response: None
System action: Processing ends.
User response: None
ANU0208E There is not enough disk space for the
operation attempted.
Explanation: An attempted operation required more
disk space than was available. The attempt failed.
System action: Processing ends.
Appendix E. Messages 85
User response: None
ANU0215E All backup objects do not have the same
management class backup copy
ANU0209E The rename of file (filename1) to destination.
(filename2) failed. Explanation: In order to maintain backup data
Explanation: An attempt was made to rename a file. integrity, multiple backup objects are sent to the Tivoli
This attempt failed. Storage Manager server within a single transaction. All
System action: Processing ends. backup objects within a single transaction are required
User response: None to have the same management class backup copy
destinations.
System action: Processing ends.
ANU0210E The Tivoli Storage Manager high level User response: Contact your Tivoli Storage Manager
qualifier is too long. server administrator.
Explanation: An attempt was made to use a Tivoli
Storage Manager high level qualifier that was too long.
This attempt failed. ANU0216E Unable to obtain space information for
System action: Processing ends. volume (volumename).
User response: None Explanation: An attempt was made to obtain space
information for a volume. This attempt failed.
System action: Processing ends.
ANU0211E The Tivoli Storage Manager low level User response: None
qualifier is too long.
Explanation: An attempt was made to use a Tivoli
Storage Manager low level qualifier that was too long. ANU0217E The Tivoli Storage Manager filespace
This attempt failed. name is invalid.
System action: Processing ends. Explanation: The filespace name or directory
User response: None delimeter is invalid.
System action: Processing ends.
User response: Check that the filespace name length,
ANU0212E The Tivoli Storage Manager filespace characters, and directory delimeters are valid.
name is too long.
Explanation: An attempt was made to use a Tivoli
Storage Manager filespace name that was too long. This ANU0218E The Tivoli Storage Manager high level
attempt failed. qualifier is invalid.
System action: Processing ends. Explanation: The high level qualifier name or
User response: None directory delimeter is invalid.
System action: Processing ends.
User response: Check that the high level qualifier
ANU0213E The maximum number of objects name length, characters, and directory delimeters are
allowed per Tivoli Storage Manager valid.
transaction is t oo small.
Explanation: In order to maintain backup data
integrity, multiple backup objects are sent to the Tivoli ANU0219E The Tivoli Storage Manager low level
Storage Manager server in a single transaction. The qualifier is invalid.
Tivoli Storage Manager server has indicated that the Explanation: The low level qualifier name or directory
maximum number of objects allowed per transaction is delimeter is invalid.
less than the minimum required by the Data Protection System action: Processing ends.
for Oracle application client. User response: Check that the low level qualifier
System action: Processing ends. name length, characters, and directory delimeters are
User response: Increase the maximum number of valid.
objects allowed per transaction on the Tivoli Storage
Manager server and retry the operation.
ANU0256E The password in your Tivoli Storage
Manager options file has expired. Please
ANU0214E The backup object’s management class change your password on the Tivoli
backup copy group does not exist. Storage Manager server using the
Explanation: The Tivoli Storage Manager server has ’change password’ command and then
indicated that the backup object’s management class either change or remove the password
backup copy group does not exist. value in your options file.
System action: Processing ends. Explanation: Your Tivoli Storage Manager password
User response: Contact your Tivoli Storage Manager has expired. You need to change your password.
server administrator. System action: Processing ends.
User response: Obtain a new password for your Tivoli
Storage Manager server; node using the change
86 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
password command or by asking your Tivoli Storage
ANU0264I Could not find the default browser
Manager Administrator to change your password.
defined. An attempt will be made to use
Microsoft Internet Explorer.
ANU0257E Your password has expired. Explanation: An attempt was made to read the
Explanation: Your Tivoli Storage Manager password registry to determine the default browser. However, a
has expired. A new password needs to be obtained. default browser is not defined. A determination will be
System action: Processing ends. made where Microsoft Internet Explorer is installed.
User response: Obtain a new password for your Tivoli System action: Processing continues.
Storage Manager node using the change password User response: It is possible that a default browser is
command or by asking your Tivoli Storage Manager not defined for the system. This is okay. An attempt
Administrator to change your password. will be made to use Microsoft Internet Explorer.
ANU0258E You did not enter a valid password. ANU0265E Could not find Internet Explorer.
Processing ends. Explanation: An attempt was made to read the
Explanation: The password that was entered was not registry to determine where Microsoft’s Internet
a valid password. Explorer was installed. This attempt failed.
System action: Processing ends. System action: Processing ends.
User response: Re-enter the command specifying a User response: Make sure that the registry is set up
valid password. correctly for Internet Explorer.
ANU0259E The password you entered for ANU0266E Could not find the Tivoli Storage
verification does not match the Manager HTML books.
password you entered for your new Explanation: An attempt was made to read the
password. Your password will not be registry to determine where the Tivoli Storage Manager
changed. books were installed. This attempt failed.
Explanation: The password you entered for System action: Processing ends.
verification of your new password does not match the User response: It may be necessary to reinstall the
new password that was entered. application client code. This will ensure that the
System action: Processing ends. registry entries are set up correctly.
User response: Try again to change your password
being sure to enter the same password for the new
ANU0267E The verify password entered does not
password and for the verification password.
match the new password entered.
Explanation: The verify password does not match the
ANU0260I Password successfully changed. new password.
Explanation: The change password command System action: Processing ends.
completed successfully User response: Retry the command with a matching
System action: Processing ends. verify password.
User response: None
ANU0300E Invalid restore type.
ANU0261I There are no backups for the server Explanation: The type of restore requested is invalid.
named servername. System action: Processing ends.
Explanation: There are no backups on the Tivoli User response: Re-enter the command specifying a
Storage Manager server for the specified server name. valid restore type.
System action: Processing ends.
User response: None
ANU0301E Invalid backup type.
Explanation: The type of backup requested is invalid.
ANU0263E Failed to start Web browser with a System action: Processing ends.
return code of returncode. User response: Re-enter the command specifying a
Explanation: An attempt was made to start the web valid backup type.
browser to view the TSM HTML b ook. This attempt
failed.
ANU351E Invalid trace keyword - ’keyword’
System action: Processing ends.
Explanation: A TRACEFLAG option in the user
User response: Start your web browser manually and
configuration file or on the command line is incorrect.
point it to bookfrm.htm in the agent htm directory.
System action: Client program did not initialize or
tracing was not enabled in the applet.
User response: Correct the value.
Appendix E. Messages 87
ANU357E Unable to open trace output file ANU385E Unable to delete symbolic link ’link’.
file-name. Explanation: Log ’linkname’ cannot be a symbolic link.
Explanation: A TRACEFILE option in the user System action: Processing stops.
configuration file or on the command line used a User response: Delete the symbolic link ’linkname’.
directory path and file-name combination to which you
do not have write access.
ANU476E program-name: cannot open file file-spec:
System action: Client program did not initialize.
error.
User response: Change the TRACEFILE value so that
Explanation: TDP cannot open the file.
it is a location to which you have write access.
System action: TDP cannot complete the requested
operation.
ANU366E Unable to close trace output file User response: Retry the operation. If the problem
file-name. continues, check with your system administrator.
Explanation: An error occurred during the closing of a
trace output file-name (for example, not enough disk
ANU487E Specifying the error log ’link’ as a
space).
symbolic link is not allowed.
System action: Processing continues.
Explanation: Error log ’linkname’ cannot be a symbolic
User response: Check the options.doc file for a
link.
description of possible causes of the error, or see your
System action: The symbolic link ’linkname’ is deleted,
system administrator.
the error log is recreated, and processing stops.
User response: Check the location of the new error
ANU367E Unable to write to trace file tracefile. log. To specify the location of the error logs, refer to the
Tracing disabled. user’s manual for the ’errorlogname’ option and
Explanation: An error occurred when writing to the ’DSM_LOG’ environmental variable.
specified tracefile.
System action: Tracing is disabled. Processing
ANU488E Initialization functions cannot open the
continues.
error log: log-name. errno = errno-value,
User response: Ensure the device that the tracefile
Explanation: The file log-name could not be opened
access is available and has sufficient space for the
during initialization. The system set the error code
tracefile. Retry the command.
errno-value. If the reason given is ″access denied,″ the
current user does not have permission to write to the
ANU368E Invalid trace file name (name too long). log in the directory specified. It is also possible that no
Explanation: A TRACEFILE option in the preferences space is available at the given log location.
files used a file name that is too long. System action: Processing terminates.
System action: Client program did not initialize. User response: Set the DSM_LOG (or DSMI_LOG)
User response: Change the file name used as the environment variable to a directory into which the
TRACEFILE so that it is equal to or less than 255 current user can write. You may also use the
characters in length. ERRORLOGNAME option to specify a file to which the
current has write permission.
ANU383E Specifying the trace file ’link’ as a
symbolic link is not allowed. ANU495E Failure writing to a Tivoli Storage
Explanation: Trace file ’linkname’ cannot be a symbolic Manager log or log-related file: file-name,
link. errno = errno-value, reason
System action: The symbolic link ’linkname’ is deleted, Explanation: A failure was encountered when writing
the trace file is recreated, and processing stops. to one of the log files or a related file named file-name.
User response: Specify the trace file location with the The system set the error code errno-value. reason is the
’tracefile’ option. system explanation of that error code. Among other
things, it is possible that no space is available at the
given log location.
ANU384E Symbolic link ’linkname’ to ’target’ was
System action: Processing terminates.
successfully deleted.
User response: Set the DSM_LOG (or DSMI_LOG)
Explanation: Log ’linkname’ cannot be a symbolic link.
environment variable to a directory with adequate
System action: The symbolic link ’linkname’ is deleted,
space to write the log data.
the log is recreated, and processing stops.
User response: Check the location of the new file. To
specify the location of log files, refer to the user’s
manual for the ’errorlogname’ option, the
’schedlogname’ option, and the ’DSM_LOG’
environmental variable.
88 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
ANU496I TDP is converting the log-file from ANU516I The Windows console event handler
continuous (pruning) mode to wrapping received a ’event’ console event.
mode. This process may take several Explanation: A console event was received by one of
minutes. the Data Protection for Oracle processes or programs.
Explanation: The log-file was previously in continouos The following events can be recevied:
mode where the only size control was through the use v Ctrl-C - This indicates either the user entered the
of ERRORLOGRETENTION or ctrl-c sequence or that one of the Windows services
SCHEDLOGRETENTION option. This is the first was stopped.
occasion where ERRORLOGMAX or SCHEDLOGMAX System action: None.
is specified for this log, so its format must be changed User response: None.
and old data saved.
System action: Transition processing continues.
User response: None. ANU517I An unexpected error was encountered.
TDP function name : function-name TDP
function : function-desc TDP return code :
ANU497I TDP is converting the log-file from TSM-rc TDP file : file-name (line-number)
wrapping mode to continuous (pruning) Explanation: None.
mode. This process may take several System action: Processing stops.
minutes. User response: Contact the TDP administrator with
Explanation: The log-file was previously in wrapping the information provided in this message.
mode where the size control was through the use of the
ERRORLOGMAX or SCHEDLOGMAX option. This is
the first occasion where ERRORLOGMAX or ANU518E Backups selected for restore must have
SCHEDLOGMAX is not specified for this log, so its the same backup location (TSM or
format must be changed and old data saved. LOCAL).
System action: Transition processing continues. Explanation: A VSS restore operation was submitted
User response: None. that specified multiple backup objects. The backup
objects chosen had different backup locations. This is
not allowed. All backup objects submitted in the same
ANU498I count log records processed. VSS restore operation must have the same backup
Explanation: This is just a progress report to let you location, either TSM or LOCAL, but not both.
know the process is still ongoing. System action: The VSS restore operation stops.
System action: Transition processing continues. User response: Retry the VSS restore operation
User response: None. specifying one backup object at a time.
ANU501E Invalid Proxy Configuration Detected: ANU519E The VSS operation failed with rc =
Target Node ’targetnode’ is not listed as a returncode.
valid node to proxy to for Node Name Explanation: There was a failure when TSM
’nodename’. performed the VSS operation.
Explanation: The proxy node configuration on the System action: The VSS operation stops.
TSM Server is not correct to support this VSS User response: Verify that the TSM Client Acceptor
operation. Daemon (CAD) is installed, configured, and running
System action: The VSS operation stops. properly on the machine. Retry the operation. If the
User response: Contact the TSM Server administrator error persists, contact your service representative.
to have the correct TSM Server GRANT PROXY
commands issued to enable proxy authority for the
nodes. If the error persists, contact your service ANU520E Failed to connect to Local DSMAGENT
representative. Node ’localdsmagentnode’ at address:port
’address:portnumber’. Verify that the TSM
Client Acceptor Daemon (CAD) is
ANU515E Invalid DSMAGENT Node installed, configured, and running
configuration found for node properly.
’dsmagentnode’. Explanation: An attempt was made to connect to the
Explanation: The DSMAGENT Node specified is not TSM Client Acceptor Daemon (CAD) running on the
configured properly. local machine. A communication error occurred when
System action: The VSS operation stops. this connection was attempted.
User response: Verify that the DSMAGENT Node System action: The operation stops.
specified is correct and that the Client Acceptor User response: In order to perform VSS operations,
Daemon (CAD) is running for the DSMAGENT Node. you must have a TSM Client Acceptor Daemon (CAD)
If the error persists, contact your service representative. and a TSM Remote Client Agent Service (DSMAGENT)
installed and configured properly. In addition, the TSM
Appendix E. Messages 89
Client Acceptor Daemon (CAD) must be running.
ANU2503E Backup object ’filespacehlll’ already exists
Verify that the TSM Client Acceptor Daemon (CAD) is
on TSM Server.
installed, configured, and running properly on the local
Explanation: The object has previously been backed
machine. If the error persists, contact your service
up to the TSM Server.
representative.
System action: Data Protection for Oracle returns to
the calling procedure.
ANU521E Pruning functions cannot open one of User response: If backing up an object, make sure
the Tivoli Storage Manager prune files: Oracle is generating a unique backup object name.
log-name. errno = errno-value,
Explanation: The file ″log-name″ could not be opened
ANU2504E Dissimilar Oracle handle
during pruning. The system set the error code
Explanation: The handle passed from Oracle is not the
errno-value. If the reason given is ″access denied,″ the
same handle that TSM passed back.
current user does not have permission to write to the
System action: The system returns to the calling
file in the directory specified. It is also possible that no
procedure.
space is available at the given file location or another
User response: Contact your system administrator.
Tivoli Storager Manager process started by different
user id is performing pruning at the same time.
System action: Pruning stops, processing continues. ANU2505I End of file reached
User response: Set the DSM_LOG (or DSMI_LOG) Explanation: End of file reached.
environment variable to a directory into which the System action: The system returns to the calling
current user can write. procedure.
User response: None.
ANU524S Error ’errtxt’ (errno=errno) occurred
trying to write to audit log ’file-name’. ANU2506E Wrong Read State
The audit log function is disabled. Explanation: The operation must be in READ state.
Explanation: There was an error encountered writing System action: The system returns to the calling
to the audit log (for example, there is not enough space procedure.
on the disk). User response: Contact TSM support.
System action: Audit logging is disabled for the rest
of the operation. The return code for the operation is
ANU2507E Runtime API version is outdated
set to 12 to indicate that the contents of the audit log
Explanation: Runtime API is lower than compile time
are incomplete.
API.
User response: If this is an out of space condition
System action: The system returns to the calling
either free up space on the volume or try to write the
procedure.
audit log to a volume with more space.
User response: Check compile time API level, obtain
same or higher level of API library.
ANU2500E Oracle passed an invalid mode
Explanation: Invalid mode passed by Oracle.
ANU2508E Wrong write state
System action: The system returns to the calling
Explanation: The operation must be in WRITE state.
procedure.
System action: The system returns to the calling
User response: Contact your system administrator.
procedure.
User response: Contact TSM support.
ANU2501E Oracle passed a null file name
Explanation: Null file name passed by Oracle.
ANU2509E Invalid flag passed
System action: The system returns to the calling
Explanation: Oracle passed an invalid flag.
procedure.
System action: The system returns to the calling
User response: Contact your system administrator.
procedure.
User response: Contact your system administrator.
ANU2502E Wrong data block size
Explanation: Wrong data block size.
ANU2510E The Caller must be a root user
System action: The system returns to the calling
Explanation: Only a UNIX root user can execute
procedure.
password
User response: Contact your system administrator.
System action: The system returns to the calling
procedure.
User response: Contact your system administrator.
90 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
ANU2511E Reduce the number of copies to that ANU2518E License file: license file not valid for this
specified in RMAN application
Explanation: The duplex copy feature has reached Explanation: The license file is not intended for this
maximum allowed copies. application.
System action: The system returns to the calling System action: The system returns to the calling
procedure. procedure.
User response: Reduce the number of backup copies User response: Reinstall the license that came with
to that allowed by RMAN. Data Protection for Oracle.
ANU2512E Could not open license file: license file ANU2519E Could not read password
Explanation: The license file could not be opened. Explanation: There is an invalid password or the
System action: The system returns to the calling password file cannot be not found.
procedure. System action: The system returns to the calling
User response: Check that the license file exists with procedure.
the correct permissions. User response: Check that password file exists and is
valid.
ANU2513E Could not read license file: license file
Explanation: The license file could not be read. ANU2521E Error opening file name. Check
System action: The system returns to the calling permissions.
procedure. Explanation: A directory could not be created.
User response: Check that the license file permissions System action: The system returns to the calling
are correct. procedure.
User response: Check that permissions allow the
creation of directories.
ANU2514E Could not write license file: license file
Explanation: The license file could not be written.
System action: The system returns to the calling ANU2522E No memory available
procedure. Explanation: There is not enough system memory to
User response: Check that the license file permissions complete the action.
are correct. System action: The system returns to the calling
procedure.
User response: Make more system resources available
ANU2515E Invalid data format in license file: license
by closing other applications, then try the action again.
file
Explanation: The license file data format is invalid.
System action: The system returns to the calling ANU2523E The Management Class does not match
procedure. Explanation: The management class for the query
User response: Reinstall the license that came with object could not be found.
Data Protection for Oracle. System action: The system returns to the calling
procedure.
User response: Contact your system administrator.
ANU2516E Bad checksum of license file: license file
Explanation: The license file has a bad checksum.
System action: The system returns to the calling ANU2525E Input date does not match expected date
procedure. format or range.
User response: Reinstall the license that came with Explanation: The input date does not match the
Data Protection for Oracle. expected date format or range.
System action: The system returns to the calling
procedure.
ANU2517E Try and Buy Evaluation period is over
User response: Check that the format and length of
for license file: license file
the date entry matches TDP_DATE_FORMAT type and
Explanation: The Try and Buy Evaluation period is
the range of the date values are valid.Valid days are:
over.
1-31Valid months are: 1-12Valid years are:1990-2089
System action: The system returns to the calling
procedure.
User response: Purchase the product or discontinue ANU2529E To Date cannot occur before From Date
use. Explanation: The specified To Date occurs before From
Date.
System action: The system returns this error.
User response: Enter a valid To Date that occurs after
the From Date.
Appendix E. Messages 91
ANU2530E Screen size is too small to accurately ANU2537E Error found while parsing options in
display the PICK window. Data Protection for Oracle options file.
Explanation: You cannot use the PICK option on a Explanation: There was an error found while parsing
workstation that has a screen smaller than 20 characters the Data Protection for Oracle options file.
across and 10 lines down. System action: The system returns to the calling
System action: The operation was not completed. procedure.
User response: Retry the operation using a User response: Check that the options and the options
workstation that has a screen with the minimum size. file are valid.
ANU2531E Could not create a temporary file name ANU2538E Error found while initializing tracing for
for Data Protection for Oracle utility Data Protection for Oracle.
Explanation: A temporary file name could not be Explanation: Error found while initializing the Data
created by the Operating System call to tempnam(). Protection for Oracle trace facility.
System action: The system returns to the calling System action: The system returns to the calling
procedure. procedure.
User response: Check with the Operating System User response: Contact your system administrator.
Vendor for specific reasons why the function call to
tempnam() could fail. Take the necessary corrective
ANU2539E Function Name: Error - string pointer is
action and try operation again.
NULL.
Explanation: A NULL pointer was passed to Data
ANU2532E Unknown Error - View the Data Protection for Oracle.
Protection for Oracle error log System action: The system returns to the calling
Explanation: There was an unknown error. View the procedure.
tdpoerror.log. User response: Contact your system administrator.
System action: None
User response: None
ANU2571E Could not load the library: library Data
Protection for Oracle
ANU2533E SQLPLUS error Explanation: Library cannot be loaded.
Explanation: The utility could not find SQLPLUS or System action: The system returns to the calling
there was a scripting error. procedure.
System action: The system returns to the calling User response: Check that the library exists.
procedure.
User response: Check that SQLPLUS is installed and
ANU2575E An error was detected while attempting
located in your search path. Verify the password.
to open the file ’filename’ for writing.
Explanation: The Data Protection for Oracle utility
ANU2534E Option file error. failed to open the file named in the error message.
Explanation: The option or option file name is invalid. System action: The system returns to the calling
System action: The system returns to the calling procedure.
procedure. User response: Check to ensure that the directory
User response: Check the tdpoerror.log file for an exists or that the directory has write permission, and
explanation of the error. that the disk is not full. Take the necessary corrective
action and try operation again.
ANU2535I File /fs/hl/ll = number bytes sent
Explanation: This is the total bytes sent to the server ANU2576E An error was detected while attempting
for that file name to open the file ’filename’ for reading.
System action: The system returns to the calling Explanation: The Data Protection for Oracle utility
procedure. failed to open the temporary file named in the error
User response: Check the TSM Server activity log. message.
System action: The system returns to the calling
procedure.
ANU2536I File /fs/hl/ll = number bytes recieved
User response: Check to ensure that the file named in
Explanation: This is the total bytes received from the
the error exists in the path specified and that the file
server for that backup file name.
named has read permissions. Take the necessary
System action: The system returns to the calling
corrective action and try operation again.
procedure.
User response: Check the TSM Server activity log.
92 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
ANU2600E There is no Registry entry for the TSM ANU2616E Empty parameter specified for option
API. ’option’ in options file ’filename’.
Explanation: The Windows Registry entry was not Explanation: The option specified must have a
found. parameter supplied.
System action: The system returns to the calling System action: The system returns to the calling
procedure. procedure.
User response: Check that the TSM API is installed User response: Ensure that a valid parameter for the
correctly. given option is entered and valid.
Appendix E. Messages 93
94 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux 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.
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.
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.
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
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.
This information is for planning purposes only. The information herein is subject to
change before the products described become available.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
96 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Trademarks
IBM, the IBM logo and the following terms are trademarks of the International
Business Machines Corporation in the United States, other countries, or both:
AIX OpenEdition
AS/400 OS/2
DB2 OS/390
DFS OS/400
DFSMS/MVS Passport Advantage
DFSMShsm pSeries
DFSMSrmm RACF
DPI Rational
Enterprise Storage Server Redbooks
ESCON RS/6000
eServer S/390
FICON SANergy
FlashCopy SecureWay
HACMP StorageSmart
Informix SystemView
iSeries Tivoli
Lotus Tivoli Enterprise Console
Lotus 1-2-3 Tivoli Management Enterprise
Lotus Approach TotalStorage
Lotus Domino TME
Lotus Notes VTAM
Magstar WebSphere
MVS z/OS
NetView zSeries
Intel, Intel Inside (logos), MMX and Pentium are trademarks of Intel Corporation
in the United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo 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.
Notices 97
98 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Index
A communication methods (continued)
Solaris SPARC 32-bit 30
dsm.sys (continued)
required options 48
accessibility x Solaris SPARC 64-bit 33 dsmi_log 44
AIX 6.1 Solaris x86 32-bit 36 dsmi_orc_config 44
options 44 Solaris x86_64 39 and the Tivoli Storage Manager
AIX 64-bit compression 49 scheduler 71
communication methods 6 conventions duplex copy
disk space requirements 6 typeface x considerations 57
hardware requirements 6 customer support overview 56
installation instructions 7 See Software Support
installation requirements 6
memory requirements 6
operating system requirements 6 E
software requirements 6 D education
archive copy group 52 Data Protection for Oracle see Tivoli technical training ix
and Oracle databases 55 enablelanfree 50
configuring 47 examples
B generating trace file 74
installation requirements
duplex copy 57
include/exclude 52
backdelete AIX 64-bit 6 invoking RMAN 55
and Data Protection for Oracle HP-UX Itanium 2 64-bit 12 removing backups 58
node 47 HP-UX PA-RISC 64-bit 9 RMAN scripts 56
and Tivoli Storage Manager Linux IA64 21 tdpoconf password command 60
policy 52 Linux on POWER 24 tdpoconf showenvironment
backup copy group values 51 Linux x86 32-bit 15 command 61
backups Linux x86_64 18 tdposync syncdb command 64
automating 69 Linux zSeries 64-bit 27 pick window 65
removing 58 Solaris SPARC 32-bit 30 Tivoli Storage Manager scheduler 69
bkdb.log 55 Solaris SPARC 64-bit 33 expiration of objects 51
bkdb.scr Solaris x86 32-bit 36
and the Tivoli Storage Manager Solaris x86_64 39
scheduler 69, 70, 72
books
installing 5
overview 2
F
see publications ix fixes, obtaining 75
recommendations 63
Recovery Manager (RMAN) 2
reporting problems 73
C supported Oracle versions 2 H
command line syntax Tivoli Storage Manager policy hardware requirements
characteristics 59 requirements 51 AIX 64-bit 6
commands version migration 3 HP-UX Itanium 2 64-bit 12
Oracle disk space requirements HP-UX PA-RISC 64-bit 9
change 58 AIX 64-bit 6 Linux IA64 21
tdpoconf password 60 HP-UX Itanium 2 64-bit 12 Linux on POWER 24
tdpoconf showenvironment 61 HP-UX PA-RISC 64-bit 9 Linux x86 32-bit 15
tdposync Linux IA64 21 Linux x86_64 18
syncdb 64 Linux on POWER 24 Linux zSeries 64-bit 27
Tivoli Storage Manager server Linux x86 32-bit 15 Solaris SPARC 32-bit 30
query actlog 74 Linux x86_64 18 Solaris SPARC 64-bit 33
query association 70 Linux zSeries 64-bit 27 Solaris x86 32-bit 36
query node 57, 74 Solaris SPARC 32-bit 30 Solaris x86_64 39
query schedule 70 Solaris SPARC 64-bit 33 HP-UX Itanium 2 64-bit
commmethod Solaris x86 32-bit 36 communication methods 12
description 49 Solaris x86_64 39 disk space requirements 12
communication methods dsierror.log hardware requirements 12
AIX 64-bit 6 problem determination 73 installation instructions 13
HP-UX Itanium 2 64-bit 12 dsm.opt installation requirements 12
HP-UX PA-RISC 64-bit 9 description 47 memory requirements 12
Linux IA64 21 problem determination 73 operating system requirements 12
Linux on POWER 24 required options 49 options 44
Linux x86 32-bit 15 dsm.sys software requirements 12
Linux x86_64 18 description 47 HP-UX PA-RISC 64-bit
Linux zSeries 64-bit 27 recommended options 49 communication methods 9
100 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
servername (continued)
and the Tivoli Storage Manager
T V
scheduler 70, 72 tcpserveraddress 49 verdeleted
set duplex 57 tdpo_date_fmt 45 and Tivoli Storage Manager
software requirements tdpo_fs 44 policy 51
AIX 64-bit 6 tdpo_mgmt_class_2 46
HP-UX Itanium 2 64-bit 12 tdpo_mgmt_class_3 46
HP-UX PA-RISC 64-bit 9 tdpo_mgmt_class_4 46
Linux IA64 21 tdpo_node 44
Linux on POWER 24 tdpo_num_fmt 46
Linux x86 32-bit 15 TDPO_OPTFILE
Linux x86_64 18 and tdpoconf password command 60
Linux zSeries 64-bit 27 and tdpoconf showenvironment
Solaris SPARC 32-bit 30 command 61
Solaris SPARC 64-bit 33 and tdposync syncdb command 64
Solaris x86 32-bit 36 example 43
Solaris x86_64 39 tdpo_owner 44
Software Support tdpo_pswdpath 44
contacting 76 tdpo_time_fmt 46
describing problems 78 tdpo_trace_file 75
determining business impact 77 tdpo.opt
receiving weekly updates 76 and version migration 3
submitting problems 78 description 43
Solaris SPARC 32-bit problem determination 73
communication methods 30 tdpoconf
disk space requirements 30 and password initialization 53
hardware requirements 30 and tdpo.opt 43
installation instructions 31 description 60
installation requirements 30 for problem determination 73
memory requirements 30 password command 60
operating system requirements 30 example 60
options 44 syntax diagram 60
software requirements 30 TDPO_OPTFILE 60
Solaris SPARC 64-bit showenvironment command 61
communication methods 33 example 61
disk space requirements 33 outfile 61
hardware requirements 33 syntax diagram 61
installation instructions 34 TDPO_OPTFILE 61
installation requirements 33 tdpoerror.log
memory requirements 33 how to specify 44
operating system requirements 33 problem determination 73
options 44 tdposync
software requirements 33 and tdpo.opt 43
Solaris x86 32-bit considerations 63
communication methods 36 description 62
disk space requirements 36 syncdb command 64
hardware requirements 36 example 64
installation instructions 37 numcatalogs 64
installation requirements 36 pick window 65
memory requirements 36 syntax diagram 64
operating system requirements 36 TDPO_OPTFILE 64
options 44 Tivoli software information center ix
software requirements 36 Tivoli Storage Manager
Solaris x86_64 functions 1
communication methods 39 management class 52
disk space requirements 39 policy requirements 51
hardware requirements 39 scheduler 69
installation instructions 40 services 1
installation requirements 39 Tivoli Storage Manager API trace file 74
memory requirements 39 Tivoli technical training ix
operating system requirements 39 trace file, generating 74
options 44 tracefile 75
software requirements 39 training, Tivoli technical ix
typeface conventions x
Index 101
102 IBM Tivoli Storage Manager for Databases: Data Protection for Oracle for UNIX and Linux Installation and User’s Guide
Printed in USA
SC32-9064-04