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
-template
Specify this option to perform restore operations by using a backup catalog that was created by
executing the drmsqlbackup command with the -template option specified. The START-TIME
and END-TIME of a template catalog specified with the -template option are the times at which
creation of the template catalog started and finished.
-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 value of the RAID Manager-linkage definition file (DEFAULT.dat) is used for parameters
that are not coded 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
NOTE:
• Specify all the databases that are contained in the logical volume to be restored. If this option is
not specified, a command error occurs.
• When you specify this command on the SQL Server database whose name has been changed,
make sure that the SQL Server database to be restored is detached. If the SQL Server database
is restored without detach processing, the command fails and the SQL Server database might not
be able to be used after restoration. If an SQL Server database becomes unusable, detach the
database, and then restore it again.
• The backup information in the backup catalog is managed based on using the copy group as a
key. Depending on the backup method, you might not be able to perform restoration, even though
the backup data exists on the secondary volume. For further information, see the notes on running
Application Agent in the
HP XP7 Replication Manager Application Agent CLI User Guide
.
• After a database is restored, the owner of the database is changed to the user who performed
the restoration. To change the owner, use SQL Server Enterprise Manager to attach the database
again, or use the sp_changedbowner system stored procedure.
• When the drmsqlrestore command executes, it uses SQL Server with minimum startup. If the
Windows firewall functionality has been set up in the database server, then when the drm-
sqlrestore command executes to restore databases that include the system databases (master,
model, and msdb), a dialog box might be displayed asking if the OS firewall is to block SQL
Server communication. If this dialog box is displayed, select Do not block. The drmsqlrestore
command will continue processing without problems even if you do not respond to this dialog
box.
Return Values
0: Normal termination
Any value other than 0: Termination with an error
Examples
• In this example, the command is used to restore, by disk resynchronization, the backup data
identified by the backup ID 0000000001:
Application Agent CLI Reference Guide 183