HP XP P9000 Replication Manager Software 7.5.0-00 Application Agent CLI Reference Guide (TB584-96072, July 2013)

If the target data has been backed up by the EX_DRM_TAPE_BACKUP extended command with the
-raw option specified, this extended command executes restore processing normally even when this
option is omitted. If this option is specified when the target data was backed up without the -raw
option specified, an error occurs for this extended command.
-force
Specify this option to forcibly mount the secondary volume. If you specify this option and the copy
group name of the primary volume obtained during backup processing on the file server (or the
database server) matches the file server (or the database server) information, the extended command
forcibly mounts the secondary volume, even if the LDEV or SERIAL number does not match.
If you omit this option, this extended command terminates with an error without mounting if the
following condition also holds: the copy group name, LDEV number, and SERIAL number of the primary
volume, which were obtained when the file server or database server was backed up, do not match
the information on the file server or database server.
Specify this option when you need to forcibly mount a secondary volume by using only the copy group
name of the primary volume as a key. Examples include cases when the secondary volume is to be
replaced because of a failure or other reason, or when an LDEV number or SERIAL number was
changed. Data might be corrupted if you specify this option for a normal backup operation.
-bup_env configuration-definition-file-name
Specify this option if you want to use a startup parameter in a user-created configuration definition
file when backing up to or restoring from a tape device.
If you omit this option, the default configuration definition file is used. As such, you will need to create
the default configuration definition file in advance.
Create the configuration definition file in the same directory as the default configuration definition
file. For further information, see the description of configuration definition file creation in the HP P9000
Replication Manager Software Application Agent CLI User Guide.
Note
The value of NBU_MASTER_SERVER in the configuration definition file must be the same as the
value that was used during the backup.
The specified configuration definition file name must fulfill the following requirements:
Maximum number of characters (total length of the directory name and file name): 255 bytes
Available characters: Characters that can be used for file names in Windows
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Conditions Causing an Error
This extended command fails in the following cases:
• An invalid option is specified.
• The system cannot acquire information from the definition file linked to the operation ID.
• A specified Application Agent command option cannot be specified as an extended command
option.
• The system cannot acquire information from the backup ID file.
• A command executed inside the extended command encounters an error.
Extended commands46