Skip to main content

volume flexcache show

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

  • 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
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.
[-flexgroup-msid <integer>] - Cache Flexgroup MSID (privilege: advanced)
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 (privilege: advanced)
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 (privilege: advanced)
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.

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