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
The specified Exchange environment settings file must be stored in the following folder:
Application-Agent-installation-folder\conf\exchange
If this option is omitted, the default value is used.
For details about the Exchange environment settings file, see the HP XP7 Replication Manager
Application Agent CLI User Guide.
NOTE:
The backup information in the backup catalog is managed based on using the copy group as a key.
Depending on the backup method, you might not be able to perform restoration, even though the
backup data exists on the secondary volume. For further information, see the notes on running
Application Agent in the
HP XP7 Replication Manager Application Agent CLI User Guide
.
Note the following if you use Exchange Server 2007 to perform restoration in units of Information
Stores from backup data obtained by using VSS:
When restoring backup data in units of Information Stores, if you specify both an Information Store
name and a storage group name, operations will occur as described below:
- If you specify a storage group name and an Information Store name of the same storage group, an
error will occur.
- If you specify a storage group name and an Information Store name of different storage groups,
the backup data is restored in units of storage groups and Information Stores respectively.
If you specify an Information Store name of data other than backup data obtained using VSS, an
error will occur.
If you omit an Information Store name and specify storage-group-name\, an error will occur.
When you want to specify an Information Store name, check the value displayed in
INFORMATIONSTORE of the drmexgcat command and specify exactly the same Information Store
name.
At restoration, this command dismounts all Information Stores within the storage group to which the
specified Information Store belongs.
If the restoration target disk contains Information Store files that are not restoration targets, an error
will occur.
If the restoration target disk contains data from different storage groups, an error will occur.
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Examples
• In this example, the command is used to restore, by disk resynchronization, the backup data
identified by the backup ID 0000000001:
PROMPT> drmexgrestore 0000000001 -resync
KAVX0001-I The drmexgrestore command will now start.
KAVX1805-I The information store will now be dismounted.
Storage group name = STR1
KAVX1700-I Restore processing will now start.
KAVX1701-I Restore processing has finished.
Application Agent CLI Reference Guide 209