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
Description
This extended command backs up a file system from the primary volume to the secondary volume;
the file system has the operation ID specified by executing the drmfsbackup command. At this time,
the EX_DRM_FS_BACKUP command generates a backup ID.
Prerequisites
The prerequisite for executing this extended command is as follows:
• An operation definition file linked to the specified operation ID has been provided.
Arguments
operation-ID
A character string that uniquely identifies the operation to be performed. Information in the operation
definition file corresponding to the specified operation ID is used when executing the extended
command.
-mode online
Specify this option to perform online backup. The online backup method backs up a file system without
unmounting it.
If you specify online backup for a file system, this extended command only synchronizes the file system
before the online backup. To ensure consistency in the backup data, you need to suppress the updating
of data before backup processing.
Even if you omit this option, an online backup is the default.
-mode cold
Specify this option to perform cold backup.
Use a cold backup for a mounted file system. When executed, this extended command unmounts the
specified file system and backs up the volume in offline mode. After backup processing has finished,
the command mounts the file system again. If unmounting of the file system fails, the command displays
an error message and cancels backup processing. If the target volume has already been unmounted,
the command cancels backup processing.
If executed on a server with a cluster configuration, this extended command takes the target disk
resource offline instead of unmounting the file system, and then backs up the volume. When backup
processing is completed, the command brings the target disk resources online again.
Backup processing is canceled if the command is executed in the following cases:
• An attempt to take the disk resource offline fails.
• The disk resource is already offline.
-mode vss
Specify this option to perform VSS backup.
To use this option, the Protection Manager service must be running on the backup server.
-comment backup-comment
Specify this option to register a backup comment in the backup catalog. The conditions for specifying
a value in the backup-comment parameter are as follows:
• The value must be 64 bytes or less.
• The value can include alphanumeric, reserved, one-byte space, and multi-byte characters.
Extended commands16