N Commands
node-info
This command displays information about the local node switch in the fabric.
Syntax node-info
Defaults None.
Access CLI
History Command introduced in Version 1.2.
Usage To show information about a local switch node in the fabric, use this command.
Examples Use the following command to display node information:
CLI network-admin@switch > node-info
CLI (network-admin@pubdev03) > node-info
name: pubdev03
fab-name: TAC
mgmt-ip: 10.9.100.50/16
mgmt-vnet:
in-band-ip: 192.168.42.30/24
in-band-vnet:
in-band-vlan-type: public
fab-tid: 66
cluster-tid: 8
out-port: 0
version: 2.4.204019818,pn-nvOS-2.4.1-2040112371
state: online
firmware-upgrade: not-required
device-state: ok
node-show
This command displays information about all nodes in the fabric. This command can only be invoked at the network-administrator access level.
Syntax node-show
name fabric-node-name |
Specifies the name of the fabric node to display information. |
id id-string |
Specifies the identifier for the fabric node |
serial serial-string |
Specifies the serial string for the fabric node |
fab-name fab-name |
Specifies the name of the fabric node |
fab-id |
Specifies the fabric identifier |
cluster-id |
Specifies the cluster identifier. |
local-mac mac-address |
Specifies the local MAC address of the fabric |
fabric-network in-band|mgmt|vmgmt |
Specifies the interface for sending fabric packets. |
mgmt-vnet vnet-name |
Specifies the management VNET. |
mgmt-public-vlan vlan-id |
Specifies the management public VLAN ID. |
mgmt-ip ip-address |
Specifies the IP address for the management NIC |
mgmt-netmask netmask] |
The netmask for the IP address |
mgmt-mac mac-address |
Specifies the MAC address for the management interface. |
vmgmt-ip ip-address |
Specifies the IP address of the virtual management interface. |
vmgmt-netmask netmask |
Specifies the netmask of the virtual management interface. |
vmgmt-mac mac-address |
Specifies the MAC address of the virtual management interface. |
vmgmt-vnet vnet name |
Specifies the VNET name for the virtual management interface. |
vmgmt-vlan vlan-id |
Specifies the VLAN ID of the virtual management interface. |
vmgmt-public-vlan vlan-id |
Specifies the public VLAN for the virtual management interface. |
vmgmt-secondary-macs secondary-macs-string |
Specifies the secondary MAC address of the virtual management interface. |
mgmt-secondary-macs secondary-mac-string |
Specifies the secondary MAC address for the management interface. |
in-band-ip ip-address |
Specifies the IP address for the in-band interface to the switch control plane. |
in-band-netmask netmask |
Specifies the netmask for the in-band interface to the switch control plane. |
in-band-mac mac-address |
Specifies the MAC address for the in-band interface to the switch control plane. |
in-band-vnet vnet-name |
Specifies the in-band VNET. |
in-band-vlan vlan-id |
Specifies the VLAN identifier for the in-band interface to the switch control plane can be reached on Layer 2. |
in-band-vlan-type public|private |
Specifies the in-band VLAN type as public or private. |
in-band-public-vlan vlan-id |
Specifies the public VLAN ID. |
in-band-secondary-macs secondary-mac-string |
Specifies the secondary MAC address for the in-band interface. |
fab-tid fab-tid-number |
Specifies the fabric identifier. |
cluster-tid cluster-tid-number] |
Specifies the cluster identifier. |
out-port out-port-number |
Specifies the port number where the switch multicasts the fabric discovery messages to other Pluribus Networks switch. |
version version-string |
Specifies the current OS version. |
state offline|online|in-band-only-online|mgmt-only- |
Specifies the state of the fabric. |
firmware_upgrade not-required|required| |
Specifies if a firmware upgrade is required. |
device_state ok|error|simulator |
Specifies the state of the switch. |
ports ports-number |
Specifies the port list used by the fabric. |
keepalive-timeout high resolution time: #n |
Specifies the keepalive timeout. |
Defaults None.
Access network-admin
History .
Version 1.2 |
Command introduced. |
Version 2.3 |
The parameter, fab-mcast, deprecated. |
Version 2.4.1 |
The parameters, mgmt-vnet, mgmt-public-vlan, in-band-vnet, in-band-vlan-type, and in-band-public-vlan added. The options, in-band-only-online and mgmt-only-online, added to the parameter, state. |
Version 2.6.2 |
The parameters, vmgmt-* and keepalive, added. |
Usage To show information about all switch nodes on the network, use this command. This command is useful if you have a node that hasn’t joined a fabric and you want to view all nodes on the network. This command is not available at the VNET manager access level.
Examples Use the following command to display node information:
CLI network-admin@switch > node-show
id: 167772387
name: pubdev03
fab-name: TAC
fab-id: a0000e3:57c0c0ea
cluster-id: a000024:1
local-mac: 64:0e:94:28:03:56
fabric-network: in-band
control-network: in-band
mgmt-ip: 10.9.100.50/16
mgmt-mac: 64:0e:94:28:03:58
mgmt-vnet:
mgmt-public-vlan: 0
mgmt-secondary-macs:
in-band-ip: 192.168.42.30/24
in-band-mac: 64:0e:94:28:03:56
in-band-vnet:
in-band-vlan: 0
in-band-vlan-type: public
in-band-public-vlan: 0
in-band-secondary-macs:
fab-tid: 66
cluster-tid: 8
out-port: 0
version: 2.4.204019818,pn-nvOS-2.4.1-2040112371
state: online
firmware-upgrade: not-required
device-state: ok
ports: 72
nv-queue-stats-clear
This command is used to clear high priority packets such as LACP, LLDP, ARP, and STP. This is useful when you want to see how the packet queues are used and troubleshoot the operating system based on this information.
Syntax nv-queue-stats-clear
name nv-queue-stats-list name |
Specify the name of the queue. |
Defaults None
Access CLI
History Command introduced in Version 2.4
Usage Use this command to clear the statistics collection settings for packet queues.
Examples To clear statistics collection for packet queues, use the following syntax:
CLI network-admin@switch > nv-queue-stats-clear name nv-queue-stats-list name
nv-queue-stats-show
This command is used to display ONVL high priority packets such as LACP, LLDP, ARP, and STP. This is useful when you want to see how the packet queues are used and troubleshoot ONVL based on this information.
Syntax nv-queue-stats-show
time date/time: yyyy-mm-ddThh:mm:ss |
Specify the time to start the statistic collection. |
start-time date/time: yyyy-mm-ddThh:mm:ss |
Specify the start time of to statistic collection. |
end-time date/time: yyyy-mm-ddThh:mm:ss |
Specify the end time of statistic collection. |
duration duration: #d#h#m#s |
Specify the duration of statistic collection. |
interval duration: #d#h#m#s |
Specify the interval between statistic collection. |
since-start |
Specify the statistics collected since the start time. |
older-than duration: #d#h#m#s |
Specify the statistics older than the initial time. |
within-last duration: #d#h#m#s |
Specify the statistics collected within the last time. |
name nv-queue-stats-list name |
Specify the name of the queue. |
q-high q-high-number |
Specify to display the highest count in queue. |
q-low q-low-number |
Specify to display the lowest count in queue. |
q-max q-max-number |
Specify to display the maximum queue size. |
q-in q-in-number |
Specify to display the number of items inserted into queue |
q-out q-out-number |
Specify to display the number of items removed from queue. |
q-delay-high high resolution time: #ns |
Specify to display the highest delay from insertion to removal from the queue. |
q-delay-samples q-delay-samples-number |
Specifies number of delay samples queue. |
q-delay-avg high resolution time: #ns |
Specifies average sampled delay from insertion to removal. |
q-overflow q-overflow-number |
Specifies if insertion failed because queue was full. |
q-underflow q-underflow-number |
Specifies that the allocation failed because queue was empty. |
Defaults None
Access CLI
History
Version 2.2.5 |
Command introduced. |
Version 2.3.1 |
The parameters, q-delay-avg, q-overflow, and q-underflow added. |
Usage Use this command to modify the statistics collection settings for packet queues.
Examples To disable statistics collection for ONVL packet queues, use the following syntax:
CLI network-admin@switch > nv-queue-stats-show since-start format all layout vertical
switch: pubdev01
time: 12-07,10:08:00
name: eventq-guaranteed-0
q-high: 1
q-low: 0
q-max: 0
q-in: 1
q-out: 1
switch: pubdev01
time: 12-07,10:08:00
name: eventq-guaranteed-1
q-high: 1
q-low: 0
q-max: 0
q-in: 23
q-out: 23
q-delay-high: 63.1us
switch: pubdev01
time: 12-07,10:08:00
name: eventq-guaranteed-cache
q-high: 512
q-low: 503
q-max: 8192
q-in: 63
q-out: 63
nv-queue-stats-settings-modify
This command is used to modify the parameters to collect high priority packets such as LACP, LLDP, ARP, and STP into a receiving queue on the CPU. This is useful when you want to see how the packet queues are used and troubleshoot the operating system based on this information.
Syntax nv-queue-stats-settings-modify
enable|disable |
Enable or disable statistics collection. |
interval duration: #d#h#m#s |
Modify the interval to collect statistics. |
disk-space disk-space-number |
Modify the disk-space allocated for statistics. |
Defaults None
Access CLI
History Command introduced in Version 2.2.5.
Usage Use this command to modify the statistics collection settings for the operating system packet queues.
Examples To disable statistics collection for nvOS packet queues, use the following syntax:
CLI network-admin@switch > nv-queue-stats-settings-modify disable
nv-queue-stats-settings-show
This command is used to display the parameters used to collect high priority packets such as LACP, LLDP, ARP, and STP into a receiving queue on the CPU. This is useful when you want to see how the packet queues are used and troubleshoot nvOS based on this information.
Syntax nv-queue-stats-settings-show
Defaults None
Access CLI
History Command introduced in Version 2.2.5.
Usage Use this command to display the statistics collection settings for nvOS packet queues.
Examples To display statistics collection for nvOS packet queues, use the following syntax:
CLI network-admin@switch > nv-queue-stats-settings-show
switch: pubdev01
enable: yes
interval: 1m
disk-space: 50M