Required options

Specify the required options in the Tivoli Storage Manager client system options file dsm.sys by default in the directory where the Tivoli Storage Manager API is installed.

Specify the required options in the Tivoli Storage Manager client user options file dsm.opt by default, in the directory that is specified by the dsmi_orc_config option.

nodename

Specify the Data Protection for Oracle node name that is used during operations with the Tivoli Storage Manager server. The node name can contain a string of 1 - 64 characters.

To restore data from one Oracle server to another with Data Protection for Oracle, make sure that the value of the nodename option in the dsm.opt file on the target Oracle server equals the value of the nodename option in the dsm.opt file on the source Oracle server. Data Protection for Oracle, the Tivoli Storage Manager backup-archive client, and the Tivoli Storage Manager API must be at the same levels on both the source Oracle server and the target Oracle server. If there is a password that is associated with the nodename option in the dsm.opt file on the target Oracle server, use the tdpoconf utility to generate the local password file when the value of the nodename option changes.

passwordaccess

Specify passwordaccess generate. This option allows the Tivoli Storage Manager API to manage all password actions after the password is created with the tdpoconf password command. The Tivoli Storage Manager API saves the current encrypted password in the Windows registry and automatically generates a new password when the current password expires. This method of password management is useful when you are running unattended scheduled backups because it ensures that the backup never fails with an expired password.

Specify whether you want Data Protection for Oracle or the Tivoli Storage Manager API to manage the password. You can specify one of the following values:

prompt

Data Protection for Oracle manages the password as the default. When you specify passwordaccess prompt in the dsm.sys file, you can optionally set the following values in the tdpo.opt file:

tdpo_node <node name>
tdpo_owner <tdpo owner name>
tdpo_pswdpath (optional) <path to password file>

After you specify these values, use the tdpoconf password command as root user to create the password and password file TDPO.nodename on the local system. When passwordaccess prompt is specified, the user must be aware of the password expiration date. A backup failure might occur if the password is allowed to expire. To allow the Tivoli Storage Manager API to manage the password, specify passwordaccess generate.

generate

The Tivoli Storage Manager API manages all password actions after the password is created with the tdpoconf password command. The Tivoli Storage Manager API stores and manages the password and automatically generates a new password when the current password expires. This method of password management is useful when you are running unattended scheduled backups because it ensures that the backup never fails with an expired password. When you are specifying passwordaccess generate, set the following values in the dsm.sys file:

passwordaccess generate
passworddir <directory owned and writable by Oracle owner>
nodename <node name>

However, do not specify the following options in the tdpo.opt file when you are specifying passwordaccess generate:

• tdpo_node
• tdpo_owner
• tdpo_pswdpath

After you specify passwordaccess generate and the other values in the dsm.sys file, run the tdpoconf password command as the Oracle user to create the encrypted password in the TSM.PWD file.

servername

Specify the name that you want to use to identify a stanza that contains the options that are used for connecting to the Tivoli Storage Manager server. The name must match the name that is specified by the servername option in the dsm.opt file. Note, the name does not have to be the actual name of a Tivoli Storage Manager server.

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.

Specify the TCP/IP address for the Tivoli Storage Manager server to be used for Oracle backups.

commmethod

Specify the communication method for Data Protection for Oracle to communicate with the Tivoli Storage Manager server. Note, this option requires other Tivoli Storage Manager options, depending on the communication method you specify.

Required option in the dsm.opt file