Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

stormirror -restore

&pagelevel(4)&pagelevel

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