volume clone show

Contributors

Display a list of FlexClones

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

Description

The volume clone show command displays information about FlexClone clone volumes. This command is only supported for flexible volumes. By default, the command displays the following information about all FlexClone volume clones:

  • Vserver name

  • FlexClone volume name

  • Parent volume name

  • Parent snapshot name

  • Whether a FlexClone volume is online or offline

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

Parameters

{ [-fields <fieldname>,…​]

Selects the fields to be displayed.

| [-estimate ]

Displays an estimate of the free disk space required in the aggregate to split the indicated clone volume from its underlying parent volume. The value reported may differ from the space actually required to perform the split, especially if the clone volume is changing when the split is being performed.

| [-instance ] }

Displays detailed information about FlexClone volumes. If -flexclone is also specified, the command displays detailed information about the FlexClone volume.

[-vserver <vserver name>] - Vserver Name

Selects summary information for the FlexClone volumes on the specified Vserver. If -flexclone is also specified, the command displays detailed information about the specified FlexClone volume.

[-flexclone <volume name>] - FlexClone Volume

Selects summary information for the specified FlexClone volume. If -vserver is also specified, the command displays detailed information about the specified FlexClone volume.

[-type {RW|DP}] - FlexClone Type

Selects information for the specified type of FlexClone volume. The type can be specified as either read-only (DP) or read-write (RW).

[-parent-vserver <vserver name>] - FlexClone Parent Vserver

Selects summary information for the FlexClone volumes that are clone volumes in the specified parent Vserver.

[-b, -parent-volume <volume name>] - FlexClone Parent Volume

Selects summary information for the FlexClone volumes that are clones of the specified parent volume.

[-parent-snapshot <snapshot name>] - FlexClone Parent Snapshot

Selects summary information for the FlexClone volumes that are clones of the parent volume to which the specified snapshot belongs.

[-state {online|restricted|offline|force-online|force-offline|mixed}] - FlexClone Volume State

Selects summary information for the FlexClone volumes that are in the specified state.

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

Selects summary information for the FlexClone volumes that have the specified junction path.

[-junction-active {true|false}] - Junction Active

Selects summary information for the FlexClone volumes that have the specified junction path status.

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

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

[-space-guarantee-enabled {true|false}] - Space Guarantee In Effect

Selects summary information for the FlexClone volumes that have the specified space-guarantee setting.

[-aggregate <aggregate name>] - FlexClone Aggregate

Selects summary information for the FlexClone volumes that reside on the specified storage aggregate.

[-dsid <integer>] - FlexClone Data Set ID

Selects summary information for the FlexClone volumes that have the specified Data Set ID.

[-msid <integer>] - FlexClone Master Data Set ID

Selects summary information for the FlexClone volumes that have the specified Master Data Set ID.

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

Selects summary information for the FlexClone volumes that have the specified size.

[-used {<integer>[KB|MB|GB|TB|PB]}] - Used Size

Selects summary information for the FlexClone volumes that have the specified amount of used space.

[-split-estimate {<integer>[KB|MB|GB|TB|PB]}] - Split Estimate

Selects summary information for the FlexClone volumes that require the specified amount of free disk space for splitting from the parent.

[-inodes-processed <integer>] - Inodes Processed

Selects summary information for the FlexClone volumes that have the specified number of Inodes processed for splitting the FlexClone volume from its parent volume.

[-inodes-total <integer>] - Total Inodes

Selects summary information for the FlexClone volumes that have the specified number of total Inodes.

[-inode-percentage-complete <integer>] - Inode Percentage Complete

Selects summary information for the FlexClone volumes that have specified percentage of Inodes processed for splitting the FlexClone volume from its parent volume.

[-blocks-scanned <integer>] - Blocks Scanned

Selects summary information for the FlexClone volumes that have the specified number of blocks scanned for splitting the FlexClone volume from its parent volume.

[-blocks-updated <integer>] - Blocks Updated

Selects summary information for the FlexClone volumes that have the specified number of blocks updated for after splitting the FlexClone volume from its parent volume.

[-comment <text>] - Comment

Selects summary information for the FlexClone volumes that have the specified comment.

[-qos-policy-group <text>] - QoS Policy Group Name

Selects summary information for the FlexClone volumes that have the specified QoS policy group.

[-qos-adaptive-policy-group <text>] - QoS Adaptive Policy Group Name

Selects summary information for the FlexClone volumes that have the specified QoS adaptive policy group.

[-caching-policy <text>] - Caching Policy Name

This optionally specifies the caching policy to apply to the volume. A caching policy defines how the system caches this volume’s data in Flash Cache modules. If a caching policy is not assigned to this volume, the system uses the caching policy that is assigned to the containing Vserver. If a caching policy is not assigned to the containing Vserver, the system uses the default cluster-wide policy. This parameter is not supported on Infinite Volumes. The available caching policies are:

  • none - Does not cache any user data or metadata blocks.

  • auto - Read caches all metadata and randomly read user data blocks, and write caches all randomly overwritten user data blocks.

  • meta - Read caches only metadata blocks.

  • random_read - Read caches all metadata and randomly read user data blocks.

  • random_read_write - Read caches all metadata, randomly read and randomly written user data blocks.

  • all_read - Read caches all metadata, randomly read, and sequentially read user data blocks.

  • all_read_random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data.

  • all - Read caches all data blocks read and written. It does not do any write caching.

  • noread-random_write - Write caches all randomly overwritten user data blocks. It does not do any read caching.

  • meta-random_write - Read caches all metadata and write caches randomly overwritten user data blocks.

  • random_read_write-random_write - Read caches all metadata, randomly read and randomly written user data blocks. It also write caches randomly overwritten user data blocks.

  • all_read-random_write - Read caches all metadata, randomly read, and sequentially read user data blocks. It also write caches randomly overwritten user data blocks.

  • all_read_random_write-random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data. It also write caches randomly overwritten user data blocks.

  • all-random_write - Read caches all data blocks read and written. It also write caches randomly overwritten user data blocks.

Note that in a caching-policy name, a hyphen (-) separates read and write policies. Default caching-policy is auto.

[-parent-vol-type <volAccessType>] - Parent volume type

Selects summary information for the FlexClone volumes that are clones of the parent volumes with the specified type.

[-flexclone-used-percent <percent>] - FlexClone Used Percentage

Selects summary information for the FlexClone volumes that have the specified percentage of used space.

[-vserver-dr-protection {protected|unprotected}] - Vserver DR Protection

Selects summary information for the FlexClone volumes that have the specified type of Vserver SnapMirror protection. This parameter is applicable only if the Vserver is the source of a Vserver level SnapMirror relationship.

[-block-percentage-complete <integer>] - Block Percentage Complete

Selects summary information for the FlexClone volumes that have specified percentage of Blocks processed for splitting the FlexClone volume from its parent volume.

[-uid <integer>] - Volume-Level UID

Selects summary information for the FlexClone volumes that are created with the specified volume-level UID.

[-gid <integer>] - Volume-Level GID

Selects summary information for the FlexClone volumes that are created with the specified volume-level GID.

Examples

The following example displays detailed information about all FlexClone volumes on Vserver vs0:

cluster1::> volume clone show -vserver vs0
  (volume clone show)
Vserver   FlexClone      Parent-Volume   Parent-Snapshot
--------- -------------- --------------- ---------------
vs0       fc_vol_1       test_vol        clone_fc_vol_1.0
          fc_vol_2       test_vol2       clone_fc_vol_2.0
          fc_vol_3       tv9             clone_fc_vol_3.0
          tv8            tv7             clone_tv8.0
          tv9            test_vol2       clone_tv9.0
5 entries were displayed.

The following example displays detailed information about FlexClone volume fc_vol_2 on Vserver vs0:

cluster1::> volume clone show -vserver vs0 -flexclone fc_vol_2

                Vserver Name: vs0
            FlexClone Volume: fc_vol_2
     FlexClone Parent Volume: test_vol2
   FlexClone Parent Snapshot: clone_fc_vol_2.0
               Junction Path: -
             Junction Active: -
       Space Guarantee Style: volume
   Space Guarantee In Effect: true
         FlexClone Aggregate: test_aggr
       FlexClone Data Set ID: 1038
FlexClone Master Data Set ID: 2147484686
              FlexClone Size: 47.50MB
                   Used Size: 128KB
              Split Estimate: 0.00B
            Inodes processed: -
                Total Inodes: -
   Inode Percentage complete: -
              Blocks Scanned: -
              Blocks Updated: -
                     Comment:
       Qos Policy Group Name: pg1
FlexClone Parent Volume Type: RW
   Block Percentage complete: -

The following example displays summary information about all FlexClone volumes residing on Vserver vs0 along with the fields msid , dsid , state and parent-volume .

cluster1::> volume clone show -vserver vs0 -fields msid, dsid, state, parent-volume
vserver flexclone parent-volume state  dsid msid
------- --------- ------------- ------ ---- ----------
vs0     fc_vol_1  test_vol      online 1037 2147484685
vs0     fc_vol_3  tv9           online 1039 2147484687
vs0     flex_clone1
                  fc_vol_1      online 1041 2147484689
vs0     fv_2      fc_vol_1      online 1043 2147484691
vs0     tv9       test_vol2     online 1036 2147484684
5 entries were displayed.

The following example displays summary information about all FlexClone volumes residing on Vserver vs0 along with space-guarantee-enabled and space-guarantee information about each FlexClone volume.

cluster1::> vol clone show -vserver vs0 -fields space-guarantee-enabled, space-guarantee
  (volume clone show)
vserver flexclone space-guarantee space-guarantee-enabled
------- --------- --------------- -----------------------
vs0     fc_vol_1  volume          true
vs0     fc_vol_3  volume          true
vs0     flex_clone1
                  volume          true
vs0     fv_2      volume          true
vs0     tv9       volume          true
5 entries were displayed.