12.5.6 swsrpshadowadm_exchange (Exchange VSS shadow copy management command)

NAME

swsrpshadowadm_exchange - shadow copy management of a Storage group or a database

SYNOPSIS

For Exchange Server 2003, Exchange Server 2007:

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]

For Exchange Server 2010, Exchange Server 2013:

When the state display of a shadow copy is performed

<program-directory>\bin\swsrpshadowadm_exchange status [-copy | -shadow] -dbname Database-Name

When a shadow copy is deleted

<program-directory>\bin\swsrpshadowadm_exchange delete -dbname Database-Name

When a QuickOPC is stopped

<program-directory>\bin\swsrpshadowadm_exchange stopqopc -dbname Database-Name

DESCRIPTION

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

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 system provider, respectively.

The contents of a display are described below.

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 or 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.

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.
An OPC physical copy is stopped by the hardware provider when a dedicated provider for AdvancedCopy Manager is used in Windows Server 2003.
When ETERNUS VSS Hardware Provider is used in Windows Server 2008 or later, OPC physical copy is not stopped.
The synchronous processing and QuickOPC are not stopped in both of the above.

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 (" ")

-dbname Database-Name: A database name is specified.
The database 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.

-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 Windows Server 2008 or later.

Specific options of the state display (i.e., the status) of a shadow copy

-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.

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  ----    ----     ----  ----

For the database "Mailbox1", the status of the shadow copies is displayed:

C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -dbname Mailbox1
[Shadow Copy Status]
Original-Volume                     Replica-Volume                      Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2010/07/04 07:23     {XXXX}      {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2010/07/04 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 database "Mailbox1", the status of the shadow copies is displayed (when -shadow option is specified):

C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -shadow -dbname Mailbox1
Original-Volume                     Replica-Volume                      Latest-Creation-Time Snapshot-ID SnapshotSet-ID
g1d1p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d11p1@BKUP-SVR(\\?\Volume{XXXX}\) 2010/07/04 07:23     {XXXX}      {XXXX}
g1d2p1@EXCHG-SVR(\\?\Volume{XXXX}\) g1d12p1@BKUP-SVR(\\?\Volume{XXXX}\) 2010/07/04 07:23     {XXXX}      {XXXX}
C:\>

For the database "Mailbox1", the status of the shadow copies is displayed (when -copy option is specified):

C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -copy -dbname Mailbox1
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 database "Mailbox1", the shadow copies are deleted:

C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange delete -dbname Mailbox1
swsrpshadowadm_exchange successfully completed
C:\>

For the database "Mailbox1", the QuickOPC is stopped:

C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -dbname Mailbox1
[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 -dbname Mailbox1
swsrpshadowadm_exchange successfully completed
C:\>C:\Win32App\AdvancedCopyManager\bin\swsrpshadowadm_exchange status -dbname Mailbox1
[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 ----   ----    ---- ----
C:\>

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 session has a fault (this only affects the state display function).
- When an error occurs with a hardware provider processing.
- When an error is caused by a hardware provider command.
- 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: