Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

storcfg volume -show

&pagelevel(5)&pagelevel

Displays information related to logical volumes. For volumes used in a storage cluster the command displays additionally storage cluster related information for the specified volume.

Selection criteria can be specified using the function parameters.

Syntax

storcfg volume –show [ –storid storid[,...] ] [ –poolid poolid[,...] ]
                    [ –system system ] [ –systemname systemname ]
                    [ –deviceid devid[,...] ] [ –vendor vendor ]
                    [ –model model ] [ –type type ]
                    [ –minsize minsize ] [ –maxsize maxsize ]
                    [ –hostname hostname ] [ –hostip ip ]
                    [ –hostwwpn wwpn ] [ –hostiqn iqn ]
                    [ –hostlun lun ][ –raidtype raidtype] 
                    [ –mirrortype mirrortype] [ –replica replica] 
                    [ –mirrorusage mirrorusage] [ –copymode copymode] 
                    [ –cluster cluster ] [ –withunmanaged] 
                    [ –showconnections] [ –showmirrors]
                    [ –format format 

Parameters

–storid storid

Specifies the storID for the logical volume (default: *).
Wildcards (*) are supported. A comma separated list of storids is 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.

–poolid poolid

Specifies the ID of a pool the logical volume belongs to (default: *).
Wildcards (*) are supported. A comma separated list of poolids is supported.
–poolid #none displays all volumes of a storage system that are NOT assigned to any pool for the specifid system.

–system system

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

–systemname systemname

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

 

–deviceid devid

Specifies the device ID of the logical volume. (default: *).
Wildcards (*) are supported. A comma separated list of device IDs is supported.
It is not allowed to specify both storID and device ID.

–vendor vendor

Specifies the vendor of the storage system.

Supported values: fujitsu | any (default).

–model model

Selects by the model of the storage system.
Supported values: eternus | any (default).

–type type

Selects by the type of logical volume in the storage system (currently supported for ETERNUS DX/AF only).

Supported values: normal | thin | snap | flexible (default: no selection)

normal displays normal volumes.

thin displays thin provisioned volumes.

snap displays snap volumes used for snapshots.

flexible displays flexible volumes used for automated storage tiering.

–minsize minsize

Selects by the minimum size of the logical volume in MB (default: no restriction).

–maxsize maxsize

Selects by the maximum size of the logical volume in MB (default: no restriction).

–hostname hostname

Selects by the name of the host the storID of is attached to (default: *).
Wildcards (*) are supported.

–hostip ip

Selects by the IP address of the host the storID of is attached to (default: *).
Wildcards (*) are supported.

–hostwwpn wwpn

Selects by the WWPN of the host port the storID of is attached to (default: *).
Wildcards (*) are supported.

–hostiqn iqn

Selects by the IQN of the host port the storID of is attached to (default: *).
Wildcards (*) are supported.

 

–hostlun lun

Selects by the device number of the host the storID of is attached to.
If -showconnections is specified only this connection is displayed.

–mirrorusage mirrorusage

Selects the displayed volumes according to their usage as mirroring (replication) pairs (default: no selection). If the parameter is not specified, no selection of mirror usage is done.

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

any selects all volumes used for mirroring regardless of the kind of mirror usage.

none selects only volumes not used for  mirroring.

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 all volumes used as original volumes of remote mirror pair(s).

mirrorremote selects all volumes used as mirror volumes of remote mirror pair(s).

–mirrortype mirrortype

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

Supported values: snap | full | fullcopy | any (default)

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

snap selects snapshot (pointer based) mirror pair(s).

full selects full copy mirror pairs.

fullcopy selects full copy clones

–replica replica

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

Supported values: local | remote | any (default)

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

local selects local mirror pair(s).

remote selects remote mirror pairs.

–copymode copymode

Specifies the copy mode synchronous or asynchronous: sync | async | asyncstack

The default value (when omitted) is sync (synchronous).

–copymode sync corresponds to sync REC mode.

–copymode async corresponds to async REC consistent mode.

–copymode asyncstack corresponds to async REC stack mode.

–copymode asyncthrough corresponds to asyncthrough stack mode.

The parameter is only supported for –replica remote and as of ETERNUS DX S3 / AF.

–raidtype raidtype

Selects by the RAID type of the volume.

any selects the volumes regardless of the RAID type. The supported RAID types on a storage system can be shown by using storcfg system -show -showraidtypes.

–cluster cluster

Selects by the cluster the volume belongs to.

–withunmanaged

Displays also volumes which are not managed by StorMan (i.e. volumes which are not contained in a pool).

–showconnections

Displays also the host connections of the volumes (with output format std).

–showmirrors

Displays also assigned mirror volumes (with output format std).

–format format

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

Return codes

Error Code

Name                                                          

Error Type

0

STORMAN_OK

Function successful

3

STORMAN_VER_NOT_SUPP

Version not supported

7

STORMAN_INV_PARAMETERS

Specified parameters invalid

13

STORMAN_COMMUNIC_ERROR

Error in StorMan communication between client and server

14

STORMAN_STORAGE_LOCKED

Storage unit to be modified currently locked

16

STORMAN_FAULT

Unexpected error in function

18

STORMAN_NOT_FOUND

Matching object could not be provided

Examples

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

    storcfg volume -show -storid SM_2081* –showmirrors

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

    storcfg volume -show -storid SM_20817 -format medium

    SM_20817 storage=4621347002 deviceID=751 size=10 GB

  3. Output for logical volumes with –format xmlp

    storcfg volume -show -storid SM_20817 –showmirrors -format xmlp

    <Response>
  <ReturnCode>
    <Code>STORMAN_OK</Code>
    <CodeNumber>0</CodeNumber>
    <Text>successful</Text>
    <SubCode>0</SubCode>
    <SubCodeText>STORMAN_SUB_NONE</SubCodeText>
    <AdditionalInformation/>
    <MessageID>846</MessageID>
    <ConnectionID>55546C7F911F0</ConnectionID>
    <TimeID>1501137374676000</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>
        <HostIDs>
        </HostIDs>
        <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>

  4. Output for logical volumes extended with storage cluster information (if existing)

    storcfg volume –show –system <system> -deviceid <deviceid>

      storage ID          =
    pool ID             =
    storage system name = 4621349005
    storage serial nr.  = 4621349005
    device ID           = 912
    GUID                = 600000E00D2A0000002A005403900000
    storage size        = 20 GB
    type                = normal
    resource type       = predefined
    storage vendor      = FUJITSU
    storage model       = Eternus
    status              = NOT-READY
    raid level          = RAID5
    raid type           = RAID5
    owner controller    = CM00
    cluster name        = DX500_2-DX500_1
    storage pools       = RG900_02
Powered by Atlassian Confluence and Scroll Viewport.