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
2. The command confirms that the file system has been unmounted, and then resynchronizes the
disks by restoring the backup data from the secondary volume to the primary volume.
3. The command mounts the file system again.
The following explains the command processing for restoration in a cluster configuration:
1. The command automatically takes the disk resource offline when the disk resource in the file
system to be restored is brought online.
If an attempt to take a disk resource offline fails, the command displays an error message and
restoration processing fails.
When the disk resource has already been taken offline, processing proceeds to the next step.
2. The command confirms that the disk resource has been successfully taken offline, and then resyn-
chronizes the disk by restoring the backup data from the secondary volume to the primary volume.
3. The command brings the disk resource online.
In a Microsoft Cluster Service or Windows Server Failover Clustering environment, you can restore
a volume within a cluster group while the cluster resources are online. To enable this, make sure that
CLU_MSCS_RESTORE is set to ONLINE in the Application Agent configuration definition file
(init.conf).
Restoration overwrites the entire primary volume with the entire secondary volume that contains a
backup of the primary volume. Therefore, additions and changes to the primary volume after the
backup was created are not applied.
Before executing this command, all application software using the volume to be restored must be
stopped. The volume being used by the operating system cannot be restored.
This command should be used to restore the primary volume to the secondary volume. This command
should not be used when data is being backed up from the secondary volume to a tape device with
the drmmediabackup command, when data is being restored from a tape device to the secondary
volume with the drmmediarestore command, or when the secondary volume is being mounted
with the drmmount command.
If the partition style of the physical disk is changed after a backup, and the command is then executed,
the command result will vary as described in the following table.
Table 29 Physical disk partition style and command execution results
Command execution resultAfter a backupBefore a backup
Command statusSecondary volumePrimary volumePrimary volume
Normal terminationMBR disk
MBR disk
MBR disk
Error message (KAVX5171-E or
KAVX5137-E)
After resynchronizing
#1
GPT disk
Error message (DRM-10337)
Before resynchronizing
#2
MBR disk
GPT disk
Error message (DRM-10337)
Before resynchronizing
#2
GPT disk
Error (DRM-10337 message)
Before resynchronizing
#2
MBR diskMBR diskGPT disk
Basic commands100