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:
A backup ID and the -copy_group option cannot be specified at the same time.
If neither the backup-ID option nor the -copy_group option is specified, the secondary volumes
of all copy groups managed by Application Agent will be targeted.
The RAID Manager instance used by Application Agent is specified in the RAID Manager-linkage
definition file (DEFAULT.dat) as HORCMINST=n. Of the two volumes defined as pair volumes in a
RAID Manager instance, the volume directly managed by the RAID Manager instance used by
Application Agent is the secondary volume.
When a volume is concealed and the disk configuration is rescanned, an error message indicating
that a device has been removed is recorded in the Windows event log. HP recommends that you
periodically delete error messages from the Windows event log.
In an environment with Veritas Storage Foundation, Missing is displayed for disks when volumes have
been concealed for some of the disks in the disk group. Conceal volumes also for copy groups with
disks displayed as Foreign or Online.
If this command is executed with the -detach option specified, take the physical volume offline from
all applications (close the volume). If you leave the volume online, the physical volume will be forcefully
concealed from the server even if applications are being used, which might result in unexpected
application problems.
If the local volume is not mapped to the physical volume because, for example, the copy group is
concealed, the following limitations apply:
- When the command is executed with the -sigview option specified, the current disk signature
cannot be viewed. The output result of the command is displayed as --------.
- When the command is executed with the -sigset option specified, the disk signature cannot be
updated.
To display and update the current disk signature, the copy group must be displayed and the local
volume must be mapped to the physical volume.
If the disk signature is updated with the -sigset option specified, execute the command again with
the -sigview option specified and make sure that the disk signature has been updated properly.
Note that if the updated disk signature already exists on another volume, the disk signature might be
updated to a different disk signature set by Windows. If this happens, execute the command by
specifying both the -sigset option and the copy group of the physical volume whose disk signature
you want to update. Update the disk signature to a different value, making sure to avoid duplicating
another disk signature.
If an attempt to update the disk signature is made with the -sigset option specified when the disk
signature format is different from the disk partition style, the KAVX5170-E error message is displayed
and the command will terminate with an error.
If this command is executed with both the -sigview option and backup-ID specified, and the
disk signature format registered in the backup catalog is different from the current disk partition style,
the KAVX5171-E error message is displayed and the command will terminate with an error.
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Basic commands118