Restores one or more mirror pairs. This function restores the contents of the local mirror volumes back to the original volumes of the mirrored pairs. All changes on the original volumes are discarded.
The mirror volumes of mirror type snap
remain accessible to the server and/or application.
The mirror volumes of mirror type full
are no longer accessible to the server and/or application. The status of mirror volumes after processing a restore operation depends on the specific storage system.
This function is supported for ETERNUS DX/AF systems only for –copymode sync
.
For ETERNUS DX/AF systems the restore operation is completed only after synchronization is also completed. The mirror volumes are accessible to the server and the mirror pairs are ‘split’ and ‘synchronized’.
Syntax
|
Parameters
–mirrortype mirrortype
Specifies the type of mirror pair(s) to be restored.
Supported values: snap
| full
| fullcopy
| any (default)
snap
selects snapshot (pointer based) mirror pair(s).
full
selects full copy mirror pairs (on ETERNUS DX/AF based on EC or REC).
fullcopy
selects full copy pairs (on ETERNUS DX/AF based on QuickOPC)
any
selects the mirroring feature defined by the specified mirror pair(s).
–replica replica
Specifies if local or remote mirror pair(s) should be restored.
Supported values: local
| remote
| bytarget
(default)
local
creates local replica(s) in the same storage system.
remote
restores remote replica(s) in a different storage system of the same model. This can be on a different site. This value is supported for –mirrortype full
only.
bytarget
selects the replica location defined by the specified mirror pair(s). The automatically selected replica must be the same for all specified mirror pairs.
–source storid[,...]
Specifies the storID(s) of one or a list of source volumes for the mirror pair(s).
The number of specified storIDs for the source volumes must be equal to the number of specified storIDs for the target volumes.
–target storid[,...]
Specifies the storID(s) of one or a list of target volumes for the mirror pair(s).
The number of specified storIDs for the source volumes must be equal to the number of specified storIDs for the target volumes.
Return codes
Error Code | Name | Error Type |
0 |
| Function successful. |
1 |
| Nothing to do. |
2 |
| Function only partly completed. |
3 |
| Version not supported |
7 |
| Specified parameters invalid. |
8 |
| Specified storID not allowed |
10 |
| storID does not yet exist. |
13 |
| Error in StorMan communication between client and server. |
14 |
| Storage unit currently locked. |
16 |
| Unexpected error in function. |
18 |
| Matching object could not be provided. |
22 |
| Provider or database not available |
25 |
| User / password for the provider not valid. |
29 |
| Failure of the mirror operation. Details in subcodes:
|
35 |
| The storage system is locked for administration |
36 |
| User / password for StorMan not valid |
37 |
| Provider returned an error |