HP P9000 Replication Manager Software Application Agent CLI Reference Guide Part number: TB584-96051 Fifth edition: August 2012
Legal and notice information © Copyright 2010, 2012 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents Preface ................................................................................................ 9 1 Extended commands ........................................................................ 11 Overview of extended commands ............................................................................................... List of extended commands ..................................................................................................
2 Basic commands .............................................................................. 79 List of basic commands .............................................................................................................. 79 Before reading the basic command descriptions ........................................................................... 81 Basic command path ..........................................................................................................
Contacting HP ........................................................................................................................ HP technical support ......................................................................................................... Subscription service .......................................................................................................... Documentation feedback ...................................................................................................
Figures 1 drmsqlrecovertool dialog box .................................................................................
Tables 1 List of extended commands (File system backups) ......................................................... 12 2 List of extended commands (Common commands) ....................................................... 12 3 List of extended commands (Tape-related commands) .................................................. 12 4 List of extended commands (SQL Server database backups) .......................................... 13 5 List of extended commands (Exchange database backups) .......................
31 Cluster software parameters ................................................................................... 108 32 Items displayed by the drmdevctl -sigview command .................................................. 116 33 Partition styles and corresponding disk signatures to be specified ................................ 116 34 Host information displayed by the drmhostinfo command ........................................... 119 35 Backup information displayed by the drmtapecat command ...............
Preface This guide describes how to manage HP StorageWorks P9000 Replication Manager Software.
Preface
1 Extended commands This chapter describes the extended commands provided by Application Agent. Overview of extended commands An extended command is used to reduce the effort required to perform data protection operations, such as backup or restoration. You can use extended commands to automatically perform backup and restoration, without needing to specify further complicated operations. For example, suppose that you want to back up data to a tape device by using Application Agent commands.
List of extended commands The following tables display the extended commands provided by Application Agent and provide a general explanation for each command. Table 1 List of extended commands (File system backups) Extended command name Explanation EX_DRM_FS_BACKUP Backs up a file system. EX_DRM_FS_DEF_CHECK Checks the contents of an operation definition file and automatically creates a temporary directory. EX_DRM_FS_RESTORE Restores a file system from its backup to the primary volume.
Extended command name Explanation EX_DRM_UMOUNT Unmounts a secondary volume. Table 4 List of extended commands (SQL Server database backups) Extended command name Explanation 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 the SQL Server database from its backup to the primary volume.
Extended command formats All arguments that can be specified are described in this section. If multiple argument conditions exist, the formats are described separately for each condition. Do not mix separate formats. Viewing the format To display the extended command format, execute an extended command by specifying the -h option after the extended command name.
Extended command specifications (File system backups) This section explains the extended command specifications that apply to file system backup and restore operations.
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.
• The value is case sensitive. • When a reserved character or a one-byte space character is used, the entire value must be enclosed in double quotation marks ("). • If the value contains a reserved character, but is not enclosed in double quotation marks, the reserved character is not correctly interpreted as a part of the backup comment, and is parsed as a reserved character.
Specify this option to execute a user script. Specify user-script-file-name as an absolute path. The conditions for specifying the value in the user-script-file-name parameter are as follows: • • • • The value must be 255 bytes or less. The value can include alphanumeric, one-byte space, and multi-byte characters. The value is case sensitive. If the value contains space characters, the entire value must be enclosed in double quotation marks (").
or restoration failures. The items, volumes, and conditions to be checked are described in the following table. Table 7 Status check of a secondary volume Check item A secondary volume is hidden from a backup server Volume to be checked All secondary volumes defined for a backup-target primary volume Check condition Checked when a primary volume is defined in pairs with secondary volumes of multiple generations and any of the following items is applicable: • A primary volume is a cluster resource.
EX_DRM_FS_BACKUP operation01 -mode cold • In this example, the extended command is used to back up the file system specified by the operation ID operation01 to the secondary volume, using the VSS backup method: EX_DRM_FS_BACKUP operation01 -mode vss EX_DRM_FS_DEF_CHECK (Checks the contents of an operation definition file and automatically creates a temporary directory) Formats To check the contents of an operation definition file for a file server: EX_DRM_FS_DEF_CHECK operation-ID -db To check the content
Item name Details to be checked • The specified file or directory must exist.#1 TARGET_NAME FTP_HOME_DIR • The specified file and directories must be under the mount point directory assigned to INSTANCE_NAME. • The specified directory must exist.#1, #2 • The absolute path must be specified. • The specified directory name must not contain a delimiter character (\). FTP_SUB_DIR • The directory name must not be specified as only one period (.) or two periods (..).
-db Specify this option to check the contents of an operation definition file for a file server. -bk Specify this operation to check the contents of an operation definition file for a backup server. 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 operation definition file specified in the argument does not exist, or the system cannot access the file.
• An operation definition file linked to the specified operation ID has been provided. • EX_DRM_BACKUPID_SET or EX_DRM_DB_IMPORT has been executed, and the backup ID has been stored in the backup ID record file. 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.
Application-Agent-installation-directory\DRM\conf\raid Notes • The backup information in the backup catalog is managed by using a 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 P9000 Replication Manager Software Application Agent CLI User Guide.
Description This extended command is used to generate a backup ID file that contains the specified backup ID. The command stores the file in the temporary directory for extended commands. Execute this extended command as preparation for restoring the backed up file system or the database to the primary volume. Execute the command by specifying the backup ID to be used for restoring (the backup ID generated when you backed up the file system or the database to the secondary volume).
Example • In this example, the extended command is used to create a backup ID file that contains the backup ID 0000000001: EX_DRM_BACKUPID_SET operation01 -backup_id 0000000001 EX_DRM_CG_DEF_CHECK (Checks the contents of a copy-group list file) Formats EX_DRM_CG_DEF_CHECK -cg_file copy-group-list-file-name Description This extended command is used to check the contents of a copy-group list file. The command first checks to see if the file specified in the argument exists.
Example • In this example, the extended command is used to check the copy-group list file C:\WORK\CGDEF.txt: EX_DRM_CG_DEF_CHECK -cg_file C:\WORK\CGDEF.txt EX_DRM_DB_EXPORT (Exports backup information to a file) Format EX_DRM_DB_EXPORT operation-ID Description This extended command executes the drmdbexport command to export the backup information corresponding to the specified operation ID.
• The system cannot acquire information from the operation definition file linked to the operation ID. • Information cannot be acquired from the host environment settings file. • No storage directory for extended-command temporary files is specified in the operation definition file. • Information cannot be acquired from the backup ID file. • A command executed inside the extended command encounters an error. • The execution results of a command executed inside the extended command cannot be acquired.
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. • The copy source folder of the file to be copied does not exist. • The backup ID cannot be recorded in the backup ID file. • A command executed inside the extended command encounters an error. • Information cannot be acquired from the host environment settings file.
Arguments Specify the arguments of this extended command in the following order: operation-ID, -server FTP-server, -user FTP-user, and -password FTP-password. 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.
EX_DRM_FTP_PUT (Transfers a backup information file to the backup server) Format EX_DRM_FTP_PUT operation-ID -server FTP-server -user FTP-user -password FTP-password Description The EX_DRM_FTP_PUT command transfers the backup information file corresponding to the operation ID specified in the arguments from the temporary directory for extended commands on the FTP client to the temporary directory for extended commands on the FTP server.
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 connection to the FTP server or file transmission fails. • A command executed inside the extended command encounters an error. • The backup information file to be transferred by this extended command does not exist. • Information cannot be acquired from the host environment settings file.
that the contents of the HOST_ROLE and MAX_LOG_LINES entries in the host environment settings file are set as described in the table below. Table 10 Items checked in the host environment settings file Item Items checked • Both the name and value of the item are specified. • Only one item is specified. • The length of the value in characters does not exceed the maximum value. HOST_ROLE • If the -db argument is specified in the extended command, DB is specified as the item.
Conditions Causing an Error This extended command fails in the following cases: • An invalid option is specified. • The file specified in the argument does not exist, or the system cannot access the file. • The check of the contents of the file for setting up the host environment detects an abnormality. Examples • In this example, the extended command is used to check the contents of the host environment settings file C:\Program Files\drm\SCRIPT\conf\host.
If all copy groups have been used for backup processing, the command specifies the oldest copy group used for backup processing. Prerequisites The prerequisites for executing this extended command are as follows: • The operation definition file corresponding to the specified operation ID has been created. • The copy-group list file has already been created when copy groups are resynchronized by using the copy-group list file.
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. • Information cannot be acquired from the backup ID file (when no copy group is specified). • Information cannot be acquired from the copy-group list file (when the file is specified).
To clear the cache of the secondary volume when usual operation is in the split state: EX_DRM_CACHE_PURGE operation-ID { -cg copy-group | -cg_file copy-group-list-file } Description This extended command sequentially executes the drmmount and drmumount commands to clear the cache of the secondary volume.
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. • The backup ID cannot be acquired from the backup ID file (when the copy group is not specified). • Information cannot be acquired from the copy-group list file (when the file is specified).
EX_DRM_MOUNT operation-ID [ -mount_pt mount-point-directory-name ] [ -force ] [ -conf ] Description The EX_DRM_MOUNT command mounts a secondary volume and locks the appropriate copy group. Use this command as follows: • Mount the secondary volume to be backed up or restored. • Clear the system cache before backing up the secondary volume. • Mount the secondary volume that is unmounted after it has been backed up or restored.
Specify a mount point directory name with a drive letter, or as an absolute path beginning with a drive letter. The conditions for specifying a mount point directory name are as follows: • Maximum number of characters: Path lengths to be specified must comply with the specifications of the mount and unmount functions provided by RAID Manager.
EX_DRM_TAPE_BACKUP (Backs up data such as a secondary volume to a tape device) Formats EX_DRM_TAPE_BACKUP operation-ID [ -exopt [ -mount_pt mount-point-directory-name ] [ -raw ][ -force ] [ -bup_env configuration-definition-file-name ]] The command can also be executed in the following format: EX_DRM_TAPE_BACKUP operation-ID [ -mount_pt mount-point-directory-name ][ -raw] Description This extended command executes the drmmount, drmmediabackup, and drmumount commands, mounts the secondary volume at a speci
Specify the name of the mount point directory on which the secondary volume is to be mounted. The secondary volume is mounted at the specified mount point, and data is backed up from the secondary volume to a tape device. Specify the mount point directory name by using an absolute path or a drive letter.
replaced because of a failure or other reason, or when an LDEV number or SERIAL number was changed. Data might be lost if you specify this option for a normal backup operation. -bup_env configuration-definition-file-name Specify this option if you want to use a startup parameter in a user-created configuration definition file when backing up to or restoring from a tape device. If you omit this option, the default configuration definition file is used.
EX_DRM_TAPE_RESTORE (Restores data from backup tape to the secondary volume) Formats EX_DRM_TAPE_RESTORE operation-ID -backup_id backup-ID [ -exopt [ -mount_pt mount-point-directory-name][ -raw ] [ -force ] [ -bup_env configuration-definition-file-name] ] The command can also be executed in the following format: EX_DRM_TAPE_RESTORE operation-ID -backup_id backup-ID [ -mount_pt mount-point-directory-name][ -raw ] Description This extended command executes the drmmount, drmmediarestore, and drmumount comman
command execution in the HP P9000 Replication Manager Software Application Agent CLI User Guide. 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. -backup_id backup-ID For backup-ID, specify the backup ID of the backup you want to use for restoration.
If the target data has been backed up by the EX_DRM_TAPE_BACKUP extended command with the -raw option specified, this extended command executes restore processing normally even when this option is omitted. If this option is specified when the target data was backed up without the -raw option specified, an error occurs for this extended command. -force Specify this option to forcibly mount the secondary volume.
• The command fails to obtain the name of the directory where dictionary map files are stored. Examples • In this example, the extended command is used to restore the backup data identified by the operation ID operation01 from a tape device to the secondary volume. 0000000001 is the backup ID that was created when this data was backed up to the tape device. The secondary volume is mounted on drive E:.
Arguments operation-ID A character string that uniquely identifies the operation to be performed. -copy_group copy-group-name Specifies the name of the copy group (mounted by the EX_DRM_MOUNT command) to be unmounted. You must clear the system cache before backing up data. To do so, specify a copy group from the backup server and mount the secondary volume with the EX_DRM_MOUNT command. Then, when you unmount the secondary volume with the EX_DRM_UMOUNT command, the system cache is cleared.
The table below indicates the files that are backed up.
If you registered a VDI metafile storage directory by using the drmsqlinit command, the backup file is stored in the registered directory. The file name is backup-ID_database-ID.dmp. If you did not register a VDI metafile storage directory by using the drmsqlinit command, the backup file is stored in the directory that contains the file with the smallest management number (file_id) value for the SQL Server in the database file. The file name is META_databaseID.dmp.
If you omit the name-identifying-the-generation parameter, 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 to use the number of retries and retry interval defined in the copy parameter definition file.
-svol_check Specify this option to check the status of a secondary volume on a backup server. You must specify this option together with the -s option. Checking the status of a secondary volume prevents backup or restoration failures. The items, volumes, and conditions to be checked are described in the following table.
EX_DRM_SQL_BACKUP operation01 -system EX_DRM_SQL_DEF_CHECK (Checks the contents of an operation definition file and automatically creates a temporary directory) Formats To check the contents of an operation definition file for a database server by specifying an operation ID: EX_DRM_SQL_DEF_CHECK operation-ID -db To check the contents of an operation definition file for a backup server by specifying an operation ID: EX_DRM_SQL_DEF_CHECK operation-ID -bk To check the contents of an operation definition file
Entry name Checked contents • A database connection can be established by executing a combination of DB_SERVER_NAME and INSTANCE_NAME DB_SERVER_NAME INSTANCE_NAME • The value of DB_SERVER_NAME matches the database server name set in DRM_DB_PATH of the Application Agent configuration definition file init.
Where EX_DRM_SQL_DEF_CHECK is executed Temporary directory for extended commands VDI metafile storage directory Backup server directory-specified-forFTP_HOME_DIR\directory-specifiedfor-FTP_SUB_DIR\operation-ID\BK directory-specifiedfor-FTP_HOME_DIR\directory-specified-forFTP_SUB_DIR\operationID\AP Prerequisites The prerequisites for executing this extended command are as follows: • The account of the user currently logged into Windows must be allowed to connect to the database server.
• The system detects an error in the results of the file check. • The command fails to create a temporary directory. • The command fails to obtain the name of the directory where dictionary map files are stored. Examples • In this example, the extended command is used to check the contents of the operation definition file C:\Program Files\drm\SCRIPT\conf\_OP0001.
Prerequisites The prerequisites for executing this extended command are as follows: • An operation definition file linked to the specified operation ID has been provided. • The backup ID has been stored in a backup ID file by executing either the EX_DRM_BACKUPID_SET or EX_DRM_DB_IMPORT extended command. Arguments operation-ID A character string that uniquely identifies the operation to be performed.
This option is not available when you restore a system database (master, model, msdb, or distribution). Note When you specify the -nochk_host option, confirm that backup data is restored on the appropriate host, because the validity of the host name in the backup catalog is not checked when restoring backup data. -target database-name Specify this option to restore instances containing the specified databases. The databases you specify must be found in the backup catalog specified by the backup ID.
• The system cannot acquire information from the definition file linked to the operation ID. • A specified Application Agent command option cannot be specified as an extended command option. • The system cannot acquire information from the backup ID file. • A command executed inside the extended command encounters an error. • The command fails to obtain the name of the directory where dictionary map files are stored.
When the transaction log backup obtained by specifying this option is displayed by the -v option, a hyphen (-) is displayed for ORIGINAL-ID and BACKUP-ID. -no_truncate Specify this option to perform a backup without truncating the transaction log. If a failure occurs, even if the database data file is damaged (provided that the transaction log is not damaged), the transaction log backup can be obtained by specifying this option.
Description This extended command deploys the SQL Server metafiles from the temporary directory for extended commands to the directory indicated below.
EX_DRM_SQLFILE_EXTRACT operation01 EX_DRM_SQLFILE_PACK (Saves SQL Server metafiles) Format EX_DRM_SQLFILE_PACK operation-ID Description This extended command saves SQL Server metafiles in the following directory to the temporary directory for extended commands.
Example • In this example, the command backs up SQL Server metafiles based on the settings specified in the operation definition file operation01: EX_DRM_SQLFILE_PACK operation01 Extended command specifications (Exchange database backups) This section explains the extended command specifications that apply to Exchange database backup and restore operations.
[ [ [ [ [ [ -event_check ] [ -comment backup-comment ] -rc [ name-identifying-the-generation ]] -pf copy-parameter-definition-file ] -vf VSS-definition-file-name ] -script user-script-file-name ] -s backup-server-name [ -auto_import [ -auto_mount [ mount-point-directory-name ]] ] [ -svol_check] ] Description This extended command executes the drmexgbackup command, which backs up the Exchange database that is in the storage group or Information Store specified by the operation ID from the primary volume t
Arguments operation-ID A character string that uniquely identifies the operation to be performed. Information in the operation definition file linked to the specified operation ID is used when executing an extended command. -mode cold Specify this option to perform a cold backup of an Exchange database. If you omit this option, a cold backup (-mode cold) is the default. -mode online Specify this option to perform an online backup of an Exchange database.
-event_check Specify this option to check whether an event indicating a corrupted database has been recorded. The command executed with this option searches the event logs that were recorded since the last backup of an Exchange database. If no previous backup is available, all recorded event logs are searched. The event log is searched before the copy pair is resynchronized. If an event indicating a corrupt database is detected, the command terminates in an error.
If you omit this option, the value in the RAID Manager-linkage definition file (DEFAULT.dat) is used. The values in the RAID Manager-linkage definition file (DEFAULT.dat) are used for any parameters that are not included in the copy parameter definition file. You can create a copy parameter definition file by using a name of your choice. Specify the file name by using an alphanumeric character string that is 64 bytes or less.
Specify this option to automatically mount a secondary volume on a backup server after backing up a volume. You must specify this option together with the -s and -auto_import options. Specify the mount-point-directory-name value by using a character string that is 64 bytes or less. If you omit the mount-point-directory-name parameter, a mount destination for a secondary volume is automatically determined.
• The system fails to record a backup ID in the backup ID record file. • A command executed inside the extended command encounters an error. • The command fails to obtain the name of the directory where dictionary map files are stored.
In addition, the command checks the contents in the operation definition file for the items listed in the table below. Table 17 Contents checked in the operation definition file Item name Details to be checked BACKUP_OBJECT MSEXCHANGE is specified. • The Exchange Server name or virtual server name exists. DB_SERVER_NAME • If SET_DRM_HOSTNAME is set to 1, the value of DB_SERVER_NAME matches the database server name set in DRM_DB_PATH of the Application Agent configuration definition file init.conf.
Prerequisites The prerequisites for executing this extended command are as follows: • Application Agent commands can be executed by a user account currently logged on to Windows. • If the command is executed on the database server, it is able to access the domain controller of the Windows domain that manages the Exchange Server. The DNS service must be running on the database server. Arguments operation-ID A character string that uniquely identifies the operation to be performed.
• In this example, the extended command is used to check the contents of the operation definition file C:\Program Files\drm\SCRIPT\conf\_OP0001.dat for a backup server: By specifying an operation ID: EX_DRM_EXG_DEF_CHECK OP0001 -bk By specifying the operation definition file: EX_DRM_EXG_DEF_CHECK -bk -f "C:\Program Files\drm\script\conf\_OP0001.
[ -vf VSS-definition-file-name ] [ -ef Exchange-environment-setting-file ] Description This extended command executes the drmexgrestore command to restore backup data from the secondary volume to the primary volume for a specified database. Prerequisites The prerequisites for executing this extended command are as follows: • An operation definition file linked to the specified operation ID has been provided.
is not case sensitive. If you omit this option, all storage groups on the server on which this command was executed will be restored. -f target-definition-file-name As with the -target option, specify this option to restore specific storage groups or Information Stores. Unlike the -target option, the -f option lets you specify a target definition file, which contains all the storage groups or Information Stores to be restored.
Application-Agent-installation-directory\DRM\conf\raid -vf VSS-definition-file-name Specify this option to specify the VSS definition file used during a VSS backup. You can specify this option only when restoring backup data that was obtained by using VSS. If you specify this option when restoring data other than backup data obtained by using VSS, this option will be ignored. Specify the VSS-definition-file-name parameter as a file name only; do not specify the parameter as a path.
• If ONLINE is set in CLU_MSCS_RESTORE in the Application Agent configuration definition file (init.conf), restoration can be performed while the cluster resources are online. 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.
When using EX_DRM_TAPE_BACKUP to back up the Exchange database from a secondary volume onto a tape device, execute this extended command to prepare for the tape device backup. If an error is detected in the consistency of the Exchange database, you must re-execute the backup to the secondary volume. Prerequisites The prerequisites for executing this extended command are as follows: • The backup catalog to be verified by this extended command has been imported to the backup server.
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.
2 Basic commands This chapter describes the basic commands provided by Application Agent. List of basic commands The table below lists the basic commands that Application Agent provides. Table 19 List of basic commands (file system backups) Basic command name Function summary drmfsbackup Backs up a file system to a secondary volume. drmfscat Displays a list of the backup information for a file system. • Displays a list of file system information. drmfsdisplay • Updates the dictionary map files.
Basic command name Function summary drmmediarestore Restores backup data from a tape device. drmmount Mounts a secondary volume. drmtapecat Displays a list of backup information for a tape device. drmtapeinit Registers the parameters for a backup management product. drmumount Unmounts a secondary volume. Table 22 List of basic commands (utility commands) Basic command name Function summary drmdbsetup Creates or deletes a Protection Manager database.
Before reading the basic command descriptions Note the following before reading the basic command descriptions: Do not forcibly terminate a basic command that is being executed. If you do so, the pair status of the copy group or the backup catalog might enter an unexpected status. For further information, see the description of permissions for command execution in the HP P9000 Replication Manager Software Application Agent CLI User Guide.
File name Use alphanumeric characters to specify the file name. File contents The contents of the file must adhere to the following conventions: • Each parameter (file name, directory name, SQL Server database name, storage group name, or Information Store name) must be specified on one line. • Lines beginning with a hash mark (#) are assumed to be comment lines.
# Protection Manager 3.5 # Log Backup Files [SQLDB001] C:\MSSQL\BackupLog\SQLDBLog001.bak C:\MSSQL\BackupLog\SQLDBLog002.bak C:\MSSQL\BackupLog\SQLDBLog003.bak [SQLDB002] C:\MSSQL\BackupLog\SQLDB2Log001.bak C:\MSSQL\BackupLog\SQLDB2Log002.bak C:\MSSQL\BackupLog\SQLDB2Log003.bak Correspondence with Replication Manager GUI terms Some terms used in the Application Agent command line interface have different meanings from those used in the Replication Manager GUI.
Basic command specifications (File system backups) drmfsbackup (Backs up a file system to a secondary volume) Formats To perform an online backup: drmfsbackup { mount-point-directory-name | mount-point-directory-target-definition-file-name } [ -mode online ] [ -rc [ name-identifying-the-generation ]] [ -pf copy-parameter-definition-file ] [ -comment backup-comment ] [ -script user-script-file-name ] [ -s backup-server-name [ -auto_import [ -auto_mount [ mount-point-directory-name ]] ] [ -svol_check ] ] To
When the drmfsbackup command is executed on the local site and the pair status is SMPL, the command does not automatically create a pair. In this case, if the PAIR_CREATE parameter in the RAID Manager-linkage definition file (DEFAULT.dat) is set to ENABLE, the command automatically creates a pair.
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.
The following special characters cannot be used in 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. -vf VSS-definition-file-name Specify this option to switch the settings to be used for each VSS backup. You can use this option only when using VSS for backup.
To unmount the mounted secondary volume, use the drmumount command. -svol_check Specify this option to check the status of a secondary volume on a backup server. This option must be specified concurrently with the -s option. Checking the status of a secondary volume prevents backup or restoration failures. The items, volumes, and conditions to be checked are described in the following table.
Application-Agent-installation-directory\DRM\conf\fs\APP1 Contents of the mount point directory target definition file: D: E: F:\MNT • In this example, the command is used to perform an online backup to a remote site: PROMPT> drmfsbackup F: -rc remote_0 • In this example, the command is used to back up by using VSS: PROMPT> drmfsbackup H: -mode vss KAVX0001-I The drmfsbackup command will now start. KAVX0019-I Copying file(s) now... KAVX5108-I Resynchronizing a copy group.
Displayed item Description ORIGINAL-ID Original backup ID obtained by the drmfsbackup command START-TIME Start time of a snapshot backup END-TIME End time of a snapshot backup HOSTNAME Server name where the snapshot backup was performed Object type T (F, which means file, is always displayed.
Displayed item Description BACKUP-COMMENT Backup comment #1 If this command is executed with the -device option, DEVICE will be displayed after T. #2 This information is displayed when the command is executed with the -v option. A hyphen (-) is displayed for any item that cannot be displayed. If no items can be displayed, an error message is displayed. Each item is separated by a space.
Specify this option to display backup information for specific files or directories on the file system specified by the mount-point-directory-name argument. Create a target definition file that contains a list of absolute paths of the mount point directories, drives, or volume mount points for which you want to display information. By specifying the target definition file name, you can collectively specify all of the targets for which you want to display information.
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. If you specify -comment "*", the command will display all backup catalogs. If two double quotation marks are specified after the -comment option (as in -comment ""), a message is displayed indicating that no backup data exists.
PROMPT> drmfscat D: -hostname FILESERV1 INSTANCE: D: BACKUP-ID:0000000001 BACKUP-MODE: COLD INSTANCE: D: ORIGINAL-ID:0000000001 START-TIME:2002/06/01 10:00:00 END-TIME: 2002/06/01 10:03:00 HOSTNAME: FILESERV1 T FILE FS DG DEVICE COPY-GROUP F D: Harddisk1 VG01,dev01 F VG01,dev01 • In this example, the command is used to display backup information for the file system of the D drive and management information for the backup catalog: PROMPT> drmfscat D: -v VIRTUAL-SERVERNAME: host1 DB-PATH: D:\Program Files\CV
drmfsdisplay (Displays or updates file system information) Formats To display file system information: drmfsdisplay [ mount-point-directory-name ] [ -target file-or-directory-names | -f target-definition-file-name ] [ -device device-file-name ][ -l ] [ -v ][ -cf ] To update the information in the dictionary map files: drmfsdisplay -refresh Description The drmfsdisplay command performs the following three functions: 1. 2. 3.
Displayed item Description PORT# Port name on the server host side TID# Target ID on the server host side LUN# Logical unit number on the server host side MU# Pair identifier LDEV# Logical device number across RAID devices Letter identifying whether the volume is primary or secondary: P: Primary volume of a pair P/S S: Secondary volume of a pair -: A volume that is not part of a pair SERIAL# Serial number across RAID devices Copy type COPY-FUNC Copy type: The name of the copy type varies de
Specify the drive letter of the file system for which you want to display information, or specify its absolute path starting with the drive letter. Do not specify a backslash (\) at the end of the path. If this argument is not specified, the command targets all file systems. -target file-or-directory-names Specify this option to display information about specific files or directories. Use absolute paths to specify the file names or directory names.
If the disk configuration has changed, always update the dictionary map files. Note When specifying on the command line a file name or directory name containing space characters for the -target option or the -f option, you must enclose the file name in double quotation marks ("). Note that enclosing with double quotation marks is not necessary for target paths specified in batch definition files.
PROMPT> drmfsdisplay D: -v VIRTUAL-SERVERNAME: host1 DB-PATH: D:\Program Files\CVXPAE\DRM\db2 INSTANCE: D: CORE-MAPFILE-UPDATE-TIME: 2002/06/01 10:00:00 APP.
2. 3. The command confirms that the file system has been unmounted, and then resynchronizes the disks by restoring the backup data from the secondary volume to the primary volume. The command mounts the file system again. The following explains the command processing for restoration in a cluster configuration: 1. The command automatically takes the disk resource offline when the disk resource in the file system to be restored is brought online.
Before a backup After a backup Primary volume Primary volume Command execution result Secondary volume GPT disk Command status Error message (DRM-10337) Before resynchronizing#2 MBR disk Error message (KAVX5171-E or KAVX5137-E) GPT disk Normal termination GPT disk After resynchronizing#1 #1 The error message is displayed after resynchronizing. #2 The error message is displayed before resynchronizing. Arguments backup-ID Specify the backup ID of the backup data you want to use for restoration.
containing space characters, enclose the directory name in double quotation marks ("). You cannot specify a backslash (\) at the end of the path. If you omit both this option and the -f option, the entire file system registered in the backup catalog will be restored. -f target-definition-file-name Specify this option to restore the file system that contains the specific file or directory. Use the file or directory name registered in the backup catalog specified by the backup ID.
PROMPT> drmfsrestore 0000000001 -resync • In this example, the command is used to restore data from the secondary volume to the primary volume, which resynchronizes the disks. The backup data used for restoration is identified by the backup ID 0000000001. During restoration, the command uses the parameters defined in the copy parameter definition file remote0.dat. PROMPT> drmfsrestore 0000000001 -resync -pf remote0.
Displayed item Description BACKUP-OBJECT Snapshot backup object type INSTANCE#2, #3 • The name of the instance of the backup target (for a database) • The name of the mount point directory (for a file system) START-TIME Start time of a snapshot backup END-TIME End time of a snapshot backup VIRTUAL-SERVERNAME Virtual server name (value of the DRM_HOSTNAME environment variable) DB-PATH Name of the directory storing the backup catalog #1 When the -comment option is specified, this information is
-comment backup-comment Specify this option to display only information on a specific backup comment. The backup-comment value is not case sensitive. You can use an asterisk (*) to specify a wildcard in backup-comment. You can specify that only the initial characters match (for example, specify a string such as XYZ* to search for strings that begin with one or more specific characters and that end with any or no characters).
• In this example, the command is used to display the backup catalog list and backup catalog management information, with backup comments: PROMPT> drmappcat -v -comment "Comment*" VIRTUAL-SERVERNAME: host1 DB-PATH: D:\Program Files\CVXPAE\DRM BACKUP-COMMENT BACKUP-ID BACKUP-MODE BACKUP-OBJECT START-TIME END-TIME Comment1 0000000162 ONLINE FILESYSTEM 2003/10/02 18:24:35 2003/10/02 18:59:37 Comment2 0000000251 ONLINE MSSQL 2003/10/03 18:55:15 2003/10/03 18:59:37 PROMPT> • In this example, the command is used
You can confirm that the logical volumes are the same by executing the drmfsdisplay command and checking the items listed for LVM-DEVICE. In environments where one logical volume group comprises multiple copy groups, if the multiple generation backup function is used, the number of generations of all copy groups comprising the logical volume group must match. If the copy group generations do not match, backup generation management cannot be performed correctly in Application Agent.
PROMPT> drmcgctl -backup_id 0000000001 -mode lock • In this example, the command is used to unlock the copy groups used for the backup identified by the backup ID 0000000001: PROMPT> drmcgctl -backup_id 0000000001 -mode unlock drmclusinit (Registers the parameters for the cluster software) Formats To register the parameters for the cluster software: drmclusinit cluster-software-name To view the parameters registered for the cluster software: drmclusinit -v cluster-software-name Description For a cluster
Registered item Description Enter the following information, based on the resource name: • When mount-point is specified: Disk name (required when D has been specified for the resource type) Enter a mount point (such as D:). • When disk-group is specified: Enter a disk group name (such as DG01). #1 A resource whose resource type is MountV #2 A resource whose resource type is VMDg Arguments -v Specify this to display the registered parameters.
Mount point resource (MountV resource) and disk group resource (VMDg resource) created on the physical disks that can be monitored by Application Agent. Do not use the drmclusinit command to register the following resources: Service resource of an SQL Server or Exchange Server, Lanman resource (virtual server), RegRep resource (registry replication resource).
KAVX0311-I KAVX0314-I KAVX0316-I KAVX0311-I KAVX0314-I KAVX0316-I KAVX0311-I KAVX0314-I KAVX0316-I KAVX0311-I KAVX0314-I KAVX0316-I KAVX0311-I KAVX0317-I KAVX0310-I KAVX0313-I KAVX0312-I PROMPT> Enter the resource name: MountV-E Enter the resource type (S for service. Enter the drive name: E: Enter the resource name: MountV-F Enter the resource type (S for service. Enter the drive name: F: Enter the resource name: VMDG-1 Enter the resource type (S for service.
KAVX0314-I KAVX0316-I KAVX0311-I KAVX0314-I KAVX0316-I KAVX0311-I KAVX0317-I KAVX0310-I KAVX0313-I KAVX0312-I PROMPT> Enter the resource type (S for service. D for disk): D Enter the drive name: DG2 Enter the resource name: VMDG-3 Enter the resource type (S for service. D for disk): D Enter the drive name: DG3 Enter the resource name: Enter the instance name: Enter the resource group name: Enter the Virtual host name : Cluster information was updated.
PROMPT> drmdbexport 0000000001 -f D:\temp\0000000001.drm drmdbimport (Imports backup information from a file) Format drmdbimport -f import-source-file-name Description The drmdbimport command imports, into a backup catalog, backup information from a file that was exported by the drmdbexport command. Application Agent manages backup information based on copy groups, which are used as a key.
To reveal (publish) the secondary volumes of all copy groups: drmdevctl -attach [ -noscan ] To reveal (publish) the secondary volumes of copy groups registered in a backup catalog: drmdevctl backup-ID -attach [ -noscan ] To reveal (publish) the secondary volumes of a specified copy group: drmdevctl -copy_group copy-group-name -attach [ -noscan ] To perform a disk rescan on the OS of the server: drmdevctl -rescan To display the disk signatures of the local volumes of all copy groups: drmdevctl -sigview To
Arguments backup-ID Specify the backup ID of a backup catalog. When a backup ID is specified, the target physical volumes are the secondary volumes of the copy groups registered in the backup catalog. -copy_group copy-group-name Specify a valid copy group name. The target physical volumes are the secondary volumes of the copy group specified. -detach Conceals the physical volumes of the storage system from the server, and instructs the OS of the server to perform a disk rescan.
The following table shows the items displayed when the -sigview option is specified. Table 32 Items displayed by the drmdevctl -sigview command Displayed item Description When the backup ID is specified: The name of the copy group to be backed up When the copy group is specified: COPY_GROUP The name of the specified copy group When none is specified: All copy groups The physical volume name corresponding to the copy groups.
Partition style Format (Example) Remarks GPT ABCDEF01-2345-6789-ABCD-EF0123456789 GUID (Curly brackets ({}) are not used.) Notes • A backup ID and the -copy_group option cannot be specified at the same time. • If neither the backup-ID option nor the -copy_group option is specified, the secondary volumes of all copy groups managed by Application Agent will be targeted. The RAID Manager instance used by Application Agent is specified in the RAID Manager-linkage definition file (DEFAULT.
Return Values 0: Normal termination Any value other than 0: Termination with an error Examples • In this example, the command conceals the secondary volumes of all copy groups, and performs a drive rescan: PROMPT> drmdevctl -detach • In this example, the command conceals the secondary volumes of the copy groups registered in the backup catalog, and performs a drive rescan: PROMPT> drmdevctl 0000000002 -detach • In this example, the command is used to execute multiple conceal operations for the secondary
ABCDEF01-2345-6789-ABCD-EF0123456702 -------VG02,dev13 UNKOWN --- -------- -------- • In this example, the command is used to display the current disk signature of the local volume, and, for the copy group recorded in the backup catalog that corresponds to the backup ID 0000000002, the disk signature at the time of backup: PROMPT> drmdevctl 0000000002 COPY_GROUP DEVICE TYPE VG01,dev01 Harddisk10 MBR VG01,dev02 Harddisk11 MBR -sigview CUR_DISKID BKU_DISKID ABCDEF01 ABCDEF00 ABCDEF02 ABCDEF03 • In this ex
Displayed item Description Product version. If this option is not specified, the information is displayed in the format VV.R.r.AASS(VV-Rr-as#1)#2. The following are examples: HP StorageWorks P9000 Replication Manager Application Agent Copy Controller 7.0.0-00: 07.0.0.0000(07-00) HP StorageWorks P9000 Replication Manager Application Agent Copy Controller 7.0.0-01: VERSION 07.0.0.0001(07-00-01) If the -i option is specified, the information is displayed in the format VV.R.r.AASS#2.
Examples The following are examples of using Application Agent version 7.0. • In this example, the drmhostinfo command is used to display host information: PROMPT> drmhostinfo PRODUCT VERSION HP StorageWorks P9000 Replication Manager Application Agent Copy Controller 07.0.0.0000(07-00) HP StorageWorks P9000 Replication Manager Application Agent for SQL 07.0.0.
command when the PAIR_CREATE parameter in the RAID Manager-linkage definition file (DEFAULT.dat) is set to ENABLE. Arguments -copy_group copy-group-name Specify the name of the copy group you want to resynchronize. To check the copy group name, execute either of the following commands according to what was backed up: • When the backup is of a file system, use the drmfscat command. • When the backup is of an SQL Server database, use the drmsqlcat command.
Examples • In this example, the command is used to resynchronize the copy group VG01,dev01: PROMPT> drmresync -copy_group VG01,dev01 • In this example, the command is used to lock the copy groups used in the backup identified by the backup ID 0000000001: PROMPT> drmresync -backup_id 0000000001 Basic command specifications (Tape-related commands) drmmediabackup (Backs up data from a secondary volume to a tape device) Format drmmediabackup backup-ID [ -raw ] [ -bkdir backup-file-directory ] [ -bup_env confi
Take the command retry period into consideration when you execute more than one drmmediabackup command concurrently. For details about the settings, see notes on command execution in the HP P9000 Replication Manager Software Application Agent CLI User Guide. Arguments backup-ID Specify the backup ID for the secondary volume that contains the backup data to be copied to a tape device. A backup ID uniquely identifies backup data and is registered in the backup catalog during backup.
Create a configuration definition file in the directory containing the default configuration definition file. For further information, see the description of configuration definition file creation in the HP P9000 Replication Manager Software Application Agent CLI User Guide.
After restoration, enter one of the following keywords: • YES (normal termination) • NO (termination with an error) • CANCEL (operation canceled) After restoration with Backup Exec finishes, enter the correct keyword. Before executing the drmmediarestore command, confirm the following: • The backup management product has been linked. • The drmmount command has been executed and the secondary volume to be backed up has been mounted. • A definition file for the tape backup has been created.
Create a configuration definition file in the directory containing the default configuration definition file. For further information, see the description of configuration definition file creation in the HP P9000 Replication Manager Software Application Agent CLI User Guide. Note The value of NBU_MASTER_SERVER in the configuration definition file must be the same as the value that was used during the backup.
for mounting a secondary volume in the HP P9000 Replication Manager Software Application Agent CLI User Guide. When a backup ID is specified, the copy group corresponding to the specified backup ID is locked. Because copy groups locked by the drmmount are unlocked by the drmumount command, when you use the drmmount command to mount a secondary volume, be sure to use the drmumount command to unmount it.
When mounting the secondary volume by specifying the backup ID: absolute-path-specified-for-mount-point-directory-name\ primary-volume-drive-letter\primary-volume-mount-point If a path does not end with a backslash (\), the command assumes a backslash at the end of the path. For example, D: and D:\ are assumed to be the same drive. D:\MOUNTDIR and D:\MOUNTDIR\ are assumed to be the same directory.
PROMPT> drmmount 0000000001 -mount_pt D: If several secondary volumes have been backed up with the backup ID 0000000001, the command searches for an unused drive in alphabetical order beginning from the D drive, and mounts the secondary volume to the first found drive.
confirm information about the objects corresponding to the backup ID, and hence confirm the backup ID to be used for restoration. The backup information for the backup from the primary volume to the secondary volume contains the information about the primary volume that stores objects that were backed up onto a tape device, and the information about the database files that were backed up.
When the -bkdir option is specified, this information is displayed. #5 When the -v option is specified, this information is displayed. #6 When the -v and -o options are specified, this information is displayed. A hyphen (-) is displayed for any item that cannot be displayed. If none of the items can be displayed, an error message is displayed. Each item is separated by a space. This information provides further details than the backup information for a backup from the secondary volume to tape.
Specify this option to display the information for a backup from a primary volume to a secondary volume, and the type of backup object is a file system. -o MSSQL Displays detailed information for the backup that was registered when a snapshot backup was performed for the backup information about the instance for the backup object type.
You can specify the following options for the drmexgcat command. For details about the functions of the options, see the description of the drmexgcat command. • -target • -f • -device • -transact_log • -datafile • -l • -v • -backup_id • -hostname -delete Specify this option to delete the backup information for the backup catalog. By using this option, you can delete backup information about a tape backup before the record's duration specified by the drmtapeinit command expires.
0000000002 MEDIA3 0000000003 MEDIA4 FILESYSTEM 2002/02/01 11:00:00 2002/05/01 11:00:00 FILESYSTEM 2002/02/01 11:30:00 2002/05/01 11:30:00 • In this example, the command is used to display the backup information of the backup ID 0000000002: PROMPT> drmtapecat -backup_id 0000000002 BACKUP-ID BACKUP-OBJECT SNAPSHOT TIME BACKUP-MEDIA 0000000002 FILESYSTEM 2002/02/01 10:30:00 MEDIA2 EXPIRATION TIME 2002/05/01 10:30:00 • In this example, the command is used to display detailed information for the backup
PROMPT> drmtapecat -o FILESYSTEM D: INSTANCE: D: BACKUP-ID:0000000010 BACKUP-MODE: COLD INSTANCE: D: ORIGINAL-ID:0000000001 START-TIME:2002/06/01 10:00:00 END-TIME: 2002/06/01 10:03:00 HOSTNAME: FILESERV1 T FILE FS DG DEVICE COPY-GROUP F D: Harddisk1 VG01,dev01 F VG01,dev01 • In this example, the command is used to display information about the backup performed from the primary volume to the secondary volume (when the backup is of an SQL Server database): PROMPT> drmtapecat -o MSSQL SQL1 INSTANCE: SQL1 BAC
T TRANSACT VG01,dev02 - VG01,dev02 T TRANSACT VG01,dev02 - VG01,dev02 C CHECKPOINT VG01,dev02 - VG01,dev02 - E:\STR1\E000002.log E: - Harddisk2 - - - - - - E:\STR1\E000003.log E: - Harddisk2 - - - - - - E:\STR1\E00.
The following table lists the parameters for backup management products that can be registered by using this command. Table 36 Parameters for backup management products Registration item Description Specify NBU or BEWS. Name of the backup management product When using NetBackup, specify NBU. When using Backup Exec, specify BEWS. Specify the number of days to store backup information.
Days to keep the backup catalog: 1 PROMPT> • In this example, the command is used to register the parameters for linking with Backup Exec: PROMPT> drmtapeinit KAVX0411-I Enter the backup management product name BEWS KAVX0417-I Enter the number of days to store the backup catalog: 1 KAVX0414-I Backup parameters were updated PROMPT> : • In this example, the command is used to display the parameters for linking with Backup Exec: PROMPT> drmtapeinit -v Backup application name: BEWS Days to keep the backup
• drmfsbackup • drmresync If the unmount cannot be performed using the drmumount command, unlock the copy group corresponding to the backup ID specified for the drmcgctl command, and unmount the secondary volume as follows: • Use the unmount functionality of RAID Manager. Arguments -copy_group copy-group-name Specify the name of the copy group to be unmounted (a copy group mounted by using the drmmount command). The system cache must be cleared before a data backup.
Basic command specifications (Utility commands) drmdbsetup (Creates and deletes Application Agent databases) Formats To create backup catalog information and the dictionary map files: drmdbsetup -i To delete backup catalog information and the dictionary map files: drmdbsetup -u Make sure that you specify an absolute path when executing the drmdbsetup command. The absolute path of this command is as follows: Application-Agent-installation-directory\DRM\bin\util\drmdbsetup.
Basic command specifications (SQL Server database backups) drmsqlbackup (Backs up an SQL Server database to a secondary volume) Formats To back up: drmsqlbackup { instance-name | DEFAULT } [ -system | target database-name | -f target-definition-file-name ] [ -rc [ name-identifying-the-generation ]] [ -pf copy-parameter-definition-file ] [ -comment backup-comment ] [ -script user-script-file-name ] [ -s backup-server-name [ -auto_import [ -auto_mount [ mount-point-directory-name ]] ] [ -svol_check ] ] To cr
If you specify an instance that is not running, the command fails. All the user databases included in the instance are to be backed up. The system databases (master, model, and msdb) for SQL server are not included. When you back up a system database, execute the command with the -system option. The system cache of the secondary volume must be cleared before executing this command. Mount or unmount the secondary volume on the backup server to clear the system cache.
Database of interest#1 User database Distribution database File type of interest Backup file name Storage destination for backup files Metafile#2 Varies depending on the VDI metafile storage directory specified with the -drmsqlinit command#3 Data file Same as the backup source file name Secondary volume Transaction log file Same as the backup source file name Secondary volume Metafile#2 Varies depending on the VDI metafile storage directory specified with the -drmsqlinit command#3 Data file
The database names specified in this option will be registered in the backup catalog, and can be checked using the drmsqlcat command. -f target-definition-file-name Like the -target option, this option performs a backup related to specific databases only. Unlike the -target option, this option lets you specify a target definition file that collectively specifies all the databases for which a backup is to be performed.
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 (").
Specify this option to create only a backup catalog, without resynchronizing or splitting pairs, or freezing databases. Even if you create a template catalog with the -template option specified, the old metafile will be deleted. For example, in a two-generation environment, suppose that the following commands are executed: 1. Execute drmsqlbackup default. 2. Execute drmsqlbackup default 3.
• In this example, the command is used to perform backup by specifying the backup comment. PROMPT>drmsqlbackup default -comment comment KAVX0001-I drmsqlbackup command will now start. KAVX1017-I SQL Server information will now be retrieved. KAVX1207-I The database is being backed up. KAVX0040-I The backup ID has been assigned as follows: Backup ID = 0000000021 KAVX0002-I drmsqlbackup command will now end.
PROMPT> drmsqlbackup default -script C:\Uscript.txt KAVX0001-I The drmsqlbackup command will now start. KAVX1017-I SQL Server information is being collected now. KAVX1207-I Backing up the database... KAVX0210-I The user script will now start. Procedure section = RESYNC_PROC KAVX0212-I A command from the user script will now execute. Command line = C:\HORCM\etc\pairresync.exe -g TC01 -d sql01 -FBC 0 KAVX0213-I A command from the user script has ended.
Displayed item Meaning BACKUP-COMMENT Backup comment BACKUP-ID Backup ID BACKUP-MODE Backup mode (ONLINE) ORIGINAL-ID Original backup ID obtained by the drmsqlbackup command INSTANCE SQL Server instance name START-TIME Snapshot backup start time END-TIME Snapshot backup end time HOSTNAME Server name where the snapshot backup was performed Object type: D: Data file T T: Transaction log M: Metafile DB SQL Server database name SQL Server object name: OBJECT DATAFILE: Data file name TRANS
Displayed item Meaning TID# Target-ID on the host server LUN# Logical unit number on host server MU# Pair ID LDEV# Logical device number inside the RAID device A letter identifying the primary or secondary volume: P/S P: Primary volume S: Secondary volume -: Others SERIAL# Serial number inside the RAID device VIRTUAL-SERVERNAME#3 Virtual server name (value of the DRM_HOSTNAME environment variable) DB-PATH#3 Name of the directory storing the backup catalog CATALOG-UPDATE-TIME#3 Time when t
• Physical disk information To display the information for multiple storage groups, use a comma to separate each database name. If you specify a database name containing a space character, enclose the database name in double quotation marks ("). When both this option and the -f option are omitted, all database information about the instance specified by the instance name will be displayed. -f target-definition-file-name Specifies the backup information to be referenced for a specific database.
• Physical disk information • Logical volume structure information -l Specifies that information will be displayed in the long format. -v Specify this option to display information about the backup catalog. The following information is displayed: • Name of the directory storing the backup catalog Displays the path that is set in DRM_DB_PATH in the Application Agent configuration definition file (init.conf).
Specify this option if you want to display the log sequence number CHECKPOINT-LSN of the log record that is used as the starting point of a recovery when restoring a backup file of the data file indicated by the DATAFILE of OBJECT and the full backup time FULL-BACKUP-TIME. Note When specifying on the command line a file name or directory name containing space characters for the -target or -f option, you must enclose the file name in double quotation marks (").
D DB1 DATAFILE D:\SQL\data2.mdf D: NTFS \\?\Volume{df67a5b0-5583-11d5-a410-806d6172696f}\ Harddisk2 VG12,dev02 CLI-A 2 20 0 10020 P - - - 15044 VG12,dev02 CLI-A 2 21 0 10021 S T DB1 TRANSACT D:\SQL\tlog2.
M DB2 METAFILE C:\METADIR\Meta2 C: NTFS \\?\Volume{df66a5b0-5583-12d5-a410-806d6172696f}\ Harddisk1 VG11,dev01 CLI-A 2 10 0 10010 P D DB1 DATAFILE D:\SQL\data2.mdf D: NTFS \\?\Volume{df67a5b0-5583-11d5-a410-806d6172696f}\ Harddisk2 VG12,dev02 CLI-A 2 20 0 10020 P - - - 15044 15044 VG12,dev02 CLI-A 2 21 0 10021 S T DB1 TRANSACT D:\SQL\tlog2.
T UserDB1 TRANSACT O: Harddisk3 - - O:\UserDB1_Log.LDF STD03,sqlstd022 STD03,sqlstd022 • In this example, the command is used to display the template catalog: PROMPT>drmsqlcat default -template INSTANCE: default BACKUP-ID: 0000000001 BACKUP-MODE: ONLINE INSTANCE: default ORIGINAL-ID: 0000000002 START-TIME: 04.02.04 13:01:35 END-TIME: 04.02.04 13:02:33 HOSTNAME: flora4 T DB OBJECT FILE FS DG DEVICE COPY-GROUP M UserDB1 METAFILE O:\MSSQL\0000000002_0000000001.dmp D UserDB1 DATAFILE O:\UserDB1_Data.
drmsqldisplay [ [ [ [ instance-name ] -target database-name | -f target-definition-file-name ] -transact_log ][ -datafile ] -v ][ -remote ] To update the information in the dictionary map files: drmsqldisplay [instance-name ] -refresh [ -coremap ] Description The drmsqldisplay command does the following: 1. 2. 3. Displays the resource information of the SQL Server database on the server on which the command was executed.
Displayed item L-COPY-GROUP R-COPY-GROUP Meaning The copy group name of the local site, displayed as follows: RAID-Manager-volume-group-name,device-name The copy group name of the remote site and the pair identifier (MU#) of the SVOL at the remote destination, displayed as follows: RAID-Manager-volume-group-name,device-name-with-remotedestination-SVOL-pair-identifier-(MU#) PORT# The port name on the host server TID# The target ID on the host server LUN# The logical unit number on the host server MU
A hyphen (-) will be displayed in columns that contain items that cannot be displayed. An error message will be displayed when none of the items can be displayed. Each item is separated by space. Arguments instance-name Specify the name of the SQL Server database instance for which information is to be updated or displayed. If the instance to be backed up is the default, specify DEFAULT. If the instance name is omitted, use the drmsqlinit command to display information for all registered instances.
• • • • • • The name of the SQL Server database The transaction log Data file information File system information Physical disk information Logical volume structure information When you specify this option with instance-name, only information about the device files of the specified instance will be displayed. When instance-name is omitted, information about the device files of all of the instances will be displayed.
• When disk information for snapshot is set up in the dictionary map files. -coremap Specify this option to update the core map file. This option is available only when it is specified together with instance-name. If the core map file does not exist, a new core map file is created. At this time, if the update of the dictionary map files fails, the contents of the core map file are deleted.
PROMPT> drmsqldisplay SQL1 -l INSTANCE: SQL1 T DB OBJECT FILE FS FSTYPE DG LVM-DEVICE DEVICE COPY-GROUP PORT# TID# LUN# MU# LDEV# P/S SERIAL# D DB1 DATAFILE D:\SQL\data1.
\\?\Volume{df67a5b0-5583-11d5-a410-806d6172696f}\ Harddisk1 VG02,dev01 CLI-A 2 11 0 10001 P - - - 15044 VG02,dev01 CLI-A 2 21 0 10021 S T DB2 TRANSACT E:\SQL\tlog2.
drmsqlinit (Registers parameters for SQL Server) Formats To register parameters for SQL Server: drmsqlinit instance-name To display the parameters registered for SQL Server: drmsqlinit -v instance-name Description The drmsqlinit command provides an interactive interface that lets you register the SQL Server parameters necessary to back up an SQL Server database. You can register parameters for each instance. This command registers the following information.
same message will be displayed if Standby is specified for Recovery Mode, in the drmsqlrecovertool dialog box. If this error message is displayed, use the drmsqlinit command to set the UNDO file storage directory. Note that you cannot specify the directory containing the SQL Server database configuration definition file (instance-name.dat, in which parameters are registered) for the UNDO file storage directory.
Return Values 0: Normal termination Any value other than 0: Termination with an error Examples • In this example, the command is used to set up the instance SQL1: PROMPT> drmsqlinit SQL1 KAVX1100-I Enter the name of the storage directory for VDI metafiles: D:\MSSQL\Meta KAVX1101-I Enter the timeout interval for VDI generation (in seconds, between 0 and 3600): 10 KAVX1102-I Enter the name of the storage directory for undo files: D:\MSSQL\Undo KAVX1107-I Enter the name of the storage directory for the backup
drmsqllogbackup backup-ID -v [ -target database-name | -f target-definition-file-name ] [-s log-backup-ID ][-e log-backup-ID ] To delete transaction log backups when the backup catalog exists: drmsqllogbackup backup-ID -d [ -s log-backup-ID ] [ -e log-backup-ID ] To delete transaction log backups when the backup catalog does not exist: drmsqllogbackup instance-name -d [ -s log-backup-ID ] [ -e log-backup-ID ] To display the detailed information of transaction log files in the log backup catalog: drmsqllo
• In this example, the command views information on the backups of the transaction log backup files with the original ID 0000000001: PROMPT> drmsqllogbackup O:0000000001 -v • In this example, the command deletes information on the backups of the transaction log backup files with the original ID 0000000001: PROMPT> drmsqllogbackup O:0000000001 -d -v Specify this option to display a list of the transaction log files that were backed up.
-d Specify this option to delete the backups of the acquired transaction log files. -s log-backup-ID Specify this option to set the start of the range of the transaction log backup files to be deleted or displayed. Use this option together with the -e option to specify the start and end of this range. Specifying the -s option alone sets the range from the backup ID that was specified with the -s option to the last log backup ID. Possible log backup ID values are 0001 through 9999.
1. For the record to which a hyphen is displayed for BACKUP-ID, check the value of LAST-FULL-BACKUP-TIME. 2. Execute drmsqlcat -lsn. 3. From the execution result of drmsqlcat -lsn, find a record whose value for FULL-BACKUP-TIME is the same as the value for LAST-FULL-BACKUP-TIME found in step 1. 4. Check the backup ID for the record found in step 3. Notes • This command cannot be applied to the system databases (master, msdb, model, tempdb, and distribution).
Examples • In this example, the command is used to back up the transaction log file of the instance DEFAULT: PROMPT> drmsqllogbackup DEFAULT • In this example, the command is used to display information on the backups of the transaction log backup files with backup ID 0000000020 and with a log backup ID from 0001 to 0003: PROMPT> drmsqllogbackup 0000000020 -v -s 0001 -e 0003 [userDB1] C:\LogBackup\userDB1_20021106010101_0001.bk C:\LogBackup\userDB1_20021106050101_0002.
0000000002 0000000002 userDB1,userDB2 --> Displays comma-separated information. 0000000003 0000000003 userDB2 PROMPT> • In this example, the command is used to display the backup information of the transaction log obtained with the -no_cat option: PROMPT>drmsqllogbackup -no_cat -v # ORIGINAL-ID:BACKUP-ID:[UserDB3] C:\MSSQL\FLORA4\default\tlog\UserDB3_20040116163638_0001.bk C:\MSSQL\FLORA4\default\tlog\UserDB3_20040116163640_0002.
Description The drmsqlrecover command recovers a database restored by the drmsqlrestore command. This command applies transaction logs that are specified in a target definition file for transaction logs or acquired during backup, and performs roll-forward recovery processing. During command execution, from another computer such as an application server, you should not connect to the database that was restored. If another server connects to the database during command execution, the command might fail.
If both the -undo option and -loading option are omitted, the database can be fully accessed after recovery, but any subsequent transaction logs are not applied. -loading Specify this to place the database in the loading status after recovery. In this status, transaction logs can continue to be applied. When the -loading option is specified, because no temporary files are created as with the -undo option, you do not need to create the temporary file storage directory beforehand.
Figure 1 drmsqlrecovertool dialog box INSTANCE Displays the instance name specified for the drmsqlrecovertool command. The command will recover this instance. To change the instance, close the drmsqlrecovertool dialog box, and then re-execute the drmsqlrecovertool command. Transaction log backup list Displays a list of transaction log backup files that apply to the database selected in Target database. Use the Add button to add a file to this list. Use the Delete button to delete a file.
Roll forward? Select whether or not to perform a roll-forward during recovery. If No is selected, the Transaction log backup list becomes inactive. Recovery takes place without a roll forward, even when transaction log backup files are displayed. Add button Choose this button to add a transaction log file to be applied. This button adds the selected file to the files selected in Transaction log backup list. The files are sorted by name (not including file extensions and paths) and added.
drmsqlrestore backup-ID -resync [ -force ][ -undo ][ -nochk_host ] [ -instance name-of-the-SQL-Server-instance ] [ -target database-name | -f target-definition-file-name ] [ -pf copy-parameter-definition-file ] To apply only the metafile to the primary volume: drmsqlrestore backup-ID -no_resync [ -undo ][ -nochk_host ] [ -instance name-of-the-SQL-Server-instance ] [ -target database-name | -f target-definition-file-name ] To restore backup data on the remote site by resynchronization: drmsqlrestore backup
2. 3. The command performs disk resynchronization to restore the backup data from a secondary volume to the primary volume. The command brings the disk resource online, and then brings the cluster resource, including databases, online. If ONLINE is set in CLU_MSCS_RESTORE in the Application Agent configuration definition file (init.conf), you can perform restoration of a user database while the cluster resources are online by specifying the -resync option.
Before a backup After a backup Primary volume Primary volume Command execution result Secondary volume MBR disk Command status Error (DRM-10337 message) Before resynchronizing#2 MBR disk GPT disk GPT disk Error (DRM-10337 message) Before resynchronizing#2 MBR disk Error (KAVX5171-E or KAVX5137-E message) GPT disk Normal termination GPT disk After resynchronizing#1 #1 The error message is displayed after resynchronizing. #2 The error message is displayed before resynchronizing.
appears, indicating that no parameters are set for the drmsqlinit command. Specify the UNDO file storage directory using the drmsqlinit command. When this option is omitted, a regular restoration is performed. In this case, the database will be placed in loading status after the restoration has finished, and will not be usable. -nochk_host Specify this option to restore the data to a host other than the one specified in the drmsqlbackup command.
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.
PROMPT> drmsqlrestore 0000000002 -resync -nochk_host -template KAVX0001-I drmsqlrestore command will now start. KAVX1316-I Performing restore pre-processing... KAVX1000-I Logged on to the SQL Server system. KAVX1300-I Restore processing will now start. KAVX1000-I Logged on to the SQL Server system. KAVX1301-I Restore processing has finished. KAVX1318-I Performing restore post-processing... KAVX1001-I Logged off from the SQL Server system. KAVX0002-I drmsqlrestore command will now end.
[ [ [ [ -event_check ] [ -comment backup-comment ] -vf VSS-definition-file-name ] -script user-script-file-name ] -s backup-server-name [ -auto_import [ -auto_mount [ mount-point-directory-name ]] ] [ -svol_check ] ] To perform a backup by using VSS (Exchange Server 2010): drmexgbackup -mode vss [ -target Information-Store-name | -f target-definition-file-name ] [ -rc [ name-identifying-the-generation ]] [ -pf copy-parameter-definition-file ] [ -transact_log_del | -noverify | -noverify_log_del ] [ -eve
map files are created using the drmexgbackup command. In this case, the processing time required to create the dictionary map files are added to the time required to execute the backup command. Backup can only be performed for files described in the following table. Table 45 Files backed up as targets of an Exchange Server Option Database to be backed up File to be backed up *.edb *.stm# The target file type is fixed The target file type is fixed Data files # Transaction log file *.
-target storage-group-names Specify this option to back up the database resources containing the specific storage group. However, the minimum unit for backup is a physical volume. If a single physical volume contains multiple storage groups, specify all of the storage groups. If you specify only some of the storage groups, a command error occurs. When specifying multiple storage groups to be backed up, use a comma to separate each storage group name.
You cannot specify this option with the -cascade option. -transact_log_del Specify this option to delete the committed transaction log files. When this command is executed, the transaction log file is deleted. This means that you will no longer be able to use the -recovery option to perform restoration from backups already performed. This option is not valid when wraparound logs are being used. For more information about wraparound logs, see the Exchange Server manual.
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. -vf VSS-definition-file-name Specify this option to switch the settings to be used for each VSS backup. You can use this option only when using VSS for backups.
Specify this option to automatically mount a secondary volume on a backup server after backing up a volume. This option must be specified concurrently with other options by using the combinations in either 1 or 2 below. 1. The -s and -auto_import options 2. The -cascade and -auto_import options Specify mount-point-directory-name by using a character string of up to 64 bytes. If you omit the mount-point-directory-name parameter, a mount destination for a secondary volume is automatically determined.
If you specify the -f option concurrently with this option, the target definition file specified in the -f option needs to exist on both the local site and remote site. When this option is specified, the backup server defined in the cascade configuration information file is used. The following backup servers are ignored: • A backup server defined in the default VSS definition file (vsscom.
Storage group name = STR1 KAVX0002-I The drmexgbackup command will now end. • In this example, the command is used to perform a cold backup for the storage groups specified in the target definition file C:\temp\BACKUP_DB.txt: PROMPT> drmexgbackup -mode cold -f C:\temp\BACKUP_DB.txt KAVX0001-I The drmexgbackup command will now start. KAVX1805-I The information store will now be dismounted. Storage group name = STR1 KAVX1805-I The information store will now be dismounted.
KAVX0256-I A connection to the Protection Manager service will now be established. Host name = BKSERV2 KAVX5108-I Resynchronizing a copy group. Copy group name = SI01,dev01 KAVX5108-I Resynchronizing a copy group. Copy group name = SI01,dev02 KAVX0257-I The connection with the Protection Manager service will now be terminated. Host name = BKSERV2 KAVX5404-I Processing to resynchronize a copy group was performed by using DBSERV2.
[ -backup_id backup-ID ][ -hostname host-name ] [ -comment backup-comment ] For Exchange Server 2010: drmexgcat [ [ [ [ [ -target Information-Store-name | -f target-definition-file-name] -transact_log ][ -datafile ] -device device-file-name][ -l ][ -v ] -backup_id backup-ID ][ -hostname host-name ] -comment backup-comment] Description The drmexgcat command displays the backup information of the Exchange database on the server where the command is executed.
Displayed item Meaning FILE#1, #2 File name FS Mount point directory name FSTYPE File system type (NTFS) DG The name of the disk group (for an environment with a logical volume manager), or a hyphen (-) (for a basic disk configuration) LVM-DEVICE The name of the logical device file (for an environment with a logical volume manager) or GUID (for an environment without a logical volume manager) DEVICE#3 Harddiskn (where n is an integer) COPY-GROUP The copy group name, displayed as follows: RAID
#3 When this command is executed with the -device option specified, this information will be displayed after OBJECT. #4 The command executed with the -v option displays this information. A hyphen (-) is displayed for any item that cannot be displayed. If none of the items can be displayed, an error message is displayed. Each item is separated by a space. Arguments -target storage-group-names Specifies that information relating to certain storage groups that will be displayed.
When you specify this option with the -target option or -f option, only information pertaining to the data file of the specified storage group or Information Store will be displayed when this option is specified. If either the -target or the -f option is omitted, information pertaining to all data files of all storage groups or Information Stores will be displayed. -device device-file-name Specifies that only information relating to the device file is to be displayed.
If two double quotation marks are specified after the -comment option (as in -comment ""), a message is displayed indicating that no backup data exists. Note When specifying on the command line a file name or directory name containing space characters for the -target or -f option, you must enclose the file name in double quotation marks ("). Note that enclosing with double quotation marks is not necessary for target paths specified in batch definition files.
PROMPT> drmexgcat -target STR1 -l STORAGEGROUP: STR1 BACKUP-ID:0000000001 BACKUP-MODE: COLD STORAGEGROUP: STR1 ORIGINAL-ID:0000000001 START-TIME:2002/06/01 10:00:00 END-TIME: 2002/06/01 10:01:00 HOSTNAME:EXG_SRV1 T OBJECT INFORMATIONSTORE FILE FS FSTYPE DG LVM-DEVICE DEVICE COPY-GROUP PORT# TID# LUN# MU# LDEV# P/S SERIAL# M MAILBOXSTORE MAILBOX1(STR1) D:\STR1\priv1.
Harddisk2 VG01,VG01_000 - VG01,VG01_000 M MAILBOXSTORE Mail2 Harddisk3 - T TRANSACT VG01,VG01_001 VG01,VG01_001 Mail2 Harddisk2 VG01,VG01_000 - VG01,VG01_000 C CHECKPOINT Mail2 Harddisk2 VG01,VG01_000 - VG01,VG01_000 P PUBLICSTORE Pub Harddisk5 - T TRANSACT VG01,VG01_003 VG01,VG01_003 Pub Harddisk4 VG01,VG01_002 - VG01,VG01_002 C CHECKPOINT Pub Harddisk4 - - VG01,VG01_002 VG01,VG01_002 - - M:\mount\VG01\001\Mail2\mail.edb M:\mount\VG01\001 - - M:\mount\VG01\000\Mail2\E01*.
drmexgdisplay [ -target Information-Store-name | -f target-definition-file-name ] [ -transact_log ][ -datafile ][ -v ] [ -device device-file-name][ -l ][ -cf ] To update the dictionary map files to the latest status (Exchange Server 2003 or Exchange Server 2007): drmexgdisplay [ storage-group-name ] -refresh [ -coremap ] To update the dictionary map files to the latest status (Exchange Server 2010): drmexgdisplay [ Information-Store-name ] -refresh [ -coremap ] Description The drmexgdisplay command does
Displayed item Meaning FS Mount point directory name FSTYPE File system type (NTFS) DG A disk group name (when using a logical volume manager) or a hyphen (-) (when using a basic disk configuration) LVM-DEVICE A logical device file name (when using a logical volume manager) or a GUID (when logical volume manager has not been implemented) DEVICE#3 Harddiskn (where n is an integer) COPY-GROUP The copy group name, displayed as follows: RAID-Manager-volume-group-name,paired-volume-name PORT# Port
Displayed item Meaning CORE-MAPFILE-UPDATE-TIME#4 Update time for the core map file APP.-MAPFILE-UPDATE-TIME#4 Update time for the application map file #1 The following are how Exchange Server 2007 differs from Exchange Server 2003: • Data files (*.stm) do not exist and, therefore, are not displayed. • Information related to transaction log files (*.log) is not displayed for each file.
-transact_log Specifies that you want to display only information relating to the transaction logs. This option will display the following information: • • • • The name of the transaction log file File system information Logical volume structure information Physical disk information When you specify this option with the -target option or -f option, only information pertaining to the transaction log of the specified storage group or Information Store will be displayed when this option is specified.
Specifies that information related to the storage group or Information Store will be displayed in the long format. -cf Specify this option to display local or remote copy types, or the name identifying the generation corresponding to the copy group name. The remote information is also displayed. storage-group-name Use this option with the -refresh option to specify the storage group for which the dictionary map files are to be updated.
PROMPT> drmexgdisplay -target STR1 -v STORAGEGROUP: STR1 T OBJECT INFORMATIONSTORE FILE COPY-GROUP M MAILBOXSTORE MAILBOX1(STR1) D:\STR1\priv1.edb VG01,dev01 - VG01,dev01 M MAILBOXSTORE MAILBOX1(STR1) D:\STR1\priv1.stm VG01,dev01 - VG01,dev01 P PUBLICSTORE PUBLIC1(STR1) D:\STR1\pub1.edb VG01,dev01 - VG01,dev01 P PUBLICSTORE PUBLIC1(STR1) D:\STR1\pub1.stm VG01,dev01 - VG01,dev01 T TRANSACT E:\STR1\E00.log VG01,dev02 - VG01,dev02 T TRANSACT E:\STR1\E000001.
\\?\Volume{2ef9993d-803e-11d7-96ae-0000e26ac10d}\ Harddisk1 0 10001 P 15044 - 0 10011 S 15044 T TRANSACT E:\STR1\E000001.log E: \\?\Volume{2ef9993d-803e-11d7-96ae-0000e26ac10d}\ Harddisk1 0 10001 P 15044 - 0 10011 S 15044 T TRANSACT E:\STR1\E000002.log E: \\?\Volume{2ef9993d-803e-11d7-96ae-0000e26ac10d}\ Harddisk1 0 10001 P 15044 - 0 10011 S 15044 T TRANSACT E:\STR1\E000003.log E: \\?\Volume{2ef9993d-803e-11d7-96ae-0000e26ac10d}\ Harddisk1 0 10001 P 15044 - 0 10011 S 15044 C CHECKPOINT E:\STR1\E00.
- - - - Harddisk6 - - - M:\mount\VG01\004 - - - M:\mount\VG01\005 - - VG01,VG01_004 - Harddisk7 VG01,VG01_005 - - - VG01,VG01_004 - - VG01,VG01_002 VG01,VG01_005 • In this example, the command is used to output information for the Information Store specified by the Information Store Mail2 (Exchange Server 2010): PROMPT> drmexgdisplay –target Mail2 STORAGEGROUP: /EXCHANGE T OBJECT INFORMATIONSTORE FILE DG DEVICE COPY-GROUP M MAILBOXSTORE Mail2 M:\mount\VG01\001\Mail2\mail.
drmexgrestore backup-ID -resync -recovery [ -target storage-group-name\Information-Store-name,...
In restoration, data on the primary volume is overwritten by the disk image of the secondary volume at the time backup is performed. Therefore, data on the primary volume that was created or updated after the backup is invalid. Arguments backup-ID Specify the backup ID of the backup data to be restored. The backup ID is used to uniquely identify backup data, and is registered in the backup catalog during backup. To check a backup ID, execute the drmexgcat command.
-force Specify this option to restore the data from the secondary volume to the primary volume by forcibly resynchronizing the volumes. With this option, forced resynchronization is performed if the copy group name of the primary volume obtained when backup processing was performed on the database server matches the information on the database server, even though the LDEV and SERIAL numbers do not match the LDEV and SERIAL numbers when backup processing was performed.
-ef Exchange-environment-setting-file-name Specify this option to change the parameter used for linking with Exchange Server each time a command is executed. For Exchange-environment-setting-file-name, specify a file name only. Do not specify a folder name. The specified Exchange environment settings file must be stored in the following folder: Application-Agent-installation-folder\conf\exchange If this option is omitted, the default value is used.
PROMPT> drmexgrestore 0000000001 -resync KAVX0001-I The drmexgrestore command will now start. KAVX1805-I The information store will now be dismounted. Storage group name = STR1 KAVX1700-I Restore processing will now start. KAVX1701-I Restore processing has finished. KAVX1806-I The information store will now be mounted. Storage group name = STR1 KAVX0002-I The drmexgrestore command will now end.
Storage group name = STR1 KAVX1737-I The seed processing has finished. Storage group name = STR1 KAVX1734-I The replication function of Exchange Server has resumed. Storage group name = STR1 KAVX1736-I The seed processing will now start. Storage group name = STR2 KAVX1737-I The seed processing has finished. Storage group name = STR2 KAVX1734-I The replication function of Exchange Server has resumed. Storage group name = STR2 KAVX0002-I The drmexgrestore command will now end.
Information store name = Mail01 KAVX1809-I The information store will now be mounted. Information store name = Mail02 KAVX1757-I Seed processing will now start. Exchange Server name = DatabaseServer2 Information store name = Mail01 KAVX1758-I Seed processing has finished. Exchange Server name = DatabaseServer2 Information store name = Mail01 KAVX1755-I The replication function of Exchange Server has resumed.
Arguments backup-ID Specify the backup ID of the secondary volume for which you want to verify the integrity. A backup ID has been assigned when a backup catalog was created in the backup server by exporting and importing information. Note For an online backup, this command only verifies the integrity of an Exchange database (*.edb files), and not of an Exchange streaming database (*.stm files).
Basic commands
3 Support and other resources Numerous support options are available. Contacting HP HP technical support For worldwide technical support information, see the HP support website: http://www.hp.
Support and other resources
Index B basic command functionality concealing and revealing physical volume, 114 create and delete Application Agent database, 141 basic command path , 81 basic commands drmappcat, 103 drmcgctl, 106 drmclusinit, 108 drmdbexport, 112 drmdbimport, 113 drmdbsetup, 141 drmdevctl, 113 drmexgbackup, 183 drmexgcat, 192 drmexgdisplay, 199 drmexgrestore, 207 drmexgverify, 214 drmfsbackup, 84 drmfscat, 89 drmfsdisplay, 95 drmfsrestore, 99 drmhostinfo, 119 drmmediabackup, 123 drmmediarestore, 125 drmmount, 127 drmre
C check tool EX_DRM_EXG_DEF_CHECK, 69 EX_DRM_FS_DEF_CHECK, 20 EX_DRM_SQL_DEF_CHECK, 53 coding rules for creating transaction log target definition file, 82 common commands basic command specifications, 103 extended command specifications, 24 conceal and reveal physical volume , conventions for creating target definition file, 81 create and delete Application Agent database , 141 D data file (for SQL Server database), 49, 143 displaying information for Information Store, 199 displaying information for stora
extended commands EX_DRM_BACKUPID_SET, 24 EX_DRM_CACHE_PURGE, 36 EX_DRM_CG_DEF_CHECK, 26 EX_DRM_DB_EXPORT, 27 EX_DRM_DB_IMPORT, 28 EX_DRM_EXG_BACKUP, 63 EX_DRM_EXG_DEF_CHECK, 69 EX_DRM_EXG_RESTORE, 72 EX_DRM_EXG_VERIFY, 76 EX_DRM_FS_BACKUP, 15 EX_DRM_FS_DEF_CHECK, 20 EX_DRM_FS_RESTORE, 22 EX_DRM_FTP_GET, 29 EX_DRM_FTP_PUT, 31 EX_DRM_HOST_DEF_CHECK, 32 EX_DRM_MOUNT, 38 EX_DRM_RESYNC, 34 EX_DRM_SQL_BACKUP, 48 EX_DRM_SQL_DEF_CHECK, 53 EX_DRM_SQL_RESTORE, 56 EX_DRM_SQL_TLOG_BACKUP, 59 EX_DRM_SQLFILE_EXTRACT, 60
