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
Arguments
-copy_group copy-group-name
Specify the name of the copy group you want to lock or unlock.
You can confirm that the logical volumes are the same by executing the drmfsdisplay command
and checking the items listed for LVM-DEVICE.
In environments where one logical volume group comprises multiple copy groups, if the multiple
generation backup function is used, the number of generations of all copy groups comprising the
logical volume group must match. If the copy group generations do not match, backup generation
management cannot be performed correctly in Application Agent.
-mode { lock | unlock }
Specify whether to lock or unlock the copy group. To lock the copy group, specify lock. To unlock
the copy group, specify unlock.
-backup_id backup-ID
Specify the backup ID associated with the copy groups you want to lock or unlock. By specifying a
backup ID, you can lock or unlock all the copy groups used for the backup identified by the specified
ID at the same time. Specify the backup ID created when the backup was performed from the primary
volume to the secondary volume.
To check backup IDs, execute either of the following commands, according to what was backed up:
• When the backup is of a file system, use the drmfscat command.
• When the backup is of an SQL Server database, use the drmsqlcat command.
• When the backup is of an Exchange database, use the drmexgcat command.
You cannot specify a backup ID that was created when a backup was performed from the secondary
volume to a tape device. (You can use the drmtapecat command to check such a backup ID.) If
such an ID is specified, a command error occurs.
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Examples
• In this example, the command is used to display a listing of lock information for each copy group:
PROMPT> drmcgctl
COPY GROUP LOCK STATUS BACKUP-ID
VG01,dev01 LOCKED 0000000001
VG01,dev02 LOCKED 0000000001
VG01,dev03 UNLOCKED
VG02,dev01 UNLOCKED
• In this example, the command is used to unlock the copy group VG01,dev01:
PROMPT> drmcgctl -copy_group VG01,dev01 -mode lock
• In this example, the command is used to unlock the copy group VG01,dev01:
Application Agent CLI Reference Guide 107