ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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

    • 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
    Top of Page