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
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
-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.
The following special characters cannot be used for backup comments:
\ / ` | < > " * ? & ; ( ) $
Note that the first character must not be a hyphen (-). If you specify two double quotation marks after
the -comment option, as in -comment "", no backup comment will be registered in the backup
catalog.
-script user-script-file-name
Specify this option to execute a user script. Use an absolute path to specify
user-script-file-name. Conditions for specifying user-script-file-name are as follows:
• Maximum number of bytes: 255
• Available characters: Characters that can be used in a file name in Windows. If the name contains
one or more space characters, the entire name string must be enclosed in double quotation marks
(").
For details about the coding used for a user script file, see the description of how to create a user
script in the HP XP7 Replication Manager Application Agent CLI User Guide.
If you specified LOCATION=REMOTE in the user script file, you must also specify the -s option.
-s backup-server-name
Specify this option to connect to a remote backup server to perform a backup. Specify the host name
or the IP address of the backup server by using a character string that is no more than 255 bytes.
You can specify the IP address in IPv4 or IPv6 format.
-auto_import
Specify this option to automatically transfer a backup catalog to a backup server after backing up a
volume. This option must be specified concurrently with the -s option.
-auto_mount mount-point-directory-name
Basic commands146