HP XP7 Replication Manager Application Agent CLI Reference Guide (TK981-96014, May 2014)
Table Of Contents
- Application Agent CLI Reference Guide
- Preface
- 1 Extended commands
- Overview of extended commands
- Before reading the extended command descriptions
- Extended command specifications (File system backups)
- Extended command specifications (Common commands)
- EX_DRM_BACKUPID_SET (Generates a backup ID file)
- EX_DRM_CG_DEF_CHECK (Checks the contents of a copy-group list file)
- EX_DRM_DB_EXPORT (Exports backup information to a file)
- EX_DRM_DB_IMPORT (Imports backup information from a file)
- EX_DRM_FTP_GET (Acquires a backup information file from the backup server)
- EX_DRM_FTP_PUT (Transfers a backup information file to the backup server)
- EX_DRM_HOST_DEF_CHECK (Checks the contents of a host environment settings file)
- EX_DRM_RESYNC (Resynchronizes a copy group)
- Extended command specifications (Tape-related commands)
- Extended command specifications (SQL Server database backups)
- EX_DRM_SQL_BACKUP (Backs up an SQL Server database)
- EX_DRM_SQL_DEF_CHECK (Checks the contents of an operation definition file and automatically creates a temporary directory)
- EX_DRM_SQL_RESTORE (Restores an SQL Server database backup to the primary volume)
- EX_DRM_SQL_TLOG_BACKUP (Backs up the transaction log of the SQL Server)
- EX_DRM_SQLFILE_EXTRACT (Deploys SQL Server metafiles to the folder to be backed up to a tape device)
- EX_DRM_SQLFILE_PACK (Saves SQL Server metafiles)
- Extended command specifications (Exchange database backups)
- EX_DRM_EXG_BACKUP (Backs up an Exchange database)
- EX_DRM_EXG_DEF_CHECK (Checks the contents of an operation definition file and automatically creates a temporary directory)
- EX_DRM_EXG_RESTORE (Restores an Exchange database backup to the primary volume)
- EX_DRM_EXG_VERIFY (Verifies the consistency of an Exchange database)
- 2 Basic commands
- List of basic commands
- Before reading the basic command descriptions
- Basic command specifications (File system backups)
- Basic command specifications (Common commands)
- drmappcat (Views catalog information on a host)
- drmcgctl (Locks or unlocks a copy group)
- drmclusinit (Registers the parameters for the cluster software)
- drmdbexport (Exports backup information to a file)
- drmdbimport (Imports backup information from a file)
- drmdevctl (Conceals and reveals a physical volume)
- drmhostinfo (Displays host information)
- drmresync (Resynchronizes copy groups)
- Basic command specifications (Tape-related commands)
- drmmediabackup (Backs up data from a secondary volume to a tape device)
- drmmediarestore (Restores data from a tape device to a secondary volume)
- drmmount (Mounts a secondary volume)
- drmtapecat (Displays or deletes backup information in a backup catalog)
- drmtapeinit (Registers parameters for a backup management product)
- drmumount (Unmounts secondary volumes)
- Basic command specifications (Utility commands)
- Basic command specifications (SQL Server database backups)
- drmsqlbackup (Backs up an SQL Server database to a secondary volume)
- drmsqlcat (Displays backup information for an SQL Server database)
- drmsqldisplay (Displays or updates information for an SQL Server database)
- drmsqlinit (Registers parameters for SQL Server)
- drmsqllogbackup (Backs up the transaction log of an SQL Server)
- drmsqlrecover (Recovers restored SQL Server databases)
- drmsqlrecovertool (Recovers restored SQL Server databases via a GUI)
- drmsqlrestore (Restores SQL Server databases from backups to a primary volume)
- Basic command specifications (Exchange database backups)
- drmexgbackup (Backs up an Exchange database)
- drmexgcat (Displays backup information for an Exchange database)
- drmexgdisplay (Displays or updates information for an Exchange database)
- drmexgrestore (Restores an Exchange database backup to the primary volume)
- drmexgverify (Verifies the consistency of an Exchange database)
- 3 Support and other resources
- Index
A hyphen (-) cannot appear as the first character in the backup comment. If you specify two consecutive
double quotation marks ("") after the -comment option, no backup comment will be registered in
the backup catalog.
-rc name-identifying-the-generation
Use this option to specify the name identifying the generation of the copy group to be backed up.
Execute the drmsqldisplay command with the -cf option specified, and then specify a value for
the displayed GEN-NAME. For single volumes, a hyphen (-) appears. In this case, the -rc option
cannot be specified.
Always specify this option when backing up from a primary volume to a secondary volume on the
remote side. If you omit this option, the secondary volume on the local side is backed up.
If you omit the name-identifying-the-generation parameter, the secondary volume that has
the smallest value among the generation numbers on the remote side becomes the backup destination.
In this case, the generation number is remote_n, where n is the smallest generation number.
-pf copy-parameter-definition-file
Specify this option to use the number of retries and 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 in 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
-script user-script-file-name
Specify this option to execute a user script. Specify user-script-file-name as an absolute path.
The conditions for specifying a value in the user-script-file-name parameter are as follows:
• The value must be 255 bytes or less.
• The value can include alphanumeric, one-byte space, and multi-byte characters.
• The value is case sensitive.
• If the value contains space characters, the entire parameter must be enclosed in double quotation
marks (").
• The following reserved characters cannot be used in the parameter: \ / : * ? | < > "
If you specify LOCAL_BACKUP=NO in the user script file, an error will occur when the command is
executed. For details about creating user script files, see the HP XP7 Replication Manager Application
Agent CLI User Guide.
If you specified LOCATION=REMOTE in the user script file, you must also specify the -s option.
-s backup-server-name
Specify this option to connect to a remote backup server to perform a backup. Specify the
backup-server-name parameter by using the host name or the IP address of the backup server.
Specify the host name by using a character string that is 255 bytes or less. You can specify the IP
address in IPv4 or IPv6 format.
-auto_import
Application Agent CLI Reference Guide 51