Host-volume connections may be represented as per-host tables like the one below.
LUN Volume
For a given host, each of the 255 LUNs supported by Purity may be used to address one connected volume or it may be unused.
As suggested by the table, however, Purity supports two types of host-volume connections:
Private
Connects one volume and one host. Uses either an administrator-specified LUN or the lowest available LUN in the range [1...9] for hosts associated with host groups, and the lowest available LUN in the range [1...255] otherwise.
Private connections are independent of one another. For example, the sequence:
purevol connect --host HOST1 VOL1 VOL2 purehost disconnect --vol VOL1 HOST1
connects HOST1 to VOL1 and HOST1 to VOL2, and then disconnects HOST1 and VOL1, leaving HOST1 connected to VOL2.
purehost-connect
Shared
Connects a designated set of hosts (a host group) to a designated set of volumes, providing the hosts with a consistent "view" of the volumes. (All associated hosts use the same LUN to address a given associated volume.) Uses LUNs in the range [10...255] for a maximum of 246 shared connections. All hosts and volumes associated with a host group are automatically connected to each other by virtue of their associations with the group.
Shared connections are established by the purevol connect command with the --hgroup option or by the purehgroup connect command. The latter is discussed in the purehgroup-connect man page.
For example, the command:
purevol connect --hgroup HGROUP1 VOL1 VOL2
is equivalent to the sequence:
purehgroup connect --vol VOL1 HGROUP1 purehgroup connect --vol VOL2 HGROUP1
Both establish shared connections between the hosts associated with HGROUP1 and VOL1 and VOL2. A host may have only one connection to a given volume. An attempt to connect a host to a volume to which it already has either a private or a shared connection fails, even if the connection attempt uses the alternate paradigm or specifies a different LUN. To change the LUN associated with a private connection, the connection must first be broken and then recreated by purehost connect or purevol connect. See the purehgroup-connect man page for further discussion of shared connections.
LUN Management
Hosts address I/O commands to volumes via the volumes' logical unit numbers (LUNs). The current Purity release supports two disjoint LUN ranges:
[1...9]
Used only for private connections.
[10...255]
Always used for shared connections (see purehgroup(1)). May be used for private connections to hosts that are not associated with host groups.
If the --lun option is not specified in a purehost connect or purevol connect command directed to a host with no host group association, Purity assigns the lowest available LUN in the [1...255] range. For private connections to hosts that are associated with host groups, Purity assigns the lowest available LUN in the [1...9] range.
If multiple hosts are specified in a single purehost connect command, there is no guarantee that the same LUN will be associated with each connection established.
When LUN and host are both specified in a purehost connect or a purevol connect command, exactly one host and one volume must be specified.
A host cannot be associated with a host group while it has private connections to volumes that utilize LUNs in the [10...255] range. Any such connections must be broken and re-established using LUNs in the [1...9]
range before the host can be added to a host group.
purehost-connect
Exceptions
Purity does not establish a private connection between a host and a volume if:
• No LUN in the appropriate range is available (i.e., not being used by another connection).
• The --lun option is specified, and the specified LUN is not available.
• The --lun option is specified, with a value that is not in the appropriate range (e.g., in the [10...255]
range in a connection to a host associated with a host group).
• A specified host already has either a private or a shared connection to a specified volume.
Examples
Example 1
purevol connect --host HOST1 VOL1 VOL2
Establishes private connections between HOST1 and VOL1 and between HOST1 and VOL2. Purity assigns a LUN to each connection. If HOST1 is associated with a host group, the LUNs will be the lowest available in the range [1...9]; if not, Purity will use the lowest available LUNs in the range [1...255].
Example 2
purehost connect --vol VOL3 --lun 4 HOST2 purevol connect --host HOST2 --lun 5 VOL4
Establishes private connections between HOST2 and VOL3 and between HOST2 and VOL4. If LUN 4 or LUN 5 is already in use by another connection to HOST2, the corresponding connection fails.
Example 3
purehgroup setattr --addhost HOST2 HGROUP1 purehost connect --vol VOL5 --LUN 1 HOST2
purevol connect --host HOST2 VOL6 VOL7 VOL8 VOL9 VOL10 VOL11 VOL12
Assuming that LUNs 4 and 5 are in use per the preceding example, LUN 0 is used by a previously made connection (for example, to a boot volume), and that no other LUNs in the range [1...9] are in use by HOST2, this example associates HOST2 with HGROUP1, forcing all private connections to use LUNs in the range [1...9]. The second command establishes a private connection between HOST2 and volume VOL5, using LUN 1. The third command connects VOL6, VOL7, VOL8, VOL9, VOL10, and VOL11, assigning LUNs 2, 3, 6, 7, 8, and 9 respectively. Because no more LUNs in the appropriate range are available, the private connection to VOL12 fails.
See Also
purehost(1), purehost-list(1)
purehost-connect
purehgroup(1), purevol(1)
Author
Pure Storage Inc. <[email protected]>
Name
purehost-list, purehost-listobj — display information about Purity host objects, host-volume connections, and storage provisioning and consumption.
Host object for which the information specified by options is to be displayed.
Options
Options that control information displayed:
-h | --help
Can be used with any command or subcommand to display a brief syntax description.
default (no content option specified with purehost list)
Displays associated worldwide names and host groups for the specified hosts.
--all (purehost list only)
Displays all visible attributes of the specified hosts. See DESCRIPTION section below for a list of attributes displayed.
--connect (purehost list only)
Displays volumes connected to the specified hosts and the LUNs used to address them.
--private (purehost list connect only)
Restricts the list or display of volumes connected to specified hosts to those with private connections.
Invalid when combined with other options.
--shared (purehost list connect only)
Restricts the display of volumes connected to specified hosts to those with shared connections. Invalid when combined with other options.
--space (purehost list only)
Displays size and space consumption information items listed below for each volume connected to a specified host.
--type (purehost listobj only)
Specifies the type of information about specified hosts that is to be produced in whitespace-separated format suitable for scripting.
Options that control display format:
--cli
Displays specified information in the form of CLI commands that could be issued to assign the current values to the specified attributes. Not meaningful when combined with non-settable attributes.
purehost-list
--csv
Lists information in comma-separated value format. This format is designed for importation into spreadsheets and for scripting.
--notitle
Suppresses generation of an initial line of output containing column titles.
--nvp
Lists each argument's name and specified information items, one to a line, in the form ITEM-NAME=VALUE. Argument names and information items are displayed flush left. This format is de-signed both for convenient viewing of what might otherwise be wide listings, and for parsing individ-ual items separated by whitespace for insertion into scripts.
Description
The purehost list command displays the information indicated by content options for the specified hosts.
If no hosts are specified, the display includes the specified information for all hosts. The information to be displayed is specified by including one of the following options:
• If no options are specified, displays names, associated worldwide names and host groups for specified hosts.
• If the --all option is specified, displays all visible attributes of the specified hosts. Display includes associated worldwide names, host groups, connected volumes and the LUNs used to address them, array port worldwide names through which the volumes are visible.
• If the --connect option is specified, displays volumes associated with the specified hosts, and the LUNs used to address them.
• If the --space option is specified, displays the following information about provisioned (virtual) size and physical storage consumption for each volume connected to the specified hosts:
Size
Size of the volume as perceived by host storage administration tools.
Data Reduction
Ratio of unique volume sectors containing host-written data to the physical storage space currently occupied by the data after reduction.
System
Amount of physical storage space occupied by RAID-3D and other array metadata.
Volumes
Amount of physical storage space currently occupied by host-written data (exclusive of array meta-data or snapshots).
Snapshots
Amount of physical storage space currently occupied by data unique to one or more snapshots.
Total
Amount of physical storage space currently occupied by host-written data and the array metadata that describes and protects it.
By default, space consumption for all connected volumes, both private and shared, is displayed. The display can be restricted to volumes with private or shared connections by specifying the --private or the --shared option.
purehost-list
The purehost listobj command produces lists of certain attributes of specified hosts in either whitespace or comma-separated form, suitable for scripting. The command produces one of four types of lists:
--type host (default if --type option not specified)
List contains the specified host names. If no host names are specified, contains the names of all host objects.
--type iqn
List contains the IQNs associated with each specified host. If no hosts are specified, list contains all IQNs (administratively assigned and discovered) known to the array.
--type vol
List contains the volumes connected to the specified hosts. If no hosts are specified, list contains names of all volumes connected to any host. List can be restricted to show only private connections by specifying the --private option.
--type wwn
List contains the worldwide names associated with each specified host. If no hosts are specified, list contains all worldwide names (administratively assigned and discovered) known to the array.
Lists are whitespace-separated by default. Specify the --csv option to produce a comma-separated list.
Exceptions
None.
Examples
Example 1
purehost list --connect
Displays names, connected volumes and logical units for all hosts. Both private and shared volume con-nections are displayed.
Example 2
purehost list
Displays names, associated worldwide names, and associated host groups (if any) for all hosts.
Example 3
purehost list --space --private --csv --notitle HOST1 HOST2 HOST3
Displays the above mentioned virtual and physical space consumption for volumes associated with each of HOST1, HOST2, and HOST3.
purehost-list
Example 4
purevol list --space $(purehost listobj --type vol HOST1 HOST2)
The inner purehost listobj command produces a whitespace-separated list of the volumes connected to HOST1 and HOST2. The outer purevol list command displays space consumption for the volumes spec-ified in the inner command.
Example 5
purehost listobj --type vol --private HOST1 HOST2
Lists all volumes with private connections to HOST1 and HOST2.
Example 6
purevol list --connect --private $(purehost listobj --type vol HOST1)
The inner purehost listobj command produces a list of the volumes to which HOST1 is connected. The list is input to the purevol list command to display all hosts with private connections to those volumes.
See Also
purehost(1), purehost-connect(1) purehgroup(1), purevol(1)
Author
Pure Storage Inc. <[email protected]>
Name
purehw — displays information about and controls visual identification of FlashArray hardware compo-nents
Synopsis
purehw list [--all] [ --csv | --nvp ] [--notitle] [--type COMPONENT-TYPE] [COMPONENT...]
purehw setattr [ --id ID | --identify {off | on} ] COMPONENT...
Arguments
COMPONENT
Hardware component whose information is to be displayed or whose attribute is to be set to the spec-ified value.
Options
-h | --help
Can be used with any command or subcommand to display a brief syntax description.
--all
Includes additional information in the display that is primarily of use to Pure Storage Technical Sup-port representatives.
--id
Integer identifier for the component. Valid for storage shelves, whose front panel LED identifiers are settable by the purehw setattr command (as well as by manipulation of the button on the panel).
--identify
Turns a visual identifier for the component on or off. Valid for drives, storage shelves, and controllers.
--type
Type of component for which information is to be displayed. When this option is specified, informa-tion is displayed for all components of the specified type. Valid values for --type are: ct (controller), bay (drive bay), eth (Ethernet port), fan (fan), fc (Fibre Channel port), ib (Infiniband port), pwr (power supply), sas (SAS port), tmp (temperature sensor), sh (storage shelf), and drv (drive).
--csv
Lists information in comma-separated value format. This format is designed for importation into spreadsheets and for scripting.
--notitle
Suppresses generation of an initial line of output containing column titles.
--nvp
Lists each argument's name and specified information items, one to a line, in the form ITEM-NAME=VALUE. Argument names and information items are displayed flush left. This format is de-signed both for convenient viewing of what might otherwise be wide listings, and for parsing individ-ual items separated by whitespace for insertion into scripts.
Description
Most FlashArray hardware components are capable of reporting their operational status. In addition, con-trollers, drive bays, and storage shelves can be configured to identify themselves visually by flashing LEDs
purehw
or showing numbers in LED displays respectively. The purehw list command displays information about specified hardware components (when no components are specified, information about all components is displayed). The purehw setattr command controls visual identification of specified controllers, storage shelves, and storage shelf drive bays.