PowerProtect Database Application Agent 19.13 Installation and Administration Guide

Adding DD systems to the lockbox for Application Direct operations

Before you run the ddbmadmin -P -z <configuration_file> command, the configuration file must exist and contain the mandatory parameter settings. For example, the following parameters are set in the [PRIMARY_SYSTEM] section of the configuration file.

DDBOOST_USER=dduser1
DEVICE_HOST=magni
DEVICE_PATH=/hermes-ddboost

You can optionally register a secondary DD system to be used for restores when the primary system is unavailable. In this case, the [SECONDARY_SYSTEM] section of the configuration file must also contain the parameter settings for the secondary system. For example:

DDBOOST_USER=dduser2
DEVICE_HOST=telly
DEVICE_PATH=/windows-poseidon-boost

To register the secondary system, the primary system parameters must be in the configuration file.

Optionally, you can set LOCKBOX_PATH in the configuration file to a nondefault lockbox location. Setting up the configuration file provides details about setting parameters in the configuration file.

Based on the configuration file settings, the ddbmadmin -P -z <configuration_file> command prompts for the required passwords for the primary and secondary systems. The command verifies the passwords by logging in to the systems, encrypts the passwords, and stores the encrypted passwords in the lockbox.

For example, the configuration file contains the following parameter settings:

[GENERAL]
LOCKBOX_PATH=/tmp/lb

[PRIMARY_SYSTEM]
DDBOOST_USER=dduser1
DEVICE_HOST=magni
DEVICE_PATH=/hermes-ddboost

[SECONDARY_SYSTEM]
DDBOOST_USER=dduser2
DEVICE_HOST=telly
DEVICE_PATH=/windows-poseidon-boost

The ddbmadmin -P -z <configuration_file> command displays the following prompts and information:

# ddbmadmin -P -z /opt/dpsapps/dbappagent/config/ddbda.cfg

Performing the registration of the device host 'magni' for DD Boost user 'dduser1'.
Enter password:
Confirm password:
Logging in to the device host 'magni' with DD Boost credentials.
Logging in to the device host 'magni' with DD Boost credentials was successful.

Continue with the registration of the secondary device host 'telly' for DD Boost user 'dduser2'? [y/n]: y
Performing the registration of the device host 'telly' for DD Boost user 'dduser2'.
Enter password:
Confirm password:
Logging in to the device host 'telly' with DD Boost credentials.
Logging in to the device host 'telly' with DD Boost credentials was successful.

Lockbox directory is '/tmp/lb'.
Device host 'magni' for DD Boost user 'dduser1' has been registered in the lockbox.
Device host 'telly' for DD Boost user 'dduser2' has been registered in the lockbox.