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

NOTE:
This command cannot be applied to the system databases (master, msdb, model, tempdb, and
distribution).
After a database has been restored, the log backup for different recovery paths are mixed and
displayed.
For the instance that is the target of this command, if the drmsqlbackup command of Application
Agent 6.3.0-00 or later has been executed for the instance, you can back up the transaction logs
entries associated with a backup ID, regardless of whether the backup catalog exists.
If the transaction log of SQL Server is backed up from any product other than Application Agent
before Application Agent executes the log backup of SQL Server, LAST-FULL-BACKUP-TIME
indicates the time at which the backup was executed from the product.
To associate a backup ID with a transaction log backup by using this command when the backup
catalog does not exist, all of the following conditions must be satisfied:
- The drmsqlbackup command in Application Agent 6.3.0-00 or later is used to back up the target
instance. Note that if the drmsqlbackup command in Application Agent 6.3.0-00 or later has not
been used to back up the target instance (for example, when specific databases only were backed
up with the -target option), the backup catalog for the target database (created by any version of
Application Agent) will exist when the drmsqlbackup command of Application Agent 6.3.0-00 or
later is executed.
- None of the following options are specified for the drmsqllogbackup command: -no_cat, -v,
-lsn, or -d
- An instance name is specified for the drmsqllogbackup command.
If you have deleted an instance, and then registered it again with the same instance name, you need
to create a backup catalog with the drmsqlbackup command before executing the
drmsqllogbackup command. If you execute the drmsqllogbackup command without creating a
backup catalog, the database name before the re-registration of the instance will be the target of
transaction log backup.
You have to back up a transaction log of the SQL Server database from Application Agent. If you
back up the transaction log from software other than Application Agent, the log sequence number
for the starting point of recovery for the values from FIRST-LSN to LAST-LSN might not be included.
In this case, an attempt to recover from Application Agent will fail because the log sequence number
for the starting point cannot be identified.
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Examples
• In this example, the command is used to back up the transaction log file of the instance DEFAULT:
PROMPT> drmsqllogbackup DEFAULT
• In this example, the command is used to display information on the backups of the transaction log
backup files with backup ID 0000000020 and with a log backup ID from 0001 to 0003:
Basic commands172