HP P9000 Replication Manager Software 7.3.1-00 Application Agent CLI Reference Guide

This option is not available when you restore a system database (master, model, msdb, or distribution).
Note
When you specify the -nochk_host option, confirm that backup data is restored on the appro-
priate host, because the validity of the host name in the backup catalog is not checked when
restoring backup data.
-target database-name
Specify this option to restore instances containing the specified databases. The databases you specify
must be found in the backup catalog specified by the backup ID. If you specify a database not found
in that backup catalog, this extended command does not restore the database. When you want to
specify more than one database, use a comma to separate each file or directory name.
If you specify neither this option nor the -f option, this extended command restores the entire instance
specified by the backup ID.
-f database-list-file
In the same way as the -target option, specify this option to restore the instances containing the
specified databases. Unlike -target, this option uses an argument that is the name of a file that
contains a list of databases you want to restore. This list file must be created beforehand. Specify the
target-definition-file-name parameter as an absolute path.
If you specify neither this option nor the -target option, this extended command restores all the
objects contained in the instance specified by the backup ID.
-pf copy-parameter-definition-file
Specify this option to use the number of retries and the retry interval defined in the copy parameter
definition file. Specify the copy-parameter-definition-file parameter as a file name only;
do not specify the parameter as a path.
If you omit this option, the value of the RAID Manager-linkage definition file (DEFAULT.dat) is used.
The values in the RAID Manager-linkage definition file (DEFAULT.dat) are used for any parameters
that are not included in the copy parameter definition file.
You can create a copy parameter definition file by using a name of your choice. Specify the file name
by using an alphanumeric character string that is 64 bytes or less. You must save the copy parameter
definition file in the following folder:
Application-Agent-installation-directory\DRM\conf\raid
Notes
• The backup information in the backup catalog is managed based on the use of a copy group
as a key. Depending on the backup method, you might not be able to perform restoration,
even though the backup data exists on the secondary volume. For further information, see the
notes on running Application Agent in the HP P9000 Replication Manager Software Application
Agent CLI User Guide.
• If ONLINE is set in CLU_MSCS_RESTORE in the Application Agent configuration definition
file (init.conf), you can perform restoration of a user database while the cluster resources
are online by specifying the -resync option. In this case, the cluster resource that manages
the instance to be restored cannot be taken offline. However, if the restoration target is a
system database (master, model, msdb, or distribution) or a database that contains a system
database, restoration will be performed offline.
Conditions Causing an Error
This extended command fails in the following cases:
• An invalid option is specified.
Extended commands58