Alternate Command Format

The CLI has an alternate command format in that the commands start with a verb instead of a noun. This format omits the hyphen in the command names. For example, connection-stats-show can also be entered as show connection-stats. The command formats have the same features and can be used interchangeably.

Specifying IP Address Netmasks

Some commands call for the specification of an IP address netmask. Pluribus Networks Netvisor OS supports both CIDR and subnet notations.

For example, the range of IP addresses from 192.168.0.0 to 192.168.0.255 can be specified by either entering 192.160.0.0 for the IP address input for a CLI command or either 24 or 255.255.255.0 for the netmask.

Specifying Measurement Units

Many commands include input and output of capacity and throughput. Network values are always in bits and storage values in bytes. Scale factors are allowed on input and displayed in output as well as shown in Table 3, “Scale Numbers”.

Table 3: Scale Numbers

Scale Indicator

Meaning (Networking)

Meaning (Storage)

K or k

Kilobits

Kilobytes

M or m

Megabits

Megabytes

G or g

Gigabits

Gigabytes

T or t

Terabits

Terabytes

Customizing Show Output Formats

The output generated by the show commands can be customized by using the optional arguments described in Table 4, “Show Output Formats”.

Table 4: Show Output Formats

format <column_name1>, <column_name2>, <column_nameX>

Displays only the columns matching the list of column header names.

NOTE: The list of column names is comma-separated without spaces.

format all

Displays all available column headers. This output is also called verbose mode.

By default, show commands output a terse set of the most commonly useful column headers.

parsable-delim <separator>

Displays the output of show command by separating columns by the specified <separator> character(s).

For example, parsable-delim , produces a comma-separated output (CSV).

NOTE: If the parsable-delim option is specified, the column header names (titles) are suppressed from the output.

Specifying a Switch or Fabric for Command Scope

While a switch is the building block of a fabric, the goal of the Netvisor OS design is that a fabric of switches is easy to manage as a single switch. Because of this, the CLI can be used to run commands on the local switch, a cluster of switches, other switches in the fabric, or the entire fabric. You don’t have to log into each switch that you want to run commands.

By default, commands are run on the switch you are logged into and for example, the command port-config-modify port 5 disable disables port 5 on the switch you are logged into on the network.

To specify a different switch for a single command, use the switch prefix. For example, switch pleiades23 port-config-modify port 28 enable enables port 28 on pleiades23, even if the CLI is connected to a different switch in the fabric.

To specify a different switch for a series of commands, use the switch prefix with no command. For example, type switch pleiades24 <return>. The CLI prompt changes to indicate that pleiades24 is the switch you are executing commands. Additional commands are run on pleiades24 rather than the switch that you’re physically connected.

For most CLI show commands, the command displays results from all switches in the fabric by default. For example, when the CLI command port-show is entered on the switch, it shows the ports of all switches in the fabric.

To specify that a CLI show command should apply to a specific switch, use the switch prefix to the CLI command. For example, for the port-show command to only show the ports of the switch named pleiades24, type the command switch pleiades24 port-show.