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
If you omit this option, online backup is assumed.
-mode vss
Specify this option to perform a VSS backup.
To use this option, the Protection Manager service must be running on the backup server.
-rc name-identifying-the-generation
Use this option to specify the name identifying the generation of the copy group to be backed up.
Execute the drmfsdisplay command with the -cf option, and specify the displayed GEN-NAME
value. In a single volume, a hyphen (-) appears. In this case, you cannot specify the -rc option.
Always specify this option when backing up from a primary volume to a secondary volume on the
remote side. If this option is omitted, the secondary volume on the local side is backed up.
When you omit name-identifying-the-generation, the secondary volume that has the smallest
value among the generation numbers on the remote side becomes the backup destination. In this
case, the generation number is remote_n, where n is the smallest generation number.
-pf copy-parameter-definition-file
Specify this option when using the number of retries and the retry interval defined in the copy parameter
definition file. Specify only the file name, without specifying the path.
When you omit this option, the value of the RAID Manager-linkage definition file (DEFAULT.dat) is
used. The DEFAULT.dat values are also used for parameters not specified in the copy parameter
definition file.
Create the copy parameter definition file with an arbitrary name in the location below. Specify the
file name by using an alphanumeric character string that is 64 bytes or less.
Application-Agent-installation-directory\DRM\conf\raid
-mode cold
Specify this option to perform a cold backup.
You can perform a cold backup only for a mounted file system. The command unmounts the file system
and performs an offline backup for the volumes containing the file system. When the backup is finished,
the command mounts the file system again. If the command cannot unmount the file system, the
command displays an error message and cancels backup processing. If the volume to be backed up
has been unmounted, the command cancels backup processing.
When the command is executed on a server in a cluster configuration, instead of unmounting the file
system, the disk resource to be backed up is taken offline to back up the volume. The disk resource
is brought online after the backup is finished.
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.
-comment backup-comment
Specify this option to register a backup comment in the backup catalog.
The backup-comment value can be a string of up to 64 bytes consisting of alphanumeric, special,
one-byte space, and multi-byte characters. The backup comment is case sensitive. When a special
character or a one-byte space character is used, the entire backup-comment string must be enclosed
in double quotation marks ("). If the backup-comment string contains a special character but is not
enclosed in double quotation marks, the special character is not properly handled as a part of the
backup-comment string and is parsed as a special character.
Basic commands86