14.4.5 swsrpshadowadm_exchange (Exchange VSS Shadow Copy Management Command)

NAME

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

SYNOPSIS

When State Display of Shadow Copy Is Performed

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

When Shadow Copy Is Deleted

<program-directory>\bin\swsrpshadowadm_exchange delete -dbname databaseName

When QuickOPC Is Stopped

<program-directory>\bin\swsrpshadowadm_exchange stopqopc -dbname databaseName

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
Group	"----" is always 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. "failed": It is in an error state. "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 "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.

OPC/QuickOPC is not 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

-dbname databaseName: A database name is specified.
If the database name contains a space, enclose it with double quotes.

Specific Options of State Display (i.e., Status) of 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

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: