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

To clear the cache of the secondary volume when usual operation is in the split state:
EX_DRM_CACHE_PURGE operation-ID
{ -cg copy-group | -cg_file copy-group-list-file }
Description
This extended command sequentially executes the drmmount and drmumount commands to clear
the cache of the secondary volume.
When usual operation is in the pair status, the cache of the secondary volume for the specified copy
group is cleared based on the backup ID created when data is backed up from the primary volume
to the secondary volume. When usual operation is in the split state, you need to specify the copy
group to clear the cache of the secondary volume because the cache needs to be cleared before the
backup.
Prerequisites
The prerequisites for executing this extended command are as follows:
• An operation definition file linked to the specified operation ID has been provided.
• During ordinary paired operation, the file system or the database has been backed up to a sec-
ondary volume by one of the following extended commands, and a backup ID record file has
been generated:
• 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
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 to clear the cache of
the secondary volume. When the copy group to be used for the next backup can be identified, specify
that copy group. When the copy group to be used for the next backup cannot be identified, specify
all copy groups.
-cg_file copy-group-list-file
When usual operation is in the split state, use an absolute path to specify the copy-group list file that
records the copy group for which you want to clear the cache of the secondary volume. Use this
option if you want to clear the caches for many copy groups at the same time. When the copy group
to be used for the next backup can be identified, specify that copy group. When the copy group to
be used for the next backup cannot be identified, specify all copy groups.
Application Agent CLI Reference Guide 37