Creates one or multiple local or remote mirroring pairs by assigning one or multiple mirror volumes to one or multiple source volumes. The mirror volumes can be specified as full mirror copies or local pointer based logical copies (snapshots).
For full mirror copies after establishing the mirroring relationship the synchronization process is started. For local replication pairs, the source volumes and mirror volumes must all be part of the same storage system.
Syntax
|
Parameters
–mirrortype mirrortype
Specifies the type of mirror pair(s) to be created.
Supported values: snap | full |fullcopy
snap creates snapshot (pointer based) mirror pair(s). Snapshots on ETERNUS DX/AF based on SnapOPC+ systems are immediately available and accessible after creation.
full creates full copy mirror pairs (on ETERNUS DX/AF based on EC or REC).
fullcopy creates full copy pairs (on ETERNUS DX/AF based on QuickOPC)
–replica replica
Specifies if local or remote mirror pair(s) should be created.
Supported values: local | remote | bytarget (default)
local creates local replica(s) in the same storage system.
remote creates remote replica(s) in a different storage system of the same model for ETERNUS DX/AF. 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.
–copymode copymode
Defines the copy mode synchronous or asynchronous: sync | async | asyncstack
The default value (when omitted) is sync (synchronous).
–copymode sync for ETERNUS DX/AF corresponds to sync REC mode.
–copymode async for ETERNUS DX/AF corresponds to async REC consistent mode.
–copymode asyncstack for ETERNUS DX/AF corresponds to async REC stack mode.
The parameter is only supported for –replica remote and for storage systems ETERNUS DX /AF.
–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.
The capacity and type of the specified target volumes must match to the prerequisites of the specified mirroring feature of the storage system.
If the value #auto is specified, StorMan automatically assigns appropriate target volumes to create the mirror pair(s). This function can be supported for –mirrortype snap only.
–waitforsync
Option to wait for the completion of the synchronization process of the newly created mirror pair(s). This function can be supported for –mirrortype full only.
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 |
35 |
| The ETERNUS DX/AF system is locked for administration |
36 |
| User / password for StorMan not valid |
37 |
| Provider returned an error |