End User Agreement, Version 2.5
5. Service Limitations
The Maintenance and Support Fee does not include, nor will Pure be obligated to provide, services re-quired as a result of: (a) any modification, reconfiguration or maintenance of the Product not performed in accordance with Pure's instructions; (b) any use of the Product in a configuration or on a system that does not meet Pure's minimum standards for such Product, as set forth in the applicable documentation;
or (c) any errors or defects in third party software or hardware.
Author
Pure Storage Inc. <[email protected]>
Name
puremonitor — displays I/O performance information for specified volumes
Synopsis
puremonitor [--csv] [--interval SECONDS] [--nrep REPEAT-COUNT] [--size] [--total] [--vollist VOL-LIST]
Options
--csv
Lists information in comma-separated value format. This format is designed for importation into spreadsheets and for scripting.
-h | --help
Can be used with any command or subcommand to display a brief syntax description.
--interval SECONDS
Number of seconds between display updates (defaults to 5 seconds).
--nrep REPEAT-COUNT
Number of display updates to produce. If this and the --interval option are both omitted, one display is produced. If this option is omitted, and the --interval option is specified, Purity produces displays at the specified interval until the command is terminated by typing CTRL-C.
--size
Displays the average I/O sizes per operation (read, write, and total).
--total
Follows output lines with a single line containing column totals in columns where they are meaningful.
Ignored when --nvp is specified (where permitted).
--vollist [VOL-LIST]
Comma-separated list of volumes for which to display data. If this option is omitted, data for all volumes is displayed.
Description
Note, this command is deprecated and will be removed in the future. Please use purearray monitor and purevol monitor instead.
Produces a display of array I/O performance data containing sections for the specified volumes. The display can be repeated with updated data at specified intervals by supplying values for the --nrep and/or --interval options.
For a given volume, each interval of performance information will be listed as a row that contains various columns such as: bytes per second read/write, operations per second read/write, duration per operation read/write.
Examples
Example 1
puremonitor
puremonitor --vollist --nrep 10 --interval 10 --total
Produces a display containing a line of performance data for each volume and a line that aggregates the data for all volumes. The display is updated every 10 seconds for 100 seconds. Data in the first display represents average performance since array boot time; data in subsequent displays represents average performance over the most recent 10-second interval.
Example 2
puremonitor --vollist VOL1,VOL2 --nrep 10
Produces a display containing lines of performance data for VOL1 and VOL2. The display is updated every 5 seconds (the default interval) for 50 seconds (10 repetitions).
Example 3
puremonitor --vollist `purehgroup listobj --type vol --csv HG1`
Produces a single display containing a line of performance data for each volume with a shared connection to host group HG1. The inner purehgroup listobj command produces a comma-separated list of the volumes with shared connections to HG1, which becomes the value for the --vollist option.
See Also
purearray(1), purehost(1), pureport(1), purevol(1)
Author
Pure Storage Inc. <[email protected]>
Name
purenetwork, purenetwork-disable, purenetwork-enable, purenetwork-list, purenetwork-setattr — man-ages the Ethernet interfaces used to connect a FlashArray system to an administrative network
purenetwork-ping, purenetwork-trace — pings remote destinations and traces routes on the administrative network
Synopsis
purenetwork disable ETHERNET-INTERFACE purenetwork enable ETHERNET-INTERFACE purenetwork list [--cli] [ --csv | --nvp ] [--notitle]
purenetwork ping [--count PING-COUNT] DESTINATION
purenetwork setattr [--address CIDR-IP-ADDRESS] [--address IP-ADDRESS --netmask NET-MASK] [--gateway GATEWAY-IP-ADDRESS] [--mtu MTU-SIZE] ETHERNET-INTERFACE
purenetwork trace DESTINATION
Arguments
DESTINATION
IP address or full hostname of a ping target or of a remote computer to which the network route is to be determined.
ETHERNET-INTERFACE
Name of the Ethernet interface to be operated upon in the form CTx.ETHy, where x denotes the controller (0 or 1) and y denotes the interface (0 or 1). In CLI commands, "CT" and "ETH" are case-insensitive. For example, CT0.ETH0, Ct0.Eth0, CT0.eth0, ct0.eth0, and so forth, all refer to controller CT0's right-hand ETH0 port.
Options
-h | --help
Can be used with any command or subcommand to display a brief syntax description.
--address {CIDR-IP-ADDRESS | IP-ADDRESS}
IPv4 address to be associated with the specified interface. IP addresses may be specified in CIDR format (ddd.ddd.ddd.ddd/dd), or alternatively, the --netmask option may be used along with the --address option to specify the netmask in ddd.ddd.ddd.ddd format.
--count PING-COUNT
Number of ICMP ping messages to send in sequence.
--gateway GATEWAY-IP-ADDRESS
IPv4 address of the gateway through which the specified interface is to communicate with the network (in ddd.ddd.ddd.ddd format).
--mtu MTU-SIZE
Maximum message transfer unit (packet) size for the interface in bytes. Valid values are integers between 1280 and 9216 (inclusive). Defaults to 1500 if not specified.
purenetwork
--netmask NETMASK
Netmask in ddd.ddd.ddd.ddd format. Used in conjunction with --address when the IP address is not specified in CIDR format.
--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
Manages an array's Ethernet interfaces and administrative network connection attributes.
Each FlashArray controller is equipped with two 1-gigabit Ethernet interfaces that connect to a data center network for array administration. The interfaces are called CTx.ETH0 and CTx.ETH1, where x denotes the array controller number (0 for FA-310 models and 0 or 1 for FA-320 models). Physical interface ports are located on controller rear bulkheads, and are labeled ETH1 (left) and ETH0 (right).
The purenetwork enable and purenetwork disable subcommands enable and disable individual Ethernet interfaces. Care should be taken not to disable the interface through which the administrative session is being conducted.
The purenetwork list subcommand displays the visible attributes of specified Ethernet interfaces (or of all interfaces if none is specified explicitly).
The purenetwork ping subcommand is used to determine whether a remote computer can be accessed by the array (provided that the remote computer is ICMP-enabled). The ping target can be specified either by IP address, or if DNS service is available and has been configured for the array, by hostname.
The IP address, netmask, and gateway for each Ethernet interface can be specified individually by the purenetwork setattr command. Ethernet interface IP addresses and netmasks are set explicitly (i.e., DHCP is not supported), along with the corresponding netmasks. Netmasks can be specified either in CI-DR format, e.g.,
purenetwork setattr --address 192.168.0.25/24 CT0.ETH0
or by specifying the --netmask option, e.g.,
purenetwork setattr --address 192.168.0.25 --netmask 255.255.255.0 CT0.ETH0
Gateways are specified by IP address. To remove a port's gateway specification, specify either a null value for the --gateway option or a zero IP address. For example, either
purenetwork
purenetwork setattr --gateway '' CT0.ETH0
or
purenetwork setattr --gateway 0.0.0.0 CT0.ETH0
unassigns whatever gateway IP address had been associated with CT0.ETH0.
The purenetwork trace subcommand traces and displays the route to a remote computer identified by IP address or, if a DNS service is available and configured for the array, by hostname.
Examples
Example 1
purenetwork enable ct0.eth0
Enables controller CT0's administrative network interface ETH0 to communicate with the administrative network.
Example 2
purenetwork list
Lists the status (enabled or disabled), IP address, netmask, gateway IP address, and MAC for each of the array's administrative network interfaces. For multi-controller arrays, all controllers' interface information is listed.
Example 3
purenetwork setattr ct0.eth0 --address 192.168.0.24 --netmask 255.255.255.0 purenetwork setattr ct0.eth0 --address 192.168.0.24/24
Assigns the IP address 192.168.0.24 to administrative Ethernet interface ct0.eth0. Both commands are equivalent.
Example 4
purenetwork ping --count 100 myhost.mydomain.com
Sends 100 ICMP ping messages to host myhost.mydomain.com and displays the response received for each one.
purenetwork
Example 5
purenetwork trace 192.168.0.1
Displays the route taken by a ping request to network address 192.168.0.1.
See Also
purearray(1)
Author
Pure Storage Inc. <[email protected]>
Name
pureport, pureport-disable, pureport-enable, pureport-list — manages an array's host connection ports
Synopsis
pureport disable pureport enable
pureport list [--initiator] [ --csv | --nvp ] [--notitle]
Options
-h | --help
Can be used with any command or subcommand to display a brief syntax description.
--initiator
Displays host worldwide names (both those discovered by Purity and those assigned by administra-tors) and the array ports (targets) on which they are eligible to communicate.
--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 pureport enable and pureport disable subcommands enable and disable communication with hosts via an array's ports.
The pureport list subcommand with no option specified displays the worldwide names assigned to an array's ports. Array port worldwide names are assigned by Purity when controllers are manufactured, and cannot be changed. When the --initiator option is specified, the display includes all host worldwide names known to the array, either through discovery or through administrator assignment, and the array ports on which they are eligible to communicate.
The pureport list output does not include information about administrative network Ethernet ports--see purenetwork(1).
Examples
Example 1
pureport disable