Skip to main content
Pure1 Support Portal

puredrive

Name

puredrive — displays information about an array's flash modules and NVRAM modules

Synopsis

puredrive list [ --csv | --nvp ] [--notitle] [--page] [--raw] [--spec] [--total] [DRIVE...]

Arguments

DRIVE

Name of a flash module or NVRAM module about which information is to be displayed. Includes the shelf identifier (for example SH1.BAY0, which designates the module in bay #0 of storage shelf #1).

Options

-h | --help

Can be used with any command or subcommand to display a brief syntax description.

--spec

Displays hardware specifications for the module.

--total

Follows output lines with a single line containing column totals in columns where they are meaningful.

Options that control display format:

--csv

Lists information in comma-separated value (CSV) format. The --csv output can be used for scripting purposes and imported into spreadsheet programs.

--notitle

Lists information without column titles.

--nvp

Lists information in name-value pair (NVP) format, in the form ITEMNAME=VALUE. Argument names and information items are displayed flush left. The --nvp output is designed both for convenient viewing of what might otherwise be wide listings, and for parsing individual items for scripting purposes.

--page

Turns on interactive paging.

--raw

Displays the unformatted version of column titles and data. For example, in the purearray monitor output, the unformatted version of column title us/op (read) is usec_per_read_op. The --raw output is used to sort and filter list results.

Description

Lists information about an array's flash modules (used for persistent storage of user data) and NVRAM modules (used as non-volatile write cache). If no modules are specified, lists information about all flash and NVRAM modules on the array.

The information listed for flash and NVRAM modules includes:

Name

Name by which Purity identifies the module in administrative operations. Flash and NVRAM module names identify physical locations in terms of shelf and bay numbers.

Type

SSD (data storage) or NVRAM (write cache).

Status

The Status column contains one of the following:

empty

No flash module or NVRAM module is installed in the bay.

healthy

The module is functioning and belongs to this array.

identifying

The module is functioning, but is not yet initialized as a FlashArray module.

unrecognized

The module is initiated as a FlashArray module and is functioning, but does not belong to this array. For example, this status is seen when a module is pulled from one FlashArray and mistakenly placed into another FlashArray.

failed

The module belongs to this array, but does not respond to I/O commands. Purity is evacuating or has evacuated data off the module.

Capacity

Physical storage capacity of the module.

Evac Remaining

For a missing module, the amount of data that remains to be evacuated (reconstructed and stored on other flash modules).

Last Failure

Time at which a module became non-responsive.

Last Evac Completed

Time at which the evacuation of data from a non-responsive module completed.

Protocol

Storage protocol, such as NVMe and SAS. Must include the --spec option to display the Protocol column.

Empty Bays, and Present and Missing Modules

The puredrive list output displays the following information:

Present Module

A flash or NVRAM module that is physically present in an array's storage shelves.

Indicated by its location (as a hardware component name, such as SH0.BAY0) in the Name column.

Missing Module

A flash or NVRAM module that is physically present but undergoing data evacuation (to be reconstructed and stored at other locations within the array).

Indicated by an empty Name column entry.

Note: Missing modules are removed from the display when the evacuation of their data completes.

Empty Bay

A storage bay that does not contain a flash module, or an NVRAM bay that does not contain an NVRAM module.

Indicated by a hyphen ('-') in the Type column and empty in the Status column.

Examples

Example 1

puredrive list SH0.BAY5
      

Lists information for the flash module in BAY5 of shelf SH0.

Example 2

puredrive list CH0.NVB1
      

Lists information for the NVRAM module in NVRAM bay 1 of shelf CH0 (does not apply to FA-300 and FA-400 systems).

See Also

n/a

Author

Pure Storage Inc.