stormirror -suspend

Suspends the mirroring between source and target volumes of one or more mirrors pairs. The function suspends the mirroring for the specified mirror pair(s).

The local volumes remain accessible to the server and/or application and all changes are tracked by the storage system.

The mirror volumes become available for a server and/or application. The activation of multiple mirror volumes is not supported consistently by means of IO sequence. Therefore consistency must be assured by caller.

The mirror pairs specified by the source and mirror volumes must be homogenous, i.e. they must have the same mirror type and must be specified in the correct order.

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

Syntax

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

Parameters

–mirrortype mirrortype

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

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 | std (default)

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

 

–force

Suspends the mirroring regardless of the status. The function is performed as supported by underlaying functions of the storage system.

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