Skip to main content

volume flexcache show

Contributors
Suggest changes

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

[-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 (privilege: advanced)

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

[-is-smb-enabled {true|false}] - SMB access Enabled/Disabled (privilege: advanced)

If this parameter is specified, the command displays the FlexCache volumes matching the value for CIFS access.

[-preserve-msid {true|false}] - Preserve Origin MSID on the Cache (privilege: advanced)

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.

[-is-nfsv4-enabled {true|false}] - NFSv4 access Enabled/Disabled (privilege: advanced)

If this parameter is specified, the command displays the FlexCache volumes matching the value for NFSv4 access.

[-is-writeback-enabled {true|false}] - Is Writeback Enabled (privilege: advanced)

This parameter specifies whether writeback is enabled for the FlexCache volume. Writeback is a storage method where data is first written to the FlexCache volume and then written to the origin of a FlexCache volume.

[-is-relative-size-enabled {true|false}] - Is Relative Sizing Enabled/Disabled (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that match the given value for -is-relative-size-enabled . When relative size is enabled, the FlexCache size will be automatically updated based on the size of the origin.

[-relative-size-percentage <integer>] - Relative FlexCache Size Percentage (privilege: advanced)

If this parameter is specified, the command displays the information only about the FlexCache volume or volumes for which the value of -relative-size-percentage is specified. The relative size percentage is used to calculate the size of a FlexCache volume when the is-relative-size-enabled field is true .

[-override-encryption {true|false}] - Override FlexCache Volume Encryption

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that match the given value for the -override-encryption . If this parameter is true , then the volume is a plaintext FlexCache volume.

[-is-atime-scrub-enabled {true|false}] - Is atime-Based Scrubbing Enabled/Disabled (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that match the given value for -is-atime-scrub-enabled . When atime scrubber is enabled, the FlexCache volume will automatically scrub inactive files based on the specified atime duration.

[-atime-scrub-period <integer>] - Days After Which An Inactive File Is Scrubbed (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexCache volume or volumes for which the value of -atime-scrub-period is specified. The atime scrub period is used to remove the files from the FlexCache volume when the duration is met. The default duration to scrub files is set to 30 days .

[-is-cifs-change-notify-enabled {true|false}] - Is CIFS CHANGE_NOTIFY Enabled/Disabled (privilege: advanced)

If this parameter is specified, the command displays information only about the FlexCache volume or volumes that match the given value for -is-cifs-change-notify-enabled . When CIFS CHANGE_NOTIFY is enabled, the FlexCache volume will notify clients about changes on a directory.

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