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 restore backup data in units of Information Stores (Exchange Server 2010 or Exchange Server
2013):
drmexgrestore backup-ID -resync
[ -target Information-Store-name,… | -f target-definition-file-name ]
[ -force ] [ -recovery ]
[ -pf copy-parameter-definition-file ]
[ -vf VSS-definition-file-name]
[ -ef Exchange-environment-setting-file-name ]
Description
The drmexgrestore command performs from the secondary volume, use disk resynchronization to
restore the backup data specified by the backup ID to the primary volume.
When restoring the results of the VSS backup, the Protection Manager service must be running on the
backup server.
If a database comprises several volumes, all volumes will be restored in order.
The following explains the command processing for restoration in a non-cluster configuration.
1. If the restored database was mounted, the database will be unmounted automatically.
If the unmount of the file system fails, an error message will be displayed, and restoration pro-
cessing error occurs.
2. After the database is stopped properly, and the file system confirms that unmount was successful,
the backup data will be restored from the secondary volume to the primary volume by disk resyn-
chronization.
3. If the file system was unmounted in step 1, the file system will be mounted.
If the file system was already unmounted in step 1, the file system will not be mounted.
4. The database unmounted in step 1 will be mounted.
The following explains the command processing for restoration in a cluster configuration. For this type
of restoration, the cluster group containing the storage groups to be restored must be online. If
restoration is performed while the cluster group is not online, a restoration error occurs. Because the
cluster resources containing the storage groups are offline after restoration, the restored storage groups
are temporarily unusable.
1. The disk resources for the storage groups to be restored are automatically set offline.
If one or more cluster resources depend on a disk resource that is set offline here, these cluster
resources are also set offline automatically. If the command is unable to set the disk resources
offline, it outputs an error message and a restoration processing error occurs.
2. The command verifies that the disk resources have been normally set offline, and then restores
backup data from the secondary volume to the primary volume by resynchronizing the disk.
3. The disk resources are set online.
If one or more cluster resources have been set offline together with the disk resources, these cluster
resources are also set online here.
If ONLINE is set in CLU_MSCS_RESTORE in the Application Agent configuration definition file
(init.conf), restoration can be performed while the cluster resources are online.
In restoration, data on the primary volume is overwritten by the disk image of the secondary volume
at the time backup is performed. Therefore, data on the primary volume that was created or updated
after the backup is invalid.
Basic commands206