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-
online|fabric_joined|setup-required|fabric-
required| fresh-install]

Specifies the state of the fabric.

firmware_upgrade

not-required|required|
reboot-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