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 -show

&pagelevel(4)&pagelevel

Displays information about the relationship and status of mirrored pairs. The selection is controlled by the specified parameters. E.g. use parameters -system system and –mirrorusage origlocal to show all volumes on a specific storage system that are used as source volumes for local mirroring. A subset of the selection parameters of storcfg volume -show is supported.

For storage volumes used in a storage cluster a remote replication is always maintained to the secondary system.
This remote replication is managed exclusively by ETERNUS SF Storage Cluster functions. The replication relationship is not displayed by stormirror -show.

Syntax

stormirror –show [ –storid storid[,...] ] [ –poolid poolid[,...] ] 
                 [ –system system ] [ -replica replica ]
                 [ –mirrortype mirrortype ] [–copymode copymode ]
                 [ –mirrorusage mirrorusage ] [ –cluster cluster ]
                 [ –format format ]

Parameters

–storid storid

Specifies the storID for the logical volume (default: *). Wildcards (*) are supported.

To display all logical volumes of a storage system (even if they are not managed by StorMan) specify –storid #all and exactly one storage system using the system parameter. All other parameters are ignored in this case. A comma separated list of stor IDs is allowed.

–poolid poolid

Specifies the ID of a pool the logical volume belongs to (default: *).
Wildcards (*) are supported. A comma separated list of pool IDs is allowed.

–system system

Specifies the system name of the storage system the logical volume belongs to (default: *). Wildcards (*) are supported.

–replica replica

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

Supported values: local | remote | any (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.

any selects all replicas.

 

–mirrortype mirrortype

Specifies the mirror type of the volume for mirroring (replication) functions.

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

–copymode copymode

Selects the displayed volumes according to their copy mode, supported only for mirrorusage origremote and mirrorremote:
Supported values: sync | async | asyncstack | asyncthrough | any (default)

–copymode sync selects the volumes with copy mode sync .

–copymode async selects the volumes with copy mode async.

–copymode asyncstack selects the volumes with copy mode asyncstack.

–copymode asyncthrough selects the volumes with copy mode asyncthrough.

–mirrorusage mirrorusage

Selects the displayed volumes according to their usage as mirroring (replication) pairs (default: any).

Supported values: origlocal | mirrorlocal | origremote | mirrorremote | any (default)

any selects the pairs regardless of their mirror usage.

origlocal selects all volumes used as original volumes of local mirror pair(s).

mirrorlocal selects all volumes used as mirror volumes of local mirror pair(s).

origremote selects original volumes of remote mirror pair(s).

mirrorremote selects mirror volumes of remote mirror pair(s).

–cluster cluster

Selects by the cluster the volume belongs to.

–format format

Specifies the output format. Refer to the description of the "Format parameter".

 

To display all logical volumes (even if they are not managed by StorMan) of a storage system you have to specify exactly one system using the –system parameter and specify –storid without a value. All other parameters are ignored in this case.

Additionally all selection parameters offered by storcfg volume –show are supported.

Return codes

Error Code

Name                                                           

Error Type

0

STORMAN_OK

Function successful.

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

13

STORMAN_COMMUNIC_ERROR

Error in StorMan communication between client and server

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

35

STORMAN_SYSTEM_LOCKED

The storage system is locked for administration

36

STORMAN_AUTH_FAILED

User / password for StorMan not valid

Examples

  1. Output for logical volumes with –format std (default)

    stormirror -show -storid SM_20817

    storage ID          = SM_20817
  pool ID             = test
  storage system name = 4621347002
  storage serial nr.  = 4621347002
  device ID           = 751
  GUID                = 600000E00D2A0000002A004702EF0000
  storage size        = 10 GB
  type                = normal
  storage vendor      = FUJITSU
  storage model       = ETERNUS DX
  status              = READY
  raid level          = RAID1
  raid type           = RAID1
  owner controller    = CM00
  storage pools       = TFO-Group
  host access         = restricted
  mirror targets
    storage ID          = SM_20819
      storage system name     = 4621347002
      pool ID                 = test
      device ID               = 753
      GUID                    = 600000E00D2A0000002A004702F10000
      mirror type             = full-copy
      replication mode        = local
      copy mode               = sync
      status                  = split
      isSynch                 = no
      percentSynced           = 1
      timestamp               = 20170511164532.000000+000
no mirror sources found

  2. Output for logical volumes with –format medium

    stormirror -show -storid UID_ SM_20817 -format medium

    SM_20817 storage=4621347002 deviceID=751 size=10 GB
        targets:SM_20819/753/split 

  3. Output for logical volumes with –format xmlp

    stormirror -show -storid SM_20817 -format xmlp

    <Response>
  <ReturnCode>
    <Code>STORMAN_OK</Code>
    <CodeNumber>0</CodeNumber>
    <Text>successful</Text>
    <SubCode>0</SubCode>
    <SubCodeText>STORMAN_SUB_NONE</SubCodeText>
    <AdditionalInformation/>
    <MessageID>889</MessageID>
    <ConnectionID>55547508F2658</ConnectionID>
    <TimeID>1501139666197000</TimeID>
  </ReturnCode>
  <Result>
    <VolumeDescriptions>
      <VolumeDescription>
        <StorID>SM_20817</StorID>
        <PoolID>test</PoolID>
        <StorageSystemName>4621347002</StorageSystemName>
        <StorageSerialNumber>4621347002</StorageSerialNumber>
        <StorageCustomName>DX500 S3-01</StorageCustomName>
        <GUID>600000E00D2A0000002A004702EF0000</GUID>
        <DeviceID>751</DeviceID>
        <DeviceNumber>751</DeviceNumber>
        <VolumeName>TFO-Vol1</VolumeName>
        <Size>10737418240</Size>
        <SizeNormalized>10 GB</SizeNormalized>
        <StorageVendor>STORMAN_STORAGE_VENDOR_FUJITSU</StorageVendor>
        <StorageModel>STORMAN_STORAGE_MODEL_ETERNUS</StorageModel>
        <StorageFeatures>29694</StorageFeatures>
        <Status>STORMAN_VOLUME_STATUS_READY</Status>
        <VolumeType>STORMAN_VOLUME_TYPE_NORMAL</VolumeType>
        <RaidLevel>STORMAN_RAID_LEVEL_1</RaidLevel>
        <RaidType>RAID1</RaidType>
        <CurrOwnerController>CM00</CurrOwnerController>
        <SpaceConsumedInBox>10737418240</SpaceConsumedInBox>
        <MayBeSource>true</MayBeSource>
        <MayBeTarget>true</MayBeTarget>
        <MayBeFullTarget>true</MayBeFullTarget>
        <MayBeSnapTarget>false</MayBeSnapTarget>
        <IsActionAllowed>true</IsActionAllowed>
        <FirstHostLun/>
        <StorageClusterName/>
        <Usage>Remote Replica Source or Target</Usage>
        <UsageCode>11</UsageCode>
        <StoragePoolNames>
          <StoragePoolName>TFO-Group</StoragePoolName>
        </StoragePoolNames>
        <StoragePoolIDs>
          <StoragePoolID>FUJITSU:RSP0014</StoragePoolID>
        </StoragePoolIDs>
        <HostConnections>
        </HostConnections>
        <MirroringTargets>
          <MirroringTarget>
            <StorID>SM_20819</StorID>
            <DeviceID>753</DeviceID>
            <DeviceNumber>753</DeviceNumber>
            <GUID>600000E00D2A0000002A004702F10000</GUID>
            <StorageSystemName>4621347002</StorageSystemName>
            <StorageSerialNumber>4621347002</StorageSerialNumber>
            <StorageCustomName>DX500 S3-01</StorageCustomName>
            <StorageVendor>STORMAN_STORAGE_VENDOR_FUJITSU</StorageVendor>
            <StorageModel>STORMAN_STORAGE_MODEL_ETERNUS</StorageModel>
            <PoolID>test</PoolID>
            <MirrorType>STORMAN_MIRROR_TYPE_FULL_COPY</MirrorType>
            <ReplicationMode>STORMAN_MIRROR_REPLICA_LOCAL</ReplicationMode>
            <CopyMethod>STORMAN_ETERNUS_COPY_METHOD_QUICK_OPC</CopyMethod>
            <Status>STORMAN_MIRROR_PAIR_STATUS_SPLIT</Status>
            <CopyMode>STORMAN_REMOTE_COPY_MODE_SYNC</CopyMode>
            <SplitMode>STORMAN_MIRROR_SPLIT_MODE_UNKNOWN</SplitMode>
            <RecoveryMode>STORMAN_MIRROR_RECOVERY_MODE_UNKNOWN</RecoveryMode>
            <IsSynch>false</IsSynch>
            <IsSCO>false</IsSCO>
            <ContinuousCopy>false</ContinuousCopy>
            <PercentSynced>1</PercentSynced>
            <StorageClusterName/>
            <PairEstablishedSince/>
            <PointInTime>
              <TimeStamp>20170511164532.000000+000</TimeStamp>
            </PointInTime>
            <CustomProperties>
            </CustomProperties>
          </MirroringTarget>
        </MirroringTargets>
        <MirroringSources>
        </MirroringSources>
        <TargetPorts>
        </TargetPorts>
        <CustomProperties>
        </CustomProperties>
        <OperationalStatus>OK</OperationalStatus>
        <OperationalStatusDetailList>
        </OperationalStatusDetailList>
      </VolumeDescription>
    </VolumeDescriptions>
  </Result>
</Response>
Powered by Atlassian Confluence and Scroll Viewport.