Skip to main content
A newer release of this product is available.

lun show

Contributors
Suggest changes

Display a list of LUNs

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

Description

The command displays information for LUNs. Use the instance parameter to display additional LUN details, such as serial number and space-reservation settings.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver Name

Selects the LUNs that match this parameter value.

{ [-path <path>] - LUN Path

Selects the LUNs that match this parameter value. Examples of correct LUN paths are /vol/vol1/lun1 and /vol/vol1/qtree1/lun1

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

Selects the LUNs that match this parameter value.

[-qtree <qtree name>] - Qtree Name

Selects the LUNs that match this parameter value.

[-lun <text>] - LUN Name }

Selects the LUNs that match this parameter value.

[-s, -size <size>] - LUN Size

Selects the LUNs that match this parameter value.

[-P, -prefix-size <size>] - Prefix Size (privilege: advanced)

Selects the LUNs that match the prefix stream size that you specify.

[-t, -ostype {vmware|hyper_v|windows_2008|windows_gpt|windows|linux|xen|solaris|solaris_efi|hpux|aix|netware|openvms}] - OS Type

Selects the LUNs that match this parameter value. The operating system types are:

  • aix - the LUN stores AIX data.

  • hpux - the LUN stores HP-UX data.

  • hyper_v - the LUN stores Windows Server 2008 or Windows Server 2012 Hyper-V data

  • linux - the LUN stores a Linux raw disk without a partition table.

  • netware - the LUN stores NetWare data.

  • openvms - the LUN stores Open-VMS data

  • solaris - the LUN stores Solaris raw disk in a single-slice partition.

  • solaris_efi - the LUN stores Solaris_EFI data.

  • vmware - the LUN stores VMware data

  • windows - the LUN stores a raw disk type in a single-partition Windows disk using the Master Boot Record (MBR) partitioning style.

  • windows_gpt - the LUN stores Windows data using the GUID Partition Type (GPT) partitioning style.

  • windows_2008 - the LUN stores Windows data for Windows 2008 or later systems.

  • xen - the LUN stores Xen data

[-space-reserve {enabled|disabled}] - Space Reservation

Selects the LUNs that match this parameter value. A value of enabled selects LUN that are space-reserved. A value of disabled select LUNs that are non-space reserved.

[-serial <text>] - Serial Number

Selects the LUNs that match this parameter value.

The LUN serial number is a twelve-character alphanumeric string containing one or more of the following:

  • upper- and lower-case letters

  • numbers

  • the characters: , <, >, /, -, #, $, %, *, +, =, ?, @, [, !, ], ^, ~

Some of the characters that are valid in a LUN serial number also have special meaning to the cluster shell command:

  • The question mark (?) activates the command line active help. In order to type a question mark as part of a LUN's serial number, it is necessary to disable active help with the command set -active-help false . Active help can later be re-enabled with the command set -active-help true .

  • The number sign (#) indicates the beginning of a comment to the command line and will cause the remainder of the line to be ignored. To avoid this, enclose the serial number in double quotes (").

  • The less than (<), greater than (>), asterisk (*), and exclamation point (!) influence the query behavior of the command. To use these as characters in a LUN's serial query, you must first press escape (ESC). To use these characters to influence the query, enclose the serial number, or partial serial number, in double quotes (") and apply <, >, *, or !, outside of the double quotes.

Alternatively, the -serial-hex parameter can be used to select LUNs using the serial number encoded in hexadecimal form.

[-serial-hex <Hex String>] - Serial Number (Hex)

Selects the LUNs that match this parameter value. This parameter applies to the LUN serial number encoded in hexadecimal form. See the description of the -serial parameter for additional details.

[-comment <text>] - Comment

Selects the LUNs that match this parameter value.

[-space-reserve-honored {true|false}] - Space Reservations Honored

Selects the LUNs that match this parameter value. A value of true select LUNs that have their space reservation honored by the container volume. A value of false displays the LUNs that are non-space reserved.

[-space-allocation {enabled|disabled}] - Space Allocation

Selects the LUNs that match this parameter value. The space allocation attribute determines if the LUN supports the SCSI Thin Provisioning features defined in the Logical Block Provisioning section of the SCSI SBC-3 standard.

Specifying enabled for this parameter selects LUNs with support enabled for the SCSI Thin Provisioning features.

Specifying disabled for this parameter selects LUNs with support disabled for the SCSI Thin Provisioning features.

Hosts and file systems that do not support SCSI Thin Provisioning should not enable space allocation.

[-container-state {online|aggregate-offline|volume-offline|error}] - LUN Container State (privilege: advanced)

Selects the LUNs that match this parameter value. The container states are:

  • online - The LUN's aggregate and volume are online.

  • aggregate-offline - The LUN's aggregate is offline.

  • volume-offline - The LUN's volume is offline.

  • error - An error occurred accessing the LUN's volume.

[-state {online|offline|nvfail|space-error|foreign-lun-error}] - State

Selects the LUNs that match this parameter value. The states are:

  • online - The LUN is online.

  • offline - The LUN is administratively offline, or a more detailed offline reason is not available.

  • foreign-lun-error - The LUN has been automatically taken offline due to a media error on the associated foreign LUN.

  • nvfail - The LUN has been automatically taken offline due to an NVRAM failure.

  • space-error - The LUN has been automatically taken offline due to insufficient space.

[-uuid <UUID>] - LUN UUID

Selects the LUNs that match this parameter value.

[-mapped {mapped|unmapped}] - Mapped

Selects the LUNs that match this parameter value. A value of mapped selects the LUNs that are mapped to an initiator group.

[-block-size {512|4KB}] - Physical Size of Logical Block

Selects the LUNs that match this parameter value.

[-device-legacy-id <integer>] - Device Legacy ID

Selects the LUNs that match this parameter value.

[-device-binary-id <text>] - Device Binary ID

Selects the LUNs that match this parameter value.

[-device-text-id <text>] - Device Text ID

Selects the LUNs that match this parameter value.

[-read-only {true|false}] - Read Only

Selects the LUNs that match this parameter value.

[-restore-inaccessible {true|false}] - Fenced Due to Restore

Selects the LUNs that match the state you specify. A value of true means that a LUN is fenced for I/O and management due to a restore operation.

[-size-used <size>] - Used Size

Selects the LUNs that match this parameter value.

[-max-resize-size <size>] - Maximum Resize Size

Selects the LUNs that match this parameter value.

[-creation-timestamp <MM/DD/YYYY HH:MM:SS>] - Creation Time

Selects the LUNs that match this parameter value.

[-class {regular|protocol-endpoint|vvol}] - Class

Selects the LUNs that match this parameter value.

[-node <nodename>] - Node Hosting the LUN

Selects the LUNs that match this parameter value.

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

Selects the LUNs that match this parameter value.

A policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to a LUN, the system will not monitor and control the traffic to it.

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

Selects the LUNs that match this parameter value.

An adaptive policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the adaptive policy group is associated.

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

Display the LUNs that match the specified cache.

A caching policy defines the caching behavior of this LUN at the Flash Cache level. If a caching policy is not assigned to this LUN, the system uses the caching policy that is assigned to the containing volume or Vserver. If a caching policy is not assigned to the containing volume or Vserver, the system uses the default cluster-wide policy. 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.

Default caching-policy is auto.

[-is-clone {true|false}] - Clone

Selects the LUNs that match this parameter value.

[-is-clone-autodelete-enabled {true|false}] - Clone Autodelete Enabled

Selects the LUNs that match this parameter value.

[-inconsistent-import {true|false}] - Inconsistent Import

Selects the LUNs that match this parameter value. A value of true means that the import of this LUN is incomplete.

[-serial-7-mode <text>] - 7-mode Serial Number (privilege: advanced)

Selects the LUNs that match this parameter value.

LUNs transitioned from Data ONTAP 7-Mode are assigned new serial numbers for use with Clustered Data ONTAP. The original 7-Mode serial number is displayed in this field for reference.

[-application <text>] - Application

Selects the LUNs that are part of an application that matches the parameter value.

[-include-offline-containers <true>] - Include LUNs on Offline Volumes and Aggregates (privilege: advanced)

If true, include available information for LUNs in offline aggregates and offline volumes in the output. By default, LUNs in offline aggregates and offline volumes are excluded from the output.

Examples

The following example displays details of the LUN at path /vol/vol1/lun1 in Vserver vs1.

cluster1::> lun show -vserver vs1 -path /vol/vol1/lun1 -instance
              Vserver Name: vs1
                  LUN Path: /vol/vol1/lun1
               Volume Name: vol1
                Qtree Name: ""
                  LUN Name: lun1
                  LUN Size: 10MB
                   OS Type: linux
         Space Reservation: disabled
             Serial Number: wCVt1]IlvQWv
       Serial Number (Hex): 77435674315d496c76515776
                   Comment: new comment
Space Reservations Honored: false
          Space Allocation: disabled
                     State: offline
                  LUN UUID: 76d2eba4-dd3f-494c-ad63-1995c1574753
                    Mapped: mapped
                Block Size: 512
          Device Legacy ID: -
          Device Binary ID: -
            Device Text ID: -
                 Read Only: false
     Fenced Due to Restore: false
                 Used Size: 5MB
       Maximum Resize Size: 64.00GB
             Creation Time: 9/14/2016 13:55:09
                     Class: regular
      Node Hosting the LUN: node1
          QoS Policy Group: -
       Caching Policy Name: -
                     Clone: false
  Clone Autodelete Enabled: false
       Inconsistent Import: false
               Application: -

The following example displays information for the LUN with serial number 1r/wc+9Cpbls:

cluster1::> lun show -serial 1r/wc+9Cpbls
Vserver   Path                            State   Mapped   Type        Size
--------- ------------------------------- ------- -------- -------- --------
vs1       /vol/vol2/lun1                  online  mapped   linux        10MB

The following example displays all the LUNs on Vserver vs1 and volume vol1:

cluster1::> lun show -vserver vs1 -volume vol1
Vserver   Path                            State   Mapped   Type        Size
--------- ------------------------------- ------- -------- -------- --------
vs1       /vol/vol1/lun1                  offline mapped   linux        10MB
vs1       /vol/vol1/lun2                  online  mapped   windows   47.07MB
2 entries were displayed.