volume flexcache show

Contributors

Display cache relationships

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume flexcache show command displays information about FlexCache volumes. The command output depends on the parameter or parameters specified with the command. If no parameters are specified, the command displays the following information about all FlexCache volumes:

  • Vserver name

  • Volume name

  • Size

  • Space guarantee

  • Origin Vserver

  • Origin volume

  • Origin cluster

To display detailed information about all FlexCache volumes, run the command with the -instance parameter.

Parameters

{ [-fields <fieldname>,…​]

This specifies the fields that need to be displayed.

| [-instance ] }

If this parameter is specified, the command displays information about all values.

[-vserver <Vserver Name>] - Vserver Name

If this parameter and the -volume parameter are specified, the command displays detailed information about the specified volume. If this parameter is specified by itself, the command displays information about FlexCache volumes on the specified Vserver.

[-volume <volume name>] - Cache Volume Name

If this parameter is specified, the command displays detailed information about the specified FlexCache volume.

[-aggr-list <aggregate name>,…​] - List of Aggregates for FlexGroup Constituents

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that are located on the specified list of storage aggregates.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Volume Size

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have the specified size. Size is the maximum amount of space a volume can consume from its associated aggregate(s), including user data, metadata, Snapshot copies, and Snapshot reserve. Note that for volumes without a -space-guarantee of volume , the ability to fill the volume to this maximum size depends on the space available in the associated aggregate or aggregates.

[-flexgroup-msid <integer>] - Cache Flexgroup MSID

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have the specified FlexGroup master data-set ID.

[-origin-vserver <vserver name>] - Origin Vserver Name

If this parameter is specified, the command displays information only about the FlexCache volume or volumes which have a relationship with the specificed origin-vserver.

[-origin-vserver-uuid <UUID>] - Origin Vserver UUID

If this parameter is specified, the command displays information only about the FlexCache volume or volumes which have a relationship with the origin-vserver UUID.

[-origin-volume <volume name>] - Origin Volume Name

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have a relationship with the specified origin-volume.

[-origin-volume-msid <integer>] - Origin Volume MSID

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have a relationship with the specified origin master data set ID.

[-origin-cluster <Cluster name>] - Origin Cluster Name

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have a relationship with the specified origin-cluster.

[-junction-path <junction path>] - Cache Junction Path

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have the specified junction path.

[-create-time <Date>] - FlexCache Create Time

If you specify this parameter, the command displays information only about the FlexCache volume or volumes for which the create-time option matches the specified input.

[-s, -space-guarantee {none|volume}] - Space Guarantee Style

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that have the specified space guarantee style.

[-relationship-type {Intravserver|Intervserver|Intercluster}] - Relationship Type

If this parameter is specified, the command displays the FlexCache volumes matching the relationship type.

[-preserve-msid {true|false}] - Preserve Origin MSID on the Cache

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that match the given value for the -preserve-msid . If this parameter is true , then FlexCache DR is enabled for the FlexCache volume.

[-is-global-file-locking-enabled {true|false}] - Global File Locking Mode Enabled/Disabled

If this parameter is specified, the command displays the FlexCache volumes matching the global file locking mode.

Examples

The following example displays information about all FlexCache volumes on the Vserver named "vs34":

cluster1::> flexcache show -vserver vs34
        (volume flexcache show)
        Vserver Volume      Size       Origin-Vserver Origin-Volume Origin-Cluster
        ------- ----------- ---------- -------------- ------------- --------------
        vs34    fc1         800MB      vs34           origin1         cluster-2
        vs34    fc2         800MB      vs34           origin1         cluster-2
        2 entries were displayed.

The following example displays detailed information about a FlexCache volume named fc1 on an SVM named vs34:

cluster1::> flexcache show -vserver vs34 -volume fc1 -instance
  (volume flexcache show)
Vserver: vs34
                            Cache Volume Name: fc1
List of Aggregates for FlexGroup Constituents: aggr34
                                  Volume Size: 800MB
                         Cache Flexgroup MSID: 2155934574
                          Origin Vserver Name: vs34
                          Origin Vserver UUID: a8717aeb-2826-11e8-bf56-00505695f37a
                           Origin Volume Name: origin1
                           Origin Volume MSID: 2155934545
                          Origin Cluster Name: cluster-2
                          Cache Junction Path: -
                        FlexCache Create Time: Thu Aug 23 04:36:19 2018
                            Relationship Type: inter-vserver
            Preserve Origin MSID on the Cache: false