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
The mount point directory name must satisfy the following:
• Maximum number of characters: Path lengths to be specified must comply with the specifications
of the mount and unmount functions provided by RAID Manager.
• Available characters: Characters that can be used in a directory name in Windows (excluding
space characters).
If you specify a drive for the mount point directory name, the command searches for unused drive
names in alphabetical order, starting with the specified drive, and then performs the mount.
If you specify an absolute path from the drive letter as the mount point directory name, the command
mount point is as follows:
absolute-path-specified-for-mount-point-directory-name\
primary-volume-drive-letter\primary-volume-mount-point
Even if the path does not end with a backslash (\), the command assumes that a backslash has been
specified. For example, D: and D:\ are assumed to be the same drive. Similarly, D:\MOUNTDIR
and D:\MOUNTDIR\ are assumed to be the same directory.
If you omit this option, a drive that is not being used when the extended command is executed is used
as the mount point.
-force
Specify this option to perform a forced mount. If you specify this option together with the -mount_pt
option, you must specify the options in the following order: -mount_pt, -force.
If the copy group name of the primary volume obtained at the time of backup processing on the
database server matches the information on the database server, forced resynchronization is performed.
This operation is executed even if the LDEV and SERIAL numbers do not match the LDEV and SERIAL
numbers from the time backup processing was performed.
Specify this option to perform a forced mount on a secondary volume using only the copy group name
of the primary volume as a key. Examples of when you might want to execute this operation include
when replacing a secondary volume because of a hardware failure, or when an LDEV number or
SERIAL number has changed. If you specify this option for normal restoration, data might be corrupted.
If you omit this option, the extended command terminates with an error without mounting if the copy
group name, LDEV number, and SERIAL number of the primary volume do not match the information
on the backup server. (These values are acquired when the database is backed up.)
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Conditions Causing an Error
This extended command fails in the following cases:
• An invalid option is specified.
• The system cannot acquire information from the operation definition file linked to the operation
ID.
• A command executed inside the extended command encounters an error.
Example
• In this example, the extended command is used to verify the consistency of the Exchange database
specified by the operation ID operation01:
Application Agent CLI Reference Guide 77