lun show

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.

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

Selects the LUNs that match this parameter value.

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

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

[-ostype | -t <LUN Operating System Format>] - OS Type

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

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

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