| ETERNUS SF AdvancedCopy Manager Operator's Guide 13.0 -Microsoft(R) Windows(R) 2000- -Microsoft(R) Windows Server(TM) 2003- |
|
Contents
Index
|
This chapter describes using commands.
All the commands provided in this chapter should be installed in the Win32app\AdvancedCopyManager directory of the C drive.
This chapter describes operations using Backup Management Commands
Only the user belonging to the Administrators group can execute all the commands of backup management. When command execution is carried out by other users, a message " swst0601 This Command cannot be run. This is because the user is not a root user." is outputted and then, an error end.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
swstbackstat
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swstbackup
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the storage server must be operating.swstbkpoldel
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.swstbkpoldisp
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swstbkpolset
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.swstcancelrest
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swstcancelsync
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the storage server must be operating.swstcanceltrk
When this command is executed with the -h option specified on the storage management server, the daemons/services of the storage management server and target storage server must be active.
swstdevdisp
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swstdevinfoset
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.swstexecstat
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swsthistdel
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swsthistdisp
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swstresback
-
swstresrst
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To execute this command with the -x option specified, the daemons and services of the storage management server must be operating.swstrestore
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swstreststat
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swstsrsemtch
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To execute this command with the -x option specified, the daemons and services of the storage management server must be operating.swststartsync
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.swstsvrdisp
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swstsvrset
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.swstsyncstat
To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:
-h option specified, or
No device name specified
swsttrkstat
When this command is executed in the following format on the storage management server, the daemons/services of the storage management server and target storage server must be active:
-h option is specified, or
No device name is specified.
swstvolunlock
The daemons and services of the storage management server must be operating.
swstvollockstat
The daemons and services of the storage management server must be operating.
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
swstsvrset
Required
Transaction operation node
swstsvrdisp
Required
Transaction operation node
swstdevinfoset
Required
Transaction operation node
swstdevdisp
Required
Transaction operation node
swstbkpolset
Required
Transaction operation node
swstbkpoldisp
Required
Transaction operation node
swstbkpoldel
Required
Transaction operation node
swstbackup
Required
Transaction operation node
swstbackstat
Required
Transaction operation node
swstrestore
Required
Transaction operation node
swstcancelrest
Required
Transaction operation node
swstreststat
Required
Transaction operation node
swsthistdisp
Required
Transaction operation node
swsthistdel
Required
Transaction operation node
swststartsync
Required
Transaction operation node
swstcancelsync
Required
Transaction operation node
swstsyncstat
Required
Transaction operation node
swstexecstat
Required
Transaction operation node
swstdrvset
Required
Transaction operation node
swstdrvunset
Required
Transaction operation node
swstdismount
Required
Transaction operation node
swstvolunlock
Required
Transaction operation node
swstvollockstat
Required
Transaction operation node
swstcanceltrk
Required
Transaction operation node
swsttrkstat
Required
Transaction operation node
swstsrsemtch
Required
Transaction operation node
swstresback
Required
Transaction operation node
swstresrst
Required
Transaction operation node
The following commands are used to define a backup environment:
|
Function |
Command name |
Description |
|---|---|---|
|
swstsvrset |
Sets the configuration information of a storage server. |
|
|
swstsvrdisp |
Displays the configuration information of a storage server. |
|
|
swstdevinfoset |
Sets the use of a device. |
|
|
swstdevdisp |
Displays the information of a device. |
|
|
swstbkpolset |
Sets a backup policy. |
|
|
swstbkpoldisp |
Displays a backup policy that has been set. |
|
|
swstbkpoldel |
Deletes a backup policy that has been set |
This command sets configuration information of a storage server for the backup operation.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstsvrset [To be executed on a storage management server] program-directory\bin\swstsvrset [-h Server] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies the name of a storage server to be subject to the backup operation. This option is valid only on a storage management server. If this option is omitted, the storage server on which the command is entered will be subject to the processing. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Set configuration information of a storage server.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrset swstsvrset completed C:\> |
Set configuration information of a storage server (Work2) from a storage management server.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrset -h Work2 swstsvrset completed C:\> |
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command(swstsvrset)
Backup policy setting command (swstbkpolset)
Backup policy deletion command (swstbkpoldel)
Backup execution command (swstbackup)
Restore execution command (swstrestore)
Restore cancellation command (swstcancelrest)
Backup synchronous processing start command (swststartsync)
Backup synchronous processing cancel command (swstcancelsync)
Device information setting command (swstdevinfoset)
History information deletion command (swsthistdel)
Tracking cancel command (swstcanceltrk)
Resource backup command (swstresback)
Resource restore command (swstresrst)
Resource match command (swstsrsemtch)
SQL Server backup execution command (swstbackup_sqlsvr)
This command displays configuration information of a storage server, which has been set using the storage server configuration information setting command.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstsvrdisp [To be executed on a storage management server] program-directory\bin\swstsvrdisp [-h Storage-Server] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option is valid only on a storage management server. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display configuration information of a storage server (Work1).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrdisp Storage-Server = Work1 C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Storage-Server |
Displays a storage server name. |
Set a volume that has been allocated to the disk array unit ETERNUS storage system, as a transaction or backup volume.
A transaction volume refers to a volume that stores transaction data to be backed up. A backup volume refers to a volume used to store a backup of this transaction data.
The following devices can be registered on Windows as transaction and backup volumes.
SCSI driver resource (OS standard)
MPHD driver resource (Multipath disk control for WindowsNT)
MPLB driver resource
Only regular drives can be registered. No mirror set, stripe set, parity-protected stripe set, and volume set that can be recognized as FT (Fault Tolerant) drives can be registered. Additionally, the following file systems can be used (HPFS is not supported).
NTFS, FAT, and FAT32
You may want to change information (partition size, drive letter, and disk array unit cabinet information) on a device registered as a work or backup volume using an OS management tool such as Disk Management or a function such as GRmgr provided by the disk array unit. If you do, you need to deselect the target device from the work or backup volume and register it again.
If you add or delete a device (including disk array units and other general devices) on a storage server on Windows, use the "getting and reflecting information of all devices" option on the initial window to update the correspondence table between AdvancedCopy Manager device names and OS information.
If you want to perform the backup operation on a regular transaction volume, see "Deciding a backup target" for information on a transaction volume and "Preparing a backup volume" for information on a backup volume.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstdevinfoset -t | -b | -o Device-Name [To be executed on a storage management server] program-directory\bin\swstdevinfoset [-h Storage-Server] -t | -b | -o Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option is valid only on a storage management server. |
|
-t |
Register the specified device as a transaction volume. Cannot be specified at the same time as the -b and -o options. |
|
-b |
Register the specified device as a backup volume. Cannot be specified at the same time as the -t and -o options. |
|
-o |
Deregister the specified device if it has been registered as a transaction or backup volume. Cannot be specified at the same time as the -t and -b options. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies an AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Register a device (g1d1p2) as a transaction volume.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -t g1d1p2 swstdevinfoset completed C:\> |
Register a device (g1d2p1) as a backup volume.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -b g1d2p1 swstdevinfoset completed C:\> |
Deregister a device (g1d1p2) that has been registered as a transaction volume.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -o g1d1p2 swstdevinfoset completed C:\> |
A device cannot be registered as a transaction volume if:
Another device with the same logical volume information has already been registered as a transaction volume.
The space of the device to be registered overlaps the space of an already registered work or backup volume.
The device is a FT drive.
The device is a dynamic volume of Windows2000/Windows2003.
The device is a GPT disk.
A device cannot be registered as a backup volume if:
When the device of same case information (box identifier, OLU number, EXTENT starting position, and EXTENT size) has already been set as a backup volume.
The space of the device to be registered overlaps the space of an already registered work or backup volume.
A drive letter has been allocated to the device to be registered.
The device is a FT drive.
The device is a dynamic volume of Windows2000/Windows2003.
The device is a GPT disk.
the device is an SDX object.
When the device that is going to be set up is registered as a replication destination volume of replication management.
When the device that is going to be set up is registered as replication source volume of the duplicate volume information in which the bidirectional copy of replication management is possible.
You must delete related backup history information before:
Changing a backup volume to a transaction volume
Canceling the setting of a backup volume
You must delete a backup policy specified on a transaction volume before:
Changing a transaction volume to a backup volume
Canceling the setting of a transaction volume
Changing the transaction volume to a transaction volume subject to the SP operation
The following changes are not possible unless the related synchronous processing (EC session) is cancelled:
Changing a setting of a suspended transaction volume
Changing a setting of a suspended backup volume
To perform the following changes, the related tracking processing (OPC session) must be canceled in advance.
Changing the settings of a transaction volume in tracking processing
Changing the settings of a backup volume in tracking processing
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Backup policy setting command (swstbkpolset)
Backup policy deletion command (swstbkpoldel)
Backup execution command (swstbackup)
Restore execution command (swstrestore)
Restore cancellation command (swstcancelrest)
Backup synchronous processing start command (swststartsync)
Backup synchronous processing cancel command (swstcancelsync)
History information deletion command (swsthistdel)
Tracking cancel command (swstcanceltrk)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
SQL Server backup execution command (swstbackup_sqlsvr)
This command displays information of a transaction or backup volume or any other definable device, which has been set using the device information setting command (swstdevinfoset).
Specification method
|
[To be executed on a storage server] program-directory\bin\swstdevdisp [-t] [-b [-u]] [-o] [Device-Name] [To be executed on a storage management server] program-directory\bin\swstdevdisp [-h Storage-Server] [-t] [-b [-u]] [-o] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-t |
Displays information on a device that has been set as a transaction volume. Displays device information on all the transaction volumes if the device name in an operand is omitted. |
|
-b |
Displays a device that has been set as a backup volume. Displays device information on all the backup volumes if the device name in an operand is omitted. |
|
-u |
Changes the display format of the Device-Mode field. |
|
-o |
Displays all the devices other than those set as a transaction or backup volume. Displays all the devices other than those set as a transaction or backup volume if the device name in an operand is omitted. |
Information on a device that has been set as a transaction volume will be displayed if all of the t, b, and o options are omitted.
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. Displays device information on all the transaction volumes if this operand as well as the options are omitted. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the usage statuses of the registered devices.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevdisp -tb Server Device Size Device-Mode Mount-Point (Method) Backup-Engine Work2 g1d1p2 1.0 Gbyte Transaction D: (NTFS) AdvancedCopy Work2 g1d2p1 1.0 Gbyte Transaction E: (FAT) AdvancedCopy Work2 g1d2p1 1.0 Gbyte Backup (used) ---- (----) AdvancedCopy Work2 g1d2p2 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy Work2 g1d2p3 2.0 Gbyte Backup (used) ---- (----) AdvancedCopy Work2 g1d2p4 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy : C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Device |
Displays a AdvancedCopy Manager device name. |
|
Size |
Displays the size of a partition allocated to a device. |
|
Device-Mode |
Displays a character string by which a device can be identified.
A backup volume is indicated as "Backup (used)" if it is being used or "Backup (free)" if it is not used. During the backup process with -suspend or -T specified, the backup volume remains in use after history information is deleted. When the -u option is specified, "Backup (used-S)" is displayed for a backup volume in the suspend status for which history information was deleted, or "Backup (used-T)" is displayed for a backup volume in the tracking status for which history information was deleted. |
|
Mount-Point (Method) |
Displays the drive letter of a device. The file system type of the device is displayed inside the parentheses. |
|
Backup-Engine |
Displays the operation type.
|
This command sets a backup policy (numbers of preservation generations and interval days). The number of preservation generations means how many generations of backup data should be kept. The number of interval days means the number of days after execution of backup in which the next backup should be performed.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstbkpolset [-i Interval-Days] [-s Save-Number] [Device-Name] [To be executed on a storage management server] program-directory\bin\swstbkpolset [-h Storage-Server] [-i Interval-Days] [-s Save-Number] [Device-Name] |
Description of options
|
Option |
Description |
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-i |
Specifies the number of interval days. You can specify a value between 1 and 366. If this option is omitted during initial registration, 30 will be set. If this option is omitted during update, the existing value will be inherited. |
|
-s |
Specifies the number of preservation generations. You can specify a value between 1 and 31. If this option is omitted during initial registration, 2 will be set. If this option is omitted during update, the existing value will be inherited. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. If the device name is omitted, the backup policy will be set for all the transaction volumes. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Set a backup policy assuming 10 days as the number of interval days and three generations as the number of preservation generations for a transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpolset -i 10 -s 3 g1d1p2 g1d1p2 swstbkpolset completed C:\> |
Even if the number of interval days is specified, AdvancedCopy Manager does not automatically collect backup.
When you specify a backup policy, there must be as many backup volumes required operating according to the specified backup policy. To view information on the number of backup volumes required to perform the backup operation of a regular transaction volume, see "Preparing a backup volume".
You can change the number of preservation generations as long as the "history information count at the time" is equal to or less than the "number of preservation generations to be specified".
No backup policy can be set if:
There are not as many backup volumes as the specified number of preservation generations.
An option for more than the maximum number of preservation generations is specified.
An option for more than the maximum interval days is specified.
When the replication control function or tape backup function uses the target transaction volume
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This command displays a backup policy that has been set for a transaction volume.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstbkpoldisp [Device-Name] [To be executed on a storage management server] program-directory\bin\swstbkpoldisp [-h Storage-Server] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. If the device name is omitted, a backup policy for a transaction volume with a registered backup policy will be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display a backup policy of a transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldisp g1d1p2 Server Device Interval-Days Save-Number Mount-Point (Method) Work2 g1d1p2 30 2 D: (NTFS) C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Device |
Displays a AdvancedCopy Manager device name |
|
Interval-Days |
Displays a number of interval days. |
|
Save-Number |
Displays a number of preservation generations. |
|
Mount-Point (Method) |
Displays the drive letter of a device. The file system type of the device will be displayed inside the parentheses. |
A set backup policy is deleted by using this command. Delete the backup history information of the transaction volume prior to execution.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstbkpoldel Device-Name [To be executed on a storage management server] program-directory\bin\swstbkpoldel [-h Storage-Server] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Delete a backup policy that has been set on a transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldel g1d1p2 g1d1p2 swstbkpoldel completed C:\> |
No backup policy can be deleted if:
The transaction volume to be deleted has backup history information.
A transaction volume whose backup policies are to be deleted has already started backup synchronous processing.
When the replication control function or tape backup function uses the target transaction volume
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This chapter describes operation commands for backup management.
|
Function |
Command name |
Description |
|---|---|---|
|
swstbackup |
Performs the synchronous high-speed backup or snapshot fast backup. |
|
|
swstbackstat |
Displays the backup progress status. |
|
|
swstrestore |
Performs restoration. |
|
|
swstcancelrest |
Cancels the execution of restoration. |
|
|
swstreststat |
Displays the execution status of restoration. |
|
|
swsthistdisp |
Displays the history information that has been backed up. |
|
|
swsthistdel |
Deletes the history information that has been backed up. |
|
|
swststartsync |
Starts backup synchronous processing. |
|
|
swstcancelsync |
Aborts backup synchronous processing. |
|
|
swstsyncstat |
Displays the progress of the backup synchronous processing. |
|
|
swstexecstat |
Displays the execution status of a command executed on a transaction volume. |
|
|
swstdrvset |
Allocates a drive letter to a device. |
|
|
swstdrvunset |
Deallocates a drive letter that has been allocated to a drive. |
|
|
swstdismount |
This command dismounts a volume. |
|
|
swstvolunlock |
Unlocks a volume. |
|
|
swstvollockstat |
Displays information about a volume locked by the volume lock command. |
|
|
swstcanceltrk |
Stops tracking processing. |
|
|
swsttrkstat |
Displays the status of tracking processing. |
As for this command, operation changes with states of the advanced copy under execution.
When synchronous processing (EC) is not performed
Snapshot processing (OPC) is performed and the performance information, such as the date and backup volume of a copy place, is registered into backup history information.
When synchronous processing (EC) is performed
The state of synchronous processing is checked and, in the case of an equivalent nature maintenance state, backup synchronous processing is suspended. Information, such as time and backup volume of a copy place, is simultaneously registered into backup history information. Backup of such a form is called synchronous high-speed backup. (It becomes an error end when an equivalent nature maintenance state is not reached)
To use the Suspend/Resume function for synchronous high-speed backup, execute the backup command with -suspend specified, and suspend backup synchronous processing.
In both cases, it is established as backup and access of backup volume is attained from immediately after this command execution.
AdvancedCopy Manager executes a backup preprocessing and post pocessing scripts before and after executing. For information oncustomizing these scripts, see "Preprocessing and Postprocessing for Backup and Restoration".
AdvancedCopy Manager deletes the oldest backup history information automatically at the time of backup execution, when it has reached the maximum number of preservation generations (*1).
(*1) Set up by the Backup policy setting command(swstbkpolset).
Specification method
|
[To be executed on a storage server] program-directory\bin\swstbackup [-suspend|-T] Device-Name [-Xdevmap Device-Map-File] [-Xflush] [To be executed on a storage management server] program-directory\bin\swstbackup [-h Storage-Server] [-suspend|-T] Device-Name [-Xdevmap Device-Map-File] [-Xflush] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-Xdevmap |
Specifies a target backup volume to perform the snapshot fast backup. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, the target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file (of a storage server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character. |
|
-Xflush |
Specifies flushing the file system buffer of the transaction volume instead of locking the transaction volume. Before this option is specified, all write processing on the transaction volume must be stopped. (During a backup process where the write processing is not stopped, then the transaction volume data is not guaranteed.) The file system buffer can be flushed by specifying on for BufferFlushOnly in the transaction volume locking specification file for backups instead of this option. (For details, see "Transaction volume locking specification file for backups.") |
|
-suspend |
This results in synchronous high-speed backup using the Suspend/Resume function. |
|
-T |
Specifies that the differential snapshot high-speed backup be executed. This option cannot be specified during synchronous processing. This option is valid only for copying within a cabinet when the disk array supports the QuickOPC function. For the snapshot high-speed backup without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be always specified to perform a backup operation using differential snapshots. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
For more information on a device map file, see "Describing a device map file".
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Back up a transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbackup -h Work2 g1d1p2 g1d1p2 swstbackup completed C:\> |
Specify a target backup volume and back up a transaction volume (g1d1p2) in the snapshot fast backup.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbackup g1d1p2 -Xdevmap C:\advancedcopynanager\devmap1 g1d1p2 swstbackup completed C:\> |
To guarantee data, this command sets the transaction volume in a state in which it cannot be accessed from other processes before a backup is created. Therefore, the command locks the transaction volume. When the command is executed while the transaction volume is being used, the command ends with an error.
If the transaction volume is used by another server, the manager of backup must inhibit the access to the transaction volume by canceling the setting of sharing the transaction volume. If, for some reason, you do not want to cancel the setting of sharing the transaction volume, do as described below. For more information see "Preprocessing and Postprocessing of Backup and Restoration".
To synchronize the transaction volume with the file system in backup preprocessing, specify the Xflush option in this command or set BufferFlushOnly to on in the transaction volume locking specification file for backups.
In the backup postprocessing, execute the chkdsk command (allocate a drive letter to a backup volume using the drive letter allocation command (swstdrvset)) to check the file system of a backup volume.
Note that backup may not be completely performed using the above procedure. On any server other than the one on which this command is entered, you are recommended to perform backup in an environment in which a transaction volume is not used.
Backup cannot be executed in the following cases:
No backup policy has been specified for the specified transaction volume.
Backup executed one generation earlier was unsuccessful.
A transaction volume on which OPC is in progress has been specified.
The drive letter specified when the transaction volume was registered has been changed.
Restoration is being executed using backup history information that will cause a generation overflow. (When restoration is performed using the backup volume of the oldest history)
No unused backup volume to be used as the copying destination could be acquired.
Any of the cabinet information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume has been changed.
A drive letter has been allocated to a backup volume to be used as the copying destination.
When the state of SDX object is not in the following states.
Mirror volume is ACTIVE or STOP.
A SDX disk is enabling.
A mirror slice is ACTIVE or STOP.
When the transaction volume cannot be locked.
When the file system buffer of the transaction volume cannot be flushed by specification of the Xflush option.
When the contents of the transaction volume locking specification file for backups are invalid.
When a backup volume could not be locked
When the backup volume locking specification file for backups is invalid
When the replication control function or tape backup function uses the target transaction volume
When the replication control function or tape backup function uses the target backup volume
When the replication control function or tape backup function uses backup records exceeding the number of preservation generations
You cannot specify a target backup volume and perform backup if:
A backup volume specified in a device map file cannot be used as the backup volume for a corresponding transaction volume. In other words, not all the following conditions are met.
The specified backup volume is unused.
The transaction volume and the backup volume are not the same partition size.
The description on a target transaction volume of the device map file has an error (see "Describing a device map file").
A device map file name includes a national character.
At this time, if existing backup history information satisfies the condition of number of saved generations specified by the backup policy setting command, then information on the oldest generation is automatically deleted from the backup history information during the backup process, and the backup volume is cleared. However, if -suspend or -T is specified for the backup history information, then the backup volume with the Suspend ot tracking state is not cleared and the backup volume remains in use.
The transaction volume on which the backup command is executed, one other transaction volume, and the suspended or tracking backup volume cannot be specified as backup destinations in the device map file.
See "General notes", for notes on executing backup.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This command displays the completion status of backup that is being performed using the backup execution command.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstbackstat [Device-Name] [To be executed on a storage management server] program-directory\bin\swstbackstat [-h Storage-Server] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name corresponding to a transaction volume. If this operand is omitted, the backup execution statuses of all the transaction volumes will be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the actual copying execution status.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbackstat Server Transaction-Disk Backup-Disk Status Execute Work1 g1d1p2 g1d2p1 succeeded ---- Work1 g1d1p3 g1d2p2 executing 70% Work1 g1d1p4 g1d2p3 executing 30% : C:\> |
The following information will be displayed.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Transaction-Disk |
Displays the AdvancedCopy Manager device name of a transaction volume. |
|
Backup-Disk |
Displays a backup volume name. If no backup has been collected, "----" will be displayed. |
|
Status |
Displays a backup completion status using one of the following character strings.
|
|
Execute |
Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed. |
Do not use the OPC stop function of GRmgr/ETERNUSmgr while the snapshot fast backup is in progress. If you use the OPC stop function of GRmgr/ETERNUSmgr, it will display "succeeded" whether or not the backup has actually been successful.
If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".
The data that exists in backup history information is restored using OPC.
When the restore execution command is executed, AdvancedCopy Manager performs the restore preprocessing and postprocessing scripts before and after copying data using OPC. For more information on customizing these scripts, see "Preprocessing and Postprocessing for Backup and Restoration."
Specification method
|
[To be executed on a storage server] program-directory\bin\swstrestore [-g Generation-No | -v Version-No] [-r Restore-Device-Name] Device-Name [To be executed on a storage management server] program-directory\bin\swstrestore [-h Storage-Server [-g Generation-No | -v Version-No][-r Restore-Device-Name] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-g |
Specifies the relative generation number of data to be restored. Check the relative generation number using the history information display command (swsthistdisp). |
|
-v |
Specifies the absolute generation number of data to be restored. Check the absolute generation number using the history information display command (swsthistdisp). |
|
-r |
Specifies a restore destination device name to restore data to any other device than a transaction volume. |
Note: If neither the -g or -v option is specified, the latest information out of information under history management will be restored.
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name corresponding to a transaction volume. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Restore data with relative generation number 2 (For information on the relative generation number, see data displayed using the history information display command).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstrestore -g 2 g1d1p2 g1d1p2 swstrestore completed C:\> |
If the Suspend/Resume function is used for the backup operation on the transaction volume, the suspended synchronous processing is deleted and the restore command is executed. For information on the suspended synchronous processing, see the data displayed by the backup synchronous processing execution status display command. Execute the backup synchronous processing cancel command to cancel the synchronous processing.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 g1d2p6 suspend ---- Work2 g1d1p6 g1d3p6 executing 75% C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelsync -all g1d1p6 g1d1p6 swstcancelsync completed C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 ---- ---- ---- C:\>C:\Win32app\AdvancedCopyManager\bin\swstrestore g1d1p6 g1d1p6 swstrestore completed C:\> |
Restoration of each individual file cannot be performed because copying between devices will be performed.
You can restore data to any device other than a transaction volume. When you do so, the device must not be registered as a transaction volume and the device must have the same space size as the specified transaction volume.
On a transaction volume on which a file system has been constructed, restore a specific file as follows:
Allocate a drive letter to a backup volume using the drive letter allocation command (swstdrvset). Check the backup volume using the backup history list view or history information display command.
Copy a file to be restored using the copy command (Windows).
To unassign the drive letter of a backup volume use the command (swstdrvunset).
If the transaction volume is used by another server, the manager of backup must execute this command after inhibiting the access to the transaction volume. For example, canceling the setting of sharing the transaction volume (Windows).
Restoration or recovery cannot be executed in the following cases:
Both a relative and absolute generation numbers have been specified.
A device registered as a transaction volume has been specified in a parameter in the -r option.
When a device registered as a backup volume has been specified in a parameter in the -r option, the device has been registered in the backup registration information of a certain transaction volume. If you restore data to a backup volume without registered backup data, and the backup volume is used to back up a certain transaction volume, then data will be overwritten. You are recommended not to specify a backup volume as a restore destination device.
You perform restoration immediately after performing backup (the actual copying using OPC is in progress). In this case, perform restoration after the actual copying using OPC is completed. Alternatively, on a transaction volume on which a file system has been constructed, perform restoration according to the method described in Points.
Any of the cabinet information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a transaction volume to be restored has been changed.
A drive letter that has been allocated during transaction volume registration has been changed.
An SDX object has been specified in a parameter in the -r option.
When operating volume has two or more mount points
When other volumes are mounted by operating volume
When a target volume could not be locked
When the target volume locking specification file is invalid
When the replication control function or tape backup function uses the target transaction volume
When the replication control function or tape backup function uses the device specified in the -r option
The suspended or tracking backup volume cannot be used as the restore destination volume.
The restore command cannot be executed on a transaction volume during the synchronous processing (during copying by EC, under the equivalency maintain status, in the Suspend state).
If the following error occurs during restore processing, then execute the backup synchronous processing cancel command (with the -all option specified) to cancel all of the synchronous processing of the transaction volume, and execute the restore command.
swst0639 This Command cannot be run. This is because a copy is running.
or
swst0634 OPC cannot be run. (SCSI command busy)
See "General notes", for notes on executing restore.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
If the transaction volume is an SDX object, you cannot perform restoration using this command. If so, perform recovery as follows:
Assign a drive letter to a backup volume using the drive letter allocation command (swstdrvset). Check the backup volume using the backup history list view or history information display command.
Copy a file to be restored using the copy command.
Unassign the drive letter of a backup volume using the drive letter deallocation command (swstdrvunset).
This command cancels OPC-based restoration.
A hardware error will be detected when the restore execution command is executed while data is being copied using OPC. Remove the cause of the hardware error and repeat restoration using the restore execution command (swstrestore).
Check whether an abnormality occurred using the restore execution status display command (swstreststat).
Specification method
|
[To be executed on a storage server] program-directory\bin\swstcancelrest [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-emergency] Device-Name [To be executed on a storage management server] program-directory\bin\swstcancelrest [-h Storage-Server][-g Generation-No | -v Version-No][-r Restore-Device-Name] [-emergency] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-g |
Specifies the relative generation number of data being restored. This option cannot be specified at the same time as the -v option. Check the relative generation number using the restore execution status display command (swstreststat). |
|
-v |
Specifies the absolute generation number of data being restored. This option cannot be specified at the same time as the -g option. Check the absolute generation number using the restore execution status display command (swstreststat). |
|
-r |
Specifies the device name if data is restored to any other device than a transaction volume. Check the device name using the restore execution status display command (swstreststat). |
|
-emergency |
Emergency operation mode is available for operations. In such cases, OPC sessions are neither confirmed nor cancelled. |
Note: The restoration of the latest history information will be canceled if neither the -g or -v option is specified.
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Cancel restoration of the transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelrest -g 1 g1d1p2 g1d1p2 swstcancelrest completed C:\> |
Restoration of the latest history information on the transaction volume (g1d1p2) is cancelled in emergency operation mode.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelrest -emergency g1d1p2 g1d1p2 swstcancelrest completed C:\> |
If you cancel OPC-based restoration using this command, the transaction volume will be in an incomplete status and can no longer be used because part of the data has already been copied. Perform restoration again using the restore execution command (swstrestore).
You cannot cancel restoration if:
The history specified in the -g or -v option does not exist.
Restoration is not performed on the device specified in the -r option.
Restoration is not performed from the specified history. In this case, processing is terminated with an information message "swst0303 Restoration for specified restoration device is not performed". (The end status is a normal end.)
When the replication control function or tape backup function uses the target transaction volume
However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This command displays the execution status of restoration.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstreststat [-g Generation-No | -v Version-No] [Device-Name] [To be executed on a storage management server] program-directory\bin\swstreststat [-h Storage-Server [-g Generation-No | -v Version-No] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-g |
Specifies the relative generation number of data whose restore execution status should be displayed. |
|
-v |
Specifies the absolute generation number of data whose restore execution status should be displayed. |
Note: The restore execution statuses of all the historys will be displayed if both the -g and -v options are omitted.
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. If this operand is omitted, the restore execution statuses of all the transaction volumes will be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the restore execution statuses of transaction volumes.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstreststat Server Transaction-Disk Generation Version Backup-Disk Restore-Device Status Execute Work1 g1d1p2 1 10 g1d2p1 g1d3p2 executing 75% Work1 g1d1p3 ---- ---- ---- ---- ---- ---- Work1 g1d1p4 2 12 g1d2p3 ---- succeeded ---- Work1 g1d1p5 3 13 g1d2p4 g1d3p5 executing 75% : C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Transaction-Disk |
Displays the AdvancedCopy Manager device name of a transaction volume. |
|
Generation |
Displays the relative generation number of restored backup data. "----" will be displayed if no generation number is specified in the -g or -v option and no history being restored exists. |
|
Version |
Displays the absolute generation number of restored backup data. "----" will be displayed if no generation number is specified in the -g or -v option and no history being restored exists. |
|
Backup-Disk |
Displays the name of a backup volume from which data should be copied and restored. "----" will be displayed if restoration is not in progress. |
|
Restore-Device |
Displays a restore target device name unless data is copied and restored to a transaction volume. "----" will be displayed if restoration is not in progress or data is restored to a transaction volume. |
|
Status |
Displays an execution status.
|
|
Execute |
Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed. |
Do not use the OPC stop function of GRmgr while the snapshot fast backup is in progress. If you use the OPC stop function of GRmgr, this command displays "succeeded" whether or not the restoration has actually been successful.
If "failed" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".
If no generation number has been specified in the -v or -g option, the restore execution statuses of all the historys will be displayed. If, at this time, restoration is not in progress from any of the historys, "----" will be displayed in all the information fields other than "Server" and "Transaction-Disk".
This command displays history information that has been backed up.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsthistdisp [Device-Name] [To be executed on a storage management server] program-directory\bin\swsthistdisp [-h Storage-Server] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. If this operand is omitted, the backup history information of all the transaction volumes will be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the backup history information of all the transaction volumes.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsthistdisp Server=Work1 Device=g1d1p2 Mount-Point=D: (NTFS) Generation Version Backup-Date Backup-Device Status Execute 1 10 1999/11/12 22:00 g1d2p1 succeeded ---- 2 9 1999/11/11 22:00 g1d2p2 succeeded ---- Server=Work1 Device=g1d1p3 Mount-Point= E: (FAT) Generation Version Backup-Date Backup-Device Status Execute 1 13 1999/11/12 23:00 g1d3p1 succeeded ---- 2 12 1999/11/11 23:00 g1d3p2 succeeded ---- : C:\> |
The following information will be displayed.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Device |
Displays a AdvancedCopy Manager device name. |
|
Mount-Point |
Displays the drive letter of a device. The file system type of the device will be displayed inside the parentheses. |
|
Generation |
Displays a relative generation number. This item will not be displayed if no backup history information exists. |
|
Version |
Displays an absolute generation number. This item will not be displayed if no backup history information exists. |
|
Backup-Date |
Displays a date at which backup has been completed. This item will not be displayed if no backup history information exists. |
|
Backup-Device |
Displays the name of a backup volume to which data has been backed up. This item will not be displayed if no backup history information exists. |
|
Status |
Displays an actual copying execution status using one of the following character strings.
This item will not be displayed if no backup history information exists. |
|
Execute |
Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed. This item will not be displayed if no backup history information exists. |
If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".
This command deletes backup history information.
The backup volume of the deleted history is released and turns into empty backup volume.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsthistdel -g Generation-No| -v Version-No | -z [-emergency] Device-Name [To be executed on a storage management server] program-directory\bin\swsthistdel [-h Storage-Server] -g Generation-No| -v Version-No | -z [-emergency] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-g |
Specifies the relative generation number of backup history information to be deleted. This option cannot be specified at the same time as the -v or -z. Check the relative generation number using the history information display command (swsthistdisp). |
|
-v |
Specifies the absolute generation number of backup history information to be deleted. This option cannot be specified at the same time as the -g or -z. Check the absolute generation number using the history information display command (swsthistdisp). |
|
-z |
Specifies to delete all the backup history information. This option cannot be specified at the same time as the -g or -v. |
|
-emergency |
Emergency operation mode is available for operations. In such cases, OPC sessions are neither confirmed nor cancelled. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Delete a history with absolute generation number 10 of a transaction volume (g1d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swsthistdel -v 10 g1d1p2 g1d1p2 swsthistdel completed C:\> |
The history information of relative generation number 1 of the transaction volume (g1d1p2) is deleted in emergency operation mode.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsthistdel -g 1 -emergency g1d1p2 g1d1p2 swsthistdel completed C:\> |
If the history information display command displays "failed" in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".
You cannot delete backup history information if:
The backup history information specified in the -g or -v option does not exist.
The specified backup history information is used in restoration.
When the replication control function or tape backup function uses the target transaction volume
When the replication control function or tape backup function uses the target backup volume
However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.
Execution is not possible in emergency operation mode for a transaction volume on a machine in the SP series.
Deleting the suspended history information does not cancel the synchronous processing (EC session).
Deleteing the tracking history information does not cancel the tracking processing (OPC session).
In synchronous high-speed backup with -suspend specified, the backup volume remains in use even after the history information is deleted.
In differential snapshot high-speed backup with -T specified, the backup volume remains in use even after the the history information is deleted.
If the history information is deleted while the OPC physical copy has not been completed in a backup operation mode other than the differential snapshot high-speed backup, physical copying of the deleted history is interrupted. In this case, the data in the backup volume is incomplete (copy stopped halfway). The backup volume is put in the unused state upon deletion of the history information and becomes ready to use at the subsequent backup.
In the differential snapshot high-speed backup mode, the physical copying of the deleted history is continued even after the history information on the incomplete OPC physical copy is deleted. Even after deletion of the history information, the backup volume is in the busy state and becomes ready to use at the subsequent backup of the relevant transaction volume.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This command starts backup synchronous processing (starts disk-to-disk copy using EC).
Specification method
|
[To be executed on a storage server] program-directory\bin\swststartsync Device-Name [-Xdevmap Device-Map-File] [To be executed on a storage management server] program-directory\bin\swststartsync [-h Storage-Server] Device-Name [-Xdevmap Device-Map-File] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specify the name of a Storage server. This option can be specified only on the Storage management server. |
|
-Xdevmap |
Specifies a target backup volume to perform the backup synchronous processing. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, the target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file (of a storage server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
For more information on a device map file, see "Describing a device map file".
End status
= 0: Normally end
> 0: Abnormally end
Execution example
To start the backup synchronous processing for a transaction volume (g1d0p0):
C:\>C:\Win32app\AdvancedCopyManager\bin\swststartsync -h Work2 g1d0p0 g1d0p0 swststartsync completed. C:\> |
Synchronous processing of transaction volume (g1d1p2) begins specifying the backup volume at the output destination.
C:\>C:\Win32app\AdvancedCopyManager\bin\swststartsync g1d1p2 -Xdevmap C:\AdvancedCopyManager\devmap1 g1d1p2 swststartsync completed C:\> |
When you execute the backup synchronous processing start command for a transaction volume or log group to which the backup synchronous processing is being executed, the message, "swst0301 Backup synchronous processing is being executed." (For a log group, the message ID is swst0302) is output and then the command is terminated normally.
You cannot start backup synchronous processing in the following cases. In any of the cases below, take an action according to the "System administrator response" message.
When specifying a device that does not support the EC function.
When the backup volumes required to start backup synchronous processing cannot be obtained.
When specifying a device that is being restored by OPC.
When mounting the backup volume to which data is copied.
When a backup volume could not be locked
When the backup volume locking specification file for backups is invalid.
When the replication control function or tape backup function uses the target transaction volume.
If a suspended backup volume is the transaction volume at the start of the synchronous processing, then the suspended backup volume is selected as the backup destination with the highest priority, and the synchronous processing restarts (differential copy starts). Otherwise, the synchronous processing (full copy) starts.
Even if already in use, the transaction volume where the synchronous processing started and the suspended backup volume can be used as backup destinations.
Except for the transaction volume where the synchronous processing started and the suspended backup volume, transaction volumes cannot be specified as backup destinations in the device map file.
When any of the following commands is running, this command cannot be executed:
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
The backup synchronous processing during copying by EC or under the equivalency maintain status may be canceled.
The synchronous processing can be canceled with the backup volume during copying by EC, under the equivalency maintain status, or while the Suspend state is set. Specifying cancellation of all of the synchronous processing cancels all of the backup synchronous processing including those in the Suspended state.
If the system detects an error while backup synchronous processing is being executed, the copying being performed at that time terminates abnormally. In such a case, use this command to cancel the backup synchronous processing. Use the backup synchronous processing progress display command (swstsyncstat) to check for the error.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name [To be executed on a storage management server] program-directory\bin\swstcancelsync [-h Storage-Server] [-emergency] [-bd Backup-Device-Name | -all] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specify the name of a Storage server. This option can be specified only with a Storage management server. |
|
-emergency |
Emergency operation mode is available for operations. In such cases, EC sessions are neither confirmed nor cancelled. |
|
-bd |
The synchronous processing on a specific backup volume can be cancelled. To do so, specify the backup volume name in an operand. The backup volume name and -all option cannot be specified together. |
|
-all |
All of the synchronous processing of the transaction volume can be specified to be cancelled. This specification and the -bd option cannot be specified together. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
|
Backup-Device-Name |
Specify the copy destination backup volume name. Specify the AdvancedCopy Manager device name for the specified device. |
For more information on a device map file, see "Describing a device map file".
End status
= 0: Normally end
> 0: Abnormally end
Execution example
To cancel backup synchronous processing to a transaction volume (g1d0p0):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelsync g1d0p0 g1d0p0 swstcancelsync completed. C:\> |
Backup synchronous processing of transaction volume (g1d0p0) is cancelled in emergency operation mode.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelsync -emergency g1d0p0 g1d0p0 swstcancelsync completed. C:\> |
The backup synchronous processing of the backup volume (g1d1p2) can be specified to be canceled from the transaction volume (g1d1p6).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 g1d1p1 suspend ---- Work2 g1d1p6 g1d1p2 executing 75% C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelsync g1d1p6 -bd g1d1p2 g1d1p6 swstcancelsync completed. C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 g1d1p1 suspend ---- C:\> |
All of the backup synchronous processing of the transaction volume (g1d1p6) can be specified to be cancelled.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 g1d1p1 suspend ---- Work2 g1d1p6 g1d1p2 executing 75% C:\>C:\Win32app\AdvancedCopyManager\bin\swstcancelsync g1d1p6 -all g1d1p6 swstcancelsync completed. C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d1p6 Server Transaction-Disk Backup-Disk Status Execute Work2 g1d1p6 ---- ---- ---- C:\> |
However, EC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an EC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.
Execution is not possible in emergency operation mode for a transaction volume on a machine in the SP series.
You cannot perform cancel processing of synchronous backup processing in the following cases
When the replication control function or tape backup function uses the target transaction volume
This command cannot be executed when any of the following commands is running:
Storage server configuration information setting command (swstsvrset)
Device information setting command(swstdevinfoset)
Resource match command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintain status, in the suspended status).
If one transaction volume has multiple EC sessions, then the statuses of all of these EC sessions are displayed.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstsyncstat [Device-Name] [To be executed on a storage management server] program-directory\bin\swstsyncstat [-h Storage-Server] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specify the name of a Storage server. This option can be specified only with the Storage management server. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
For more information on a device map file, see "Describing a device map file".
End status
= 0: Normally end
> 0: Abnormally end
Execution example
To display the status of backup synchronous processing to a transaction volume (g1d1p2):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat g1d0p0 Server Transaction-Disk Backup-Disk Status Execute Work1 g1d1p2 g1d2p1 suspend ---- Work1 g1d1p2 g1d2p2 executing 75% C:\> |
To display the status of backup synchronous processing for all of the transaction volumes:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsyncstat Server Transaction-Disk Backup-Disk Status Execute Work1 g1d1p2 g1d2p1 suspend ---- Work1 g1d1p2 g1d2p2 executing 75% Work1 g1d1p2 g1d2p5 suspend ---- Work1 g1d1p3 g1d2p3 equivalent 100% Work1 g1d1p4 g1d2p4 failed ---- Work1 g1d1p5 ---- ---- ---- C:\> |
The table below lists the meaning of each title.
|
Title |
Description |
|---|---|
|
Server |
Indicates the name of the Storage server. |
|
Transaction-Disk |
Indicates the name of the transaction volume. |
|
Backup-Disk |
Indicates the name of the backup volume. When backup synchronous processing is not being executed, the system displays "----". |
|
Status |
Indicates the status of backup synchronous processing:
|
|
Execute |
Indicates the progress of the backup synchronous processing as a percentage (0 to 100%). "----" is displayed when the status is Suspend and at times not during the backup synchronous processing. |
If "failed" or "halt" is indicated as the status of the backup synchronous processing (in the Status field), a hardware failure is considered. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".
If "nosession" is indicated as the status of the backup synchronous processing (in the Status field)," resource information having inconsistency is considered. Use the resource match command (swstsrsemtch) to remove the inconsistency from the resource information.
This command displays the execution status of other commands executed on a transaction volume. The execution status of OPC/EC will be displayed if OPC/EC is being executed.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstexecstat [-j] [Device-Name] [To be executed on a storage management server] program-directory\bin\swstexecstat [-j] [-h Storage-Server] [Device-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-j |
Specifies to display information in another format. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name corresponding to a transaction volume. If this operand is omitted, the execution statuses of all the transaction volumes will be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the execution statuses of transaction volumes.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstexecstat Server Device Last-Backup-Date Interval Status Mount-Point (Method) Execute Work1 g1d1p2 2000/12/11 12:20 OK IDLE D: (NTFS) ---- Work1 g1d1p4 2000/12/09 12:20 DELAY=2 EXEC E: (NTFS) snapshot(45%) : C:\> |
The following information will be displayed.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Device |
Displays a AdvancedCopy Manager device name. |
|
Last-Backup-Date |
Displays the last backup date. * Displays the time when the backup execution command was accepted. |
|
Interval |
Displays how many days have passed after the specified number of interval days since the last backup date has been exceeded. This item will be displayed as "DELAY=number-of-days-passing". "OK" will be displayed if the number of interval days has not been exceeded. |
|
Status |
Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.
|
|
Mount-Point(Method) |
Displays the drive letter of a device. The file system type of the device will be displayed inside the parentheses. |
|
Execute |
Displays the name of a command being executed or the copying progress ratio.
|
If multiple processes are performed on transaction volumes (for example, when the backup synchronous processing start command is issued while a real copy of the snap shot backup is being handled), the display in the Execute field conforms to the following rule:
The display of a command name takes priority if both copying and command execution are in progress.
When a disk copy of the snap shot backup and a disk copy of the backup synchronous processing are being handled simultaneously, the progress of the disk copy of the backup synchronous processing is displayed. (A disk copy for restoration is not performed during disk copy of the snap shot backup or backup synchronous processing due to a restriction of the ETERNUS storage system.)
The execution example of using the "-j" option is as follows:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstexecstat -h Work2 -j Server Device Execute-Date Status Mount-Point (Method) Execute Work2 g1d1p2 ---- IDLE D: (NTFS) ---- Work2 g1d1p3 2000/12/10 12:20 EXEC E: (NTFS) sync Work2 g1d1p4 2000/12/09 12:20 EXEC F: (NTFS) swstbackup : C:\> |
The following information will be displayed.
|
Keyword |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Device |
Specifies a AdvancedCopy Manager device name. |
|
Execute-Date |
Displays the command execution time. |
|
Status |
Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.
|
|
Mount-Point(Method) |
Displays the drive letter of a device. The file system type of the device will be displayed inside the parentheses. |
| Execute |
Displays the name of a command being executed or the copying progress ratio.
|
During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute field.
If "sync (failed)", "snapshot(failed)", "restore(failed)", "sync (halt)", "snapshot(halt)" or "restore(halt)" is displayed in the "Execute" field, a hardware error may have occurred. After removing the cause of the hardware error, do as follows:
For "sync (failed)"
Execute the backup synchronous processing cancel command (swstcancelsync) to cancel the backup synchronous processing.
If "snapshot(failed)" is displayed
Delete backup history information using the history information deletion command (swsthisdel).
If "restore(failed)" is displayed
Cancel restoration using the restore cancellation command (swstcancelrest).
Use this command if you need to allocate a drive letter temporarily to a device when, for example, you restore an individual file.
Specification method
|
program-directory\bin\swstdrvset Device-Name [Drive-Letter] |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
|
Drive-Letter |
Specifies a drive letter to be allocated to a device. Valid drive letters include "C:" to "Z:". (The letters are not case-sensitive.) If this operand is omitted, an unused drive letter will be automatically selected (unused drive letters are searched starting from "Z:"). |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Allocate a drive letter (E:) to a device (g3d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdrvset g3d1p2 E: swst1001 E: has been allocated to g3d1p2. swstdrvset completed C:\> |
Allocate an appropriate used drive letter to a device (g3d1p3).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdrvset g3d1p3 Swst1001 Z: has been allocated to g3d1p3. swst0307 Z: is allocated to g3d1p3. swstdrvset completed C:\> |
You cannot allocate a drive letter if:
The specified drive letter has already been allocated to other drive or resource.
When this command is executed with no drive letter specified, no unused drive letter exists.
The user who executes a command does not have the administrators authority for the local machine.
When this command is executed with a drive letter specified, this drive letter has already been allocated (Warning message swst1011 will be displayed).
When this command is executed with no drive letter specified, one or more drive letters have already been allocated (Warning message swst1011 will be displayed).
This command is executed on a dynamic volume of Windows2000/Windows2003.
This command is executed on GPT disk.
On Windows2000/Windows2003, the target device is mounted on another device.
On Windows2000/Windows2003, the target device mounts another device.
On Windows2000/Windows2003, the target device mounts itself.
Do not use Disk Management when you use this command.
A drive letter allocated using this command is valid until the OS is shut down. When the OS is restarted, drive letters revert to the status before this command is executed.
The drive letter currently assigned to the device is canceled.
Specification method
|
program-directory\bin\swstdrvunset (Device-Name | Drive-Letter) |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
|
Drive-Letter |
Specifies a drive letter. Valid drive letters include "C:" to "Z:". (The letters are not case-sensitive.) |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Deallocate the drive letter of a device (g3d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdrvunset g3d1p2 swst1002 The allocation of the drive letter for g3d1p2 has been released. Drive letter=E: swstdrvunset completed C:\> |
Deallocate the drive letter of a device (Z:).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdrvunset Z: swst1002 The allocation of the drive letter for g3d1p3 has been released. Drive letter=Z: swstdrvunset completed C:\> |
You cannot unassign a drive letter if:
No drive letter has been allocated to the specified device.
The specified device is in use.
The specified drive letter has not been allocated to a device.
The specified device is either in use or shared.
The specified drive letter has been allocated to a device that does not have a AdvancedCopy Manager device name.
The user who executes the command does not have an administrators permission.
This command is executed on a dynamic volume of Windows2000/Windows2003.
This command is executed on GPT disk.
On Windows2000/Windows2003, the target device is mounted on another device.
On Windows2000/Windows2003, the target device mounts another device.
On Windows2000/Windows2003, the target device mounts itself.
Do not use Disk Management when you use this command.
A drive letter allocated using this command is valid until the OS is shut down. When the OS is restarted, drive letters revert to the status before this command is executed.
This command dismounts the specified volume. When the volume is dismounted, all handles opened for the volume becomes invalid. The OS automatically mounts the dismounted volume when the volume is accessed.
Specification method
|
program-directory\bin\swstdismount Device-Name |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The device (g3d1p2) is dismounted.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdismount g3d1p2 swstdismount completed C:\> |
Dismounting is not possible in the following situations:
The specified device name is invalid.
The volume is locked by another process.
This command unlocks a volume.
Specification method
|
program-directory\bin\swstvolunlock [-n] Device-Name |
Description of options
|
Option |
Description |
|---|---|
|
-n |
Specifies that a device is not to be dismounted before it is unlocked. |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies the name of an AdvancedCopy Manager device. |
End status
=0: Normal end
>0: Abnormal end
Execution example
Unlock a device (g3d1p2).
C:\>C:\Win32app\AdvancedCopyManager\bin\swstvolunlock g3d1p2 swstvolunlock completed C:\> |
This command does not work if:
The specified device name is invalid.
The device has not been locked.
The AdvancedCopy Manager's communication service has not been run or an error occurs in the service.
When this command is executed for a volume in a cluster system, set the name of the logical node for the transaction in the SWSTGNODE environment variable.
This command displays information about a volume locked by the volume lock command (swstvollock).
Specification method
| program-directory\bin\swstvollockstat [Device-Name] |
Description of operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies the name of an AdvancedCopy Manager device. If an AdvancedCopy Manager device name is omitted, information about all volumes locked by the volume lock command is displayed. |
End status
=0: Normal end
>0: Abnormal end
Execution example
Display information about a locked volume.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstvollockstat ACM-Volume-Name Lock-Start-Time g1d1p1 2003/12/21 3:56:09 g1d2p1 2003/12/21 3:57:21 g3d1p2 2003/12/21 3:58:12 C:\> |
The following types of information are displayed:
|
Item |
Description |
|---|---|
|
ACM-Volume-Name |
AdvancedCopy Manager device name |
|
Lock-Start-Time |
Time at which the device was locked. |
This command does not work if:
The specified device name is invalid.
The device has not been locked.
The AdvancedCopy Manager's communication service has not been run or an error occurs in the service.
When this command is executed for a volume in a cluster system, set the name of the logical node for the transaction in the SWSTGNODE environment variable.
This command stops tracking processing.
Specification method
|
[To execute on the storage server] [To execute on the storage management server] |
Options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on the storage management server. |
|
-copy |
Specifies that physical copying, if active, should also be stopped (the OPC session should be canceled). This option cannot be specified for a backup volume that has already been a backup history. For a volume whose copy destination volume has been a backup history, delete the history information in advance using the history deletion command (swsthistdel). |
|
-emergency |
Specifies that the command should operate in emergency operation mode. The command does not check tracking processing and does not stop tracking processing and the OPC session. |
|
-bd |
Stops tracking processing for the specified backup volume. Specify the target backup volume name as an operand. This option cannot be specified together with the -all option. |
|
-all |
Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified together with the -bd option. |
Operand
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a device name. Specify a block device name. |
End status
= 0: Normal end
> 0: Abnormal end
Example
The following example stops the tracking processing that was specified for the backup volume (g1d20p1) from the transaction volume (g1d10p1)
C:\>C:\Win32app\AdvancedCopyManager\bin\swstcanceltrk g1d10p1 -bd g1d20p1 g1d10p1 swstcanceltrk completed. C:\> |
The following example stops tracking processing and physical copying that were specified for the transaction volume (g1d10p1).
C:\>C:\Win32app\AdvancedCopyManager\bin\swsttrkstat g1d10p1 Server Transaction-Disk Backup-Disk Status Execute Update job2 g1d10p1 g1d20p1 executing 33% ----- C:\>C:\Win32app\AdvancedCopyManager\bin\swstcanceltrk -copy g1d10p1 -bd g1d20p1 g1d10p1 swstcanceltrk completed. C:\> |
If the command is executed in emergency operation mode, no OPC session is canceled. A session that is not managed remains if the command is entered during tracking. The session must be canceled using GRmgr, ETERNUSmgr, or GDS.
Tracking processing cannot be stopped under the following conditions. In this case, take action according to "System administrator response" provided for the message output.
- Tracking processing is not performed for the specified copy source and destination volumes.
This command cannot be executed while the following command is executed:
Storage server configuration information setting command (swstsvrset)
Device information setting command (swstdevinfoset)
Resource matching command (swstsrsemtch)
Resource backup command (swstresback)
Resource restore command (swstresrst)
This command displays the status of tracking processing.
When multiple types of synchronous processing exist for one transaction volume, the command displays the statuses of all types of tracking processing.
Specification method
|
[To execute on the storage server] [To execute on the storage management server] |
Options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on the storage management server. |
Operands
|
Operand |
Description |
|---|---|
|
Device-Name |
Specifies a device name. Specify a block device name. If this operand is omitted, the command displays the statuses of tracking processing for all transaction volumes. |
End status
= 0: Normal end
> 0: Abnormal end
Example
The following example displays the status of tracking processing of a transaction volume (g1d10p1):
C:\>C:\Win32app\AdvancedCopyManager\bin\swsttrkstat g1d10p1 Server Transaction-Disk Backup-Disk Status Execute Update job1 g1d10p1 g1d20p1 tracking ---- 12% C:\> |
The following example displays the status of tracking processing of all transaction volumes:
C:\>C:\Win32app\AdvancedCopyManager\bin\swsttrkstat Server Transaction-Disk Backup-Disk Status Execute Update job1 g1d10p1 g1d20p1 nosession ---- ---- job1 g1d30p1 g1d40p1 executing 75% ---- job1 g1d50p1 g1d60p1 failed ---- ---- job1 g1d70p1 g1d80p1 tracking ---- 12% job1 g1d90p1 ---- ---- ---- ---- : C:\> |
The displayed data is explained below.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Transaction-Disk |
Displays a transaction volume name. |
|
Backup-Disk |
Displays a backup volume name. Displays "----" when the volume is not in the tracking status. |
|
Status |
Displays the execution status. "----": Not in progress of tracking "executing": In progress of physical copying and tracking "tracking": In progress of tracking "failed": Physical copying or tracking terminated abnormally. "nosession": No session exists. (Resource information is inconsistent.) |
|
Execute |
Displays the progress of copying as a percentage when "executing" is displayed in the Status column. "----" is displayed when "tracking" is displayed in the Status column. |
|
Update |
Displays the amount of updated data after logical copying as a percentage when "tracking" is displayed in the Status column. "----" is displayed when "executing" is displayed in the Status column. |
When the execution status (status displayed in the "Status" column) is "failed," a hardware problem is assumed. Remove the problem cause and then reexecute the differential snapshot backup.
When the execution status (status displayed in the "Status" column) is "nosession," the resource information is probably inconsistent. Use the resource matching command (swstsrsemtch) to remove any inconsistencies from the resource information.
To operate backup management, use the following maintenance commands:
|
Function |
Command name |
Description |
|---|---|---|
|
swstsrsemtch |
Recovers the consistency of information in a backup management files. |
|
|
swstresback |
Backs up a backup management files |
|
|
swstresrst |
Restores a backup management files |
This command recovers resource information if a system failure, etc. has made the resource information inconsistent.
Specification method
|
[To be executed on a storage server] program-directory\bin\swstsrsemtch [-x] [To be executed on a storage management server] program-directory\bin\swstsrsemtch [-x] [-h Storage-Server] |
Description of operands
|
Operand |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-x |
Gets consistency with a repository. Specify this option if the consistency between a backup management files and a repository comes to be inconsistent. |
Execution example
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsrsemtch swstsrsemtch completed C:\> |
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command(swstsvrset)
Backup policy setting command (swstbkpolset)
Backup policy deletion command (swstbkpoldel)
Backup execution command (swstbackup)
Restore execution command (swstrestore)
Restore cancellation command (swstcancelrest)
Backup synchronous processing start command (swststartsync)
Backup synchronous processing cancel command (swstcancelsync)
Device information setting command (swstdevinfoset)
History information deletion command (swsthistdel)
Tracking cancel command (swstcanceltrk)
Resource backup command (swstresback)
Resource restore command (swstresrst)
Resource match command (swstsrsemtch)
SQL Server backup execution command (swstbackup_sqlsvr)
A backup management files is backed up to the specified directory.
Backup management files
Management books, such as Storage server composition information
The information backed up by this command can be restored by the resources restoration command.
By this command, a replication management files, a database, and an attestation management files are not evacuated.
Specification method
|
program-directory\bin\swstresback Backup-Directory |
Description of operand
|
Operand |
Description |
|---|---|
|
Backup-Directory |
Specifies the name of a directory to which resource control information should be saved. |
Execution example
Back up resource control information to C:\backup.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstresback C:\backup swstresback completed C:\> |
You cannot perform backup if:
The specified directory does not exist.
Copying of data to the specified directory failed because of insufficient free space, etc.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command(swstsvrset)
Backup policy setting command (swstbkpolset)
Backup policy deletion command (swstbkpoldel)
Backup execution command (swstbackup)
Restore execution command (swstrestore)
Restore cancellation command (swstcancelrest)
Backup synchronous processing start command (swststartsync)
Backup synchronous processing cancel command (swstcancelsync)
Device information setting command (swstdevinfoset)
History information deletion command (swsthistdel)
Tracking cancel command (swstcanceltrk)
Resource backup command (swstresback)
Resource restore command (swstresrst)
Resource match command (swstsrsemtch)
SQL Server backup execution command (swstbackup_sqlsvr)
A backup management files is restored from the specified directory.
Managed resources information
Management books, such as Storage server composition information.
Specification method
|
program-directory\bin\swstresrst Backup-Directory |
Description of operand
|
Operand |
Description |
|---|---|
|
Backup-Directory |
The evacuation place directory name directed by the Backup-Directory resources backup command is specified. |
Execution example
Restore resource management information from C:\backup.
C:\>C:\Win32app\AdvancedCopyManager\bin\swstresrst C:\backup swstresrst completed C:\> |
Before the backup management files can be restored by this command, the storage server configuration information setting command (swstsvrset) must be executed.
You cannot perform restoration if:
The specified directory does not exist.
No backup management files exists in the specified directory.
Copying of data from the specified directory for restoration failed because of insufficient free space, etc.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command(swstsvrset)
Backup policy setting command (swstbkpolset)
Backup policy deletion command (swstbkpoldel)
Backup execution command (swstbackup)
Restore execution command (swstrestore)
Restore cancellation command (swstcancelrest)
Backup synchronous processing start command (swststartsync)
Backup synchronous processing cancel command (swstcancelsync)
Device information setting command (swstdevinfoset)
History information deletion command (swsthistdel)
Tracking cancel command (swstcanceltrk)
Resource backup command (swstresback)
Resource restore command (swstresrst)
Resource match command (swstsrsemtch)
SQL Server backup execution command (swstbackup_sqlsvr)
This chapter is explains operation the composition management command. This manages the information on a server device which performs backup employment and replication employment, or is a candidate for employment.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
stgcmmodnode
To execute this command on a storage management server (storage management server transaction), the storage management server (storage management server transaction) must be operating.
stguserset
In cluster operation, the storage management server transaction must be operating.
stgguiipset
In cluster operation, the storage management server transaction must be operating.
stgxfwcmaddsrv
The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.
stgxfwcmmodsrv
The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.
stgxfwcmdelsrv
The storage management server (storage management server transaction) must be operating.
stgxfwcmsetdev
The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.
stgxfwcmdeldev
The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.
stgxfwcmdispsrv
The storage management server (storage management server transaction) must be operating.
stgxfwcmdispdev
The storage management server (storage management server transaction) must be operating.
stgxfwcmdisppat
The storage management server (storage management server transaction) must be operating.
stgenvdisp
This command is executable when both storage management server (storage management server transaction) and storage server (storage server transaction) are not operating.
Note that when the cluster service (named differently in respective cluster systems) is not operating in cluster operation, this command cannot display certain information.stgmgrinfoset
The package-backup-of-the-management-information execution server must be operating.
stgmgrinfobkup
The storage management server (storage management server transaction), package-backup-of-the-management-information execution server, and package-backup-of-the-management-information target servers must be operating.
stgmgrinfodisp
The package-backup-of-the-management-information execution server must be operating.
stgarcext
This command is executable when both storage management server (storage management server transaction) and storage server (storage server transaction) are not operating.
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
stgcmmodnode
Required
Transaction operating node
stgguiipset
Not required
Transaction operating node
Executable only on storage management server transaction
stguserset
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmaddsrv
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmmodsrv
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmdelsrv
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmsetdev
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmdeldev
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmdispsrv
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmdispdev
Not required
Transaction operating node
Executable only on storage management server transaction
stgxfwcmdisppat
Not required
Transaction operating node
Executable only on storage management server transaction
stgenvdisp
Not required
Transaction operating node
stgmgrinfobkup
Required
Transaction operating node
stgmgrinfodisp
Required
Transaction operating node
stgmgrinfoset
Required
Transaction operating node
stgarcext
Not required
Transaction operating node
This command changes the following information on a storage management server.
IP address of a storage management server
PORT number used by a communication service that runs on a storage management server
Server name of a storage management server
This command has the following two functions:
Displays storage management server information specified on the storage server on which this command is currently executed
Changes storage management server information.
Refer to the following for the change procedure which uses this command.
Specification method
|
program-directory\bin\stgcmmodnode [-i IP-address] [-p PORT number] [-n Server name] |
Description of options
|
Option |
Description |
|---|---|
|
None |
Displays the server information currently managed. |
|
-i |
Specifies the IP address of a storage management server to change the IP address of the storage management server. |
|
-p |
Specifies the port number of a storage management server to change the port number of the storage management server. |
|
-n |
Specifies the server name of a storage management server to change the server name of the storage management server. This option cannot be specified if this command is executed on a storage management server. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display server information.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgcmmodnode swstf2413 IP Address = 10.10.10.10 swstf2413 PORT Number = 1226 swstf2413 Storage Management Server's Name = fujitsu-storage-management-server C:\> |
Change the IP address of a storage management server to 10.12.13.14.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgcmmodnode -i 10.12.13.14 swstf2401 AdvancedCopy Manager registry updated. C:\> |
The following lists notes on this command.
This command can be executed only by an account belonging to the administrators group.
As the PORT number of a storage management server, you can specify a value between 1024 and 65535.
In this command, specify the same value as the one specified on a storage management server. A error will occur in the operation if an invalid value is specified.
This command changes the user name and the password of a "repository access user" specified when Manager of AdvancedCopy Manager was installed. This command must be executed on a storage management server.
The change in the user-name and the password is executed according to the following procedures.
Close Web browser of AdvancedCopy Manager.
Execute Repository access user change command (stguserset).
Stop service (AdvancedCopy Manager GUI service).
Start service (AdvancedCopy Manager GUI service).
Specification method
|
program-directory\bin\stguserset user-name password |
Description of options
|
Option |
Description |
|---|---|
|
User name |
Specifies a user name to be used for repository access. |
|
Password |
Specifies a user password to be used for repository access. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Change the user name and the password to be used for repository access to a1234 and Yfd1fz3, respectively.
C:\>C:\Win32app\AdvancedCopyManager\bin\stguserset a1234 Yfd1fz3 Password for accessing the repository has been registered. C:\> |
This command can be executed only by an account belonging to the administrators group.
A user name to be specified in this command must already be registered to the system and have the local logon authority.
The Storage management server is equipped with two or more network cards, and it is used when dividing and employing the IP address specified in case the IP address (IP address specified when it was the database creation at the time of Storage management server introduction) and Web screen with a Storage server which communicate are used. It is necessary to execute this command by the Storage management server.
This command has the following functions.
Displays the IP address for GUI connection of the Storage management server
Changes the IP address for GUI connection of a Storage management server
To change the IP address for GUI connection of a Storage management server:
The web browser of AdvancedCopy Manager is closed.
A GUI connection information setting command (stgguiipset) is carried out.
Service (display name: AdvancedCopy Manager GUI Service) is stopped.
Service (display name: AdvancedCopy Manager GUI Service) is started.
Specification method
|
Program directory\bin\stgguiipset [-i IP address] |
Description of options
|
Option |
Description |
|---|---|
|
None |
Displays the IP address for GUI connection currently managed. |
|
-i |
The IP address for GUI connection to change is specified. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The IP address for the present GUI connection is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgguiipset IP Address = 10.10.10.10 C:\> |
The IP address for GUI connection of a Storage management server is changed into 10.12.13.14.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgguiipset -i 10.12.13.14 swstf2401 Renewal of the server information on a Storage management server was completed normally. C:\> |
Only the account which belongs to an administrators group can execute this command.
This command adds Storage server information to be managed by AdvancedCopy Manager. This command can only be executed from the Storage management server.
Specification method
|
Program directory\bin\stgxfwcmaddsrv [-n Server-Name] -i IP address -p port-Number |
Description of options
|
Option |
Description |
|---|---|
|
-n |
Specifies the name of the storage server to be added. The name must be less than 255 bytes(*2) and a unique server name for AdvancedCopy Manager in order for it to manage the server.
|
|
-i |
Specify the IP address of the Storage server to be added by IPv4 format. Specify a physical IP address if the Storage server is managed as a physical server. Specify a logical IP address if the IP address is made redundant and managed (as a logical server), like under the cluster environment. |
|
-p |
Specify the port number that is set on the Storage server side to communicate with the Storage server to be added. (Value from 1,024 to 65,535) Under the cluster environment, specify the port number that is allocated to the service name stgxfws_? (*1). |
(*1) Logical node name of AdvancedCopy Manager specified during cluster setup
(*2) The usable characters are: 1-byte alphanumeric characters, minus sign (-), underscore (_), number sign (#), and period (.), with the first character being a 1-byte alphanumeric character. (A 2-byte character causes an error.)
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Add a server by using host name.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmaddsrv -i 10.10.10.10 -p 1226 stgxfwcmaddsrv completed C:\> |
Add a logical server that cluster setup is performed by specifying a server name.
(Logical IP address: 10.10.10.20; port number allocated to stgxfws_logical-node-name: 1227)
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmaddsrv -n Server1 -i 10.10.10.20 -p 1227 stgxfwcmaddsrv completed C:\> |
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
Because a Storage management server and a logical server for a Storage management server transaction are added during database setup and cluster setup, they are not added by this command.
This command cannot be executed when the following commands are being executed:
Server information change command(stgxfcmmodsrv)
Server information deletion command(stgxfwcmdellsrv)
Device information collection/reflection command(stgxfwcmsetdev)
Device information deletion command(stgxfwcmdeldev)
This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:
Addition of server
Change of server
Deletion of server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on Specific Device
Deletion of device information
This command changes the following server information managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
Storage server IP address
Storage server port number
Server name of Storage management server
Server name of Storage server
Also, use this when installing the tape server function on the target server later.
Only the management server information change command (stgcmmodnode) can change the following server information:
IP address of Storage management server
Port number of Storage management server
When the server information is changed by using this command, the machine definition information must be changed in advance. Refer to the procedure given in "Changing the operating Environment," to execute the processing.
Specification method
|
Program directory\bin\stgxfwcmmodsrv -n Server-Name [-s New-Server-Name] [-i New-IP-Address] [-p New-port-Number] |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify a server name that is currently being managed. |
|
-s |
Specify a new server name within 255 bytes. The usable characters are: 1-byte alphanumeric characters, minus sign (-), underscore (_), number sign (#), and period (.), with the first character being a 1-byte alphanumeric character. (A 2-byte character causes an error.) |
|
-i |
Specify the IP address of the Storage server to be added by IPv4 format. Specify a physical IP address if the Storage server is managed as a physical server. Specify a logical IP address if the IP address is made redundant and managed (as a logical server), like under the cluster environment. |
|
-p |
Specify a port number required for postchange communication. (Value from 1024 to 65535) Under the cluster environment, specify the port number that is allocated to service name stgxfws_? (*1). |
(*1) Logical node name of AdvancedCopy Manager specified during cluster setup
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The IP address of a Storage server (server name: Server1) is changed to 10.20.30.40.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmmodsrv -n Server1 -i 10.20.30.40 stgxfwcmmodsrv completed C:\> |
The server name of a Storage server (server name: Server1) is changed to Agent5.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmmodsrv -n Server1 -s Agent5 stgxfwcmmodsrv completed C:\> |
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
This command cannot be executed when the following commands are being executed:
Server information addition command(stgxfwcmaddsrv)
Server information deletion command(stgxfwcmdelsrv)
Device information collection/reflection command(stgxfwcmsetdev)
Device information deletion command(stgxfwcmdeldev)
This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:
Addition of server
Change of server
Deletion of server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on Specific Device
Deletion of device information
This command deletes the Storage server information that AdvancedCopy Manager is currently managing. It is necessary to execute this command on the Storage management server.
Specification method
|
Program directory\bin\stgxfwcmdelsrv -n Server-Name |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the Storage server name to be deleted. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
A Storage server's (server name: Server1) information is deleted.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdelsrv -n Server1 stgxfwcmdelsrv completed C:\> |
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
The Storage management server information cannot be deleted.
This command cannot be executed when the following commands are being executed:
Server information addition command(stgxfwcmaddsrv)
Server information change command(stgxfwcmmodsrv)
Device information collection/reflection command(stgxfwcmsetdev)
Device information deletion command(stgxfwcmdeldev)
This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:
Addition of server
Change of server
Deletion of server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on Specific Device
Deletion of device information
This command collects the latest device information detected by the server and displays the difference with the information managed by AdvancedCopy Manager. Later, it reflects the specified device difference information in the management information for AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
The device information currently being managed and the device information detected are compared, stored, deleted, and updated, and used in the following cases:
When operation using AdvancedCopy Manager is started
When device information being managed is changed
Specification method
|
Program directory\bin\stgxfwcmsetdev -n Server-Name [-d Device-Name] [-f File-Name | -y] |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the server name whose device information is to be collected or reflected. |
|
-d |
Specify the device name whose information is to be collected or reflected. If this specification is omitted, all devices of the specified server are assumed to be specified. |
|
-f |
Use the absolute path to specify the file name to which the difference between the device information managed currently and the device information collected is output. The device difference information is only output to the file, and the reflection processing for the subsequent management information is not executed. This option cannot be specified with the -y option. |
|
-y |
The difference between the device information managed by AdvancedCopy Manager and the latest device information detected is reflected unconditionally in the management information without an inquiry made about that difference. This option cannot be specified with the -f option. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The information for each device of a server (server name: Server1) is collected or reflected.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmsetdev -n Server1 >Device detected 1:g1d38p1 (X:) 2:g1d38p2 3:g1d38p3 >Device not detected 1:g1d39p1 (Y:) 2:g1d39p2 >Specify a device requested to be added. [* or ?-? or ?,? or q] 1,3 >Specify a device requested to be deleted. [* or ?-? or ?,? or q] * >Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed C:\> |
The information for a specific device (device name: g1d38p1) managed by the server (server name: Server1) is collected or reflected.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmsetdev -n Server1 -d g1d38p1 > The following device information has been changed. This information is updated. 1:g1d38p1 (X:) > Do you want to continue the processing? [y or n] y stgxfwcmsetdev completed C:\> |
Use the following methods to request addition or deletion:
Enter "*" to specify all.
Enter numbers connected with a hyphen to specify a range. (Example: 1-3)
Enter numbers separated with a comma to specify an enumeration. (Example: 2, 4)
A combination of range and enumeration specifications can be entered. (Example: 1-3, 5)
Enter no data to specify nothing.
Enter "q" to stop the processing.
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
On Windows servers and HP-UX servers, AdvancedCopy Manager does not control GPT disks, thus no disk information can be obtained or reflected.
The following message may be displayed when a device requested to be added is specified. It is an indication of an attempt to register a device that is in the GR cabinet and may have invalid settings. Make sure that no problem would occur in operation before continuing the processing.(This message is also displayed when the -y option is specified.)
The following message may be displayed when a device requested to be added is specified. In this case, check the following before continuing the processing: whether the device is to be subjected to duplicated registration when two or more logical servers running on the same physical server are managed. (This message is also displayed when the -y option is specified.)
The amount of time required to process this command is proportional to the total number of devices defined on the specified server when the device information is collected. When the number of devices is large, execute the command with low CPU and I/O loads.
Note that it takes about 0.5 second for one device (partition) in no load state.
When backup synchronous processing or synchronous replication processing is being performed, device information may be unable to be acquired correctly. Therefore, when you take in device information, where all synchronous processing are canceled, please carry out.
This command cannot be executed when the following commands are being executed:
Server information addition command(stgxfwcmaddsrv)
Server information change command(stgxfwcmmodsrv)
Server information deletion command(stgxfwcmdelsrv)
Device information deletion command(stgxfwcmdeldev)
This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:
Addition of server
Change of server
Deletion of server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on Specific Device
Deletion of device information
This command deletes the device information currently being managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
The device information collection/reflection command (stxfwcmsetdev) compares the device information currently being managed and the device information detected before it executes the processing. However, this command deletes the device information irrespective of whether the device information currently being managed is detected.
Specification method
|
Program directory\bin\stgxfwcmdeldev -n Server-Name -d Device-Name |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the server name that is managing the device to be deleted. |
|
-d |
Specify the device name to be deleted. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The device (g1d18p1) information for a Storage server (server name: Server1) is deleted.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdeldev -n Server1 -d g1d18p1 stgxfwcmdeldev completed C:\> |
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
This command cannot be executed when the following commands are being executed:
Server information addition command(stgxfwcmaddsrv)
Server information change command(stgxfwcmmodsrv)
Server information deletion command(stgxfwcmdelsrv)
Device information collection/reflection command(stgxfwcmsetdev)
This command cannot be executed when the following operations are being performed in the initial window by using the Web screen:
Addition of server
Change of server
Deletion of server
Acquisition and Reflection of Information on All Devices
Acquisition and Reflection of Information on Specific Device
Deletion of device information
This command displays the server information managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
Specification method
|
Program directory\bin\stgxfwcmdispsrv [-n Server-Name] |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the server name whose information is to be displayed. If this specification is omitted, the information for all servers managed by AdvancedCopy Manager is displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The information for all servers is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispsrv Server Server-Type Tape OS-Type OS-Version Version IP-Address Port-Number Manager Management-Server -- Windows2000 --- V10.0L60 10.10.10.10 1226 Server1 Server -- Windows2000 --- V10.0L60 10.10.10.20 1226 C:\> |
The information for a Storage server (server name: Server1) is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispsrv -n Server1 Server Server-Type Tape OS-Type OS-Version Version IP-Address Port-Number Server1 Server -- Windows2000 --- V10.0L60 10.10.10.20 1226 C:\> |
The contents to be displayed are as follows:
|
Title |
Description |
|---|---|
|
Server |
A server name is displayed. |
|
Server-Type |
A server type is displayed. |
|
Tape |
"Y" indicated for a tape server. |
|
OS-Type |
An operating system type is displayed. |
|
OS-Version |
An operating system version is displayed. |
|
Version |
The version of this product is displayed. |
|
IP-Address |
The IP address for communication with the server is displayed. |
|
Port-Number |
The port number for communication with the server is displayed. |
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
This command displays the device managed by AdvancedCopy Manager. Moreover, the list of the device which uses the specified same to device copy area, the specified device, and the device which exists in the same, logical group can be displayed.
It is necessary to execute this command on the Storage management server.
It displays it based on information registered in AdvancedCopy Manager. Therefore, when the composition has been changed there is a device not registered in a logical group, and after it registers, correct information is not displayed. For this case, please execute acquisition of device information on the registration of the device not registered and the device which does the "Acquisition/reflection of information on all devices" processing again.
Specification method
|
Program directory\bin\stgxfwcmdispdev -n Server-Name [-d Device-Name [-sm|-grp]] |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the server name that manages the device whose information is to be displayed. |
|
-d |
Specify the device name whose information is to be displayed. If this specification is omitted, the information for all devices managed by the specified server is displayed. |
|
-sm |
With the -d option also specified, this option specifies that a list of the devices using the same copy area as the specified device be displayed. |
|
-grp |
The list of the device which exists in the same logical group as a specified device is displayed by specifying it simultaneously with -d option. this option - The device type of the specified device can be specified for d option only for LVM/VxVM. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The information for a device (g1d19p1) of a server (Server1) is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispdev -n Server1 -d g1d19p1 S Device Block-Device Mount-Point File-System Device-Type Size(MB) g1d19p1 disk19p1 J: NTFS Normal 2000 C:\> |
The information for each device of a server (Server1) is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispdev -n Server1 S Device Block-Device Mount-Point File-System Device-Type Size(MB) g1d19p1 disk19p1 J: NTFS Normal 2000 * g1d19p2 disk19p2 M: NTFS Normal 2000 D g1d20p1 disk20p1 K: NTFS Normal 2000 U g1d20p2 disk20p2 N: NTFS Normal 2000 C:\> |
Device (/dev/vx/rdsk/dg1/vol1) of server (Server1) is displayed and device information which uses the same copy area is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -sm Device Mount-Point /dev/vx/rdsk/dg1/vol1 /storagedata /dev/vx/rdsk/dg1/vol2 --- /dev/vx/rdsk/dg1/vol3 /zzz C:\> |
Device information which exists in the same logical group as device (/dev/vx/rdsk/dg1/vol1) of server (Server1) is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -grp Device Mount-Point /dev/vx/rdmp/c1t0d0s2 --- /dev/vx/rdmp/c1t0d1s2 --- /dev/vx/rdsk/dg1/vol1 /storagedata /dev/vx/rdsk/dg1/vol2 --- /dev/vx/rdsk/dg1/vol3 /zzz /dev/vx/rdsk/dg1/vol4 --- C:\> |
The following contents are displayed. The following contents are displayed. Note that "SDX" or "SDX object" in the table are SynfinityDISK or PRIMECLUSTER Global Disk Services (GDS) terms.
|
Title |
Description |
|---|---|
|
S |
The status of each device is indicated. The following is displayed according to the device status: |
|
Device |
(Solaris server) (Windows server) A device name managed internally by AdvancedCopy Manager is displayed. (HP-UX server) (Linux server) (AIX server) |
|
Block-Device |
(Solaris server) (Windows server) disk?: Disk number displayed by Disk Management p?: Logical disk number (*2) (HP-UX server) (Linux server) (AIX server) |
|
Mount-Point |
(Solaris server, HP-UX server, AIX server and Linux server) (Windows server) |
|
File-System |
A file system name is displayed. |
|
Device-Type |
A device type is displayed. |
|
Size(MB) |
The capacity (in megabytes) allocated to a device is displayed. |
(*1) A number given uniquely on the disk array. This number differs from the disk number on the Disk Management.
(*2) The sequential number of a logical disk on the disk. The logical disk indicates the following contents of the Disk Management. The number is given by counting up from the left to the right on the Disk Management.
In the case of the basic partition, the logical disk is that entire partition.
In the case of the extended partition, the logical disk is a logical drive in that partition.
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
This command displays the information for the partitions that comprise a device managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
Specification method
|
Program directory\bin\stgxfwcmdisppat -n Server-Name -d Device-Name |
Description of options
|
Options |
Description |
|---|---|
|
-n |
Specify the server name that manages a device whose information is to be displayed. |
|
-d |
Specify a device name whose information is to be displayed. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The partition information for a device (g1d19p1) of a server (Server1) is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgxfwcmdisppat -n Server1 -d g1d19p1 Partition Identifier Physical-Disk Disk-Type LU-Number g1d19p1 g1d19p1 disk19p1 GR 19 C:\> |
The following contents are displayed. Note that "SDX" or "SDX object" in the table are SynfinityDISK or PRIMECLUSTER Global Disk Services (GDS) terms.
|
Title |
Description |
|---|---|
|
Partition |
(Solaris server) (Windows server) (HP-UX server) (Linux server) In the case of a SDX object(slice), it displays in the form of RAW device name:sd?. (AIX server) |
|
Identifier |
(Solaris server) (Windows server) The same contents as Device of the device information display command (HP-UX server) (Linux server) In the case of a SDX object(slice), it displays in the form of block device name:sd?. (AIX server) |
|
Physical-Disk |
(Solaris server, HP-UX server, Linux, and AIX server) (Windows server) The same contents as Block-Device of the device information display command (stgxfwcmdispdev) are displayed. |
|
Disk-Type |
When the device is installed in the ETERNUS storage system, "GR" is displayed. When the device is not installed in the ETERNUS storage system, "---" is displayed. |
|
LU-Number |
When the device is installed in the ETERNUS storage system, a logical unit number is displayed. When the device is not installed in the ETERNUS storage system, "---" is displayed. |
(*1) The sequential number of a logical disk on the disk. The logical disk indicates the following contents of the Disk Management. The number is given by counting up from the left to the right on the Disk Management.
In the case of the basic partition, the logical disk is that entire partition.
In the case of the extended partition, the logical disk is a logical drive of that partition.
The following provides notes on this command:
Only the account which belongs to an administrators group can execute this command.
Please perform in the locale specified at the time of product installation.
This command displays values of environment settings in AdvancedCopy Manager.
To output cluster operation information, execute the command from an active node. Executing the command from a standby node displays only partial information. To output cluster operation information while a transaction is stopped, set the shared disk containing the AdvancedCopy Manager shared data of the transaction to the online state or mount the shared disk, and then execute the command.
When this command is executed in a cluster environment, the environment variable (SWSTGNODE) need not be set.
Only users whose accounts belong to the Administrators group can execute this command.
Specification method
|
program-directory\bin\stgenvdisp [-n transaction-logical-node-name] |
Description of options
|
Option |
Description |
|---|---|
|
-n |
Specifies the logical node name (logical node name specified in the cluster setup command) of the transaction.
If this option is specified, information on only the specified transactions is output. Otherwise, information on all transactions is output.
This option cannot be specified. If the option is specified, then message swstf6001 is output and processing ends. Otherwise, information is output. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Information in a non-cluster environment is displayed.
[For the storage management server]
C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp Server type : Management server Manager IP address : 10.10.10.10 Repository user : acm DB log file : D:\acmdb\log DB dictionary file : D:\acmdb\dic Repository database : D:\acmdb\spa Database size : 65MB IP address for GUI : 10.10.10.10 Communication : 1226 Remote access : 9851 Exclusive control : 9852 Authentication feature : 4660 Repository : 2004 C:\> |
[For the storage server]
C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp Server type : Server Manager IP address : 10.10.10.10 Communication : 1226 C:\> |
Information on all transactions in a cluster environment (MSCS) is displayed.
[For the storage management server]
C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp Server type : Management server Cluster system : MSCS Node type : Primary Node name : nodemgr Service name : manager_service Cluster name : ACMCluster Disk resource : Disk R Drive : R Network name : ACMNet External connection : local Subnet mask : 255.255.255.0 IP by cluster setup : 10.10.10.10 Manager IP address : 10.10.10.10 Repository user : acm DB log file : R:\acmdb\log DB dictionary file : R:\acmdb\dic Repository database : R:\acmdb\spa Database size : 65MB IP address for GUI : 10.10.10.10 Communication : 11000 Remote access : 9851 Exclusive control : 9852 Authentication feature : 4660 Repository : 2004 ------------------------------------------------------------------------- Server type : Server Node name : Local-Service Manager IP address : 10.10.10.10 Communication : 1226 C:\> |
Values for any of the following are output according to the IP address information entered in the cluster setting command: network name, external connection, subnet mask, and IP address resource.
[For the storage server]
C:\>C:\Win32app\AdvancedCopyManager\bin\stgenvdisp Server type : Server Cluster system : MSCS Node type : Primary Node name : nodeagt1 Service name : agent_service1 Cluster name : ACMCluster Disk resource : Disk R Drive : R Network name : ACMNet1 External connection : local Subnet mask : 255.255.255.0 IP by cluster setup : 10.10.10.10 Manager IP address : 10.10.10.10 Communication : 11000 ------------------------------------------------------------------------- Server type : Server Cluster system : MSCS Node type : Secondary Node name : nodeagt2 Service name : agent_service2 Cluster name : ACMCluster Disk resource : Disk P Drive : P IP address resource : ACM Net Resource IP by cluster setup : 10.10.10.10 Manager IP address : 10.10.10.10 Communication : 12000 ------------------------------------------------------------------------- Server type : Server Node name : Local-Service Manager IP address : 10.10.10.10 Communication : 1226 C:\> |
Values for any of the following are output according to the IP address information entered in the cluster setting command: network name, external connection, subnet mask, and IP address resource.
The contents of displayed information are described below.
|
Title |
Description |
|---|---|
|
Server type |
The server type is displayed as follows: |
|
Cluster system |
The type of cluster system is displayed as follows: HACMP: High Availability Cluster Multi-Processing |
|
Node type |
The node type is displayed as follows: |
|
Node name |
The logical node name is displayed. |
|
Service name |
The transaction name is displayed. |
|
Cluster name |
The cluster name is displayed. |
|
Mount point |
The mount point for AdvancedCopy Manager shared data is displayed. |
|
Disk resource |
The name of the shared disk resource used for AdvancedCopy Manager shared data is displayed. |
|
Drive |
The drive letter used for AdvancedCopy Manager shared data is displayed. |
|
Volume group |
The volume group name is displayed. |
|
Network name |
The name of the network for AdvancedCopy Manager is displayed. |
|
External connection |
The external connection network name is displayed. |
|
Subnet mask |
The subnet mask is displayed. |
|
IP address resource |
IP address resource information is displayed. |
|
IP by cluster setup |
The logical IP address specified in the cluster setting command is displayed. |
|
Manager IP address |
The IP address of the storage management server is displayed. |
|
Repository user |
The name of the user accessing the repository is displayed. |
|
DB log file |
[Windows Edition only] |
|
DB dictionary file |
[Windows Edition only] |
|
Repository database |
[Windows Edition only] |
|
DB file |
[Solaris Edition] [Linux Edition] |
|
RDB dictionary |
[Solaris Edition] [Linux Edition] |
|
RDB log file |
[Solaris Edition] [Linux Edition] |
|
Database space |
[Solaris Edition] [Linux Edition] |
|
Database size |
[Windows Edition and Linux Edition only] |
|
IP address for GUI |
The GUI connection IP address is displayed. |
|
Communication |
The communication service/daemon port number (service name in the services file: stgxfws) is displayed. |
|
Remote access |
The remote access service/daemon port number (service name in the services file: rmiswstf) is displayed. |
|
Exclusive control |
The exclusive control service/daemon port number (service name in the services file: semswstf) is displayed. |
|
Authentication feature |
The authentication feature service/daemon port number (service name in the services file: smaclmgr) is displayed. |
|
Repository |
The repository service/daemon port number (service name in the services file: rdaswstf) is displayed. |
"????" is displayed for any information that cannot be displayed because of an error.
Some items may not be output depending on the server type (storage management server/storage server) or cluster type.
The command registers the management information package backup execution server (the server on which the management information package backup command is executed).
The command deletes the management information package backup execution server.
The command displays information about the management information package backup execution server.
Specification method
|
program-directory\bin\stgmgrinfoset [-del | -d directory-name -c storage-management-server-encoding] |
Description of options
|
Option |
Description |
|---|---|
|
None |
Displays information about the management information package backup execution server. |
|
-del |
Deletes the management information package backup execution server. |
|
-d |
Specify the full path to the directory where the backup data is to be stored. Only alphanumeric characters and underscores can be used in the directory name. |
|
-c |
Specify the encoding designated when the storage management server was installed. Specify either of the following: ASCII : ASCII |
End status
=0: Normal end
>0: Abnormal end
Execution example
Register the management information package backup execution server (the path to the directory where backup data is to be stored is D:\stgbkupdata, and the encoding used on the storage management server is ASCII):
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfoset -d /stgbkupdata -c ASCII swstf3000 The server which performs package backup of the management information on AdvancedCopy Manager was registered. C:\> |
Delete the management information package backup execution server:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfoset -del swstf3001 The server which performs package backup of the management information on AdvancedCopy Manager was deleted. delete a directory. Directory=/stgbkupdata C:\> |
Display information about the management information package backup execution server:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfoset Directory : /stgbkupdata Manager code : ASCII C:\> |
The following notes apply to this command:
Only a root user or an account which belongs to the administrators group can execute this command.
To change the backup data storage directory, first use the -del option to delete the current directory, then register a new backup data storage directory.
Register only one storage server as the management information package backup execution server.
Set the name of the logical node in the SWSTGNODE environment variable when the storage server registered as the management information package backup execution server is in a cluster system.
Create the directory specified in the -d option in advance.
This command makes backups of the management information stored on the storage servers and storage management server.
Specification method
|
program-directory\bin\stgmgrinfobkup [-n server-name] [-t backup-type] |
Description of options
|
Option |
Description |
|---|---|
|
-n |
Makes backups of the management information stored on the specified server. If this option is not specified, the management information on all storage servers (including the storage management server) is backed up. |
|
-t |
Specifies the types of data that is to be backed up. Specify one of the values listed below. Do not specify more than one value in the -t option: DBData : Database RegiData : Registry MgrInfoData : Policy file for management information package backup AuthData : Authentication management list BkupData : Backup management ReplData : Replication management TapeData : Tape backup management backup If this option is not specified, backups are made as defined in the policy file. For details on the policy file, refer to the section "Preliminaries" in this manual. |
End status
=0: Normal end
>0: Abnormal end
Execution example
Make backups of the management information on all the storage servers as defined in the policy file:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfobkup swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01 swstf3014 Backup of management information is started. Start time=04/07/02 11:02:00, Server name=acm02 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:05:00, Server name=acm02 swstf3021 The normal end of the backup of management information was carried out by all servers. C:\> |
Make backups of the management information on storage server acm01 as defined in the policy file:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfobkup -n acm01 swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01 swstf3021 The normal end of the backup of management information was carried out by all servers. C:\> |
Makes backups of the registries on all of the storage servers.
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfobkup -t RegiData swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01 swstf3014 Backup of management information is started. Start time=04/07/02 11:02:00, Server name=acm02 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:05:00, Server name=acm02 swstf3021 The normal end of the backup of management information was carried out by all servers. C:\> |
Make a backup of backup management located on storage server acm01:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfobkup -n acm01 -t BkupData swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01 swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01 swstf3021 The normal end of the backup of management information was carried out by all servers. C:\> |
The following notes apply to this command:
Only a root user or an account which belongs to the administrators group can execute this command.
Be sure to check the information (a message indicating completion or an error) output by this command.
This command can be executed only on the management information package backup execution server.
Set the name of the logical node in the SWSTGNODE environment variable when the management information package backup execution server is in a cluster system.
Do not execute other AdvancedCopy Manager commands or GUI commands while this command is running. Conversely, do not execute this command while another AdvancedCopy Manager command or a GUI command is running.
Do not execute this command again if it is already running.
To save backup data to a tape or similar medium, save all files and directories under the backup data storage directory.
Registry backups are made only when RegiData is specified in the -t option. A registry backup will not be made if the -t option is not specified.
A backup of the policy file for management information package backup is made only when MgrInfoData is specified in the -t option. No backup is made when the -t option is not specified. Additionally, specify the name of the management information package backup execution server in the -n option.
Backup is not possible for any management information on storage servers with Softek AdvancedCopy Manager 10.3 (V10.0L40) or earlier.
This command displays the status of execution of the management information package backup command.
Specification method
|
program-directory\bin\stgmgrinfodisp [-n server-name] |
Description of options
|
Option |
Description |
|---|---|
|
-n |
Specifies the name of the server where the backup status is to be output. If this option is not specified, the status of backups on the storage server for which the management information package backup command was executed is displayed. |
End status
=0: Normal end
>0: Abnormal end
Output information
The types of information listed below are output. If no backups are made when the management information package backup command is executed or if the management information package backup command ends in error, no data is output.
|
Item |
Description |
|---|---|
|
Server |
Server name |
|
RegiData |
Date and time at which the management information package backup command created a backup of a registry (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
DBData |
Date and time at which the management information package backup command created a backup of the database (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
AuthData |
Date and time at which the management information package backup command created a backup of the authentication management list (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
BkupData |
Date and time at which the management information package backup command created a backup of the backup management (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
ReplData |
Date and time at which the management information package backup command created a backup of replication management (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
MgrInfoData |
Date and time at which the management information package backup command created a backup of the policy file for management information package backup (date and time that the management information package backup command was executed) yy/mm/dd hh:mm:ss |
|
TapeData |
Date when a backup of tape backup management was made by package backup using the management information command (with package backup of the management information command executed) yy/mm/dd hh:mm:ss |
Execution example
Output information about all storage servers:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfodisp Server: acm01 DBData: 04/08/02 16:11:26 AuthData: 04/08/02 16:32:00 RegiData: 04/08/01 09:00:00 ReplData: 04/08/02 16:32:22 Server: acm02 RegiData: 04/08/01 09:00:00 BkupData: 04/08/03 16:00:00 Server: tape RegiData: 05/08/01 09:00:00 TapeData: 05/08/03 16:00:00 C:\> |
Output information about storage server acm01:
C:\>C:\Win32app\AdvancedCopyManager\bin\stgmgrinfodisp -n acm01 Server: acm01 DBData: 04/08/02 16:11:26 AuthData: 04/08/02 16:32:00 RegiData: 04/08/01 09:00:00 ReplData: 04/08/02 16:32:22 C:\> |
The following notes apply to this command:
Only a root user or an account which belongs to the administrators group can execute this command.
This command can be executed only on the management information package backup execution server.
Set the name of the logical node in the SWSTGNODE environment variable when the management information package backup execution server is in a cluster system.
This command expands the following types of backup data collected by the management information package backup command from the storage management server and storage servers running the Windows version of AdvancedCopy Manager.
Backup management list
Database
Specification method
|
program-directory\ bin\stgarcext file-name directory-name |
Description of options
|
Option |
Description |
|---|---|
|
file-name |
Specify the full path to the backup file to be expanded. |
|
directory-name |
Specify the full path to the directory where the file is to be expanded. |
End status
=0: Normal end
>0: Abnormal end
Execution example
Expand backup data (c:\temp\acm_db_backup) in a directory (d:\temp\ACM_DB_DATA):
C:\>C:\Win32app\AdvancedCopyManager\bin\stgarcext c:\temp\acm_db_backup d:\temp\ACM_DB_DATA swstf3035 The stgarcext command was ended normally. C:\> |
The following notes apply to this command:
Only an account which belongs to the administrators group can execute this command.
Create the directory where the file is to be expanded in advance.
The directory where the file is to be expanded must be different from the directory containing the original backup.
This chapter describes operations using Replication Management Commands. It is necessary to execute the command of replication management by the user belonging to the Administrators group.
Only the user belonging to the Administrators group can execute all the commands of replication management. When command execution is carried out by other users, a message " swsrp0601 This Command cannot be run. This is because the user is not a root user." is outputted and then, an error end.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
swsrpcancel
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the copy destination storage server must be operating (except when the -m option or -t option is specified).
For inter-server replication in EC equivalency status, the associated server must be operating (except when the -m option is specified).swsrpchsync
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swsrpdelvol
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating (except when the -d option is specified).swsrprecbuffstat
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swsrprecbuffset
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.swsrpmake
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is engaged in intra-server replication and EC operation, the daemons and services of the storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating (except when the -m option or -t option is specified).swsrprecoverres
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To specify the -r option, the daemons and services of the storage management server must be operating.swsrprevsync
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swsrpsetvol
To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating.swsrpstartsync
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
For inter-server replication, the associated server must be operating (except a case where the -m option is specified).swsrpstat
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
swsrpvolinfo
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
swsrpsetvol
Required
Transaction operation node
swsrpvolinfo
Required
Transaction operation node
swsrpdelvol
Required
Transaction operation node
swsrprecbuffstat
Required
Transaction operation node
swsrprecbuffset
Required
Transaction operation node
swsrpstartsync
Required
Transaction operation node
swsrpmake
Required
Transaction operation node
swsrpstat
Required
Transaction operation node
swsrpcancel
Required
Transaction operation node
swsrpchsync
Required
Transaction operation node
swsrprevsync
Required
Transaction operation node
swsrprecoverres
Required
Transaction operation node
This chapter describes environment definition commands for replication management. To define a replication management environment, use the following commands:
|
Function |
Command name |
Description |
|---|---|---|
|
swsrpsetvol |
Sets the information about a replication volume. |
|
|
swsrpvolinfo |
Displays the information about a replication volume. |
|
|
swsrpdelvol |
Deletes replication volume information that has been set. |
|
|
swsrprecbuffstat |
Displays information for the REC transfer buffer. |
|
|
swsrprecbuffset |
Changes the settings for the REC transfer buffer. |
This command sets the replication source and replication destination volumes that will be used in a replication operation. Execute this command to declare that the replication operation will performed using the specified replication volumes.
Specification method
|
[To be executed on a storage server] For replication on a server program-directory\bin\swsrpsetvol [-n] [-u] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name For replication between servers program-directory\bin\swsrpsetvol [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name [To be executed on a storage management server] For replication on a server program-directory\bin\swsrpsetvol -h Server-Name [-n] [-u] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name For replication between servers program-directory\bin\swsrpsetvol -h Server-Name [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies the name of a storage server subject to the replication operation. This option is valid only on a storage management server. If this option is omitted, the storage server on which the command is entered will be the target to the processing. |
|
-u |
Specifies the direction of copying. If this option is specified, copying from a replication source volume to a replication destination volume is performed only in this direction. Copying from a replication destination volume to a replication source volume is prohibited. If this option is omitted, copying between the replication source and replication destination volumes interactively is bidirectional. |
|
-o |
Specifies the operation server. Specify one of the following for this operand: ORG: Sets the replication source server as the operation server. REP: Sets the replication destination server as the operation server. BOTH: Sets both the copy-source server and copy-destination server as operation servers.
Specifying BOTH in the operand enables the execution of all commands on both the copy-source server and copy-destination server. Note that the BOTH option is usable when the versions of both servers are 11.0/V11.0L10 or later. This option is valid only for replication between servers. |
|
-n |
If this option is omitted, replication volume information cannot be set when the sizes of the replication source volume and replication destination volume are different. When this option is specified, the sizes of the replication source volume and replication destination volume are not checked. Use this option when volume sizes are different (for example, for replication between different OSs). When the volume sizes of the replication source volume and replication destination volume are different, copying is performed as follows: The address at which copying starts is the first sector of the replication destination volume. The copy data size is the size of the smaller volume. |
|
-Xgroup |
Specifies that the copy source and copy destination volumes be registered in a group. If the specified group does not exist, a new group is created. Otherwise, the specified copy source and copy destination volumes are added to an existing group. The characters that can be used for the group name are single-byte alphanumeric characters, the minus sign (-), underscore (_), number sign (#) and period (.). The first character must be a single-byte alphanumeric character. Up to 64 characters can be used. |
Description of operands
|
Operand |
Description |
|---|---|
|
Original-Volume-Name |
Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Specifies a AdvancedCopy Manager device name for the volume name. |
|
Replica-Volume-Name |
Specifies a replication destination volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Specifies a AdvancedCopy Manager device name for the volume name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Set replication volume information by specifying volume g1d1p1 of storage server SRC-SV as the replication source volume and volume g2d1p1 of storage server TARG-SV as the replication destination volume. In addition, specify one-way copying for the copy direction and specify the replication source server (SRC-SV) as the operation server. The example below shows the command executed on SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpsetvol -u -o ORG g1d1p1 g2d1p1@TARG-SV swsrpsetvol completed C:\> |
When the same settings are made from TARG-SV, the example is as follows (be careful with the volume name):
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpsetvol -u -o ORG g1d1p1@SRC-SV g2d1p1 swsrpsetvol completed C:\> |
Replication volume information cannot be set if:
Replication volume information has already been set.
The specified replication source volume and replication destination volume are set as the replication destination volume and the replication source volume.
The n option is not specified when the sizes of the replication source volume and the replication destination volume are different.
Two volumes that have the same cabinet information (box identifier, OLU number, EXTENT start position, and EXTENT size) as the cabinet information of the specified two volumes have already been set as replication volumes.
The replication destination volume has been registered as a backup volume of the backup management function.
The replication source volume has been registered as a backup volume of the backup management function and bi-directional copying is specified as a replication volume attribute.
The specified replication destination volume and replication source volume are volumes belonging to other servers (at least one volume must be a volume on the local server).
If the replication source volume and the replication destination volume are located on another disk array device, the remote copy function of the disk array device is not correctly set.
Communication with the storage management server fails.
Communication with a destination server fails for replication between servers.
When you change physical information on volumes (partition size, and cabinet information on a disk array device) using such functions as an OS management tool (for example, Disk Management) or GRmgr provided by the disk array device, you need to reset the registered replication volume information associated with the changed volumes, according to the following procedures:
Delete the replication volume information by the replication volume information deletion command (swsrpdelvol).
In an initial screen, "information acquisition / reflection" of all devices are performed. Or device information acquisition / reflection command (stgxfwcmsetdev) is executed in a Storage management server.
Reset the replication volume information by the replication volume informatin setting command (swsrpsetvol).
Also, when you add a new device or delete a device (including general devices other than a disk array device) on a Windows 2000 / Windows2003 storage server, perform the "acquire and reflect all device information" operation listed on the initial window to update the correspondence table for AdvancedCopy Manager device names and OS information.
When you use a replication destination volume by mounting or by allocating a drive letter after creating a replication, the size of the replication destination volume must exactly match the size of the replication destination volume to the byte. If you do not use a replication destination volume (for example, when you need copy data, you restore it to the replication source volume and then use it), the size of the replication destination volume can be larger than the size of the replication source volume.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset).
Synchronous processing start command (swsrpstartsync)
Replication creation command (swsrpmake)
Replication cancellation command (swsrpcancel)
Synchronization mode change command (swsrpchsync)
Synchronization reverse command (swsrprevsync)
Resource adjustment command (swsrprecoverres)
SQL Server backup execution command (swsrpbackup_sql)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
Exchange VSS backup execution command (swsrpvssbackup_exchange)
Exchange VSS restore execution command (swsrpvssretore_exchange)
Exchange VSS shadow copy management command (swsrpshadowadm_exchange)
Shadow copy management command (swsrpshadowadm)
This command displays the replication volume information registered by the replication volume setting command.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpvolinfo [-L] [Original-Volumue-Name] [To be executed on a storage management server] program-directory\bin\swsrpvolinfo -h Server-Name [-L] [Original-Volume-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option is valid only on a storage management server. |
|
-L |
Specifies that information be displayed using the extended format. Refer to the table in the execution example for information about the items that are displayed when this option is specified. The items that are displayed when this option is specified may be expanded to support new functions provided by future versions. |
Description of operands
|
Operand |
Description |
|---|---|
|
Original-Volume-Name |
Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Displays all the replication volume information for the specified replication source volume. If this operand is omitted, all the replication volume information existing on the storage server on which this command is executed is displayed. Specifies a AdvancedCopy Manager device name for the volume name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Direct that all the replication volume information on a storage management server be displayed on storage server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpvolinfo -h SRC-SV Server Original-Volume Size Replica-Volume Size Copy Op-Server SRC-SV g1d1p1@SRC-SV 4.0Gbyte g2d1p1@TARG-SV 4.0Gbyte uni-direction original SRC-SV g1d2p1@SRC-SV 4.0Gbyte g2d2p1@TARG-SV 5.0Gbyte bi-direction original SRC-SV g1d3p1@SRC-SV 9.1Gbyte g2d3p1@TARG-SV 9.1Gbyte bi-direction replica SRC-SV g1d4p1@SRC-SV 7.5Gbyte g2d4p1@TARG-SV 7.5Gbyte bi-direction both C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Original-Volume |
Displays a replication source volume name. |
|
Size |
Displays the volume size. |
|
Replica-Volume |
Displays a replication destination volume name. |
|
Copy |
Displays the copying direction. uni-direction: One-way copying from a replication source volume to a replication destination volume is allowed. bi-direction: Bidirectional copying is allowed. |
|
Op-Server |
Displays the operation server of a pair of replication volumes. original: The replication source server is the operation server. replica: The replication destination server is the operation server. both: Sets both the copy-source server and copy-destination server as operation servers. |
|
Group [only if the -L option has been specified] |
Displays the group name. "----"is displayed if the copy source and destination volumes are not registered in a group. |
Replication volume information cannot be displayed if:
The specified volume is not set as a replication source volume
This command cannot be executed while the following command is running:
Resource adjustment command (swsrprecoverres)
Delete the replication volume information that has been set.
If copy processing is being performed on a replication volume that is to be deleted, execute the command after the copy processing has stopped.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpdelvol [-e] [-d] Original-Volume-Name Replica-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrpdelvol -h Server-Name [-e] [-d] Original-Volume-Name Replica-Volume-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option is valid only on a storage management server. |
|
-e |
Emergency operation mode is available for operations. Specifies deleting replica volume information, without checking the execution state of an advanced copy. Use this option, only when it is clear that the advanced copy is not executed. |
|
-d |
Specifies that no communication take place between the linked servers in replication between servers. When this option is specified, replication volume information is deleted without communication taking place between the linked servers. Use the option only when recovery of one of the linked servers cannot be expected. |
Description of operand
|
Operand |
Description |
|---|---|
|
Original-Volume-Name |
Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Specifies an AdvancedCopy Manager device name. |
|
Replica-Volume-Name |
Specifies a replication destination volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Specifies an AdvancedCopy Manager device name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Delete replication volume information on storage server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpdelvol g1d1p1 g2d1p1@TARG-SV swsrpdelvol completed C:\> |
Replication volume information cannot be deleted if:
The specified replication source volume and the replication destination volume are not set as replication volumes.
The copy processing (synchronization processing and snapshot processing) is performed between replication volumes.
For server-to-server replication, the storage server that executed the command is not the operation server of the replication volume.
Communication with a storage management server fails.
For server-to-server replication, communication with a destination server fails.
However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset).
Synchronous processing start command (swsrpstartsync)
Replication creation command (swsrpmake)
Replication cancellation command (swsrpcancel)
Synchronization mode change command (swsrpchsync)
Synchronization reverse command (swsrprevsync)
Resource adjustment command (swsrprecoverres)
SQL Server backup execution command (swsrpbackup_sql)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
Exchange VSS backup execution command (swsrpvssbackup_exchange)
Exchange VSS restore execution command (swsrpvssretore_exchange)
Exchange VSS shadow copy management command (swsrpshadowadm_exchange)
Shadow copy management command (swsrpshadowadm)
Displays information for the transfer buffer used by ETERNUS when REC is performed in Consistency mode.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrprecbuffstat [-Xaltpath] Volume-Name [To be executed on a storage management server] program-directory\bin\swsrprecbuffstat -h Server-Name [-Xaltpath] Volume-Name |
Description of options
|
Option |
Description |
|
-h |
Specifies the name of a storage server. You can use this option only for a storage management server. |
|
-Xaltpath |
/dev/sfdsk/(class name)/dsk/(volume name):(DEVNAM value for sdxinfo) |
Description of operands
|
Operand |
Description |
|
Volume-Name |
Specifies the name of a volume that has been registered as a replication volume. You can only specify volumes that are connected to the Storage server where the command is executed. Specify the AdvancedCopy Manager device name as the volume name. |
End status
=0:Normal end
>0:Abnormal end
Execution example
Display information for the transfer buffer used by the REC, where the copy source volume is g1d10p1@Server1 and the copy destination volume is g1d20p1@Server1, and replication is performed within the storage server "Server1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA C:\> |
Display information for the transfer buffer used by the REC in an environment where replication is being performed between storage server "Server1" and storage server "Server2".Additionally, the copy source volume is g1d10p1@Server1 and the copy destination volume is g1d30p1@Server2.
[Command executed on storage server "Server1"] C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\> [Command executed on storage server "Server2"] C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d30p1@Server2 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 2 SEND 5% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA C:\> |
Display information for the transfer buffer used by the REC if a cabinet where the copy source volume g1d10p1@Server1 resides has been set up to make remote copies to multiple cabinets, and replication is being performed between storage server "Server1" and storage server "Server2"
[Command executed on storage server "Server1"] C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 3 SEND 4% CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC 4 RECV 0% CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC 5 SEND 10% DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD 6 RECV 0% EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE 7 SEND 3% FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 8 SEND 5% GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG C:\> |
The following information will be displayed.
|
Title |
Description |
|
BoxID |
The box identifier for the cabinet connected to the server where the command was executed. |
|
ID |
The ID for the transfer buffer. |
|
Use |
The attribute (usage) for the transfer buffer. SEND : Transfer buffer for sending data |
|
Rate |
The usage rate of the transfer buffer as a percentage. If the usage is SEND: Displays the usage rate of the transfer buffer as a percentage.This will never be 0%, even if REC is not being performed in asynchronous Consistency mode. If the usage is RECV: "0%" will always be displayed. "----" will be displayed if the transfer buffer cannot be used. |
|
RemoteBoxID |
The box identifier for the cabinet performing a remote copy. |
Information is displayed only for cabinets that contain replication volumes for the server where the command was executed.
If intercabinet replication is being performed between servers, then the command must be executed on both servers involved in the replication in order to check information for the transfer buffers in both cabinets.
It will take a short period for changes to REC transfer buffer settings to take effect, during which time the buffer may become unusable (the "Rate" field will be displayed as "----"). In this case, wait about one minute and then execute the command again.
This command cannot be executed while the following command is running:
Resource adjustment command (swsrprecoverres)
Changes the settings for the transfer buffer used by ETERNUS when REC is performed in Consistency mode.
Refer to "ETERNUSmgr User's Guide Setup / Maintenance" about the setting method of REC transfer buffer.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrprecbuffset -Xbuffid buffer-id -Xbuffuse {SEND|RECV} [-Xaltpath] Volume-Name [To be executed on a storage management server] program-directory\bin\swsrprecbuffset -h Server-Name -Xbuffid buffer-id -Xbuffuse {SEND|RECV} [-Xaltpath] Volume-Name |
Description of options
|
Option |
Description |
|
-h |
Specifies the name of a storage server. You can use this option only for a storage management server. |
|
-Xbuffid |
Specifies the ID for the transfer buffer. |
|
-Xbuffuse |
Specifies the usage for the transfer buffer. SEND : Transfer buffer for sending data |
|
-Xaltpath |
/dev/sfdsk/(class name)/dsk/(volume name):(DEVNAM value for sdxinfo) |
Description of operands
|
Operand |
Description |
|
Volume-Name |
Specifies the name of a volume that has been registered as a replication volume. You can only specify volumes that are connected to the Storage server where the command is executed. Specify the AdvancedCopy Manager device name as the volume name. |
End status
=0:Normal end
>0:Abnormal end
Execution example
Change the attributes for the transfer buffer used by the REC where the copy source volume is g1d10p1@Server1 and the copy destination volume is g1d20p1@Server1, and replication is being performed within the storage server "Server1"
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpbuffset -Xbuffid 1 -Xbuffuse RECV g1d10p1@Server1 swsrpbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 RECV 0% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpbuffset -Xbuffid 1 -Xbuffuse SEND g1d20p1@Server1 swsrpbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ID Use Rate RemoteBoxID 1 SEND 3% AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC:\> |
Change the connected cabinet for the transfer buffer where the copy source volume is g1d10p1@Server1, and replication is being performed between storage server "Server1" and storage server "Server2".
[Command executed on storage server "Server1"] C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d10p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 12% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpbuffset -Xbuffid 1 -Xbuffuse SEND g1d20p1@Server1 swsrpbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpbuffset -Xbuffid 2 -Xbuffuse RECV g1d20p1@Server1 swsrpbuffset completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecbuffstat g1d20p1@Server1 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA ID Use Rate RemoteBoxID 1 SEND 4% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB 2 RECV 0% BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB C:\> |
Settings for dedicated REC buffers must be made in advance.
Change settings while there are no asynchronous Consistency mode sessions in either the ACTIVE or ERROR SUSPEND state.
Information can be changed only for cabinets that contain replication volumes for the server where the command was executed.
It will take a short period for changes to buffer settings to take effect, during which time the transfer buffer will become unusable. Do not perform REC operations during this time.
This command cannot be executed while any of the following commands are running.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Synchronous processing start command (swsrpstartsync)
Replication creation command (swsrpmake)
Operation status display command (swsrpstat)
Replication cancellation command (swsrpcancel)
Synchronization mode change command (swsrpchsync)
Synchronization reverse command (swsrprevsync)
Resource adjustment command (swsrprecoverres)
SQL Server backup execution command (swsrpbackup_sql)
Exchange2003 database information registration command (swsrpdbinfo_ex2k3)
Exchange VSS backup execution command (swsrpvssbackup_exchange)
Exchange VSS restore execution command (swsrpvssretore_exchange)
Exchange VSS shadow copy management command (swsrpshadowadm_exchange)
Shadow copy management command (swsrpshadowadm)
This chapter describes operation commands for replication management.
To operate replication management, use the following commands:
|
Function |
Command name |
Description |
|---|---|---|
|
swsrpstartsync |
Starts replication while the synchronous type replication function is performed. |
|
|
swsrpmake |
Creates replication while the snapshot type and the synchronous type replication functions are performed. |
|
|
swsrpstat |
Displays the status of replication operation |
|
|
swsrpcancel |
Cancels the replication processing while the snapshot type and the synchronous type replication functions are performed. |
Start the synchronous type replication processing (copying between disks by EC and REC).
Copy all the specified replication destination and replication source volumes (start of the synchronization processing), or copy (restart of the synchronization processing) updated data (difference). Use this command at the start of operation or when you want to reflect updated data (difference) from the equivalency holding status.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpstartsync [-y [-a | -v]| -k | -i] [-g] [-m] [-Xskip | -Xremain] [-t] From-Volume-Name To-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrpstartsync -h Server-Name [-y [-a | -v]| -k | -i] [-g] [-m] [-Xskip | -Xremain] [-t] From-Volume-Name To-Volume-Name [if executed on a storage server: group specification] program-directory\bin\swsrpstartsync [-y [-a | -v]| -k | -i] [-g] [-m] [-Xskip | -Xremain] [-t] [-Xreverse] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpstartsync -h Server-Name [-y [-a | -v]| -k | -i] [-g] [-m] [-Xskip | -Xremain] [-t] [-Xreverse] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|
-h |
This option is valid only on a storage management server. This option can be specified only on a storage management server. |
|
-y |
Specifies synchronization in synchronous write mode. This option is valid only when total copy is started for inter-box replication. Not specifying the -y, -k, and -i option sets asynchronous write mode. Synchronization in intra-box replication is always handled in synchronous write mode. |
|
-a |
Specifies the start of split mode for inter-box synchronization in Automatic Split mode. This option is valid only when total copy is started for inter-box replication. Specify this option together with the -y option. Specifying the -y option without the -a option or -v option sets Automatic Split mode. |
|
-v |
Specifies the start of split mode for inter-box synchronization in Manual Split mode. This option is valid only when total copy is started for inter-box replication. Specify this option together with the -y option. Specifying the -y option without the -a option or -v option sets Automatic Split mode. You must specify this option when specifying synchronization mode (-y option) on a box that does not support Automatic Split mode. |
|
-k |
Specifies the setting of transfer mode for inter-box synchronization in Stack mode. This option is valid only when total copy is started for inter-box replication. Not specifying the -y, -k, or -i option sets asynchronous write mode. You cannot use this option when operating SDX objects in units of logical volumes. |
|
-i |
Specifies the setting of transfer mode for inter-box synchronization in Consistency mode. This option is valid only when total copy is started for inter-box replication. Not specifying the -y, -k, or -i option sets asynchronous write mode. |
|
-g |
Specifies the setting of recovery mode for inter-box synchronization in Manual Recovery mode. This option is valid only when total copy is started for inter-box replication. Not specifying this option sets Automatic Recovery mode. |
|
-m |
For server-to-server replication, specifies that communication processing with non-operation servers is not performed. When this option is specified, volume status check processing and the preprocessing for the replication destination volume of a non-operation server are not performed. This option is valid only during server-to-server replication. |
|
-t |
Specifies that preprocessing for the replication destination volume is not performed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device). |
|
-Xgroup |
Specifies that synchronous processing be started for each group. |
|
-Xreverse |
Specifies that synchronous processing be started for each group in the reverse direction (from replica volumes to original volumes). |
|
-Xskip |
Specifies that synchronous processing be suspended using the initial copy skip function. This option is valid only when total copy is started for inter-box replication. |
|
-Xremain |
Enables data that has been updated to the copy destination during replication established status when synchronous processing is restarted. This option is valid only when inter-box replication is restarted. This option is used to reflect to the copy destination volume only those parts of the copy source volume that have been updated, after synchronous processing has been started using the -Xskip option and backup data has been copied from the tape medium to the copy destination volume. |
Description of operands
|
Operand |
Description |
|---|---|
|
From-Volume-Name |
Specifies a replication source volume name. Specifies the replication source volume or the replication destination volume set with the replication volume information setting command. Specifies a AdvancedCopy Manager device name |
|
To-Volume-Name |
Specifies a replication destination volume name. Specifies the replication source volume or the replication destination volume set with the copy volume information setting command. Specifies a AdvancedCopy Manager device name |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Start replication from g1d1p1 of a storage management server to g2d1p1@TARG-SV of storage server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstartsync -h SRC-SV g1d1p1 g2d1p1@TARG-SV FROM=g1d1p1@SRC-SV,TO=g2d1p1@TARG-SV swsrpstartsync completed C:\> |
Start replication for group "GRP1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstartsync -Xgroup GRP1 GROUP=GRP1 swsrpstartsync completed C:\> |
Replication cannot be started if:
The specified source volume and destination volume are not set as replication volumes.
A replication source volume is specified as the copy volume and a replication destination volume is specified as the copied material volume, and one-way copy is set as the copy attribute of the replication volume.
Volume information (box identifier, OLU, EXTENT start position, and EXTENT size) is changed after operation starts. In this case, operation cannot continue for the corresponding volume. Stop the replication operation for the corresponding volume, and then delete and set the replication volume information.
For server-to-server replication, the storage server on which the command is executed is not the operation server of the replication volume.
For server-to-server replication, communication with a destination server fails.
Replication cannot be started as a result of the preceding advanced copy function.
When a destination volume could not be locked
When the destination volume locking specification file is invalid
When option -g is specified, except for a remote copy.
When the backup management function or tape backup function uses a specified source/destination volume
When either the copy source volume or the copy destination volume is a Snap Data Volume.
When the replication to perform corresponds to either of the following conditions, please perform drive letter release or unmount of copy place volume before executing a command.
When a replication is performed between different OS's
When the sizes of replication source volume and replication destination volume differ
When performing neither drive letter release nor unmount in the above-mentioned case, post-processing of the copy place volume at the time of duplicate creation serves as an error.
Now, the replication which makes a SDX object (SynfinityDISK) replication source volume is not supported. Therefore, when one of replication destination volume and the duplicate place volumes is a SDX object, only the replication from a SDX object to a non-SDX object can be used.
Use the COPY command in copying data to a SDX object.
You cannot change synchronization mode when synchronization is resumed.
When synchronization is resumed, you must specify the -y, -a, -v, -k, -i, and -g options as follows:
Specify only the options that match the mode of synchronization to be resumed, or
Do not specify any of the options.
The processing of this command varies according to the status of the synchronization processing of the specified replication source and replication destination volumes.
Status of synchronization processing
Processing
Unmount status
Start of total copy
Total or incremental copy status
Informational message (swsrp2401) is output and normally end
Equivalency maintain status
Informational message (swsrp2401) is output and normally end
Replication established status (halt status)
Start of incremental copy
Before starting the replication, run the replication preprocessing script for the replication destination volume. The contents of this script can be customized. For more information, see "Preprocessing and Postprocessging of Replication". If you do not want to implement the preprocessing script, use the -t option.
To protect processing that accesses a replication destination volume, set the replication destination volume before starting replication so that other processes cannot access it. To do so, cancel the drive letter of the replication destination volume or execute unmount. If you cannot cancel the drive letter of the replication destination volume or execute unmount because of the situations described below, this command fails and terminates.
There is a directory in which other volumes are mounted under the mount point.
A file on the volume is being used. In addition, if the replication destination volume is being used from a server other than the server on which this command is entered, the replication-operation administrator must disable access to the replication destination volume by cancellation of the share setting, unmounting, or some other method.
See "General notes", for notes on starting replication.
If the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
When synchronization processing (EC) is not performed, start snapshot processing (OPC) to create a replication volume.
When synchronization processing is performed, check whether the status of the processing is equivalency holding status. If the status is equivalency holding status, suspend the synchronization processing and create a replication volume. The status in which synchronization processing is suspended is referred to as the replication established status. After this command is executed, the replication volume (replication destination volume) can be accessed.
This command executes the replication preprocessing and postprocessing before a replication is created. For details of these processes, see "Preprocessing and Postprocessing of Replication".
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpmake [-m] [-f | -Xflush] [-t] ([-j | -T | -Xconcur | -C]) From-Volume-Name To-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrpmake -h Server-Name [-m] [-f | -Xflush] [-t] ([-j | -T | -Xconcur | -C]) From-Volume-Name To-Volume-Name [if executed on a storage server: group specification] program-directory\bin\swsrpmake [-m] [-f] [-t] ([-j|-T|-Xconcur|-C]) [-Xreverse] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpmake -h Server-Name [-m] [-f] [-t] ([-j|-T|-Xconcur|-C]) [-Xreverse] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-m |
For server-to-server replication, specifies that communication processing with the non-operation server is not performed. When this option is specified, volume status check processing and preprocessing and postprocessing are not performed for the non-operation server volume. This option is valid only during server-to-server replication. |
|
-f |
Specifies that the preprocessing and postprocessing for a replication source volume are not performed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy source volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device). |
|
-t |
Specifies that the preprocessing and postprocessing for a replication destination volume are not performed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device). |
|
-Xflush |
Specifies flushing the file system buffer of the copy source volume instead of locking the copy source volume. Before this option is specified, all write processing on the copy source volume must be stopped. (If a replica is created without the write processing stopped, then the copy source volume data is not guaranteed.) The file system buffer can be flushed by specifying on for BufferFlushOnly in the copy source volume locking specification file instead of this option. (For details, see "Copy source volume locking specification file.") |
|
-j |
Specifies that copy processing be forcibly suspended even if the execution status of copying is "sync: Total copy or incremental copy is being performed" or "halt: Hard suspend status" in synchronization processing of intercabinet replication. This option can be used only for intercabinet replication. If used for intracabinet replication, an error occurs. When this option is specified, the data in the destination volume is not guaranteed. Also, when this option is specified, preprocessing and postprocessing for the source and destination volumes are not performed. |
|
-T |
Specifies that differential snapshot processing be executed. This option cannot be specified while synchronous processing is performed. This option is valid only for a replication within a cabinet and when the disk array supports the QuickOPC function. For a snapshot replication without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be specified to perform the replication operation using differential snapshots. |
|
-Xgroup |
Specifies that a replication be created for each group. |
|
-Xreverse |
Specifies that a replication be created for each group in the reverse direction (from replica volumes to original volumes). |
|
-Xconcur |
Specifies that a replication be created using the concurrent suspension function. This option is not supported when GDS Snapshot linkage is being used. |
|
-C |
Specifies that SnapOPC be start. This option is valid only for a replication within a cabinet and when the disk array supports the SnapOPC function. In order to execute SnapOPC, the copy destination volume must be a Snap Data Volume. |
Description of operands
|
Operand |
Description |
|---|---|
|
From-Volume-Name |
Specifies a replication source volume. Specifies the replication source volume or the replication destination volume that was set with the replication volume information setting command. Specifies a AdvancedCopy Manager device name for the volume name. |
|
To-Volume-Name |
Specifies a replication destination volume. Specifies the replication source volume or the replication destination volume that was set with the replication volume information setting command. Specifies a AdvancedCopy Manager device name for the volume name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
On a storage management server, direct replication of g1d1p1 to g2d1p1@TARG-SV for storage server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpmake -h SRC-SV g1d1p1 g2d1p1@TARG-SV FROM=g1d1p1@SRC-SV,TO=g2d1p1@TARG-SV swsrpmake completed C:\> |
Creates a copy for the group " GRP1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpmake -Xgroup GRP1 GROUP=GRP1 swsrpmake completed C:\> |
Replication cannot be created if:
The specified replication source and replication destination volumes are not set as replication volumes.
The synchronization processing from the specified replication source volume to the replication destination volume is not in the equivalency holding status.
After operation starts, physical volume information (box identifier, OLU, EXTENT start position, and EXTENT size) is changed. In this case, operation for the corresponding volume cannot continue. Stop the replication operation for the volume, and then delete and set the replication volume information.
A destination volume has multiple mount points.
If a replication source volume is an SDX object (SynfinityDISK), the status of the SDX object does not match the following:
The mirror volume is ACTIVE or STOP.
The mirror slice status is ACTIVE or STOP.
The SDX disk status is ENABLE.
For server-to-server replication, the storage server on which the command is executed is not the operation server of the replication volume.
For server-to-server replication, communication with a destination server fails.
When the copy source volume cannot be locked.
When the file system buffer of the copy source volume cannot be flushed by specification of the Xflush option.
When the contents of the copy source volume locking specification file are invalid.
When the replication destination volume cannot be locked
When the contents of the replication destination volume lock operation specification file are invalid
When the backup management function or tape backup function uses a specified source/destination volume
When the replication to perform corresponds to either of the following conditions, please perform drive letter release or unmount of copy place volume before executing a command.
When a replication is performed between different OS's
When the sizes of replication source volume and replication destination volume differ
When performing neither drive letter release nor unmount in the above-mentioned case, post-processing of the copy place volume at the time of duplicate creation serves as an error.
Now, the replication which makes a SDX object (SynfinityDISK) replication source volume is not supported. Therefore, when one of replication destination volume and the duplicate place volumes is a SDX object, only the replication from a SDX object to a non-SDX object can be used.
Use the COPY command in copying data to a SDX object.
Before a replication is created, the preprocessing for the source volume and destination volume are executed (for synchronized replication, only preprocessing is executed). After the replication has been created, the postprocessing for the source volume and destination volume is executed. The contents of the script can be customized. For more information, "Preprocessing and Postprocessing of Replication" If you do not want to implement the preprocessing and postprocessing scripts, use the -f option and the -t option.
If this command is executed during execution of snapshot processing, stop the copy processing in progress and start the snapshot processing again.
To protect the data, set the replication source volume before creating a replication so that other processes cannot access the volume. To do so, lock the source volume or execute unmount. If you cannot lock the source volume or execute unmount because of the situations described below, this command fails and terminates.
There is a directory in which other volumes are mounted under the mount point.
A file on the volume is being used. In addition, if the replication source volume is being used from a server other than the server on which this command is entered, the backup-operation administrator must disable access to the replication source volume by cancellation of the share setting, unmounting, or some other method. If for whatever reason you do not want to remove the share setting of the replication source volume or execute unmount or some other method, see "Preprocessing and Postprocessing of Replication" and note the following.
To synchronize the volumes and the file system in replication preprocessing, specify the Xflush option in this command or set BufferFlushOnly to on in the copy source volume locking specification file.
For replication postprocessing, if you want to check the file system at the replication destination, assign a drive letter to the replication destination volume with the chkdsk drive letter assign command (swstdrvset).
When the replication source volume is being used by backup management, unmount may not possible. If so, "swsrp2613 An error occurred in the preprocessing script for creating a replica. Error Code = 2" or "swsrp3607 Locking the volume failed. Please confirm that the volume is being used by other processes. Error=5(FSCTL_LOCK_VOLUME), Volume Name=[VOLUME NAME]" is output.
However, since a replication may be unable to be completely performed in the above-mentioned procedure, in servers other than the server which supplies this command, we recommend you to perform a replication under the environment where copied material volume is not used.
See "General notes", for notes on creating replication.
Before replication is performed in snapshot-type replication, this command option prevents other processes from accessing the replication destination volume to protect the process that is accessing the volume. The command accomplishes this by locking or unmounting the replication destination volume. In cases where the replication destination volume cannot be locked or unmounted, such as described below, the command terminates with an error:
The mount point has a directory for mounting another volume.
The volume has a file that is being used. If the replication destination volume is being used by a server that is not the server where the command was entered, prevent the replication destination volume from being accessed by canceling share settings or performing unmounting for the replication operation, using administrator's authority.
If the -Xgroup option is specified, processing will be terminated without creating a copy if the operation statuses of the replication volumes being processed include both snapshot-type replication and synchronous-type replication.
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.
For Snap Data Volumes, only SnapOPCs can be executed and OPCs and QuickOPCs cannot be executed.
Additionally, when restoring data from a Snap Data Volume, note that there must be a SnapOPC session between the copy source volume and the copy destination volume (Snap Data Volume).
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
If this command is executed during snapshot processing, snapshot processing is newly started. See the following table for details of copy operation:
|
Operation status |
-T option specification |
Copy operation |
|---|---|---|
|
Copy is not executed. |
No |
Ordinary snapshot processing is started. |
|
Copy is not executed. |
Yes |
Differential snapshot processing is started. |
|
Snapshot processing is in progress |
No |
Copying in progress is terminated and ordinary snapshot processing is newly started. |
|
Snapshot processing is in progress |
Yes |
Copying in progress is terminated and differential snapshot processing is newly started. |
|
Snapshot processing is in progress |
No |
Copying in progress is terminated and ordinary snapshot processing is newly started. |
|
Snapshot processing is in progress |
Yes |
Differential snapshot processing is restarted. |
|
Tracking is in progress. |
No |
Tracking processing is terminated and ordinary snapshot processing is newly started. |
|
Tracking is in progress. |
Yes |
Differential snapshot processing is restarted. |
This command displays the operation status of the specified volume. If a volume is not specified, the operation status of each replication volumes is displayed.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpstat [-L] [-E] [-H] [Original-Volume-Name] [To be executed on a storage management server] program-directory\bin\swsrpstat -h Server-Name [-L] [-E] [-H] [Original-Volume-Name] [if executed on a storage server: group specification] program-directory\bin\swsrpstat [-L] [-E] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpstat -h Server-Name [-L] [-E] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-L |
Specifies display in extension format. For the items displayed by this option, see the table of the execution example. Note that the items displayed by this option may be subject to change in a future release. |
|
-E |
An option which when set will display the operational status in the opposite direction only(from the copy destination to the copy source). In case this option is not set, the operation status in the normal direction (from the copy source to the copy destination) will always be displayed when a bi-directional OPC physical copy is taking place. In case this option is set, the operational status in the normal direction will not be displayed. Only the operational status in the opposite direction will be displayed. This option can be used to check the operational status of an OPC session performed in an opposite direction in case a QuickOPC session in the normal direction exists. |
|
-Xgroup |
Specifies that operation statuses are displayed by the group. In case this option is set, all the operational statuses about the specified group will be displayed. |
|
-H |
Changes the Status field display method used when a REC enters a hard suspend (HALT) status. If this option is specified, then "halt(sync)" will be displayed when hard-suspend status occurs during a total copy or a differential copy. "halt(equivalent)" will be displayed when hard-suspend status occurs during an equivalency maintenance state. Note that hard-suspend status will still be displayed as "halt" even if this option is specified for ROPC. |
Description of operands
|
Operand |
Description |
|---|---|
|
Original-Volume-Name |
Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name." Displays all operation statuses for the specified replication source volume. If this operand is omitted, all the operation statuses of the storage server on which this command is executed are displayed. For the volume name, specify a AdvancedCopy Manager device name |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Direct that all the replication operation statuses for storage server SRC-SV be displayed on the storage management server.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstat -h SRC-SV Server Original-Volume Replica-Volume Direction Status Execute SRC-SV g1d1p3@SRC-SV g2d1p1@TARG-SV regular replicated ---- SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV ---- ---- ---- SRC-SV g1d3p1@SRC-SV g2d3p1@TARG-SV reverse snap 45% C:\> |
From storage management server to storage server: Instruct SRC-SV to display the status of all replication operations (with the -L option specified).
C:\>C:\Win32app\AdvancedCopyManager\binswsrpstat -h SRC-SV -L Server Original-Volume Replica-Volume Direction Status Execute Trk Update Rcv Split Xfer SRC-SV g1d1p3@SRC-SV g2d1p1@TARG-SV regular replicated ---- ---- ---- auto ---- async SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV ---- ---- ---- on 6% ---- ---- ---- SRC-SV g1d3p1@SRC-SV g2d3p1@TARG-SV reverse snap 45% off ---- ---- ---- ---- C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Server |
Displays a storage server name. |
|
Original-Volume |
Displays a replication source volume name. |
|
Replica-Volume |
Displays a replication destination volume name. |
|
Direction |
Displays the copy direction.
|
|
Status |
Displays the progress.
|
|
Execute |
Displays the rate of copying progress as a percentage. "----" is displayed during SnapOPCs and when replication has not been implemented. |
|
Trk |
Displays whether tracking processing is in progress. on : Tracking processing is in progress. off : Tracking processing is in progress. ----: Snapshot processing is not performed. Always displays "----" when the GDS Snapshot linkage function is enabled. |
|
Update |
Displays the percentage of data that has been updated since the previous replication was created, in either of the following cases:
Displays "----" during physical copying or when tracking is not in progress. Always displays "----" when the GDS Snapshot linkage function is enabled. |
|
Rcv |
Indicates recovery mode for inter-box synchronization. auto: Automatic Recovery mode. manual: Manual Recovery mode. ----: Synchronous duplication (REC) is not performed between boxes. |
|
Split |
Indicates split mode for inter-box synchronization. auto: Automatic Split mode. manual: Manual Split mode. ----: Synchronous duplication (REC) is not performed between boxes. |
|
Xfer |
Indicates transfer mode in inter-box synchronization. sync: Synchronous mode. async: Asynchronous mode. stack: Stack mode. consist: Consistency mode. ----: Synchronous duplication (REC) is not performed between boxes. |
When the execution status (status displayed in the Status field) is one of the following, take appropriate action.
Status display
Corrective action
failed
A hardware error may have occurred. Correct the hardware error, and then use the replication cancellation command to stop operation.
halt
A hardware error during replication operation between cabinets may occur. Correct the hardware error, and then use the replication cancellation command to stop the copy operation.
?????
Copy situation cannot be acquired. A hardware error may have occurred if the result is the same after reexecution. Correct the hardware error, and then reexecute the command.
The operation status cannot be displayed if:
The volumes are not set as replication volumes.
This command cannot be executed while the following command is running:
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
This command stops snapshot processing (OPC) and synchronization processing (EC) of the specified replication volume. Use this command when an error is detected during the replication operation and when you want to stop replication processing.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpcancel [-c] ([-f] [-t] [-m] [-b]) | [-T] [-Xflush] From-Volume-Name To-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrpcancel -h Server-Name [-c] ([-f] [-t] [-m] [-b]) | [-T] [-Xflush] From-Volume-Name To-Volume-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpcancel [-c] ([-f] [-t] [-m] [-b]) | [-T] [-Xreverse] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpcancel -h Server-Name [-c] ([-f] [-t] [-m] [-b]) | [-T] [-Xreverse] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be specified only on a storage management server. |
|
-c |
Specifies that the copy processing is forcibly stopped from a non-operation server when the operation server cannot be used because of a system failure. If this option is used, the copy processing is stopped without implementing preprocessing and postprocessing. As a result, the copy destination volume may become locked if copy processing is canceled using this option.Check the status of the copy destination volume using the locked-volume information display command (swstvollockstat) and, if it is locked, unlock the volume using the volume unlock command (swstvolunlock) This option cannot be specified on the operation server. |
|
-m |
For server-to-server replication, specifies that communication processing with non-operation servers is not performed. When this option is specified, volume status check processing and preprocessing and postprocessing for the replication destination volume of a non-operation server are not performed. This option is valid only during server-to-server replication. |
|
-f |
When stopping the synchronous processing under the equivalency maintain status, specify that preprocessing and postprocessing for the copy source volume not be executed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy source volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device). |
|
-t |
When stopping the synchronous processing under the equivalency maintain status, specify that postprocessing for the copy destination volume not be executed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device). |
|
-Xflush |
Specifies flushing the file system buffer of the copy source volume instead of locking the copy source volume when the synchronous processing under the equivalency maintain status is stopped. Before this option is specified, all write processing on the copy source volume must be stopped. (If a replica is created without the write processing stopped, then the copy source volume data is not guaranteed.) The file system buffer can be flushed by specifying on for BufferFlushOnly in the copy source volume locking specification file instead of this option. (For details, see "Copy source volume locking specification file.") |
|
-b |
Specifies that the intercabinet copy operation in the HALT status be stopped. For replication on a server, the copying is cancelled for both cabinets. For replication between servers, the copying is cancelled only for the cabinet connected to the server on which this command was executed. Use the option only for a copy operation in the HALT status and whose recovery cannot be expected. The option is valid only for a copy operation in the HALT status. The option can be used on the server not specified as the operation server. If this option is specified together with the -Xgroup option, copy processing is only stopped for sessions in the group whose status is HALT. |
|
-T |
Specifies that differential snapshot processing be terminated. This option terminates only tracking processing but does not terminate snapshot processing (OPC physical copying) in progress. This option releases the OPC session if snapshot processing (OPC physical copying) is complete. This option can be used only while physical copying or tracking is in progress. This option cannot be used for the logical volume of an SDX object. If this option is specified together with the -Xgroup option, only tracking processing within the group is stopped. |
|
-Xgroup |
Specifies that copy processing be stopped for each group. |
|
-Xreverse |
Specifies that copy processing that is being executed in the reverse direction (from replica volumes to original volumes) be stopped. |
Description of operands
|
Operand |
Description |
|---|---|
|
From-Volume-Name |
Specifies a copy source volume name. Specifies the replication source volume or the replication destination volume set with the replication volume information setting command. Specifies a AdvancedCopy Manager device name for the volume name. |
|
To-Volume-Name |
Specifies a copy destination volume name. Specifies the replication source volume or the replication destination volume set with the copy volume information set command. Specifies a AdvancedCopy Manager device name for the volume name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
On the storage management server, direct that copying from g1d1p1 to g2d1p1@TARG-SV be stopped for storage server SRC-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpcancel -h SRC-SV g1d1p1 g2d1p1@TARG-SV FROM=g1d1p1@SRC-SV,TO=g2d1p1@TARG-SV swsrpcancel completed C:\> |
Stops copy processing for group " GRP1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpcancel -Xgroup GRP1 GROUP=GRP1 swsrpcancel completed C:\> |
Following execution with the -b option specified in replication on a server, the command stops normally when cancellation of the copying succeeds in either of the cabinets.
Copy processing cannot be performed if:
The specified replication source volume and replication destination volume are not set as replication volumes.
The copy processing is not performed for the specified replication source and replication destination volumes.
For server-to-server replication, the storage server on which the command is executed is not the operation server of the replication volume.
For server-to-server replication, communication with a destination server fails.
When the backup management function or tape backup function uses a specified source/destination volume
The volume information for the specified volume is not checked (check for matching of the volume information in the management list and the actual physical information). Operation is canceled unconditionally using the volume information in the management list.
The following processing is performed depending on the operation status of the specified replication source volume and replication destination volume.
Operation status
Processing
Reverse copy direction
Suspends the processing.
Not operating yet
Suspends the processing.
Total or incremental copy is performed
Suspends synchronization processing. The replication destination volume cannot be used.
Equivalency maintain status
Suspends synchronization processing. The replication destination volume can be used as a copy
Replication established status
Suspends synchronization processing. The replication destination volume can be used as a copy
Snapshot processing is being performed
Stops the snapshot processing. The replication destination volume cannot be used.
Preprocessing and post processing for a replication source and replication destination volumes are performed only when the status of synchronization processing is equivalency holding state.
Synchronization processing cannot be stopped in equivalency holding status if:
When the copy source volume cannot be locked.
When the file system buffer of the copy source volume cannot be flushed by specification of the Xflush option.
When the contents of the copy source volume locking specification file are invalid.
When a replication source volume is an SDX object (SynfinityDISK), the status of the SDX object is not one of the following:
The mirror volume is ACTIVE or STOP.
The mirror slice status is ACTIVE or STOP.
The SDX disk status is ENABLE.
When the replication destination volume cannot be locked
When the contents of the replication destination volume lock operation specification file are invalid
If the -Xgroup option is specified, processing will be performed for each active replication volume, but processing will be terminated without canceling replication in the following case:
If no replication volumes have been copied
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
When the -T option is not specified, command processing varies depending on the operation status of the source and destination volumes.
|
Operation status |
Processing |
|---|---|
|
Reverse copy |
Processing is interrupted. |
|
Not in operation |
Processing is interrupted. |
|
Total or difference copying is in progress. |
Synchronous processing is terminated. The destination volume cannot be used. |
|
Equivalency maintain status |
Synchronous processing is terminated. The destination volume can be used as a replica. |
|
Replica created status |
Synchronous processing is terminated. The destination volume can be used as a replica. |
|
Snapshot processing is in progress. |
Synchronous processing is terminated. The destination volume cannot be used. Tracking processing, if in progress, is also terminated. |
|
Snapshot processing complete status |
Tracking processing is terminated. The destination volume can be used as a replica. |
When the -T option is specified, command processing varies depending on the operation status of the source and destination volumes.
|
Operation status |
Processing |
|---|---|
|
Reverse copy |
Processing is interrupted. |
|
Not in operation |
Processing is interrupted. |
|
Total or difference copying is in progress. |
Processing is interrupted. |
|
Equivalency maintain status |
Processing is interrupted. |
|
Replica created status |
Processing is interrupted. |
|
Snapshot processing is in progress |
Processing is interrupted. |
|
Snapshot processing is in progress |
Only tracking processing is terminated. Snapshot processing (physical copying) is continued. The destination volume can be used as a replica. |
|
Snapshot processing complete status |
Tracking processing is terminated. The destination volume can be used as a replica. |
This command changes the operation mode of inter-box synchronization (transfer mode, recovery mode, or split mode).
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrpchsync [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] From-Volume-Name To-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrpchsync -h Server-Name [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] From-Volume-Name To-Volume-Name [if executed on a storage server: group specification] program-directory\bin\swsrpchsync [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] [-Xreverse] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrpchsync -h Server-Name [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] [-Xreverse] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies the name of a storage server. You can use this option only for a storage management server. |
|
-F |
Changes the transfer mode. You can specify one of the following parameters in the operand: Sync: Changes to Synchronous mode. Async: Changes to Asynchronous (sequential transfer) mode. Stack: Changes to Stack mode. Consist: Changes to Consistency mode. Changing the transfer mode requires this option. You can only specify the -S option together with the -F Sync option. Specifying the -F Sync option to change the transfer mode from a non-synchronous mode to the synchronous mode without specifying the -S option sets the automatic split mode. |
|
-R |
Changes the recovery mode. You can specify either of the following parameters in the operand: Auto: Changes to Automatic Recovery mode. Manual: Changes to Manual Recovery mode. Changing the recovery mode requires this option. |
|
-S |
Changes the split mode. You can specify either of the following parameters in the operand: Auto: Changes to Automatic Split mode. Manual: Changes to Manual Split mode. Changing the split mode requires this option. To specify this option, you must also specify -F Sync or the transfer mode of the current synchronization must be synchronous mode. |
|
-Xgroup |
Changes the operation mode of inter-box synchronous processing for each group (transfer mode, recovery mode, or split mode). |
|
-Xreverse |
Specifies that the operation mode of synchronous processing that is being executed in reverse direction (from replica volumes to original volumes) be changed. |
Description of operands
|
Operand |
Description |
|---|---|
|
From-Volume-Name |
Specifies the name of a source volume. Specify the original volume or replica volume configured by the replication volume information set command. |
|
To-Volume-Name |
Specifies the name of a destination volume. Specify the original volume or replica volume configured by the replication volume information set command. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
From storage management server to storage server: Instruct SRC-SV to change the transfer mode for inter-box synchronization between g1d2p1@SRC-SV and g2d2p1@TARG-SV from Consistency mode to Asynchronous mode.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstat -h SRC-SV -L g1d2p1@SRC-SV Server Original-Volume Replica-Volume Direction Status Execute Trk Rcv Split Xfer SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV regular sync 99% ---- auto ---- consist : C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpchsync -h SRC-SV -F Async g1d2p1@SRC-SV g2d2p1@TARG-SV FROM=g1d2p1@SRC-SV, TO=g2d2p1@TARG-SV swsrpchsync completed : C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstat -h SRC-SV -L g1d2p1@SRC-SV Server Original-Volume Replica-Volume Direction Status Execute Trk Rcv Split Xfer SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV regular equivalent 100% ---- auto ---- async C:\> |
Specify that the transfer mode of inter-box synchronous processing for group "GRP1" be changed from consistency mode to asynchronous mode.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpchsync -F Async -Xgroup GRP1 GROUP=GRP1 swsrpchsync completed C:\> |
In any of the following cases, you cannot change the operation mode of inter-box synchronization:
The specified original/replica volume has not been configured as a replica volume.
None of the -F, -R, and -S options are specified.
In inter-server replication, the storage server on which you execute the command is not the operation server for the replica volume.
Synchronization from the specified source volume to the destination volume is not secured.
Synchronization from the specified source volume to the destination volume is in error-suspended status (with "failed" indicated for Status by the operating status display command) or hard-suspended status (with "halt" indicated for Status by the operating status display command).
The disk array in which the specified original/replica volume is placed does not support the operation mode change function.
If the -Xgroup option is specified, the synchronous processing for all replication volumes being processed is changed to the same operation mode. However, the operation mode cannot be changed if there is even one replication volume that meets the conditions above. -
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
This command reverses the copying direction of inter-box synchronization (REC) in suspended status.
This command is unusable to handle an intra-box synchronization or a logical volume of an SDX object.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrprevsync From-Volume-Name To-Volume-Name [To be executed on a storage management server] program-directory\bin\swsrprevsync -h Server-Name From-Volume-Name To-Volume-Name [if executed on a storage server: group specification] program-directory\bin\swsrprevsync [-Xreverse] -Xgroup Group-Name [if executed on a storage management server: group specification] program-directory\bin\swsrprevsync -h Server-Name [-Xreverse] -Xgroup Group-Name |
Description of options
|
Option |
Description |
|---|---|
|
-h |
Specifies the name of a storage server. You can only use this option for a storage management server. |
|
-Xgroup |
Changes the direction of inter-box synchronous processing for each group. |
|
-Xreverse |
Specifies that the direction of synchronous processing that is being executed in reverce direction (from replica volumes to original volumes) be inverted. |
Description of operands
|
Option |
Description |
|---|---|
|
From-Volume-Name |
Specifies the name of a source volume (as the destination in the reverse direction). Specify the original volume or replica volume configured by the replication volume information set command. |
|
To-Volume-Name |
Specifies the name of a destination volume (as the source in the reverse direction). Specify the original volume or replica volume configured by the replication volume information set command. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
From storage management server to storage server: Instruct SRC-SV to reverse the copying direction of inter-box synchronization between g1d2p1@SRC-SV and g2d2p1@TARG-SV.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstat -h SRC-SV g1d2p1@SRC-SV Server Original-Volume Replica-Volume Direction Status Execute SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV reverse replicated ---- C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprevsync g1d2p1@TARG-SV g2d2p1@SRC-SV FROM=g1d2p1@SRC-SV,TO=g2d2p1@TARG-SV swsrprevsync completed C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpstat g1d2p1@SRC-SV Server Original-Volume Replica-Volume Direction Status Execute SRC-SV g1d2p1@SRC-SV g2d2p1@TARG-SV regular replicated ---- C:\> |
Change the direction of inter-box synchronous processing for group "GRP1".
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprevsync -Xgroup GRP1 GROUP=GRP1 swsrprevsync completed C:\> |
In any of the following cases, you cannot reverse the direction of synchronization:
The specified original/replica volume has not been configured as a replica volume.
Unidirectional copying has been specified in the copying attribute for the replica volume.
In inter-server replication, the storage server on which you execute the command is not the operation server for the replica volume.
Replication has not been established in synchronization from the specified source volume to the destination volume.
The disk array in which the specified original/replica volume is placed does not support the REC reverse function.
If the -Xgroup option is specified, the direction of synchronous processing for all replication volumes being processed is changed. However, the direction of synchronous processing cannot be changed if there is even one replication volume that meets the conditions above.
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.
If the -Xgroup option is specified, processing is not performed for those sessions in the group where the direction has already been changed.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
This chapter describes the maintenance commands for replication management.
Use the following maintenance commands for replication management.
|
Function |
Command name |
Description |
|---|---|---|
|
swsrprecoverres |
Restores the consistency of information in a replication management files. |
This command executes recovery to make replication management information consistent if a system failure or other problem has made the replication management information inconsistent.
Specification method
|
[To be executed on a storage server] program-directory\bin\swsrprecoverres [-r] [-p] [To be executed on a storage management server] program-directory\bin\swsrprecoverres -h Server-Name [-r] [-p] |
Description of operands
|
Operand |
Description |
|---|---|
|
-h |
Specifies a storage server name. This option can be used only on a storage management server. |
|
-r |
Specify this option when an incorrect status exists in the replication management files (for example, the replication volume information setting command or the replication volume information deletion command that update the replication management files terminate suddenly because of a forced stop or a system failure, or the replication management files has been deleted by mistake). When this option is specified, the following processing to re-create the replication management files is performed. Replication management information in the storage management server repository is downloaded to the storage server, and the replication volume information is restored. The disk array device is queried, and the execution information for the synchronization processing is restored. |
|
-p |
Specifies not to perform any postprocessing that has not been performed. This option can be used when the replication creation command processing terminates suddenly because of a forced stop or system failure. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Perform resource adjustment.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrprecoverres swsrprecoverres completed C:\> |
The resource adjustment processing cannot be performed if:
Communication with a storage management server fails and the -r option is specified.
The -r option is not specified when this command is executed after processing by the replication volume information setting command and the replication volume information deletion command has been forcibly terminated.
The consistency of resource information is restored only for the storage server on which this command is executed. When a resource inconsistency occurs during processing related to replication between servers, this command must be executed both on the storage server on which the processing was performed and on the storage server with which communication is being made.
This command cannot be executed while any of the following commands is running:
Replication volume information setting command (swsrpsetvol)
Replication volume information display command (swsrpvolinfo)
Replication volume information deletion command (swsrpdelvol)
REC transfer buffer settings change command (swsrprecbuffset)
Synchronous processing start command (swsrpstartsync)
Replication creation command (swsrpmake)
Operation status display command (swsrpstat)
Replication cancellation command (swsrpcancel)
Synchronization mode change command (swsrpchsync)
Synchronization reverse command (swsrprevsync)
Resource adjustment command (swsrprecoverres)
SQL Server backup execution command (swsrpbackup_sql)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
Exchange VSS backup execution command (swsrpvssbackup_exchange)
Exchange VSS restore execution command (swsrpvssretore_exchange)
Exchange VSS shadow copy management command (swsrpshadowadm_exchange)
Shadow copy management command (swsrpshadowadm)
This chapter describes operations using a setup command.
This command sets up or cancels the setting of a virtual directory required to use the GUI window of AdvancedCopy Manager on the Web server (IIS).
This command must be executed on a storage management server. Use this command if:
A failure occurs in the Web server setup automatically executed when you customize AdvancedCopy Manager after installing it.
You uninstall AdvancedCopy Manager.
When employment of a Web client is started or ended
This command sets up and cancels the setting of the following virtual directories:
|
Virtual directory |
Directory name |
Property of virtual directory |
|
swstorage |
program-directory\inet\wwwroot |
Addition of "read" |
|
swstorage-j |
program-directory\java |
Addition of "read" |
|
swstorage-cgi |
program-directory\inet\cgi |
Addition of "Execute permissions" (CGI script is stored.) |
|
swstorage-d |
environment-setting-directory\etc\data |
Addition of "read" |
If any of the virtual directories already exists, change the setting so it can be used on AdvancedCopy Manager.
Specification method
|
program-directory\bin\alias [ -u ] |
Description of options
|
Option |
Description |
|---|---|
|
None |
Sets up the Web server. |
|
-u |
Cancels the setting of the Web server. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Set up the Web server.
C:\>C:\Win32app\AdvancedCopyManager\bin\alias Info:AdvancedCopy Manager Web server setup start. Info:AdvancedCopy Manager Web server setup completed. C:\> |
Cancel the setting of the Web server.
C:\>C:\Win32app\AdvancedCopyManager\bin\alias -u Info:AdvancedCopy Manager Web server unsetup start. Info:AdvancedCopy Manager Web server unsetup completed. C:\> |
If version 6.0 of Internet Information Service is installed, then the confirmation dialog box shown below opens when the [Yes] button in the Confirmation of Web Server Setting dialog box is clicked. To enable execution of CGI script, click [Yes] and set up the Web server.
The following lists notes on this command.
This command can be executed only by an account belonging to the administrators group.
For information on errors that occur, see Appendix C, "Detailed Error Messages in Setup and Unsetup of Web Server" in the "ETERNUS SF AdvancedCopy Manager Messages".
If Windows SharePoint Services have been installed in a Windows Server 2003 R2 environment, IIS settings and server management settings for SharePoint must be made in order to use the Web client. Refer to A.7, "Using AdvancedCopy Manager in Environments where Windows SharePoint Services have been Installed" in the "ETERNUS SF AdvancedCopy Manager Installation Guide" for more information on how to make these settings.
This chapter explains the command which AdvancedCopy Manager Exchange support software offers. Moreover, it is necessary to execute an Exchange Server cooperation command by the user belonging to the Administrators group and the Domain Admins group.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
swsrpdbinfo_ex2k3
swsrpdevdisp_ex2k3
swsrpvssbackup_exchange
The service of the backup server in communication must be operating .
swsrpvssrestore_exchange
The service of the backup server in communication must be operating .
swsrpshadowadm_exchange
The service of the backup server in communication must be operating (except for case of specifying -copy option).
swsrpstat_exchange
swsrpcancel_exchange
swsrpshadowadm
eternus_provider
eternus_copyset
The services of the storage management server, storage server and backup server must be operating when registering or deleting copy set information.
eternus_getolu
eternus_getins
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
swsrpdbinfo_ex2k3
Required
Transaction operation node
It executes it with the Exchange server.
swsrpdevdisp_ex2k3
Required
Transaction operation node
It executes it with the Exchange server.
swsrpvsssync_exchange
Required
Transaction operation node
It executes it with the Exchange server.
swsrpvssbackup_exchange
Required
Transaction operation node
It executes it with the Exchange server.
swsrpvssrestore_exchange
Required
Transaction operation node
It executes it with the Exchange server.
swsrpshadowadm_exchange
Required
Transaction operation node
It executes it with the Exchange server.
swsrpstat_exchange
Required
Transaction operation node
It executes it with the Exchange server.
swsrpshadowadm
Notrequired
It executes it with the backup server.
eternus_provider
Notrequired
Transaction operation node
It executes it with the Exchange server or backup server.
eternus_copyset
Notrequired
Transaction operation node
It executes it with the Exchange server or backup server.
eternus_getolu
Notrequired
It executes it with the backup server.
eternus_getins
Notrequired
It executes it with the backup server.
Exchange Server commands do not support the SnapOPC function.
This command registers or deletes information on a storage group. The command is used when Exchange Server backup operation begins or after the file configuration of a storage group is changed.
Executing the command registers or deletes information on the files that constitute a storage group and information on AdvancedCopy Manager device names. (The files that constitute a storage group include mailbox store and public folder store database files, transaction files, and checkpoint file.)
Specification method
[To register Exchange database information] program-directory\bin\swsrpdbinfo_ex2k3 [-evs Virtual-Server-Name]
[-sgname Storage-Group-Name]
[To delete Exchange database information] program-directory\bin\swsrpdbinfo_ex2k3 [-evs Virtual-Server-Name] -clean |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
Specifies the storage group name. If this option is omitted, information on all storage groups is registered. |
|
-clean |
Specifies that information on the storage group that has been deleted from Exchange Server be deleted. |
|
-evs |
Specifies the name of an Exchange virtual server (EVS) when MSCS operation is used. Need not be specified unless MSCS operation is used. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Register storage group FirstStorageGroup.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpdbinfo_ex2k3 -sgname FirstStorageGroup swsrpdbinfo_exchange successfully completed C:\> |
Delete unnecessary storage group information.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpdbinfo_ex2k3 -clean swsrpdbinfo_exchange successfully completed C:\> |
The command cannot register database information if:
The specified storage group does not exist.
This command cannot be executed while one of the following commands is in execution:
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Synchronous processing start command (swsrpstartsync)
Replication creation command (swsrpmake)
Replication cancellation command (swsrpcancel)
Synchronization mode change command (swsrpchsync)
Syncronization reverse command (swsrprevsync)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
Exchange VSS backup execution command (swsrpvssbackup_exchange)
Exchange VSS restore execution command (swsrpvssretore_exchange)
Exchange VSS shadow copy management command (swsrpshadowadm_exchange)
Shadow copy management command (swsrpshadowadm)
This command displays the information registered with the Exchange2003 database information registration command (swsrpdbinfo_ex2k3). The command displays information on the files that constitute a storage group and information on AdvancedCopy Manager device names. (The files that constitute a storage group include mailbox store and public folder store database files, transaction files, and checkpoint file.)
Specification method
[To display information on a specific storage group] program-directory\bin\swsrpdevdisp_ex2k3 -sgname Storage-Group-Name [To display information on all storage groups used for Exchange] program-directory\bin\swsrpdevdisp_ex2k3 [-evs Virtual-Server-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
Specifies the storage group name. If this option is omitted, information on all storage groups is displayed. |
|
-evs |
Specifies the name of an Exchange virtual server (EVS) when MSCS operation is used. Need not be specified unless MSCS operation is used. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display device information on storage group FirstStorageGroup.
C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpdevdisp_ex2k3 -sgname FirstStorageGroup
Exchange Storage Group:FirstStorageGroup
MailBoxStore:Mail1
EDB:e:\Exchsrvr\mdbdata\priv1.edbAdvancedCopy Manager Device:g1d1p1
STM:e:\Exchsrvr\mdbdata\priv1.stmAdvancedCopy Manager Device:g1d1p1
PublicStore:Pub1
EDB:e:\Exchsrvr\pdbdata\priv1.edbAdvancedCopy Manager Device:g1d1p1
STM:e:\Exchsrvr\pdbdata\priv1.stmAdvancedCopy Manager Device:g1d1p1
MailBoxStore:Mail2
EDB:e:\Exchsrvr\mdbdata\priv2.edbAdvancedCopy Manager Device:g1d1p1
STM:e:\Exchsrvr\mdbdata\priv2.stmAdvancedCopy Manager Device:g1d1p1
PublicStore:Pub2
EDB:e:\Exchsrvr\pdbdata\priv2.edbAdvancedCopy Manager Device:g1d1p1
STM:e:\Exchsrvr\pdbdata\priv2.stmAdvancedCopy Manager Device:g1d1p1
TransactionLog=f:\Exchsrvr\log\E00.logAdvancedCopy Manager Device:g1d2p1
CheckPointFile=e:\Exchsrvr\chk\E00.chkAdvancedCopy Manager Device:g1d1p1 |
The command cannot display device information if:
Device information has not been registered with the Exchange2003 database information registration command (swsrpdbinfo_ex2k3).
Not all storage group information is registered with AdvancedCopy Manager when an attempt is made to display information on all storage groups.
This command cannot be executed while the following command is in execution:
Resource adjustment command(swsrprecoverres)
This command performs synchronous processing operations for storage groups
Starting or restarting synchronous processing
Stopping synchronous processing
This command starts or restarts synchronous processing for storage groups. It is used to start synchronous type backup operations and to reflect updated (differential) data from a replication established (suspended) state.
This command stops synchronous processing for storage groups Use this command when an error is detected with synchronous processing or when synchronous type backup operations are to be stopped.
Specification method
[When starting or restarting synchronous processing] program-directory\bin\swsrpvsssync_exchange start
[-evs Virtual-Server-Name]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name]
[When stopping synchronous processing] program-directory\bin\ swsrpvsssync_exchange cancel
[-evs Virtual-Server-Name]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
Specifies the storage group name. |
|
-evs |
Specifies the name of an Exchange virtual server (EVS) when MSCS operation is used. |
|
-copygrp |
Specifies the copy set group name. If this option is omitted, the default copy set group "BkupGroup" will be specified. |
End status
= 0 : Normal end
> 0 : Abnormal end
Execution example
Start synchronous processing for the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR".
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -copy -evs VSVR -sgname FirstStorageGroup -copygrp BK1 Type Group Original-Disk Replica-Disk Status Execute Trk Update EC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR ---- ---- ---- ---- EC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR ---- ---- ---- ---- C:\>C:\Win32app\AdvancedCopyManager\bin\swsrpvsssync_exchange start -evs VSVR -sgname FirstStorageGroup -copygrp BK1 swsrpvsssync_exchange successfully completed C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -copy -evs VSVR -sgname FirstStorageGroup -copygrp BK1 Type Group Original-Disk Replica-Disk Status Execute Trk Update EC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR sync 3% ---- ---- EC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR sync 1% ---- ---- C:\> |
Stop synchronous processing for the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR".
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -copy -evs VSVR -sgname FirstStorageGroup -copygrp BK1 Type Group Original-Disk Replica-Disk Status Execute Trk Update EC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR suspend ---- ---- ---- EC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR suspend ---- ---- ---- C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpvsssync_exchange cancel -evs VSVR -sgname FirstStorageGroup -copygrp BK1 swsrpvsssync_exchange successfully completed C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -copy -evs VSVR -sgname FirstStorageGroup -copygrp BK1 Type Group Original-Disk Replica-Disk Status Execute Trk Update EC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR ---- ---- ---- ---- EC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR ---- ---- ---- ---- C:\> |
Synchronous processing operation cannot be executed in the following cases:
When the database information for the specified storage group was not registered using the Exchange database information registration command (swsrpdbinfo_ex2k3).
When the database configuration for the specified storage group has been changed.
When copy set information cannot be obtained.
When there is a copy set in the specified storage group whose copy type is not EC.
When communications with the backup server fail (the start/restart function).
When an error occurs with ETERNUS provider processing.
When a backup LUN volume (partition) cannot be deleted (the start/restart function).
When there is a shadow copy on a backup LUN that cannot be deleted (the start/restart function).
When synchronous processing has not been executed on any of the copy sets in the storage group (the stop function).
This command cannot be executed while any of the following commands are running.
Exchange 2003 database information registration command (swsrpdbinfo_ex2k3)
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
If this command is executed when synchronous processing has been executed on all copy sets in the storage group, the following information message will be output and the command will terminate: "swsrp4203 Synchronous processing is already in progress. Storage Group Name = [STORAGE-GROUP-NAME]". (The end status will be normal termination.).
If an error occurs during synchronous processing operations on a storage group that is made up of multiple copy sets, processing for this command will be interrupted. To execute the synchronous processing operation again, correct the error and then run the command again.
It cooperates with VSS and on-line backup of an Storage group is performed.
This command performs the following processings.
By using VSS and AdvancedCopy, the backup data of an Storage group is created on a backup server.
For snapshot type backups, shadow copies are created by starting an OPC, or QuickOPC.
For synchronous type backups, shadow copies are created by suspending an EC or REC in an equivalency maintenance state.
A drive letter is assigned to the backup volume based on a drive letter map file. The backup volume can be accessed as a read-only volume.
ESEUTIL is performed against backup data to verify data integrity. When there is no problem in data integrity, Exchange deletes unnecessary log files.
The metadata documents, which are needed at the time of restoration, are saved in the following locations of the backup server
|
File |
Output place |
|---|---|
|
Writer metadata |
[If the copy set group name is "BkupGroup" (the default name)] <Environmental setting directory>\etc\repl\data\exchange\<Storage server name of Exchange server>\metadoc \<Storage group name>.wmd.xml [If the copy set group name is anything other than "BkupGroup" (the default name)] environment settings directory\etc\repl\data\exchange\<Storage server name of Exchange server>\metadoc\<Storage group name >.<Copy set group name>.wmd.xml |
|
Backup component |
[If the copy set group name is "BkupGroup" (the default name)] <Environmental setting directory>\etc\repl\data\exchange\<Storage server name of Exchange server>\metadoc \<Storage group name>.bcd.xml [If the copy set group name is anything other than "BkupGroup" (the default name)] environment settings directory\etc\repl\data\exchange\<Storage server name of Exchange server>\metadoc\<Storage group name >.<Copy set group name>.bcd.xml |
Specification method
program-directory\bin\swsrpvssbackup_exchange [-evs Virtual-Server-Name]
[-skipchk]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
An Storage group name is specified. |
|
-evs |
When MSCS employment is being performed, the name of an Exchange virtual server (EVS) is specified. |
|
-skipchk |
It specifies not performing data consistency verification by ESEUTIL. |
|
-copygrp |
Specifies the copy set group name. If this option is omitted, the copy set group name will be the default name "BkupGroup". |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", backup is performed.
C:\>set SWSTGNODE=nodeAGT C:\> C:\Win32App\AdvancedCopyManager\bin\swsrpvssbackup_exchange -evs VSVR -sgname FirstStorageGroup -copygrp BK1 swsrpvssbackup_exchange successfully completed C:\> |
Backup cannot be executed in the following cases:
When the database information on the specified Storage group is not registered by the Exchange database information registration command (swsrpdbinfo_ex2k3).
When the database composition of the specified Storage group is changed.
When acquisition of copy set information goes wrong.
When communication with a backup server goes wrong.
When the store is being dismounted.
When there are copy sets in the specified storage group whose copy types are OPC and EC.
When not all of the copy set synchronous processes for the storage group are in an equivalency maintenance state (for synchronous type backups).
When a certain error occurs in processing of an ETERNUS provider.
When volume (partition) deletion of Backup LUN is not completed.
When a shadow copy exists in Backup LUN and deletion of a shadow copy is not completed.
When abnormalities are detected by consistency verification of backup data.
When preservation of a writer metadata document and a backup component document goes wrong.
When assignment of the drive letter of backup volume goes wrong.
When - skipchk option is specified
When verification of data consistency is omitted using -skipchk option, it recommends strongly verifying data consistency manually after this command end. About the verification method of data consistency, it is the following "support technical know-how" (Microsoft Knowledge Base). Refer to."Exchange Server 2003 data backup and Volume Shadow Copy services" (see the clause of "How to check snapshot consistency")http://support.microsoft.com/default.aspx?scid=kb;en-us;822896
When the command is canceled
An Exchange writer may remain backup processing when this command is forced by the task manager, Ctrl-C, etc. to terminate. In such a case, when you reexecute this command, an error message like the following message will be output and backup cannot be performed.swsrp4648 An error occurred in VSS processing. Processing Phase=[BACKUP] Creation of Shadow Copy Set, Detected API=StartSnapshotSet, Error=0x80042316
In order to restore this state, it is necessary to initialize the Exchange writer by restarting "Microsoft Exchange Information Store" service. However, if this service is restarted, the client connecting to the Exchange Server may raise an unexpected termination or an unexpected connection shutdown. Therefore, we recommend you to restart this service after due consultation with an Exchange administrator.
This command cannot be executed during execution of the following commands.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
If an error occurs during the processing for a storage group that is made up of multiple copy sets, processing for this command will be interrupted. If a synchronous type backup was being performed, suspended synchronous processes must be restarted using the Exchange VSS synchronous processing command (swsrpvsssync_exchange start).
It cooperates with VSS and restoration of a Storage group is performed.
In case it cooperates with VSS, the writer metadata document and backup component document which are saved at the backup server are used. The following two restoration systems are chosen and restoration is performed.
By restoring all the files (*. edb, *.stm, *.log, *.chk) that constitute an Storage group from backup volume, an Storage group is restored to a backup time.
Only database files (*. edb, *.stm) are restored, log application is performed using the log file which exists on operating volume, and a database is restored to the newest time.
Specification method
program-directory\bin\swsrpvssrestore_exchange [-evs Virtual-Server-Name]
(-point|-roll)
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
An Storage group name is specified. |
|
-evs |
When MSCS employment is being performed, the name of an Exchange virtual server (EVS) is specified. |
|
-point |
A Point-in-Time system is restored. |
|
-roll |
A roll forward system is restored. |
|
-copygrp |
A copy set group name is specified. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", roll-forward restoration is performed.
C:\>set SWSTGNODE=nodeAGT C:\> C:\Win32App\AdvancedCopyManager\bin\swsrpvssrestore_exchange -evs VSVR -roll -sgname FirstStorageGroup -copygrp GRP1 swsrpvssrestore_exchange successfully completed C:\> |
When it corresponds to the following conditions, the unusual end of this command is carried out.
When the database information on the specified Storage group is not registered by the Exchange database information registration command (swsrpdbinfo_ex2k3).
When the database composition of the specified Storage group is changed.
When acquisition of copy set information goes wrong.
When a database volume and a backup volume are not registered as an original volume and a replica volume, respectively.
Volume information (box identifier, OLU, EXTENT start position, and EXTENT size) is changed after operation starts. In this case, operation cannot continue for the corresponding volume. Stop the replication operation for the corresponding volume, and then delete and set the replication volume information.
When restoration is being performed using EC or REC and the restoration synchronous process is not in the equivalency maintenance state.
When an Exchange server is not an operation server of the replication volumes.
When communication with a backup server goes wrong.
When the database is in inconsistent state.
When the store could not be dismounted.
When the store could not be mounted.
When the roll option is specified and the log files exist on the same volume as database files (*. edb, *.stm).
When a transaction log required [ when the roll option is specified ] in order to perform a roll forward does not exist in a log file.
When a backup (copy source) volume is not able to be locked.
When the contents of the copy source volume locking specification file are invalid.
When a database volume (original volume) could not be locked.
When the contents of the copy destination volume locking specification file are invalid.
When a writer metadata document and a backup component document do not exist on a backup server.
When backup data does not exist on backup volume.
This command cannot be executed during execution of the following commands.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
The shadow copy of an Storage group is managed.
A shadow copy state and an advanced copy execution state are acquired and displayed from VSS of a backup server, and an ETERNUS provider, respectively.
A shadow copy is deleted from VSS of a backup server.
The writer metadata document and backup component document of a backup server are deleted.
When the OPC physical copy is performed, an OPC physical copy is stopped by the ETERNUS provider. Synchronous processes and QuickOPCs do not stop even if shadow copies are deleted.
This function stops QuickOPC processing (both the physical copy and tracking processing).It can be used only when the copy type for the copy set group is QOPC.
QuickOPCs where the physical copy is in progress cannot be stopped if a shadow copy exists.To stop a QuickOPC where the physical copy is in progress, the shadow copy must be deleted first.QuickOPCs where tracking is in progress can be stopped regardless of whether any shadow copies exist.
Specification method
[When the state display of a shadow copy is performed]
program-directory\bin\swsrpshadowadm_exchange status
[-evs Virtual-Server-Name]
[-copy | -shadow]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name]
[When a shadow copy is deleted]
program-directory\bin\swsrpshadowadm_exchange delete
[-evs Virtual-Server-Name]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name]
[When a QuickOPC is stopped]
program-directory\bin\swsrpshadowadm_exchange stopqopc
[-evs Virtual-Server-Name]
-sgname Storage-Group-Name
[-copygrp Copyset-Group-Name] |
Description of options
|
Option |
Description |
|---|---|
|
-sgname |
An Storage group name is specified. |
|
-evs |
When MSCS employment is being performed, the name of an Exchange virtual server (EVS) is specified. |
|
-shadow |
Only the execution state of an advanced copy is displayed in the state display (status) of a shadow copy. |
|
-copy |
Only the state of a shadow copy is displayed in the state display (status) of a shadow copy. |
|
-copygrp |
A copy set group name is specified. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", the status of the shadow copies is displayed.
C:\>set SWSTGNODE=nodeAGT
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -sgname FirstStorageGroup -copygrp BK1
[Shadow Copy Status]
Original-Volume Replica-Volume Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2005/06/23 03:23 {XXXX} {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2005/06/23 03:23 {XXXX} {XXXX}
[AdvancedCopy Status]
Type Group Original-Disk Replica-Disk Status Execute Trk Update
QOPC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR snap 88% on ----
QOPC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR snap 83% on ----
C:\> |
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", the status of the shadow copies is displayed (when -shadow option is specified).
C:\>set SWSTGNODE=nodeAGT
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -shadow -sgname FirstStorageGroup -copygrp BK1
Original-Volume Replica-Volume Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2005/06/23 03:23 {XXXX} {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2005/06/23 03:23 {XXXX} {XXXX}
C:\> |
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", the status of the shadow copies is displayed (when -copy option is specified).
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -copy -sgname FirstStorageGroup -copygrp BK1 Type Group Original-Disk Replica-Disk Status Execute Trk Update EC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR sync 88% ---- ---- C:\> |
The contents of a display are as follows.
|
Title |
Description |
|---|---|
|
Original-Volume |
A reproducing agency volume name is displayed. In a parenthesis, it is the volume name ("\\?\Volume{GUID}\") of Windows. The volume name of a meaning expressed with the form to say is displayed. |
|
Replica-Volume |
A duplicate place volume name is displayed. In a parenthesis, it is the volume name ("\\?\Volume{GUID}\") of Windows. the volume name of a meaning expressed with the form to say is displayed (the case where a shadow copy does not exist -- "- -- " -- it displays). |
|
Latest-Creation-Time |
The creation time of the newest shadow copy is displayed. |
|
Snapshot-ID |
The shadow copy ID of the newest shadow copy (GUID) is displayed. |
|
SnapshotSet-ID |
The shadow copy set ID of the newest shadow copy (GUID) is displayed. |
|
Type |
A copy type is displayed. OPC:OPC |
|
Group |
A copy set group name is displayed. |
|
Original-Disk |
A reproducing agency disk (LUN) name is displayed. |
|
Replica-Disk |
A duplicate place disk (LUN) name is displayed. |
|
Status |
The execution state of the advanced copy from a reproducing agency disk to a duplicate place disk is displayed. |
|
Execute |
The rate of copy advance is expressed as percent. If copy is being performed, "----" is displayed. |
|
Trk |
Displays whether tracking processing is in progress. on : Tracking processing is in progress. |
|
Update |
When the Status column is "----" and the Trk column is "on" (that is, tracking is in progress and the physical copy is not executed), displays the amount of data updated after the previous replica creation as a percentage. Displays "----" during physical copying or when tracking is not in progress. |
For the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR", the shadow copies are deleted.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange delete -evs VSVR -sgname FirstStorageGroup -copygrp BK1 swsrpshadowadm_exchange successfully completed C:\> |
Stop the QuickOPC for the storage group "FirstStorageGroup" on the MSCS operation Exchange server "VSVR".
C:\>set SWSTGNODE=nodeAGT
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -sgname FirstStorageGroup -copygrp BK1
[Shadow Copy Status]
Original-Volume Replica-Volume Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) ---- ---- ----
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) ---- ---- ----
[AdvancedCopy Status]
Type Group Original-Disk Replica-Disk Status Execute Trk Update
QOPC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR snap 88% on ----
QOPC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR ---- ---- on 15%
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange stopqopc -evs VSVR -sgname FirstStorageGroup -copygrp BK1
swsrpshadowadm_exchange successfully completed
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -sgname FirstStorageGroup -copygrp BK1
[Shadow Copy Status]
Original-Volume Replica-Volume Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) ---- ---- ----
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) ---- ---- ----
[AdvancedCopy Status]
Type Group Original-Disk Replica-Disk Status Execute Trk Update
QOPC BK1 g1d1@EXCHG-SVR g1d11@BKUP-SVR ---- ---- ---- ----
QOPC BK1 g1d2@EXCHG-SVR g1d12@BKUP-SVR ---- ---- ---- ----
C:\> |
When it corresponds to the following conditions, the unusual end of this command is carried out.
When communication with a backup server goes wrong.
When acquisition of copy set information goes wrong.
When state acquisition of a shadow copy goes wrong (state display function).
When state acquisition of an advanced copy goes wrong (state display function).
When deletion of a shadow copy goes wrong (deletion function).
When deletion of a writer metadata document and a backup component document goes wrong (deletion function).
This command cannot be executed during execution of the following commands.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
This command displays the operation status of the specified storage group.
Specification method
program-directory\bin\swsrpstat_exchange [-Xdevmap Device-Map-File ] -sgname Storage-Group-Name |
Description of options
|
Option |
Description |
|
|---|---|---|
|
-sgname |
Specifies the storage group name. |
|
|
-Xdevmap |
Specifies the name of the device map file that defines the combinations of storage group volumes and target backup volumes. Specify the absolute path of the device map file. If this option is omitted, the operation status of all replication volumes in the specified storage group is displayed. |
|
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Display the operation status of storage group FirstStorageGroup. Assume that the device map file that defines the associations between transaction volumes (storage group volumes) and backup volumes is K:\STG\DEV.map.
C:\> C:\Win32App\AdvancedCopyManager\bin\swsrpstat_exchange -Xdevmap K:\STG\DEV.map -sgname FirstStorgeGroup Server Original-Volume Replica-Volume Direction Status Execute EXCHG-SVR g1d1p1@EXCHG-SVR g1d11p1@BKUP-SVR regular equivalent 100% EXCHG-SVR g1d2p1@EXCHG-SVR g1d12p1@BKUP-SVR regular sync 83% C:\> |
See the description about the Operation status display command (swsrpstat) for display information and notes.
Take corrective action as necessary when the execution status (displayed in the "Status" column) is one of the following:
Status
Corrective action
failed
A hardware error occurred. Remove the hardware error cause and use the replication cancellation command to stop operation.
halt
A hardware error occurred during replication between cabinets. Remove the hardware error cause and use the replication cancellation command to stop operation.
?????
Copy information could not be obtained. If the same symptom results even after reexecution, a hardware error occurred. Remove the hardware error cause and reexecute the command.
The command cannot display the operation status if:
The specified original or replica volume is not defined as a replication volume.
This command cannot be executed while the following command is in execution:
Resource adjustment command (swsrprecoverres)
A shadow copy is managed.
This command is used on a backup server. This command is used only within the case where he wants to delete a shadow copy or to check a shadow copy status from a backup server by the reason of the Exchange server having stopped. It is not necessary to use this command in everyday backup employment.
The shadow copy state created by the ETERNUS provider is acquired and displayed from VSS of a backup server.
The shadow copy created by the ETERNUS provider is deleted from VSS of a backup server.
Deletion of a shadow copy deletes all volumes (partition) from a backup disk.
When the OPC physical copy is performed, an OPC physical copy is stopped by the ETERNUS provider. Synchronous processes and QuickOPCs do not stop even if shadow copies are deleted.
Specification method
[When the state display of a shadow copy is performed] program-directory\bin\swsrpshadowadm status [When a shadow copy is deleted] program-directory\bin\swsrpshadowadm delete (-id Snapshot-ID | -all) |
Description of options
|
Option |
Description |
|---|---|
|
-id |
A shadow copy with the specified snapshot ID is deleted. |
|
-all |
All the shadow copies created by the ETERNUS provider are deleted. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The status of the shadow copies is displayed.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm status
Original-Volume Original-Machine Replica-Volume Latest-Creation-Time Snapshot-ID SnapshotSet-ID
\\?\Volume{XXXX}\ EXSVR-SV \\?\Volume{XXXX}\ 2005/06/23 03:23 {XXXX} {XXXX}
\\?\Volume{XXXX}\ EXSVR-SV \\?\Volume{XXXX}\ 2005/06/23 03:23 {XXXX} {XXXX}
C:\> |
The contents of a display are as follows.
|
Title |
Description |
|---|---|
|
Original-Volume |
The volume name of Windows of a reproducing agency ("\\?\Volume{GUID}\") The volume name of a meaning expressed with the form to say is displayed. |
|
Original-Machine |
The machine name (computer name) in which reproducing agency volume exists is displayed. |
|
Replica-Volume |
The volume name of Windows of a duplicate place ("\\?\Volume{GUID}\") The volume name of a meaning expressed with the form to say is displayed. |
|
Latest-Creation-Time |
The creation time of the newest shadow copy is displayed. |
|
Snapshot-ID |
The shadow copy ID of the newest shadow copy (GUID) is displayed. |
|
SnapshotSet-ID |
The shadow copy set ID of the newest shadow copy (GUID) is displayed. |
Snapshot ID: A shadow copy with {5928749d-60ea-11d7-ab2d-806d6172696f} is deleted.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm delete -id {5928749d-60ea-11d7-ab2d-806d6172696f}
swsrpshadowadm successfully completed
C:\> |
When it corresponds to the following conditions, the unusual end of this command is carried out.
When state acquisition of a shadow copy goes wrong (state display function).
When deletion of a shadow copy goes wrong (deletion function).
When the shadow copy for processing does not exist (deletion function).
This command cannot be executed during execution of the following commands.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
Exchange2003 database information registraton command (swsrpdbinfo_ex2k3)
An ETERNUS provider is registered into VSS.
An ETERNUS provider is deleted from VSS.
Specification method
program-directory\bin\eternus_provider install | uninstall |
Description of options
|
Option |
Description |
|---|---|
|
install |
Registration |
|
uninstall |
Deletion |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Registration
C:\>C:\Win32App\AdvancedCopyManager\bin\eternus_provider install eternus_provider install successfully completed. C:\> |
Deletion
C:\>C:\Win32App\AdvancedCopyManager\bin\eternus_provider uninstall eternus_provider uninstall successfully completed. C:\> |
If the "MS DTC service" is not running, this command will terminate with an error.Before executing the command, always check whether the "MS DTC service" is running.For cluster operations, resources that start the "MS DTC service" must be registered with the cluster system. Use the cluster administrator to check whether any "Distributed Transaction Coordinator" resources have been registered. If no such resources have been registered, create a "Distributed Transaction Coordinator" resource for the cluster service that includes the quorum disk, and vary this resource online.
The copy set information on an operating disk and a backup disk is registered.
The copy set information on an operating disk and a backup disk is deleted.
The copy set information on an operating disk and a backup disk is outputted.
Specification method
[Registration] program-directory\bin\eternus_copyset -set -o dev-name@server-name -t dev-name@serever-name -c OPC | EC | QOPC [-g group-name] [Deletion] program-directory\bin\eternus_copyset -del -o dev-name@server-name [-t dev-name@serever-name] [Reference] program-directory\bin\eternus_copyset -disp serever-name |
Description of options
|
Option |
Description |
|---|---|
|
-set |
Registration |
|
-del |
Deletion |
|
-disp |
Reference |
|
-o |
Copied material information (an operating disk, operating server) |
|
-t |
Copy place information (a backup disk, backup server) Required for multiple generation operations in the case of deletions (the -del option). |
|
-c |
Copy type OPC:OPC EC:EC QOPC:QuickOPC |
|
-g |
Group name Required for multiple generation operations. If this option is not specified (single generation operations), the group name will be the default group name "BkupGroup". |
Description of operands
|
Operand |
Description |
|---|---|
|
dev-name |
Device name |
|
server-name |
Server name |
|
group-name |
Specifies a group name. This group name must be unique within the copy source information (transaction disk and transaction server). Specify the group name using up to 10 alphanumeric characters (including underscore characters "_"). The group name is not case sensitive. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Registration
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_copyset -set -o g1d87@server1 -t g1d27@bkupsrv1-c QOPC -g Daily_1 eternus_copyset set successfully completed. C:\> |
Deletion
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_copyset -del -o g1d87@server1 -t g1d27@bkupsrv1 eternus_copyset delete successfully completed. C:\> |
Reference
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_copyset -disp server1 Type Group-Name Original-Disk Target-Disk QOPC Daily_1 g1d87@server1 g1d27@bkupsrv1 QOPC Daily_2 g1d87@server1 g1d28@bkupsrv1 QOPC Daily_1 g1d88@server1 g1d29@bkupsrv1 QOPC Daily_2 g1d88@server1 g1d30@bkupsrv1 C:\> |
The contents of a display are as follows.
|
Title |
Description |
|---|---|
|
Type |
Copy type |
|
Group-Name |
Group name |
|
Original-Disk |
Transaction disk |
|
Target-Disk |
Backup disk |
When you perform registration processing and deletion processing, ACM of a Storage management server, an operating server, and a backup server needs to be operating.
Copy set information cannot be deleted if a session for the copy set is being deleted when the deletion processing is executed.
The copy type is specified separately for each unit of copy source information.
If the storage group consists of multiple LUNs, group name consistency is implemented by the operation.
This command cannot be executed if the Exchange VSS backup execution command is executing.
The physical disk number and OLU number of a copy place disk are displayed.
Specification method
program-directory\bin\eternus_getolu |
Description of options
Nothing.
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The physical disk number and OLU number of a copy place disk are displayed. 0 and an OLU number are set to 20 by the physical disk number of g1d20@H200-S2 (copy place disk).
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_getolu PhysicalDrive = 3, OLU = 20, Target=g1d20@H200-S2 PhysicalDrive = 4, OLU = 21, Target=g1d21@H200-S2 PhysicalDrive = 5, OLU = 22, Target=g1d22@H200-S2 PhysicalDrive = 6, OLU = 23, Target=g1d23@H200-S2 C:\> |
The contents of a display are as follows.
|
Title |
Description |
|---|---|
|
PhysicalDrive |
Physical disk number |
|
OLU |
OLU number |
|
Target |
Copy place information (a backup disk, backup server) |
It can perform only by the backup server.
The information on the disk which has not been registered as copy set information is not outputted.
This command cannot be executed if the Exchange VSS backup execution command is executing.
The device instance ID is displayed.
Specification method
program-directory\bin\eternus_getins |
Description of options
Nothing.
End status
= 0: Normal end
> 0: Abnormal end
Execution example
The device instance ID is displayed.
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_getins SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&100 : FUJITSU GR740 SCSI Disk Device SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&101 : FUJITSU GR740 SCSI Disk Device SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&102 : FUJITSU GR740 SCSI Disk Device SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&103 : FUJITSU GR740 SCSI Disk Device SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&104 : FUJITSU GR740 SCSI Disk Device SCSI\DISK&VEN_FUJITSU&PROD_GR740&REV_0388\4&737E0A5&0&105 : FUJITSU GR740 SCSI Disk Device C:\> |
Only the information by which the character string of "FUJITSU" is contained in the device instance ID is outputted.
The information on the device which has not been registered as copy set information is also outputted.
A physical disk number etc. is not outputted.
This command cannot be executed if the Exchange VSS backup execution command is executing.
Display the status of an OPC/EC/QuickOPC
Specification method
program-directory\bin\ eternus_query server-name |
Description of options
None
Description of operands
|
Operand |
Description |
|---|---|
|
server-name |
Specifies the server name for the Storage server registered with AdvancedCopy Manager. |
End status
= 0 : Normal end
> 0 : Abnormal end
Execution example
Display the status of an OPC
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_query server1 Type Group-Name Original-Disk Target-Disk Status Execute Trk Update OPC Daily_1 g1d87@server1 g1d27@bkupsrv1 snap 95% off ---- OPC Daily_1 g1d88@server1 g1d28@bkupsrv1 ---- ---- --- ---- C:\> |
Display the status of an EC
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_query server1 Type Group-Name Original-Disk Target-Disk Status Execute Trk Update REC Daily_1 g1d87@server1 g1d27@bkupsrv1 sync 95% --- ---- REC Daily_1 g1d88@server1 g1d28@bkupsrv1 equivalent 100% --- ---- C:\> |
Display the status of a QuickOPC
C:\>C:\Win32app\AdvancedCopyManager\bin\eternus_query server1 Type Group-Name Original-Disk Target-Disk Status Execute Trk Update QOPC Daily_1 g1d87@server1 g1d27@bkupsrv1 sync 95% on ---- QOPC Daily_2 g1d87@server1 g1d31@bkupsrv1 ---- ---- on 12% QOPC Daily_1 g1d88@server1 g1d28@bkupsrv1 sync 90% on ---- QOPC Daily_2 g1d88@server1 g1d32@bkupsrv1 ---- ---- on 5% C:\> |
The following information will be displayed
|
Title |
Description |
|---|---|
|
Type |
A copy type |
|
Group-Name |
A group name |
|
Original-Disk |
Copy source information (transaction disk and transaction server). |
|
Target-Disk |
Copy destination information (backup disk and backup server). |
|
Status |
The execution status of advanced copies from the copy source disk to the copy destination disk ---- : Copying is not being performed. sync : Total copy or incremental copy is being performed. equivalent : Equivalency maintenance state. suspend : Suspend status. failed : Error suspend status. halt(sync):Hard-suspended status for the REC (occurs during REC total copies or differential copies). halt(equivalent):Hard-suspended status for the REC (occurs during REC equivalency maintenance state). halt:Hard-suspended status. snap : Snapshot processing is being performed. ????? : Copy situation cannot be acquired. |
|
Execute |
Displays the copy progress status for OPCs, ECs, or QuickOPCs Displays "----"if there is no copy (sync or snap) in progress Displays "100%" for equivalency maintenance state (equivalent). |
|
Trk |
Displays whether tracking processing is in progress on:Tracking processing is in progress off:Tracking processing is not in progress ---:Snapshot processing is not performed |
|
Update |
When the Status column is "----" and the Trk column is "on" (that is, tracking is in progress and the physical copy is not executed), displays the amount of data updated after the previous replica creation as a percentage. Displays "----" during physical copying or when tracking is not in progress |
This command can display the status of devices that have been registered in the provider management file.
It can be executed on both transaction servers and backup servers
This command cannot be executed if the Exchange VSS backup execution command is executing.
This command stops OPCs, ECs, and QuickOPCs, or suspends ECs.
Specification method
program-directory\bin\eternus_stopcopy -o dev-name@server-name -t dev-name@server-name stop|suspend [-f] |
Description of options
|
Option |
Description |
|---|---|
|
-o |
Specifies the copy source information (transaction disk and transaction server) |
|
-t |
Specifies the copy destination information (transaction disk and transaction server). |
|
stop |
Stops OPCs, ECs and QuickOPCs. |
|
suspend |
Suspends ECs. |
|
-f |
Specifies that the copy be forcibly stopped or suspended. |
Description of operands
|
Operand |
Description |
|---|---|
|
dev-name |
Specifies the gXdY for the device name managed by AdvancedCopy Manager. |
|
server-name |
Specifies the server name for the Storage server registered with AdvancedCopy Manager. |
End status
= 0 : Normal end
> 0 : Abnormal end
Execution example
C:\Win32app\AdvancedCopyManager\bin\eternus_stopcopy -o g1d87@server1 -t g1d27@bkupsrv1 stop eternus_stopcopy successfully completed. C:\> |
Only devices that have been registered with the provider management file can be stopped or suspended using this command.
This command can be executed on both transaction servers and backup servers.
Use this command when faults occur.
This command cannot be executed if the Exchange VSS backup execution command is executing.
This chapter explains the commands by which the backup and restore of SQL Server databases are performed. It is necessary to execute a SQL Server cooperation command by the user belonging to the Administrators group.
The commands used by the backup management function and the replication management function are different. Refer to 11.6.1 when you use the backup management function. Refer to 11.6.2 when you use the replication management function.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
swstbackup_sqlsvr
In EC operation, the daemons and services of the storage server must be operating.
swstrestore_sqlsvr
swsrpbackup_sql
In intra-server replication and EC operation, the daemons and services of the storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating (except when the -m option or -t option is specified).swsrprestore_sql
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
swstbackup_sqlsvr
Required
Transaction operation node
swstrestore_sqlsvr
Required
Transaction operation node
swsrpbackup_sql
Required
Transaction operation node
swsrprestore_sql
Required
Transaction operation node
SQL Server commands do not support the SnapOPC function.
Swstbackup_sqlsvr and swstrestore_sqlsvr are used in the backup operation of SQL Server by the backup management function.
This command backs up SQL Server 2000 databases. This command, in cooperation with SQL Server 2000, performs copy of data of the target database volumes on to backup volumes by executing the backup execution command (swstbackup).
When the Backup synchronous processing start command (swststartsync) is executed in advance of the backup synchronous processing and the Suspend/Resume function is used for synchronous high-speed backup, execute the backup command with -suspend specified and suspend the backup synchronous processing.
The database backup history information will be stored in msdb of SQL Server 2000. The database volume backup history information will be stored in the management files of AdvancedCopy Manager.
Specification method
program-directory\bin\swstbackup_sqlsvr [-Xserver Server-Name]
[-Xinstance Instance-Name]
[-Xdevmap Device-Map-File]
[-suspend|-T]
DB-Name-1 DB-Name-2,,,DB-Name-i |
Description of options
|
Option |
Description |
|---|---|
|
-Xserver |
Specifies the virtual server name of connected SQL Server in case of operation by MSCS. In case of operation without MSCS, this option need not be specified. |
|
-Xinstance |
Specifies a connection instance. Specify an instance name in the operand. If this option is not specified, connection will be made to the default instance. |
|
-Xdevmap |
Specifies to perform the backup to the specified backup volume. Specify a device map file name that describes combinations of database volumes and destination backup volumes. If this option is not specified, the target backup volume will be automatically selected. Specify a device map file name using an absolute pathname. |
|
-suspend |
This results in synchronous high-speed backup using the Suspend/Resume function. |
|
-T |
Specifies that the differential snapshot high-speed backup be executed. This option cannot be specified during synchronous processing. This option is valid only for copying within a cabinet when the disk array supports the QuickOPC function. For the snapshot high-speed backup without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be always specified to perform a backup operation using differential snapshots. |
Description of operand
|
Operand |
Description |
|---|---|
|
DB-Name,,, (i=1,2,,,,64) |
Specifies database names. Delimit by the half-size blank or the tab character and specify the database names when you specify two or more databases. 65 data base names or more cannot be specified. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Backup the databases DB01, DB02, and DB03 of virtual server VSERVER. (Suppose that the logical node name of AdvancedCopy Manager is nodeAGT.)
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32App\AdvancedCopyManager\bin\swstbackup_sqlsvr -Xserver VSERVER DB01 DB02 DB03 DB01 DB02 DB03 swstbackup_sqlsvr completed C:\> |
Backup the databases (DB01, DB02 and DB03) specifying the destination backup volumes by the device map file (G:\STGADM\devmap.txt).
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32App\AdvancedCopyManager\bin\swstbackup_sqlsvr -Xserver VSERVER -Xdevmap G:\STGADM\DEV.map DB01 DB02 DB03 DB01 DB02 DB03 swstbackup_sqlsvr completed C:\> |
This command uses the backup execution command (swstbackup) to back up database volumes where database files are located. The backup execution command locks database volumes during preprocessing, executes the backup process, and unlocks database volumes during postprocessing. Transaction volumes where SQL Server database files are located cannot be locked because SQL Server uses these transaction volumes. Therefore, create a transaction volume locking specification file for backups, and set it up so that the transaction volumes where SQL Server database files are located are not locked and the respective file system buffer is only flushed. For an explanation on how to set this up, see "Creating a transaction volume locking specification file for backups."
You cannot perform backup in the following cases:
A specified database does not exist. (This case includes the case where neither the virtual server nor the instance exists.)
In the case of specifying two or more databases, all of the specified databases are not databases of the same instance. (In the case where Xinstance option is not used, the processing is done to the default instance. In the case where Xinstance option is used, the processing is done to the specified named instance.)
A volume where the specified database is placed is not registered as a transaction volume.
Backup policy is not set for a database volume to be backed up.
Backup executed one generation earlier was unsuccessful.
Restore is being performed using backup history information that will cause a generation overflow.
No unused backup volume to be used as the copy destination could be acquired.
A drive letter has been assigned to a backup volume to be used as the copy destination.
The synchronous processing between the database volumes and the backup volumes is not in equivalency holding state.
After operation is begun, any of physical information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a volume has been changed.
If a database volume is an SDX object (SynfinityDISK), the state of the SDX object is not in the following states:
The mirror volume is ACTIVE or STOP.
The mirror slices are ACTIVE or STOP.
The state of SDX Disk is ENABLE.
65 databases or more are specified.
When a backup volume could not be locked
When the backup volume locking specification file for backups is invalid
You cannot specify a destination backup volume and perform backup if:
A backup volume specified in a device map file cannot be used as the destination backup volume for a corresponding database volume. In other words, not all the following conditions are met.
The specified backup volume is unused.
The database volume and the backup volume have the same partition size.
The description on a target database volume of the device map file has an error.
If this command is executed during execution of snapshot processing, stop the copy processing in progress and start the snapshot processing again.
This command provides the function to back up two or more databases at the same time by specifying the operand. When, like two or more databases exist on one partition, physical files of plural databases exist together on volumes, perform the backup of all the databases which exist on the volumes by using this function.
This command makes all the databases specified in operand to be frozen by SQL Server 2000 until backup processing is completed. Thus, if the volumes where database files exist are independent in each database, back up each database two or more times to shorten the frozen time as much as possible.
Now, the advanced copy which makes a SDX object (SynfinityDISK) backup volume is not supported. Therefore, only the advanced copy from a database volume which is an SDX object to a backup volume which is a non-SDX object can be used.
Use the COPY command, in case you copy data to a SDX object.
Because processing of securing data consistency for database volumes when the backup is performed is done by SQL Server 2000, the preprocessing and postprocessing (volume lock and unlock) like a usual file system volume are not executed.
If an error occurs while SQL Server backup execution command (swsrpbackup_sql) is processing the database of two or more volumes composition with this command, processing is interrupted. When you perform synchronous type backup, restart stopped synchronous processing by using the backup synchronous processing start command (swststartsync).
If an error occurs while SQL Server backup execution command (swstbackup_sqlsvr) is processing the database of two or more volumes composition with the backup execution command (swstbackup), the backup history information on AdvancedCopy Manager may become inconsistent. In order to cancel such an inconsistent state, delete unnecessary history information using a history information deletion command (swsthistdel).
At this time, if existing backup history information satisfies the condition of number of saved generations specified by the backup policy setting command, then information on the oldest generation is automatically deleted from the backup history information during the backup process, and the backup volume is cleared. However, if -suspend is specified for the backup history information, then the backup volume with the Suspend state is not cleared and the backup volume remains in use.
The transaction volume on which the backup command is executed, one other transaction volume, and the suspended backup volume cannot be specified as backup destinations in the device map file.
Before replication is performed in snapshot-type replication, this command option prevents other processes from accessing the replication destination volume to protect the process that is accessing the volume. The command accomplishes this by locking or unmounting the replication destination volume. In cases where the replication destination volume cannot be locked or unmounted, such as described below, the command terminates with an error:
The mount point has a directory for mounting another volume.
The volume has a file that is being used. If the replication destination volume is being used by a server that is not the server where the command was entered, prevent the replication destination volume from being accessed by canceling share settings or performing unmounting for the replication operation, using administrator's authority.
This command can be executed only while none of the following commands are running.
Storage server configuration information setting command (swstsvrset)
Device information setting command (swstdevinfoset)
Resource match command(swstsrsemtch)
Resource backup command(swstresback)
Resource restore command(swstresrst)
This command restores an SQL Server 2000 database. Enter this command after restoring database files using the restore execution command (swstrestore).This command recreates a database from restored database files. To perform recovery, after this command is executed, apply logs using Enterprise Manager or Transact-SQL.
Specification method
program-directory\bin\swstrestore_sqlsvr [-Xserver Server-Name]
[-Xinstance Instance-Name]
[-Xnolog]
-Xmeta Meta-File-Name
DB-Name |
Description of options
|
Option |
Description |
|---|---|
|
-Xserver |
Specifies the virtual server name of connected SQL Server in case of operation by MSCS. In case of operation without MSCS, this option need not be specified. |
|
-Xinstance |
Specifies a connection instance. Specify an instance name in the operand. If this option is not specified, connection will be made to the default instance. |
|
-Xnolog |
Specifies to restore a DB to a backup point, without applying logs. If this option is not specified, the DB will be restored to a backup point but cannot be used until logs are applied to it. Apply logs using Enterprise Manager or Transact-SQL. |
|
-Xmeta |
Specifies a meta data file name, using an absolute pathname. A meta data file will be stored as "db-name.swst-dmp" in the same folder as the primary data file. To confirm file identification numbers of database files, use the Transact-SQL "USE DB-Name EXEC SP_HELPFILE". |
Description of operand
|
Operand |
Description |
|---|---|
|
DB-Name |
Specifies a database name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Restore a database (DB01) using its backup data. The file restore using swstrestore has been completed and a meta data file exists at D:\SQLSVR\DB01.swst-dmp.
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32\AdvancedCopyManager\bin\swstrestore_sqlsvr -Xserver VSERVER -Xmeta D:\SQLSVR\DB01.swst-dmp DB01 DB01 swstrestore_sqlsvr completed C:\> |
You cannot specify a target backup volume and perform backup if:
Neither the virtual server nor the instance exists
By choosing to apply logs or not, you can select one of the following two restore methods:
Restore to a backup point (only restoring backup data)
Restore to the latest point or a specific point (restoring backup data and then applying logs)
Swsrpbackup_sql and swsrprestore_sql are used in the backup operation of SQL Server by the replication management function.
This command backs up SQL Server 2000 databases. This command, in cooperation with SQL Server 2000, performs copy of data of the target database volumes on to backup volumes by executing the replication creation command (swsrpmake). The database backup history information will be stored in msdb of SQL Server 2000.
Specification method
program-directory\bin\swsrpbackup_sql [-Xserver Server-Name]
[-Xinstance Instance-Name]
-Xdevmap Device-Map-File
[-m]
[-t]
[-T]
DB-Name-1 DB-Name-2,,,DB-Name-i |
Description of options
|
Option |
Description |
|---|---|
|
-Xserver |
Specifies the virtual server name of connected SQL Server in case of operation by MSCS. In case of operation without MSCS, this option need not be specified. |
|
-Xinstance |
Specifies a connection instance. Specify an instance name in the operand. If this option is not specified, connection will be made to the default instance. |
|
-Xdevmap |
Specify a device map file name that describes combinations of database volumes and destination backup volumes. Specify a device map file name using an absolute pathname. |
|
-m |
For backup server type operation (server-to-server replication), specifies that communication processing with the backup server (non-operation server) is not performed. When this option is specified, volume status check processing and preprocessing and postprocessing are not performed for the backup volume. This option is valid only during backup server type operation. |
|
-t |
Specifies that the preprocessing and postprocessing for a backup volume (copy destination volume) are not performed. Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command. |
|
-T |
Specifies that the differential snapshot high-speed backup be executed. This option cannot be specified during synchronous processing. This option is valid only for copying within a cabinet when the disk array supports the QuickOPC function. For the snapshot high-speed backup without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be always specified to perform a backup operation using differential snapshots. |
Description of operand
|
Operand |
Description |
|---|---|
|
DB-Name-1,,, (i=1,2,,,,64) |
Specifies database names. Delimit by the half-size blank or the tab character and specify the database names when you specify two or more databases. 65 data base names or more cannot be specified. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Backup the databases DB01, DB02, and DB03 of virtual server VSERVER. (Suppose that the logical node name of AdvancedCopy Manager is nodeAGT.)
C:\>set SWSTGNODE=nodeAGT C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpbackup_sql -Xserver VSERVER -Xdevmap G:\STGADM\devmap.txt DB01 DB02 DB03 DB01 DB02 DB03 swsrpbackup_sql completed C:\> |
You cannot perform backup in the following cases:
A specified database does not exist. (This case includes the case where neither the virtual server nor the instance exists.)
In the case of specifying two or more databases, all of the specified databases are not databases of the same instance. (In the case where Xinstance option is not used, the processing is done to the default instance. In the case where Xinstance option is used, the processing is done to the specified named instance.)
The specified device map file does not exist.
The description on a target database volume of the device map file has an error. (see 9.4.1.3)
The database volumes and backup volumes described in the device map file are not registered as original volumes and replica volumes, respectively.
The synchronous processing between the database volumes and the backup volumes described in the device map file is not in equivalency holding state.
After operation is begun, any of physical information (box identifier, OLU number, EXTENT start position, and EXTENT size) of a volume has been changed.
A database volume has plural mount points. (Only Windows 2000/Windows 2003)
If a database volume is an SDX object (SynfinityDISK), the state of the SDX object is not in the following states:
The mirror volume is ACTIVE or STOP.
The mirror slices are ACTIVE or STOP.
The state of SDX Disk is ENABLE.
In the case where all the backup volumes are volumes on the database server, m option is specified.
For backup server type operation (server-to-server replication), the storage server on which the command is executed is not the operation server of the corresponding replication volumes.
For backup server type operation (server-to-server replication), communication with a destination server fails.
65 databases or more are specified.
When the replication destination volume cannot be locked
When the contents of the replication destination volume lock operation specification file are invalid
When the backup to perform corresponds to either of the following conditions, perform drive letter release or unmount of copy destination volume before executing a command.
When a replication is performed between different OS's
When the sizes of replication source volume and replication destination volume differ
When performing neither drive letter release nor unmount in the above-mentioned case, post-processing of the copy place volume at the time of backup serves as an error.
If this command is executed during execution of snapshot processing, stop the copy processing in progress and start the snapshot processing again.
This command provides the function to back up two or more databases at the same time by specifying the operand. When, like two or more databases exist on one partition, physical files of plural databases exist together on volumes, perform the backup of all the databases which exist on the volumes by using this function.
This command makes all the databases specified in operand to be frozen by SQL Server 2000 until backup processing is completed. Thus, if the volumes where database files exist are independent in each database, back up each database two or more times to shorten the frozen time as much as possible.
Now, the advanced copy which makes a SDX object (SynfinityDISK) backup volume is not supported. Therefore, only the advanced copy from a database volume which is an SDX object to a backup volume which is a non-SDX object can be used.
Use the COPY command, in case you copy data to a SDX object.
Because processing of securing data consistency for database volumes when the backup is performed is done by SQL Server 2000, the preprocessing and postprocessing (volume lock and unlock) like a usual file system volume are not executed.
If an error occurs while SQL Server backup execution command (swsrpbackup_sql) is processing the database of two or more volumes composition with this command, processing is interrupted. When you perform synchronous type backup, restart stopped synchronous processing by using the synchronous processing start command (swsrpstartsync).
Before replication is performed in snapshot-type replication, this command option prevents other processes from accessing the replication destination volume to protect the process that is accessing the volume. The command accomplishes this by locking or unmounting the replication destination volume. In cases where the replication destination volume cannot be locked or unmounted, such as described below, the command terminates with an error:
The mount point has a directory for mounting another volume.
The volume has a file that is being used. If the replication destination volume is being used by a server that is not the server where the command was entered, prevent the replication destination volume from being accessed by canceling share settings or performing unmounting for the replication operation, using administrator's authority.
This command can be executed only while none of the following commands are running.
Replication volume information setting command (swsrpsetvol)
Replication volume information deletion command (swsrpdelvol)
Resource adjustment command (swsrprecoverres)
This command restores an SQL Server 2000 database. Enter this command after restoring database files using the replication creation command (swsrpmake). This command recreates a database from restored database files. To perform recovery, after this command is executed, apply logs using Enterprise Manager or Transact-SQL.
Specification method
program-directory\bin\swsrprestore_sql [-Xserver Server-Name]
[-Xinstance Instance-Name]
[-Xnolog]
-Xmeta Meta-File-Name
DB-Name |
Description of options
|
Option |
Description |
|---|---|
|
-Xserver |
Specifies the virtual server name of connected SQL Server in case of operation by MSCS. In case of operation without MSCS, this option need not be specified. |
|
-Xinstance |
Specifies a connection instance. Specify an instance name in the operand. If this option is not specified, connection will be made to the default instance. |
|
-Xnolog |
Specifies to restore a DB to a backup point, without applying logs. If this option is not specified, the DB will be restored to a backup point but cannot be used until logs are applied to it. Apply logs using Enterprise Manager or Transact-SQL. |
|
-Xmeta |
Specifies a meta data file name, using an absolute pathname. A meta data file will be stored as "db-name.swsrp-dmp" in the same folder as the primary data file. To confirm file identification numbers of database files, use the Transact-SQL "USE DB-Name EXEC SP_HELPFILE". |
Description of operand
|
Operand |
Description |
|---|---|
|
DB-Name |
Specifies a database name. |
End status
= 0: Normal end
> 0: Abnormal end
Execution example
Restore a database (DB01) using its backup data. The file restore using swstrestore has been completed and a meta data file exists at D:\SQLSVR\DB01.swsrp-dmp.
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrprestore_sql -Xserver VSERVER -Xmeta D:\SQLSVR\DB01.swsrp-dmp DB01 DB01 swsrprestore_sql completed C:\> |
You cannot specify a target backup volume and perform backup if:
Neither the virtual server nor the instance exists
By choosing to apply logs or not, you can select one of the following two restore methods:
Restore to a backup point (only restoring backup data)
Restore to the latest point or a specific point (restoring backup data and then applying logs)
This section explains the commands that execute SnapOPC.
Operating environment for command execution
The table below lists the requirements for the operating environment in which to execute the respective commands.
Command
Operating environment of AdvancedCopy Manager
swstestupdate
In cluster operation
In cluster operation, execute a command by taking the following steps:
If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. Specify the environment variable as follows:
Execute the command.
The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.
Command
Environment variable
Command execution node
Remarks
swstestupdate
Required
Transaction operation node
This command measures the physical capacity of SnapOPC disks using the pseudo SnapOPC session setting function.
Specification method
[When starting update volume measurements (setting up a pseudo SnapOPC session)] program-directory\bin\swstestupdate start Volume-Name [When looking up the update volume (displaying the status of the pseudo SnapOPC session)] program-directory\bin\swstestupdate status Volume-Name [When finishing update volume measurements (canceling the pseudo SnapOPC session)] program-directory\bin\swstestupdate stop Volume-Name |
Description of operands
|
Operand |
Description |
|
Volume-Name |
Specifies the volume name Specify a copy source volume that is used with SnapOPC operations |
End status
=0:Normal end
>0:Abnormal end
Execution example
Measure the update volume for g1d1p1
(Start taking measurements by starting a pseudo SnapOPC) C:\>C:\Win32App\AdvancedCopyManager\bin\swstestupdate start g1d1p1 g1d1p1 swstestupdate completed (First measurement) C:\>C:\Win32App\AdvancedCopyManager\bin\swstestupdate status g1d1p1 Volume-Name Update g1d1p1 644333 (Second measurement) C:\>C:\Win32App\AdvancedCopyManager\bin\swstestupdate status g1d1p1 Volume-Name Update g1d1p1 1045000 (Stop taking measurements by canceling the pseudo SnapOPC) C:\>C:\Win32App\AdvancedCopyManager\bin\swstestupdate stop g1d1p1 g1d1p1 swstestupdate completed C:\> |
The following information will be displayed.
|
Title |
Description |
|---|---|
|
Volume-Name |
The volume name. |
|
Update |
The amount of data that has been updated since measurements started in the number of blocks (1 block = 512 bytes). Displays "----" if there is no pseudo SnapOPC session. Displays "failed" if the pseudo SnapOPC session is error-suspended. |
Restoration will not be executed in the following cases.
When the specified volume does not exist.
When the disk array device does not support the SnapOPC function.
When the pseudo session has already been set up (when the "start" option is specified).
When the pseudo session does not exist (when the "stop" option is specified).
|
Contents
Index
|
