11.5.6 swsrpshadowadm_exchange (Exchange VSS shadow copy management command)

NAME

swsrpshadowadm_exchange - shadow copy of a Storage group

SYNOPSIS

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

This command allows management of the shadow copy of a Storage group.

State display function

A shadow copy state and an advanced copy execution state are acquired and displayed from the VSS of a backup server, and from ETERNUS disk storage systems provider, respectively.

The contents of a display are described below.

Table 11.27 Cluster operations (using MSCS)
Title	Description
Original-Volume	A source volume name is displayed. Placed in parentheses, it is the volume name ("\\?\Volume{GUID}\") of Windows. A meaningful volume name is displayed.
Replica-Volume	A duplicate place volume name is displayed. Placed in parentheses, it is the volume name ("\\?\Volume{GUID}\") of Windows. A meaningful volume name is displayed (in the case where a shadow copy does not exist, "---- " is displayed).
Latest-Creation-Time	The creation time of the newest shadow copy is displayed. If a shadow copy does not exist, "----" is displayed.
Snapshot-ID	The shadow copy ID of the newest shadow copy (GUID) is displayed. If a shadow copy does not exist, "----" is displayed.
SnapshotSet-ID	The shadow copy set ID of the newest shadow copy (GUID) is displayed. If a shadow copy does not exist, "----" is displayed.
Type	A copy type is displayed. OPC:OPC QOPC:QuickOPC EC:EC/REC
Group	A copy set group name is displayed.
Original-Disk	A source disk (LUN) name is displayed.
Replica-Disk	A duplicate destination disk (LUN) name is displayed.
Status	The state of the execution of the advanced copy from a source disk to a destination disk is displayed. ---- : Copy has not been carried out. sync : Total copy or incremental copy is being performed. equivalent : Equivalency maintenance state suspend : Suspend status. failed : It is in an error state. halt(sync) : Hard-suspended status for the REC (occurs during REC total copies or differential copies) halt(equivalent) : Hard-suspended status for the REC (this occurs during REC equivalency maintenance state) halt : Hard-suspended status snap : Snapshot processing is being performed. ????? : Acquisition of a copy failed for some reason.
Execute	The progress of the copying is expressed as percentage. Displays "----" when the Status column is anything other than "sync", "equivalent" or "snap". If copy is not being performed, "----" is displayed.
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 has not been 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.

Table 11.28 Cluster operation (using WSFC)
Title	Description
Original-Volume	The replication source volume name is displayed. A meaningful Windows volume name is displayed in parentheses in the format "\\?\Volume{GUID}\".
Replica-Volume	The replication destination volume name is displayed. Placed in parentheses, a meaningful Windows volume name is displayed in parentheses in the format "\\?\Volume{GUID}\". If a shadow copy does not exist, "--- " is displayed.
Latest-Creation-Time	The creation time of the latest shadow copy is displayed. If a shadow copy does not exist, "----" is displayed.
Snapshot-ID	The shadow copy ID (GUID) of the latest shadow copy is displayed. If a shadow copy does not exist, "----" is displayed.
SnapshotSet-ID	The shadow copy set ID (GUID) of the latest shadow copy is displayed. If a shadow copy does not exist, "----" is displayed.
Type	The copy type is displayed. OPC:OPC QOPC:QuickOPC
Original-Disk	The replication source disk (LUN) name is displayed.
Replica-Disk	The replication destination disk (LUN) name is displayed.
Status	The execution status of an advanced copy from a replication source disk to a replication destination disk is displayed. ---- : Copy has not been performed. sync : Total copy or incremental copy is in progress equivalent : Equivalency maintenance status suspend : Suspended status failed : Error suspended status halt(sync) : Hard-suspended status for the REC (occurs during REC total copy or incremental copy) halt(equivalent) : Hard-suspended status for the REC (occurs during REC equivalency maintenance state) snap : Snapshot processing is in progress ????? : Fetch of a copy failed for some reason
Execute	The copy progress rate is displayed as a percentage. If the Status column is anything other than "sync", "equivalent" or "snap", "----" is displayed.
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 in progress.
Update	When the Status column is "----" and the Trk column is "on" (that is, tracking is in progress and the physical copy has not been executed), the updated data size after the previous replication creation is displayed as a percentage. During physical copying or when tracking is not in progress, "----" is displayed.

Deletion function

A shadow copy is deleted from the 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 disk storage systems provider. Synchronous processes and QuickOPCs do not stop even if shadow copies are deleted.

When Windows Server 2008 is combined with Exchange Server 2007, the following processes occur:

The writer metadata document and backup component document of the backup server are deleted.
QuickOPC tracking processes are not stopped, even if shadow copies are deleted. If copying again to the same volume, first use the "QuickOPC Tracking Stop Function" to stop tracking processes before copying.
Copy processes are also not stopped if the OPC physical copy is performed during shadow copy deletion. Even if copying to the same volume, the OPC physical copy need not be stopped.

QuickOPC stop function

This function stops QuickOPC processing (both the physical copy and tracking processing). It can only be used when the copy type 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 first be deleted. QuickOPCs, where tracking is in progress, can be stopped regardless of whether any shadow copies exist.

OPTIONS

-sgname Storage-Group-Name: A Storage group name is specified.
The storage group name containing a space needs to attach double quotation marks (" ")

-evs Virtual-Server-Name: When cluster usage is being performed, the name of an Exchange virtual server (EVS) is specified.
When cluster usage is omitted, there is no necessity for specifying this option.

-shadow: Only the execution state of an advanced copy is displayed in the state display (i.e., the status) of a shadow copy.

-copy: Only the state of a shadow copy is displayed in the state display (ie, the status) of a shadow copy.

-copygrp Copyset-Group-Name: A copy set group name is specified.
If this option is omitted, the copy set group name will be the default name "BkupGroup".
This option is not supported in an environment where Windows Server 2008 is combined with Exchange Server 2007.

EXIT STATUS

=0:Completed successfully

>0:Terminated abnormally

EXAMPLES

Cluster operations (using MSCS)
For the storage group "FirstStorageGroup" on the cluster operation (using MSCS) 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 cluster operation (using MSCS) Exchange server "VSVR", the status of the shadow copies is displayed (i.e., 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 (i.e., 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:\>

For the storage group "FirstStorageGroup" on the cluster operation (using MSCS) 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 cluster operation (using MSCS) 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:\>

Cluster operation (using WSFC)
For the storage group "FirstStorageGroup" on the cluster operation (using WSFC) 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
[Shadow Copy Status]
Original-Volume                     Replica-Volume                      Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2008/08/15 07:23     {XXXX}      {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2008/08/15 07:23     {XXXX}      {XXXX}
[AdvancedCopy Status]
Type Original-Disk  Replica-Disk   Status Execute Trk  Update
QOPC g1d1@EXCHG-SVR g1d11@BKUP-SVR snap   60%     on   ----
QOPC g1d2@EXCHG-SVR g1d12@BKUP-SVR snap   55%     on   ----
C:\>

For the storage group "FirstStorageGroup" on the cluster operation (using WSFC) 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 
Original-Volume                     Replica-Volume                      Latest-Creation-Time Snapshot-ID SnapshotSet-ID       
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2008/08/15 07:23     {XXXX}      {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2005/08/15 07:23     {XXXX}      {XXXX}
C:\>

For the storage group "FirstStorageGroup" on the cluster operation (using WSFC) 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
Type Original-Disk  Replica-Disk   Status Execute  Trk   Update
QOPC g1d1@EXCHG-SVR g1d11@BKUP-SVR snap   60%      ----  ----
QOPC g1d2@EXCHG-SVR g1d12@BKUP-SVR snap   55%      ----  ----
C:\>

For the storage group "FirstStorageGroup" on the cluster operation (using WSFC) Exchange server "VSVR", the shadow copies are deleted.

C:\>set SWSTGNODE=nodeAGT
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange delete -evs VSVR -sgname FirstStorageGroup
swsrpshadowadm_exchange successfully completed
C:\>

For the storage group "FirstStorageGroup" on the cluster operation (using WSFC) Exchange server "VSVR", the QuickOPC is stopped.

C:\>set SWSTGNODE=nodeAGT
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -sgname FirstStorageGroup
[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  ----  g1d1@EXCHG-SVR g1d11@BKUP-SVR snap   88%     on   ----
QOPC  ----  g1d2@EXCHG-SVR g1d12@BKUP-SVR ----   ----    on   15%
C:\> C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange stopqopc -evs VSVR -sgname FirstStorageGroup
swsrpshadowadm_exchange successfully completed
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -evs VSVR -sgname FirstStorageGroup
[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 Original-Disk  Replica-Disk    Status  Execute  Trk   Update
QOPC g1d1@EXCHG-SVR g1d11@BKUP-SVR  ----    ----     ----  ----
QOPC g1d2@EXCHG-SVR g1d12@BKUP-SVR  ----    ----     ----  ----

NOTES

When any of the following conditions occur, this command terminates abnormally:
- When communication with a backup server has a fault.
- When acquisition of copy set information has a fault.
- When the acquisition of the state a shadow copy has a fault (this only affects the state display function).
- When the acquisition of the state an advanced copy has a fault (this only affects the state display function).
- When an error occurs with ETERNUS disk storage systems hardware provider processing (for the contents of the error, refer to "Messages" in the ETERNUS VSS Hardware Provider Software Manual). (Only applies when Windows Server 2008 is combined with Exchange Server 2007)
- When an error is caused by a hardware provider command (for the contents of the error, refer to "Messages" in the ETERNUS VSS Hardware Provider Software Manual). (Only applies when Windows Server 2008 is combined with Exchange Server 2007)
- When the deletion of a shadow copy has a fault (this only affects the deletion function).
- When the deletion of a writer metadata document and a backup component document has a fault (this only affects the deletion function).
This command cannot be executed during if any the following commands are being executed: