stormirror -restore

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

stormirror –restore [ –mirrortype mirrortype ] ] [ -replica replica ]
                     –source storid[,...] –target storid[,...]

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	STORMAN_OK	Function successful.
1	STORMAN_NO_ACTION	Nothing to do.
2	STORMAN_NOT_COMPLETE	Function only partly completed.
3	STORMAN_VER_NOT_SUPP	Version not supported
7	STORMAN_INV_PARAMETERS	Specified parameters invalid.
8	STORMAN_INVALID_STORID	Specified storID not allowed
10	STORMAN_STORID_NOT_FOUND	storID does not yet exist.
13	STORMAN_COMMUNIC_ERROR	Error in StorMan communication between client and server.
14	STORMAN_STORAGE_LOCKED	Storage unit currently locked.
16	STORMAN_FAULT	Unexpected error in function.
18	STORMAN_NOT_FOUND	Matching object could not be provided.
22	STORMAN_RESOURCE_NOT_AVAILABLE	Provider or database not available
25	STORMAN_PROVIDER_AUTH_FAILED	User / password for the provider not valid.
29	STORMAN_MIRROR_ERROR	Failure of the mirror operation. Details in subcodes: STEP_RESTART_FAILED STEP_SUSPEND_FAILED STEP_2ND_SWAP_FAILED
35	STORMAN_SYSTEM_LOCKED	The storage system is locked for administration
36	STORMAN_AUTH_FAILED	User / password for StorMan not valid
37	STORMAN_PROVIDER_ERROR	Provider returned an error