stormirror -swap

Swaps the mirror roles of source and target volumes of one or more mirrors pairs. The function reverses the roles of the volumes for the specified mirror pair(s) in the storage system, making the source volumes to target volumes and vice versa. The current local volumes are no longer accessible to the server and/or application and all.

The function is supported for local and remote full mirror pairs (clones).

Syntax

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

Parameters

–mirrortype mirrortype

Specifies the type of mirror pair(s) to be swapped.

Supported values: full | any (default)

full selects full copy mirror pairs (on ETERNUS DX/AF based on EC or REC).

any selects the mirroring feature defined by the specified mirror pair(s).

–replica replica

Specifies if local or remote mirror pair(s) should be processed.

Supported values: local | remote | bytarget (default)

local selects local replica(s) in the same storage system.

remote selects remote replica(s) in a different storage system of the same model. This can be on a different site.

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 ore 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.
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
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