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
If all copy groups have been used for backup processing, the command specifies the oldest copy
group used for backup processing.
Prerequisites
The prerequisites for executing this extended command are as follows:
• The operation definition file corresponding to the specified operation ID has been created.
• The copy-group list file has already been created when copy groups are resynchronized by using
the copy-group list file.
• When usual operation is in the pair status, the file system or the database has been backed up
to the secondary volume by using the commands below, and the backup ID file has already been
created.
• When backing up a file system, use the EX_DRM_FS_BACKUP command.
• When backing up an SQL Server database, use the EX_DRM_SQL_BACKUP command.
• When backing up an Exchange database, use the EX_DRM_EXG_BACKUP command.
Arguments
Specify the arguments of this extended command in the following order: operation-ID, -cg
copy-group, -cg_file copy-group-list-file, -copy_size copy-track-size.
operation-ID
A character string that uniquely identifies the operation to be performed. Information in the operation
definition file linked to the specified operation ID is used when executing an extended command.
-cg copy-group
When usual operation is in the split state, specify the name of the copy group you want to
resynchronize. Specify the copy group to be used at the next backup.
-cg_file copy-group-list-file
When usual operation is in the split state, specify the absolute path of the copy-group list file that
contains the copy group you want to resynchronize. Use this item if you want to resynchronize many
copy groups at once. Specify the copy group to be used at the next backup.
-copy_size copy-track-size
For copy-track-size, specify a numeric value in the range from 1 to 15 as the copy track size
to be used for copy group resynchronization. If you do not specify this option, the extended command
uses the copy track size specified in the DRM_COPY_SIZE environment variable of Application Agent.
-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 in the RAID Manager-linkage definition file (DEFAULT.dat) is used.
The values in 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 to the following location:
Application-Agent-installation-directory\DRM\conf\raid
Application Agent CLI Reference Guide 35