Download Netvisor nvOS - Pluribus Networks

Netvisor nvOS
Command Reference A – O Version 2.3.2
January 2016
pluribusnetworks.com/dell
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE
WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO
BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE
FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE
INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF
YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR PLURIBUS
NETWORKS REPRESENTATIVE FOR A COPY.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE ARE PROVIDED “AS IS”
WITH ALL FAULTS. PLURIBUS NETWORKS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR
ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL PLURIBUS NETWORKS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL
DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA, ARISING OUT OF THE
USE OR INABILITY TO USE THIS MANUAL, EVEN IF PLURIBUS NETWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES.
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples,
command display output, and figures included in the document are shown for illustrative purposes only. Any use of
actual IP addresses in illustrative content is unintentional and coincidental.
© 2016 PLURIBUS NETWORKS, INC. ALL RIGHTS RESERVED.
Pluribus Networks nvOS Version 2.3.2
i
ii
Pluribus Networks nvOS Version 2.3.2
Table of Contents
Table of Contents .............................................................................................................................. i
nvOS Introduction ............................................................................................................................ 1
A Commands..................................................................................................................................... 11
aaa-tacacs-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
aaa-tacacs-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
aaa-tacacs-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
aaa-tacacs-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
aaa-tacacs-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
acl-ip-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
acl-ip-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
acl-ip-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
acl-ip-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
acl-mac-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
acl-mac-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
acl-mac-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
acl-mac-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
admin-ipmi-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
admin-ipmi-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
admin-service-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
admin-service-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
admin-sftp-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
admin-sftp-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
admin-syslog-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
admin-syslog-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
admin-syslog-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
admin-syslog-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
admin-syslog-match-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
admin-syslog-match-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
admin-syslog-match-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
admin-syslog-match-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
api-install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
B Commands ..................................................................................................................................... 69
bootenv-activate-and-reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
bootenv-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
bootenv-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
C Commands ..................................................................................................................................... 75
client-server-stats-clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
client-server-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
client-server-stats-clear-history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
cluster-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
cluster-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
cluster-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
cluster-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
connection-clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
connection-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
connection-clear-history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
connection-latency-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
connection-stats-clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
Pluribus Networks nvOS Version 2.3.2
i
connection-stats-clear-history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
connection-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
control-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
control-stats-setting-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
control-stats-setting-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
D Commands .................................................................................................................................. 119
dhcp-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
dhcp-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
dhcp-migrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
dhcp-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
dhcp-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
dhcp-host-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
dhcp-host-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
dhcp-host-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
dhcp-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
dhcp-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
dhcp-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141
dhcp-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
dhcp-lease-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
dhcp-pool-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151
dhcp-pool-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
dhcp-pool-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
dhcp-pool-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157
dhcp-pxe-menu-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
dhcp-pxe-menu-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
dhcp-pxe-menu-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
dhcp-pxe-menu-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167
disk-library-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
disk-library-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
disk-library-image-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173
disk-library-image-clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
disk-library-image-export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
disk-library-image-import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179
disk-library-image-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181
disk-library-image-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
disk-library-imports-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
dns-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187
dns-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
dns-migrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
dns-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
dns-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
dns-domain-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197
dns-domain-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199
dns-domain-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
dns-domain-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
dns-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
dns-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
dns-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
dns-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
dns-record-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
dns-record-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
dns-record-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
Pluribus Networks nvOS Version 2.3.2
ii
E Commands ................................................................................................................................... 219
ecp-port-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
F Commands ................................................................................................................................... 223
fabric-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223
fabric-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
fabric-join . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
fabric-local-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
fabric-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231
fabric-unjoin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
fabric-node-evict . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
fabric-node-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
fabric-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241
fabric-upgrade-abort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243
fabric-upgrade-continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245
fabric-upgrade-finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247
fabric-upgrade-prepare-cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
fabric-upgrade-prepare-resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
fabric-upgrade-prepare-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253
fabric-upgrade-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
fabric-upgrade-status-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
firmware-upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259
flow-table-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
H Commands .................................................................................................................................. 265
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
hw-nat-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .267
hw-nat-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269
hw-nat-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
hw-nat-loopback-port-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273
hw-nat-map-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .275
hw-nat-map-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
hw-nat-map-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
hw-nat-port-forward-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
hw-nat-port-forward-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
hw-nat-port-forward-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285
hw-nat-session-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287
hw-nat-static-nat-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289
hw-nat-static-nat-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291
hw-nat-static-nat-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293
I Commands .................................................................................................................................... 295
id-led-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
id-led-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .297
igmp-router-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
igmp-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
igmp-snooping-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303
igmp-snooping-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
igmp-static-group-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
igmp-static-group-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309
igmp-static-group-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
igmp-static-source-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
igmp-static-source-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
igmp-static-source-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
Pluribus Networks nvOS Version 2.3.2
iii
igmp-static-source-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319
igmp-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
interface-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
ip-pool-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
ip-pool-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
ip-pool-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
ip-pool-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331
iso-library-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333
iso-library-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .335
iso-library-image-export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337
iso-library-image-import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339
iso-library-image-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341
iso-library-image-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
L Commands ................................................................................................................................... 345
l2-history-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
l2-setting-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .351
l2-setting-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353
l2-static-multicast-group-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355
l2-static-multicast-group-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .357
l2-static-multicast-group-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .359
l2-table-flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .361
l2-table-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .363
l3-history-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369
l3-setting-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375
l3-setting-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .377
l3-table-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .379
lacp-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .381
lacp-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .383
lldp-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .385
log-alert-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .387
log-audit-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .389
log-event-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393
log-event-settings-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .397
log-event-settings-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .399
log-system-counters-reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401
log-system-counters-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .403
log-system-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405
M Commands ................................................................................................................................. 409
mcast-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409
metadata-provider-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .411
mirror-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413
mirror-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .415
mirror-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .417
mirror-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419
mld-router-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .421
mld-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .423
mld-snooping-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .425
mld-snooping-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .427
mld-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429
mld-static-group-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431
mld-static-group-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .433
mld-static-group-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435
Pluribus Networks nvOS Version 2.3.2
iv
mld-static-source-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .437
mld-static-source-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .439
mld-static-source-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .441
N Commands .................................................................................................................................. 443
nat-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .443
nat-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .445
nat-migrate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .447
nat-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449
nat-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .451
nat-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .453
nat-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .455
nat-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457
nat-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .459
nat-map-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .463
nat-map-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .465
nat-map-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .467
nat-port-forward-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .469
nat-port-forward-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .471
nat-port-forward-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .473
nat-static-nat-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .475
nat-static-nat-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .477
nat-static-nat-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .479
netvisor-kvm-clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .481
netvisor-kvm-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .483
netvisor-kvm-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .485
netvisor-kvm-failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .487
netvisor-kvm-kill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .489
netvisor-kvm-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .491
netvisor-kvm-reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .493
netvisor-kvm-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .495
netvisor-kvm-shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .499
netvisor-kvm-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .501
netvisor-kvm-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .503
netvisor-kvm-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .505
netvisor-kvm-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .507
netvisor-kvm-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .509
netvisor-vm-clone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .513
netvisor-vm-console-login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .515
netvisor-vm-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .517
netvisor-vm-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .519
netvisor-vm-failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .521
netvisor-vm-kill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .523
netvisor-vm-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .525
netvisor-vm-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .527
netvisor-vm-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .531
netvisor-vm-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .533
netvisor-vm-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .535
netvisor-vm-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .537
netvisor-vm-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .539
netvisor-zone-console-login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .541
netvisor-zone-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .543
netvisor-zone-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .545
Pluribus Networks nvOS Version 2.3.2
v
netvisor-zone-login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .547
netvisor-zone-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .549
netvisor-zone-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .551
netvisor-zone-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .553
netvisor-zone-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .555
netvisor-zone-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .557
netvisor-zone-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .559
node-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .561
node-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .563
nv-queue-stats-settings-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .567
nv-queue-stats-settings-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .569
nv-queue-stats-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .571
O Commands .................................................................................................................................. 575
openflow-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .575
openflow-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .577
openflow-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .579
openflow-connection-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .581
openflow-connection-disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .583
openflow-connection-enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .585
openflow-connection-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .587
openflow-connection-restart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .589
openflow-connection-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .591
openflow-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .593
openflow-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .595
openflow-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .597
openflow-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .599
openstack-config-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .601
openstack-config-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .603
openstack-config-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .605
openstack-config-node-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .607
openstack-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .609
openstack-controller-create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .613
openstack-controller-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .615
openstack-controller-shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617
openstack-controller-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .619
openstack-controller-storage-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .621
openstack-interface-add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .623
openstack-interface-modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .625
openstack-interface-remove . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .627
openstack-interface-show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .629
openstack-plugin-install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .633
Pluribus Networks nvOS Version 2.3.2
vi
nvOS Introduction
This chapter provides information for understanding and using the Pluribus Networks nvOS command line interface
(CLI) on a Pluribus Networks switch. Included in this chapter is the following information:
 Before You Start
 Important Terms
 Entering Commands and Getting Help
 Finding Command Options
 Understanding Role-based Access Control
 Specifying IP Address Netmasks
 Specifying Capacity, Throughput, and Scale
 Customizing Show Output Formats
 Using the CLI String Search
 Specifying a Switch or Fabric for Command Scope
Before You Start
Pluribus Netvisor uses the concept of Fabric-Cluster to describe the interconnectivity of devices into a single logical
network. The concept of a virtual network (VNET) describes is a “slice” of resources that apply to a single entity with
assigned resources within the fabric. The VNET contains services and resources that apply only to that VNET.
Typically, VNETs are used to house different tenants within a single large network. For switches with nvOS, the only
available VNET is a global VNET created when a fabric is created for the first time.
Since you are just getting started with your switches and Netvisor, you may decide to configure a single switch first
or you may have purchased a single switch. It’s important to understand that a single switch can consist of a single
fabric and a single VNET, or many switches and VNETs.
Important Terms
The following list of important terms and concepts and their definitions is important for understanding Pluribus
Networks features and determine the best configuration to meet your needs.
Term
Meaning
API
Application Programming Interface to the Pluribus Networks switch.
It has a similar scope as the CLI.
CLI
Command Line Interface to the Pluribus Networks switch. Depending
on the command, it can be executed for an individual switch, a
cluster, or a fabric.
Cluster
A pair of Pluribus Networks switches configured as a high availability
group. You can configure many clusters in the fabric, but a switch can
be a member of only one cluster.
Disk-library
Virtual machine storage within a storage pool.
eth0...ethX
Virtual network interface names associated with virtual services.
Fabric
A set of Pluribus Networks switches configured as a single entity. Any
switch can be a member of only one fabric. Up to 4096 switches can
be configured a single fabric.
Pluribus Networks nvOS Version 2.3.2
1
Term
Meaning
Flow
A communication from one device outside of the fabric to another
device outside of the fabric and traveling through the fabric.
GUI
Graphic User Interface to the Pluribus Networks switch. It has a
similar scope as the CLI.
In-band Management
Address
The IP address of the switch on a production or management
network for administration and inter-switch communication.
ISO- library
ISO (operating system) image storage within a storage pool
LACP
Link Aggregation Control Protocol allows a non-Pluribus Networks
device to have multiple connections to the same switch, for example,
IEEE 802.3ad trunks.
Netvisor Zone, Netvisor
KVM, Netvisor VMM
A virtual machine running within the Pluribus Networks switch. A
NetZone runs natively on the Unix-compatible operating system. A
NetVM allows the use of arbitrary x86 operating systems and
applications.
Server-switch
A Pluribus Networks hardware device with aspects of both a server
and a switch.
Storage-device
Disk or PCI-based storage connected to the switch.
Storage-pool
Storage in a RAID set available for use by storage commands.
Storage-folder
General purpose file sharing system available within a storage pool.
vFlow
A logical, manageable connection within or through the fabric.
VLAG
Virtual Link Aggregation Group is the Pluribus Networks method for
multiple connecting hosts to multiple switches, switches to each
other, and switches to other switches.
VNET
A virtual network configured within the fabric. All traffic within one
VNET segregated from the traffic of all other VNETs. A VNET is an
administrative entity as well, limiting the effects of changes to a
single VNET. Everything in a Pluribus Networks server is associated
with a VNET.
Entering Commands and Getting Help
Commands, options, and arguments are entered at the CLI prompt. A command name must be typed, but included
command-completion and help features contribute to the command entry process.
To display a list of command that you can use within a command mode, enter a question mark (?), or use the tab
key, or type help at the command prompt. You can also display keywords and arguments for each command with
this context-sensitive help feature. You can also use complete commands and display keywords and arguments for
each command using the tab key to assist with context-sensitive command help and completion.
2
Pluribus Networks nvOS Version 2.3.2
Table 1 lists the command that you can enter to get help specific to a command, keyword, or argument.
Table 1: Getting Help
abbreviated- command-entry?
Displays a list of commands that begin with a specific
character string. Do not leave a space between the string
and question mark.
abbreviated- command-entry <tab>
Completes a partial command name.
?
Lists all commands.
command ?
Lists all keywords for the command. Leave a space
between the command and the question mark.
command keyword ?
Lists all arguments for the keyword. Leave a space
between the command and the question mark.
Where a text string is used, such as name-string, the following characters are allowed as part of the text string:
a-z, A-Z, 0-9, _ (underscore), . (period), , (comma), : (colon), and - (dash).
Informational Note: If you enter a command that is invalid, then using the ? and tab key have no effect and
do not return any changes to the CLI.
Informational Note: The CLI has an editing ability similar to UNIX and Linux functionality using emacs keys.
For example, ˄p steps backward through previous commands, ˄n moves to the next command in the history, ˄a
moves to the first character in the command and ˄e moves to the end of the line, ˄u erases the current line, and
˄w erases the previous word.
Informational Note: Also you can use the up and down arrows on your keyboard to retrieve the last
command entered at the CLI.
Finding Command Options
The syntax can consist of optional or required keywords. To display keywords for a command, enter a question mark
(?) at the command prompt or after entering part of a command followed by a space. nvOS® CLI displays a list of
available keywords along with a brief description of the keywords. For example, if you want to see all of the
keywords for the command user, enter user ?.
Table , “Getting Help” displays examples of using the question mark (?) to assist you with entering commands.
Pluribus Networks nvOS Version 2.3.2
3
Table 2: Finding Command Options
CLI network-admin@switch > ?
All commands:
acl-ip-create
acl-ip-delete
...
Displays a list of commands that begin with a specific
character string. Do not leave a space between the string
and question mark.
Switch> user auth
User: <user>
Password: <password>
Completes a partial command name.
?
Lists all commands.
command ?
Lists all keywords for the command. Leave a space
between the command and the question mark.
command option ?
Lists all arguments for the option. Leave a space between
the command and the question mark.
Informational Note: Other useful options, especially for displaying statistics, include sort, interval,
duration, and show diff interval.
Additional Information on the Command Line Interface
For some commands, the parameter delete is used, and in other commands, the parameter remove is used. This
may appear as inconsistent usage, but the explanation is quite simple.
delete is used for top level commands, such as acl-ip-delete, or vlan-delete. The following list is a
sample of top level commands:
 aaa-tacacs-delete
 dhcp-delete
 ip-pool-delete
 nat-delete
remove is used for commands with additional options, such as iso-library-image-remove where the top
level command is iso-library and the additional option image is added to the top level command. The
following list is a sample of top level commands with additional parameters that use remove:
 dhcp-host-remove
 disk-library-image-remove
 dns-interface-remove
 sflow-port-remove
4
Pluribus Networks nvOS Version 2.3.2
The same logic also applies to the usage of create and add. create is used for top level commands and add is
used with top level commands with additional options. For example, sflow-create and sflow-port-add are
two instances where this usage occurs in the CLI.
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.
Understanding Role-based Access Control
Pluribus Networks nvOS® supports flexibly defined roles so that data centers can use the same best practices for
managing discrete servers, storage, and networks to operate a Pluribus Networks fabric. You can create user roles
with privileges that reflect user responsibilities in the data center. For example, you can create the following types of
roles:
 Fabric administrator roles with control over all fabric-wide tasks
 Cluster administrator roles with control over all cluster-wide tasks
 Switch-server administrator roles with control over single switch configuration tasks
 Virtual Network (VNET) administrator roles with control over one or multiple VNET configuration tasks
 Virtual network services administrator with control over one or multiple network service(s) configuration tasks.
Specifying IP Address Netmasks
Some commands call for the specification of an IP address netmask. Pluribus Networks nvOS 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 Capacity, Throughput, and Scale
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
Pluribus Networks nvOS Version 2.3.2
5
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.
Using the CLI String Search
The pattern in the command output is referred to as a string. The CLI string search feature allows you to search or
filter any show or more command output and allows you to search and filter at --More-- prompts. This feature is
useful when you need to sort through large amounts of output, or if you want to exclude output that you don’t want
to see.
With the search function, you can begin unfiltered output at the first line that contains a specified regular
expression. You can then specify a maximum of one filter per command or start a new search from the --More-prompt.
You can perform three types of filtering:
Use the begin keyword to begin output with the line that contains a specified regular expression.
Use the include keyword to include output lines containing a specified regular expression.
Use the exclude keyword to exclude output lines containing a specified regular expression.
6
Pluribus Networks nvOS Version 2.3.2
You can then search this filtered output at the --More-- prompts.
Most commands optionally preceded by integer argument k. Defaults in brackets. Star
(*) indicates argument becomes the new default.
---------------------------------------------------------------<space>
Display next k lines of text [current screen size]
z
Display next k lines of text [current screen size]
<return.
Display next k lines of text [1]*
d or ctrl-D
Scroll k lines [current scroll size, initally 11]*
q or Q or ,interrupt>
Exit from more
s
Skip forward k lines of text [11]
f
Skip forward k screenfuls of text [1]
b or ctrl-b
Skip backwards k screenfuls of text [1]
‘
Go to place where previous search started
=
Display current line number
/<regular expression>
Search for kth occurrence of regular expression [1]
n
Search for kth occurrence of last r.e. [1]
h
Display this message
ctrl-l
Redraw the screen
:n
Go to kth next file [1]
:p
Go to kth previous file [1]
.
Repeat previous command
For example, to only display output that includes the IP address, 10.9.9, type the following at the --More-prompt:
/10.9.9<return>
Informational Note:
The CLI search function does not allow you to search or filter backward through previous
output.
Specifying a Switch or Fabric for Command Scope
While a switch is the building block of a fabric, the goal of the Pluribus Networks 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’re logged into and for example, the command
port-config-modify port 5 disable disables port 5 on the switch you’re 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.
Pluribus Networks nvOS Version 2.3.2
7
Topic Feedback
Was this topic useful to you? Please provide feedback to improve the content.
8
Pluribus Networks nvOS Version 2.3.2
Pluribus Networks nvOS® Command Changes
This chapter contains a list of nvOS® commands that are deprecated in Version 2.3.2 and earlier.
If you are familiar with Version 1.2 and 2.0 of nvOS®, this chapter is useful when upgrading from either
version to Version 2.3.2.
Table 5: Deprecated Commands
Command
Version 2.0
netvm-create
netvm-delete
netvm-interface-add
netvm-interface-modify
netvm-interface-remove
netvm-interface-show
netvm-kill
netvm-modify
netvm-reset
netvm-show
netvm-shutdown
netvm-start
netzone-create
netzone-delete
netzone-interface-add
netzone-interface-modify
netzone-interface-remove
netzone-interface-show
netzone-modify
netzone-show
port-mirror-modify
port-mirror-show
sflow-port-show
sftp-files-show
Version 2.1
factory-reset
hw-nat-loopback-port-modify
router-cached-routes-show
router-if-create
Pluribus Networks nvOS Version 2.3.1
9
Table 5: Deprecated Commands
Command
router-if-delete
router-if-show
tunnel-vxlan-add
tunnel-vxlan-remove
tunnel-vxlan-show
Version 2.2
cluster-modify
netvisor-vmmVersion 2.3.1
openstack-
Early Access Feature Commands
Early access features are available for early adopters who want to test drive features that are still in
development. Table 6 lists the commands for early access features.
Table 6: Early Access Feature Commands
Commands for OpenFlow 1.3
openvswitch-controller-add
openvswitch-controller-remove
openvswitch-controller-show
openvswitch-create
openvswitch-create
openvswitch-modify
openvswitch-show
openvswitch-start
The following is a listing of all commands in alphabetical order including command history, usage, and
examples.
Pluribus Networks nvOS Version 2.3.1
10
A Commands
aaa-tacacs-create
This command is used to add a TACACS+ server for authorization and authentication on the network.
Syntax aaa-tacacs-create name name-string scope fabric|local [server
server-string] [port port-number] [secret secret-string]
[timeout timeout-number][priority priority-number]
[authen|no-authen] [authen-method pap|chap|ms-chap]
[sess-acct|no-sess-acct] [cmd-acct|no-cmd-acct]
[sess-author|no-sess-author] [cmd-author|no-cmd-author]
name name-string
Specify the name, up to 60 characters, of the TACACS service.
scope fabric|local
Specify the scope to apply to the TACACS server.
server server-string
Specify the name, up to 60 characters, of the TACACS server.
port port-number
Specify the port that connects to the server. The default port is
49.
secret secret-string
Specify the secret (password) to access the server.
timeout timeout-number
Specify the number of seconds for the server to time out a
request. The default value is 10 seconds.
priority
priority-number
Specify the priority for the server. The priority can be 1 (highest)
to X (lowest priority).
authen|no-authen
Specify if the server authenticates clients on the network.
authen-method
pap|chap|ms-chap
Specify the authentication method for clients. PAP, CHAP, and
MS-CHAP are supported methods with CHAP as the default
method.
sess-acct|
no-sess-acct
Specify if you want to use session accounting. The TACACS+
server is notified when a user logs in or out of the network.
cmd-acct|
no-cmd-acct
Specify if you want to use command accounting. The TACACS+
server is notified when ever a user, including the network
administrator, runs a non-show command.
sess-author|
no-sess-author
Specify if you want to use session authorization. The TACACS+
server configured for session authorization determines if a user
can initiate a session on the network after logging in.
cmd-author|
no-cmd-author
Specify if you want to use command authorization. The TACACS+
server determines if a user can run certain commands on the
network.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to allow a TACACS+ server authenticate and authorize clients on the network.
The TACACS+ can also provide accounting for sessions and commands.
Pluribus Networks nvOS Version 2.3.2
11
Examples To add the TACACS+ server, TACserver1, with scope local on port 33 and secret, p@ssw0rd, use
the following commands:
CLI network-admin@switch > aaa-tacacs-create name TACserver1 scope local
port 33 p@ssw0rd
To add the authentication method, MS-CHAP, use the following command:
CLI network-admin@switch > aaa-tacacs-create name TACserver1
authen-method ms-chap
See Also
aaa-tacacs-delete
aaa-tacacs-modify
aaa-tacacs-show
Pluribus Networks nvOS Version 2.3.2
12
aaa-tacacs-delete
This command is used to remove a TACACS+ server from the configuration.
Syntax aaa-tacacs-delete name name-string
name name-string
Specify the name of the TACACS+ server to remove from the
configuration.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to remove a TACACS+ server.
Examples To remove the TACACS+ server, TACserver1, use the following command:
CLI network-admin@switch > aaa-tacacs-delete name TACserver1
See Also
aaa-tacacs-create
aaa-tacacs-modify
aaa-tacacs-show
Pluribus Networks nvOS Version 2.3.2
13
Pluribus Networks nvOS Version 2.3.2
14
aaa-tacacs-modify
This command is used to modify a TACACS+ server configuration on the network.
Syntax aaa-tacacs-modify name name-string scope fabric|local [server
server-string] [port port-number] [secret] [timeout
timeout-number][priority priority-number] [authen|no-authen]
[authen-method pap|chap|ms-chap] [sess-acct|no-sess-acct]
[cmd-acct|no-cmd-acct] [sess-author|no-sess-author]
[cmd-author|no-cmd-author]
Specify the name of the TACACS service.
name name-string
Specify one or more of the following options to modify:
scope fabric|local
Specify the scope to apply to the TACACS server.
server server-string
Specify the name of the TACACS server.
port port-number
Specify the port that connects to the server.
secret secret-string
Specify the secret (password) to access the server.
timeout timeout-number
Specify the number of seconds for the server to time out a
request. The default value is 10 seconds.
priority
priority-number
Specify the priority for the server. The priority can be 1 (highest)
to X (lowest priority).
authen|no-authen
Specify if the server authenticates clients on the network.
authen-method
pap|chap|ms-chap
Specify the authentication method for clients. PAP, CHAP, and
MS-CHAP are supported methods.
sess-acct|
no-sess-acct
Specify if you want to use session accounting. The TACACS+
server is notified when a user logs in or out of the network.
cmd-acct|
no-cmd-acct
Specify if you want to use command accounting. The TACACS+
server is notified when ever a user, including the network
administrator, runs a non-show command.
sess-author|
no-sess-author
Specify if you want to use session authorization. The TACACS+
server configured for session authorization determines if a user
can initiate a session on the network after logging in.
cmd-author|
no-cmd-author
Specify if you want to use command authorization. The TACACS+
server determines if a user can run certain commands on the
network.
Defaults None.
Access CLI.
History Command introduced in nvOS Version 1.2.
Usage Use this command to modify how a TACACS+ server authenticates and authorizes clients on the
network. The TACACS+ can also provide accounting for sessions and commands.
Examples To modify the TACACS+ server, TACserver1, and change the secret, p@ssw0rd, to m0nk3ys,
use the following commands:
CLI network-admin@switch > aaa-tacacs-create name TACserver1 secret
@m0nk3ys
aaa-tacacs-create
Pluribus Networks nvOS Version 2.3.2
15
aaa-tacacs-delete
aaa-tacacs-show
Pluribus Networks nvOS Version 2.3.2
16
aaa-tacacs-show
Use this command to display the configuration parameters of the TACACS+ server.
Syntax aaa-tacacs-show name name-string scope fabric|local [server
server-string] [port port-number] [secret secret-string]
[timeout timeout-number][priority priority-number]
[authen|no-authen] [authen-method pap|chap|ms-chap]
[sess-acct|no-sess-acct] [cmd-acct|no-cmd-acct]
[sess-author|no-sess-author] [cmd-author|no-cmd-author]
name name-string
Specifies the name of the TACACS service.
scope fabric|local
Specifies the scope to apply to the TACACS server.
server server-string
Specify the name of the TACACS server.
port port-number
Specifies the port that connects to the server.
secret secret-string
Specifies the secret (password) to access the server.
timeout timeout-number
Specifies the number of seconds for the server to time out a
request. The default value is 10 seconds.
priority
priority-number
Specifies the priority for the server. The priority can be 1
(highest) to X (lowest priority).
authen|no-authen
Specifies if the server authenticates clients on the network.
authen-method
pap|chap|ms-chap
Specifies the authentication method for clients. PAP, CHAP, and
MS-CHAP are supported methods.
sess-acct|
no-sess-acct
Specifies if you use session accounting. The TACACS+ server is
notified when a user logs in or out of the network.
cmd-acct|
no-cmd-acct
Specifies if you use command accounting. The TACACS+ server is
notified when ever a user, including the network administrator,
runs a non-show command.
sess-author|
no-sess-author
Specifies if you use session authorization. The TACACS+ server
configured for session authorization determines if a user can
initiate a session on the network after logging in.
cmd-author|
no-cmd-author
Specifies if you use command authorization. The TACACS+ server
determines if a user can run certain commands on the network.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
Pluribus Networks nvOS Version 2.3.2
17
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI.
History Command introduced in nvOS Version 1.2.
Usage Use this command to display information about a TACACS+ server
Examples To display the information about a TACACS+ server, use the following command:
CLI network-admin@switch > aaa-tacacs-show layout vertical
See Also
aaa-tacacs-create
aaa-tacacs-delete
aaa-tacacs-modify
Pluribus Networks nvOS Version 2.3.2
18
aaa-tacacs-status
This command is used to display the status of the TACACS+ service.
Syntax aaa-tacacs-status name name-string
name name-string
Specify the name of the TACACS service.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
Usage Use this command to display TACACS status.
Examples To display the status of tacacs-service, use the following command:
CLI network-admin@switch > aaa-tacacs-status name tacacs-service
See Also
aaa-tacacs-create
aaa-tacacs-delete
aaa-tacacs-modify
aaa-tacacs-show
Pluribus Networks nvOS Version 2.3.2
19
Pluribus Networks nvOS Version 2.3.2
20
acl-ip-create
Use this command to create an IP address for an Access Control List (ACL). ACLs are rules that you apply
to allow or deny access to hosts or IP addresses.
Syntax acl-ip-create name string [action permit | deny] [scope local |
fabric] [src-ip ip-address] [src-ip-mask netmask] [dst-ip
ip-address dst-ip-mask netmask] [proto [tcp|udp|icmp|ip]]
[src-port src-port-number] [dst-port dst-port-number] [vlan
vlan-id] [port port-number]
name string
Specifies the name of the ACL.
action
permit | deny
Specifies the permission of the ACL to be either permit or deny.
scope
local|fabric
Specifies the scope of the ACL.
Then at least one of the following options:
src-ip ip-address
Specifies the source IP address of the ACL.
src-ip-mask netmask
Specifies the source IP mask of the ACL.
dst-ip ip-address
Specifies the destination IP address of the ACL.
dst-ip-mask netmask
Specifies the destination IP mask of the ACL.
Then any of the following options:
proto [tcp|udp|icmp|
ip
Specifies the protocol flag filter of the ACL.
src-port src-port-number
Specifies the source port number.
dst-port dst-port-number
Specifies the destination port number
vlan vlan-id
Specifies the VLAN to apply the ACL.
port port-number]
If the scope is local, specifies the switch port of the ACL.
Defaults None
Access CLI
History Command introduced in Version 1.2.
Usage IP ACLs can be used to filter network traffic. Use this command to create a new IP ACL.
Informational Note: The source or destination IP address/mask of
0.0.0.0/255.255.255.255 means any.
The source or destination IP address/mask of 208.74.182.229/0.0.0.0 is the same as
“host 208.74.182.229”.
Examples This example shows how to create a fabric-wide ACL named MyWebACL allowing HTTP
traffic (port 80) from any host to the web server with IP address 208.74.182.229.
CLI network-admin@switch > ip-acl-create name MyWebACL action permit
scope fabric src-ip 0.0.0.0 src-msk 255.255.255.255 dst-ip
208.74.182.229 dst-msk 0.0.0.0 prot tcp src-port 80 dst-port 80
See Also
acl-ip-delete
Pluribus Networks nvOS Version 2.3.2
21
acl-ip-modify
acl-ip-show
Pluribus Networks nvOS Version 2.3.2
22
acl-ip-delete
Use this command to delete an ACL from the network configuration.
Syntax acl-ip-delete name string id number
name string
Specify the name of the ACL.
id number
Specify the identifier assigned to the ACL.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Deletes an ACL from the existing network configuration.
Examples To delete the ACL, net-traffic, use the following command:
CLI network-admin@switch > acl-ip-delete net-traffic
See Also
acl-ip-create
acl-ip-modify
acl-ip-show
Pluribus Networks nvOS Version 2.3.2
23
Pluribus Networks nvOS Version 2.3.2
24
acl-ip-modify
This command allows you to change an existing ACL rule on the switch.
Syntax acl-ip-modify name name-string id id_num [action permit|deny]
[src-ip ip-address] [src-ip-mask netmask] [dst-ip ip-address
dst-ip-mask netmask] [proto [tcp|udp|icmp|ip]] [src-port
src-port-number] [dst-port dst-port-number] [vlan vlan-id] [port
port-number]
name name-string
Specifies the name of the ACL.
id
Specifies the ID assigned by ONVL to the ACL.
The following parameter is optional:
action
permit | deny
Specifies the permission of the ACL to be either permit or deny.
src-ip ip-address
Specifies the source IP address of the ACL.
src-ip-mask netmask
Specifies the source IP mask of the ACL.
dst-ip ip-address
Specifies the destination IP address of the ACL.
dst-ip-mask netmask
Specifies the destination IP mask of the ACL.
Then any of the following options:
proto [tcp|udp|icmp|
ip
Specifies the protocol flag filter of the ACL.
src-port
src-port-number
Specifies the source port number.
dst-port
dst-port-number
Specifies the destination port number
vlan vlan-id
Specifies the VLAN to apply the ACL.
port port-number]
If the scope is local, specifies the switch port of the ACL.
Defaults None.
Access network-admin
History
Version 1.2
Command introduced.
Version 2.3.0
Added the parameters to modify the ACL.
Usage Use this command to modify an existing IP ACL.
Examples To modify the ACL, net-traffic, from deny to permit, use the following command:
CLI network-admin@switch > acl-ip-modify net-traffic action permit
See Also
acl-ip-create
acl-ip-delete
acl-ip-show
Pluribus Networks nvOS Version 2.3.2
25
Pluribus Networks nvOS Version 2.3.2
26
acl-ip-show
Use this command to display information about ACLs configured on the switch.
Syntax acl-ip-show name string id [action permit|deny] [proto
tcp|udp|icmp|igmp|ip] [src-ip ip-address src-ip-mask netmask]
[src-port src-port-number] [dst-ip ip-address] dst-ip-mask
netmask] [dst-port dst-port-number] [vlan vlan-id] [scope
local|fabric] [port port-number]
name string
Specifies the name of the ACL.
id
Species the ID assigned to the ACL.
action
permit | deny
Specifies the permission of the ACL to be either permit or deny.
scope
local|fabric
Specifies the scope of the ACL.
src-ip ip-address
Specifies the source IP address of the ACL.
src-ip-mask netmask
Specifies the source IP mask of the ACL.
dst-ip ip-address
Specifies the destination IP address of the ACL.
dst-ip-mask netmask
Specifies the destination IP mask of the ACL.
protocol
[tcp|udp|icmp|ip
Specifies the protocol flag filter of the ACL.
src-port
src-port-number]
Specifies the source port number.
dst-port
dst-port-number
Specifies the destination port number
vlan vlan-id
Specifies the VLAN to apply the ACL.
port port-number
If the scope is local, specifies the switch port of the ACL.
Formatting Options
To format the output for this command, use the formatting options:
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
Pluribus Networks nvOS Version 2.3.2
27
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Displays the list of IP ACLS in the configuration. .
Informational Note: The source or destination IP address/mask of
0.0.0.0/255.255.255.255 means any.
The source or destination IP address/mask of 208.74.182.229/0.0.0.0 is the same as
“host 208.74.182.229”.
Examples This example shows how to list all IP ACLs.
CLI network-admin@switch > acl-ip-show
name
slot
id action
port
prot
sip
smsk
sprt
dip
dmsk
dprt
vlan
scope
unit
test1 54147812341841995 deny udp 192.192.100.100 0.0.0.0 20 192.168.1.100
0.0.0.0 40 0 local 0 0 0
test2 54147812341841996 deny udp 192.192.100.100 0.255.255.255 20
192.168.1.100 0.0.255.255 40 0 local 0 0 0
See Also
acl-ip-create
acl-ip-delete
acl-ip-modify
Pluribus Networks nvOS Version 2.3.2
28
acl-mac-create
This command is used to create Access Control Lists (ACLs) based on MAC addresses.
Syntax acl-mac-show name name-string action permit|deny [src-mac
mac-address] [src-mac-mask mac-address] [dst-mac mac-address]
[dst-mac-mask mac-address] [ether-type
ipv4|arp|wake|rarp|vlan|ipv6|mpls-uni|mpls-multi|jumbo|aoe|dot1X
|lldp|ecp|macsec|ptp|fcoe|fcoe-init|qinq] [vlan vlan-id] [scope
local|fabric] [port port-number]
name string
Specifies the name of the ACL.
action permit|deny
Specifies the permission of the ACL to be either permit or deny.
src-mac mac-address
Specifies the source MAC address of the ACL. The value can be any to
match all MAC addresses
src-mac-mask
mac-address
Specifies the source MAC address mask.
dst-mac mac-address
Specifies the destination MAC address of the ACL. The value can be
any to match all MAC addresses.
dst-mac-mask
mac-address
Specifies the destination MAC address mask.
Specifies the EtherType value.
ether-type
ipv4|arp|wake|rarp|
vlan|ipv6|mpls-uni|
mpls-multi|jumbo|aoe|
dot1X|lldp|lacp|ecp|
macsec|ptp|fcoe|fcoe-in
it|qinq
vlan vlan-id
Specifies the VLAN identifier.
scope
local|fabric|cluster
Specifies the scope of the ACL.
port port-number
Specifies the switch port number.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage MAC access control lists (ACLs) can be used to filter network traffic. This command creates a new
ACL.
Examples This example shows how to create a fabric-wide ACL named MyMacACL allowing IPv4 traffic
from the host with the MAC address e0:f8:47:14:3c:2e to any host.
CLI network-admin@switch > mac-acl-create name MyMacACL action permit
scope fabric src e0:f8:47:14:3c:2e dst any type ipv4
See Also
• acl-mac-delete
• acl-mac-modify
• acl-mac-show
Pluribus Networks nvOS Version 2.3.2
29
Pluribus Networks nvOS Version 2.3.2
30
acl-mac-delete
This command is used to delete an existing MAC ACL from the switch.
Syntax acl-mac-delete name name-string id acl-id
name string
Specify the name of the ACL to delete.
id acl-id
Specify the ACL identifier. This is automatically generated by
ONVL.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage MAC access control lists (ACLs) can be used to filter network traffic. This command deletes an
existing MAC ACL.
Examples To delete the MAC ACL named MyMacACL, use the following command:
CLI network-admin@switch > acl-mac-delete name MyMacACL
See Also
acl-mac-create
acl-mac-modify
acl-mac-show
Pluribus Networks nvOS Version 2.3.2
31
Pluribus Networks nvOS Version 2.3.2
32
acl-mac-modify
This command is used to modify Access Control Lists (ACLs) based on MAC addresses.
Syntax acl-mac-show name name-string id action permit|deny [src-mac
mac-address] [src-mac-mask mac-address] [dst-mac mac-address]
[dst-mac-mask mac-address] [ether-type
ipv4|arp|wake|rarp|vlan|ipv6|mpls-uni|mpls-multi|jumbo|aoe|dot1X
|lldp|ecp|macsec|ptp|fcoe|fcoe-init|qinq] [vlan vlan-id] [scope
local|fabric] [port port-number]
name name-string
Specifies the name of the ACL.
id
Specifies the ID generated by ONVL. Press Tab to see a list of
identifiers.
Specify one or more of the following options:
action permit|deny
Specifies the permission of the ACL to be either permit or deny.
src-mac mac-address
Specifies the source MAC address of the ACL. The value can be
any to match all MAC addresses
src-mac-mask
mac-address
Specifies the source MAC address mask.
dst-mac mac-address
Specifies the destination MAC address of the ACL. The value can
be any to match all MAC addresses.
dst-mac-mask
mac-address
Specifies the destination MAC address mask.
Specifies the EtherType value.
ether-type
ipv4|arp|wake|rarp|
vlan|ipv6|mpls-uni|
mpls-multi|jumbo|aoe|
dot1X|lldp|lacp|ecp|
macsec|ptp|fcoe|fcoe-in
it|qinq
vlan vlan-id
Specifies the VLAN identifier.
scope
local|fabric|cluster
Specifies the scope of the ACL.
port port-number
Specifies the switch port number.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.3.2
Added new parameters to modify the ACL.
Usage MAC access control lists (ACLs) can be used to filter network traffic. This command modifies an
existing ACL.
Examples This example shows how to modify the fabric-wide ACL named MyMacACL with the action
permit.
CLI network-admin@switch > mac-acl-modify name MyMacACL action permit
Pluribus Networks nvOS Version 2.3.2
33
See Also
acl-mac-create
acl-mac-delete
acl-mac-show
Pluribus Networks nvOS Version 2.3.2
34
acl-mac-show
Displays information about the ACLs using MAC addresses as a parameter.
Syntax acl-mac-show name name-string id action permit|deny [src-mac
mac-address] [src-mac-mask mac-address] [dst-mac mac-address]
[dst-mac-mask mac-address] [ether-type
ipv4|arp|wake|rarp|vlan|ipv6|mpls-uni|mpls-multi|jumbo|aoe|dot1X
|lldp|ecp|macsec|ptp|fcoe|fcoe-init|qinq] [vlan vlan-id] [scope
local|fabric] [port port-number
name name-string
Specifies the name of the ACL.
id
Specifies the ID generated by ONVL.
action permit|deny
Specifies the permission of the ACL to be either permit or deny.
src-mac mac-address
Specifies the source MAC address of the ACL. The value can be any to
match all MAC addresses
src-mac-mask
mac-address
Specifies the source MAC address mask.
dst-mac mac-address
Specifies the destination MAC address of the ACL. The value can be
any to match all MAC addresses.
dst-mac-mask
mac-address
Specifies the destination MAC address mask.
Specifies the EtherType value.
ether-type
ipv4|arp|wake|rarp|
vlan|ipv6|mpls-uni|
mpls-multi|jumbo|aoe|do
t1X|lldp|lacp|ecp|
macsec|ptp|fcoe|fcoe-in
it|qinq
vlan vlan-id
Specifies the VLAN identifier.
scope local|fabric
Specifies the scope of the ACL.
port port-number
Specifies the switch port number.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
Pluribus Networks nvOS Version 2.3.2
35
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage MAC access control lists (ACLs) filter network traffic. This command displays a list of MAC ACLs.
Examples This example shows how to list all MAC ACLs.
CLI network-admin@switch > mac-acl-show
name
id
action src dst type vlan scope
port
MyMacACl 54147812341841957 deny e0:f8:47:14:3c:2e ff:ff:ff:ff:ff:ffipv4 0
local 0
See Also
acl-mac-create
acl-mac-delete
acl-mac-modify
Pluribus Networks nvOS Version 2.3.2
36
admin-ipmi-modify
This command is used to modify parameters for Intelligent Processor Management Interface (IPMI). This
command does not require that you first create a fabric before using the command to modify the
parameters.
Syntax admin-ipmi-modify [enable|disable] [addr-type static|dhcp] [ip
ip-address] [netmask netmask] [gateway-ip ip-address]
ipmi-password ipmi-password-string]
Specify one or more of the following options:
enable|disable
Enable or disable IPMI.
addr-type static|dhcp
Specify if the IP address is static or obtained by DHCP.
ip ip-address
Specify the IP address.
netmask netmask
Specify the netmask of the IP address.
gateway-ip ip-address
Specify the IP address of the gateway.
ipmi-password
ipmi-password-string
If applicable, specify a password for IPMI.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IPMI is used to monitor and perform maintenance on the switch. Use this command to enable or
disable the service.
Examples To enable IPMI on the switch, use the following command:
CLI network-admin@switch > admin-ipmi-modify enable
See Also
admin-ipmi-show
admin-service-modify
admin-service-show
admin-sftp-modify
admin-sftp-show
admin-syslog-create
admin-syslog-delete
admin-syslog-modify
admin-syslog-show
admin-syslog-match-add
admin-syslog-match-modify
admin-syslog-match-remove
admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
37
Pluribus Networks nvOS Version 2.3.2
38
admin-ipmi-show
This command is used to display parameters for Intelligent Processor Management Interface (IPMI).
Syntax admin-ipmi-show
Formatting Options Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Display information about IMPI
Examples To display information about IPMI, use the following command:
CLI network-admin@switch > admin-ipmi-show layout vertical
switch:
enable:
addr-type:
ip:
gateway-ip:
mac:
user:
pleiades24
enable
static
10.11.9.167/16
10.11.9.1
00:25:90:9d:B3:25
admin
See Also
Pluribus Networks nvOS Version 2.3.2
39
admin-ipmi-modify
admin-service-modify
admin-service-show
admin-sftp-modify
admin-sftp-show
admin-syslog-create
admin-syslog-delete
admin-syslog-modify
admin-syslog-show
admin-syslog-match-add
admin-syslog-match-modify
admin-syslog-match-remove
admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
40
admin-service-modify
This command is used to modify services on the switch.
Syntax admin-service-modify if if-string [scope local|fabric]
[ssh|no-ssh] [nfs|no-nfs] [web|no-web] [web-ssl|no-web-ssl]
[web-ssl-port web-ssl-port-number][web-port web-port-number]
[snmp|no-snmp] [net-api|no-net-api] [icmp|no-icmp]
if if-string
Specify the interface to modify.
Specify one or more of the following options:
scope local|fabric
Specify the scope of the admin service. If you don’t specify a
scope, ONVL attempts to modify the service with the scope
fabric.
ssh|no-ssh
Specify if you want to connect to the switch using Secure Shell
(SSH).
nfs|no-nfs
Specify if you want to use Network Files System (NFS) for the
admin service.
web|no-web
Specify if you want to enable Web management.
web-ssl|
no-web-ssl
Specify if you want to use SSL and certificates for Web services.
web-ssl-port
web-ssl-port-number
Specify the Web SSL port.
web-port
web-port-number
Specify the port for Web management.
snmp|no-snmp
Specify if SNMP is allowed as a service.
net-api|no-net-api
Specify if APIs are allowed as a service.
icmp|no-icmp
Specify if Internet Control Message Protocol (ICMP) is allowed as
a service.
Defaults None
Access CLI
History Command introduced in Version 1.2.
Usage Use this command to modify administrative services on the switch.
Examples To modify the admin service to enable SNMP, use the following command:
CLI network-admin@switch > admin-service-modify if eth.0 scope fabric
snmp
See Also
• admin-service-show
• admin-sftp-modify
• admin-sftp-show
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
Pluribus Networks nvOS Version 2.3.2
41
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
42
admin-service-show
This command is used to display information about admin services configuration.
Syntax admin-service-show if if-string [scope local|fabric]
[ssh|no-ssh] [nfs|no-nfs] [web|no-web] [web-ssl|no-web-ssl]
[web-ssl-port web-ssl-port-number][web-port web-port-number]
[snmp|no-snmp] [net-api|no-net-api] [icmp|no-icmp] [ntp|no-ntp]
if if-string
Specifies the interface.
Specify one or more of the following options:
scope local|fabric
Specifies the scope of the admin service.
ssh|no-ssh
Specifies if the switch is running Secure Shell (SSH) as a service.
nfs|no-nfs
Specifies if the switch is running Network File System (NFS) as a
service.
web|no-web
Specifies if Web is running as a service.
web-ssl|
no-web-ssl
Specifies if SSL and certificates are used for Web services.
web-ssl-port
web-ssl-port-number
Specifies the Web SSL port.
web-port web-port-number Specifies the port for Web management.
snmp|no-snmp
Specifies if SNMP is running as a service.
net-api|no-net-api
Specifies if APIs are running as a service.
icmp|no-icmp
Specifies if Internet Control Message Protocol (ICMP) is running as a
service.
ntp|no-ntp
Specifies if Network Time Protocol (NTP) is running as a service.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
43
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2
Usage Use this command to display information about admin services on the switch.
Examples To display admin service information, use the following command:
CLI network-admin@switch > admin-service-show
switch
aquila11
aquila11
nic
mgmt
data
ssh
on
on
sftp
on
on
nfs
on
on
web
on
on
snmp
off
off
See Also
• admin-service-modify
• admin-sftp-modify
• admin-sftp-show
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
44
net-api
on
on
icmp
on
on
admin-sftp-modify
This command allows you to modify SFTP functionality for the administrator.
Syntax admin-sftp-modify enable|disable
Defaults Disabled.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to enable or disable secure file transport protocol (SFTP).
Examples To enable SFTP, use the following command:
CLI network-admin@switch > admin-sftp-modify enable
See Also
admin-ipmi-modify
admin-ipmi-show
admin-service-modify
admin-service-show
admin-sftp-show
admin-syslog-create
admin-syslog-delete
admin-syslog-modify
admin-syslog-show
admin-syslog-match-add
admin-syslog-match-modify
admin-syslog-match-remove
admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
45
Pluribus Networks nvOS Version 2.3.2
46
admin-sftp-show
This command allows you to display SFTP functionality for the administrator.
Syntax admin-sftp-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display SFTP functionality on the switch.
Examples Use the following command to display SFTP,
CLI network-admin@switch > admin-sftp-show
switch:
sftp-user:
pleiades24
sftp
See Also
admin-ipmi-modify
admin-ipmi-show
admin-service-modify
Pluribus Networks nvOS Version 2.3.2
47
admin-service-show
admin-sftp-modify
admin-syslog-create
admin-syslog-delete
admin-syslog-modify
admin-syslog-show
admin-syslog-match-add
admin-syslog-match-modify
admin-syslog-match-remove
admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
48
admin-syslog-create
This command is used to create the scope and other parameters of syslog event collection.
Syntax admin-syslog-create name name-string scope local|fabric host
host-string [port port-number] [message-format
structured|legacy]
name name-string
The name of the syslog file for the syslog event collection.
scope local|fabric
The scope of the syslog for the syslog event collection.
host host-string
The host name for the syslog event collection..
port port-number
The port for the syslog event collection.
message-format
structured|legacy
The message format you want to use in the syslog event
collection. The default format is legacy.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to create a syslog file.
Examples To create the syslog file, engoct12, with the scope local on port 24 and message format
structured, use the following command:
CLI network-admin@switch > admin-syslog-create name engoct12 scope
local port 24 message-format structured
See Also
admin-syslog-delete
admin-syslog-modify
admin-syslog-show
admin-syslog-match-add
admin-syslog-match-modify
admin-syslog-match-remove
admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
49
Pluribus Networks nvOS Version 2.3.2
50
admin-syslog-delete
This command is used to delete a syslog from the configuration.
Syntax admin-syslog-delete name name-string
Specify the name of the syslog file to delete.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to delete a syslog file.
Examples To delete the syslog file, eng-local, use the following command:
CLI network-admin@switch > admin-syslog-delete eng-local
See Also
• admin-syslog-create
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
51
Pluribus Networks nvOS Version 2.3.2
52
admin-syslog-modify
This command is used to modify the scope and other parameters of syslog event collection.
Syntax admin-syslog-modify [name name-string] [scope local|fabric]
[host host-string] [port port-number] [message-format
structured|legacy]
Specify the name of the syslog file to modify.
name name-string
Specify one or more of the following options:
scope local|fabric
Specify the scope of the syslog to modify
host host-string
Specify the host to modify.
port port-number
Specify the port you want to modify.
message-format
structured|legacy
Specify the message format you want to modify.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to modify an existing syslog file.
Examples To modify the port from port 24 to port 83 for syslog file, engoct12, use the following
command:
CLI network-admin@switch > admin-syslog-modify name engoct12 port 83
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
53
Pluribus Networks nvOS Version 2.3.2
54
admin-syslog-show
This command is used to display parameters about a syslog file.
Syntax admin-syslog-show name name-string scope local|fabric host
host-string port port-number message-format structured|legacy
name name-string
Specifies the name of the syslog file.
scope local|fabric
Specifies the scope of the syslog file.
host host-string
Specifies the host for the syslog file.
port port-number
Specifies the port for the syslog file.
message-format
structured|legacy
Specifies the message format for the syslog file.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display information about a syslog file.
Pluribus Networks nvOS Version 2.3.2
55
Examples Use this command to display administrative log information.
CLI network-admin@switch > admin-syslog-show
switch
name
scope host
port message-format
-------- ------ ----- -------- ---- -------------pubdev01 syslog local pubdev01 25
legacy
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
56
admin-syslog-match-add
This command is used to search a syslog file for specific events logged to it.
Syntax admin-syslog-match-add syslog-name name-string name name-string
[msg-category event|audit|system|perror][msg-program
program-string] [msg-name name-string] [msg-code code-number]
msg-level critical|error|warn|note] [msg-event-type
systm|port|tcp|stp|igmp|lldp|vdp|ecp|evb|ptp|openflow|storage|ta
cacs|openstack|mld|mroute] [msg-vnet vnet-name]
[msg-remote-switch node name][msg-user user-name] [msg-port
port-number] [msg-vlan vlan-id] [msg-vxlan vxlan-name] [name
name-string] [msg-args args-string] [msg-starting-point
starting-point-number] [msg-length length-number] [facility
kern|user|mail|daemon|auth|syslog|lpr|news|uucp|clock|security|f
tp|ntp|audit|alert|cron|local0|local1|local2|local3|local4|local
5|local6|local7] [set-severity
emerg|alert|crit|err|warning|notice|info|debug]
Specify the name of the syslog file to use for matching an event
or adding an event.
syslog-name
name-string
Specify the following match arguments:
Specify the name of the log file.
name name-string
Specify any of the following options:
msg-category
even|audit|system|perror
Specify the category of the message to match or add in the
systlog file.
msg-program
program-string
Specify the name of the program used to generate log messages.
msg-name name-string
Specify the type of message to match or add.
msg-code code-number
Specify the message code to match or add.
msg-level critical|error|
warn|note
Specify the message level to match or add.
msg-event-type
system|port|tcp|stp|
igmp|lldp||lacp|vdp|ecp|
evb|ptp|openflow|storage|
tacacs|openstack|mld|
mroute
Specify the type of event to match or add.
msg-vnet vnet-name
Specify the name of a VNET to match or add.
msg-remote-switch node
name
Specify the name of a remote switch node to match or add.
msg-user user-name
Specify user name to match or add.
msg-client-addr
ip-address
Specify the client IP address.
msg-port port-number
Specify the port to match or add.
msg-vlan vlan-id
Specify the VLAN ID to match or add.
msg-vxlan vxlan-name
Specify the VXLAN name to match or add.
Pluribus Networks nvOS Version 2.3.2
57
msg-args args-string
Specify a message argument to match or add.
msg-starting-point
starting-point-number
Specify a starting point number for a message.
msg-length length-number
Specify the length of a message.
set-facility
kern|user|mail|daemon|
auth|syslog|lpr|news|
uucp|clock|security|ftp|
ntp|audit|alert|cron|
local0|local1|local2|
local3|local4|local5|
local6|local7
Specify the facility type to match or add.
set-severity
emerg|alert|crit|err|
warning|notice|info|debug
Specify the severity of the event to match or add.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.3
The parameters, mld and mroute, added.
Usage Use this command to search a syslog file and match on a certain keyword.
Examples To add the message level critical, in the syslog file, logevents-aug13, use the
following command:
admin-syslog-match-add syslog-name logevents-aug13 msg-level critical
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-modify
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
58
admin-syslog-match-modify
This command is used to modify a syslog file for specific events logged to it.
admin-syslog-match-add syslog-name name-string name name-string
[msg-category event|audit|system|perror]
[msg-program program-string] [msg-name name-string]
[msg-code code-number] msg-level critical|error|warn|note]
[msg-event-type systm|port|tcp|stp|igmp|lldp|vdp|ecp|evb|ptp|openflow|
storage|tacacs|openstack|mld|mroute] [msg-vnet vnet-name]
[msg-remote-switch node name][msg-user user-name]
[msg-port port-number] [msg-vlan vlan-id] [msg-vxlan vxlan-name] [name
name-string] [facility
kern|user|mail|daemon|auth|syslog|lpr|news|uucp|clock|security|ftp|ntp
|audit|alert|cron|local0|local1|local2|local3|local4|local5|local6|loc
al7][severity emerg|alert|crit|err|warning|notice|info|debug]
The name of the syslog file to use for matching an event or adding an
event.
syslog-name
name-string
Specify the following match arguments:
Specify the name of the syslog file.
name name-string
Specify any of the following options:
msg-category
even|audit|system|perror
The category of the message to match or add in the systlog file.
msg-program
program-string
The name of the program used to generate log messages.
msg-name name-string
The type of message to match or add.
msg-code code-number
The message code to match or add.
msg-level
critical|error|
warn|note
The message level to match or add.
The type of event to match or add.
msg-event-type
systm|port|tcp|stp|igmp
|lldp|vdp|ecp|evb|ptp|
openflow|storage|tacacs
|openstack|mld|mroute
msg-vnet vnet-name
The name of a VNET to match or add.
msg-remote-switch node
name
The name of a remote switch node to match or add.
msg-user user-name
Us er name to match or add.
msg-port port-number
The port to match or add.
msg-vlan vlan-id
The VLAN ID to match or add.
msg-vxlan vxlan-name
The VXLAN name to match or add.
msg-args args-string
Specify a message argument to match or add.
Pluribus Networks nvOS Version 2.3.2
59
msg-starting-point
starting-point-number
Specify a starting point number for a message.
msg-length
length-number
Specify the length of a message.
msg-reverse|
no-msg-reverse
Specify if the message is reversed or not.
set-facility
kern|user|mail|
daemon|auth|
syslog|lpr|news|
uucp|clock|security|ftp|n
tp|audit|alert|cron|
local0|local1|local2|
The facility type to match or add.
local3|local4|local5|
local6|local7
The severity of the event to match or add.
set-severity
emerg|alert|crit|err|
warning|notice|info|
debug
Access CLI
History
Version 1.2
Command introduced.
Version 2.3
The parameters, mld and mroute, added.
Usage Use this command to modify a search term for a syslog file and match on a certain keyword.
Examples To modify the syslog to capture messages with the level critical, in the syslog file,
logevents-aug13, use the following command:
CLI network-admin@switch > admin-syslog-match-modify syslog-name
logevents-aug13 msg-level critical
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-remove
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
60
admin-syslog-match-remove
This command is used to remove a syslog file from the syslog match string.
Syntax admin-syslog-match-remove syslog-name name-string name
name-string
The name of the syslog file to remove from the matching string
syslog-name
name-string
Specify the following match arguments:
Specify the name of the match.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to remove a syslog match parameter.
Examples To remove the syslog file, june2012, from the matching string, use the following command:
CLI network-admin@switch > admin-syslog-match-remove june2012
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-show
Pluribus Networks nvOS Version 2.3.2
61
Pluribus Networks nvOS Version 2.3.2
62
admin-syslog-match-show
This command is used to display a syslog file for specific events logged to it.
Syntax admin-syslog-match-add syslog-name name-string
[msg-category event|audit|system]
[msg-program program-string] [msg-name name-string]
[msg-code code-number] msg-level critical|error|warn|note]
[msg-event-type
systm|port|tcp|stp|igmp|lldp|vdp|ecp|evb|ptp|openflow|storage|
openstack|mld|route] [msg-vnet vnet-name] [msg-remote-switch
node name]
[msg-user user-name] [msg-client-pid client-pid-number]
[msg-client-addr ip-address] [msg-port port-number] [msg-vlan
vlan-id] [msg-vxlan vxlan-name] [msg-start-time date/time:
yyyy-mm-ddThh:mm:ss] [msg-end-time date/time:
yyyy-mm-ddThh:mm:ss] [msg-duration duration: #d#h#m#s]
[msg-count 1..50000] [msg-starting-point starting-point-number]
[msg-length length-number] [msg-reverse|no-msg-reverse] [name
name-string] [facility
kern|user|mail|daemon|auth|syslog|lpr|news|uucp|clock|security|
ftp|ntp|audit|alert|cron|local0|local1|local2|local3|local4|loca
l5|local6|local7]
[severity emerg|alert|crit|err|warning|notice|info|debug]
Displays the name of the syslog file to use for matching an event or
adding an event.
syslog-name
name-string
And the following match arguments:
msg-category
event|audit|system
Displays the category of the message to match or add in the systlog
file.
msg-program
program-string
Displays the name of the program used to generate log messages.
msg-name name-string
Displays the type of message.
msg-code code-number
Displays the message code.
msg-level
critical|error|
warn|note
Displays the message level.
Displays the type of event.
msg-event-type
systm|port|tcp|stp|igmp
|lldp|vdp|ecp|evb|ptp|
openflow|storage|tacacs
|openstack|mld|mroute
msg-vnet vnet-name
Displays the name of a VNET.
msg-remote-switch node
name
Displays the name of a remote switch node.
msg-user user-name
Displays the user name.
msg-client-pid
client-pid-number
Displays the client product ID.
Pluribus Networks nvOS Version 2.3.2
63
msg-client-addr
ip-address
Displays the client IP address.
msg-port port-number
Displays the port.
msg-vlan vlan-id
Displays the VLAN ID.
msg-vxlan vxlan-name
Displays the VXLAN name.
msg-start-time
date/time:
yyyy-mm-ddThh:mm:ss
Displays the start time of the messages.
msg-end-time date/time: Displays the end time of the messages.
yyyy-mm-ddThh:mm:ss
msg-duration duration:
#d#h#m#s
Displays the duration of the messages.
msg-count number
Displays the message count from 1 to 50000.
msg-starting-point
starting-point-number
Displays the starting point of the messages.
msg-length
length-number
Displays the length of the messages.
msg-reverse|no-msg-reve Displays if the messages are reversed or not.
rse
name name-string
Displays the name.
Displays the facility type.
facility
kern|user|mail|
daemon|auth|syslog|lpr|
news|uucp|clock|securit
y|ftp|
ntp|audit|alert|cron|lo
cal0|local1|local2|loca
l3|local4|local5|local6
|local7
Displays the severity of the event to match or add.
severity
emerg|alert|crit|err|
warning|notice|info|deb
ug
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
Pluribus Networks nvOS Version 2.3.2
64
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.3
The parameters, mld and mroute, added.
Usage Use this command to display search terms for a syslog file.
Examples To display the search terms for syslog file, logevents-aug13, use the following command:
CLI network-admin@switch > admin-syslog-match-show syslog
logevents-aug13
See Also
• admin-syslog-create
• admin-syslog-delete
• admin-syslog-modify
• admin-syslog-show
• admin-syslog-match-add
• admin-syslog-match-modify
• admin-syslog-match-remove
Pluribus Networks nvOS Version 2.3.2
65
Pluribus Networks nvOS Version 2.3.2
66
api-install
This command is used to install nvOS on a Linux platform and use the API associated features.
Syntax api-install linux-host linux-host-string user user-string
linux-host
linux-host-string
Specify the name of the Linux host.
user user-string
Specify the user login for the Linux host.
Defaults None
Access network-admin
History Command introduced in nvOS Version 2.2.
Usage Use this command to install the nvOS API on a Linux platform.
Examples To install the nvOS API on the Linux host, centos-root, and the user admin, use the
following syntax:
CLI network-admin@switch > api-install linux-host centos-server user
root
Pluribus Networks nvOS Version 2.3.2
67
Pluribus Networks nvOS Version 2.3.2
68
B Commands
bootenv-activate-and-reboot
This command allows you to activate a boot environment and reboot it.
Syntax bootenv-activate-and-reboot name name-string
name name-string
The name for the boot environment that you want to activate.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to activate a boot environment.
Examples To activate an environment called, backup, and reboot it, use the following command:
CLI network-admin@switch > bootenv-activate-and-reboot name backup
See Also
• bootenv-delete
• bootenv-show
Pluribus Networks nvOS Version 2.3.2
69
Pluribus Networks nvOS Version 2.3.2
70
bootenv-delete
This command is used to delete a boot environment from the switch.
Syntax bootenv-delete name name-string
name name-string
The name for the boot environment that you want to delete.
Defaults None
Access CLI.
History Command introduced in nvOS Version 1.2.
Usage Use the command to remove stale boot environments from the platform.
Examples To delete the boot environment, local-boot, use the following command:
CLI network-admin@switch > bootenv-delete local-boot
See Also
• bootenv-activate-and-reboot
• bootenv-show
Pluribus Networks nvOS Version 2.3.2
71
Pluribus Networks nvOS Version 2.3.2
72
bootenv-show
Display information about the boot environment.
Syntax bootenv-show [name name-string] [version version-string]
[current yes|no] [reboot yes|no]
name name-string
Specifies the name of the boot environment.
version version-string
Specifies the version of the boot environment.
current yes|no
Specifies if the named boot environment is the current boot
environment.
reboot yes|no
Specifies if the boot environment is set to reboot.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to display configured information about the boot environment.
Pluribus Networks nvOS Version 2.3.2
73
Examples To display the boot environment, local-copy, in the format layout horizontal, use the following
command:
CLI network-admin@switch > bootenv-show name local-copy layout
horizontal
name
version
----------- ---------ONVL-13 ONVL-14 2.3.0-6795
current
------no
yes
reboot
-----no
yes
space
----17.6M
19.8G
See Also
• bootenv-activate-and-reboot
• bootenv-delete
Pluribus Networks nvOS Version 2.3.2
74
created
-------------03-19,13:54:51
03-23,10:47:53
C Commands
client-server-stats-clear
This command is used to clear statistics generated between a client and server on the network.
Syntax client-server-stats-clear time date/time:yyyy-mm-ddThh:mm:ss
start-time date/time:yyyy-mm-ddThh:mm:ss end-time
date/time:yyyy-mm-ddThh:mm:ss duration duration: #d#h#m#s
interval duration: #d#h#m#s since older-than duration: #d#h#m#s
within-last duration: #d#h#m#s count count-number vlan vlan-id
vxlan vxlan-id client-switch-port port-number server-switch-port
port-number client-mac mac-address server-mac mac-address
client-ip ip-address server-ip ip-address server-port
server-port-type syn syn-number est est-number fin fin-number
obytes obytes-number ibytes ibytes-number total-bytes
total-bytes-number avg-dur high resolution time: #ns avg-lat
high resolution time: #ns first-seen date/time:
yyyy-mm-ddThh:mm:ss last-seen date/time: yyyy-mm-ddThh:mm:s
Specify any of the following options:
time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific time period.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific start time and
date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistic from a specific end time and
date.
duration: #d#h#m#s
Clear statistics for a specific duration.
interval duration: #d#h#m#s
Clear statistics for a specific interval duration.
since-start
Clear statistics from the start of collection.
older-than duration: #d#h#m#s
Clear statistics older than a specified date and
time.
within-last duration: #d#h#m#s
Clear statistics within a specified duration time.
count count-number
Clear the number of counters.
vlan vlan-id
Clear statistics for a specific VLAN.
vxlan vxlan-id
Clear statistics for a specific VXLAN.
client-switch-port port-number
Clear statistics for a specific port number on
the client switch.
server-switch-port port-number
Clear statistics for a specific port number on
the server switch.
client-mac mac-address
Clear statistics for a specific client MAC
address.
server-mac mac-address
Clear statistics for a specific server MAC
address.
client-ip ip-address
Clear statistics for a specific client IP address.
server-ip ip-address
Clear statistics for a specific client IP address.
Pluribus Networks nvOS Version 2.3.2
75
server-port
Specifies the type of statistic to clear from the
server port. This includes HDFS, Hive, Ganglia,
Cassandra, Nutanix and other server types.
syn syn-number
Clear the statistics for SYN packets.
est est-number
Clear the statistics for established connections.
fin fin-number
Clear the statistics for the total number of
closed connections.
obytes obytes-number
Specifis the number of outgoing bytes to clear
statistics.
ibytes ibytes-number
Specifies the number of incoming bytes to
clear statistics.
total-bytes total-bytes-number
Specifies the total bytes to clear statistics.
avg-dur high resolution time: #ns Clear the average duration of high resolution
statistics.
avg-lat high resolution time: #ns Clear the average latency statistics.
first-seen date/time:
yyyy-mm-ddThh:mm:ss
Clear the first-seen statistics only.
last-seen date/time:
yyyy-mm-ddThh:mm
Clear the last-seen statistics only.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, timestamp, start-time, end-time, duration,
interval, since-start, older-than, and within-last added to the
command. The options,
openstack-nova|openstack-keystone|openstack-metering|
openstack-neutron
|openstack-glance|openstack-cinder, added to the parameter,
server-port.
Version 2.2
The parameter, no-since-start, deprecated.
Version 2.2.5
The parameters, HDFS-, added.
Version 2.2.6
The parameters, MR, HBase, Ganglia, Cassandra, and Nutanix added to
server-port.
Usage You can clear all statistics for a client server connection or you can use a filter to clear specific
statistics.
Examples To clear statistics for VLAN12, use the following command:
CLI network-admin@switch > client-server-stats-clear vlan 12
See Also
• client-server-stats-show
• client-server-stats-clear-history
Pluribus Networks nvOS Version 2.3.2
76
client-server-stats-show
This command is used to show statistics generated between a client and server on the network.
Syntax client-server-stats-show timestamp date/time:yyyy-mm-ddThh:mm:ss
start-time date/time:yyyy-mm-ddThh:mm:ss end-time
date/time:yyyy-mm-ddThh:mm:ss duration duration: #d#h#m#s
interval duration: #d#h#m#s count count-number vlan vlan-id
vxlan vxlan-id client-switch-port port-number server-switch-port
port-number client-mac mac-address server-mac mac-address
client-ip ip-address server-ip ip-address server-port
server-port-type syn syn-number est est-number fin fin-number
obytes obytes-number ibytes ibytes-number total-bytes
total-bytes-number avg-dur high resolution time: #ns avg-lat
high resolution time: #ns first-seen date/time:
yyyy-mm-ddThh:mm:ss last-seen date/time: yyyy-mm-ddThh:mm:s
last-seen-ago duration: #d#h#m#s
timestamp date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific timestamp
period.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific start time and
date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistic from a specific end time and date.
duration: #d#h#m#s
Clear statistics for a specific duration.
interval duration: #d#h#m#s
Clear statistics for a specific interval duration.
since-start
Clear statistics from the start of collection.
older-than duration: #d#h#m#s
Clear statistics older than a specified date and
time.
within-last duration: #d#h#m#s
Clear statistics within a specified duration time.
count count-number
Specifies the number of counters.
vlan vlan-id
Specifies statistics for a specific VLAN.
vxlan vxlan-id
Specifies statistics for a specific VXLAN.
client-switch-port port-number
Specifies statistics for a specific port number on
the client switch.
server-switch-port port-number
Specifies statistics for a specific port number on
the server switch.
client-mac mac-address
Specifies statistics for a specific client MAC
address.
server-mac mac-address
Specifies statistics for a specific server MAC
address.
client-ip ip-address
Specifies statistics for a specific client IP
address.
server-ip ip-address
Specifies statistics for a specific client IP
address.
server-port
Specifies the type of protocol on the server
port. This includes HDFS, Hive, Ganglia,
Cassandra, Nutanix and other server types.
Pluribus Networks nvOS Version 2.3.2
77
syn syn-number
Specifies the number of SYN packets.
est est-number
Specifies the number established connections.
fin fin-number
Specifies the total number of closed
connections statistics.
obytes obytes-number
Specifis the number of outgoing bytes to clear
statistics.
ibytes ibytes-number
Specifies the number of incoming bytes to clear
statistics.
total-bytes total-bytes-number
Specifies the total bytes to clear statistics.
avg-dur high resolution time: #ns
Specifies the average duration of high
resolution statistics.
avg-lat high resolution time: #ns
Specifies the average latency statistics.
first-seen date/time:
yyyy-mm-ddThh:mm:ss
Specifies the first-seen statistics only.
last-seen date/time:
yyyy-mm-ddThh:mm
Specifies the last-seen statistics only.
last-seen-ago duration: #d#h#m#s
Specifies a duration to clear statistics.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
78
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage You can display all statistics for a client server connection or you can use a filter to display
specific statistics.
Examples To display all statistics on pleiedes24, use the following command:
CLI network-admin@switch > client-server-stats-show layout vertical
switch:
vlan:
vxlan:
client-ip:
server-ip:
server-port:
syn:
est:
fin:
obytes:
ibytes:
total-bytes:
avg-dur:
avg-lat:
last-seen-ago:
switch:
vlan:
vxlan:
client-ip:
server-ip:
server-port:
syn:
est:
fin:
obytes:
ibytes:
total-bytes:
avg-dur:
avg-lat:
last-seen-ago:
pleiades24
1
0
192.171.1.65
192.171.2.60
ssh
4
0
724
1.29M
2.70M
3.99M
486ms
97.1us
51m4s
pleiedes24
1
0
192.171.1.31
192.171.2.60
ssh
10
0
1.60K
2.92M
6.09M
9.01M
490ms
86.3us
51m4s
See Also
• client-server-stats-clear-history
• client-server-stats-clear
Pluribus Networks nvOS Version 2.3.2
79
Pluribus Networks nvOS Version 2.3.2
80
client-server-stats-clear-history
This command is used to clear the history of client and server statistics.
Syntax client-server-stats-clear-history
Defaults None
Access CLI
History Command introduced in nvOS Version 2.2.3.
See Also
• client-server-stats-clear
• client-server-stats-show
Pluribus Networks nvOS Version 2.3.2
81
Pluribus Networks nvOS Version 2.3.2
82
cluster-create
To create a new cluster for high availability (HA) in a fabric, use the cluster-create command.
Informational Note: You may configure multiple clusters of switches within a single fabric.
However, a switch can participate in only one cluster configuration. For example, switch-1 and switch-2
can participate in cluster-1, and switch-3 and switch-4 can participate in cluster-2, but switch-1 and
switch-2 cannot participate in cluster-2 or any other cluster.
Syntax cluster-create name cluster_name cluster-node-1 cluster-node-1
cluster-node-2 cluster-node-2 [validate|no-validate]
cluster-name
Specify the name of the cluster.
cluster-node-1
Specify the name of the first switch in the cluster.
cluster-node-2
Specify the name of the second switch in the cluster.
Any of the following options:
validate |no-validate
Validate the inter-switch links and state of the switches in the
cluster.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, private-link, added.
Version 2.2
The parameter, private-link, deprecated.
Usage A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that
form the cluster must be members of the same fabric. Clusters are typically used in conjunction
with a virtual link aggregation group (VLAG) that allows links physically connected to two
separate switches appear as a single trunk to a third device. The third device can be a switch,
server, or any Ethernet device.
Examples To create a cluster named, cluster_eng, using an interswitch link or trunk between two
cluster nodes, switch_a and switch_b, and is available to other network traffic, use the
following command:
CLI network-admin@switch > cluster-create name cluster_eng
cluster-node-1 switch_a cluster-node-2 validate
See Also
• cluster-delete
• cluster-show
Pluribus Networks nvOS Version 2.3.2
83
Pluribus Networks nvOS Version 2.3.2
84
cluster-delete
To delete a cluster for high availability (HA) in a fabric, use the cluster-delete command.
Syntax cluster-delete name name-string
name name-string
Specify the name of the cluster.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, private-link, added.
Version 2.2
The parameter, private-link, deprecated.
Usage A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that
form the cluster must be members of the same fabric. Clusters are typically used in conjunction
with a virtual link aggregation group (VLAG) that allows links physically connected to two
separate switches appear as a single trunk to a third device. The third device can be a switch,
server, or any Ethernet device.
Examples To delete a cluster named, cluster_eng, use the following command:
cluster-delete name cluster_eng
See Also
• cluster-create
• cluster-show
Pluribus Networks nvOS Version 2.3.2
85
Pluribus Networks nvOS Version 2.3.2
86
cluster-info
To view information about clusters in a fabric, use the cluster-info command.
Informational Note: You may configure multiple clusters of switches within a single fabric.
However, a switch can participate in only one cluster configuration. For example, switch-1 and
switch-2 can participate in cluster-1, and switch-3 and switch-4 can participate in cluster-2, but
switch-1 and switch-2 cannot participate in cluster-2 or any other cluster.
Syntax cluster-info
cluster-name
Displays the name of the cluster.
cluster-node-1
Displays the name of the first switch in the cluster.
cluster-node-2
Displays the name of the second switch in the cluster.
tid
Displays the transaction ID.
ports
Displays the port used to create the cluster configurarion.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, private-link, added.
Version 2.2
The parameter, private-link, deprecated.
History
Usage A cluster allows two switches to cooperate in high-availability (HA) deployments. The nodes that
form the cluster must be members of the same fabric. Clusters are typically used in conjunction
with a virtual link aggregation group (VLAG) that allows links physically connected to two
separate switches appear as a single trunk to a third device. The third device can be a switch,
server, or any Ethernet device.
Examples To display information a cluster named, vlag, use the cluster-info command:
CLI network-admin@switch > cluster-info
name:
state:
cluster-node-1:
cluster-node-2:
tid:
ports:
vlag
online
167772208
167772196
1
26
See Also
• cluster-create
• cluster-delete
• cluster-repeer
• cluster-show
Pluribus Networks nvOS Version 2.3.2
87
Pluribus Networks nvOS Version 2.3.2
88
cluster-show
To display a cluster configuration in a fabric, use the cluster-show command.
Syntax cluster-show name name-string id cluster-id [state
offline|coming-up|synching|online] [cluster-node-1 fabric-node
name-string] [cluster-node-2 fabric-node name-string]
[tid tid-number] ports port-list [validate|no-validate] ]
name name-string
Specifies the name of the cluster.
cluster-id
Specifies the ID assigned to the cluster configuration.
state
•
•
•
•
cluster-node-1
Specifies the name of the first switch in the cluster.
cluster-node-2
Specifies the name of the second switch in the cluster.
tid tid-number
Specifies the transaction ID number.
ports port-list
Specifies the list of ports.
validate |no-validate
Validate the inter-switch links and state of the switches in the
cluster.
offline
online
coming-up
synching
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, private-link, added.
Version 2.2
The parameter, private-link, deprecated.
Usage Displays information about cluster configurations on the network.
Examples To show information about a cluster configuration, use the following command:
CLI network-admin@switch > cluster-show format all layout vertical
name:
id:
state:
cluster-node-1:
cluster-node-2:
tid:
ports:
vlag
a000030:1
online
pubdev01
pubdev02
0
26,128
See Also
• cluster-create
• cluster-delete
Pluribus Networks nvOS Version 2.3.2
89
Pluribus Networks nvOS Version 2.3.2
90
connection-clear
To clear connection statistics for a switch, use the connection-clear command.
Syntax connection-clear
Specify any of the following options:
time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific timestamp period.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific start time and date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistic from a specific end time and date.
duration: #d#h#m#s
Clear statistics for a specific duration.
interval duration: #d#h#m#s
Clear statistics for a specific interval duration.
since-start
Clear statistics from the start of collection.
older-than duration: #d#h#m#s
Clear statistics older than a specified date and
time.
within-last duration: #d#h#m#s
Clear statistics within a specified duration time.
count count-number
Clear the count number.
vlan vlan_id
Specifies the VLAN identifier.
vxlan vxlan-id
Specifies the VXLAN identifier.
vnet vnet-string
Specifies the name of the virtual network (VNET).
src-switch-port
Specifies the physical port number on the switch
where a client requested a connection.
dst-switch-port
Specifies the physical port number on the switch
where a server responded to a connection.
ether_type
Specifies the EtherType value or keyword of the
connection. The keywords can be arp, dot1X,
fcoe, fcoe-init, ipv4, ipv6,
jumbo, lldp, macsec, mpls-multi,
mpls-uni, ptp, qing, rarp, vlan,
and wake.
src-mac-addr
Specifies the MAC address of the client requesting
a connection.
dst-mac-addr
Specifies the MAC address of the server
responding to a connection.
src-ip
Specifies the IP address of the client requesting a
connection.
dst-ip
Specifies the IP address of the server responding to
a connection.
Pluribus Networks nvOS Version 2.3.2
91
src-port
Specifies the type of port used by the client
requesting a connection. This includes HDFS, Hive,
Ganglia, Cassandra, Nutanix and other server
types.
dst-port
Specifies the type of port used by the server
responding to a connection. This includes HDFS,
Hive, Ganglia, Cassandra, Nutanix and other server
types.
dscp
Specifies the 6-bit Differentiated Services Code
Point (DSCP).
protocol
[tcp|udp|icmp|igmp|ip
Specifies the protocol.
cur-state
syn|est|fin|rst
Specifies the current state of the connection.
dur high resolution time:#ns
Specifies the duration for high resolution time in
nano seconds.
latency high resolution time:#ns
Specifies the latency for high resolution time in
nano seconds
latency(us)
Specifies the network transmit time (latency)
experienced by the connection in microseconds.
obytes
Specifies the number of bytes sent from the client
side of the connection.
ibytes
Specifies the number of bytes received by the
client side of the connection.
total-bytes
Specifies the total number of bytes for the
connection.
started-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the time and date of the initial
connection.
ended-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the time and date when the connection
ended.
transition-state
started-and-ended
|started|ended|ongoing
Specifies the transition state of the connection.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 1.2.2
Command changed to connection-clear. bytes-sent and
bytes-recvd changed to obytes and ibytes. older-than and
within-last parameters added.
Pluribus Networks nvOS Version 2.3.2
92
Version 2.1
The parameters, client and server, changed to src and
dst. The parameter, service, is deprecated. The parameters,
started-time, ended-time, and transition-state
added.
Version 2.2
The parameter, no-since-start, deprecated.
Version 2.2.5
The parameters, HDFS-, added..
Usage Clears statistical information about the current connections on the switch.
See Also
 connection-show
 connection-stats-show
 connection-stats-clear
 connection-stats-show
Pluribus Networks nvOS Version 2.3.2
93
Pluribus Networks nvOS Version 2.3.2
94
connection-show
To display connection statistics for a switch, use the connection-show command.
Syntax connection-show
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies statistics from a specific start time and date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies statistic from a specific end time and date.
duration: #d#h#m#s
Specifies statistics for a specific duration.
interval duration:
#d#h#m#s
Specifies statistics for a specific interval duration.
since-start
Specifies statistics from the start of collection. This is another
way to specify the start time for the connection output.
older-than duration:
#d#h#m#s
Specifies statistics older than a specified date and time. This is
another way to specify the end time for the connection output.
within-last duration:
#d#h#m#s
Specifies statistics within a specified duration time. This is
another way to specify the start time for the connection output.
Also, only the closed connections are displayed.
vlan vlan_id
Specifies the VLAN identifier.
vnet vnet_name
Specifies the name of the virtual network (VNET).
src-switch-port
Specifies the physical port number on the switch where a client
requested a connection.
dst-switch-port
Specifies the physical port number on the switch where a server
responded to a connection.
ether_type
Specifies the EtherType value or keyword of the connection. The
keywords can be arp, dot1X, fcoe, fcoe-init,
ipv4, ipv6, jumbo, lldp, macsec, mpls-multi,
mpls-uni, ptp, qing, rarp, vlan, and wake.
src-mac-addr
Specifies the MAC address of the client requesting a connection.
dst-mac-addr
Specifies the MAC address of the server responding to a
connection.
src-ip
Specifies the IP address of the client requesting a connection.
dst-ip
Specifies the IP address of the server responding to a connection.
src-port
Specifies the type of data on the source port. HDFS indicates
ports connected to Hadoop systems. Also includes HDFS, Hive,
Ganglia, Cassandra, Nutanix and other server types.
dst-port
Specifies the type of data on the destination port. This includes
HDFS, Hive, Ganglia, Cassandra, Nutanix and other server types.
dscp
Specifies the 6-bit Differentiated Services Code Point (DSCP).
proto
[tcp|udp|icmp|igmp|ip
Specifies the protocol.
Pluribus Networks nvOS Version 2.3.2
95
cur-state
syn|est|fin|rst
Specifies the current state of the connection.
dur high resolution
time: #ns
Specifies the duration of the connection.
latency(us)high
resolution time: #ns
Specifies the network transmit time (latency) experienced by the
connection in microseconds.
obytes
Specifies the number of bytes sent from the client side of the
connection.
ibytes
Specifies the number of bytes received by the client side of the
connection.
active
Specifies whether the connection is currently active or inactive.
age duration:#d#h#m#s
Specifies the duration of the connection in days, hours, minutes
and seconds.
•
•
•
•
syn — synchronized
est — established
fin — finished
rst — reset
transition-state
Specifies the transition state of the connection.
started-and-ended
|started| ended|ongoing
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
96
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 1.2.2
Command changed to connection-clear. bytes-sent and
bytes-recvd changed to obytes and ibytes. older-than and
within-last parameters added.
Version 2.1
The parameters, client and server, changed to src and
dst. The parameter, service, is deprecated. The parameters,
started-time, ended-time, and transition-state
added.
Version 2.2
The parameter, no-since-start, deprecated.
Version 2.2.5
The parameters, HDFS-, added..
Usage Each switch maintains a set of standard flow-based statistics that are “always-on”, meaning that
they are continuously tracked and updated by the switch. This command displays the TCP
connections transiting the local switch as identified through the SYN/FIN protocol handshake
between the client and the server of the application.
Examples To show the connection statistics for vnet MyVNET, use the following command:
CLI network-admin@switch > connection-show vnet MyVNET layout vertical
switch:
vlan:
vxlan:
vnet:
src-ip:
dst-ip:
client-switch-port:
server-switch-port:
client-port:
server-port:
dscp:
proto:
service dur(s:
latency(us):
bytes-sent:
bytes-recv:
active:
pleiades24
51
0
10.222.1.1
10.222.1.2
8000
See Also
• connection-stats-clear
• connection-stats-clear
• connection-stats-show
Pluribus Networks nvOS Version 2.3.2
97
Pluribus Networks nvOS Version 2.3.2
98
connection-clear-history
This command is used to clear the history of connection statistics.
Syntax connection-clear-history
Defaults None
Access CLI
History Command introduced in Version 2.2.3.
See Also
• connection-clear
• connection-show
• connection-latency-show
• connection-stats-clear
• connection-stats-show
Pluribus Networks nvOS Version 2.3.2
99
Pluribus Networks nvOS Version 2.3.2
100
connection-latency-show
This command is used to display latency information for connections on the switch. Comparing latency
information for connections at various times can show whether the network performance has changed
or stayed the same, and potentially eliminate the network as the cause of the problem
Syntax connection-latency-show
min high resolution
time: #ns
Displays the minimum latency in nanoseconds.
max high resolution
time: #ns
Displays the maximum latency in nanoseconds.
num-bins
num-bins-number
Specify the number of bins to divide the latency range. Bins
display the number of connections at each latency interval.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Pluribus Networks nvOS Version 2.3.2
101
Usage You can display all of the latency information about a connection or you can filter by the number
of bins to display. Comparing latency information for connections at various times can show
whether the network performance has changed or stayed the same, and potentially eliminate the
network as the cause of the problem
Examples To display all latency information on pleiades24, use the following command:
network-admin@pleiedes24> connection-latency-show
switch
al-bytes
min
max
num-conns percent
avg-dur
obytes
ibytes
tot
------------- ------ --------- ------- ------- ------ ---------------pleiades2
40.00ns 20.0us 13
0%
0
3%
1.28us
pleiades24 40.0us 60.0us 671
28%
14.9us 1.19M 2.50M 3.69M
pleiades24 60.0us 80.0us 649
27%
19.2us 1.16M 2.42M 3.57M
pleiades24 80.0us 100us 337
14%
12.9us 615K
1.25M 1.86M
pleiades24 100us
120us
219
9%
10.2us
400K
835K
1.21M
pleiades24 120us
140us
114
4%
6.33us
208K
434K
642K
pleiades24 140us
160us
63
2%
4.01us
115K
241K
356K
pleiades24 160us
180us
58
2%
4.19us
106K
222K
327K
pleiades24 180us
200us
35
1%
2.85us
63.9K
134K
198K
94
4%
146K
0
pleiades24 20.0us 40.0us 80
pleiades24 200us
13.2us
Pluribus Networks nvOS Version 2.3.2
102
0
305K
172K
451K
359K
530K
connection-stats-clear
This command clears statistics collected while connected to the host.
Syntax [time date/time: yyyy-mm-ddThh:mm:ss] [start-time date/time:
yyyy-mm-ddThh:mm:ss] [end-time date/time: yyyy-mm-ddThh:mm:ss]
[duration duration: #d#h#m#s] [interval duration: #d#h#m#s]
[since-start|no-since-start] [older-than duration: #d#h#m#s]
[within-last duration: #d#h#m#s] [count count-number] [mac
mac-address] [vlan vlan-id] [ip ip-address] [port port-number]
[iconns iconns-number] [oconns oconns-number] [ibytes
ibytes-number] [obytes obytes-number] [total-bytes
total-bytes-number] [first-seen date/time: yyyy-mm-ddThh:mm:ss ]
[last-seen date/time: yyyy-mm-ddThh:mm:ss] [last-seen-ago
duration: #d#h#m#s]]
time date/time:
yyyy-mm-ddThh:mm:ss
Specify a time to clear the connection statistics.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from a specific start time and date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Clear statistic from a specific end time and date.
duration: #d#h#m#s
Clear statistics for a specific duration.
interval duration:
#d#h#m#s
Clear statistics for a specific interval duration.
since-start
Clear statistics from the start of collection.
older-than duration:
#d#h#m#s
Clear statistics older than a specified date and time.
within-last duration:
#d#h#m#s
Clear statistics within a specified duration time.
count count-number
Clear a specific number of statistics.
mac mac-address
Clear statistics for a MAC address.
vlan vlan_id
Clear the VLAN identifier.
ip ip-address
Clear the IP address of the connection.
port port-number
Clear the port number of the connection.
iconns iconns-number
Clear the number of incoming connections.
oconns oconns-number
Clear the number outgoing connections.
obytes
Clear the number of bytes sent from the client side of the
connection.
ibytes
Clear the number of bytes received by the client side of the
connection.
first-seen date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from the time a connection is first seen.
last-seen date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from the time a connection was last seen.
Defaults None
Pluribus Networks nvOS Version 2.3.2
103
Access CLI
History
Version 1.2
Command introduced.
Version 1.2.2
Command changed to connection-stats-show.
Version 2.2
The parameter, no-since-start, deprecated.
Usage Used to clear statistics for a connection to a host.
Examples To clear the statistics from port 23, use the following command:
CLI network-admin@switch > connection-stats-clear port 23
Pluribus Networks nvOS Version 2.3.2
104
connection-stats-clear-history
This command is used to clear the history of connection statistics.
Syntax connection-stats-clear-history
Defaults None
Access CLI
See Also Command introduced in Version 2.2.3.
• connection-clear
• connection-show
• connection-latency-show
• connection-stats-clear
• connection-stats-show
Pluribus Networks nvOS Version 2.3.2
105
Pluribus Networks nvOS Version 2.3.2
106
connection-stats-show
This command displays statistics collected when connected to host.
Syntax connection-stats-show [time date/time:
yyyy-mm-ddThh:mm:ss][start-time date/time: yyyy-mm-ddThh:mm:ss]
[end-time date/time: yyyy-mm-ddThh:mm:ss] [duration duration:
#d#h#m#s] [interval duration: #d#h#m#s]
[since-start|no-since-start] [older-than duration: #d#h#m#s]
[within-last duration: #d#h#m#s] [count count-number] [mac
mac-address] [vlan vlan-id] [ip ip-address] [port port-number]
[iconns iconns-number] [oconns oconns-number] [ibytes
ibytes-number] [obytes obytes-number] [total-bytes
total-bytes-number] [first-seen date/time: yyyy-mm-ddThh:mm:ss ]
[last-seen date/time: yyyy-mm-ddThh:mm:ss] [last-seen-ago
duration: #d#h#m#s]]
time date/time:
yyyy-mm-ddThh:mm:ss
Specify a time to display connection statistics.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies statistics from a specific start time and date.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies statistic from a specific end time and date.
duration: #d#h#m#s
Specifies statistics for a specific duration.
interval duration:
#d#h#m#s
Specifies statistics for a specific interval duration.
since-start|
no-since-start
Specifies statistics from the start of collection.
older-than duration:
#d#h#m#s
Specifies statistics older than a specified date and time.
within-last duration:
#d#h#m#s
Specifies statistics within a specified duration time.
count count-number
Clear a specific number of statistics.
mac mac-address
Clear statistics for a MAC address.
vlan vlan_id
Specifies the VLAN identifier.
ip ip-address
Specifies the IP address of the connection.
port port-number
Specifies the port number of the connection.
iconns iconns-number
Specifies the number of incoming connections.
oconns oconns-number
Specifies the number outgoing connections.
obytes
Specifies the number of bytes sent from the client side of the
connection.
ibytes
Specifies the number of bytes received by the client side of the
connection.
total-bytes
total-bytes-number
Specifies the total number of bytes for the connection.
age duration:#d#h#m#s
Specifies the duration of the connection in days, hours, minutes
and seconds.
Pluribus Networks nvOS Version 2.3.2
107
first-seen date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from the time a connection is first seen.
last-seen date/time:
yyyy-mm-ddThh:mm:ss
Clear statistics from the time a connection was last seen.
age duration:#d#h#m#ss
Clear the duration of the connection in days, hours, minutes and
seconds.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 1.2.2
Command changed to connection-stats-show.
Version 2.2
The parameter, total-bytes, added.
Usage Used to clear statistics about a connection to a host.
Pluribus Networks nvOS Version 2.3.2
108
Examples To display the statistics from port 23, use the following command:
CLI network-admin@switch > connection-stats-show format all layout
vertical
switch:
mac:
vlan:
ip:
port:
iconns:
oconns:
ibytes:
obytes:
total-bytes:
first-seen:
last-seen:
last-seen-ago:
switch:
mac:
vlan:
ip:
port:
iconns:
oconns:
ibytes:
obytes:
total-bytes:
first-seen:
last-seen:
last-seen-ago:
pubdev02
64:0e:94:28:03:56
1
192.168.42.30
41
184
0
0
0
0
01-14,10:33:44
01-14,10:35:22
5d23h29m53s
pubdev02
64:0e:94:28:00:5e
1
192.168.42.20
47
3
0
1.47K
14.8K
16.3K
01-13,13:59:35
01-19,22:45:21
11h19m54s
See Also
 connection-stats-clear
 connection-stats-show
 connection-stats-clear
Pluribus Networks nvOS Version 2.3.2
109
Pluribus Networks nvOS Version 2.3.2
110
control-stats-show
This command is used to display the packet counts sent from the CPU.
Syntax control-stats-show [time date/time: yyyy-mm-ddThh:mm:ss]
[start-time date/time: yyyy-mm-ddThh:mm:ss] [end-time date/time:
yyyy-mm-ddThh:mm:ss] [duration duration: #d#h#m#s] [interval
duration: #d#h#m#s] [since-start] [older-than duration:
#d#h#m#s] [within-last duration: #d#h#m#s] [caller Unknown|Total
Defaults
time date/time:
yyyy-mm-ddThh:mm:ss
Specify the timestamp of the statistics that you want to display.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specify the start time for the statistics that you want to display.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specify the end time for the statistics that you want to display.
duration duration:
#d#h#m#s
Specify the duration of the statistics that you want to display.
interval duration:
#d#h#m#s
Specify the interval between the statistics that you want to
display.
since-start
Specify a start time for the statistics.
older-than duration:
#d#h#m#s
Specify a duration that is older than a specified time.
within-last duration:
#d#h#m#s
Specify a duration window for a specified time.
caller Unknown|Total
Specify the caller for the specific statistics. Total is displayed by
default.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
111
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The options, CPU-RX-TX|VLAG|BCAST|Flood, added to the
parameter, caller.
Version 2.2
The parameters, older-than and within-last, added. The
parameters,
|ARP|Vxlan-ARP|Vxlan-multicast|Vxlan-TCP|Vx
lan-encap|Vxlan|Discovery|Keep-Alive|ECP|
ICMP|IGMP|LLDP|LACP|
Logical-switch|PTP|STP|PVST|nvOS-control|Lo
cal-subnet|Ipv6-mc|TCP-conn|RX-queue|NAT-Dy
namic|CPU-RX-TX|VLA
G|BCAST|Flood] deprecated.
Usage You can use this command to display how many packets ONVL is sending out and how many
packets were dropped. This can be helpful when debugging or troubleshooting problems on the
network.
Pluribus Networks nvOS Version 2.3.2
112
Examples To display control stats for a duration of three days and an interval of one day, use the
following command:
CLI network-admin@switch > control-stats-show duration 03:00:00
interval 01:00:00 format all layout vertical
switch:
caller:
ipkts:
ibytes:
idrops:
idrop-bytes:
idrops-err:
opkts:
obytes:
odrops:
odrop-bytes:
switch:
caller:
ipkts:
ibytes:
idrops:
idrop-bytes:
idrops-err:
opkts:
obytes:
odrops:
odrop-bytes:
switch:
caller:
ipkts:
ibytes:
idrops:
idrop-bytes:
idrops-err:
opkts:
obytes:
odrops:
odrop-bytes:
pubdev03
Total
1.80M
458M
5
300
0
1.87M
395M
29.7K
1.51M
pubdev02
Total
978K
434M
8
490
0
1.53M
399M
53.4K
15.2M
pubdev01
Total
1.86M
499M
13
780
0
2.33M
454M
89.0K
15.0M
Pluribus Networks nvOS Version 2.3.2
113
Pluribus Networks nvOS Version 2.3.2
114
control-stats-setting-modify
This command is used to modify the settings to collect statistics about packets sent from the CPU.
Syntax control-stats-settings-modify enable|disable interval duration:
#d#h#m#s disk-space disk-space-number
enable|disable
Specify to enable or disable statistic collection.
interval duration:
#d#h#m#s
Specify the intervals to collect statistics.
disk-space
disk-space-number
Specify the disk space to allocate to the statistics.
Defaults None
Access CLI
History Introduced in Version 2.0.
Usage You can use this command to modify how packets statistics are collected.
Examples To disable statistic collection, use the following command:
CLI network-admin@switch > control-stats-settings-modify disable
See Also
• control-stats-setting-show
Pluribus Networks nvOS Version 2.3.2
115
Pluribus Networks nvOS Version 2.3.2
116
control-stats-setting-show
This command is used to display the settings for collecting statistics about packets sent from the CPU.
Syntax control-stats-settings-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Introduced in Version 2.0.
Usage You can use this command to display how packets statistics are collected.
Pluribus Networks nvOS Version 2.3.2
117
Examples To disable statistic collection, use the following command:
CLI network-admin@switch > control-stats-settings-show
switch:
enable:
interval:
disk-space:
switch:
enable:
interval:
disk-space:
switch:
enable:
interval:
disk-space:
pubdev01
yes
1m
50M
pubdev03
yes
1m
50M
pubdev02
yes
1m
50M
See Also
• control-stats-setting-modify
Pluribus Networks nvOS Version 2.3.2
118
D Commands
dhcp-create
This command is used to create a DHCP service for a fabric, cluster, or standalone switch.
Syntax dhcp-create name name-string vnet vnet-string initial-ip-pool
ip-pool name [dedicated-vnet-service|shared-vnet-service]
[disable|enable] [storage-pool storage-pool name] max-leasetime
max-leasetime-number] [default-leasetime
default-leasetime-number] [pxe-boot
disabled|by-host-mac|all-hosts] [pxe-default-menu dhcp pxe-menuname] [pxe-menu-timeout pxe-menu-timeout-number]
name name-string
Specifies the name of the DHCP service.
vnet vnet-string
Specifies the VNET to apply the DHCP service.
initial-ip-pool ip-pool Specifies the IP address pool to use for IP addresses.
name
Specify any of the following options:
dedicated-vnet-service| Configure DHCP to be a dedicated service or shared service on
shared-vnet-service
the VNET.
disable|enable
Enable or disable DHCP.
storage-pool
storage-pool name
Specifies the name of the storage pool.
max-leasetime
max-leasetime-number
Specifies the maximum lease time for IP addresses allocated to
hosts of the DHCP service. The default value is 3600 seconds.
Specifies the default lease time for IP addresses allocated to
default-leasetime
default-leasetime-numbe hosts of the DHCP service. The default value is 3600 seconds.
r
pxe-boot
disabled|by-host-mac|
all-hosts
Specify the PXE boot action.
pxe-default-menu dhcp
pxe-menu-name
Specify the name for the PXE menu.
pxe-menu-timeout
Specify the timeout in seconds.
pxe-menu-timeout-number
Defaults Unless specified otherwise, the DHCP mode is configured in master mode as a primary DHCP
server with a default and maximum lease time of 3600 seconds (one hour). The default is to
ping an IP address before allocating it to a DHCP client. If the IP address is taken, the DHCP
service finds another IP address to allocate to the DHCP client.
Access CLI
History Command introduced in nvOS Version 1.2
Usage Used to create DHCP services in a virtual network.
Pluribus Networks nvOS Version 2.3.2
119
Examples To create a dedicated DHCP service for VNET, finance-all, and an initial IP address pool, local,
use the following command:
CLI network-admin@switch > dhcp-create dhcp-finance vnet finance-all
local dedicated-vnet-service enable
See Also
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
120
dhcp-delete
This command deletes DHCP services from the VNET configuration.
Syntax dhcp-delete name name-string
The name of the DHCP service to delete from the configuration.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or virtual network can provide a DHCP service to allocate
IP addresses. This command deletes a previously created DHCP service.
Examples To delete DHCP services, finance, use the following command:
CLI network-admin@switch > dhcp-delete name finance
See Also
• dhcp-create
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
121
Pluribus Networks nvOS Version 2.3.2
122
dhcp-migrate
This command allows you to migrate a DHCP service from a location to another location or from one
storage pool to another.
Syntax dhcp-migrate name name-string [location fabric-node name to
location fabric-node name] [storage-pool storage-pool-name]
Specify the name of the DHCP service.
name name-string
Specify one or both of the following options:
location fabric-node
name
Specify the location to migrate the service.
storage-pool
storage-pool-name
Specify the name of the storage pool.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to migrate a DHCP service from one location or storage pool to another.
Examples To migrate the DHCP service, eng-remote, from the fabric, external, to the fabric, internal,
use the following command:
CLI network-admin@switch > dhcp-migrate name eng-remote location
fabric-node external to location fabric-node internal
See Also
• dhcp-create
• dhcp-delete
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
123
Pluribus Networks nvOS Version 2.3.2
124
dhcp-modify
This command is used to modify a DHCP service on the switch.
Syntax dhcp-modify name name-string disable|enable [gateway ip-address]
[max-leasetime max-leasetime-number] [default-leasetime
default-leasetime-number]pxe-boot disabled|by-host-mac|all-hosts
[pxe-default-menu dhcp pxe-menu-name] [pxe-menu-timeout
pxe-timeout-menu-timeout-number]
name name-string
The name of the DHCP service that you want to modify.
Specify one or more of the following options:
disable|enable
Enable or disable the DHCP service
gateway ip-address
Specify or modify the IP address of the gateway server
max-leasetime
max-leasetime-number
Specify or modify the maximum lease time for an IP address
default-leasetime
default-leasetimenumber
Specify or modify the default lease time value for an IP address.
pxe-boot disabled|by-host-mac|
all-hosts
Specify if PXE boot is enabled or disabled.
pxe-default-menu dhcp
pxe-menu-name
Specify or modify the PXE menu name.
pxe-menu-timeout
pxe-timeout-menutimeout-number
Specify or modify the PXE timeout.
Defaults Unless specified otherwise, the DHCP mode is configured in master mode as a primary DHCP
server with a default and maximum lease time of 3600 seconds (one hour). The default is to
ping an IP address before allocating it to a DHCP client. If the IP address is taken, the DHCP
service finds another IP address to allocate to the DHCP client.
Access CLI
History Command introduced in nvOS Version 1.2.
Version 1.2
Command introduced.
Version 2.1
The parameter, pxeboot, was added.
Usage Use this command to modify DHCP configuration parameters for a DHCP service.
Examples To disable the DHCP service, dhcp-vlan2, use the following command:
dhcp-modify dhcp-vlan2 disable
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-show
• dhcp-host-add
Pluribus Networks nvOS Version 2.3.2
125
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
126
dhcp-show
This command is used to display information about DHCP services on a virtual network.
Syntax dhcp-show name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm||nat|
openstack|netvmm|ovs] [scope local|fabric] vnet vnet-string
[location fabric-node name] initial-vlan-pool ip-pool name
[dedicated-vnet-service|shared-vnet-service disable|enable]
[storage-pool storage-pool name] max-leasetime
max-leasetime-number] default-leasetime
default-leasetime-number] [status unknown|startup|normal|
communication-intr|partner-down|potential-conflict|recover|
paused|shutdown|recover-done|resolution-intr|
conflict-done|recover-wait]
[pxe-boot disabled|by-host-mac|all-hosts] pxe-default-menu dhcp
pxe-menu- name] [pxe-menu-timeout pxe-menu-timeout-number]
kickstarts-share kickstarts-share-string auto_if auto_if-string
name name-string
Specifies the name of the DHCP service.
type vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|ofpd|
orphaned|netvm||nat|
openstack|netvmm|ovs
Specifies the type of services associated with the DHCP services.
vnet vnet-string
Specifies the VNET using the DHCP service.
location fabric-node name
Specifies the location of the DHCP service.
initial-ip-pool ip-pool name
Specifies the initial IP pool for the VLAN.
dedicated-vnet-service|
shared-vnet-service
disable|enable
Specifies if DHCP service is a dedicated or shared service.
storage-pool storage-pool name
Specifies the name of the storage pool.
max-leasetime
max-leasetime-number
Specifies the maximum lease time for IP addresses allocated to the
hosts of the DHCP service.The default is 3600 seconds.
default-leasetime
default-leasetimenumber
Specifies the default least time for IP addresses allocated to the
hosts of the DHCP service.
status unknown|startup|normal| Specifies the status of the DHCP services.
communication-intr|partner-dow
n|potentialconflict|recover|paused|shutdo
wn|recover-done|
resolution-intr| conflict-done|
recover-wait
pxe-boot disabled|by-host-mac|
all-hosts
Specify the PXE boot action.
pxe-default-menu dhcp
pxe-menu-name
Specify the name for the PXE menu.
pxe-menu-timeout
pxe-menu-timeout-number
Specify the timeout in seconds.
Pluribus Networks nvOS Version 2.3.2
127
kickstarts-share
kickstarts-share-string
Specifies a shared kickstart string.
auto_if auto_if-string
Specifies an auto-configured interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, location, added. The options, openstack, netvmm, and ovs
added to the parameter, type.
Usage Used to display information about DHCP services in a virtual network.
Pluribus Networks nvOS Version 2.3.2
128
Examples To display DHCP services on the switch, use the following command:
CLI network-admin@switch > dhcp-show layout vertical
name:
type:
scope:
vnet:
vnet-service:
state:
gateway
pxe-boot
name:
type:
scope:
vnet:
vnet-service:
state:
gateway
pxe-boot
dhcp-openstack-rn1-1000
dhcp
fabric
openstack-rn1-1000
shared
enabled
::
disabled
dhcp-openstack-Tenant-300
dhcp
fabric
openstack-Tenant-300
shared
enabled
::
disabled
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
129
Pluribus Networks nvOS Version 2.3.2
130
dhcp-host-add
This command adds a host to PXE boot from an existing DHCP service to the switch configuration.
Syntax dhcp-host-add dhcp-name name-string hostname hostname-string mac
mac-address [pxe-boot|no-pxe-boot] gateway-ip ip-address
[fixed-ip ip-address]
dhcp-name name-string
Specify the name you want to call the DHCP service.
Specify any of the following host options:
hostname hostname-string
Specify the name of the DHCP host that you want to add to the
configuration.
mac mac-address
Specify the MAC address for the host to add to the DHCP host.
gateway-ip ip-address
Specify the gateway IP address.
pxe-boot|no-pxe-boot
Specify to use PXE boot or not.
fixed-ip ip-address
You can optionally include a fixed IP address for the DHCP host.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, gateway-ip, added.
Usage Used to add a DHCP host.
Examples To add DHCP host, finance, use the following command:
CLI network-admin@switch > dhcp-host-add dhcp-name finance hostname
myhost pxe-boot
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
Pluribus Networks nvOS Version 2.3.2
131
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
132
dhcp-host-remove
This command removes a hostname record from an existing DNS service on the switch configuration.
Syntax dhcp-host-remove dhcp-name name-string hostname hostname-string]
dhcp-name name-string
The name of the DHCP service to remove.
hostname hostname-string
The name of the DHCP host that you want to remove from the
configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to remove a DHCP host.
Examples To remove a DHCP host, finance, and hostname, myhost, use the following command:
CLI network-admin@switch > dhcp-host-remove name finance hostname
myhost
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
133
Pluribus Networks nvOS Version 2.3.2
134
dhcp-host-show
This command displays information about a DHCP host in the switch configuration.
Syntax dhcp-host-add dhcp-name name-string hostname hostname-string mac
mac-address [pxe-boot|no-pxe-boot] gateway-ip ip-address
[fixed-ip ip-address]
dhcp-name name-string
Specifies the name of the DHCP service.
Specify the following host arguments:
hostname hostname-string
Specifies the name of the DHCP host.
mac mac-address
Specifies the MAC address of the host.
pxe-boot|no-pxe-boot
Specifies the PXE boot option.
gateway-ip ip-address
Specifies the gateway IP address for the DHCP host.
fixed-ip ip-address
Specifies an optional fixed IP address for the DHCP host.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
135
History
Version 1.2
Command introduced.
Version 2.1
The parameter, gateway-ip, added.
Usage to display information about a DHCP host.
Examples To display information about the DHCP host, finance, use the following command:
CLI network-admin@switch > dhcp-host-show dhcp-name finance hostname
myhost
dhcp-name:
hostname:
mac:
pxe-boot:
fixed-ip:
dhcp-ops-ten-n1-1000
5f1ffc1a-7f74-441e-879f-9fd9e052b868
fa:16:3e:ad:6c:0d
no
no
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
136
dhcp-interface-add
This command is used to add DHCP services to an interface.
Syntax dhcp-interface-add dhcp-name name-string [ip ip-address]
[netmask netmask] [assignment none|dhcp|dhcpv6] [vlan vlan-id]
[vxlan vxlan-id] if mgmt|data|span [alias-on alias-on-string]
exclusive|no-exclusive nic-enable|nic-disable
dhcp-name name-string
Specify the name of the DHCP service.
Specify any of the following options:
ip ip-address
Specify the IP address of the interface.
netmask netmask
Specify the netmask.
assignment none|dhcp|dhcpv6
Specify the type of assignment.
vlan vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify the type of interface to use for DHCP.
alias-on alias-on-string
Specify an alias name.
exclusive|no-exclusive
Specify if the DHCP host is exclusive to the configuration.
nic-enable|nic-disable
Specify if the corresponding NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, if, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Adds a DHCP service to an interface on the switch.
Examples To add DHCP services to the interface, int1, IP address, 192.168.3.5, use the following
command:
CLI network-admin@switch > dhcp-interface-add dhcp-name int1 ip
192.168.3.5 netmask 255.255.255.0 assignment dhcp if mgmt
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
Pluribus Networks nvOS Version 2.3.2
137
• dhcp-host-show
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
138
dhcp-interface-modify
This command is used to modify DHCP services to an interface.
Syntax dhcp-interface-modify dhcp-name name-string [nic nic-string] [ip
ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6]
[vlan vlan-id] [vxlan vxlan-id] [if mgmt|data|span][alias-on
alias-on-string exclusive|no-exclusive nic-enable|nic-disable
dhcp-name name-string
Specify the name of the DHCP service.
Specify the following interface argument:
nic nic-string
Specify the NIC to modify.
Specify any of the following options:
ip ip-address
Specify the IP address of the interface.
netmask netmask
Specify the netmask.
assignment none|dhcp|dhcpv6
Specify the type of assignment.
vlan vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify the type of port to modify.
alias-on alias-on-string
Specify an alias name.
exclusive|no-exclusive
Specify if the DHCP host is exclusive to the configuration.
nic-enable|nic-disable
Specify if the corresponding NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
History
Usage Modifies a DHCP service to an interface on the switch.
Examples To modify the DHCP services to the interface, int1, IP address, 192.168.3.5, use the following
command:
CLI network-admin@switch > dhcp-interface-modify int1 ip 192.168.3.5
netmask 255.255.255.0 assignment dhcp
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
Pluribus Networks nvOS Version 2.3.2
139
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
140
dhcp-interface-remove
This command is used to remove a DHCP services an interface.
Syntax dhcp-interface-remove dhcp-name name-string [nic nic-string]
dhcp-name name-string
Specify the name of the DHCP service.
Specify the following interface argument:
nic nic-string
Specify the NIC name.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Removes DHCP service information on an interface on the switch.
Examples To remove DHCP services on the interface, int1, from eth0, use the following command:
CLI network-admin@switch > dhcp-interface-remove dhcp-name int1 nic
eth0
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
141
Pluribus Networks nvOS Version 2.3.2
142
dhcp-interface-show
This command is used to display DHCP services to an interface.
Syntax dhcp-interface-modify dhcp-name name-string [nic nic-string] [ip
ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6]
[vlan vlan-id] [vxlan vxlan-id] if mgmt|data|span [alias-on
alias-on-string] [vm-nic-type e1000|virtio]
exclusive|no-exclusive nic-enable|nic-disable nic-state down|up
secondary-macs secondary-macs-string
dhcp-name name-string
Specifies the name of the DHCP service.
Specify the following interface argument:
nic nic-string
Specifies the NIC of the interface.
ip ip-address
Specifies the IP address of the interface.
netmask netmask
Specifies the netmask.
assignment none|dhcp|dhcpv6
Specifies the type of assignment.
vlan vlan-id
Specifies the VLAN identifier.
vxlan vxlan-id
Specifies the VXLAN identifier.
if mgmt|data|span
Specifies the type of interface.
alias-on alias-on-string
Specifies an alias name.
exclusive|no-exclusive
Specifies if the DHCP interface is exclusive to the configuration.
nic-enable|nic-disable
Specifies if the NIC is enabled or disabled.
nic-state down|up
Specifies if the NIC state is up or down.
secondary-macs
secondary-macs-string
Specifies a secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
143
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, nic, and nic-state added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Displays a list of DHCP services to an interface on the switch.
Examples To display the list of DHCP services to interfaces, use the following command:
CLI network-admin@switch > dhcp-interface-show
dhcp-name:
nic:
ip:
assignment:
mac:
vlan:
vxlan:
if:
dhcp-name:
nic:
ip:
assignment:
mac:
vlan:
vxlan:
if:
dhcp-openstack-rn1-1000
openstack.rn1.1000.mgr.eth0
109.1.5.1/24
static
66:0e:94:23:f9:c5
1000
0
data
dhcp-openstack-Tenant-300
openstack.Tenant.300.mgr.eth0
110.1.10.1/24
static
66:0e:94:23:a6:eb
300
0
data
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
Pluribus Networks nvOS Version 2.3.2
144
• dhcp-interface-remove
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
145
Pluribus Networks nvOS Version 2.3.2
146
dhcp-lease-show
This command is used to display information about DHCP leases on the switch.
Syntax dhcp-lease-show [ip ip-address] [mac mac-address][port
port-list] [vlan vlan-id] [db-state
unknow|free|active|backuo|abandoned|expired] [start-time
yyyy-mm-ddThh:mm:ss] [end-time yyyy-mm-ddThh:mm:ss] [server dhcp
name][server-ip ip-address] [server-port
server-port-number][last-msg
-|discover|offer|request|decline|ack|nack|release|inform]
last-msg-time date/time:yyyy-mm-ddThh:mm:ss]
ip ip-address
Specifies the IP address of a DHCP client.
mac mac-address
Specifies the MAC address of a DHCP client.
port port-list
Specifies the port of a DHCP client.
vlan vlan-id
Specifies the VLAN for the DHCP client.
db-state unknow|free|active|
backup|abandoned|
expired
Specifies the state of a DHCP client’s lease.
start-time yyyy-mm-ddThh:mm:ss The beginning of the DHCP lease.
end-time yyyy-mm-ddThh:mm:ss
Specifies the end of the DHCP lease.
server dhcp name
Specifies the name of the DHCP server.
server-ip ip-address
Specifies the IP address of the DHCP server.
server-port server-port-number
Specifies the port number of the DHCP server.
Specifies the last message received from the DHCP client.
last-msg |discover|offer|
request|decline|ack|nack|releas
e|inform
last-msg-time
Specifies the time of the last message received from the DHCP client.
date/time:yyyy-mm-ddThh:mm:ss
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
Pluribus Networks nvOS Version 2.3.2
147
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to display information about DHCP leases on the switch.
Examples To display information about the DHCP leases on the switch, use the following command:
CLI network-admin@switch > dhcp-lease-show
switch:
ip:
mac:
port:
vlan:
db-state:
start-time:
end-time:
server:
server-ip:
switch:
ip:
mac:
port:
vlan:
db-state:
start-time:
end-time:
server:
server-ip:
server-port:
last-msg:
last-msg-time:
pleiades25
172.16.23.2
66:0e:94:21:4a:7b
none
11
active
09:17:59
10:17:59
red-dhcp
172.16.23.1
pleiades25
172.16.23.3
00:25:90:63:8a:84
10
11
active
09:20:05
10:20:05
red-dhcp
172.16.23.1
65
ack
09:20:06
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
Pluribus Networks nvOS Version 2.3.2
148
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
149
Pluribus Networks nvOS Version 2.3.2
150
dhcp-pool-add
This command is used to add a DHCP pool to the switch configuration.
Syntax dhcp-pool-add dhcp-name name-string dhcp-ip-pool ip-pool name
[gateway-ip ip-address] [ddns-domain ddns-domain-string] [dns-ip
ip-address] [dns2-ip ip-address] [ddns-domain-rev
ddns-domain-rev-string][ntp-server-ip ip-address]
dhcp-name name-string
Specify the name of the DHCP service.
Specify the following pool arguments:
dhcp-ip-pool ip-pool-name
Specify the name of the DHCP Pool
Specify one or more of the following options:
gateway-ip ip-address
Specify the gateway IP address.
ddns-domain ddns-domain-string If you are using Dynamic DNS, specify the DDNS domain.
dns-ip ip-address
Specify the DNS IP address.
dns2-ip ip-address
If you have a second DNS IP address, specify the IP address.
ddns-domain-rev
ddns-domain-rev-string
Specify the revision of the DDNS domain.
ntp-server-ip ip-address
Specify a NTP server for the DHCP pool.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, dhcp-pool-name, added.
Version 2.2
The parameter, ntp-server, added.
History
Usage Used to add a DHCP pool to the switch configuration.
Examples To add the DHCP group, dhcp-eng, to the DHCP IP Pool, all, with the gateway 10.4.3.1, use
the following command:
CLI network-admin@switch > dhcp-pool-add dhcp-name dhcp-eng
dhcp-ip-pool ip-pool all gateway-ip 10.4.3.1
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
Pluribus Networks nvOS Version 2.3.2
151
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
152
dhcp-pool-modify
This command is used to modify a DHCP pool to the switch configuration.
Syntax dhcp-pool-modify dhcp-name name-string name name-string
[gateway-ip ip-address] [ddns-domain ddns-domain-string] [dns-ip
ip-address] [dns2-ip ip-address] [ddns-domain-rev
ddns-domain-rev-string] [ntp-server-ip ip-address]
dhcp-name name-string
Specify the name of the DHCP service.
Specify the following pool argument:
dhcp-pool-name name-string
Specify the name of the DHCP Pool
Specify one or more of the following options:
gateway-ip ip-address
Specify the gateway IP address.
ddns-domain ddns-domain-string If you are using Dynamic DNS, specify the DDNS domain.
dns-ip ip-address
Specify the DNS IP address.
dns2-ip ip-address
If you have a second DNS IP address, specify the IP address.
ddns-domain-rev
ddns-domain-rev-string
Specify the revision of the DDNS domain.
ntp-server-ip ip-address
Specify a NTP server for the DHCP pool.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, dhcp-pool-name, added.
Version 2.2
The parameter, ntp-server, added.
Usage Used to modify a DHCP pool to the switch configuration.
Examples To modify the gateway IP address, use the following command:
CLI network-admin@switch > dhcp-pool-modify dhcp-name dhcp-eng
dhcp-ip-pool ip-pool all gateway-ip 172.16.21.1
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
Pluribus Networks nvOS Version 2.3.2
153
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
154
dhcp-pool-remove
This command is used to remove information about a DHCP pool to the switch configuration.
Syntax dhcp-pool-remove dhcp-name name-string dhcp-pool-name
name-string
dhcp-name name-string
Specify the name of the DHCP service.
Specify the following pool argument:
dhcp-pool-name name-string
Specify the name of the DHCP Pool.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, dhcp-pool-name, was added.
Usage Used to remove a DHCP information about DHCP pool to the switch configuration.
Examples To remove the DHCP group, dhcp-eng, from the DHCP pool, all, use the following
command:
CLI network-admin@switch > dhcp-pool-remove dhcp-name dhcp-all
dhcp-pool-name dhcp-eng
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
155
Pluribus Networks nvOS Version 2.3.2
156
dhcp-pool-show
This command is used to display information about a DHCP pool on the switch configuration.
Syntax dhcp-pool-show dhcp-name name-string dhcp-pool-name
dhcp-pool-name-string dhcp-ip-pool ip-pool name [gateway-ip
ip-address] [ddns-domain ddns-domain-string] [dns-ip ip-address]
[dns2-ip ip-address] [ddns-domain-rev
ddns-domain-rev-string][kickstarts-url url-string][auto_if
auto_if-string][ntp-server-ip ip-address]
dhcp-name name-string
Specifies the name of the DHCP service.
Specify the following pool arguments:
dhcp-pool-name
dhcp-pool-name-string
Specifies the name of the DHCP pool.
dhcp-ip-pool ip-pool-name
Specifies the name of the IP pool
gateway-ip ip-address
Specifies the gateway IP address.
ddns-domain ddns-domain-string If you are using Dynamic DNS, Specifies the DDNS domain.
dns-ip ip-address
Specifies the DNS IP address.
dns2-ip ip-address
If you have a second DNS IP address, Specifies the IP address.
ddns-domain-rev
ddns-domain-rev-string
Specifies the revision of the DDNS domain.
kickstarts-url url-string
Specifies the URL for the kickstart file.
auto_if auto_if-string
Specifies the auto interface.
ntp-server-ip ip-address
Specifies a NTP server for the DHCP pool.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
157
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, dhcp-pool-name, was added.
Version 2.2
The parameter, ntp-server, added.
Usage Used to modify a DHCP pool on the switch.
Examples To display all entries for all DHCP pools, use the following command:
CLI (network-admin@pleiades25) > dhcp-pool-show
dhcp-name
dhcp-pool-name dhcp-ip-pool start-ip
gateway-ip ddns-domain
end-ip
----------- -------------- ------------ ----------- ----------------------- ----------redhat-dhcp redhat-pool
172.16.23.1
redhat-pool
172.16.23.1 172.16.23.254
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
Pluribus Networks nvOS Version 2.3.2
158
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
159
Pluribus Networks nvOS Version 2.3.2
160
dhcp-pxe-menu-add
This command is used to configure preboot execution environment (PXE) parameters on the switch.
Syntax dhcp-pxe-menu-add dhcp-name name-string [name name-string]
[iso-library iso-library-name] [iso-label iso-image-name]
[kernel-iso-path kernel-iso-path-string] [initrd-iso-path
initrd-iso-path] [append append-string] [menu-label
menu-label-string][dhcp-interface dhcp-interface-nic]
dhcp-name name-string
Specify the DHCP name.
Specify the following pxe-menu arguments:
name name-string
Specify the name of PXE menu.
iso-label iso-image-name
Specify the name of the ISO image.
kernel-iso-path
kernel-iso-path-string
Specify the ISO path for the kernel.
initrd-iso-path initrd-iso-path
Specify the ISO path.
append append-string
Specify the append type.
Specify the following pxe-menu options:
menu-label menu-label-string
Specify the menu label.
dhcp-interface dhcp-interface-nic Specify the DHCP interface to add the PXE menu.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, iso-library, deprecated.
Usage Preboot Execution Environment (PXE) uses technologies that ensure a common and consistent
set of pre-boot services. Using this command adds a menu item for DHCP and PXE on the
switch.
Examples To add centOS-6.2-amd64-install as a PXE boot menu item, use the following command:
CLI network-admin@switch > dhcp-pxe-menu-add dhcp-name all name
centOS-6.2-amd64-install
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
Pluribus Networks nvOS Version 2.3.2
161
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
162
dhcp-pxe-menu-modify
This command is used to modify DHCP preboot execution environment (PXE) parameters on the switch.
Syntax dhcp-pxe-menu-modify dhcp-name name-string [name name-string]
[iso-library iso-library-name] [iso-label iso-image-name]
[kernel-iso-path kernel-iso-path-string] [initrd-iso-path
initrd-iso-path] [append append-string] [menu-label
menu-label-string][dhcp-interface dhcp-interface-nic]
dhcp-name name-string
Specify the name of the DHCP group.
Specify the following pxe-menu arguments:
name name-string
Specify the name for the PXE menu item.
Specify the following pxe-menu options:
iso-label iso-image-name
Specify the ISO label.
kernel-iso-path
kernel-iso-path-string
Specify the path for the ISO kernel.
initrd-iso-path initrd-iso-path
Specify the initial path read for the ISO.
append append-string
Specify the append string.
menu-label menu-label-string
Specify the menu label for PXE.
dhcp-interface dhcp interface nic
Specify a specific DHCP interface to use for PXE booting from the
switch.
Syntax None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, dhcp-interface, was added.
Version 2.2
The parameter, iso-library, deprecated.
Usage Preboot Execution Environment (PXE) uses technologies that ensure a common and consistent
set of pre-boot services. Using this command modifies information about how DHCP and PXE
are configured on the switch.
Examples To modify the PXE menu with DHCP name, pxedhcp, to use the ISO library name,
centos-all, use the following command:
CLI network-admin@switch > dhcp-pxe-menu-modify dhcp-name pxedhcp name
centOS-6.2-amd64-install iso-library centos-all
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
Pluribus Networks nvOS Version 2.3.2
163
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-add
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
164
dhcp-pxe-menu-remove
This command is used to remove preboot execution environment (PXE) parameters on the switch.
Syntax dhcp-pxe-menu-remove dhcp-name name-string name name-string
dhcp-name name-string
Specify the name of the DHCP item to remove.
Specify the following pxe-menu arguments:
Specify the name of the menu item.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Preboot Execution Environment (PXE) uses technologies that ensure a common and consistent
set of pre-boot services. Using this command adds a menu item for DHCP and PXE on the
switch.
Examples To remove centOS-6.2-amd64-install as a PXE boot menu item, use the following command:
CLI network-admin@switch > dhcp-pxe-menu-remove dhcp-name all name
centOS-6.2-amd64-install
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-show
Pluribus Networks nvOS Version 2.3.2
165
Pluribus Networks nvOS Version 2.3.2
166
dhcp-pxe-menu-show
This command is used to display information about DHCP preboot execution environment (PXE)
parameters on the switch.
Syntax dhcp-pxe-menu-show dhcp-name name-string [name name-string]
[iso-library iso-library-name] [iso-label iso-image-name]
[kernel-iso-path kernel-iso-path-string] [initrd-iso-path
initrd-iso-path] [append append-string] [menu-label
menu-label-string] iso-url iso-url-string dhcp-interface dhcp
interface nic
dhcp-name name-string
Specifies the name of the DHCP group.
Specify the following pxe-menu arguments:
name name-string
Specifies the name for the PXE menu item.
iso-label iso-image-name
Specifies the ISO label.
kernel-iso-path
kernel-iso-path-string
Specifies the path for the ISO kernel.
initrd-iso-path initrd-iso-path
Specifies the initial path read for the ISO.
append append-string
Specifies the append string.
menu-label menu-label-string
Specifies the menu label for PXE.
iso-url iso-url-string
Specifies the URL for the ISO image.
dhcp-interface dhcp interface nic
Specifies a DHCP interface for the PXE menu.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
167
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, iso-library, deprecated.
History .
Usage Preboot Execution Environment (PXE) uses technologies that ensure a common and consistent set
of pre-boot services. Using this command displays information about how DHCP and PXE are
configured on the switch.
Examples To display information about all PXE menus, use the following command:
CLI network-admin@switch > dhcp-pxe-menu-show layout vertical
See Also
• dhcp-create
• dhcp-delete
• dhcp-migrate
• dhcp-modify
• dhcp-show
• dhcp-host-add
• dhcp-host-remove
• dhcp-host-show
• dhcp-interface-add
• dhcp-interface-modify
• dhcp-interface-remove
• dhcp-interface-show
• dhcp-lease-show
• dhcp-pool-add
• dhcp-pool-modify
• dhcp-pool-remove
• dhcp-pool-show
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
• dhcp-pxe-menu-add
• dhcp-pxe-menu-modify
Pluribus Networks nvOS Version 2.3.2
168
disk-library-modify
This command is used to modify sharing ISO images in the disk library on the switch.
Syntax disk-library-modify name name-string
name name-string
The name of the disk library to modify sharing permissions.
sharing none|stftp|nfs
Select the type of sharing or you can configure the library as
unshared.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a disk library to store
application disk images natively on the network. Use this command to modify a disk library.
Examples To configure the disk library, updates, as sharing via NFS, use the following command:
CLI network-admin@switch > disk-library-modify name updates sharing nfs
See Also
• disk-library-image-add
• disk-library-image-export
• disk-library-image-import
• disk-library-image-remove
• disk-library-image-show
• disk-library-imports-show
Pluribus Networks nvOS Version 2.3.2
169
Pluribus Networks nvOS Version 2.3.2
170
disk-library-show
This command is used to display information about disk library properties.
Syntax disk-library-show [name name-string] [storage-pool
storage-pool-name] [data-set data-set-string] [sharing
none|sftp|nfs] [import-share import-share-string]
[import-share-path import-share-path-string] [export-share
export-share-string] [export-share-path
export-share-path-string]
name name-string
Specifies the name of the disk library.
storage-pool storage-pool-name
Specifies the name of the storage pool
data-set data-set-string
Specifies the type of data contained in the library
sharing none|sftp|nfs
Specifies the type of sharing assigned to the library
import-share import-share-string
Specifies the location of the import share
import-share-path
import-share-pathstring
Specifies the import share path on the switch.
export-share export-share-string
Specifies the location of the export share
export-share-path
export-share-pathstring
Specifies the export share path on the switch.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
171
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, dedup and no-dedup, is deprecated.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a disk library to store
application disk images natively on the network. Use this command to display a disk library.
Examples To display all information about disk libraries, use the following command:
CLI network-admin@switch > disk-library-show
switch:
name:
storage-pool:
data-set:
sharing:
import-share:
import-share-path:
export-share:
export-share-path:
switch:
name:
storage-pool:
data-set:
sharing:
import-share:
import-share-path:
export-share:
export-share-path:
pubdev03
disk-lib-pool-disk4
pool-disk4
pool-disk4/disk-lib-pool-disk4
nfs
pubdev03:/disk-lib/pool-disk4/import
/disk-lib/pool-disk4/import
pubdev03:/disk-lib/pool-disk4/export
/disk-lib/pool-disk4/export
pubdev03
disk-lib-pool-disk5
pool-disk5
pool-disk5/disk-lib-pool-disk5
nfs
pubdev03:/disk-lib/pool-disk5/import
/disk-lib/pool-disk5/import
pubdev03:/disk-lib/pool-disk5/export
/disk-lib/pool-disk5/export
See Also
• disk-library-modify
• disk-library-image-add
• disk-library-image-export
• disk-library-image-import
• disk-library-image-remove
• disk-library-image-show
• disk-library-imports-show
Pluribus Networks nvOS Version 2.3.2
172
disk-library-image-add
This command is used to add blank disk image of a specific size to the disk library on the switch.
Syntax disk-library-image-add disk-library-name name-string
[image-label label-string] [image-size size-number]
disk-library-name name-string
Specify a name for the disk library.
Specify the following image arguments:
image-label label-string
Specify the label of the image file.
image-size size-number
Specify the size of the image file.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, image-library, deprecated.
Usage Use this command to add extra disk space to existing VMs.
Examples This example shows how to add an extra blank disk named 30G-host to the disk library
MyDiskLibrary.
CLI network-admin@switch > disk-library-image-add disk-library-name
MyDiskLibrary image-label 30G-host image-size 30
See Also
• disk-library-image-export
• disk-library-image-import
• disk-library-image-remove
• disk-library-image-show
Pluribus Networks nvOS Version 2.3.2
173
Pluribus Networks nvOS Version 2.3.2
174
disk-library-image-clone
This command is used to clone a disk image to another location on a switch.
Syntax disk-library-image-clone disk-library-name name-string
image-label label-string image-parent-label disk-image-label
image-destination-switch fabric-node-name image-library
disk-library-name
disk-library-name
name-string
Specify the name of the disk library to clone.
image-label label-string Specify the image label.
image-parent-label
disk-image-label
Specify the disk image label of the parent image.
image-destination-switch Specify the destination switch for the cloned
fabric-node-name
image.
image-library
disk-library-name
Specify the name of the disk library.
Defaults None
Access network-admin
History Command introduced in Version 2.3.
Usage Use this command to clone a disk image from one switch to another switch.
Examples To clone the disk image, netvisor-vm-test-hda, to switch pleiades25, use the
following syntax:
CLI network-admin@switch > disk-library-image-clone disk-library-name
disk-lib-vnet1 image-label netvisor-vm-test-hda image-parent-label
netvisor-vm-test-hda1 image-destination-switch pleiades25
image-library disk-lib-pool-disk4
Pluribus Networks nvOS Version 2.3.2
175
Pluribus Networks nvOS Version 2.3.2
176
disk-library-image-export
This command is used to export images from the disk library on the switch to an image library.
Syntax disk-library-image-export disk-library-name name-string
[image-label label-string][image-library library-string]
[image-file file-string] image-parent_label disk-image-label
[image-size size-number
disk-library-name name-string
Specify a name for the disk library.
Specify the following image arguments:
image-label label-string
Specify the label of the image file.
Specify the following image options:
image-library library-string
Specify the name of the image library.
image-file file-string
Specify the name of the image file.
image-parent_label
disk-image-label
Specify the disk image label of the parent image.
image-size size-number
Specify the size of the image file.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, image-parent-label, added.
Usage Each fabric, cluster, standalone switch, or virtual network can provide its tenants with a disk
library to store application disk images natively in the network. This command exports a disk
image to an existing disk library.
Examples This example shows how to export a disk image named MyCentOSImage to the disk library
MyDiskLibrary.
CLI network-admin@switch > disk-library-image-export disk-library-name
MyDiskLibrary image-label MyCentOSImage
See Also
• disk-library-image-add
• disk-library-image-import
• disk-library-image-remove
• disk-library-image-show
Pluribus Networks nvOS Version 2.3.2
177
Pluribus Networks nvOS Version 2.3.2
178
disk-library-image-import
This command is used to import virtual disk images to the disk library on the switch. Once you import
the disk image, you can create a VM by using the imported image as the hda-label for the VM.
Syntax disk-library-image-import disk-library-name name-string
[image-label label-string] [image-file file-string]
[image-library library-string] [image-size size-number
disk-library-name name-string
Specify a name for the disk library.
Specify the following image arguments:
image-label label-string
Specify the label of the image file.
image-file file-string
Specify the name of the image file.
Specify the following image options:
image-library library-string
Specify the name of the image library.
image-size size-number
Specify the size of the image file.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or virtual network can provide its tenants with a disk
library to store application disk images natively in the network. This command exports a disk
image to an existing disk library.
Examples This example shows how to import a disk image named MyCentOSImage to the disk library
MyDiskLibrary.
CLI network-admin@switch > disk-library-image-import disk-library-name
MyDiskLibrary image-label MyCentOSImage image-sharing nfs
See Also
• disk-library-image-add
• disk-library-image-export
• disk-library-image-remove
• disk-library-image-show
Pluribus Networks nvOS Version 2.3.2
179
Pluribus Networks nvOS Version 2.3.2
180
disk-library-image-remove
This command is used to remove disk images from the disk library on the switch.
Syntax disk-library-image-remove disk-library-name name-string
[image-label label-string]
disk-library-name name-string
Specify a name for the disk library.
Specify the following image arguments:
image-label label-string
Specify the label of the image file.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, image-size, deprecated.
Usage Each fabric, cluster, standalone switch, or virtual network can provide its tenants with a disk
library to store application disk images natively in the network. This command exports a disk
image to an existing disk library.
Examples This example shows how to remove a disk image named MyCentOSImage from the disk
library MyDiskLibrary.
CLI network-admin@switch > disk-library-image-remove disk-library-name
MyDiskLibrary image-label MyCentOSImage image-sharing nfs image-dedup
yes
See Also
• disk-library-image-add
• disk-library-image-export
• disk-library-image-import
• disk-library-image-show
Pluribus Networks nvOS Version 2.3.2
181
Pluribus Networks nvOS Version 2.3.2
182
disk-library-image-show
This command is used to display ISO images in the disk library on the switch.
Syntax disk-library-image-show disk-library-name name-string
[image-library library-string] [image-label label-string]
[image-file file-string] [image-size size-number]
disk-library-name name-string
Specifies a name for the disk library.
Specify the following image arguments:
image-label label-string
Specifies the label of the image.
image-library library-string
Specifies the name of the image library.
image-file file-string
Specifies the name of the image file.
image-parent_label
disk-image-label
Specify the disk image label of the parent image.
image-size size-number
Specifies the size of the image file.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
183
History
Version 1.2
Command introduced.
Version 2.1
The parameter, image-parent-label, added.
Usage Each fabric, cluster, standalone switch, or virtual network can provide its tenants with a disk
library to store application disk images natively in the network. This command exports a disk
image to an existing disk library.
Examples his example shows how to display a list of disk images in the disk library MyDiskLibrary
CLI network-admin@switch > disk-library-image-show
switch disk-library-name
------ ---------------------Leaf2 disk-lib-pool-disk4
Leaf2 disk-lib-pool-disk4
Leaf2 disk-lib-pool-disk4
Leaf2 disk-lib-pool-disk4
label
file
size
------------------------ -------------vThunder
vThunder
Fortinet2
Fortinet-disk1
Fortinet-disk1
netvisor-vm-vThunder-hda
See Also
• disk-library-image-add
• disk-library-image-export
• disk-library-image-import
• disk-library-image-remove
Pluribus Networks nvOS Version 2.3.2
184
8G
30G
2G
15G
disk-library-imports-show
This command is used to display information about ISO images in the disk library on the switch.
Syntax disk-library-imports-show name name-string [imports-name
name-string]
name name-string
Specifies the name of the disk library.
Specify the following import arguments:
imports-name name-string
Specifies the name of the imports.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a disk library to store
application disk images natively on the network. Use this command to display a list of images
imported into the disk library.
Pluribus Networks nvOS Version 2.3.2
185
Examples To display a list of images, use the following command:
CLI network-admin@switch > disk-library-imports-show
switch
-----Leaf2
Leaf2
Leaf2
Leaf2
name
-------------------------vThunder_acos4.0-disk1.img
fortinet-new.img
fortios.img
fortios_raw2.img
See Also
• disk-library-image-import
Pluribus Networks nvOS Version 2.3.2
186
dns-create
This command allows you to configure a DNS service on the switch.
Syntax dns-create name name-string vnet vnet-name
[dedicated-vnet-service|shared-vnet-service][enable|disable]
[storage-pool storage-pool-name]
name name-string
Specify the name of the DNS service.
vnet vnet-name
Specify the VNET name to apply the DNS service.
Specify any of the following DNS options:
dedicated-vnet-service|shared-v
net-service
Specify the service to be dedicated to a VNET or shared between
VNETs.
enable|disable
Enable or disable the service.
storage-pool storage-pool-name
Specify the storag pool name.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to configure a DNS service as a
dedicated or shared service on a vnet.
Examples To create a dedicated DNS service, dns-net1, on vnet local, use the following command:
CLI network-admin@switch > dns-create dns-net1 vnet local
dedicated-service
See Also
• dns-create
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-add
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
187
Pluribus Networks nvOS Version 2.3.2
188
dns-delete
This command is used to remove a DNS service from the switch.
Syntax dns-delete name name-string
name name-string
The name of the DNS service to delete from the configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to delete a DNS servic.
Examples To delete the DNS service, dns-local, use the following command:
CLI network-admin@switch > dns-delete dns-local
See Also
• dns-create
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-add
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
189
Pluribus Networks nvOS Version 2.3.2
190
dns-migrate
This command is used to migrate a DNS service between two locations.
Syntax dns-migrate name name-string location fabric-node-name
storage-pool storage-pool-name
name name-string
Specify the name o f the DNS service to migrate.
Specify one or both of the following DNS arguments:
location fabric-node-name
Specify the location of the DNS service
storage-pool storage-pool-name
Specify the storage pool information
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to migrate a DNS service.
Examples To migrate the DNS service, MyDNS, to the fabric, pn-fabric use the following command:
CLI network-admin@switch > dns-migrate name MyDNS location pn-fabric
See Also
• dns-create
• dns-delete
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
191
Pluribus Networks nvOS Version 2.3.2
192
dns-modify
This command is used to modify a DNS service.
Syntax dns-modify name name-string disable|enable gateway ip-address
name name-string
Specify the name of the DNS service.
Specify one or more of the following DNS arguments:
disable|enable
Specify if the service is disabled or enabled.
gateway ip-address
Specify the gateway IP address for the service.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to modify information about DNS
services configured on the switch.
Examples To disable the DNS service, MyDNS, use the following command:
CLI network-admin@switch > dns-modify name MyDNS disable
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-show
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
193
Pluribus Networks nvOS Version 2.3.2
194
dns-show
This command allows you to display information about a DNS service on the switch.
Syntax dns-show id name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|natope
nstack|netvmm|ovs][scope local|fabric] [vnet vnet-name][location
fabric-node name]
id
Specifies the identifier associate d with the DNS service.
name name-string
Specifies the name of the DNS service.
Specifies the network type.
type
vnet-mgr|vrouter|vlb|dhcp|dns|
netzone|ofpd|orphaned|netvm|
nat|
openstack|netvmm|ovs]
scope local|fabric
Specifies the scope.
vnet vnet-name
Specifies the VNET name.
location fabric-node name
Specifies the location of the DNS service.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Pluribus Networks nvOS Version 2.3.2
195
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The options, openstack|netvmm, added to the parameter
type.
Version 2.2.2
The option, ovs, added for the parameter type.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to translate
hostnames into IP addresses. Use this command to display information about DNS services
configured on the switch.
Examples To display information about all DNS services on the switch, use the following command:
CLI network-admin@switch > dns-show
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
196
dns-domain-add
This command is used to add a DNS domain to the switch configuration.
Syntax dns-domain-add dns-name name-string domain domain-string [type
master|slave] dns-ip ip-address [reverse-lookup-ip-pool
ip-pool-name] [reverse-lookup-network ip-address]
[reverse-lookup-netmask netmask] [forwarding none|first}only]
[forwarder ip-address]
dns-name name-string
Specify the name of the DNS service to add to the configuration.
Specify any of the following domain arguments:
domain domain-string
Specify the name of the DNS domain to add to the confguration.
type master|slave
Specify the type of DNS domain as master or slave.
dns-ip ip-address
Specify the IP Address of the DNS service.
reverse-lookup-ip-pool
ip-pool-name
Specify the IP address pool used for reverse lookups on the
network.
reverse-lookup-network ip-address Specify the IP address to use for reverse lookups on the network.
reverse-lookup-netmask netmask
Specify the netmask for the IP address.
forwarding none|first}only
Specify the forwarding options.
forwarder ip-address
Specify the forwarder IP address.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to add a DNS domain from the
confguration.
Examples To add the DNS domain service, MyDNS, with the domain, mydns.com, as the master with
the IP address of 208.74.182.229, use the following command:
CLI network-admin@switch > dns-domain-add dns-name MyDNS domain
mydns.com type master dns-ip 208.74.182.229
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
Pluribus Networks nvOS Version 2.3.2
197
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
198
dns-domain-modify
This command is used to modify a DNS domain to the switch configuration.
Syntax dns-domain-modify dns-name name-string domain domain-string
[type master|slave] dns-ip ip-address [reverse-lookup-ip-pool
ip-pool-name] [reverse-lookup-network ip-address]
[reverse-lookup-netmask netmask] [forwarding none|first}only]
[forwarder ip-address]
dns-name name-string
Specify the name of the DNS service to add to the configuration.
Specify any of the following domain arguments:
domain domain-string
Specify the name of the DNS domain to add to the confguration.
Specify any of the following domain options:
type master|slave
Specify the type of DNS domain as master or slave.
dns-ip ip-address
Specify the IP Address of the DNS service.
reverse-lookup-ip-pool
ip-pool-name
Specify the IP address pool used for reverse lookups on the network.
reverse-lookup-network
ip-address
Specify the IP address to use for reverse lookups on the network.
reverse-lookup-netmask netmask Specify the netmask for the IP address.
forwarding none|first}only
Specify the forwarding options.
forwarder ip-address
Specify the forwarder IP address.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to modify a DNS domain from the
confguration.
Examples To modify the DNS service, MyDNS, to be the slave instead of the master, use the following
command:
CLI network-admin@switch > dns-domain-modify dns-name MyDNS type slave
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
Pluribus Networks nvOS Version 2.3.2
199
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
200
dns-domain-remove
This command is used to remove a DNS domain from the switch configuration.
Syntax dns-domain-remove dns-name name-string domain domain-string
dns-name name-string
Specify the name of the DNS service that you want to remove from
the configuration.
Specify the following domain argument:
domain domain-string
Specify the name of the DNS domain that you want to remove from
the configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to remove a DNS domain from the
confguration.
Examples To remove the DNS service, dns-home, and the domain, local, use the following command:
CLI network-admin@switch > dns-domain-remove dns-name dns-home domain
local
See Also
 dns-create
 dns-delete
 dns-migrate
 dns-modify
 dns-show
 dns-domain-add
 dns-domain-modify
 dns-domain-show
 dns-interface-add
 dns-interface-modify
 dns-interface-remove
 dns-interface-show
 dns-record-remove
 dns-record-show
Pluribus Networks nvOS Version 2.3.2
201
Pluribus Networks nvOS Version 2.3.2
202
dns-domain-show
This command is used to display a DNS domain configuration on the switch.
Syntax dns-domain-show dns-name name-string domain domain-string [type
master|slave] dns-ip ip-address [reverse-lookup-ip-pool
ip-pool-name] [reverse-lookup-network ip-address]
[reverse-lookup-netmask netmask] [forwarding none|first}only]
[forwarder ip-address] mirror-peer dns name
dns-name name-string
Specifies the name of th e DNS service to add to the configuration.
Specify the following domain arguments:
domain domain-string
Specifies the name of the DNS domain to add to the confguration.
type master|slave
Specifies configure the type of DNS domain as master or slave.
dns-ip ip-address
Specifies the IP Address of the DNS service.
reverse-lookup-ip-pool
ip-pool-name
Specifies the IP address pool used for reverse lookups on the
network.
reverse-lookup-network
ip-address
Specifies the IP address to use for reverse lookups on the network.
reverse-lookup-netmask netmask Specifies the netmask for the IP address.
forwarding none|first}only
Specifies the forwarding options.
forwarder ip-address
Specifies the forwarder IP address.
mirror-peer dns name
Specifies the mirrored peer DNS name.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
203
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to translate
hostnames into IP addresses. Use this command to display information about DNS on the switch.
Examples To display information about all DNS services on the switch, use the following command:
CLI network-admin@switch > dns-show
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
204
dns-interface-add
This command is used to add a DNS interface to the switch configuration.
Syntax dns-interface-add dns-name name-string [ip ip-address] [netmask
netmask] [assignment none|dhcp|dhcpv6] [vlan vlan-id] [vxlan
vxlan-id] [if mgmt|data|span] [alias-on alias-on-string]
exclusive|no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
dns-name name-string
Specifies the DNS name.
Specify any of the following DNS options:
ip ip-address
Specifies the IP address.
netmask netmask
Specifies the netmask.
assignment none|dhcp|dhcpv6
Specifies the method that the interface uses to assign IP
addresses.
vlan vlan-id]
Specifies the VLAN assigned to the interface.
vxlan vxlan-id
Specifies the VXLAN, if configured.
if mgmt|data|span
Specifies the port method.
alias-on alias-on-string
Specify an alias name.
exclusive|
no-exclusive
Specify if the DHCP host is exclusive to the configuration.
nic-enable|
nic-disable
Specify if the corresponding NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, and NIC are added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to remove a DNS interface from the
configuration. Use this command to add a DNS interface to the switch.
Examples To add the DNS interface, MyDNS, IP address 172.25.21.3/32 and assign IP addresses using
DHCP to VLAN 39, use the following command:
CLI network-admin@switch > dns-interface-add dns-name MyDNS ip
172.25.21.3/32 vlan 39
See Also
• dns-create
• dns-delete
• dns-migrate
Pluribus Networks nvOS Version 2.3.2
205
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
206
dns-interface-modify
This command is used to modify a DNS interface in the switch configuration.
Syntax dns-interface-modify dns-name name-string [ip ip-address]
[netmask netmask] [assignment none|dhcp|dhcpv6] [vlan vlan-id]
[vxlan vxlan-id] [if mgmt|data|span] [alias-on alias-on-string]
exclusive|no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
dns-name name-string
Specify the DNS name.
Specify the following interface argument:
Specify the NIC name.
nic nic-string
Specify any of the following DNS options:
ip ip-address
Specify the IP address.
netmask netmask
Specify the netmask.
assignment none|dhcp|dhcpv6
Specify the method that the interface uses to assign IP addresses.
vlan vlan-id]
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Specify the VXLAN, if configured.
if mgmt|data|span
Specify the port method.
alias-on alias-on-string
Specify a configured alias for the interface.
exclusive|no-exclusive
Specify if the DHCP host is exclusive to the configuration.
nic-enable|nic-disable
Specify if the corresponding NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, and NIC are added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to remove a DNS interface from the
configuration. Use this command to modify a DNS interface on the switch.
Examples To modify the DNS interface, MyDNS, to use the IP address 172.25.21.3/32, use the following
command:
CLI network-admin@switch > dns-interface-modify dns-name MyDNS ip
172.25.21.3/32 vlan 31
See Also
• dns-create
• dns-delete
Pluribus Networks nvOS Version 2.3.2
207
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
208
dns-interface-remove
This command is used to remove a DNS interface from the switch configuration.
Syntax dns-interface-remove dns-name name-string nic nic-string
dns-name name-string
Specify the name of the DNS service.
Specify the following interface argument:
nic nic-string
Specify the NIC name.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to remove a DNS interface from the
configuration.
Examples To remove the interface MyDNS, use the following command:
CLI network-admin@switch > dns-interface-remove dns-name MyDNS nic eth0
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
209
Pluribus Networks nvOS Version 2.3.2
210
dns-interface-show
This command is used to display a DNS interface in the switch configuration.
Syntax dns-interface-show dns-name name-string [ip ip-address] [netmask
netmask] [assignment none|static|dhcp|dhcpv6] [mac mac-address]
[vlan vlan-id] [vxlan vxlan-id] [if mgmt|data|span] [alias-on
alias-on-string] [exclusive|no-exclusive]
[nic-enable|nic-disable] [nic-state down|up] secondary-macs
secondary-macs-string
dns-name name-string
Specifies the DNS name.
Specify the following interface argument:
nic nic-string
Specifies the NIC associated with the DNS interface.
ip ip-address
Specifies the IP address.
netmask netmask
Specifies the netmask.
assignment
none|static|dhcp|dhcpv6
Specifies the method that the interface uses to assign IP addresses.
mac mac-address
Specifies the MAC address of the interface.
vlan vlan-id]
Specifies the VLAN assigned to the interface.
vxlan vxlan-id
Specifies the VXLAN, if configured.
if mgmt|data|span
Specifies the port method.
alias-on alias-on-string
Specifies a configured alias for the interface.
exclusive|no-exclusive
Specifies if the DHCP host is exclusive to the configuration.
nic-enable|nic-disable
Specifies if the corresponding NIC is enabled or disabled.
nic-state down|up
Specifies if the NIC is up or down.
secondary-macs
secondary-macs-string
Specifies a secondary MAC address.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
Pluribus Networks nvOS Version 2.3.2
211
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, nic-state, and NIC are added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to translate
hostnames into IP addresses. Use this command to show configuration information about a DNS
interface on the switch.
Examples To display all information about all DNS interfaces, use the following command:
CLI network-admin@switch > dns-interface-show layout vertical
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
212
dns-record-add
This command is used to add a DNS record to the switch configuration.
Syntax dns-record-add dns-name name-string [domain dns] host
host-string ip ip-address
dns-name name-string
Specify the DNS name.
Specify the following record arguments:
domain dns
Specify the DNS domain.
host host-string
Specify the host.
ip ip-address
Specify the IP address.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to add a hostname to the DNS
records.
Examples To add the DNS service, MyDNS, use the following command:
CLI network-admin@switch > dns-record-add MyDNS ip 208.74.182.119 host
mydns1
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-remove
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
213
Pluribus Networks nvOS Version 2.3.2
214
dns-record-remove
This command is used to remove a DNS record from the configuration.
Syntax dns-record-remove dns-name name-string host host-string
dns-name name-string
Specify the DNS name.
Specify the following record arguments:
host host-string
Specify the DNS host.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to remove a hostname from the DNS
records.
Examples To remove the DNS record, MyDNS, use the following command:
CLI network-admin@switch > dns-record-remove MyDNS host mydns.com
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-add
• dns-record-show
Pluribus Networks nvOS Version 2.3.2
215
Pluribus Networks nvOS Version 2.3.2
216
dns-record-show
This command is used to display a DNS record to the switch configuration.
Syntax dns-record-add dns-name name-string domain dns domain domain host
host-string ip ip-address
dns-name name-string
Specifies the name of the DNS service to display
Specify the following record arguments:
domain dns
Specifies the DNS domain to display
domain domain
Specifies the domain to display
host host-string
Specifies the host information
ip ip-address
Specifies the IP address for the DSN record.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide tenants with a DNS service to
translate hostnames into IP addresses. Use this command to display information about DNS
records.
Pluribus Networks nvOS Version 2.3.2
217
Examples To display information about an existing DNS service named MyDNS, use the following
command:
CLI network-admin@switch > dns-record-show MyDNS layout vertical
See Also
• dns-create
• dns-delete
• dns-migrate
• dns-modify
• dns-show
• dns-domain-add
• dns-domain-modify
• dns-domain-remove
• dns-domain-show
• dns-interface-add
• dns-interface-modify
• dns-interface-remove
• dns-interface-show
• dns-record-add
• dns-record-remove
Pluribus Networks nvOS Version 2.3.2
218
E Commands
ecp-port-show
Displays information about the Edge Control Protocol (ECP) port.
Syntax ecp-port-show [port port-list][ipkts ipkts-number] [opkts
opkts-number] [timeouts timeouts-number] [retransmits
retransmits-number] [tx-errors tx-errors-number] [last-rx-seqno
last-rx-seqno-number] [last-ack-seqno last-ack-seqno-number]
port port-list
Specifies the ports.
ipkts ipkts-number
Specifies the inbound packets.
opkts opkts-number
Specifies the outbound packets.
timeouts
timeouts-number
Specifies the number of timeouts.
retransmits
retransmits-number
Specifies the number of retransmits.
tx-errors
tx-errors-number
Specifies the number of transmit errors.
last-rx-seqno
last-rx-seqno-number
Specifies the last received sequence number.
last-ack-seqno
last-ack-seqno-number
Specifies the last ACK sequence number.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
219
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Usage Each switch supports ECP. This command shows ECP packet statistics on the local switch.
Examples To display information about ports with Edge Control Protocol, you must first enable VDP, and
then use the following syntax:
CLI network-admin@switch > ecp-port-show format all layout vertical
switch:
port:
ipkts:
opkts:
timeouts:
retransmits:
tx-errors:
last-rx-seqno:
last-ack-seqno:
switch:
port:
ipkts:
opkts:
timeouts:
retransmits:
tx-errors:
last-rx-seqno:
last-ack-seqno:
pubdev01
26
0
0
0
0
0
0
0
pubdev02
26
0
0
0
0
0
0
0
See Also
• vdp-modify
• vdp-show
• vsi-state-show
Pluribus Networks nvOS Version 2.3.2
220
exit
This command allows you to exit the CLI.
Defaults None
Access CLI.
Usage Use this command to exit the CLI.
See Also
• quit
Pluribus Networks nvOS Version 2.3.2
221
Pluribus Networks nvOS Version 2.3.2
222
F Commands
fabric-create
This command is used to create a fabric on the network.
Syntax fabric-create name name-string [vlan vlan-id] [password
password-string] [network-type in-band|mgmt]
[delete-conflicts|abort-on-conflict]
Specify the name of the fabric.
name name-string
Specify any of the following options:
Specify VLAN for the fabric.
vlan vlan-id
password password-string Specify the fabric password.
network-type
in-band|mgmt
Specify the in-band interface or the management
interface to send fabric communications.
delete-conflicts|aborton-conflict
Specify the action to take when there is a conflict with
another fabric.
Defaults If the multicast address is not specified, a random IPv6 address in the range from
ff95::239:4:10:1 to ff95::239:4:10:ff is used as the default fabric multicast address. Unless you
specify a password, the default password for the fabric is blank.
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, mcast-ip, deprecated. The parameter, vlan,
added.
Version 2.2.4
The parameter, network-type, added.
Usage The fabric consists of one or more switches that share a fabric administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. This
command creates the fabric abstraction, but not the switch membership.
Examples To create a fabric named MyFabric with the password b0n3s123
CLI network-admin@switch > fabric-create name MyFabric password
b0n3s123
See Also
• fabric-info
• fabric-join
• fabric-show
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
223
Pluribus Networks nvOS Version 2.3.2
224
fabric-info
This command is used to display information about a fabric on the switch.
Syntax fabric-info
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to display information about the fabric on a local switch.
Examples To display information about a fabric, use the following command:
CLI network-admin@switch > fabric-info
name:
pn-fab
ident:
a1634:b
mcastaddr:ff95::239:4:10:2c
tid:
0
Pluribus Networks nvOS Version 2.3.2
225
See Also
• fabric-create
• fabric-join
• fabric-show
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
226
fabric-join
This command is used to join an existing fabric on the switch.
Syntax fabric-join name name-string switch-ip ip-address [vlan vlan-id]
[password password-string] [delete-conflicts|abort-on-conflict]
repeer-to-cluster-node cluster-repeer-node name
Specify one of the following options:
name name-string
Specify the name of the fabric.
switch-ip ip-address
Specify the IP address of the switch joining the
fabric.
Specify any of the following options:
vlan vlan-id
Specify VLAN for the fabric.
password password-string
Specify the fabric password if configured.
delete-conflicts|
Specify the action to take when there is a conflict
with another fabric.
abort-on-conflict
repeer-to-cluster-node
cluster-repeer-node name
Specify if you want to replace a dead cluster node
by restoring a new switch against the existing
cluster node.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, vlan, added.
Version 2.3
The parameter, repeer-to-cluster-node, added.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to join a fabric.
Examples To join the fabric, network-1, with the id, admin, and the password, pizzatime, use
the following command:
CLI network-admin@switch > fabric-join name network-1 id admin password
pizzatime
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
227
Pluribus Networks nvOS Version 2.3.2
228
fabric-local-modify
This command is used to modify a local fabric on the network.
Syntax fabric-local-modify vlan vlan-id network-type in-band|mgmt
vlan vlan-id
Specify the VLAN to modify on the local fabric.
network-type
in-band|mgmt
Specify the network type as in-band or management.
Defaults The default VLAN for a fabric is VLAN 0.
Access CLI
History Command introduced in nvOS Version 2.2.
Version 2.2
Command introduced.
Version 2.2.4
The parameter, network-type, introduced.
Usage In some network configurations, you may want to assign a different VLAN to a local fabric.
Examples To modify a local fabric and assign it to VLAN 2, use the following syntax:
CLI network-admin@switch > fabric-local-modify vlan 2
See Also
• fabric-info
• fabric-join
• fabric-show
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
229
Pluribus Networks nvOS Version 2.3.2
230
fabric-show
This command is used to display information about a fabric on the switch.
Syntax fabric-show name name-string switch-ip ip-address [id]
repeer-to-cluster-node cluster-repeer-node name [vlan vlan-id]
[network-type in-band|mgmt] [tid tid-number]
name name-string
Specifies the name of the fabric.
switch-ip ip-address
Specify the IP address of the switch joining the fabric.
id
Specifies the identifier for the fabric.
repeer-to-cluster-node
cluster-repeer-node
name
Specifies if the action is to replace a dead cluster node by
restoring against the existing cluster node.
vlan vlan-id
Specifies the VLAN ID for the fabric.
network-type
in-band|mgmt
Specifies the network type as in-band or through the
management interface.
tid tid-number
Specifies the transaction identifier.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Pluribus Networks nvOS Version 2.3.2
231
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameters, multicast-ip, and cid, deprecated.
Version 2.2.8
The parameter, network-type, added.
Version 2.3
The parameter, repeer-to-cluster-node, added.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to display information about the fabric.
Examples To display the fabric, network-1, use the following command:
CLI network-admin@switch > fabric-show name network-1
name:
id:
mcast-ip:
fid:
cid:
network-1
b000043:5152184f
239.4.10.230
149
0
See Also
• fabric-create
• fabric-info
• fabric-join
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
232
fabric-unjoin
This command is used to unjoin an existing fabric on the switch.
Syntax fabric-unjoin [delete-conflicts|abort-on-conflict]
Specify the action to take when there is a conflict with another
fabric.
delete-conflicts|
abort-on-conflict
Defaults None.
Access CLI
License SDF
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to join a fabric.
Examples To join the fabric, network-1, with the id, admin, and the password, pizzatime, use
the following command:
CLI network-admin@switch > fabric-unjoin name network-1 id admin
password pizzatime
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
233
Pluribus Networks nvOS Version 2.3.2
234
fabric-node-evict
This command is used to remove a node from a fabric.
Syntax fabric-node-evict name fabric-node-name id id-number
name fabric-node-name
Specify the name of the fabric node to remove from the
configuration.
id id-number
Specify the identifier of the fabric node.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to remove a node.
Examples To remove the node, ursa123, use the following command:
fabric-node-evict name ursa123
See Also
• fabric-create
• fabric-info
• fabric-join
• fabric-unjoin
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
235
Pluribus Networks nvOS Version 2.3.2
236
fabric-node-show
This command is used to display information about a node from a fabric.
Syntax fabric-node-show name fabric-node-name [id id-string] [serial
serial-string] [name fabric-node-name] [fab-name
fab-name-string] [fab-id] [cluster-id] [fabric-network
in-band|mgmt] [local-mac mac-address] [mgmt-ip ip-address]
[mgmt-netmask netmask] [ [mgmt-mac mac-address]
[mgmt-secondary-mac mac-address] [in-band-ip ip-address]
[in-band-netmask netmask] [in-band-mac mac-address]
[in-band-secondary-mac mac-address] [fab-tid fab-tid-number]
[cluster-tid cluster-tid-number] [out-port out-port-number]
[version version-string] [state
offline|online|fabric_joined|setup-required|fabric-required|
fresh-install] [firmware_upgrade] [device_state] [ports
ports-number]
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
fabric-network
in-band|mgmt
Specifies the fabric network type.
local-mac mac-address
Specifies the local MAC address of the fabric
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.
mgmt-secondary-mac
mac-address
Specifies the secondary MAC address of the management
interface
Specifies the NIC state as down or up.
down|up
in-band-nic nic-string
Specifies the NIC for the in-band interface to the switch control
plane.
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-secondary-mac
mac-address
Specifies the secondary MAC address of the in-band interface
fab-tid fab-tid-number
Specifies the fabric identifier.
cluster-tid
cluster-tid-number]
Specifies the cluster identifier.
Pluribus Networks nvOS Version 2.3.2
237
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 ONVL version.
state offline|online|
fabric_joined|
setup-required|
fabric-required|
fresh-install]
Specifies the state of the fabric.
Specifies if a firmware upgrade is required.
firmware_upgrade
not-required|required|r
eboot-required
device-state
ok|error|simulator
Specifies the state of the switch.
ports ports-number
Specifies the port list used by the fabric.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
238
History Command introduced in nvOS Version 1.2.
Version 1.2
Command introduced.
Version 2.3.2
The parameters, cluster-id, cluster-tid,
The parameter, mgmt-assignment,
mgmt-vm-nic-type, mgmt-nic, mgmt-vxlan,
mgmt-if, mgmt-alias-on, mgmt-vm-nic-type,
mgmt-exclusive, mgmt-nic-enable,
mgmt-nic-state, and corresponding in-band
parameters deprecated.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to display node information.
Examples To display a list of fabrics visible from the local switch, use the following command:
CLI network-admin@switch > fabric-node-show layout vertical
id:
name:
fab-name:
fab-id:
cluster-id:
fab-mcast-ip:
local-mac:
fabric-network:
mgmt-ip:
mgmt-mac:
mgmt-l3-port:
mgmt-secondary-macs:
in-band-ip:
in-band-mac:
in-band-l3-port:
in-band-secondary-macs:
fab-tid:
cluster-tid:
out-port:
version:
state:
firmware-upgrade:
device-state:
ports:
167772208
pubdev01
info-dev
a000030:5537b46c
a000030:1
::
64:0e:94:28:00:8e
in-band
10.9.100.100/16
64:0e:94:28:00:8f
0
192.168.42.10/24
64:0e:94:28:00:8e
0
8
1
0
2.2.202046923,pn-ONVL-2.2.4-2020412306
online
not-required
ok
0
See Also
• fabric-create
• fabric-info
• fabric-join
• fabric-unjoin
• fabric-node-evict
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
239
Pluribus Networks nvOS Version 2.3.2
240
fabric-stats-show
This command is used to display statistical information about the fabric configured on the network.
Syntax fabric-stats-show id id-number servers servers-number storage
storage-number VM VM-number vlan vlan-number vxlan vxlan-number
tcp-syn tcp-syn-number tcp-est tcp-est-number tcp-completed
tcp-completed-number tcp-bytes tcp-bytes-number udp-bytes
udp-bytes-number arp arp-number vlan vlan-id
id id-number
Specifies the ID number automatically assigned to the
fabric.
servers servers-number
Specifies the number of servers in the fabric.
storage storage-number
Specifies the storage occupying the fabric.
VM VM-number
Specifies the number of VMs in the fabric.
vlan vlan-number
Specifies the number of VLANs in the fabric.
vxlan vxlan-number
Specifies the number of VXLANs in the fabric.
tcp-syn tcp-syn-number
Specifies the number of TCP packets synchronized by
the fabric.
tcp-est tcp-est-number
Specifies the number of TCP packets estimated on the
network.
tcp-completed
tcp-completed-number
Specifies the number of completed TCP packets.
tcp-bytes
tcp-bytes-number
Specifies the number of TCP bytes sent through the
fabric.
udp-bytes
udp-bytes-number
Specifies the number of UDP bytes sent through the
fabric.
arp arp-number
Specifies the number of ARPs on the fabric.
vlan vlan-id
Specifies the VLAN ID.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
Pluribus Networks nvOS Version 2.3.2
241
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display statistical information about the fabric configured on the network.
Examples To display the statistics about the fabric, use this command:
CLI network-admin@switch > fabric-stats-show layout vertical
switch:
id:
servers:
storage:
VM:
vxlan:
tcp-syn:
tcp-est:
tcp-completed:
tcp-bytes:
udp-bytes:
arp:
vlan:
pleiades25
0
0
0
0
0
294
51
67
149
0
0
0
See Also
• fabric-info
• fabric-join
• fabric-show
• fabric-unjoin
• fabric-node-evict
• fabric-node-show
Pluribus Networks nvOS Version 2.3.2
242
fabric-upgrade-abort
This command is used to end a fabric-wide upgrade on the fabric.
Syntax fabric-upgrade-abort {force|no-force]
Specify if you want the upgrade to stop immediately or
wait for a logical step in the upgrade process.
force|no-force
Defaults None.
Access CLI
License SDF
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to stop a fabric-wide upgrade.
Examples To stop the fabric upgrade and end the process immediately, use the following command:
CLI network-admin@switch > fabric-upgrade-abort force
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-finish
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
243
Pluribus Networks nvOS Version 2.3.2
244
fabric-upgrade-continue
This command is used to continue a rolling fabric upgrade that is paused due to a node failure.
Syntax fabric-upgrade-continue
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to continue a fabric-wide upgrade.
Examples To continue the fabric upgrade, use the following command:
CLI network-admin@switch > fabric-upgrade-continue
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-finish
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
245
Pluribus Networks nvOS Version 2.3.2
246
fabric-upgrade-finish
This command is used to reboot the fabric after a fabric-wide upgrade.
Syntax fabric-upgrade-finish
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.2.6.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to reboot the nodes after a fabric-wide upgrade.
Examples To finish the upgrade, use the following snyntax:
CLI network-admin@switch > fabric-upgrade-finish
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-abort
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
247
Pluribus Networks nvOS Version 2.3.2
248
fabric-upgrade-prepare-cancel
This command is used to cancel a fabric-wide upgrade that was prepared earlier.
Syntax fabric-upgrade-prepare-cancel
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to cancel a fabric-wide upgrade.
Examples To cancel the fabric upgrade, use the following command:
CLI network-admin@switch > fabric-upgrade-prepare-cancel
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-finish
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
249
Pluribus Networks nvOS Version 2.3.2
250
fabric-upgrade-prepare-resume
This command is used to resume a fabric-wide upgrade that was prepared earlier.
Syntax fabric-upgrade-prepare-resume
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to resume a fabric-wide upgrade.
Examples To resume the fabric upgrade, use the following command:
CLI network-admin@switch > fabric-upgrade-prepare-resume
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-finish
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
251
Pluribus Networks nvOS Version 2.3.2
252
fabric-upgrade-prepare-show
This command is used to display information about prepared upgrades on the fabric nodes.
Syntax fabric-upgrade-prepare-show
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to display fabric-wide upgrade information.
Examples To display the fabric upgrade information, use the following command:
CLI network-admin@switch > fabric-upgrade-prepare-show
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
• fabric-node-show
• fabric-upgrade-finish
• fabric-upgrade-start
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
253
Pluribus Networks nvOS Version 2.3.2
254
fabric-upgrade-start
This command is used to start a fabric-wide upgrade.
Syntax fabric-upgrade-start packages sftp-files name
[auto-finish|no-auto-finish]prepare|no-prepare
reboot-parallel|reboot-single reboot-group number
packages sftp-files name
Specify a comma delimited list of the offline
packages to use for the upgrade process.
auto-finish|no-auto-finish
Specify if you want to automatically reboot
the fabric after the upgrade.
rolling|no-rolling
Specify if you want to perform a rolling
upgrade across the fabric.
abort-on-failure|
no-abort-on-failure
Specify if you want to stop the upgrade
process if the upgrade fails on a node.
manual-reboot|
no-manual-reboot
Specify if you want to manually reboot the
switches so that all switches do not reboot at
the same time.
prepare|no-prepare
Specify if you want to perform setup steps for
the actual upgrade.
reboot-parallel|reboot-single
Specify if you want to perform parallel rolling
reboots or reboot each switch one at a time.
The default is reboot-parallel.
reboot-group number
Specify the number of switches to reboot
together in parallel mode. The default is the
maximum number of switches in the fabric.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.2.6.
Version 2.2.6
Command introduced.
Version 2.3
The parameters prepare, reboot-parallel, and
reboot-group added.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to begin a fabric-wide upgrade.
Examples To force the upgrade to end immediately, use the following syntax:
CLI network-admin@switch > fabric-upgrade-start
See Also
• fabric-create
• fabric-info
• fabric-show
• fabric-node-evict
Pluribus Networks nvOS Version 2.3.2
255
• fabric-node-show
• fabric-upgrade-abort
• fabric-upgrade-finish
• fabric-upgrade-status-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
256
fabric-upgrade-status-show
This command is used to display the status of a fabric-wide upgrade.
Syntax fabric-upgrade-status-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.2.6.
Usage The fabric consists of one or more switches that share an administrative domain. The fabric
presents the abstraction of a big logical switch with a single point of management, hiding the
complexity of the underlying collection of switch hardware and inter-switch links. Use this
command to display the status of a fabric-wide upgrade.
Examples To force the upgrade to end immediately, use the following snyntax:
CLI network-admin@switch > fabric-upgrade-status-show
See Also
• fabric-create
• fabric-info
• fabric-show
Pluribus Networks nvOS Version 2.3.2
257
• fabric-node-evict
• fabric-node-show
• fabric-stats-show
Pluribus Networks nvOS Version 2.3.2
258
firmware-upgrade
This command is used to upgrade the firmware on the switch.
Warning: Upgrading the firmware on the switch reboots the system.
Syntax firmware-upgrade
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to upgrade the firmware on the server-switch.
Examples To upgrade the server-switch use the following command:
CLI network-admin@switch > firmware-upgrade
Warning: This will reboot the switch after completion. Proceed? [y/n]
Pluribus Networks nvOS Version 2.3.2
259
Pluribus Networks nvOS Version 2.3.2
260
flow-table-show
This command is used to display information about traffic flows on the switch.
Syntax flow-table-show [name name-string] [id id-number] [hw-id
hw-id-number] [flow-name flow-name-string] [flow-tbl-id]
[flow-hw-id flow-hw-id-number]
name name-string
Specifies the name of the traffic flow
id id-number
Specifies the identifier of the traffic flow
hw-id hw-id-number
Specifies the identifier of the hardware source
flow-name
flow-name-string
Specifies the name of the traffic flow type
flow-tbl-id
Specifies the identifier for the traffic flow table
flow-hw-id
flow-hw-id-number
Specifies the identifier of the hardware flow source
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Pluribus Networks nvOS Version 2.3.2
261
History Command introduced in nvOS Version 1.2.
Version 1.2
Command introduced.
Version 2.3.2
The parameter, flow-id flow-id, deprecated.
Usage Each switch is built with a datapath ASIC inside and contains a set of hardware flow tables for
traffic forwarding. Use this command to display flows as they are currently programmed in each
of the hardware flow table.s
Pluribus Networks nvOS Version 2.3.2
262
Examples To display the flows, use the following command:
CLI (network-admin@pleiades25) > flow-table-show layout vertical
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
switch:
name:
id:
hw-id:
flow-name:
flow-id:
flow-hw-id:
flow-hw-id:
mitch-aquila2
Switch System Table 2
33
Martian-L2-Check
2
1048578
mitch-aquila2
Switch System Table 2
33
Martian-IP4-L3-Check
3
1048579
mitch-aquila2
Switch System Table 2
33
Martian-IP6-L3-Check
4
1048580
mitch-aquila2
Switch System Table 2
33
STP-FLOW
5
3145733
mitch-aquila2
Switch System Table 2
33
PVST-FLOW
6
1048582
mitch-aquila2
Switch System Table 2
33
LLDP-NB-Flow
7
1048583
mitch-aquila2
Switch System Table 2
33
LLDP-NONTPMR-Flow
8
1048584
1048585
L2 to L4
L2 to L4
L2 to L4
L2 to L4
L2 to L4
L2 to L4
L2 to L4
Pluribus Networks nvOS Version 2.3.2
263
Pluribus Networks nvOS Version 2.3.2
264
H Commands
help
Displays usage information about commands.
Syntax help
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display usage information for all ONVL commands.
Examples To display usage information for fabric-create, use the following command:
CLI network-admin@switch > help fabric-create
name
name-string
any of the following options:
mcast-ip ip-address
password
delete-conflicts|abort-on-conflict
Pluribus Networks nvOS Version 2.3.2
265
Pluribus Networks nvOS Version 2.3.2
266
hw-nat-create
You can add hardware NAT to a vRouter on a switch.
Syntax hw-nat-create name name-string vrouter-name name-string
name name-string
Specify a name for the hardware NAT configuration.
vrouter-name
name-string
Specify the name of vRouter to apply the hardware NAT
configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage You can create hardware NAT configurations to add to a vRouter.
Examples To create the hardware NAT configuration, NAT1, and apply it to the vRouter, hw-nat, use the
following command:
CLI network-admin@switch > hw-nat-create name NAT1 vrouter-name hw-nat
See Also
 hw-nat-delete
 hw-nat-show
 hw-nat-map-add
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
267
Pluribus Networks nvOS Version 2.3.2
268
hw-nat-delete
You can add hardware NAT to a vRouter on a switch.
Syntax hw-nat-delete name name-string
Specify the name of a hardware NAT configuration to
remove from the switch.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage You can remove hardware NAT configurations from the switch.
Examples To remove the hardware NAT configuration, NAT1, use the following command:
CLI network-admin@switch > hw-nat-delete name NAT1 vrouter-name hw-nat
See Also
 hw-nat-create
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
269
Pluribus Networks nvOS Version 2.3.2
270
hw-nat-show
You can display information about a hardware NAT on a vRouter on a switch.
Syntax hw-nat-show name name-string vrouter-name name-string
name name-string
Specify a name for the hardware NAT configuration.
vrouter-name
name-string
Specify the name of vRouter to apply the hardware NAT
configuration.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage You can show hardware NAT configurations on a vRouter.
Examples To display the hardware NAT configuration, NAT1, use the following command:
CLI network-admin@switch > hw-nat-show name NAT1 vrouter-name hw-nat
See Also
 hw-nat-create
Pluribus Networks nvOS Version 2.3.2
271
 hw-nat-delete
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
272
hw-nat-loopback-port-show
You can display hardware NAT loopback port information on the switch.
Syntax hw-nat-loopback-port-show
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage You display hardware NAT loopback port information on the switch.
Examples To display hardware NAT loopback port information on the switch, use the following
command:
CLI network-admin@switch > hw-nat-loopback-port-show
See Also
 hw-nat-create
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
273
Pluribus Networks nvOS Version 2.3.2
274
hw-nat-map-add
You can add hardware NAT mapping to a hardware NAT configuration.
Syntax hw-nat-map-add hw-nat-name name-string [name name-string]
[ext-ip ip-address] [network ip-address] [netmask netmask]
hw-nat-name name-string Specify the name of the hardware NAT configuration to
apply the map.
Specify the following map arguments:
name name-string
Specify the name of the map.
ext-ip ip-address
Specify the external IP address to add to the map.
network ip-address
Specify the network IP address to add to the map.
netmask netmask
Specify the netmask for the network IP address.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage You can configure dynamic NAT for a hardware NAT configuration. Dynamic NAT maps a private
IP address to a public IP address drawing from a pool of registered (public) IP addresses.
Examples To map the external IP address, 207.191.37.46, to the network IP address, 20.20.20.1/24, use
the following syntax:
CLI network-admin@switch > hw-nat-map-add hw-nat-name NAT1 name map1
ext-ip 207.191.37.46 network 20.20.20.1/24
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
275
Pluribus Networks nvOS Version 2.3.2
276
hw-nat-map-remove
Use this command to remove an IP address map from a hardware NAT configuration.
Syntax hw-nat-map-remove hw-nat-name name-string [name name-string]
hw-nat-name name-string Specify the name of the hardware NAT configuration to
apply the map.
Specify the following map arguments:
Specify the name of the map.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Dynamic NAT maps a private IP address to a public IP address drawing from a pool of registered
(public) IP addresses. You can remove a NAT map for a hardware NAT configuration.
Examples To remove the map, Map1, from the configuration, NAT1, use the following command:
CLI network-admin@switch > hw-nat-remove hw-nat-name NAT1 name Map1
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
277
Pluribus Networks nvOS Version 2.3.2
278
hw-nat-map-show
This command is used to display information about a hardware NAT map configuration.
Syntax hw-nat-map-show hw-nat-name name-string [name name-string]
[ext-interface ext-interface-string] [ext-ip ip-address]
[network ip-address] [netmask netmask]
hw-nat-name name-string Specifies the name of the hardware NAT configuration to
apply the map.
Specify the following map arguments:
name name-string
Specifies the name of the map.
ext-interface
ext-interface-string
Specifies the interface name assigned to the external
interface.
ext-ip ip-address
Specifies the external IP address to add to the map.
network ip-address
Specifies the network IP address to add to the map.
netmask netmask
Specifies the netmask for the network IP address.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
279
History
Version 2.0
Command introduced.
Version 2.1
The parameter, ca-id, is removed.
Usage Dynamic NAT maps a private IP address to a public IP address drawing from a pool of registered
(public) IP addresses. You can display information about a NAT map for a hardware NAT
configuration.
Examples To display information about Map1 applied to hardware NAT, NAT1, use the following
command:
CLI network-admin@switch > hw-nat-map-show hw-nat-name NAT1 name Map1
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
280
hw-nat-port-forward-add
You can use this command to add port forwarding to a hardware NAT configuration.
Syntax hw-nat-port-forward-add hw-nat-name name-string name name-string
ext-ip ip-address ext-port ext-port-number int-ip ip-address
int-port int-port-number protocol tcp|udp|udp|icmp|igmp|ip
hw-nat-name name-string Specify the name of the hardware NAT configuration to apply
port forwarding.
Specify the following map arguments:
name name-string
Specify a name for the port forwarding configuration.
ext-ip ip-address
Specify the external IP address to apply to the configuration.
ext-port
ext-port-number
Specify the external port to apply port forwarding.
int-ip ip-address
Specify the internal IP address to apply to the configuration.
int-port
int-port-number
Specify the internal port to apply port forwarding.
protocol
tcp|udp|udp|icmp|igmp|
ip
Specify the type of packet to apply port forwarding.
Defaults None
Access CLI
License SDF
History .
Version 1.2
Command introduced.
Version 2.1
The parameter, protocol, was added.
Version 2.3
The protocols, icmp, igmp, and ip added.
Usage Port forwarding is also called Port Address Translation, where the same IP address is assigned
different port numbers.
Examples To configure port forwarding for external IP address 207.47.35.15, port 1122 and internal IP
address, 20.20.20.1, port 80, use the following command:
CLI network-admin@switch > hw-nat-port-forward-add hw-nat-name NAT1
name port-forward ext-ip 207.47.35.15 ext-port 1122 int-ip 20.20.20.1
int-port 80
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
Pluribus Networks nvOS Version 2.3.2
281
 hw-nat-map-show
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
282
hw-nat-port-forward-remove
This command is used to remove port forwarding from a hardware NAT configuration.
Syntax hw-nat-port-forward-remove hw-nat-name name-string name
name-string
hw-nat-name name-string Specify the name of the hardware NAT configuration to
remove port forwarding.
Specify the following map arguments:
Specify the name of the port forwarding configuration to
remove port forwarding.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Port forwarding is also called Port Address Translation, where the same IP address is assigned
different port numbers. You can remove port forwarding from the hardware NAT configuration.
Examples To remove the port forwarding configuration, port-forward, from NAT1, use the following
syntax:
CLI network-admin@switch > hw-nat-port-forward-remove hw-nat-name NAT1
name port-forward
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
283
Pluribus Networks nvOS Version 2.3.2
284
hw-nat-port-forward-show
This command is used to display port forwarding information about a hardware NAT configuration.
Syntax hw-nat-port-forward-show hw-nat-name name-string nat-index
nat-index-number name name-string protocol tcp|udp
hw-nat-name name-string Specifies the name of the hardware NAT configuration to show port
forwarding.
Specify the following map arguments:
nat-index
nat-index-number
Specifies the automatically generated index number for the
configuration.
name name-string
Specifies the name of the port forwarding configuration to display
port forwarding.
name name-string
Specifies a name for the port forwarding configuration.
ext-ip ip-address
Specifies the external IP address to show in the configuration.
ext-port
ext-port-number
Specifies the external port for port forwarding.
int-ip ip-address
Specifies the internal IP address for the configuration.
int-port
int-port-number
Specifies the internal port for apply port forwarding.
protocol tcp|udp
Specify the type of packet to apply port forwarding. The default value
is TCP.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
285
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
License SDF
History
Version 1.2
Command introduced.
Version 2.1
The parameter, protocol, was added.
Usage Port forwarding is also called Port Address Translation, where the same IP address is assigned
different port numbers. You can display port forwarding information about the hardware NAT
configuration.
Examples To display the port forwarding configuration, port-forward, from NAT1, use the following
syntax:
CLI network-admin@switch > hw-nat-port-forward-show hw-nat-name NAT1
name port-forward
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
286
hw-nat-session-show
This command is used to display information about static and dynamic NAT sessions on the switch
Syntax hw-nat-session-show type dynamic|static ob-vflow-name
ob-vflow-name-string in-vflow-name in-vflow-name-string
session-id session-id-number start-time date/time:
yyyy-mm-ddThh:mm:ss int-ip ip-address int-port int-port-number
ext-ip ip-address ext-port ext-port-number last-vflow-cnt
last-vflow-cnt-number
type dynamic|static
Specifies if the session type is dynamic or static.
ob-vflow-name
ob-vflow-name-string
Specifies the name of the outbound vFlow.
in-vflow-name
in-vflow-name-string
Specifies the name of the inbound vFlow.
session-id
session-id-number
Specifies the session ID for the NAT session.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the time that the NAT session begun.
int-ip ip-address
Specifies the internal IP address for the configuration.
int-port
int-port-number
Specifies the internal port number for the configuration.
ext-ip ip-address
Specifies the external IP address for the configuration.
ext-port
ext-port-number
Specifies the external port number for the configuration.
last-vflow-cnt
last-vflow-cnt-number
Specifies the last vFlow count for the session.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
287
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to display information about a current hardware NAT configuration.
Examples To display all dynamic hardware NAT sessions, use the following command:
CLI network-admin@switch > hw-nat-session-show dynamic
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
288
hw-nat-static-nat-add
This command is used to add static NAT to a hardware NAT configuration on a vRouter.
Syntax hw-nat-static-nat-add hw-nat-name name-string name name-string
external-ip ip-address internal-ip ip-address
hw-nat-name name-string Specify the name of the hardware NAT configuration.
Specify the following static NAT arguments:
name name-string
Specify a name for the static NAT configuration.
external-ip ip-address
Specify an external IP address to map an interface.
internal-ip ip-address
Specify an internal IP address to map to an interface.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage In some cases, you may want to map specific IP addresses for a NAT configuration.
Examples To map, static-nat1, to the hardware NAT, nat1, with the external IP address 201.37.101.135
and internal IP addresses 20.20.20.5, use the following command:
CLI network-admin@switch > hw-nat-static-nat-add hw-nat-name nat1 name
static-nat1 external-ip 201.37.101.135 internal-ip 20.20.20.5
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-remove
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
289
Pluribus Networks nvOS Version 2.3.2
290
hw-nat-static-nat-remove
This command is used to remove static NAT configuration from a hardware NAT configuration on a
vRouter.
Syntax hw-nat-static-nat-remove hw-nat-name name-string name
name-string external-ip ip-address internal-ip ip-address
hw-nat-name name-string Specify the name of the hardware NAT configuration.
Specify the following static NAT arguments:
Specify the name of the static NAT configuration to
remove from the hardware NAT.
name name-string
Defaults None
Access CLI
License SDF
History Command introduced in nvOS Version 2.0.
Usage In some cases, you may want to map specific IP addresses for a NAT configuration.
Examples To remove, static-nat1, from the hardware NAT, nat1, use the following command:
CLI network-admin@switch > hw-nat-static-nat-remove hw-nat-name nat1
name static-nat1
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
291
Pluribus Networks nvOS Version 2.3.2
292
hw-nat-static-nat-show
This command is used to display static NAT configuration information on a hardware NAT configuration
on a vRouter.
Syntax hw-nat-static-nat-show hw-nat-name name-string name name-string
nat-index nat-index-number external-ip ext-interface
ext-interface-stringip-address internal-ip ip-address
hw-nat-name
name-string
Specifies the name of the hardware NAT configuration.
Specify the following static NAT arguments:
name name-string
Specifies the name of the static NAT configuration to
remove from the hardware NAT.
nat-index
nat-index-number
Specifies the automatically generated index number for the
NAT configuration.
external-ip
ip-address
Specifies an external IP address to map an interface.
ext-interface
Specifies the external interface name.
ext-interface-string
internal-ip
ip-address
Specifies an internal IP address to map to an interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
293
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage In some cases, you may want to display information about a hardware NAT configuration.
Examples To display information about, static-nat1, configured on the hardware NAT, nat1, use the
following command:
CLI network-admin@switch > hw-nat-static-nat-show hw-nat-name nat1 name
static-nat1
See Also
 hw-nat-create
 hw-nat-delete
 hw-nat-show
 hw-nat-loopback-port-modify (deprecated)
 hw-nat-loopback-port-show
 hw-nat-map-add
 hw-nat-map-remove
 hw-nat-map-show
 hw-nat-port-forward-add
 hw-nat-port-forward-remove
 hw-nat-port-forward-show
 hw-nat-session-show
 hw-nat-static-nat-add
 hw-nat-static-nat-remove
Pluribus Networks nvOS Version 2.3.2
294
I Commands
id-led-modify
This command is used to locate the switch by blinking the LED on the front panel.
Syntax id-led-modify enable|disable
enable|disable
You can enable or disable this feature.
Defaults None
Access CLI
Usage When you enable this feature, the LED on the switch blinks allowing you to physically locate it.
Examples To enable this feature, use the following command:
CLI network-admin@switch > id-led-modify enable
See Also
• id-led-show
Pluribus Networks nvOS Version 2.3.2
295
Pluribus Networks nvOS Version 2.3.2
296
id-led-show
This command is used to display LED parameters on the switch.
Syntax id-led-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display LED parameters on the switch.
Examples To display LED parameters, use the following command:
CLI network-admin@switch > id-led-show layout vertical
switch:
enable:
pleiades24
no
See Also
• id-led-modify
Pluribus Networks nvOS Version 2.3.2
297
Pluribus Networks nvOS Version 2.3.2
298
igmp-router-show
This command is used to display IGMP routers on the network.
Syntax igmp-router-show group-ip ip-address node-ip ip-address vlan
vlan-id port port-number source ip-address node-type Host|Router
expires expires-number(s)
group-ip ip-address
Specifies the IP address of the group router.
node-ip ip-address
Specifies the IP address of the host.
vlan vlan-id
Specifies the ID of the VLAN.
port port-number
Specifies the number of the port.
source ip-address
Specifies the IP address of the source router.
node-type Host|Router
Specifies if the router is a host or router.
expires
expires-number(s)
Specifies the ageout time on the IGMP router.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in Version 2.2.2
Pluribus Networks nvOS Version 2.3.2
299
Usage Use this command to display information about IGMP routers on the network.
Examples To display information about IGMP routers on the network, use the following command:
CLI network-admin@switch > igmp-router-show
See Also
 igmp-snooping-modify
 igmp-snooping-show
 igmp-static-group-create
 igmp-static-group-delete
 igmp-static-source-create
 igmp-static-source-delete
 igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
300
igmp-show
To show the Internet Group Management Protocol (IGMP) group membership information for a switch,
use this command.
Syntax igmp-show [group-ip ip-address] [host-ip ip-address][vlan
vlan-id] [port port-number] [source ip-address]
group-ip ip-address
Specifies the multicast group IP address.
host-ip ip-address
Specifies the host IP address
vlan vlan-id
Specifies the VLAN identifier.
port port-number
Specifies the port number.
source ip-address
Specifies the multicast source traffic.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults All IGMP group membership information for the local switch is displayed unless a single switch
is specified.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display information about IGMP on the network.
Pluribus Networks nvOS Version 2.3.2
301
Examples To display all IGMP group membership information for the local switch, use the following
command:
CLI network-admin@switch > igmp-show
switch
-------pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
pubdev03
group-ip
--------239.4.9.3
239.4.9.3
239.4.9.3
239.4.9.4
239.4.9.4
239.4.9.4
239.4.9.7
239.4.9.7
239.4.9.7
239.4.9.3
239.4.9.3
239.4.9.3
host-ip
------------192.168.42.20
192.168.42.10
192.168.42.30
192.168.42.20
192.168.42.10
192.168.42.30
192.168.42.20
192.168.42.10
192.168.42.30
192.168.42.20
192.168.42.10
192.168.42.30
vlan
---1
1
1
3
3
3
3
3
3
3
3
3
port
---128
128
0
128
128
65
128
128
65
128
128
65
See Also
 igmp-snooping-modify
 igmp-snooping-show
 igmp-static-group-create
 igmp-static-group-delete
 igmp-static-source-create
 igmp-static-source-delete
 igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
302
source
------0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
0.0.0.0
igmp-snooping-modify
This command enables or disables Internet Group Management Protocol (IGMP) snooping on the
network.
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must
disable IGMP snooping on the Pluribus Networks switch.
Syntax igmp-snooping-modify scope local|fabric enable|disable
Specify one or more of the following options:
scope local|fabric
Specify if the scope is local or fabric.
enable|disable
Specify if IGMP snooping is enabled or disabled.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Version 1.2
Command introduced.
Version 2.1
The parameter, scope, added.
Usage IGMP snooping allows the switch to listen in on IGMP traffic between hosts and routers, thus
maintaining a map of the links that need IP multicast streams. Use this command to modify
IGMP snooping on the switch.
Examples To enable IGMP snooping, use the following command:
CLI network-admin@switch > igmp-snooping-modify enable
See Also
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-create
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
303
Pluribus Networks nvOS Version 2.3.2
304
igmp-snooping-show
This command displays information about Internet Group Management Protocol (IGMP) snooping on
the network.
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must
disable IGMP snooping on the Pluribus Networks switch.
Syntax igmp-snooping-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IGMP snooping allows the switch to listen in on IGMP traffic between hosts and routers, thus
maintaining a map of the links that need IP multicast streams. Use this command to display
IGMP snooping information on the switch.
Pluribus Networks nvOS Version 2.3.2
305
Examples To display information about IGMP snooping, use the following command:
CLI network-admin@switch > igmp-snooping-show
switch:
enable:
switch:
enable:
switch:
enable:
pubdev03
yes
pubdev02
yes
pubdev01
yes
See Also
• igmp-snooping-modify
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-create
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
306
igmp-static-group-create
This command creates a static IGMP group on the network..
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must
disable IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-group-create [group-ip ip-address] [vlan vlan-id]
[ports port-list]
group-ip ip-address
Speicifies the group multicast IP address for IGMP.
vlan vlan-id
Specifies the VLAN identifier.
ports port-list
Specifies the list of ports.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to create an IGMP static group.
Examples To configure a static group for 239.4.9.3 on VLAN 202 and ports 55-57, use the following
command:
CLI network-admin@switch > igmp-static-group-create group-ip 239.4.9.3
vlan 202 ports 55-57
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
307
Pluribus Networks nvOS Version 2.3.2
308
igmp-static-group-delete
This command deletes information about IGMP snooping on the network..
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must
disable IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-group-delete [group-ip ip-address] [vlan vlan-id]
group-ip ip-address
Specify the group IP address for IGMP.
vlan vlan-id
Specify the VLAN identifier.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, ports, is deprecated.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to remove an IGMP static group.
Examples To delete a static group for 239.4.9.3 on VLAN 202 and ports 55-57, use the following
command:
CLI network-admin@switch > igmp-static-group-delete group-ip 239.4.9.3
vlan 202 ports 55-57
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-show
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
309
Pluribus Networks nvOS Version 2.3.2
310
igmp-static-group-show
This command is used to display information about IGMP static groups configured on the switch..
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-group-show group-ip ip-address vlan vlan-id ports
port-list
group-ip ip-address
Specifies the IP address of the IGMP static group.
vlan vlan-id
Specifies the VLAN assigned to the IGMP static group.
ports port-list
Specifies the ports assigned to the IGMP group.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Pluribus Networks nvOS Version 2.3.2
311
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to display an IGMP static group.
Examples To display a static group for 239.4.9.3 on VLAN 202 and ports 55-57, use the following
command:
CLI network-admin@switch > igmp-static-group-show group-ip 239.4.9.3
vlan 202 ports 55-57
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-create
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
312
igmp-static-source-create
This command creates a static IP address as the IGMP source on the network..
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-source-create [source-ip ip-address][group-ip
ip-address] [vlan vlan-id] [ports port-list]
source-ip ip-address
Specifies the source IP address. This is a unicast IP address.
group-ip ip-address
Specifies the group IP address for IGMP.
vlan vlan-id
Specifies the VLAN identifier.
Specify the following option:
Specifies the list of ports.
ports port-list
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to create an IGMP static IP address as the source.
Examples To add the static source 12.0.0.1 as the static source, use the following command:
CLI network-admin@switch > igmp-static-source-create source-ip 12.0.0.1
group-ip vlan 202 ports 55-57
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
313
Pluribus Networks nvOS Version 2.3.2
314
igmp-static-source-delete
This command deletes a static IGMP source on the netework.
Informational Note: IGMPv1 is not supported in ONVL. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-source-delete [group-ip ip-address] [source-ip
ip-address] [vlan vlan-id]
group-ip ip-address
Specifies the group IP address for IGMP.
source-ip ip-address
Specifies the source IP address.
vlan vlan-id
Specifies the VLAN identifier.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to remove an IP address as the static source.
Examples To remove the static source 12.0.0.1 as the static source, use the following command:
CLI network-admin@switch > igmp-static-source-remove source-ip 12.0.0.1
group-ip vlan 202 ports 55-57
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
315
Pluribus Networks nvOS Version 2.3.2
316
igmp-static-source-show
This command displays a static IGMP source on the network.
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-source-show [group-ip ip-address] [vlan vlan-id]
[source-ip ip-address] [host-ip ip-address] [ports port-list]
group-ip ip-address
Specifies the group IP address for IGMP.
source-ip ip-address
Specifies the source IP address.
host-ip ip-address
Specifies the host IP address
vlan vlan-id
Specifies the VLAN identifier.
ports port-list
Specifies the list of ports.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
317
History Command introduced in nvOS Version 1.2.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to remove an IGMP static source.
Examples To display information about all IGMP static source IP addresses, use the following command:
CLI network-admin@switch > igmp-static-source-show
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
318
igmp-static-source-show
This command displays a static IGMP source on the network.
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-static-source-show [group-ip ip-address] [vlan vlan-id]
[source-ip ip-address] [host-ip ip-address] [ports port-list]
group-ip ip-address
Specifies the group IP address for IGMP.
source-ip ip-address
Specifies the source IP address.
host-ip ip-address
Specifies the host IP address
vlan vlan-id
Specifies the VLAN identifier.
ports port-list
Specifies the list of ports.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
319
History Command introduced in nvOS Version 1.2.
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to remove an IGMP static source.
Examples To display information about all IGMP static source IP addresses, use the following command:
CLI network-admin@switch > igmp-static-source-show
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
320
igmp-stats-show
This command displays a IGMP statistics on the network.
Informational Note: IGMPv1 is not supported in nvOS. If you are using IGMPv1, you must disable
IGMP snooping on the Pluribus Networks switch.
Syntax igmp-stats-show [vlan vlan-id]
vlan vlan-id
Specifies the VLAN identifier.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.3. (Not available in Version 2.2.8.)
Usage IGMP groups are used to determine the reception state for a specific multicast address. This
allows the switch to determine if any switches need messages sent from a multicast group. Use
this command to display IGMP statistics.
Pluribus Networks nvOS Version 2.3.2
321
Examples To display information about all IGMP statistics, use the following command:
CLI network-admin@switch > igmp-stats-show
See Also
• igmp-show
• igmp-snooping-modify
• igmp-snooping-show
• igmp-static-group-create
• igmp-static-group-delete
• igmp-static-source-delete
• igmp-static-source-show
Pluribus Networks nvOS Version 2.3.2
322
interface-stats-show
This command is used to display statistical information about an interface.
Syntax interface-stats-show [time date/time:yyyy-mm-ddThh:mm:ss][nic
nic-string]
time
Specifies the date and time that the stats are collected.
date/time:yyyy-mm-ddThh
:mm:ss
nic nic-string
Specifies the NIC to display stats.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display stats about interfaces on the switch.
Pluribus Networks nvOS Version 2.3.2
323
Examples To display stats about all interfaces, use the following command:
CLI network-admin@switch > interface-stats-show layout vertical
switch:
time:
nic:
ibytes:
ipkts:
ierrs:
obytes:
opkts:
oerrs:
switch:
time:
nic:
ibytes:
ipkts:
ierrs:
obytes:
opkts:
oerrs:
switch:
time:
nic:
ibytes:
ipkts:
ierrs:
obytes:
opkts:
oerrs:
pubdev01
11:36:59
data
2.72G
9.40M
4
2.86G
10.1M
0
pubdev01
11:36:59
span
357K
199K
0
0
0
0
pubdev01
11:36:59
eth0.1
0
0
0
0
0
0
Pluribus Networks nvOS Version 2.3.2
324
ip-pool-create
This command creates a new IP address pool with a specific IP address range.
Syntax ip-pool-create name ip-pool-name vnet vnet-name start-ip
ip-address end-ip ip-address netmask netmask [vlan vlan-id]
name ip-pool-name
Specify the name for the IP pool.
vnet vnet-name
Specify the VNET for the IP pool.
start-ip ip-address
Specify the first IP address in the pool. This address is
included in the pool.
end-ip ip-address
Specify the end IP address of the pool and is included in
the pool.
netmask netmask
Specify the subnet for the IP address pool.
Specify the following option:
vlan vlan-id
Specify the VLAN identifier for an IP address pool that
applies to a specific Layer 2 network segment.
Defaults Unless the netmask parameter is specified, the subnet for the IP address pool is assumed to
be the standard IP block for a given IP prefix. For example, if no netmask is specified and the IP
address has a prefix of 192.168.0.x, the subnet is assumed as /24, 255.255.255.0.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IP address pools help automate the management of IP addresses for hosts and virtual machines,
including the management IP addresses of the switches in a fabric. Use this command to create
a new IP pool.
Examples To create a fabric-wide IP address pool named MyPublicIPv4Pool to automate the
allocation of IP addresses within a fabric for the IP address block 208.74.182.0 to
208.74.182.100/32, use the following command:
CLI network-admin@switch > ip-pool-create name MyPublicIPv4Pool
start-ip 208.74.182.0 end-ip 208.74.182.100 netmask 255.255.255.0
See Also
• ip-pool-delete
• ip-pool-modify
• ip-pool-show
Pluribus Networks nvOS Version 2.3.2
325
Pluribus Networks nvOS Version 2.3.2
326
ip-pool-delete
This command deletes an IP address pool with a specific IP address range.
Syntax ip-pool-delete name ip-pool-name
ip-pool-name
Specify the name of the IP pool to delete.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IP address pools help automate the management of IP addresses for hosts and virtual machines,
including the management IP addresses of the switches in a fabric. This command deletes an
existing IP address pool.
Examples To delete the IP address pool name MyPublicIPv4Pool, use the following command:
CLI network-admin@switch > ip-pool-delete MyPublicIPv4Pool
See Also
• ip-pool-create
• ip-pool-modify
• ip-pool-show
Pluribus Networks nvOS Version 2.3.2
327
Pluribus Networks nvOS Version 2.3.2
328
ip-pool-modify
This command modifies an IP address pool with a specific IP address range.
Syntax ip-pool-modify name ip-pool-name start-ip ip-address end-ip
ip-address netmask netmask [vlan vlan-id]
name ip-pool-name
Specify the name of the IPpol.
Specify one or more of the following options:
start-ip ip-address
Specify the first IP address in the pool. This address is
included in the pool.
end-ip ip-address
Specify the end IP address of the pool and is included in
the pool.
network
ip-address
Specify the network for the IP address pool, for example,
192.168.1.0.
netmask netmask
Specify the subnet for the IP address pool.
vlan vlan-id
Specify the VLAN identifier for an IP address pool that
applies to a specific Layer 2 network segment.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameter, vnet, deprecated.
Usage IP address pools help automate the management of IP addresses for hosts and virtual machines,
including the management IP addresses of the switches in a fabric. Use this command to modify
an existing IP pool.
Examples To modify a fabric-wide IP address pool named MyPublicIPv4Pool to automate the allocation
of IP addresses within a fabric for the IP address block 208.74.182.0/24 to 208.74.182.201/24,
use the following command:
CLI network-admin@switch > ip-pool-modify name MyPublicIPv4Pool
start-ip 208.74.182.0 end-ip 208.74.182.200 netmask 255.255.255.0
See Also
• ip-pool-create
• ip-pool-delete
• ip-pool-show
Pluribus Networks nvOS Version 2.3.2
329
Pluribus Networks nvOS Version 2.3.2
330
ip-pool-show
This command displays information about an IP address pool with a specific IP address range.
Syntax ip-pool-show name ip-pool-name vnet vnet-name scope local|fabric
start-ip ip-address end-ip ip-address network ip-address netmask
netmask [vlan vlan-id]
name ip-pool-name
Specifies the name of the IP pool.
vnet vnet-name
Specifies the VNET for the IP pool.
scope local|fabric
Specifies the scope of the IP pool.
start-ip ip-address
Specifies the first IP address in the pool. This address is
included in the pool.
end-ip ip-address
Specifies the end IP address of the pool and is included in
the pool.
network ip-address
Specify an IP address group such as 192.168.11.0.
netmask netmask
Specifies the subnet for the IP address pool.
vlan vlan-id
Specifies the VLAN identifier for an IP address pool that
applies to a specific Layer 2 network segment.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
331
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage IP address pools help automate the management of IP addresses for hosts and virtual machines,
including the management IP addresses of the switches in a fabric.
Examples To display information about a fabric-wide IP address pool named vPool, use the following
command:
CLI network-admin@switch > ip-pool-show name vPool
Name
vPool
Owner
None
Scope
local
Range Start
192.168.240.1
Range End
Nemask
192.168.240.254 24
See Also
• ip-pool-create
• ip-pool-delete
• ip-pool-modify
Pluribus Networks nvOS Version 2.3.2
332
Gateway
DNS
10.9.40.1 0
iso-library-modify
This command modifies the configuration of an ISO library.
Syntax iso-library-create name library-name [sharing off|nfs]
name library-name
Specifies the name of the ISO library.
sharing off|nfs
Specifies if sharing is allowed using NFS.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Version 1.2
Command introduced.
Version 2.1
The parameters, storage-pool, and dedup, are deprecated.
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to
store application disk images natively in the network. Use this command to modify an ISO
library.
Examples To modify an ISO image library named MyISOLibrary and turn off sharing, use the following
command:
CLI network-admin@switch > iso-library-modify MyISOLibrary sharing off
See Also
• iso-library-create
• iso-library-delete
• iso-library-show
• iso-library-image-export
• iso-library-image-import
• iso-library-image-remove
• iso-library-image-show
Pluribus Networks nvOS Version 2.3.2
333
Pluribus Networks nvOS Version 2.3.2
334
iso-library-show
This command displays a list of existing ISO libraries.
Syntax iso-library-show name library-name [storage-pool
storage-pool-name] [data-set dataset-name] [sharing
none|sftp|nfs][import-share-path import-share-path-string]
[export-share-path export-share-path-string] [import-share
import-share-name] [export-share export-share-name]
[export-share-path export-share-path-string
name library-name
Specifies the name of the ISO library.
storage-pool
storage-pool-name
Soecifies the name of the storage pool.
data-set dataset-name
Specifies the name of the ZFS dataset.
sharing none|sftp|nfs
Specifies the type of sharing for the library.
import-share
import-share-name
Specifies the name of the share to import the ISO image.
import-share-path
import-share-pathstring
Specifies the file path used to import an ISO file.
export-share
export-share-name
Specifies the name of the share to export the ISO image.
export-share-path
export-share-pathstring
Specifies the file path used to export an ISO file.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, sharing, import-share-path and
export-share-path, added. The parameter, dedup, is deprecated.
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to
store application disk images natively in the network.
Examples To display all ISO image libraries, use the following command:
CLI network-admin@switch > iso-library-show
switch:
name:
storage-pool:
data-set:
sharing:
import-share:
import-share-path:
export-share:
export-share-path:
F64M-Leaf2
iso-lib-pool-disk4
pool-disk4
pool-disk4/iso-lib-pool-disk4
nfs
F64M-Leaf2:/iso-lib/pool-disk4/import
/iso-lib/pool-disk4/import
F64M-Leaf2:/iso-lib/pool-disk4/export
/iso-lib/pool-disk4/export
Pluribus Networks nvOS Version 2.3.2
335
See Also
• iso-library-create
• iso-library-delete
• iso-library-modify
• iso-library-image-export
• iso-library-image-import
• iso-library-image-remove
• iso-library-image-show
Pluribus Networks nvOS Version 2.3.2
336
iso-library-image-export
This command exports an ISO image from the ISO library.
Syntax iso-library-export iso-library-name library-name image-label
label-string image-library library-string image-file file-string
Specify the name of the ISO library.
iso-library-name
library-name
Specify the following image argument:
Specify the label for the ISO image.
image-label
iso-image-label
Specify the following options:
image-file file-string
Specify the target file name of the image.
image-library
library-string
Specify the name for the target image library.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, name, iso-image-name,
image-storage-pool, image-sharing, image-dedup are
deprecated.
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to
store application disk images natively in the network.
Examples To export an ISO image named ubuntu-11.04-amd64 from the ISO image Library, pluribus ,
use the following command:
CLI network-admin@switch > iso-library-image-export iso-library-name
pluribus image-label ubuntu-11.04-amd64 image-library myLibrary
image-file ubuntu-11.04-amd64
See Also
• iso-library-create
• iso-library-delete
• iso-library-modify
• iso-library-show
• iso-library-image-import
• iso-library-image-remove
• iso-library-image-show
Pluribus Networks nvOS Version 2.3.2
337
Pluribus Networks nvOS Version 2.3.2
338
iso-library-image-import
This command imports an ISO image into an ISO library.
Syntax iso-library-import iso-library-name name-string image-label
label-string image-file image-string] [image-library
library-string]
Specify the name of the ISO library to import the image
from.
iso-library-name
library-name
Specify the following image arguments:
image-label image-label Specify the label for the ISO image.
image-file file-string
Specify the file name for the ISO image..
Specify the following option:
Specify the name of the image library.
image-library
library-name
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to
store application disk images natively in the network.
Examples To import an ISO image named MyCentOSImage from the file
Centos-6.0-x86_64-bin-DVD1.iso into the image Library, pluribus, use the following command:
CLI network-admin@switch > iso-library-image-import iso-library-name
pluribus image-label myCentOSImage image-file
CentOS-6.0-x86_64-bin-DVD1.iso
See Also
• iso-library-create
• iso-library-delete
• iso-library-modify
• iso-library-show
• iso-library-image-export
• iso-library-image-remove
• iso-library-image-show
Pluribus Networks nvOS Version 2.3.2
339
Pluribus Networks nvOS Version 2.3.2
340
iso-library-image-remove
This command removes an ISO image.
Syntax iso-library-remove iso-library-name library-name image-label
iso-image-label
Specifies the name of the ISP library.
iso-library-name
library-name
Specify the image argument:
Specifies the label for the ISO image.
image-label
iso-image-label
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to
store application disk images natively in the network. Use this command to remove an ISO
image.
Examples To remove an ISO image named MyCentOSImage from the Ifile
Centos-6.0-x86_64-bin-DVD1.iso into the image Library, MyISOLibrary, , use the following
command:
CLI network-admin@switch > iso-library-image-remove iso-library-name
MyISOLibrary image-label myCentOSImage
See Also
• iso-library-create
• iso-library-delete
• iso-library-modify
• iso-library-show
• iso-library-image-export
• iso-library-image-show
Pluribus Networks nvOS Version 2.3.2
341
Pluribus Networks nvOS Version 2.3.2
342
iso-library-image-show
This command displays a list of images in an ISO library.
Syntax iso-library-image-show iso-library-name name-string image-label
label-string image-file image-string] [image-library
library-string]
Specify the name of the ISO library.
name library-name
Specify the image arguments:
image-label image-label Specify the label for the ISO image.
image-library
library-name
Specify the name of the image library.
image-file file-string
Specify the file name for the ISO image..
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Pluribus Networks nvOS Version 2.3.2
343
Usage Each fabric, cluster, standalone switch, or VNET can provide its tenants with a disk library to store
application disk images natively in the network. Use this command to display information about
ISO images on the switch.
Examples To display a list of ISO images in the ISO image Library, MyISOLibrary, , use the following
command:
CLI network-admin@switch > iso-library-image-show layout vertical
switch:
iso-library-name:
label:
library:
switch:
iso-library-name:
label:
library:
pleiades24
pluribus
ubuntu-11.04-amd64
pluribus
pleiades24
pluribus
centOS-6.2-x86_64
pluribus
See Also
• iso-library-create
• iso-library-delete
• iso-library-modify
• iso-library-show
• iso-library-image-export
• iso-library-image-remove
Pluribus Networks nvOS Version 2.3.2
344
L Commands
l2-history-show
This command displays historical information about Layer 2 entries on the switch.
Syntax [time date/time: yyyy-mm-ddTHH:mm:ss] [start-time date/time:
yyyy-mm-ddTHH:mm:ss] [end-time date/time: yyyy-mm-ddTHH:mm:ss]
[duration duration: #d#h#m#s] [interval duration: #d#h#m#s]
[since-start] [older-than duration: #d#h#m#s] [within-last
duration: #d#h#m#s] [log-type l2-save|l3-save|restart
|l2-modify|l2-delete|l3-modify|l3-delete] [caller
init|config|status|switch-cb|cluster|gre|ARP|router|flow-cb|
vdp|vlag|port|inject|evict|vxlan|stats|vnm-vnic|adjacency|stp|
trunk|intsw|ttl1|flood|flush|retire|loop|dhcp|fabric|table|
l3-age-out|vlan] [ last-caller init|config|status|switch-cb
|cluster|gre|ARP|router| flow-cb|vdp|vlag|port|inject
|evict|vxlan|stats|vnm-vnic| adjacency|stp|trunk|intsw|
ttl1|flood|flush|retire|loop|dhcp|fabric|table|l3-age-out|vlan]
[reason activate|deactivate|port-move|ip-move|ip-remove|
batch-move|retire|break-loop|break-loop-timeout|create|modify|
delete| policy|owner-status|remove-node|port-flags|check-owner|
trunk-port-add|trunk-port-remove|move-router-if|age-out|
hw-remove|restart|undo] [last-reason activate|deactivate|
port-move|ip-move|ip-remove| batch-move|retire|break-loop|
break-loop-timeout|create|modify| delete|policy|owner-status|
remove-node|port-flags|check-owner| trunk-port-add|
trunk-port-remove|move-router-if|age-out|
hw-remove|restart|undo] [changes owner|mac|ip|num-ips|
config-intf|intf|ports|state|local-intf|local-ports|local-state|
hostname|hypervisor|vm-id|vm-name| vm-flavor|vm-status|memory
|cpus|disk|os|config|blocked-port| rem-switch|rem-intf|
rem-ports|peer-intf|peer-state|status| tunnel|create-time|
last-seen|vxlan-lru|hit|migrate|drops] [count count-number]
[owner node name] [ mac mac-address ] [ vlan 0..4095 ] [ vxlan
0..16777215 ] [ ip ip-address ] [ num-ips num-ips-number ] [
config-intf config-intf-number ] [ intf intf-number ] [ ports
port-list ] [ vm-status
unknown|migrating|build|shutoff|reboot|hard_reboot|active|
rescued|suspended|paused|error|stopped|deleted|resized|
soft_deleted ] [ memory memory-number ] [ cpus cpus-number ] [
disk disk-number ] [ os os-string ] config
none|owner|ip|port|hostname|hypervisor|vm-id|vm-name|
vm-flavor|memory|cpus|disk|os ] [ blocked-port port-list ] [
rem-switch node name ] [ rem-intf rem-intf-number ] [ rem-ports
port-list ] [ status
phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|
PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|
PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|
no-pktin|no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|
remote-l3-port|vdp|dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|
vlag-active|vlag-blocked|stp-edge-port|LACP-wait|LACP-fallback|
adjacency-wait|adjacency-check|vlag-wait|multicast-router ] [
Pluribus Networks nvOS Version 2.3.2
345
tunnel tunnel-string ] [ create-time date/time:
yyyy-mm-ddTHH:mm:ss ] [ last-seen date/time: yyyy-mm-ddTHH:mm:ss ]
[ vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss ] [ hit hit-number ] [
migrate migrate-number ] [ drops drops-number ]
time date/time:
yyyy-mm-ddThh:mm:ss
Specifies a point in tjme for displaying historical information.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the start time for Layer 2 history collection.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the end time for Layer 2 history collection.
duration duration:
#d#h#m#s
Specifies the duration to collect the Layer 2 history.
interval duration:
#d#h#m#s
Specifies the intervals that nvOS collected Layer 2 history.
since-start
Specifies to display all of the Layer 2 history since collection began
on the fabric.
time date/time:
yyyy-mm-ddThh:mm:ss
Specifies a point in tjme for displaying historical information.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the start time for Layer 2 history collection.
Filter output by the log type of each entry. The log-type column
log-type
l2-save|l3-save|restart displays when a vPort is created, modified, saved, or deleted.
|l2-modify|l2-delete|l3modify|l3-delete
Specifies the feature that made the change for this entry.
caller
init|config|status|switc
h-cb|cluster|gre|ARP|rou
ter|flow-cb|
vdp|vlag|port|inject|evi
ct|vxlan|stats|vnm-vnic|
adjacency|stp|
trunk|intsw|ttl1|flood|f
lush|retire|loop|dhcp|fa
bric|table|
l3-age-out|vlan
Pluribus Networks nvOS Version 2.3.2
346
Specifies the most recent caller for this entry.
last-caller
init|config|status|switc
h-cb|cluster|gre|ARP|
router| flow-cb|vdp|
vlag|port|inject
|evict|vxlan|stats|vnm-v
nic| adjacency|stp
|trunk|intsw|ttl1|flood|
flush|retire|loop|dhcp|f
abric|table|l3-age-out|
vlan
Specifies the reason for history entry.
reason
activate|deactivate|port
-move|ip-move|ip-remove|
batch-move|retire|breakloop|break-loop-timeout|
create|modify|
delete|
policy|owner-status|remo
ve-node|port-flags|check
-owner|
trunk-port-add|trunk-por
t-remove|move-router-if|
age-out|
hw-remove|restart|undo
Specifies the most recent reason for this entry.
last-reason
activate|deactivate|
port-move|ip-move|ip-rem
ove|
batch-move|retire|breakloop|
break-loop-timeout|creat
e|modify|
delete|policy|owner-stat
us|
remove-node|port-flags|c
heck-owner|
trunk-port-add|
trunk-port-remove|move-r
outer-if|age-out|
hw-remove|restart|undo
Pluribus Networks nvOS Version 2.3.2
347
Specifies what changed in this entry.
changes
owner|mac|ip|num-ips|
config-intf|intf|ports|s
tate|local-intf|local-po
rts|local-state|hostname
|hypervisor|vm-id|vm-nam
e| vm-flavor|vm-status
|memory|cpus|disk|os|
config|blocked-port|
rem-switch|rem-intf|
rem-ports|peer-intf|peer
-state|status| tunnel|
create-time|last-seen|
vxlan-lru|hit|migrate|
drops
Filter output by the number of entries summed using the sum-by
argument.
count count-number
owner node name
mac mac-address
Filter output by the Filter output by MAC address.
vlan vlan-id
Filter output by the VLAN ID.
vxlan vxlan-id
Filter output by the VXLAN ID.
ip ip-address
Filter output by the IP address.
num-ips num-ips-number
Specify the number of IP addresses for the Layer 2 entry.
config-intf
config-intf-number
Filter output by the configured interface of the Layer 2 entry.
intf intf-number
Filter output by the interface number. This is the port or trunk
number of the Layer 2 entry.
ports port-list
Filter output by the list of ports.
state
active|static|vrrp|
tunnel|software|
needs-peer-status|
port-mac|hit
Filter output by the state of the Layer 2 entry.
hostname hostname-string Filter output by the host name.
vm-id vm-id-string
Filter output by the ID assigned to the VM.
hypervisor
hypervisor-string
Filter output by the hypervisor for a VM.
vm-name vm-name-string
Filter output by the name of the VM.
vm-flavor
vm-flavor-string
Filter output by the VM flavor. This can be CentOS, Ubuntu, etc.
Pluribus Networks nvOS Version 2.3.2
348
Specify the VM status.
vm-status
unknown|migrating|build|
shutoff|reboot|hard_rebo
ot|active|
rescued|suspended|paused
|error|stopped|deleted|r
esized| soft_deleted
memory memory-number
Filter output by the amount of memory assigned to the VM.
cpus cpus-number
Filter output by the number of CPUs assigned to the VM.
disk disk-number
Filter output by the disk number where the VM is installed.
os os-string
Filter output by the OS installed on the VM.
Filter output by the configuration of the VM.
config
none|owner|ip|port|hostn
ame|hypervisor|vm-id|vmname|
vm-flavor|memory|cpus|di
sk|os
blocked-port port-list
Filter output by a list of ports to block for the VM.
rem-switch node name
Filter output by the remote switch name.
rem-intf rem-intf-number
Filter output by the remote interface number.
rem-ports port-list
Filter output by the remote ports.
Filter output by the status of the Layer 2 entry.
status
phy-up|up|disabled|hw-na
t-loop|mirror-loop|mirro
r-to|inuse|
PN-switch|PN-fabric|PN-o
ther|PN-cluster|PN-inter
nal|
PN-hypervisor|PN-guest|s
nmp-host|host|uplink|dro
p-pkts|
no-pktin|no-fwd|no-flood
|STP-BPDUs|LLDP|trunk|l3
-port|
remote-l3-port|vdp|dhcp|
dhcpsvr|blocked|no-BPDU|
LACP-PDUs|
vlag-active|vlag-blocked
|stp-edge-port|LACP-wait
|LACP-fallback|
adjacency-wait|adjacency
-check|vlag-wait|multica
st-router ]
Pluribus Networks nvOS Version 2.3.2
349
tunnel tunnel-string
Filter output by the tunnel name.
create-time date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the time that the vPort was created.
last-seen date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the time that the vPort was last seen on the fabric.
vxlan-lru date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the number of received hits.
hit hit-number
Filter output by the number of times that the vPort migrated on
the fabric.
migrate migrate-number
Filter output by the number of drops on the fabric.
drops drops-number
Filter output by the time that the vPort was created.
Defaults None
Access CLI
History Command introduced in Version 2.3.2.
Usage Use this command to display history of Layer 2 entries.
Examples To display Layer 2 information, use the following command:
CLI network-admin@switch > l2-history-show
time:
log-type:
caller:
reason:
owner:
mac:
vlan:
ip:
ports:
state:
hostname:
status:
09:02:33
l2-modify
router
activate,create
pleaides24
66:0e:94:f4:ec:6e
1
192.168.16.24
65
active,static
pleiades-tib
host
Pluribus Networks nvOS Version 2.3.2
350
l2-setting-modify
This command modifies the Layer 2 settings in the configuration.
Syntax l2-setting-modify aging-time seconds
Configures the aging time in Layer 2. You can configure a
value from 1 to 2000000.
aging-time seconds
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to modify the Layer 2 aging time in seconds.
Examples To modify the aging time to 360 seconds, use the following command:
CLI network-admin@switch > l2-setting-modify aging-time 360
See Also
• l2-history-show (deprecated)
• l2-setting-show
• l2-table-flush
• l2-table-show
Pluribus Networks nvOS Version 2.3.2
351
Pluribus Networks nvOS Version 2.3.2
352
l2-setting-show
This commands displays the Layer 2 settings in the configuration.
Syntax l2-setting-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display information about Layer 2 settings.
Pluribus Networks nvOS Version 2.3.2
353
Examples To display the Layer 2 settings, use the following command:
CLI network-admin@switch > l2-setting-show
switch:
aging-time(s):
l2-max-count:
l2-cur-count:
l2-active-count:
l2-max-mem:
l2-cur-mem:
l3-arp-max-count:
l3-arp-cur-count:
l3-arp-max-mem:
l3-arp-cur-mem:
switch:
aging-time(s):
l2-max-count:
l2-cur-count:
l2-active-count:
l2-max-mem:
l2-cur-mem:
l3-arp-max-count:
l3-arp-cur-count:
l3-arp-max-mem:
l3-arp-cur-mem:
Pleiades24
300
1300000
36
13
1.81G
32.6K
1300000
7
624M
2.13K
Pleiades25
300
1300000
36
14
1.81G
32.6K
1300000
7
624M
2.13K
See Also
• l2-history-show (deprecated)
• l2-setting-modify
• l2-table-flush
• l2-table-show
Pluribus Networks nvOS Version 2.3.2
354
l2-static-multicast-group-create
This command is used to create a Layer 2 static multicast group. Hosts join multicast groups either by
sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general
query from a multicast router (the switch forwards general queries from multicast routers to all ports in
a VLAN). When you specify group membership for a multicast group address statically, the static setting
supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and
IGMP snooping-learned settings.
Syntax l2-static-multicast-group-create group-mac mac-address vlan
vlan-id ports port-list
group-mac
mac-address
Specify a MAC address for the multicast group.
vlan vlan-id
Specify a VLAN ID for the multicast group.
ports
port-list
Specify a list of ports for the multicast group.
Defaults None
Access network-admin
History Command introduced in nvOS Version 2.3. (Not available in Version 2.2.8)
Usage Use this command to create a Layer 2 static multicast group.
Examples To create a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports
10-12, use the following syntax:
CLI network-admin@switch > l2-static-multicast-group-create group-mac
0050.3e8d.6400 vlan 25 ports 10-12
Pluribus Networks nvOS Version 2.3.2
355
Pluribus Networks nvOS Version 2.3.2
356
l2-static-multicast-group-delete
This command is used to delete a Layer 2 static multicast group. Hosts join multicast groups either by
sending an unsolicited IGMP join message or by sending an IGMP join message in response to a general
query from a multicast router (the switch forwards general queries from multicast routers to all ports in
a VLAN). When you specify group membership for a multicast group address statically, the static setting
supersedes any IGMP snooping learning. Multicast group membership lists can consist of both static and
IGMP snooping-learned settings.
Syntax l2-static-multicast-group-create group-mac mac-address vlan
vlan-id
group-mac
mac-address
Specify a MAC address for the multicast group.
vlan vlan-id
Specify a VLAN ID for the multicast group.
Defaults None
Access network-admin
History Command introduced in nvOS Version 2.3. (Not available in Version 2.2.8)
Usage Use this command to delete a Layer 2 static multicast group.
Examples To delete a L2 static multicast group on MAC address, 0050.3e8d.6400 and VLAN 25, use the
following syntax:
CLI network-admin@switch > l2-static-multicast-group-delete group-mac
0050.3e8d.6400 vlan 25 ports 10-12
Pluribus Networks nvOS Version 2.3.2
357
Pluribus Networks nvOS Version 2.3.2
358
l2-static-multicast-group-show
This command is used to display information about a Layer 2 static multicast group. Hosts join multicast
groups either by sending an unsolicited IGMP join message or by sending an IGMP join message in
response to a general query from a multicast router (the switch forwards general queries from multicast
routers to all ports in a VLAN). When you specify group membership for a multicast group address
statically, the static setting supersedes any IGMP snooping learning. Multicast group membership lists
can consist of both static and IGMP snooping-learned settings.
Syntax l2-static-multicast-group-show group-mac mac-address vlan
vlan-id ports port-list
group-mac
mac-address
Specify a MAC address for the multicast group.
vlan vlan-id
Specify a VLAN ID for the multicast group.
ports
port-list
Specify a list of ports for the multicast group.
Defaults None
Access network-admin
History Command introduced in nvOS Version 2.3.(Not available in Version 2.2.8)
Usage Use this command to create a Layer 2 static multicast group.
Examples To display a L2 static multicast group on MAC address, 0050.3e8d.6400, VLAN 25, and ports
10-12, use the following syntax:
CLI network-admin@switch > l2-static-multicast-group-show group-mac
0050.3e8d.6400 vlan 25 ports 10-12
Pluribus Networks nvOS Version 2.3.2
359
Pluribus Networks nvOS Version 2.3.2
360
l2-table-flush
This command is used to clear information about the Layer 2 settings.
Syntax l2-table-flush [vlan vlan-id] [port port-list]
Specify either zero or both options:
vlan vlan-id
Specifies the VLAN identifier.
port port-list
Specifies the port list.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to flush the Layer 2 information.
Examples To flush the Layer 2 table information from VLAN 25, use the following command:
CLI network-admin@switch > l2-table-flush vlan 25
See Also
• l2-history-show (deprecated)
• l2-setting-modify
• l2-setting-show
• l2-table-show
Pluribus Networks nvOS Version 2.3.2
361
Pluribus Networks nvOS Version 2.3.2
362
l2-table-show
To display Layer 2 flows in the forwarding table of the switch datapath, use this command.
Syntax l2-table-show [switch-id node name] [mac mac-address] [ip
ip-address] [config-intf config-intf-number][vlan vlan-id][vxlan
vxlan-id] intf intf-number [port port-number] [blocked-port
blocked-port-list] [rem-switch node-name] [rem-intf
rem-intf-number] [rem-ports port-list] [hostname
hostname-string] [hypervisor hypervisor-string] [vm-id
vm-id-string] [vm-name vm-name-string] [vm-flavor
vm-flavor-string] [vm-status
unknown|migrating|build|shutoff|reboot|hard_reboot|active|
rescued|suspended|paused|error|stopped|deleted|resized|
soft_deleted] [memory memory-number] [cpus cpus-number] [disk
disk-number] [os os-string] [config none|switch|ip|port|
hostname|hypervisor|vm-id|vm-name|vm-flavor|memory|cpus|disk|os]
[state
phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|
PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|
PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|no-pktin|
no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|remote-l3-port|vdp|
dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|vlag-active|
vlag-blocked|stp-edge-port|LACP-wait|LACP-fallback|
adjacency-wait|adjacency-check|vlag-wait|multicast-router]
[create-time date/time: yyyy-mm-ddThh:mm:ss] [last-time
date/time: yyyy-mm-ddThh:mm:ss] [hit number-of-hits] [migrate
number-of-migrates] [drops number-of-drops] [resolved-arp
true|false][rt-if rt-if-string]
switch-id node name
Specifies the node name for the L2 table.
mac mac-address
Specifies the source MAC address for the flow.
ip ip-address
Specifies the source IP address for the flow.
vlan vlan-id
Specifies the VLAN identifier for the flow.
vxlan vxlan-id
Specifies the ID for the VXLAN.
config-intf
config-intf-number
Specifies a configured interface number.
intf intf-number
Specifies the interface number.
ports port-list
Specifies the source port number for the flow.
hostname hostname-string
Specifies a hostname.
hypervisor hypervisor-string Specifies the hypervisor on the host.
vm-id vm-id-string
Specifies the VM ID on the host.
vm-name vm-name-string
Specifies the VM name on the host.
vm-flavor vm-flavor-string
Specifies the type of VM on the host.
Specifies the status of the VM.
vm-status
unknown|migrating|build|shut
off|reboot|hard_reboot|activ
e| rescued|
suspended|paused|error|stopp
ed|deleted|resized|soft_dele
ted
Pluribus Networks nvOS Version 2.3.2
363
memory memory-number
Specifies the amount of memory assigned to the VM.
cpus cpus-number
Specifies the number of CPUs assigned to the VM.
disk disk-number
Specifies the number of disks assigned to the VM.
os os-string
Specifies the name of the operating system (OS) running
on the VM.
config none|switch|ip|port| Displays the configuration on the host.
hostname|hypervisor|
vm-id|vm-name|vm-flavor|memo
ry|
cpus|disk|os
blocked-port
blocked-port-list
Specifies the list of ports that block packets matching the
flow.
rem-switch node-name]
Specifies a remote switch.
rem-intf rem-intf-number
Specifies a remote switch interface.
rem-ports port-list
Specifies a remote switch port list.
Specifies the status of the entry.
status
phy-up|up|disabled|hwnat-loop|mirror-loop|
mirror-to|inuse|
PN-switch|PN-fabric|PN-other
|PN-cluster|
PN-internal|
PN-hypervisor|PN-guest|
snmp-host|host|uplink|
drop-pkts|no-pktin|
no-fwd|no-flood|
STP-BPDUs|LLDP|trunk|
|l3-port|remote-l3-port|vdp|
dhcp|dhcpsvr|
blocked|no-BPDU|
LACP-PDUs|vlag-active|
vlag-blocked|stp-edge-port|L
ACP-wait|LACP-fallback|
adjacency-wait
|adjacency-check|vlag-wait|m
ulticast-router
tunnel tunnel-string
Specifies a tunnel name if configured.
create-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the date and time that the flow was inserted
into the Layer 2 table.
last-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the most recent date and time that a packet
matched the flow.
vxlan-lru date/time:
yyyy-mm-ddThh:mm:ss
Specifies the last received update time for a VXLAN.
hit number-of-hits
Specifies the number of packets that matched the flow.
Pluribus Networks nvOS Version 2.3.2
364
migrate number-of-migrates
Specifies the number of different ports that received
packets matching the flow.
drops number-of-drops
Specifies the number of packets matching the flow that
were dropped.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, state, added.
Pluribus Networks nvOS Version 2.3.2
365
Version 2.2
The parameters, switch-id, hostname, hypervisor,
vm-id, vm-name, vm-flavor, memory, disk, os, and
config added. The options, phy-up, up, disabled,
hw-nat-loop, mirror-loop, mirror-to, linuse,
PN-switch, PN-fabric, PN-other, PN-cluster,
PN-internal, PN-hypervisor, PN-guest, snmp-host,
host, uplink, drop-pkts, no-pktin, no-fwd,
no-flood, STP-BPDUs, LLDP, trunk, vdp, dhcp,
dhcpsvr, blocked, no-BPDU, LACP-PDUs,
vlag-active, vlag-blocked, stp-edge-p added to the
parameter state. The options, active, retired, pending,
recorded, aged-out-port-down, static, and software
deprecated. The parameters, resolved-arp, and rt-if
deprecated.
Version 2.2.4
The parameters, config-intf, rem-switch, rem-intf, and
rem-ports, added.
Version 2.2.5
The parameters, vlag-active, vlag-blocked,
stp-edge-port, deprecated. The parameters, l3-port and
remote-l3-port, added.
Version 2.3
The parameters, vlag-active, vlag-blocked,
stp-edge-port, added. The parameters vm-status, tunnel,
and vxlan-lru added.
Usage Each switch has automatic safeguards to avoid forwarding loops in Layer 2 multipathing. This
feature operates independently of Spanning Tree Protocol (STP) if STP is enabled. This command
lists the Layer 2 flows in the forwarding table of the switch datapath. If there are ports in the
blocked state may indicate the presence of loops in Layer 2 multipathing.
Pluribus Networks nvOS Version 2.3.2
366
Examples To display the Layer 2 table, use the following command:
CLI network-admin@switch > l2-table-show format all layout vertical
switch:
mac:
vlan:
hostname:
create-time:
last-seen:
hit:
switch:
mac:
vlan:
intf:
ports:
state:
hostname:
status:
last-seen:
switch:
mac:
vlan:
intf:
ports:
state:
hostname:
status:
create-time:
last-seen:
hit:
switch:
mac:
vlan:
intf:
ports:
state:
hostname:
status:
last-seen:
switch:
mac:
vlan:
intf:
ports:
state:
hostname:
status:
create-time:
last-seen:
hit:
switch:
mac:
vlan:
intf:
ports:
state:
pubdev02
02:08:20:38:00:c6
4094
pubdev02
04-22,08:17:16
04-22,08:17:16
1
pubdev01
02:08:20:72:2d:ff
4094
128
26,47-48
active,static
pubdev02
PN-internal
05-19,15:10:12
pubdev02
02:08:20:72:2d:ff
4094
65
65
active
pubdev02
PN-internal
04-22,08:53:08
05-19,15:03:08
1
pubdev03
02:08:20:72:2d:ff
4094
128
45-48
active,static
pubdev02
PN-internal
05-19,14:32:30
pubdev02
06:a0:00:03:00:1a
1
26
26
active
pubdev01
PN-switch,PN-fabric,PN-cluster
04-22,08:42:19
11:17:47
4045
pubdev03
06:a0:00:03:00:2d
1
45
45
active
Pluribus Networks nvOS Version 2.3.2
367
hostname:
status:
create-time:
last-seen:
hit:
migrate:
pubdev01
PN-switch,PN-fabric
04-22,07:49:03
05-19,15:10:29
2
10
See Also
• l2-history-show (deprecated)
• l2-setting-modify
• l2-setting-show
• l2-table-flush
Pluribus Networks nvOS Version 2.3.2
368
l3-history-show
This command displays historical information about Layer 2 entries on the switch.
Syntax [time date/time: yyyy-mm-ddTHH:mm:ss] [start-time date/time:
yyyy-mm-ddTHH:mm:ss] [end-time date/time: yyyy-mm-ddTHH:mm:ss]
[duration duration: #d#h#m#s] [interval duration: #d#h#m#s]
[since-start] [older-than duration: #d#h#m#s] [within-last
duration: #d#h#m#s] [log-type l2-save|l3-save|restart
|l2-modify|l2-delete|l3-modify|l3-delete] [caller
init|config|status|switch-cb|cluster|gre|ARP|router|flow-cb|
vdp|vlag|port|inject|evict|vxlan|stats|vnm-vnic|adjacency|stp|
trunk|intsw|ttl1|flood|flush|retire|loop|dhcp|fabric|table|
l3-age-out|vlan] [ last-caller init|config|status|switch-cb
|cluster|gre|ARP|router| flow-cb|vdp|vlag|port|inject
|evict|vxlan|stats|vnm-vnic| adjacency|stp|trunk|intsw|
ttl1|flood|flush|retire|loop|dhcp|fabric|table|l3-age-out|vlan]
[reason activate|deactivate|port-move|ip-move|ip-remove|
batch-move|retire|break-loop|break-loop-timeout|create|modify|
delete| policy|owner-status|remove-node|port-flags|check-owner|
trunk-port-add|trunk-port-remove|move-router-if|age-out|
hw-remove|restart|undo] [last-reason activate|deactivate|
port-move|ip-move|ip-remove| batch-move|retire|break-loop|
break-loop-timeout|create|modify| delete|policy|owner-status|
remove-node|port-flags|check-owner| trunk-port-add|
trunk-port-remove|move-router-if|age-out|
hw-remove|restart|undo] [changes owner|mac|ip|num-ips|
config-intf|intf|ports|state|local-intf|local-ports|local-state|
hostname|hypervisor|vm-id|vm-name| vm-flavor|vm-status|memory
|cpus|disk|os|config|blocked-port| rem-switch|rem-intf|
rem-ports|peer-intf|peer-state|status| tunnel|create-time|
last-seen|vxlan-lru|hit|migrate|drops] [count count-number]
[owner node name] [ mac mac-address ] [ vlan 0..4095 ] [ vxlan
0..16777215 ] [ ip ip-address ] [ num-ips num-ips-number ] [
config-intf config-intf-number ] [ intf intf-number ] [ ports
port-list ] [ vm-status
unknown|migrating|build|shutoff|reboot|hard_reboot|active|
rescued|suspended|paused|error|stopped|deleted|resized|
soft_deleted ] [ memory memory-number ] [ cpus cpus-number ] [
disk disk-number ] [ os os-string ] config
none|owner|ip|port|hostname|hypervisor|vm-id|vm-name|
vm-flavor|memory|cpus|disk|os ] [ blocked-port port-list ] [
rem-switch node name ] [ rem-intf rem-intf-number ] [ rem-ports
port-list ] [ status
phy-up|up|disabled|hw-nat-loop|mirror-loop|mirror-to|inuse|
PN-switch|PN-fabric|PN-other|PN-cluster|PN-internal|
PN-hypervisor|PN-guest|snmp-host|host|uplink|drop-pkts|
no-pktin|no-fwd|no-flood|STP-BPDUs|LLDP|trunk|l3-port|
remote-l3-port|vdp|dhcp|dhcpsvr|blocked|no-BPDU|LACP-PDUs|
vlag-active|vlag-blocked|stp-edge-port|LACP-wait|LACP-fallback|
adjacency-wait|adjacency-check|vlag-wait|multicast-router ] [
tunnel tunnel-string ] [ create-time date/time:
yyyy-mm-ddTHH:mm:ss ] [ last-seen date/time: yyyy-mm-ddTHH:mm:ss
] [ vxlan-lru date/time: yyyy-mm-ddTHH:mm:ss ] [ hit hit-number ]
[ migrate migrate-number ] [ drops drops-number ]
time date/time:
yyyy-mm-ddThh:mm:ss
Specifies a point in tjme for displaying historical information.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the start time for Layer 3 history collection.
Pluribus Networks nvOS Version 2.3.2
369
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the end time for Layer 3 history collection.
duration duration:
#d#h#m#s
Specifies the duration to collect the Layer 3 history.
interval duration:
#d#h#m#s
Specifies the intervals that nvOS collected Layer 3 history.
since-start
Specifies to display all of the Layer 3 history since collection began
on the fabric.
time date/time:
yyyy-mm-ddThh:mm:ss
Specifies a point in tjme for displaying historical information.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the start time for Layer 3 history collection.
Filter output by the log type of each entry. The log-type column
log-type
l2-save|l3-save|restart displays when a Layer 3 entry is created, modified, saved, or
|l2-modify|l2-delete|l3- deleted.
modify|l3-delete
Specifies the feature that made the change for this entry.
caller
init|config|status|switc
h-cb|cluster|gre|ARP|rou
ter|flow-cb|
vdp|vlag|port|inject|evi
ct|vxlan|stats|vnm-vnic|
adjacency|stp|
trunk|intsw|ttl1|flood|f
lush|retire|loop|dhcp|fa
bric|table|
l3-age-out|vlan
Specifies the most recent caller for this entry.
last-caller
init|config|status|switc
h-cb|cluster|gre|ARP|
router| flow-cb|vdp|
vlag|port|inject
|evict|vxlan|stats|vnm-v
nic| adjacency|stp
|trunk|intsw|ttl1|flood|
flush|retire|loop|dhcp|f
abric|table|l3-age-out|
vlan
Pluribus Networks nvOS Version 2.3.2
370
Specifies the reason for history entry.
reason
activate|deactivate|port
-move|ip-move|ip-remove|
batch-move|retire|breakloop|break-loop-timeout|
create|modify|
delete|
policy|owner-status|remo
ve-node|port-flags|check
-owner|
trunk-port-add|trunk-por
t-remove|move-router-if|
age-out|
hw-remove|restart|undo
Specifies the most recent reason for this entry.
last-reason
activate|deactivate|
port-move|ip-move|ip-rem
ove|
batch-move|retire|breakloop|
break-loop-timeout|creat
e|modify|
delete|policy|owner-stat
us|
remove-node|port-flags|c
heck-owner|
trunk-port-add|
trunk-port-remove|move-r
outer-if|age-out|
hw-remove|restart|undo
Pluribus Networks nvOS Version 2.3.2
371
Specifies what changed in this entry.
changes
owner|mac|ip|num-ips|
config-intf|intf|ports|s
tate|local-intf|local-po
rts|local-state|hostname
|hypervisor|vm-id|vm-nam
e| vm-flavor|vm-status
|memory|cpus|disk|os|
config|blocked-port|
rem-switch|rem-intf|
rem-ports|peer-intf|peer
-state|status| tunnel|
create-time|last-seen|
vxlan-lru|hit|migrate|
drops
Filter output by the number of entries summed using the sum-by
argument.
count count-number
owner node name
mac mac-address
Filter output by the Filter output by MAC address.
vlan vlan-id
Filter output by the VLAN ID.
vxlan vxlan-id
Filter output by the VXLAN ID.
ip ip-address
Filter output by the IP address.
num-ips num-ips-number
Specify the number of IP addresses for the Layer 3 entry.
config-intf
config-intf-number
Filter output by the configured interface of the Layer 3 entry.
intf intf-number
Filter output by the interface number. This is the port or trunk
number of the Layer 3 entry.
ports port-list
Filter output by the list of ports.
state
active|static|vrrp|
tunnel|software|
needs-peer-status|
port-mac|hit
Filter output by the state of the Layer 3 entry.
hostname hostname-string Filter output by the host name.
vm-id vm-id-string
Filter output by the ID assigned to the VM.
hypervisor
hypervisor-string
Filter output by the hypervisor for a VM.
vm-name vm-name-string
Filter output by the name of the VM.
vm-flavor
vm-flavor-string
Filter output by the VM flavor. This can be CentOS, Ubuntu, etc.
Pluribus Networks nvOS Version 2.3.2
372
Specify the VM status.
vm-status
unknown|migrating|build|
shutoff|reboot|hard_rebo
ot|active|
rescued|suspended|paused
|error|stopped|deleted|r
esized| soft_deleted
memory memory-number
Filter output by the amount of memory assigned to the VM.
cpus cpus-number
Filter output by the number of CPUs assigned to the VM.
disk disk-number
Filter output by the disk number where the VM is installed.
os os-string
Filter output by the OS installed on the VM.
Filter output by the configuration of the VM.
config
none|owner|ip|port|hostn
ame|hypervisor|vm-id|vmname|
vm-flavor|memory|cpus|di
sk|os
blocked-port port-list
Filter output by a list of ports to block for the VM.
rem-switch node name
Filter output by the remote switch name.
rem-intf rem-intf-number
Filter output by the remote interface number.
rem-ports port-list
Filter output by the remote ports.
Filter output by the status of the Layer 3 entry.
status
phy-up|up|disabled|hw-na
t-loop|mirror-loop|mirro
r-to|inuse|
PN-switch|PN-fabric|PN-o
ther|PN-cluster|PN-inter
nal|
PN-hypervisor|PN-guest|s
nmp-host|host|uplink|dro
p-pkts|
no-pktin|no-fwd|no-flood
|STP-BPDUs|LLDP|trunk|l3
-port|
remote-l3-port|vdp|dhcp|
dhcpsvr|blocked|no-BPDU|
LACP-PDUs|
vlag-active|vlag-blocked
|stp-edge-port|LACP-wait
|LACP-fallback|
adjacency-wait|adjacency
-check|vlag-wait|multica
st-router ]
Pluribus Networks nvOS Version 2.3.2
373
tunnel tunnel-string
Filter output by the tunnel name.
create-time date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the time that the Layer 3 entry was created.
last-seen date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the time that the Layer 3 entry was last seen on
the fabric.
vxlan-lru date/time:
yyyy-mm-ddTHH:mm:ss
Filter output by the number of received hits.
hit hit-number
Filter output by the number of times that the Layer 3 entry
migrated on the fabric.
migrate migrate-number
Filter output by the number of drops on the fabric.
drops drops-number
Filter output by the time that the Layer 3 entry was created.
Defaults None
Access CLI
History Command introduced in Version 2.3.2.1
Usage Use this command to display history of Layer 3 entries.
Examples To display Layer 2 information, use the following command:
CLI network-admin@switch > l3-history-show
time:
log-type:
caller:
reason:
owner:
mac:
vlan:
ip:
state:
09:02:33
l3-modify
ARP
activate,create
pleaides24
66:0e:94:f4:ec:6e
1
192.168.16.24
active
Pluribus Networks nvOS Version 2.3.2
374
l3-setting-modify
This command allows you to modify the Layer 3 settings.
Syntax l3-setting-modify aging-time seconds
Specify one or more of the following options:
aging-time
Specifies the aging time between 0 to 2000000 seconds. Use
0 (zero) to disable aging time. The default aging time is 600
seconds.
Defaults None
Access CLI
Usage Use this command to modify the Layer 3 setting.
Examples To modify the Layer 3 aging-time setting, use the following command:
CLI network-admin@switch > l3-setting-modify aging-time 1000
CLI network-admin@switch > l3-setting-show format all
switch:
s6000-1
aging-time(s): 1000
Pluribus Networks nvOS Version 2.3.2
375
Pluribus Networks nvOS Version 2.3.2
376
l3-setting-show
This command allows you to display the Layer 3 settings.
Syntax l3-setting-show
Defaults None
Access CLI
Usage Use this command to show the Layer 3 setting.
Examples To display the Layer 3 setting, use the following command:
CLI network-admin@switch > l3-setting-show format all
switch:
s6000-1
aging-time(s): 600
switch:
s6000-2
aging-time(s): 600
From this output, you can see that the aging time is set to 600 seconds by default.
Pluribus Networks nvOS Version 2.3.2
377
Pluribus Networks nvOS Version 2.3.2
378
l3-table-show
This command allows you to display the Layer 3 table settings.
Syntax l3-table-show
Specify one or more of the following options:
mac mac-address
Display the MAC address.
ip ip-address
Display the IP address.
vlan id5
Display the VLAN ID.
vxlan id
Display the assigned VXLAN.
intf intf-number
Display the interface.
rt-if rt-if-string
Display the router interface.
state active|static
Display the flags.
create-time date/time: Display the time entry created.
yyyy-mm-ddThh:mm:ss
last-seen date/time:
yyyy-mm-ddThh:mm:ss
Display the last time seen on network.
hit hit-number
Display the number of hits.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
379
Defaults None
Access CLI
Usage Use this command to show the Layer 3 table setting.
Examples To display the Layer 3 table setting, use the following command:
CLI network-admin@switch > l3-table-show format all
switch:
s6000-1
mac:
c6:8f:66:55:fe:30
ip:
192.168.1.3
vlan:
1
vxlan:
0
intf:
128
rt-if:
state:
active
create-time:
10-06,15:58:02
last-seen:
09:06:44
hit:
1764
There is no routing interface (rt-if) value because there are no Layer 3 routes configured on the switch.
Pluribus Networks nvOS Version 2.3.2
380
lacp-modify
This command is used to modify Link Aggregation Control Protocol (LACP) parameters on the switch.
Syntax lacp-modify [enable|disable] system-priority priority
Specify one or more of the following options:
enable|disable
Specify to enable or disable LACP on the switch.
system-priority
priority
Specifies the priority for the configuration. The default
value is 32768 with a range of 1 to 65535.
Defaults The default system-priority is 32768.
Access CLI
History Command introduced in nvOS Version 1.2.6
Usage Use this command to enable or disable LACP and set the priority.
Examples To enable LACP with a priority of 3567, use the following command:
CLI network-admin@switch > lacp-modify enable system-priority 3576
See Also
 lacp-show
Pluribus Networks nvOS Version 2.3.2
381
Pluribus Networks nvOS Version 2.3.2
382
lacp-show
This command is used to display information about Link Aggregation Control Protocol (LACP)
configurations on the switch.
Syntax lacp-show
switch
switch-name
Specifies the name of the switch in the configuration.
enable|disable
Specifies if LACP is enabled or disabled.
system-priority
priority
Specifies the priority for the configuration. The default
value is 32768 with a range of 1 to 65535.
system-id
id-string
Specifies the ID of the switch in the configuration. LACP
uses the system priority with the MAC address to form the
system ID and also during negotiation with other systems.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2
Usage Use this command to display information about the LACP configuration.
Pluribus Networks nvOS Version 2.3.2
383
Examples To display LACP information, use the following syntax
CLI network-admin@switch > lacp-show
switch:
pleiades24
enable:
yes
system-priority:
32768
systemid:800640e942c007a
switch:
pleiades32
enable:
yes
system-priority:
32768
systemid:800640e942c0143
See Also
 lacp-modify
Pluribus Networks nvOS Version 2.3.2
384
lldp-show
This command is used to display Link Layer Discovery Protocol (LLDP) information on the switch. Link
Layer Discovery Protocol (LLDP) allows Ethernet network devices such as switches and routers to receive
and transmit device-related information to directly connected devices on the network that are also
using the protocols, and to store the information that is learned about other devices.
Syntax lldp-show local-port local-port-number chassid-id
chassis-id-string port-id port-id-string
Specify any of the following options:
local-port
local-port-number
Specifies the local port where the LLDP packet is
received.
chassis-id
chassis-id-string
Specifies the chassis ID of the switch.
port-id port-id-string
Specifies the port of the switch sending the LLDP packet.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0
Pluribus Networks nvOS Version 2.3.2
385
Usage Use this command to display LLDP information on the switch.
Examples To display all LLDP information, use the following command:
CLI network-admin@switch > lldp-show
switch
local-port chassis-id port-id port-desc
sys-name
----------- ---------- ---------- ------- ---------------------------F64M-Leaf2 41
0a0000c5
41
PN Switch Port(41) F64-Spine1
F64M-Leaf2 42
0a0000c5
42
PN Switch Port(42) F64-Spine1
F64M-Leaf2 63
0a0001ca
63
PN Switch Port(63) F64M-Spine2
F64M-Leaf2 64
0a0001ca
64
PN Switch Port(64) F64M-Spine2
F64M-Spine2 11
0c0000b3
11
PN Switch Port(11) S68-Leaf1
F64M-Spine2 12
0c0000b3
12
PN Switch Port(12) S68-Leaf1
F64M-Spine2 43
0a0000c5
43
PN Switch Port(43) F64-Spine1
F64M-Spine2 44
0a0000c5
44
PN Switch Port(44) F64-Spine1
F64M-Spine2 63
0a0001c8
63
PN Switch Port(63) F64M-Leaf2
F64M-Spine2 64
0a0001c8
64
PN Switch Port(64) F64M-Leaf2
S68-Leaf1
11
0a0001ca
11
PN Switch Port(11) F64M-Spine2
S68-Leaf1
12
0a0001ca
12
PN Switch Port(12) F64M-Spine2
S68-Leaf1
31
0a0000c5
31
PN Switch Port(31) F64-Spine1
S68-Leaf1
32
0a0000c5
32
PN Switch Port(32) F64-Spine1
F64-Spine1 31
0c0000b3
31
PN Switch Port(31) S68-Leaf1
F64-Spine1 32
0c0000b3
32
PN Switch Port(32) S68-Leaf1
F64-Spine1 41
0a0001c8
41
PN Switch Port(41) F64M-Leaf2
F64-Spine1 42
0a0001c8
42
PN Switch Port(42) F64M-Leaf2
F64-Spine1 43
0a0001ca
43
PN Switch Port(43) F64M-Spine2
F64-Spine1 44
0a0001ca
44
PN Switch Port(44) F64M-Spine2
Pluribus Networks nvOS Version 2.3.2
386
log-alert-show
This command displays information about the log alerts on the switch.
Syntax log-alert-show [time date/time date/time: yyyy-mm-ddThh:mm:ss
[start-time date/time: yyyy-mm-ddThh:mm:ss] [end-time date/time:
yyyy-mm-ddThh:mm:ss][duration duration: #d#h#m#s][interval
duration: #d#h#m#s] [since-start|no-since-start] [older-than
duration: #d#h#m#s] [name name-string] [code code-number] [count
number]
time date/time:
yyyy-mm-ddThh:mm:ss]
Displays the timestamp for the log file.
start-time date/time:
yyyy-mm-ddThh:mm:ss
Displays the start time for the log file.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Displays the end time for the log file.
duration duration:
#d#h#m#s
Displays the duration of the log file.
interval duration:
#d#h#m#s
Displays the intervals that alerts occurred in the
duration.
since-start
Displays alerts collected from the start.
older-than duration:
#d#h#m#s
Displays alerts older than the duration.
within-last duration:
#d#h#m#s
Displays alerts collected within the last duration.
switch node name
Displays the name of the switch collecting the alert
data.
code code-number
Displays the code number of the alert.
name name-string
Displays the program name.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
Pluribus Networks nvOS Version 2.3.2
387
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to display information about the alert log.
Examples To display information about log alerts, use the following command:
CLI network-admin@switch > log-alert-show
No problems found
See Also
• log-audit-show
• log-event-settings-modify
• log-event-settings-show
• log-system-counters-reset
• log-system-counters-show
• log-system-show
Pluribus Networks nvOS Version 2.3.2
388
log-audit-show
This command displays information about the log audit configuration.
Syntax log-audit-show start-time date/time: yyyy-mm-ddThh:mm:ss
end-time date/time: yyyy-mm-ddThh:mm:ss duration duration:
#d#h#m#s [program program-string] [pid pid-number] [name
name-string] [code code-number] [vnet vnet-name] [remote_switch
node name] [user user-name][client-pid client-pid-number]
[client-addr ip-address] [port port-number] [vlan vlan-id]
[vxlan vxlan-name] [start-time date/time: yyyy-mm-ddThh:mm:ss]
[end-time date/time: yyyy-mm-ddThh:mm:ss][duration duration:
#d#h#m#s] [count number] starting-point starting-point-number
length length-number reverse|no-reverse
Specify between 0 and 2 of the following options:
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the start time for the audit log.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specifies the end time for the audit log.
duration duration:
#d#h#m#s
Specifies the duration of the audit log.
Specify any of the following options:
program program-string
Specifies the program type.
pid pid-number
Specifies the product indentifiier.
name name-string
Specifies the name to match.
code code-number
Specifies the code number.
vnet vnet-name
Specifies the name of the virtual network.
remote_switch node name Specifies the name of the remote switch.
user user-name
Spcifies the username.
client-pid
client-pid-number
Specifies the client program identifier.
client-addr ip-address
Specifies the client IP address.
port port-number
Specifies the port number.
vlan vlan-id
Specifies the VLAN identifier.
vxlan vxlan-name
Specifies the VXLAN identifier.
count number
Displays the count between 1 and 50000.
starting-point
starting-point-number
Specifies the starting point of the log audit.
length length-number
Specifies the length of the log audit.
reverse|
no-reverse
Specifies if the log is displayed in reverse or not.
Pluribus Networks nvOS Version 2.3.2
389
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.2
The parameters, starting-point, length and
reverse added.
Version 2.2.5
The IP address is logged as part of a user login event.
Usage Use this command to display information about the audit log.
Pluribus Networks nvOS Version 2.3.2
390
Examples To display information about log audits, use the following command:
CLI network-admin@switch > log-audit-show
CLI (network-admin@pleiades25) > log-audit-show layout vertical
length:
1628527
category:
audit
time:
2015-04-22,07:59:08.947601-07:00
switch:
pubdev01
program:
nvOSd
pid:
1242
name:
xact_command
code:
11101
remote_switch: pubdev03
user:
network-admin
client-addr:
10.9.10.24
message:
Transaction command "vlan-create id 25 scope fabric
stats" result success
starting-point: 8324
length:
1628813
category:
audit
time:
2015-04-22,08:08:32.577538-07:00
switch:
pubdev01
program:
nvOSd
pid:
1242
name:
user_command
code:
11001
user:
network-admin
client-pid:
5446
client-addr:
10.9.10.24
message:
Command "vlan-port-add vlan-id 25 ports 55 untagged"
result success
starting-point: 8324
length:
1629091
See Also
• log-event-show
• log-event-settings-modify
• log-event-settings-show
• log-system-counters-reset
• log-system-counters-show
• log-system-show
Pluribus Networks nvOS Version 2.3.2
391
Pluribus Networks nvOS Version 2.3.2
392
log-event-show
This command displays information about the log event configuration.
Syntax log-event-show [program program-string] [pid pid-number] [name
name-string] [code code-number] [event-type
system|port|tcp|stp|igmp|lldp|vdp|ecp|evb|ptp|openflow|
storage|tacacs|openstack|mld|mroute|vport] [vnet vnet-name]
[remote_switch node name] [user user-name] [client-pid
client-pid-number] [client-addr ip-address][port
port-number][vlan vlan-id] [vxlan vxlan-name] [start-time
date/time: yyyy-mm-ddThh:mm:ss] [end-time date/time:
yyyy-mm-ddThh:mm:ss][duration duration: #d#h#m#s] [count number]
starting-point starting-point-number length length-number
reverse|no-reverse
Specify between 0 and 2 of the following options:
start-time date/time:
yyyy-mm-ddThh:mm:ss
Displays the start time for the log file.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Displays the end time for the log file.
duration duration:
#d#h#m#s
Displays the duration of the log file.
Specify any of the following options:
program program-string
Specifies the program type.
pid pid-number
Specifies the program indentifiier.
name name-string
Specifies the program name.
code code-number
Specifies the code number.
Specifies the type of event.
event-type
system|port|tcp|
stp|igmp|lldp|lacp|
vdp|ecp|evb|ptp|
openflow| storage|
tacacs|openstack|mld|mr
oute|vport
Specifies the associated VNET.
vnet vnet-name
remote_switch node name Specifies the name of the remote switch.
user user-name
Specifies the username.
client-pid
client-pid-number
Specifies the client program identifier.
client-addr ip-address
Specifies the client IP address.
port port-number
Specifies the port number.
vlan vlan-id
Specifies the VLAN identifier.
vxlan vxlan-name
Specifies the VXLAN identifier.
count number
Displays the count in a range from 1 to 50000.
starting-point
starting-point-number
Specifies the starting point of the log audit.
Pluribus Networks nvOS Version 2.3.2
393
length length-number
Specifies the length of the log audit.
reverse|
no-reverse
Specifies if the log is reverse or not reverse.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The event type, TACACS, added.
Version 2.2
The parameters, starting-point, length and
reverse added.
Version 2.3.2.1
The parameters, mld|mroute|vport, added to event type.
Usage Use this command to display information about the event log.
Pluribus Networks nvOS Version 2.3.2
394
Examples To display information about log events, use the following command:
CLI network-admin@switch > log-event-show
category:
event
time:
2014-06-24,15:01:08.094640-07:00
switch:
pleiades24
program:
nvOSd
pid:
1384
name:
mac_ip_add
code:
11022
event-type:
port
port:
10
vlan:
11
message:
mac/ip address added mac=50:73:9f:e0:7f:fd
ip=172.16.23.3
category:
event
time:
2014-06-24,15:03:24.063484-07:00
switch:
pleiades24
program:
nvOSd
pid:
1384
name:
mac_ip_add
code:
11022
event-type:
port
port:
65
vlan:
11
message:
mac/ip address added mac=50:73:9f:e0:7f:fd
ip=172.16.23.2
category:
event
time:
2014-06-24,15:26:04.863472-07:00
switch:
pleaides
program:
nvOSd
pid:
1384
name:
mac_ip_add
code:
11022
See Also
• log-audit-show
• log-event-settings-modify
• log-event-settings-show
• log-system-counters-reset
• log-system-counters-show
• log-system-show
Pluribus Networks nvOS Version 2.3.2
395
Pluribus Networks nvOS Version 2.3.2
396
log-event-settings-modify
This command allows you to modify the log event settings.
Syntax log-event-settings-modify [system|no-system]
[port|no-port][tcp|no-tcp][stp|no-stp] [igmp|no-igmp]
[lldp|no-lldp] [lacp|no-lacp] [vdp|no-vdp] [ecp|no-ecp]
[evb|no-evb] [ptp|no-ptp] [openflow|no-openflow]
[storage|no-storage] tacacs|no-tacacs openstack|no-openstack
[mld|no-mld] [mroute|no-mroute]
Specify one or more of the following options:
system|no-system
Specifies system events.
port|no-port
Specifies the port event.
tcp|no-tcp
Specifies TCP events
stp|no-stp
Specifies the STP events.
igmp|no-igmp
Specifies IGMP events.
lldp|no-lldp
Specifies LLDP events.
lacp|no-lacp
Specifies LACP events.
vdp|no-vdp
Specifies VDP events.
ecp|no-ecp
Specifies ECP events.
evb|no-evb
Specifies EVB events.
ptp|no-ptp
Specifies PTP events.
openflow|no-openflow
Specifies Openflow events.
storage|no-storage
Specifies storage events.
tacacs|no-tacacs
Specifies TACACS events.
openstack|no-openstack
Specifies OpenStack events.
mld|no-mld
Specifies MLD events.
mroute|no-mroute
Specifies multicast routing events.
vport|no-vport
Specifies if vPort events are logged or not.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameter, TACACS, added.
Version 2.2
The parameter, openstack, added.
Version 2.2.5
The parameter, LACP, added.
Version 2.3
The parameters, mld and mroute, added.
Version 2.3.2
The parameter, vport, added.
Usage Use this command to modify log event settings including the type of event.
Pluribus Networks nvOS Version 2.3.2
397
Examples To modify the log event settings to exclude vdp events, use the following command:
CLI network-admin@switch > log-event-settings-modify no-vdp
See Also
• log-audit-show
• log-event-show
• log-event-settings-show
• log-system-counters-reset
• log-system-counters-show
• log-system-show
Pluribus Networks nvOS Version 2.3.2
398
log-event-settings-show
This command allows you to display the log event settings.
Syntax log-event-settings-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display log event settings including the type of event.
Pluribus Networks nvOS Version 2.3.2
399
Examples To display the log event settings, use the following command:
CLI network-admin@switch > log-event-settings-show
switch:
system:
port:
tcp:
stp:
igmp:
lldp:
lacp:
vdp:
ecp:
evb:
ptp:
openflow:
storage:
tacacs:
openstack:
switch:
system:
port:
tcp:
stp:
igmp:
lldp:
lacp:
vdp:
ecp:
evb:
ptp:
openflow:
storage:
tacacs:
openstack:
Pleiades24
on
on
off
off
off
off
off
off
off
off
off
off
on
on
on
Pleiades25
on
on
off
off
off
off
off
off
off
off
off
off
on
on
on
See Also
• log-audit-show
• log-event-show
• log-event-settings-modify
• log-system-counters-reset
• log-system-counters-show
• log-system-show
Pluribus Networks nvOS Version 2.3.2
400
log-system-counters-reset
This command resets the log counters on the switch.
Syntax log-system-counters-reset reset-time reset-time-string
reset-time
reset-time-string
Specify the reset time.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to reset log counters.
Examples To reset log counters, use the following commands:
CLI network-admin@switch > log-system-counters-reset
See Also
• log-system-show
• log-system-counters-show
Pluribus Networks nvOS Version 2.3.2
401
Pluribus Networks nvOS Version 2.3.2
402
log-system-counters-show
This command displays the log counters on the switch.
Syntax log-system-counters-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display log counters.
Examples To display log counters, use the following command:
CLI network-admin@switch > log-system-counters-show
switch
---------------pleiades24
pleiades25
critical
-------0
26
error
----0
0
warn
---390
546
note
---494
843
See Also
• log-system-show
Pluribus Networks nvOS Version 2.3.2
403
• log-system-counters-reset
Pluribus Networks nvOS Version 2.3.2
404
log-system-show
This command displays information about the log system configuration.
Syntax log-event-show [start-time date/time: yyyy-mm-ddThh:mm:ss]
[end-time date/time: yyyy-mm-ddThh:mm:ss][duration duration:
#d#h#m#s] [program program-string] [pid pid-number] [name
name-string] [code code-number] [level critical|error|warn|note]
[vnet vnet-name][remote_switch node name] [user user-name]
[client-pid client-pid-number] [client-addr ip-address] [port
port-number][vlan vlan-id] [vxlan vxlan-name] [count number]
[starting-point starting-point-number] [length
length-number][reverse|
no-reverse]]
Specify between 0 and 2 of the following options:
start-time date/time:
yyyy-mm-ddThh:mm:ss
Specify the start time for the log file.
end-time date/time:
yyyy-mm-ddThh:mm:ss
Specify the end time for the log file.
duration duration:
#d#h#m#s
Specify the duration of the log file.
Specify any of the following options:
program program-string
Specifies the program type.
pid pid-number
Specifies the program identifiier.
name name-string
Specifies the program name.
code code-number
Specifies the code number.
level
critical|error|warn|
note
Specifies the type of event.
vnet vnet-name
Specifies the VNET name.
remote_switch node name Specifies the name of the remote switch.
user user-name
Spcifies the username.
client-pid
client-pid-number
Specifies the client program identifier.
client-addr ip-address
Specifies the client IP address.
port port-number
Specifies the port number.
vlan vlan-id
Specifies the VLAN identifier.
vxlan vxlan-name
Specifies the VXLAN identifier.
count number
Displays the count.
starting-point
starting-point-number
Specifies the starting point of the log audit.
length length-number
Specifies the length of the log audit.
reverse|
no-reverse
Specifies if the log is reverse or not reverse.
Pluribus Networks nvOS Version 2.3.2
405
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to display information about the audit log.
Pluribus Networks nvOS Version 2.3.2
406
Examples To display information about system logging, use the following command:
CLI network-admin@switch > log-system-show
CLI (network-admin@pleiades25) > log-system-show format all layout
vertical
category:
system
time:
2014-06-16,10:33:54.425701-07:00
switch:
pleiades25
program:
nvOSd
pid:
1431
name:
fan_initial_status
code:
11303
level:
warn
message:
Fan 4 initial status ok
category:
system
time:
2014-06-16,10:33:54.425839-07:00
switch:
pleiades25
program:
nvOSd
pid:
1431
name:
ps_initial_status
code:
11302
level:
warn
message:
Power supply 1 initial status ok
category:
system
time:
2014-06-16,10:34:51.479611-07:00
switch:
pleiades25
program:
sh
pid:
3873
name:
smf_nvOSd_stop
code:
30108
level:
note
message:
SMF Service stopping nvOSd
category:
system
time:
2014-06-16,10:36:57.144770-07:00
switch:
pleiades25
program:
sh
pid:
871
name:
smf_nvOSd_start
code:
30107
level:
note
message:
SMF Service starting nvOSd
category:
system
time:
2014-06-16,10:36:58.543972-07:00
switch:
pleiades25
program:
nvOSd
pid:
1014
name:
nvOSd_start
code:
11008
level:
note
message:
===== nvOSd start:
version=2.1.201005777,pn-ONVL-2.0.2-2000212193
changeset=ceb01f7ff168 branch=default
category:
system
time:
2014-06-16,10:37:07.796715-07:00
switch:
pleiades25
program:
perl
Pluribus Networks nvOS Version 2.3.2
407
pid:
name:
code:
level:
message:
1506
fanmon_fan_status
30100
note
Controller 1 fan 1 speed 7050 RPM
See Also
• log-system-counters-reset
• log-system-counters-show
Pluribus Networks nvOS Version 2.3.2
408
M Commands
mcast-show
This command displays multicast group information for a switch.
Syntax mcast-show group-ip ip-address
group-ip
muticast-ip-address
Specifies the IP address for the multicast group.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults Unless otherwise specified, all multicast group membership information for the local switch is
displayed.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Hosts and adjacent switches on IPv4 networks can establish multicast group memberships.
Pluribus Networks nvOS Version 2.3.2
409
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mcast-show
group-ip
239.4.10.122
239.4.10.70
239.4.10.190
239.4.10.222
239.4.10.187
239.4.10.32
239.4.10.115
vlan
1
1
1
1
1
1
1
group-id
28
27
26
25
24
23
22
group-ports
43
43
17
17
17
17
17
Pluribus Networks nvOS Version 2.3.2
410
metadata-provider-stats-show
This command displays metadata provider information.
Syntax metadata-provider-stats-show [provider name-string] [vnet
name-string] [keys keys-number] [total-size total-size-number]
[scope local|fabric] [uuid uuid-string]
Specify two of the following parameters:
provider name-string
Specify the metadata provider name.
vnet name-string
Specify the VNET for the metadata.
Specify any of the following optional parameters:
keys keys-number
Specifies the number of keys.
total-size
total-size-number
Specifies the total size.
scope local|fabric
Specifies the scope of the metadata.
uuid uuid-string
Specifies the Universally Unique Identifier (UUID).
Defaults None
Access CLi
History Command introduced in Version 2.3.1.
Pluribus Networks nvOS Version 2.3.2
411
Pluribus Networks nvOS Version 2.3.2
412
mirror-create
This command is used to create mirror ports and flows Network engineers or administrators use port
mirroring to analyze and debug data or diagnose errors on a network. It helps administrators keep a
close eye on network performance and alerts them when problems occur. It can be used to mirror either
inbound or outbound traffic (or both) on single or multiple interfaces.
Syntax mirror-create name name-string [direction
ingress|egress|bidirection] [out-port port-list] [out-trunk
trunk name] [in-port port-list] [filtering
port|vflow-and-port|vflow-or-port] [enable|disable]
[other-egress-out allow|prevent]
name name-string
Specify a name for the mirror configuration.
direction
ingress|egress|
bidirection
Specify a direction for the mirrored traffic.
out-port port-list
Specify the port for outgoing traffic.
out-trunk trunk name
Specify the name of the outgoing trunk configuration.
in-port port-list
Specify the port for incoming traffic. Supported ports are
1-64 on the F64 platform. The parameter, all, is not
supported.
filtering port|
Specify the filter type for the configuration.
vflow-and-port|vflow-or
-port
enable|disable
Enable or disable the configuration.
other-egress-out
allow|prevent
Specify if other outgoing traffic is allowed or prevented.
The default value is prevent.
Defaults None
Access CLI
History Command introduced in Version 2.2.
Usage Use this command to create mirrored traffic or ports for analyzing traffic.
Examples To create a mirror configuration, mirror-port, with the direction egress, port 73, inbound port
33, filtering by port, and allow other egress traffic, use the following syntax:
CLI network-admin@switch > mirror-create name mirror-port direction
egress out-port 73 in-port 33 enable other-egress-out allow
See Also
• mirror-delete
• mirror-modify
• mirror-show
Pluribus Networks nvOS Version 2.3.2
413
Pluribus Networks nvOS Version 2.3.2
414
mirror-delete
This command is used to delete mirror ports and flows.
Syntax mirror-delete name name-string
name name-string
Specify a name for the mirror configuration.
Defaults None
Access CLI
History Command introduced in Version 2.2.
Usage Use this command to create mirrored traffic or ports for analyzing traffic.
Examples To delete a mirror configuration, mirror-port, use the following syntax:
CLI network-admin@switch > mirror-delete name mirror-port
See Also
• mirror-create
• mirror-modify
• mirror-show
Pluribus Networks nvOS Version 2.3.2
415
Pluribus Networks nvOS Version 2.3.2
416
mirror-modify
This command allows you to modify a port mirror configuration.
Syntax mirror-modify name name-string [out-port port-list] [out-trunk
trunk-name] [direction disabled|ingress|egress|bidirection]
[in-port port-list][filtering port|vflow-and-port|vflow-or-port]
[other-egress-out allow|prevent]
Specify the name of the mirror configuration to modify.
name name-string
Specify any of the following options:
direction
disabled|ingress|
egress|bidirection
Specify the direction of the traffic that you want to mirror
on the port.
out-port port-list
Specify the list of ports for outgoing network traffic.
out-trunk trunk-name
Specify the trunk name for the outgoing trunk.
in-port port-list
Specify the list of ports for incoming network traffic.
filtering
port|vflow-and-port|
vflow-or-port
Specify the type of traffic to filter.
enable|disable
Enable or disable port mirroring on the network.
other-egress-out
allow|prevent
Specify if other outgoing traffic is allowed or prevented.
Defaults None.
Access CLI
History
Version 1.2
port-mirror-modify introduced.
Version 2.0
Command changed to mirror-modify.
Version 2.1
The parameter, out-trunk, added.
Version 2.2.2
The parameter, direction, added.
Version 2.2.3
The parameter, policy, changed to filtering. The parameter
other-egress-out added. j
Usage Port mirroring is used to send copies of network traffic on one port to a network monitoring
connection on another port. You can use this command to enable or disable port mirroring as
well as designate the ports to use for it.
Examples To enable port mirroring on outbound ports 3-5 and inbound ports 8-9, use the following
command:
CLI network-admin@switch > mirror-modify out-port 3-5 in-port 8-9
mirroring
See Also
• mirror-show
• port-show
• port-config-modify
Pluribus Networks nvOS Version 2.3.2
417
• port-config-show
• port-phy-show
• port-stats-show
• port-vlan-add
• port-vlan-remove
• port-vlan-show
• port-xcvr-show
Pluribus Networks nvOS Version 2.3.2
418
mirror-show
This command is used to display information about port mirroring on the switch.
Syntax mirror-show [name name-string] [id] [ direction
ingress|egress|bidirection ] [out-port port-list] [out-trunk
trunk name] [loopback-port loopback-port-number] [in-port
port-list] [filtering port|vflow-and-port|vflow-or-port]
[enable|disable] [other-egress-out allow|prevent]]
name name-string
Specifies a name for the mirror configuration.
id
Specifies the mirror ID assigned by nvOS.
direction
ingress|egress|
bidirection
Specifies a direction for the mirrored traffic.
out-port port-list
Specifies the port for outgoing traffic.
out-trunk trunk name
Specifies the name of the outgoing trunk configuration.
loopback-port
loopback-port-number
Specifies the loopback port for mirrored traffic.
in-port port-list
Specifies the port for incoming traffic.
filtering port|
Specifies the filter type for the configuration.
vflow-and-port|vflow-or
-port
enable|disable
Enable or disable the configuration.
other-egress-out
allow|prevent
Specifies if other outgoing traffic is allowed or prevented.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
419
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
Command changed to mirror-show.
Usage Use this command to display port mirroring information.
Examples To display information about port mirroring, use the following command:
CLI (network-admin@pleiades25) > mirror-show
switch:
pleiades25
mirroring:
disable
See Also
• mirror-modify
• port-show
• port-config-modify
• port-config-show
• port-phy-show
• port-stats-show
• port-vlan-add
• port-vlan-remove
• port-vlan-show
• port-xcvr-show
Pluribus Networks nvOS Version 2.3.2
420
mld-router-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Syntax mld-router-show group-ip ip-address node-ip ip-address vlan
vlan-id port port-number source-ip ip-address node-type
host|router expires expires-numbers
group-ip ip-address
Specifies the name of the IP group for the MLD
configuration.
node-ip ip-address
Specifies the name of the IP node for the MLD
configuration.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration.
port port-number
Specifies the number of the port for the MLD
configuration.
source-ip ip-address
Specifies the IP source name for the MLD configuration.
node-type host|router
Specifies the node type.
expires
expires-numbers
Specifies the ageout time on the MLD router.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
421
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Examples To display MLD router parameters for the local switch, use the following command:
CLI network-admin@switch > mld-router-show
Pluribus Networks nvOS Version 2.3.2
422
mld-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-show switch name-string group-ip ip-address node-ip
ip-address vlan vlan-id port port-number source-ip ip-address
node-type Host|Router expires expires-number(s)
switch name-string
Specifies the name of the switch for the MLD
configuration.
group-ip ip-address
Specifies the name of the IP group for the MLD
configuration.
node-ip ip-address
Specifies the name of the IP host for the MLD
configuration.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration.
port port-number
Specifies the number of the port for the MLD
configuration.
source-ip ip-address
Specifies the IP source name for the MLD configuration.
node-type Host|Router
Specifies the node type as host or router.
expires
expires-number(s)
Specifies the ageout time.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
423
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage Default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Examples To display MLD parameters for the local switch, use the following command:
CLI network-admin@switch > mld-show
switch:
group-ipv6:
host-ipv6:
vlan:
port:
source-ipv6:
aquila-ext-01
ff02::1:ff11:1111
fe80::3636:3bff:fece:44f2
100
8,69
2001:db8::2:1
Pluribus Networks nvOS Version 2.3.2
424
mld-snooping-modify
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically to
forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-snooping-modify scope local|fabric enable|disable
scope local|fabric
Modify the scope of MLD Snooping to local or fabric.
enable|disable
Enable, disable MLD Snooping.
Defaults None.
Access CLI
Usage When MLD Snooping is not configured, multicast traffic is forwarded to all the switch ports,
impacting switch performance. Use this command to modify the scope of MLD Snooping or to
enable or disable.
Examples To modify the scope from local to fabric use the following syntax:
CLI network-admin@switch > mld-snooping-modify scope fabric
Pluribus Networks nvOS Version 2.3.2
425
Pluribus Networks nvOS Version 2.3.2
426
mld-snooping-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-snooping-show
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance.
Pluribus Networks nvOS Version 2.3.2
427
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-snooping-show
switch:
enable:
aquila-ext-01
yes
Pluribus Networks nvOS Version 2.3.2
428
mld-stats-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Syntax mld-stats-show vlan vlan-id
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance.
Pluribus Networks nvOS Version 2.3.2
429
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-stats-show
Pluribus Networks nvOS Version 2.3.2
430
mld-static-group-create
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically to
forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-group-create [group-ip ip-address] [vlan vlan-id]
[ports port-list]
group-ip ip-address
Specifies the name of the IP group for the MLD
configuration.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration.
ports port-list
Specifies the list of the ports for the MLD configuration
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance.
Examples To create a multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-static-group-create
Pluribus Networks nvOS Version 2.3.2
431
Pluribus Networks nvOS Version 2.3.2
432
mld-static-group-delete
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically to
forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-group-delete [group-ip ip-address] [vlan vlan-id}
group-ip ip-address
Specifies the name of the IP group for the MLD
configuration to be deleted.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration to
be deleted.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded
to all the switch ports, impacting switch performance.
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-static-group-delete
Pluribus Networks nvOS Version 2.3.2
433
Pluribus Networks nvOS Version 2.3.2
434
mld-static-group-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-group-show group-ip ip-address vlan vlan-id ports
port-list
group-ipv6 ip-address
Specifies the name of the IP group for the MLD
configuration.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration.
ports port-list
Specifies the number of the port for the MLD
configuration.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
Pluribus Networks nvOS Version 2.3.2
435
History Command introduced in nvOS Version 2.3.
Usage When MLD Snooping is not configured, multicast traffic is forwarded to all the switch ports,
impacting switch performance.
Examples To display MLD parameters for the local switch, use the following command:
CLI network-admin@switch > mld-static-group-show
switch:
group-ipv6:
vlan:
port:
aquila-ext-01
ff02::1:ff11:1111
100
8,69, 129
Pluribus Networks nvOS Version 2.3.2
436
mld-static-source-create
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically to
forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-source-create [source-ip ip-address][group-ip
ip-address] [vlan vlan-id] [ports port-list]
source-ip ip-address
Specifies the source IPv6 address for the MLD
configuration.
group-ip ip-address
Specifies the source of the IP group for the MLD
configuration.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration.
ports port-list
Specifies the list of the ports for the MLD configuration.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance.
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-static-source-create
Pluribus Networks nvOS Version 2.3.2
437
Pluribus Networks nvOS Version 2.3.2
438
mld-static-source-delete
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically to
forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic will be forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-source-delete [source-ip ip-address][group-ip
ip-address] [vlan vlan-id]
source-ip ip-address
Specifies the source IPv6 address for the MLD
configuration to be deleted.
group-ip ip-address
Specifies the source of the IP group for the MLD
configuration to be deleted.
vlan vlan-id
Specifies the ID of the VLAN for the MLD configuration to
be deleted.
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance. For this CLI, the group has to be seated
statically already.
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-static-source-delete
Pluribus Networks nvOS Version 2.3.2
439
Pluribus Networks nvOS Version 2.3.2
440
mld-static-source-show
Multicast Listener Discovery (MLD) is a Layer 3 multicast protocol used between IPv6 hosts and routers
similar to how IGMP is used for IPv4. MLD snooping allows a switch to examine MLD packets and make
forwarding decisions based on their content.
MLD snooping constrains IPv6 multicast traffic at Layer 2 by configuring Layer 2 LAN ports dynamically
to forward IPv6 multicast traffic only to those ports that want to receive it.
The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all the
switch ports, impacting switch performance.
Syntax mld-static-source-show switch name-string group-ip ip-address
vlan vlan-id source-ip ip-address host-ip ip-address ports
port-list
switch name-string
Specifies the name of the given switch.
group-ip ip-address
Specifies the IP address of the group.
vlan vlan-id
Specifies the name of the VLAN.
source-ip ip-address
Specifies the IP address of the source.
host-ip ip-address
Specifies the IP address of the host.
ports port-list
Specifies the list of ports.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
441
Defaults None.
Access CLI
History Command introduced in nvOS Version 2.3.
Usage The default behavior, when MLD Snooping is not configured, multicast traffic is forwarded to all
the switch ports, impacting switch performance.
Examples To display all multicast group memberships for the local switch, use the following command:
CLI network-admin@switch > mld-static-source-show
switch:
group-ip:
vlan:
source-ip:
host-ip:
ports:
aquila-ext-01
ff02::1:ff11:1111
100
2001:db8::2:1
fe80::3636:3bff:fece:44f2
8,69,129
Pluribus Networks nvOS Version 2.3.2
442
N Commands
nat-create
This command creates a new Network Address Translation (NAT) service for a fabric, cluster, or
standalone switch.
Syntax nat-create name name-string vnet vnet-name
[dedicated-vnet-service|shared-vnet-service] [disable|enable]
[storage-pool storage-pool-name]
name name-string
Specify a name for the NAT service.
vnet vnet-name
Specify a VNET to apply the NAT service.
Specify any of the following options:
dedicated-vnet-service| Specify if the NAT service is shared or dedicated.
shared-vnet-service
enable|disable
Enables or disables the NAT service.
storage-pool
storage-pool-name
Specify a storage-pool for the NAT service.
Defaults Enabled by default.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, switch, or VNET can provide tenants with a NAT service to translate private
IP addresses into public IP addresses. This command creates a new NAT service.
Examples To create a new NAT service, MyNATservice, for a VNET, MyVNET, use the following
command:
CLI network-admin@switch > nat-create name MyNATservice vnet MyVNET
enable
See Also
• nat-delete
• nat-migrate
• nat-modify
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
Pluribus Networks nvOS Version 2.3.2
443
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
444
nat-delete
This command deletes an existing NAT service.
Syntax nat-delete name name-string
Specify the name of the NAT service to delete from the
configuration.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, switch, or vnet can provide tenants with a NAT service to translate private IP
addresses into public IP addresses. This command deletes a new NAT service.
Examples To delete the existing NAT service, MyNAT, use the following command:
CLI network-admin@switch > nat-delete MyNAT
See Also
• nat-create
• nat-migrate
• nat-modify
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
445
Pluribus Networks nvOS Version 2.3.2
446
nat-migrate
This command is used to migrate the NAT configuration from a location to a storage pool on the switch.
Syntax nat-migrate name name-string location fabric-node-name
storage-pool storage-pool-name
Specify the name of the NAT configuration to migrate
from one location to another.
name name-string
Specify between 1 and 2 of the following options:
location
fabric-node-name
Specify the location of the fabric with the NAT
configuration.
storage-pool
storage-pool-name
The name of the storage pool to migrate the NAT
configuration.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to migrate a NAT from one location to another.
Examples To migrate the NAT, lab-to-nat, to location node-4, use the following command:
CLI network-admin@switch > nat-migrate nat-name lab-to-nat location
node-4
See Also
• nat-create
• nat-delete
• nat-modify
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
447
Pluribus Networks nvOS Version 2.3.2
448
nat-modify
This command modifies an existing Network Address Translation (NAT) service for a fabric, cluster, or
standalone switch.
Syntax nat-modify name name-string vnet vnet-name [disable|enable]
[gateway ip-address]]
Specify a name for the NAT service.
name name-string
Specify one or more of the following options:
enable|disable
Enables or disables the NAT service.
gateway ip-address
Specify an IP address for the gateway.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Each fabric, cluster, switch, or vnet can provide tenants with a NAT service to translate private IP
addresses into public IP addresses. This command modifies an existing NAT service.
Examples To modify a new NAT service, MyNATservice, and disable it, use the following command:
CLI network-admin@switch > nat-modify name MyNATservice disabled
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
449
Pluribus Networks nvOS Version 2.3.2
450
nat-show
This command displays information about an existing Network Address Translation (NAT) service for a
fabric, cluster, or standalone switch.
Syntax nat-show id id name name-string [type vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|ofpd|orphaned|netvm|nat|openstack|netvmm|ovs]
[scope local|fabric][vnet vnet-name location fabric-node name]
id id
Specifies the NAT identifier.
name name-string
Specifies the name of the NAT service.
Specifies where the NAT service is assigned.
type
vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|ofpd|
orphaned|netvm|nat|open
stack|netvmm|ovs
scope local|fabric
Specifies the scope of the NAT service.
vnet vnet-name
Specifies the VNET that the NAT service is assigned.
location fabric-node
name
Specifies the location for the fabric node.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
451
Defaults None.
Access CLI
License SDF
History .
Version 1.2
Command introduced.
Version 2.1
The options, openstack and netvmm, added to the parameter
type.
Version 2.2
The option, ovs, added to the parameter type.
Usage Each fabric, cluster, switch, or VNET can provide tenants with a NAT service to translate private IP
addresses into public IP addresses. This command displays information existing NAT services.
Examples To display all NAT configurations, use the following command:
CLI (network-admin@pleiades25) > nat-show
name
type scope vnet
vnet-service state
gateway
---------- ---- ------ ------ ------------ ------- ------redhat-nat nat fabric redhat shared
enabled ::
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-modify
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
452
nat-interface-add
This command is used to add a NAT interface to the switch configuration.
Syntax nat-interface-add nat-name name-string [ip ip-address] [netmask
netmask] [assignment none|dhcp|dhcpv6] [vlan vlan-id] [vxlan
vxlan-id] [if mgmt|data|span] [alias-on alias-string]
exclusive|no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
nat-name name-string
Specify the name of the NAT interface.
Specify any of the following options:
ip ip-address
Specify the IP address in dotted decimal notation text.
netmask netmask
Specify the netmask.
assignment
none|dhcp|dhcpv6
Specify how the IP address is obtained.
None - IP address is static
DHCP - receives the IPv4 address from a DHCP server.
DHCPv6 - receives the IPv6 address from a DHCPv6
server.
vlan vlan-id
Specify the VLAN for the NAT interface.
vxlan vxlan-id
Specify the VXLAN identifier for the NAT interface.
if mgmt|data|span
Specify the type of port for the interface.
alias-on alias-string
Specify an alias for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, no-exclusive, nic-enable, and
nic-disable added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Used to specify an interface to provide NAT services.
Examples To add a NAT interface, NAT-eng, with the IP address of 205.189.35.43/24, use the following
command:
CLI network-admin@switch > nat-interface-add nat-name NAT-eng ip
205.189.35.43 netmask 24
See Also
• nat-create
Pluribus Networks nvOS Version 2.3.2
453
• nat-delete
• nat-migrate
• nat-modify
• nat-show
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
454
nat-interface-modify
This command is modify a NAT interface on the switch configuration.
Syntax nat-interface-modify nat-name name-string [nic nic-string][ip
ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6]
[vlan vlan-id] [vxlan vxlan-id] [if mgmt|data|span] [alias-on
alias-string]exclusive|no-exclusive nic-enable|nic-disable
secondary-macs secondary-macs-string
nat-name name-string
Specify the name of the NAT interface.
Specify any of the following interface arguments:
Specify the NIC assigned to the NAT interface.
nic nic-string
Specify any of the following options:
ip ip-address
Specify the IP address in dotted decimal notation text.
netmask netmask
Specify the netmask.
assignment
none|dhcp|dhcpv6
Specify how the IP address is obtained.
• None - IP address is static
• DHCP - receives the IPv4 address from a DHCP server.
• DHCPv6 - receives the IPv6 address from a DHCPv6 server.
vlan vlan-id
Specify the VLAN for the NAT interface.
vxlan vxlan-id
Specify the VXLAN identifier for the NAT interface.
if mgmt|data|span
Specify the type of port for the interface.
alias-on alias-string
Specify an alias for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, no-exclusive, nic-enable, and
nic-disable added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Used to modify a NAT interface configuration.
Examples To modify a NAT interface, NAT-eng, to have the IP address of 205.189.35.45/24, use the
following command:
CLI network-admin@switch > nat-interface-add nat-name NAT-eng ip
205.189.35.45 netmask 24
Pluribus Networks nvOS Version 2.3.2
455
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
456
nat-interface-remove
This command is used to remove an existing NAT interface.
Syntax nat-interface-remove nat-name name-string nic nic-string
nat-name name-string
The NAT interface that you want to remove from the
configuration.
Specify any of the following interface arguments:
The network interface card (NIC) to remove the NAT
interface.
nic nic-string
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to remove an existing NAT interface from the configuration.
Examples To remove the NAT interface, NAT-eng, on nic 3, use the following command:
CLI network-admin@switch > nat-interface-remove NAT-eng nic eth3
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
457
Pluribus Networks nvOS Version 2.3.2
458
nat-interface-show
This command is used to display information about a NAT interface in the switch configuration.
Syntax nat-interface-show nat-name name-string [nic nic-string][ip
ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6] [mac
mac-address] [vlan vlan-id] [vxlan vxlan-id] [if mgmt|data|span]
[alias-on alias-string] [vm-nic-type e1000|virtio]
exclusive|no-exclusive nic-enable|nic-disable nic-state down|up
nat-name name-string
Specifies the name of the NAT interface.
Specify any of the following interface arguments:
nic nic-string
Specifies the NIC to remove the NAT interface.
ip ip-address
Specifies the IP address in dotted decimal notation text.
netmask netmask
Specifies the netmask.
assignment
none|dhcp|dhcpv6
Specifies how the IP address is obtained.
• None - IP address is static
• DHCP - receives the IPv4 address from a DHCP server.
• DHCPv6 - receives the IPv6 address from a DHCPv6 server.
mac mac-address
Specifies the MAC address of the interface.
vlan vlan-id
Specifies the VLAN for the NAT interface.
vxlan vxlan-id
Specifies the VXLAN identifier for the NAT interface.
if mgmt|data|span
Specifies the type of port for the interface.
alias-on alias-string
Specifies an alias for the interface.
exclusive|
no-exclusive
Specifies if the interface is exclusive or not.
nic-enable|
nic-disable
Specifies if the NIC is enabled or disabled.
nic-state down|up
Specifies the status of the NIC as up or down.
secondary-macs
secondary-macs-string
Specifies a secondary MAC address.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
Pluribus Networks nvOS Version 2.3.2
459
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.1
The parameters, exclusive, no-exclusive, nic-enable,
nic-disable, and nic-state added.
Version 2.2.2
The parameter, vm-nic-type, deprecated.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Used to display information about a NAT interface configuration.
Pluribus Networks nvOS Version 2.3.2
460
Examples To display a NAT interface, use the following command:
CLI (network-admin@pleiades24) > nat-interface-show format all layout
vertical
nat-name:
redhat-nat
nic:
eth0.14
ip:
172.16.23.1/24
assignment: static
mac:
66:0e:94:21:78:2e
vlan:
14
vxlan:
0
if:
data
alias-on:
exclusive:
no
nic-config: disable
nic-state:
up
nat-name:
redhat-nat
nic:
eth0
ip:
10.9.10.24/16
assignment: dhcp
mac:
66:0e:94:21:68:bf
vlan:
0
vxlan:
0
if:
mgmt
alias-on:
exclusive:
no
nic-config: enable
nic-state:
up
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
461
Pluribus Networks nvOS Version 2.3.2
462
nat-map-add
This command is used to map IP addresses to an external NAT interface.
Syntax nat-map-add nat-name name-string name name-string ext-interface
nat-interface-nic network ip-address netmask netmask
nat-name name-string
Specify the name for the NAT map.
Specify any of the following map arguments:
name name-string
Specify the name of the NAT interface.
ext-interface
nat-interface-nic
Specify the external interface to use for the NAT map.
network ip-address
Specify the IP address to map to the interface.
netmask netmask
Specify the netmask for IP address.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Configure a NAT map to an external interface.
Examples To map an IP address to an external interface named west-wing to IP address
201.135.27.21/24 and name the map, lab-to-nat, use the following command:
CLI network-admin@switch > nat-map-add lab-to-nat name west-wing
ext-interface eth.03 network 201.135.27.21/24
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
463
Pluribus Networks nvOS Version 2.3.2
464
nat-map-remove
This command is used to remove a NAT map from the switch configuration.
Syntax nat-map-remove nat-name name-string name name-string
nat-name name-string
Specify the name of the NAT map to remove from the
configuration.
Specify the following map arguments:
The name of the interface to remove from the
configuration.
name name-string
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to remove a NAT map from the switch configuration.
Examples To remove the NAT map, lab-to-nat, and external interface, west-wing, use the following
command:
CLI network-admin@switch > nat-map-remove nat-name lab-to-nat name
west-wing
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
465
Pluribus Networks nvOS Version 2.3.2
466
nat-map-show
This command is used to display NAT map information.
Syntax nat-map-show nat-name name-string name name-string ext-interface
nat|interface|nic network ip-address netmask netmask
nat-name name-string
Specifies the name for the NAT map.
Specify any of the following map arguments:
name name-string
Specifies the name of the NAT interface.
ext-interface
nat|interface|nic
Specifies the external interface to use for the NAT map.
network ip-address
Specifies the IP address to map to the interface.
netmask netmask
Specifies the netmask for IP address.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Configure a NAT map to an external interface.
Pluribus Networks nvOS Version 2.3.2
467
Examples To display information about NAT maps, use the following command:
CLI (network-pleiades24) > nat-map-show
nat-name
name
ext-interface network
---------- ---------- ------------- -----------redhat-nat redhat-map eth0
10.9.10.0/16
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
468
nat-port-forward-add
This command is used to add a forwarding port to a NAT service on a fabric, cluster, or standalone switch.
Syntax nat-port-forward-add nat-name name-string name name-string
ext-interface nat-interface-nic ext-ip ip-address ext-port
ext-port-number int-ip ip-address int-port int-port-number
nat-name name-string
Specify the name of the NAT service.
Specify any of the following port-forward arguments:
name name-string
Specify a name for the port forwarding service.
ext-interface
nat-interface-nic
Specify an external interface for port forwarding.
ext-ip ip-address
Specify an external IP address for the NAT map.
ext-port
ext-port-number
Specify an external port for port forwarding.
int-ip ip-address
Specify the internal IP address.
int-port
int-port-number
Specify the internal port number.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.2.2
The parameter, ext-ip, added.
Usage You can configure port forwarding for a NAT service to allow network traffic to reach a specific
IP address and port.
Examples To configure port forwarding for NAT service, vnet1-nat, with the name vml-ssh, from
the external IP address 10.100.1.1 and external port 8888 to internal IP address
192.168.18.4 and internal port 22, use the following command:
CLI network-admin@switch > nat-port-forward-add nat-name vnet1-nat name
vml-ssh ext-ip 10.100.1.1 ext-port 8888 int-ip 192.168.18.4 int-port 22
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
Pluribus Networks nvOS Version 2.3.2
469
• nat-map-show
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
470
nat-port-forward-remove
This command is used to remove port forwarding from a NAT service on a fabric, cluster, or standalone
switch.
Syntax nat-port-forwarding-remove nat-name name-string name name-string
nat-name name-string
Specify the name of the NAT service.
Specify the following port-forward arguments:
Specify a name for the port forwarding service.
name name-string
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage You can configure port forwarding for a NAT service to allow network traffic to reach a specific IP
address and port. This command removes port forwarding from a NAT service.
Examples To remove port forwarding, vml-ssh, for NAT service, vnet1-nat, use the following
command:
CLI network-admin@switch > nat-port-forward-remove nat-name vnet1-nat
name vml-ssh
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-show
• nat-static-nat-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
471
Pluribus Networks nvOS Version 2.3.2
472
nat-port-forward-show
This command displays information about port forwarding for a NAT service on a fabric, cluster, or
standalone switch.
Syntax nat-port-forward-add nat-name name-string name name-string
ext-interface nat-interface-nic ext-ip ip-address ext-port
ext-port-number int-ip ip-address int-port int-port-number
nat-name name-string
Specify the name of the NAT service.
Specify any of the following port-forward arguments:
name name-string
Specify a name for the port forwarding service.
ext-interface
nat-interface-nic
Specify an external interface for port forwarding.
ext-ip ip-address
Specify an external IP address.
ext-port
ext-port-number
Specify an external port for port forwarding.
int-ip ip-address
Specify the internal IP address.
int-port
int-port-number
Specify the internal port number.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
473
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.2.2
The parameter, ext-ip, added.
Usage You can configure port forwarding for a NAT service to allow network traffic to reach a specific IP
address and port.
Examples To display port forwarding information for NAT services, use the following command:
CLI (network-admin@pleiades25) > nat-port-forward-show
nat-name
name ext-interface ext-port int-ip
int-port
---------- ---- ------------- -------- ----------- -------redhat-nat web eth0
8080
172.16.23.4 80
redhat-nat vnc eth0
6080
172.16.23.4 6080
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-static-nat-show
• nat-static-nat-add
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
474
nat-static-nat-add
This command is used to configure a static NAT service.
Syntax nat-static-nat-add nat-name name-string external-ip ip-address
internal-ip ip-address
nat-name name-string
Specify the name of the NAT service.
Specify any of the following static NAT arguments:
external-ip ip-address
Specify the external IP address for the configuration.
internal-ip ip-address
Specify the internal IP address for the configuration.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Used to configure one to one NAT when a dynamic configuration is not possible.
Examples To configure a static NAT, web-site, with internal IP address 10.1.1.5 to external IP address
203.135.25.11, use the following command:
CLI network-admin@switch > nat-static-nat-add web-site external-ip
203.235.25.11 internal-ip 10.1.1.5
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-remove
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
475
Pluribus Networks nvOS Version 2.3.2
476
nat-static-nat-remove
This command is used to remove a static NAT configuration from the switch.
Syntax nat-static-nat-remove nat-name name-string external-ip
ip-address
nat-name name-string
Specify the name of the static NAT service to remove
from the configuration.
Specify the following static NAT arguments:
external-ip ip-address
Specify the external IP address of the static
configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Remove a static NAT service from the configuration.
Examples To remove a static NAT, web-site, with external IP address 203.135.25.11, use the following
command:
CLI network-admin@switch > nat-static-nat-remove nat-name web-site
external-ip 203.135.25.11
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-static-nat-add
• nat-static-nat-show
Pluribus Networks nvOS Version 2.3.2
477
Pluribus Networks nvOS Version 2.3.2
478
nat-static-nat-show
This command is used to configure a static NAT service.
Syntax nat-static-nat-show nat-name name-string ip ip-address
external-interface nat|interface|nic internal-ip ip-address
nat-name name-string
Displays the name of the NAT service.
Specify any of the following static NAT arguments:
external-ip ip-address
Displays the external IP address for the configuration.
external-interface
nat|interface|nic
Displays the type of external interface used in the NAT
service.
internal-ip ip-address
Displays the internal IP address for the configuration.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
License SDF
History Command introduced in nvOS Version 1.2.
Usage Displays information about a static NAT configuration.
Pluribus Networks nvOS Version 2.3.2
479
Examples To display all information about static NAT configurations, use the following command:
CLI network-admin@switch > nat-static-nat-show
See Also
• nat-create
• nat-delete
• nat-migrate
• nat-show
• nat-interface-add
• nat-interface-modify
• nat-interface-remove
• nat-interface-show
• nat-map-add
• nat-map-remove
• nat-map-show
• nat-port-forward-add
• nat-port-forward-remove
• nat-port-forward-show
• nat-static-nat-add
• nat-static-nat-remove
Pluribus Networks nvOS Version 2.3.2
480
netvisor-kvm-clone
This command is used to clone a Linux-based virtual disk image for a VNET on the switch.
Syntax netvisor-kvm-clone name name-string new-vm-name name-string
destination-switch fabric-node-name destination-vnet vnet-name
new-vm-lib disk-lib-name
name name-string
Specify the name of the VM that you want to clone to
another siwtch.
new-vm-name name-string Specify the new name of the VM.
destination-switch
fabric-node-name
Specify the name of the destination switch.
destination-vnet
vnet-name
Specify the destination VNET.
new-vm-lib
disk-lib-name
Specify the name of the new disk library.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Clone virtual machines (VMs) on the switch.
Examples To clone an existing VM,ubunt-12, to switch pleiades25 with destination VNET, clone-vm, and
disk library name, vm-ubuntu, use the following command:
CLI network-admin@switch > netvisor-kvm-clone name ubuntu-12
new-vm-name ubuntu-clone12 destination-switch pleiades25
destination-vnet clone-vm new-vm-lib vm-ubuntu
See Also
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
481
Pluribus Networks nvOS Version 2.3.2
482
netvisor-kvm-create
This command is used to create a Linux-based virtual disk image for a VNET on the switch.
Syntax netvisor-kvm-create name name-string vnet name-string [iso-label
iso-image-label | hda-label disk-image-label] [disable|enable]
[storage-pool storage-pool-name] [memory memory-number] [cpus
cpus-number] [hda-size hda-size-number] [hda-lib
disk-library-name] [boot-order
cdrom,hdisk|cdrom,net,hdisk|cdrom,hdisk,net|cdrom,net|cdrom|net,
cdrom,hdisk|net,hdisk,cdrom|net,hdisk|net,cdrom|net|hdisk,cdrom,
net|hdisk,netcdrom|hdisk,net|hdisk][ [hda-if scsi|ide|virtio]
[hdb-label disk-image-label][hdb-if scsi|ide|virtio] [hdc-label
disk-image-label][hdc-if scsi|ide|virtio [hdd-label
disk-image-label] [hdd-if scsi|ide|virtio]
name name-string
Specify a name for the netvm.
vnet name-string
Specify the name of the VNET for the netvm.
Specify either or both of the following options:
iso-label
iso-image-label
Specify the name of the ISO image to copy into the
Netvisor KVM.
hda-label
disk-image-label
Specify the label of the disk image.
Specify any of the following options:
disable|enable
Enable or disable the Netvisor KVM.
storage-pool
storage-pool-name
Specify the name of the storage pool for the Netvisor KVM.
memory memory-number
Specify the required memory for the Netvisor KVM.
cpus cpus-number
Specify the number of CPUs required to run the Netvisor
KVM.
hda-size
hda-size-number
Specify the hard drive size to support the Netvisor KVM.
hda-lib
disk-library-name
Specify the library name for the hard drive.
Specify the order in which to boot the Netvisor KVM.
boot-order
cdrom,hdisk|cdrom,net,
hdisk|cdrom,hdisk,net|c
drom,
net|cdrom|net,
cdrom,hdisk|net,
hdisk,cdrom|net,
hdisk|net,cdrom|
net|hdisk,cdrom,
net|hdisk,net,
cdrom|hdisk,net|
hdisk
hda-if scsi|ide| virtio Specify the type of hard drive.
hdb-label
disk-image-label
Specify a label for the second hard drive.
Pluribus Networks nvOS Version 2.3.2
483
hdb-if scsi|ide| virtio Specify the type of hard drive.
hdc-label
disk-image-label
Specify a label for the third hard drive.
hdc-if scsi|ide| virtio Specify the type of hard drive.
hdd-label
disk-image-label
Specify the label for the fourth hard drive.
hdd-if scsi|ide| virtio Specify the type of hard drive.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm. The option to specify
a hard drive type was added - hda-if
scsi|ide|virtio.
Usage Create virtual machines (VMs) on the switch.
Examples To create an in-memory NetVM for temporary use, using the temporary Unbuntu ISO image
and 2GB of memory, use the following command:
CLI network-admin@switch > netvisor-kvm-create name tempvm vnet
myfabric-global iso-label unbuntu-12 memory 2000
Netvm created. Please use netvisor-kvm-interface-add to add
interfaces, and then netvisor-kvm-start to boot.
See Also
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
484
netvisor-kvm-delete
This command is used to delete a KVM from the switch configuration.
Syntax netvisor-kvm-delete name name-string delete-hda|no-delete-hda
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Usage Use this command to remove a Netvisor KVM image from the configuration. You can optionally
delete the hard drive from the configuration to free space on the switch.
Examples To delete the KVM image, vm-centOS, and delete the hard drive, use the following command:
CLI network-admin@switch > netvisor-kvm-delete name vm-centOS
delete-hda
See Also
• netvisor-kvm-create
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
485
Pluribus Networks nvOS Version 2.3.2
486
netvisor-kvm-failover
This command is used to failover a KVM from one switch to another switch.
Syntax netvisor-kvm-failover name name-string active-sw
fabric-node-name force|no-force
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2
Usage Use this command to failover a Netvisor KVM image to another switch.
Examples To failover the KVM image, vm-centOS, to the switch, pleaides25, use the following
command:
CLI network-admin@switch > netvisor-kvm-delete name vm-centOS active-sw
pleaides25
See Also
• netvisor-kvm-create
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
487
Pluribus Networks nvOS Version 2.3.2
488
netvisor-kvm-kill
This command is used to stop a VM process on the switch.
Syntax netvisor-kvm-kill name name-string
name name-string
Specify the name of the netvm image to kill on the
switch.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Usage Stops a netvm process on the switch.
Examples To stop the netvm, centos-5, use the following command:
CLI network-admin@switch > netvisor-kvm-kill name centos-5
See Also
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
489
Pluribus Networks nvOS Version 2.3.2
490
netvisor-kvm-modify
This command is used to modify a virtual manager for a VNET on the switch.
Syntax netvisor-kvm-modify name name-string [disable|enable] [memory
memory-number] [cpus cpus-number] [hda-size hda-size-number]
[hda-lib disk-library-name] boot-order
cdrom,hdisk|cdrom,net,hdisk|cdrom,hdisk,net|cdrom,net|cdrom|net,
cdrom,hdisk|net,hdisk,cdrom|net,hdisk|net,cdrom|net|hdisk,cdrom,
net|hdisk,netcdrom|hdisk,net|hdisk[iso-label iso-image-label]
[hda-label disk-image-label] [hda-if scsi|virtio] [hdb-label
disk-image-label] [hdb-if scsi|virtio] [hdc-label
disk-image-label] [hdc-if scsi|virtio [hdd-label
disk-image-label] [hdd-if scsi|virtio]
Specify a name for the KVM.
name name-string
Specify any of the following options:
disable|enable
Enable or disable the KVM.
memory memory-number
Specify the required memory for the KVM.
cpus cpus-number
Specify the number of CPUs required to run the netvm.
hda-size
hda-size-number
Specify the hard drive size to support the KVM.
hda-lib
disk-library-name
Specify the library name for the hard drive.
boot-order
cdrom,hdisk|cdrom,net,
hdisk|cdrom,
hdisk,net|cdrom,
net|cdrom|net,
cdrom,hdisk|net,
hdisk,cdrom|net,
hdisk|net,cdrom|
net|hdisk,cdrom,
net|hdisk,net,
cdrom|hdisk,net|hdisk
Specify the order in which to boot the KVM.
iso-label
iso-image-label
Specify the label for the ISO image.
hda-label
disk-image-label
Specify a label for the first hard drive.
hda-if scsi|ide| virtio Specify the type of hard drive.
hdb-label
disk-image-label
Specify a label for the second hard drive.
hdb-if scsi|ide| virtio Specify the type of hard drive.
hdc-label
disk-image-label
Specify a label for the third hard drive.
hdc-if scsi|ide| virtio Specify the type of hard drive.
Pluribus Networks nvOS Version 2.3.2
491
hdd-label
disk-image-label
Specify the label for the fourth hard drive.
hdd-if scsi|ide| virtio Specify the type of hard drive.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm. The option to specify
a hard drive type was added - hda-if
scsi|ide|virtio. boot-at-console-connect
true|false added.
Usage Modify virtual machines (KVMs) on the switch.
Examples To modify the memory, use the following command:
CLI network-admin@switch > netvisor-kvm-modify name tempvm memory 3000
Netvm created. Please use netvisor-kvm-interface-add to add
interfaces, and then netvisor-kvm-start to boot.
See Also
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
492
netvisor-kvm-reset
This command is used to reset the KVM image.
Syntax netvisor-kvm-reset name name-string
name name-string
Specify the name of the netvm to reset.
Defaults None.
Access CLI
License ASDF - Not supported on the E68 platform.
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Usage Resets the netvm on the switch.
Examples To reset the KVM, tempvm, use the following command:
CLI network-admin@switch > netvisor-kvm-reset name tempvm
See Also
• netvisor-kvm-create
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-shutdown
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
493
Pluribus Networks nvOS Version 2.3.2
494
netvisor-kvm-show
This command is used to display information about a Netvisor KVMs on the switch.
Syntax netvisor-kvm-show id id-string name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|nat|
openstack|netvmm] [scope local|fabric] [vnet vnet-name] location
fabric-node name [memory memory-number] [cpus cpus-number]
[hda-size hda-size-number] [hda-lib disk-library-name] [vm-state
none|running|blocked|paused|shutdown|shutoff|crashed|error|null]
[boot-order
cdrom,hdisk|cdrom,net,hdisk|cdrom,hdisk,net|cdrom,net|cdrom|
net,cdrom,hdisk|net,hdisk,cdrom|net,hdisk|net,cdrom|net|hdisk,cd
rom,net|hdisk,netcdrom|hdisk,net|hdisk] uuid iso-label
iso-image-label [hda-label disk-image-label] [hda-if
scsi|virtio] [hdb-label disk-image-label] [hdb-if scsi|virtio]
[hdc-label disk-image-label] [hdc-if scsi|virtio [hdd-label
disk-image-label] [hdd-if scsi|virtio] [vnc-port
vnc-port-number] [boot-at-console-connect true|false]
id id-string
Displays the assigned netvm identifier.
name name-string
Displays a name for the netvm.
Displays the type of netvm.
type
vnet-mgr|vrouter|vlb|dh
cp|dns|netzone|ofpd|orp
haned|
netvm|nat|openstack|net
vmm|ovs
scope local|fabric
Displays the scope of the netvm.
vnet vnet-name
Displays the name of the VNET assigned to the netvm.
location fabric-node
name
Displays the location of the KVM.
memory memory-number
Displays the required memory for the netvm.
cpus cpus-number
Displays the number of CPUs required to run the netvm.
hda-size
hda-size-number
Displays the hard drive size to support the netvm.
hda-lib
disk-library-name
Displays the library name for the hard drive.
Displays the current status of the netvm image.
vm-state
none|running|blocked|
paused|shutdown|shutoff
|crashed|error|null
Pluribus Networks nvOS Version 2.3.2
495
boot-order
cdrom,hdisk|cdrom,net,
hdisk|cdrom,hdisk,net|
cdrom,net|cdrom|net,
cdrom,hdisk|net,
hdisk,cdrom|net,
hdisk|net,cdrom|
net|hdisk,cdrom,
net|hdisk,net,
cdrom|hdisk,net|hdisk
Displays the order in which to boot the netvm.
uuid
Displays the universal unique identifier (UUID).
iso-label
iso-image-label
Displays the label for the ISO image.
hda-label
disk-image-label
Displays a label for the first hard drive.
hda-if scsi|ide| virtio Displays the type of hard drive.
hdb-label
disk-image-label
Displays a label for the second hard drive.
hdb-if scsi|ide| virtio Displays the type of hard drive.
hdc-label
disk-image-label
Displays a label for the third hard drive.
hdc-if scsi|ide| virtio Displays the type of hard drive.
hdd-label
disk-image-label
Displays the label for the fourth hard drive.
hdd-if scsi|ide| virtio Displays the type of hard drive.
vnc-port
vnc-port-number
Displays the port used to connect to VNC.
boot-at-console-connect Displays if the KVM boots after connecting to the console.
true|false
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
Pluribus Networks nvOS Version 2.3.2
496
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm. The option to
specify a hard drive type was added - hda-if
scsi|ide|virtio.
Usage Displays information about Netvisor KVMs on the switch.
Pluribus Networks nvOS Version 2.3.2
497
Examples To display information about all Netvisor KVMs on the switch, use the following command:
CLI (network-admin@pleiades25) > netvisor-kvm-show format all layout
vertical
id:
6000021:4
name:
redhat-os-controller
type:
netvm
scope:
fabric
vnet:
redhat
vnet-service:
dedicated
state:
enabled
location:
pleiades25
storage-pool:
rpool
gateway:
::
template:
no
memory:
2G
cpus:
2
vm-state:
running
boot-order:
hdisk,net
iso-label:
hda-label:
redhat-os-controller
hda-if:
ide
hdb-label:
hdb-if:
ide
hdc-label:
hdc-if:
ide
hdd-label:
hdd-if:
ide
vnc-port:
2
delete-hda:
false
See Also
• netvisor-vmm-create
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
498
netvisor-kvm-shutdown
This command is used to shutdown the netvm image.
Syntax netvisor-kvm-shutdown name name-string
name name-string
Specify the name of the Netvisor KVM to shutdown.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Usage Shuts down the netvm on the switch.
Examples To shutdown the netvisor KVM, tempvm, use the following command:
CLI network-admin@switch > netvisor-kvm-shutdown name tempvm
See Also
• netvisor-kvm-create
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
499
Pluribus Networks nvOS Version 2.3.2
500
netvisor-kvm-start
This command is used to start the Netvisor KVM image.
Syntax netvisor-kvm-start name name-string
name name-string
Specify the name of the Netvisor KVM to start.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
History
Usage Starts the netvm on the switch.
Examples To start the netvm, tempvm, use the following command:
CLI network-admin@switch > netvisor-kvm-start name tempvm
See Also
• netvisor-vmm-create
• netvisor-kvm-delete
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
501
Pluribus Networks nvOS Version 2.3.2
502
netvisor-kvm-interface-add
This command adds an interface to a netvm on the switch.
Syntax netvisor-kvm-interface-add netvm-name name-string [vlan-id
vlan-id] [vxlan vxlan-id] [if mgmt|data|span][alias-on
alias-on-string] [vm-nic-type e1000|virtio]
exclusive|no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
netvm-name
name-string
Specify the name of the Netvisor KVM.
Specify any of the following options:
vlan-id vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify if the physical network port is a management, data or
both.
alias-on
alias-on-string
Specify an alias if desired.
vm-nic-type
e1000|virtio
Specify the type of VM NIC for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
Specify a secondary MAC address for the interface.
secondary-macs-strin
g
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Version 2.1
The parameters, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to add a network interface to a netvm.
Examples To add an interface, tempvm, on the management port, use the following command:
CLI network-admin@switch > netvisor-kvm-interface-add netvm-name tempvm
if mgmt nic-enable
See Also
• netvisor-vmm-create
• netvisor-kvm-delete
• netvisor-kvm-kill
Pluribus Networks nvOS Version 2.3.2
503
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
504
netvisor-kvm-interface-modify
This command modifies an interface on a KVM image on the switch.
Syntax netvisor-kvm-interface-modify netvm-name name-string [nic
nic-string][vlan-id vlan-id] [vxlan vxlan-id] [if
mgmt|data|span][alias-on alias-on-string] [vm-nic-type
e1000|virtio] exclusive|no-exclusive nic-enable|nic-disable
secondary-macs secondary-macs-string
netvm-name name-string
Specify the name of the Netvisor KVM.
Specify the following interface argument:
Specify the NIC of the KVM interface.
nic nic-string
Specify any of the following options:
vlan-id vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify if the physical network port is a management,
data or both .
alias-on
alias-on-string
Specify an alias if desired.
vm-nic-type
e1000|virtio
Specify the type of VM NIC for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Version 2.1
The parameters, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to modify a network interface to a netvm.
Examples To modify an interface, tempvm, from the management port to the data port, use the
following command:
CLI network-admin@switch > netvisor-kvm-interface-modify netvm-name
tempvm if data
See Also
• netvisor-vmm-create
• netvisor-kvm-delete
Pluribus Networks nvOS Version 2.3.2
505
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-add
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
506
netvisor-kvm-interface-remove
This command is used to remove an interface from a VNET.
Syntax netvisor-kvm-interface-remove netvm name-string nic nic-string
netvm name-string
Specify the name of the Netvisor KVM to remove the interface.
Specify the following interface argument:
nic nic-string
Specify the NIC for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Usage Used to remove interfaces from a VM on the switch.
Examples To remove the interface, tempvm, from the NIC, mgmt, use the following command:
CLI network-admin@switch > netvisor-kvm-interface-remove name tempvm
nic mgmt
See Also
• netvisor-vmm-create
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
507
Pluribus Networks nvOS Version 2.3.2
508
netvisor-kvm-interface-show
This command displays information about an interface on a netvm on the switch.
Syntax netvisor-kvm-interface-show name name-string [nic nic-string]
[ip ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6]
[mac mac-address][vlan-id vlan-id] [vxlan vxlan-id] [if
mgmt|data|span][alias-on alias-on-string] [vm-nic-type
e1000|virtio] exclusive|no-exclusive nic-enable|nic-disable
nic-state down|up secondary-macs secondary-macs-string
Specifies the name of the netvm.
name name-string
Specify the following interface arguments:
nic nic-string
Specifies the name of the NIC assigned to the interface.
ip ip-address
Specifies the IP address of the interface.
netmask netmask
Specifies the netmask of the interface.
assignment
none|dhcp|dhcpv6
Specifies the method that the interfaced used to obtain an
IP address.
mac mac-address
Specifies the MAC address of the interface.
vlan-id vlan-id
Specifies the VLAN identifier.
vxlan vxlan-id
Specifies the VXLAN identifier.
if mgmt|data|span
Specifies if the physical network port is a management,
data or both.
alias-on
alias-on-string
Specifies an alias if desired.
vm-nic-type
e1000|virtio
Specifies the type of VM NIC for the interface.
exclusive|no-exclusi
ve
Specifies if the interface is exclusive or not.
nic-enable|
nic-disable
Specifies if the NIC is enabled or disabled.
nic-state down|up
Specifies if the NIC is up or down.
secondary-macs
secondary-macs-strin
g
Specify a secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
Pluribus Networks nvOS Version 2.3.2
509
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Version 2.1
The parameters, exclusive, nic, and nic-state
added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to display a network interface information on a Netvisor KVM.
Examples To display information about an interface, use the following command:
CLI (network-admin@pleiades25) > netvisor-kvm-interface-show format
all layout vertical
switch:
pleiades25
netvisor-kvm-name: redhat-os-controller
nic:
eth2.14
ip:
::/0
assignment:
none
mac:
66:0e:94:21:3c:84
vlan:
14
vxlan:
0
if:
data
alias-on:
vm-nic-type:
e1000
exclusive:
no
nic-config:
disable
nic-state:
down
See Also
• netvisor-kvm-create
Pluribus Networks nvOS Version 2.3.2
510
• netvisor-kvm-delete
• netvisor-kvm-kill
• netvisor-kvm-modify
• netvisor-kvm-reset
• netvisor-kvm-show
• netvisor-kvm-start
• netvisor-kvm-shutdown
• netvisor-kvm-interface-add
• netvisor-kvm-interface-modify
• netvisor-kvm-interface-remove
• netvisor-kvm-interface-show
Pluribus Networks nvOS Version 2.3.2
511
Pluribus Networks nvOS Version 2.3.2
512
netvisor-vm-clone
This command is used to clone a Linux-based virtual disk image for a VNET on the switch.
Syntax netvisor-vm-clone name name-string new-vm-name name-string
destination-switch fabric-node-name destination-vnet vnet-name
new-vm-lib disk-lib-name
Specify the name of the VM that you want to clone to
another siwtch.
name name-string
new-vm-name name-string Specify the new name of the VM.
destination-switch
fabric-node-name
Specify the name of the destination switch.
destination-vnet
vnet-name
Specify the destination VNET.
new-vm-lib
disk-lib-name
Specify the name of the new disk library.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.3.0.
Usage Clone virtual machines (VMs) on the switch.
Examples To clone an existing VM,ubunt-12, to switch pleiades25 with destination VNET, clone-vm, and
disk library name, vm-ubuntu, use the following command:
CLI network-admin@switch > netvisor-vm-clone name ubuntu-12 new-vm-name
ubuntu-clone12 destination-switch pleiades25 destination-vnet clone-vm
new-vm-lib vm-ubuntu
See Also
 netvisor-vm-create
 netvisor-vm-delete
 netvisor-vm-kill
 netvisor-vm-modify
 netvisor-vm-show
 netvisor-vm-start
 netvisor-vm-interface-add
 netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
513
Pluribus Networks nvOS Version 2.3.2
514
netvisor-vm-console-login
This command is used to log into a VM console.
Syntax netvisor-vmm-console-login name name-string
Specify the name used to log into the console.
name name-string
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Usage Use this command to log into the VMM console.
Examples To login as john_doe, use the following command:
CLI network-admin@switch > netvisor-vm-console-login name john_doe
See Also
 netvisor-vm-create
 netvisor-vm-delete
 netvisor-vm-kill
 netvisor-vm-modify
 netvisor-vm-show
 netvisor-vm-start
 netvisor-vm-interface-add
 netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
515
Pluribus Networks nvOS Version 2.3.2
516
netvisor-vm-create
This command is used to create a virtual manager for a VNET on the switch.
Syntax netvisor-vm-create name name-string vnet name-string [iso-label
iso-image-label] [peer-node fabric-node name] [backup-interval
duration: #d#h#m#s] [hda-label disk-image-label] [memory
memory-number] [cpus cpus-number] [hda-size hda-size-number]
[hda-lib disk-library name] [vmm-boot-order
efi-cdrom,efi-hdisk|efi-cdrom|efi-hdisk,efi-cdrom|
efi-hdisk|cdrom,hdisk|cdrom|hdisk,cdrom|hdisk|efi-shell] [uuid]
[generate-uuid] [hda-if scsi|virtio] [hdb-label
disk-image-label] [hdb-if scsi|virtio] [hdc-label
disk-image-label] [hdc-if scsi|virtio [hdd-label
disk-image-label] [hdd-if scsi|virtio] boot-at-console-connect
true|false
name name-string
Specify a name for the VM.
vnet name-string
Specify the name of the VNET for the VM.
Specify one or both of the following options:
iso-label
iso-image-label
Specify the ISO label of the ISO image.
hda-label
disk-image-label
Specify a label for the first hard drive.
Specify one or both of the following options:
peer-node fabric-node
name
Specify the name of the peer switch for high availability.
backup-interval
duration: #d#h#m#s
Specify the frequency of replication in minutes.
Specify any of the following options:
memory memory-number
Specify the quantity of memory to assign to a VM.
cpus cpus-number
Specify the number of CPUs to assign to the VM.
hda-size
hda-size-number
Specify the size of the hard-drive if creating a blank disk.
hda-lib disk-library
name
Specify the disk library to store the blank disk.
Specify the boot order for the VM. You can specify EFI
vmm-boot-order
(extensible firmware interface) as an option for booting
efi-cdrom,efi-hdisk|
efi-cdrom|efi-hdisk,efi the image.
-cdrom| efi-hdisk|
cdrom,hdisk|cdrom|hdisk
,cdrom|hdisk|efi-shell
uuid
Specify a Universally Unique ID if you want to assign a
UUID.
generate-uuid
If you don’t specify a UUID, you can generate one when
the VM is created.
vmm-hda-if
virtio-blk|ahci-hd
Specify the type of hard drive.
Pluribus Networks nvOS Version 2.3.2
517
hdb-label
disk-image-label
Specify a label for the second hard drive.
vmm-hdb-if
virtio-blk|ahci-hd
Specify the type of hard drive.
hdc-label
disk-image-label
Specify a label for the third hard drive.
vmm-hdc-if
virtio-blk|ahci-hd
Specify the type of hard drive.
hdd-label
disk-image-label
Specify the label for the fourth hard drive.
vmm-hdd-if
virtio-blk|ahci-hd
Specify the type of hard drive.
boot-at-console-connect Specify if the VNET boots when you connect to the
true|false
console.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm. The option to specify a hard
drive type was added - hda-if scsi|ide|virtio.
boot-at-console-connect true|false added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm. The
parameters, iso-label, cpus, and vmm-boot-order, uuid,
and generate-uuid added.
Version 2.3.2
The parameters, peer-node, and backup-interval, added.
Usage Create virtual machines (VMs) on the switch.
Examples To create an in-memory NetVM for temporary use, use the following command:
CLI network-admin@switch > netvisor-vm-create name tempvm vnet
myfabric-global iso-label os-12 memory 2g
Netvm created. Please use netvisor-vm-interface-add to add interfaces,
and then netvisor-vm-start to boot.
See Also
• netvisor-vm-console-login
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-start
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
518
netvisor-vm-delete
This command is used to remove a netvm from the switch configuration.
Syntax netvisor-vm-delete name name-string delete-hda|no-delete-hda
name name-string
Specify the name of the netvm image to remove from the
switch.
delete-hda|
no-delete-hda
Specify if you want to delete HDA information.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Optional parameter delete-hda|no-delete-hda
added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Usage Deletes a VM from the switch.
Examples To remove the netvm, vmac-5, from the configuration, use the following command:
CLI network-admin@switch > netvisor-vm-delete name vmac-5
See Also
• netvisor-vm-console-login
• netvisor-vm-create
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-start
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
519
Pluribus Networks nvOS Version 2.3.2
520
netvisor-vm-failover
This command is used to failover a VM from one switch to another switch.
Syntax netvisor-vm-failover name name-string active-sw fabric-node-name
force|no-force
name name-string
Specify the name of the VM to failover to another switch.
active-sw
fabric-node-name
Specify the name of the active switch.
force|no-force
Specify if this is a forced failover or not.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.3.
Usage Use this command to failover a NetvisorVM image from the configuration.Use the
force|no-force option to force the failover to another switch.
Examples To failover the VM image, vm-centOS, to switch, pleaides25, use the following command:
CLI network-admin@switch > netvisor-vm-failover name vm-centOS
delete-hda
See Also
 netvisor-vm-create
 netvisor-vm-delete
 netvisor-vm-kill
 netvisor-vm-modify
 netvisor-vm-show
 netvisor-vm-start
 netvisor-vm-interface-add
 netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
521
Pluribus Networks nvOS Version 2.3.2
522
netvisor-vm-kill
This command is used to stop a Netvisor VM process on the switch.
Syntax netvisor-vm-kill name name-string
name name-string
Specify the name of the netvm image to kill on the switch.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Usage Stops a netvm process on the switch.
Examples To stop the netvm, centos-5, use the following command:
CLI network-admin@switch > netvisor-vm-kill name centos-5
See Also
• netvisor-vm-console-login
• netvisor-vm-create
• netvisor-vm-delete
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-start
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
523
Pluribus Networks nvOS Version 2.3.2
524
netvisor-vm-modify
This command is used to modify a virtual manager for a VNET on the switch.
Syntax netvisor-vm-modify name name-string [disable|enable]
[backup-interval duration: #d#h#m#s] [memory memory-number]
[cpus cpus-number] [hda-size hda-size-number] [hda-lib
disk-library name] [vmm-boot-order
efi-cdrom,efi-hdisk|efi-cdrom|efi-hdisk,efi-cdrom|
efi-hdisk|cdrom,hdisk|cdrom|hdisk,cdrom|hdisk|efi-shell]
[uuid][iso-label iso-image-label] [hda-label disk-image-label]
[hda-if scsi|virtio] [hdb-label disk-image-label] [hdb-if
scsi|virtio] [hdc-label disk-image-label] [hdc-if scsi|virtio
[hdd-label disk-image-label] [hdd-if scsi|virtio]
Specify a name for the netvm.
name name-string
Specify any of the following options:
disable|enable
Enable or disable the netvm.
backup-interval
duration: #d#h#m#s
Specify the frequency of replication in minutes.
memory memory-number
Specify the required memory for the netvm.
cpus cpus-number
Specify the number of CPUs to assign to the VMM.
hda-size
hda-size-number
Specify the size of the hard-drive if creating a blank
disk.
hda-lib disk-library
name
Specify the disk library to store the blank disk.
Specify the boot order for the VMM. You can specify
vmm-boot-order
EFI (extensible firmware interface) as an option for
efi-cdrom,efi-hdisk|
efi-cdrom|efi-hdisk,efi booting the image.
-cdrom| efi-hdisk|
cdrom,hdisk|cdrom|hdisk
,cdrom|hdisk|efi-shell
uuid
Specify a Universally Unique ID if you want to assign a
UUID.
iso-label
iso-image-label
Specify the label for the ISO image.
hda-label
disk-image-label
Specify a label for the first hard drive.
hda-if scsi|ide| virtio Specify the type of hard drive.
vmm-hda-if scsi|ide|
virtio
Specify the type of hard drive.
hdb-label
disk-image-label
Specify a label for the second hard drive.
hdb-if scsi|ide| virtio Specify the type of hard drive.
vmm-hdb-if scsi|ide|
virtio
Specify the type of hard drive.
hdc-label
disk-image-label
Specify a label for the third hard drive.
Pluribus Networks nvOS Version 2.3.2
525
hdc-if scsi|ide| virtio Specify the type of hard drive.
vmm-hdc-if scsi|ide|
virtio
Specify the type of hard drive.
hdd-label
disk-image-label
Specify the label for the fourth hard drive.
hdd-if scsi|ide| virtio Specify the type of hard drive.
vmm-hdd-if scsi|ide|
virtio
Specify the type of hard drive.
boot-at-console-connect Specify if the VNET boots when you connect to the
true|false
console.
Defaults None
Access CLI
License ASDF - Not supported on the E68 platform.
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm. The option to specify a hard
drive type was added - hda-if scsi|ide|virtio.
boot-at-console-connect true|false added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm. The
parameters, iso-label, cpus, and vmm-boot-order, and
uuid added.
Version 2.3.2
The parameter, backup-interval, added.
Usage Modify virtual machines (VMs) on the switch.
Examples To modify an in-memory NetVM for temporary use, use the following command:
CLI network-admin@switch > netvisor-vm-modify name tempvm memory 3000
boot-at-console true
See Also
• netvisor-vm-console-login
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-start
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
•
Pluribus Networks nvOS Version 2.3.2
526
netvisor-vm-show
This command is used to display information about a VM on the switch.
Syntax netvisor-vm-show id id-string name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|nat|
openstack|netvmm] [scope local|fabric] [vnet vnet-name]
[location fabric-node name] [peer-node fabric-node
name][active-sw fabric-node name] [backup-interval duration:
#d#h#m#s] [last-backup date/time: yyyy-mm-ddTHH:mm:ss] [memory
memory-number] [cpus cpus-numbe[r] [hda-size hda-size-number]
[hda-lib disk-library-name] [vm-state
none|running|blocked|paused|shutdown|shutoff|crashed|error|null]
[boot-order
cdrom,hdisk|cdrom,net,hdisk|cdrom,hdisk,net|cdrom,net|cdrom|
net,cdrom,hdisk|net,hdisk,cdrom|net,hdisk|net,cdrom|net|hdisk,cd
rom,net|hdisk,netcdrom|hdisk,net|hdisk] [hda-label
disk-image-label] [hda-if scsi|virtio] [hdb-label
disk-image-label] [hdb-if scsi|virtio] [hdc-label
disk-image-label] [hdc-if scsi|virtio [hdd-label
disk-image-label] [hdd-if scsi|virtio] [vnc-port
vnc-port-number] boot-at-console-connect true|false
id id-string
Displays the assigned identifier.
name name-string
Displays a name for the netvm.
Displays the type of netvm.
type
vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|
ofpd|orphaned|netvm|nat
|openstack|netvmm|ovs
scope local|fabric
Displays the scope of the netvm.
vnet vnet-name
Displays the name of the VNET assigned to the Netvisor
VM.
location fabric-node
name
Displays the location of the VMM.
peer-node fabric-node
name
Displays the peer node for VM high availability.
active-sw fabric-node
name
Displays the active switch.
backup-interval
duration: #d#h#m#s
Displays the configured backup interval for HA.
last-backup date/time:
yyyy-mm-ddTHH:mm:ss
Displays the last time the configuration was backed up.
memory memory-number
Displays the required memory for the netvm.
cpus cpus-number
Displays the number of CPUs required to run the netvm.
hda-size
hda-size-number
Displays the hard drive size to support the netvm.
hda-lib
disk-library-name
Displays the library name for the hard drive.
Pluribus Networks nvOS Version 2.3.2
527
Displays the current status of the netvm image.
vm-state
none|running|blocked|
paused|shutdown|shutoff
|crashed|error|null
Specifies the boot order for the VMM. You can specify EFI
vmm-boot-order
(extensible firmware interface) as an option for booting
efi-cdrom,efi-hdisk|
efi-cdrom|efi-hdisk,efi the image.
-cdrom|
efi-hdisk|cdrom,hdisk|
cdrom|hdisk,cdrom|hdisk
|efi-shell
uuid
Specifies a Universally Unique ID if you want to assign a
UUID.
iso-label
iso-image-label
Specifies the label for the ISO image.
hda-label
disk-image-label
Specifies a label for the first hard drive.
hda-if scsi|ide| virtio Specifies the type of hard drive.
vmm-hda-if scsi|ide|
virtio
Specifies the type of hard drive.
hdb-label
disk-image-label
Specifies a label for the second hard drive.
vhdb-if scsi|ide|
virtio
Specifies the type of hard drive.
vmm-hdb-if scsi|ide|
virtio
Specifies the type of hard drive.
hdc-label
disk-image-label
Specifies a label for the third hard drive.
hdc-if scsi|ide| virtio Specifies the type of hard drive.
vmm-hdc-if scsi|ide|
virtio
Specifies the type of hard drive.
hdd-label
disk-image-label
Specifies the label for the fourth hard drive.
hdd-if scsi|ide| virtio Specifies the type of hard drive.
vnc-port
vnc-port-number
Specifies the VNC port.
boot-at-console-connect Specifies if the VNET boots when you connect to the
true|false
console.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
Pluribus Networks nvOS Version 2.3.2
528
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm. The option to specify a
hard drive type was added - hda-if scsi|ide|virtio.
boot-at-console-connect true|false was
added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
The parameters, iso-label, cpus, vmm-boot-order, and
uuid added.
Usage Displays information about VMs on the switch.
Examples To display information about all netvms on the switch, use the following command:
CLI network-admin@switch > netvisor-vm-show
See Also
• netvisor-vm-create
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-start
• netvisor-vm-interface-add
Pluribus Networks nvOS Version 2.3.2
529
• netvisor-vm-interface-modify
Pluribus Networks nvOS Version 2.3.2
530
netvisor-vm-start
This command is used to start the netvm image.
Syntax netvisor-vm-start name name-string
name name-string
Specify the name of the netvm to reset.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Usage Starts the netvm on the switch.
Examples To start the netvm, tempvm, use the following command:
CLI network-admin@switch > netvisor-vm-start name tempvm
See Also
• netvisor-vm-create
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
• netvisor-vm-interface-remove
• netvisor-vm-interface-show
Pluribus Networks nvOS Version 2.3.2
531
Pluribus Networks nvOS Version 2.3.2
532
netvisor-vm-interface-add
This command adds an interface to a Netvisor VM on the switch.
Syntax
netvisor-vm-interface-add netvisor-vm-name name-string [vlan-id
vlan-id] [vxlan vxlan-id] [if mgmt|data|span][alias-on
alias-on-string] [vm-nic-type e1000|virtio] exclusive|
no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
Specify the name of the netvm.
netvisor-name
name-string
Specify any of the following options:
vlan-id vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify if the physical network port is a management,
data or both.
alias-on
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Version 2.1
The parameters, exclusive, no-exclusive, nic-enable, and
nic-disable added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to add a network interface to a netvm.
Examples To add an interface, tempvm, on the management port, use the following command:
CLI network-admin@switch > netvisor-vm-interface-add netvm-name tempvm
if mgmt nic-enable
See Also
• netvisor-vm-create
• netvisor-vm-delete
Pluribus Networks nvOS Version 2.3.2
533
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-interface-modify
• netvisor-vm-interface-remove
• netvisor-vm-interface-show
Pluribus Networks nvOS Version 2.3.2
534
netvisor-vm-interface-modify
This command modifies an interface on a Netvisor VM on the switch.
Syntax netvisor-vm-interface-modify netvisor-vm-name name-string [nic
nic-string][vlan-id vlan-id] [vxlan vxlan-id] [if
mgmt|data|span][alias-on alias-on-string] [vm-nic-type
e1000|virtio] exclusive|no-exclusive nic-enable|nic-disable
secondary-macs secondary-macs-string
Specify the name of the VM.
netvisor-vm-name
name-string
Specify the following interface arguments:
Specify a NIC to modify.
nic nic-string
Specify any of the following options:
vlan-id vlan-id
Specify the VLAN identifier.
vxlan vxlan-id
Specify the VXLAN identifier.
if mgmt|data|span
Specify if the physical network port is a management,
data or both .
alias-on
alias-on-string
Specify an alias if desired.
vm-nic-type
e1000|virtio
Specify the type of VM NIC for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-vmm.
Version 2.1
The parameters, exclusive, no-exclusive,
nic-enable, and nic-disable added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to modify a network interface to a Netvisor VM.
Examples To modify an interface, tempvm, from the management port to the data port, use the
following command:
CLI network-admin@switch > netvisor-vm-interface-modify
netvisor-vmm-name tempvm if data
Pluribus Networks nvOS Version 2.3.2
535
See Also
• netvisor-vm-create
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-interface-add
• netvisor-vm-interface-remove
• netvisor-vm-interface-show
Pluribus Networks nvOS Version 2.3.2
536
netvisor-vm-interface-remove
This command is used to remove an interface from a vnet.
Syntax netvisor-vm-interface-remove netvisor-vm-name name-string
netvisor-vm-name nic nic-string
netvisor-vm-name
name-string
Specify the name of the netvm to remove the interface.
Specify the following interface arguments:
nic nic-string
Specify the NIC for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Version 2.1
The parameter, switch, added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Version 2.2.5
The parameter, switch, deprecated.
Usage Used to remove interfaces from a VM on the switch.
Examples To remove the interface, tempvm, from the NIC, mgmt, use the following command:
CLI network-admin@switch > netvisor-vm-interface-remove tempvm nic mgmt
See Also
• netvisor-vm-create
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
• netvisor-vm-interface-show
Pluribus Networks nvOS Version 2.3.2
537
Pluribus Networks nvOS Version 2.3.2
538
netvisor-vm-interface-show
This command displays information about an interface on a VM on the switch.
netvisor-vm-interface-show netvisor-vm-name name-string nic nic-string
[ip ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6]
[vlan-id vlan-id] [vxlan vxlan-id] [if mgmt|data|span][alias-on
alias-on-string] [vm-nic-type e1000|virtio][exclusive|no-exclusive]
[nic-enable|nic-disable secondary-macs secondary-macs-string]
Specifies the name of the VM.
netvisor-vm-name
name-string
Specify the following interface arguments:
nic nic-string
Specifies the NIC for the interface.
ip ip-address
Specifies the IP address of the interface.
netmask netmask
Specifies the netmask of the interface.
assignment
none|dhcp|dhcpv6
Specifies the method that the interfaced used to
obtain an IP address.
vlan-id vlan-id
Specifies the VLAN identifier.
vxlan vxlan-id
Specifies the VXLAN identifier.
if mgmt|data|span
Specifies if the physical network port is a
management, data or both.
alias-on
alias-on-string
Specifies an alias if desired.
vm-nic-type
e1000|virtio
Specifies the type of VM NIC for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
Pluribus Networks nvOS Version 2.3.2
539
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
netvm changed to netvisor-kvm.
Version 2.1
The parameters, exclusive, no-exclusive,
nic-enable, nic-disable and nic-state added.
Version 2.2
Command changed from netvisor-vmm to netvisor-vm.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to display a network interface information on a netvm.
Examples To display information about VM interfaces, use the following command:
CLI network-admin@switch > netvisor-vm-interface-show
See Also
• netvisor-vm-console-login
• netvisor-vm-delete
• netvisor-vm-kill
• netvisor-vm-modify
• netvisor-vm-show
• netvisor-vm-start
• netvisor-vm-interface-add
• netvisor-vm-interface-modify
• netvisor-vm-interface-remove
Pluribus Networks nvOS Version 2.3.2
540
netvisor-zone-console-login
After creating a Netvisor zone, you can log into the zone with a username and password.
Syntax netvisor-zone-console-login name name-string
name name-string
Specify the username created as part of the Netvisor
zone configuration.
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to log into a Netvisor zone and begin using the Unix shell interface. To logout,
type exit at the shell prompt.
Examples To log into the netvisor zone, devzone, with the username dev1 and password m0nk3ys, use
the following syntax:
CLI network-admin@switch > netvisor-zone-console-login name dev1
password:*******
Last login: Fri Mar 28 10:29:45 on console
PluribusNetworks Inc.
Netvisor(R) 5.11
pn-nvOS-2.0.0-2000012159
January 2014
-bash-4.0$
Pluribus Networks nvOS Version 2.3.2
541
Pluribus Networks nvOS Version 2.3.2
542
netvisor-zone-create
This command is used to create a NetZone on the switch. NetZones allow the execution of x86 Solaris
code on the switch.
Syntax netvisor-zone-create name name-string vnet vnet-name user
user-string [enable|disable] [storage-pool storage-pool-name]
[floodlight-enable|floodlight-disable]
name name-string
Specify the name of the Netvisor-Zone.
vnet vnet-name
Specifies the VNET for the NetZone.
user user-string
Specifies the user with access to the NetZone.
Specify any of the following options:
enable|disable
Enables or disables the NetZone.
storage-pool
storage-pool-name
Specifies the storage pool for the NetZone.
floodlight-enable|
floodlight-disable
Enables or disabled the built-in Floodlight Openflow
feature. By default, Floodlight OpenFlow listens for
OpenFlow protocol messages on port 6633.
Defaults None.
Access CLI
History .
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-create.
Usage Create a NetZone when you want to run custom programs or pre-compiled applications on x86
Solaris platforms.
Examples To create the Netvisor-Zone, solaris01, use the following command:
CLI network-admin@switch > netvisor-zone-create name solaris01 vnet
v_net9 user admin enable
See Also
• netvisor-zone-delete
• netvisor-zone-modify
• netvisor-zone-show
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
543
Pluribus Networks nvOS Version 2.3.2
544
netvisor-zone-delete
This command deletes a NetZone from a switch.
Syntax netvisor-zone-delete name name-string
name name-string
Specify the name of the NetZone that you want to
delete.
Defaults None.
Access CLI
History .
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-create.
Usage Remove a NetZone from the configuration.
Examples To remove Netvisor-Zone, spider-app, from the configuration, use the following command:
CLI network-admin@switch > netvisor-zone-delete name spider-app
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-show
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
545
Pluribus Networks nvOS Version 2.3.2
546
netvisor-zone-login
This command is used to log into a Netvisor zone.
Syntax netvisor-zone-login name name-string
name name-string
Specify the name of the zone.
Defaults None
Access CLI
History Command introduced in Version 2.0.
Usage Use this command to log into a Netvisor zone after you created it.
Examples To log into the Netvisor zone, dev-zone, use the following syntax:
CLI network-admin@switch > netvisor-zone-login name dev-zone
See Also
• netvisor-zone-console-login
• netvisor-zone-create
• netvisor-zone-delete
• netvisor-zone-modify
• netvisor-zone-show
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
547
Pluribus Networks nvOS Version 2.3.2
548
netvisor-zone-modify
This command is used to modify a Netvisor-Zone configuration.
Syntax netvisor-zone-modify name name-string [disable|enable] [gateway
ip-address] [user user-string][password password-string]
[floodlight-enable|floodlight-disable]
name name-string
Specify the name of the Netvisor-Zone to modify.
Specify any of the following options:
disable|enable
Specify if you want to enable the Netvisor-Zone if
disabled, or disable the Netvisor-Zone if enabled.
gateway ip-address
Modify the gateway IP address.
user user-string
Modify the user name.
password
password-string
Specify a password for the user.
floodlight-enable|
floodlight-disable
Specify if you want to enable Floodlight if disabled, or
disable Floodlight if enabled
Defaults None.
Access CLI
History .
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-create.
Usage You can modify an existing Netvisor-Zone using this command.
Examples To disable Netvisor-Zone, eng-hw, use the following command:
CLI network-admin@switch > netvisor-zone-modify name eng-hw
See Also
• netvisor-zone-create
• netvisor-zone-delete
• netvisor-zone-show
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
549
Pluribus Networks nvOS Version 2.3.2
550
netvisor-zone-show
This command is used to display information about Netvisor-Zones.
Syntax netvisor-zone-show id id-string name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|nat|
openstack|netvmm|ovs]] [scope local|fabric] [vnet vnet-name]
[is-global true|false][location fabric-node name] [user
user-string]
id id-string
Displays the identifier of the Netvisor-Zone.
name name-string
Displays the name of the Netvisor-Zone.
Displays the type of Netvisor-Zone.
type
vnet-mgr|vrouter|vlb|dh
cp|dns|netzone|ofpd|orp
haned|netvm|nat|
openstack|netvmm|ovs]
scope local|fabric
Displays the scope of the Netvisor-Zone.
vnet vnet-name
Displays the VNET.
is-global true|false
Displays if the zone is local or global.
location fabric-node
name
Displays the location of the Netvisor-Zone.
user user-string
Displays the user associated with the Netvisor-Zone.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
551
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History .
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-create.
Version 2.1
The parameter, location, added.
Usage Use this command to display detailed information about Netvisor-Zone.
Examples
CLI network-admin@switch > netvisor-zone-show
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-delete
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
552
netvisor-zone-interface-add
This command is used to add an interface to a NetZone.
netvisor-zone-interface-add netvisor-zone-name name-string [ip
ip-address] [netmask netmask] [assignment none|dhcp|dhcpv6] [vlan
vlan-id] [vxlan vxlan-id] [if mgmt|data|span] [alias-on
alias-on-string] exclusive|no-exclusive nic-enable|nic-disable
secondary-macs secondary-macs-string
Specify the following interface arguments:
Specify the name of the netvisor-zone interface.
netvisor-zone-name
name-string
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask of the IP address.
assignment
Specify if the IP address obtained from DHCP.
none|dhcp|dhcpv6|autov6
vlan vlan-id
Specify the VLAN for the interface.
vxlan vxlan-id
Specify the VXLAN for the interface.
if mgmt|data|span
Specify if the physical network port is a management,
data or both.
alias-on
alias-on-string
Specify an alias for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-interface-add.
Version 2.1
The parameters, exclusive, no-exclusive,
nic-enable, and nic-disable added.
Version 2.2.4
The parameter, secondary-macs, added.
Version 2.3.1
The option, autov6, added.
Usage Use this command to add interfaces to a NetZone.
Pluribus Networks nvOS Version 2.3.2
553
Examples To add the interface, mynetzone, with the IP address of 172.16.178.10/16, use the
following command:
CLI network-admin@switch > netvisor-zone-interface-add
netvisor-zone-name mynetzone if data ip 172.16.178.10/16.
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-delete
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
554
netvisor-zone-interface-modify
This command is used to modify an interface on a NetZone.
Syntax netvisor-zone-interface-modify netzone-name name-string [nic
nic-string][ip ip-address] [netmask netmask] [assignment
none|dhcp|dhcpv6] [vlan vlan-id] [vxlan vxlan-id] [if
mgmt|data|span] [alias-on alias-on-string] secondary-macs
secondary-macs-string
Specify the name of the NetZone interface.
netvisor-name
name-string
Specify the following interface argument:
Specify the NIC of the interface.
nic nic-string
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask of the IP address.
assignment
Specify if the IP address obtained from DHCP.
none|dhcp|dhcpv6|autov6
vlan vlan-id
Specify the VLAN for the interface.
vxlan vxlan-id
Specify the VXLAN for the interface from 0 to
16777215.
if mgmt|data|span
Specify if the physical network port is a
management, data or both.
alias-on
alias-on-string
Specify an alias for the interface.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-interface-add.
Version 2.1
The parameters, exclusive, no-exclusive, nic-enable,
and nic-disable added.
Version 2.2.4
The parameter, secondary-macs, added.
Version 2.3.1
The option, autov6, added.
Usage Use this command to add interfaces to a NetZone.
Pluribus Networks nvOS Version 2.3.2
555
Examples To modify the interface, mynetzone, with the IP address of 172.16.178.12/16, use the
following command:
CLI network-admin@switch > netvisor-zone-interface-modify netzone-name
mynetzone if data ip 172.16.178.12/16.
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-delete
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
556
netvisor-zone-interface-remove
This command is used to remove a NetZone interface.
Syntax netvisor-zone-interface-remove netzone-name name-string [nic
nic-string]
netvisor-zone-name
name-string
Specify the NetZone interface to remove from the
configuration.
Specify the following interface arguments:
nic nic-string
Specify the NIC to remove from the configuration.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-interface-remove.
Usage Use this command to remove a NetZone interface.
Examples To remove NetZone interface, localzone, use the following command:
CLI network-admin@switch > netvisor-zone-interface-remove netzone-name
localzone nic eth01
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-delete
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-show
Pluribus Networks nvOS Version 2.3.2
557
Pluribus Networks nvOS Version 2.3.2
558
netvisor-zone-interface-show
This command is used to display information about Netvisor Zone interfaces.
Syntax netvisor-zone-interface-show netvisor-zone-name name-string [nic
nic-string] [ip ip-address] [netmask netmask] [assignment
none|dhcp|dhcpv6] [mac mac-address] [vlan vlan-id] [vxlan
vxlan-id] [if mgmt|data|span] [alias-on alias-on-string]
[vm-nic-type e1000|virtio]exclusive|no-exclusive nic-enable|
nic-disable nic-state down|up secondary-macs
secondary-macs-string
Specifies the name of the Netvisor-Zone interface.
netvisor-zone-name
name-string
Specify the following interface arguments:
nic nic-string
Specifies the NIC information.
ip ip-address
Specifies the IP address for the interface.
netmask netmask
Specifies the netmask of the IP address.
assignment
Specifies if the IP address obtained from DHCP.
none|dhcp|dhcpv6}autov6
mac mac-address
Specifies the MAC address of the interface.
vlan vlan-id
Specifies the VLAN for the interface.
vxlan vxlan-id
Specifies the VXLAN for the interface.
if mgmt|data|span
Specifies if the physical network port is a
management, data or both.
alias-on
alias-on-string
Specifies an alias for the interface.
vm-nic-type
e1000|virtio
Specifies the type of virtual NIC used by the interface.
exclusive|
no-exclusive
Specifies if the interface is exclusive or not.
nic-enable|
nic-disable
Specifies if the NIC is enabled or disabled.
nic-state down|up
Specifies if the NIC is up or down.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
Pluribus Networks nvOS Version 2.3.2
559
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
License ASDF - Not supported on the E68 platform.
History
Version 1.2
Command introduced.
Version 2.0
Changed command to netvisor-zone-interface-add.
Version 2.1
The parameters, exclusive, no-exclusive,
nic-enable, nic-disable, and nic-state added.
Version 2.2.4
The parameter, secondary-macs, added.
Version 2.3.1.1
The option, autov6, added.
Usage Use this command to display information about interfaces on a NetZone.
Examples To display information about Netvisor-Zone interfaces, use the following command:
CLI network-admin@switch > netvisor-zone-interface-show
See Also
• netvisor-zone-create
• netvisor-zone-modify
• netvisor-zone-delete
• netvisor-zone-interface-add
• netvisor-zone-interface-modify
• netvisor-zone-interface-remove
Pluribus Networks nvOS Version 2.3.2
560
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 nvOS 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
name:
fab-name:
mgmt-nic:
mgmt-ip:
mgmt-assignment:
mgmt-mac:
mgmt-vlan:
mgmt-vxlan:
mgmt-if:
mgmt-vm-nic-type:
mgmt-exclusive:
mgmt-nic-config:
mgmt-nic-state:
mgmt-vrrp-id:
mgmt-vrrp-primary:
mgmt-vrrp-priority:
mgmt-vrrp-state:
mgmt-l3-port:
fab-tid:
cluster-tid:
out-port:
version:
state:
firmware-upgrade:
device-state:
pubdev01
info-dev
igb0
10.9.100.100/16
static
64:0e:94:28:00:8f
0
0
data
none
no
disable
down
0
0
slave
0
8
1
0
2.2.202046923,pn-ONVL-2.2.4-2020412306
online
not-required
ok
See Also
• node-show
Pluribus Networks nvOS Version 2.3.2
561
Pluribus Networks nvOS Version 2.3.2
562
node-show
This command displays information about all nodes in the fabric. This command can only be invoked at
the network-admin access level.
Syntax node-show [id id-string] [serial serial-string] [name
fabric-node-name] [fab-name fab-name-string] [fab-id] [local-mac
mac-address] [mgmt-nic nic-string] [mgmt-ip ip-address]
[mgmt-netmask netmask] [mgmt-assignment none|dhcp|dhcpv6]
[mgmt-mac mac-address] [mgmt-vlan vlan-id][mgmt-vxlan vxlan-id]
[mgmt-if mgmt|data|span] [mgmt-alias-on alias-on-string]
[mgmt-vm-nic-type e1000|virtio]
[mgmt-exclusive|no-mgmt-exclusive]
[mgmt-nic-enable|mgmt-nic-disable] [mgmt-nic-state down|up]
[mgmt-vrrp-id id] [mgmt-vrrp-primary vrrp-primary-string]
[mgmt-vrrp-priority vrrp-priority-number] [mgmt-vrrp-state
slave|master] [in-band-nic nic-string] [in-band-ip ip-address]
[in-band-netmask netmask] [in-band-assignment none|dhcp|dhcpv6]
[in-band-mac mac-address] [in-band-vlan vlan-id] [in-band-vxlan
vxlan-id][in-band-if mgmt|data|span] [in-band-alias-on
alias-on-string] [in-band-vm-nic-type e1000|virtio] [fab-tid
fab-tid-number] [cluster-tid cluster-tid-number] [out-port
out-port-number] [version version-string] [state
offline|online|fabric_joined|setup-required|fabric-required|
fresh-install] [firmware_upgrade] [device_state] [ports
ports-number]
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
Specifies the interface for sending fabric packets.
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.
mgmt-secondary-macs
secondary-mac-string
Specifies the secondary MAC address for the management interface.
in-band-nic nic-string
Specifies the NIC for the in-band interface to the switch control plane.
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-vlan vlan-id
Specifies the VLAN identifier for the in-band interface to the switch
control plane can be reached on Layer 2.
Pluribus Networks nvOS Version 2.3.2
563
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 nvOS version.
Specifies the state of the fabric.
state offline|online|
fabric_joined|setup-req
uired|fabric-required|
fresh-install]
firmware_upgrade
not-required|required|
reboot-required
Specifies if a firmware upgrade is required.
device_state
Specifies the state of the switch.
ports ports-number
Specifies the port list used by the fabric.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Pluribus Networks nvOS Version 2.3.2
564
Defaults None.
Access network-admin
History .
Version 1.2
Command introduced.
Version 2.3
The parameter, fab-mcast, deprecated.
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:
name:
fab-name:
fab-id:
cluster-id:
fab-mcast-ip:
local-mac:
fabric-network:
mgmt-ip:
mgmt-mac:
mgmt-l3-port:
mgmt-secondary-macs:
in-band-ip:
in-band-mac:
in-band-l3-port:
in-band-secondary-macs:
fab-tid:
cluster-tid:
out-port:
version:
state:
firmware-upgrade:
device-state:
ports:
167772208
pubdev01
info-dev
a000030:5537b46c
a000030:1
::
64:0e:94:28:00:8e
in-band
10.9.100.100/16
64:0e:94:28:00:8f
0
192.168.42.10/24
64:0e:94:28:00:8e
0
8
1
0
2.2.202046923,pn-ONVL-2.2.4-2020412306
online
not-required
ok
0
See Also
• node-info
Pluribus Networks nvOS Version 2.3.2
565
Pluribus Networks nvOS Version 2.3.2
566
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 nvOS based on this information.
Syntax nv-queue-stats-settings-modify enable|disable interval duration:
#d#h#m#s disk-space disk-space-number disk-space allocated for
statistics
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 nvOS 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
See Also
Pluribus Networks nvOS Version 2.3.2
567
Pluribus Networks nvOS Version 2.3.2
568
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
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-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:
enable:
interval:
disk-space:
pubdev01
yes
1m
50M
See Also
Pluribus Networks nvOS Version 2.3.2
569
• nv-queue-stats-settings-modify
Pluribus Networks nvOS Version 2.3.2
570
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]
[start-time date/time: yyyy-mm-ddThh:mm:ss] [end-time date/time:
yyyy-mm-ddThh:mm:ss] [duration duration: #d#h#m#s] [interval
duration: #d#h#m#s] [since-start] [older-than duration:
#d#h#m#s] [within-last duration: #d#h#m#s]
[name nv-queue-stats-list name] [q-high q-high-number]
[q-low q-low-number] [q-max q-max-number] [q-in q-in-number]
[q-out q-out-number] [q-delay-high high resolution-time: #ns]
[q-delay-samples q-delay-samples-number] [q-delay-avg high
resolution time: #ns] [q-overflow q-overflow-number]
[q-underflow q-underflow-number]
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.
Pluribus Networks nvOS Version 2.3.2
571
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.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History Command introduced in Version 2.2.5.
Version 2.2.5
Command introduced.
Version 2.3.2
The parameters, q-delay-avg, q-overflow, and
q-underflow added.
Usage Use this command to modify the statistics collection settings for ONVL packet queues.
Pluribus Networks nvOS Version 2.3.2
572
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:
time:
name:
q-high:
q-low:
q-max:
q-in:
q-out:
switch:
time:
name:
q-high:
q-low:
q-max:
q-in:
q-out:
q-delay-high:
switch:
time:
name:
q-high:
q-low:
q-max:
q-in:
q-out:
pubdev01
12-07,10:08:00
eventq-guaranteed-0
1
0
0
1
1
pubdev01
12-07,10:08:00
eventq-guaranteed-1
1
0
0
23
23
63.1us
pubdev01
12-07,10:08:00
eventq-guaranteed-cache
512
503
8192
63
63
See Also
• nv-queue-stats-settings-modify
• nv-queue-stats-settings-show
Pluribus Networks nvOS Version 2.3.2
573
Pluribus Networks nvOS Version 2.3.2
574
O Commands
openflow-create
This command is used to create an Openflow instance on a VNET for the switch.
Syntax openflow-create name name-string vnet vnet-name
[dedicated-vnet-service|shared-vnet-service] [storage-pool
storage-pool-name] [gateway ip-address] [version 1.0|1.3][vlans
vlan-list]
name name-string
Specify the name of the openflow controller.
vnet vnet-name
Specify the VNET to apply the controller.
Specify any of the following options:
dedicated-vnet-service| Specify if the service is shared or dedicated.
shared-vnet-service
storage-pool
storage-pool-name
Specify the name of the storage pool.
gateway ip-address
Specify the IP address.
version 1.0|1.3
Specify the version of OpenFlow. The default version is 1.0.
vlans vlan-list
Specify the list of VLANs.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.2.2
The parameter, version, added.
Usage Openflow allows you to deploy innovative routing and switching protocols on a fabric, cluster,
VNET, or standalone switch. Use this command to create an Openflow controller.
Examples To create an Openflow controller called area51, on the vnet roswell, as a dedicated
service, with an IP address of 172.16.21.11, use the following command:
CLI network-admin@switch > openflow-create name area51 vnet roswell
dedicated-vnet-service gateway 172.16.21.11 version 1.3
See Also
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-remove
Pluribus Networks nvOS Version 2.3.2
575
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
576
openflow-delete
This command is used to delete an existing OpenFlow service instance on the switch.
Syntax openflow-delete name name-string
name name-string
Specifies the name of the OpenFlow service.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage An OpenFlow service can be enabled to communicate with an OpenFlow controller using the
OpenFlow version 1.0 or 1.3 protocol. Use this command to delete an existing service.
Examples To delete the OpenFlow service instance, ofpd, use the following command:
CLI network-admin@switch > openflow-delete name ofpd
See Also
• openflow-create
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-remove
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
577
Pluribus Networks nvOS Version 2.3.2
578
openflow-show
This command displays a list of OpenFlow service instances on the switch.
openflow-show id [name name-string] type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|nat|
openstack|netvmm|ovs [scope local|fabric] [is-global true|false]
[location fabric-node name] [version 1.0|1.3] [vlan vlan-id] [vnet
vnet-name]
id
Specifies the ID generated automatically by nvOS.
name name-string
Specifies the name of the OpenFlow service.
type
vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|ofpd|
orphaned|netvm|nat|
openstack|netvmm|ovs
Specifies the type of service used by OpenFlow.
scope local|fabric
Specifies the scope of the OpenFlow service.
vnet vnet-name
Specifies the name of the VNET in the case where the
OpenFlow service controls a virtual network.
is-global true|false
Specifies if the service is global or not.
location fabric-node
name
Specifies the location of the OpenFlow instance.
version 1.0|1.3
Specifies the version of OpenFlow.
vlans vlan-list
Specifies the list of VLANs where the OpenFlow service
controls a VLAN on a switch.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
579
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None.
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
The parameter, state, and failmode are deprecated. The parameters,
type, and location are added.
Version 2.2
The option, ovs, added to the parameter, type.
Version 2.2.2
The parameter, version, added.
Version 2.3.1
The parameter, is-global, added.
Usage An OpenFlow service can be enabled to communicate with an OpenFlow controller using the
OpenFlow version 1.0 protocol. This command shows a list of OpenFlow instances for a VLAN on
a switch or a virtual network.
Examples To display a list of all OpenFlow instances on the switch, use the following command:
CLI network-admin@switch > openflow-show
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-remove
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
580
openflow-connection-add
This command adds an OpenFlow controller instance to an OpenFlow service instance.
Syntax openflow-connection-add name name-string vlan vlan-id
controller-ip ip-address [control-port port-number] [failmode
standalone(open)|secure(timeout)]
name name-string
Specifies the name of the OpenFlow service to connect.
Specify the following connection arguments:
vlan vlan-id
Specify the VLAN for the OpenFlow service.
controller-ip
ip-address
Specify the IP address of the OpenFlow controller.
Specify any of the following options:
control-port
port-number
Specify the TCP port for the OpenFlow controller. The
default value is 6633, the well-known OpenFlow port.
failmode
Specify the type of failmode, either standalone or secure.
standalone(open)|secure
(timeout)
Defaults Unless you configure the control port, the default port value is 6633.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage One or several OpenFlow controllers can manage traffic forwarding using the OpenFlow 1.0
protocol. When a VLAN on a switch or a virtual network is turned over to OpenFlow control, it
ceases to perform standard (“legacy”) L2/L3 switching functions such as flooding and dynamic
MAC learning.
Examples To configure the OpenFlow service, MyOpenFlowService, to the OpenFlow ccontroller at
IP address, 172.24.99.30, use the following command:
CLI network-admin@switch > openflow-connection-add name
MyOpenFlowService controller-ip 172.24.99.30
The configuration uses the default port, 6633.
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-remove
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
Pluribus Networks nvOS Version 2.3.2
581
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
582
openflow-connection-disable
This command is used to disable an OpenFlow controller instance to an OpenFlow service instance.
Syntax openflow-connection-disable name name-string [vlan vlan-id]
name name-string
Specify the name of an existing OpenFlow service instance
to disable.
Specify the following connection arguments:
vlan vlan-id
Specify the VLAN identifier for the OpnFlow service.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to disable an OpenFlow service instance.
Examples To disable the OpenFlow connection, MyOpenflow, use the follwowing command:
CLI network-admin@switch > openflow-connection-disable MyOpenFlow
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-enable
• openflow-connection-remove
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
583
Pluribus Networks nvOS Version 2.3.2
584
openflow-connection-enable
This command is used to enable an OpenFlow controller instance to an OpenFlow service instancer.
Syntax openflow-connection-enable name name-string [vlan vlan-id]
name name-string
Specify the name of an existing OpenFlow service instance
to disable.
Specify the following connection arguments:
vlan vlan-id
Specify the VLAN identifier for the OpenFlow service.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to enable an OpenFlow service instance.
Examples To enable the OpenFlow connection, MyOpenflow, use the following command:
CLI network-admin@switch > openflow-connection-enable MyOpenFlow
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-remove
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
585
Pluribus Networks nvOS Version 2.3.2
586
openflow-connection-remove
This command removes an OpenFlow controller from an OpenFlow service instance from the
configuration.
Syntax openflow-connection-remove name name-string vlan vlan-id
[controller-ip ip-address]]
Specifies the name of the OpenFlow service to connect.
name name-string
Specify the following connection arguments:
vlan vlan-id
Specify the following options:
controller-ip
ip-address
Specifies the IP address of the OpenFlow controller to
connect to.
Defaults None.
Access CLI
History Command introduced in nvOS Version 1.2.
Usage One or several OpenFlow controllers can manage traffic forwarding using the OpenFlow 1.0
protocol. When a VLAN on a switch or a virtual network is turned over to OpenFlow control, it
ceases to perform standard (“legacy”) L2/L3 switching functions such as flooding and dynamic
MAC learning.
Examples To remove the OpenFlow service, MyOpenFlowService, to the OpenFlow ccontroller at IP
address, 172.24.99.30, use the following command:
CLI network-admin@switch > openflow-connection-remove name
MyOpenFlowService controller-ip 172.24.99.30
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-restart
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
587
Pluribus Networks nvOS Version 2.3.2
588
openflow-connection-restart
This command is used to restart an OpenFlow controller.
Syntax openflow-connection-restart name name-string [vlan vlan-id]
name name-string
Specify the name of an existing OpenFlow service instance to
disable.
Specify the following connection argument:
vlan vlan-id
Specify the VLAN identifier for the OpenFlow service.
Defaults None
Access CLI
History Command introduced in nvOS Version 1.2.
Usage Use this command to restart an OpenFlow service instance.
Examples To restart the OpenFlow connection, MyOpenflow, use the following command:
CLI network-admin@switch > openflow-connection-restart MyOpenFlow
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-remove
• openflow-connection-show
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
589
Pluribus Networks nvOS Version 2.3.2
590
openflow-connection-show
This command displays a list of OpenFlow controller instances.
Syntax openflow-connection-add name name-string controller-ip
ip-address [control-port port-number] [status connection-status
[uptime duration:#d#h#m#s] vlan vlan-id failmode
standalone(open)|secure(timeout) dpid dpid-number
name name-string
Specifies the name of the OpenFlow service to connect.
Specify the following connection arguments:
controller-ip
ip-address
Specifies the IP address of the OpenFlow controller to connect to.
control-port
port-number
Specifies the TCP port for the OpenFlow controller. The default value
is 6633, the well-known OpenFlow port.
status
connection-status
Specifies whether the connection with the OpenFlow controller is
disconnected, handshaking in progress, or established.
uptime
duration:#d#h#m#s
Specifies the elapsed time since the connection with the OpenFlow
controller was last successfully established (in days, hours, minutes
and seconds).
vlan vlan-id
Specifies the VLAN associated with the OpenFlow connection.
failmode
standalone(open)|
secure(timeout)
Specifies the failure method configured for the connection.
dpid dpid-number
Specifies the datapath identifier.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
591
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 1.2
Command introduced.
Version 2.0
The parameters, failmode, and dpid added.
Usage One or several OpenFlow controllers can manage traffic forwarding using the OpenFlow 1.0
protocol. When a VLAN on a switch or a virtual network is turned over to OpenFlow control, it
ceases to perform standard (“legacy”) L2/L3 switching functions such as flooding and dynamic
MAC learning.
Examples To display information about the OpenFlow service, MyOpenFlowService, to the
OpenFlow ccontroller at IP address, 172.24.99.30, use the following command:
CLI network-admin@switch > openflow-connection-show name
MyOpenFlowService controller-ip 172.24.99.30
name
MyOpenFlowService
controller-ip
172.24.98.30
See Also
• openflow-create
• openflow-delete
• openflow-modify (deprecated)
• openflow-restart
• openflow-show
• openflow-connection-add
• openflow-connection-disable
• openflow-connection-enable
• openflow-connection-restart
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
control-port
6633
Pluribus Networks nvOS Version 2.3.2
592
status
connected
openflow-interface-add
This command is used to add an interface to an OpenFlow configuration.
openflow-interface-add openflow-name name ip ip-address netmask
netmask assignment none|dhcp|dhcpv6|autov6 vlan vlan-id vxlan vxlan-id
if mgmt|data|span alias-on|alias-on-string exclusive|no-exclusive
nic-enable|nic-disable secondary-macs secondary-macs-string
Specify the name of the OpenFlow configuration.
openflow-name name
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask.
assignment
Specify the method of IP address assignment.
none|dhcp|dhcpv6|autov6
vlan vlan-id
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specify the VXLAN assigned to the interface.
if mgmt|data|span
Specify the type of interface.
alias-on|
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
History
Version 2.2
Command introduced.
Version 2.2.4
The parameter, secondary-macs, added.
Version 2.3.2
The parameter, autov6, added.
Usage Use this command to add an interface to an OpenFlow configuration.
Examples To add an interface to the OpenFlow configuration, openflow-1, with IP assignment, DHCP,
VLAN 101, and interface type, data, use the following syntax:
CLI network-admin@switch > openflow-interface-add openflow-name
openflow-1 assignment dhcp vlan 101 if data
See Also
• openflow-interface-modify
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
593
Pluribus Networks nvOS Version 2.3.2
594
openflow-interface-modify
This command is used to modify an interface for an OpenFlow configuration.
Syntax openflow-interface-modify openflow-name name ip ip-address
netmask netmask assignment none|dhcp|dhcpv6 vlan vlan-id vxlan
vxlan-id if mgmt|data|span alias-on|alias-on-string
exclusive|no-exclusive nic-enable|nic-disable secondary-macs
secondary-macs-string
Specify the name of the OpenFlow configuration.
openflow-name name
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask.
assignment
none|dhcp|dhcpv6|auto6
Specify the method of IP address assignment.
vlan vlan-id
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specify the VXLAN assigned to the interface.
if mgmt|data|span
Specify the type of interface.
alias-on|
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|nic-disable
Specify if the NIC is enabled or disabled.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
History
Version 2.2
Command introduced.
Version 2.2.4
The parameter, secondary-macs, added.
Version 2.3.2
The parameter, autov6, added.
Usage Use this command to modify an interface to an OpenFlow configuration.
Examples To modify an interface to the OpenFlow configuration, openflow-1, to use VLAN 110, use the
following syntax:
CLI network-admin@switch > openflow-interface-modify openflow-name
openflow-1 vlan 110
• openflow-interface-add
• openflow-interface-remove
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
595
Pluribus Networks nvOS Version 2.3.2
596
openflow-interface-remove
This command is used to remove an interface from an OpenFlow configuration.
Syntax openflow-interface-remove openflow-name name nic nic-string
Specify the name of the OpenFlow configuration.
openflow-name name
Specify the following interface arguments:
Specify the NIC string.
nic nic-string
Defaults None
Access CLI
History Command introduced in Version 2.2
Usage Use this command to remove an interface from an OpenFlow configuration.
Examples To remove an interface to the OpenFlow configuration, openflow-1, use the following syntax:
CLI network-admin@switch > openflow-interface-remove openflow-name
openflow-1 nic eth0.110
See Also
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-show
Pluribus Networks nvOS Version 2.3.2
597
Pluribus Networks nvOS Version 2.3.2
598
openflow-interface-show
This command is used to display information about an interface in an OpenFlow configuration.
Syntax openflow-interface-show openflow-name name ip ip-address netmask
netmask assignment none|dhcp|dhcpv6 vlan vlan-id vxlan vxlan-id
if mgmt|data|span alias-on|alias-on-string
exclusive|no-exclusive nic-enable|nic-disable nic-state down|up
secondary-macs secondary-macs-string
Specify the name of the OpenFlow configuration.
openflow-name name
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask.
assignment
none|dhcp|dhcpv6
Specify the method of IP address assignment.
vlan vlan-id
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specify the VXLAN assigned to the interface.
if mgmt|data|span
Specify the type of interface.
alias-on|
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|nic-disable
Specify if the NIC is enabled or disabled.
nic-state down|up
Specifies the NIC state as up or down.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
Pluribus Networks nvOS Version 2.3.2
599
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 2.2
Command introduced.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to display information about an interface in an OpenFlow configuration.
Examples To display information about an interface to the OpenFlow configuration, openflow-1, use the
following syntax:
CLI network-admin@switch > openflow-interface-show openflow-name
openflow-1
See Also
• openflow-interface-add
• openflow-interface-modify
• openflow-interface-remove
Pluribus Networks nvOS Version 2.3.2
600
openstack-config-create
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to create an OpenStack instance on a VNET.
Syntax openstack-config-create name name-string vnet vnet-name port
port-number vlans vlan-list
dedicated-vnet-service|shared-vnet-service disable|enable [
scope local|fabric] [ha|no-ha] [ha-vip ip-address]
[ha-vip-netmask netmask] [glance-folder storage-folder-name]
[release icehouse|juno]
name name-string
Specify a name for the OpenStack instance.
vnet vnet-name
Specify the name of the VNET for OpenStack.
port port-number
Specify the port number for the VNET.
vlans vlan-list
Specify the list of VLANS to apply to the OpenStack
service. This should be a range of VLANs that apply to the
networks created in OpenStack. Each network is
assigned a separate VLAN.
Specify any of the following options:
dedicated-vnet-service|
shared-vnet-service
Specify if OpenStack is a dedicated or shared VNET
service.
scope local|fabric
Specify the scope of the OpenStack service as local or
fabric.
ha|no-ha
Specify to add high availability to the configuration.
ha-vip ip-address
Specify the virtual IP address where the failover occurs.
ha-vip-netmask netmask
pecify the netmask for the IP address where the failover
occurs.
glance-folder
storage-folder-name
Specify the name of the Glance storage folder for the
configuration.
glance-vfolder
storage-vfolder-name
Specify the name of the virtual Glance storage folder for
the configuration.
release icehouse|juno
Specify the OpenStack release that you want to deploy.
Icehouse is the recommended version of OpenStack.
plugin ml2|ovs
Specify a plugin to configure for OpenStack.
extensions|no-extenstion
Specify if you want to include OpenStack extensions in
the configuration.
enable-nat|no-enable-nat
Enable NAT for the configuration.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, storage-pool, storage, and release
added.
Pluribus Networks nvOS Version 2.3.2
601
Version 2.2
The option, grizzly, removed from the parameter, release, and
the option, icehouse, added. The parameter, plugin, added.
Version 2.3
The parameter storage-folder changed to glance-folder.
The parameter plugin is deprecated. The parameter
enable-nat added.
Version 2.3.1
The parameters for high availability added. Command changed to
openstack-config-create.
Usage Use this command to create an OpenStack instance on a VNET.
Examples To create an OpenStack instance, Open-One, on VNET, opvnet, on port 65 as a dedicated
service, on storage pool, vry-lrg-str, use the following command:
CLI network-admin@switch > openstack-config-create name Open-One vnet
opvnet port 65 dedicated-vnet-service storage-pool vry-lrg-str
See Also
 openstack-config-delete
 openstack-config-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
602
openstack-config-delete
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to delete an OpenStack instance on a VNET.
Syntax openstack-config-delete name name-string
Specify the name of the OpenStack instance that you
want to delete from the configuration.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Version 2.0
Command introduced.
Version 2.3.1
Command changed to openstack-config-delete.
Usage Use this command to remove an OpenStack instance.
Examples To remove the OpenStack instance, Open-One, use the following command:
CLI network-admin@switch > openstack-delete name Open-One
See Also
 openstack-config-create
 openstack-config-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
603
Pluribus Networks nvOS Version 2.3.2
604
openstack-config-modify
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to modify an OpenStack instance on a VNET.
Syntax openstack-config-modify name name-string port port-number vlans
vlan-list dedicated-vnet-service|shared-vnet-service
disable|enable [ scope local|fabric] [ha|no-ha] [ha-vip
ip-address] [ha-vip-netmask netmask] [glance-folder
storage-folder-name] [release icehouse|juno]
name name-string
Specify a name for the OpenStack instance.
port port-number
Specify the port number for the VNET.
vlans vlan-list
Specify the list of VLANS to apply to the OpenStack
service. This should be a range of VLANs that apply to the
networks created in OpenStack. Each network is
assigned a separate VLAN.
Specify any of the following options:
scope local|fabric
Specify the scope of the OpenStack service as local or
fabric.
ha|no-ha
Specify to add high availability to the configuration.
ha-vip ip-address
Specify the virtual IP address where the failover occurs.
ha-vip-netmask netmask
pecify the netmask for the IP address where the failover
occurs.
glance-folder
storage-folder-name
Specify the name of the Glance storage folder for the
configuration.
release icehouse|juno
Specify the OpenStack release that you want to deploy.
Icehouse is the recommended version of OpenStack.
plugin ml2|ovs
Specify a plugin to configure for OpenStack.
extensions|no-extenstion
Specify if you want to include OpenStack extensions in
the configuration.
enable-nat|no-enable-nat
Enable NAT for the configuration.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, storage-pool, storage, and release
added.
Version 2.2
The option, grizzly, removed from the parameter, release, and
the option, icehouse, added. The parameter, plugin, added.
Pluribus Networks nvOS Version 2.3.2
605
Version 2.3
The parameter storage-folder changed to glance-folder.
The parameter plugin is deprecated. The parameter
enable-nat added.
Version 2.3.1
The parameters for high availability added. Command changed to
openstack-config-modify.
Usage Use this command to modify an OpenStack instance on a VNET.
Examples To modify an OpenStack instance, Open-One, on VNET, opvnet, on port 65 as a dedicated
service, on storage pool, vry-lrg-str, use the following command:
CLI network-admin@switch > openstack-config-modify name Open-One vnet
opvnet port 65 dedicated-vnet-service storage-pool vry-lrg-str
See Also
 openstack-config-create
 openstack-config-delete
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
606
openstack-config-node-show
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to display information about an OpenStack
node on a VNET.
Syntax openstack-config-node-show openstack-name name-string
openstack-bridge-vnic-nic nic-string [hostname hostname-string]
addr ip-address macid mac-address [type
controller|compute|unknown] platform platform-string
[status online|offline|installing|failed]
openstack-name name-string
Specifies the name of the OpenStack node.
openstack-bridge-vnic-nic
nic-string
Specifies the name of the virtual NIC assigned to
theinterface.
Specify the following node arguments:
hostname hostname-string
Specifies the host name for the node.
addr ip-address
Specifies the IP address for the node.
macid mac-address
Specifies the MAC address for the node.
type controller|compute|
unknown
Specifies the type of node.
platform platform-string
Specifies the type of platform.
release release-string
Specifies the OpenStack release on the node.
status online|offline|
installing|failed
Specifies the status of the node.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
Pluribus Networks nvOS Version 2.3.2
607
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.3
The parameters, platform and release, added.
Version 2.3.2
Command changed to openstack-config-node-show.
Usage Use this command to display information about a node in the OpenStack instance.
Examples To display a node, openstack-node1, host name, openstack, IP address 192.168.1.15 type
controller, use the following command:
CLI (network-admin@aquila13) > openstack-config-node-show
openstack-name hostname
addr
macid
type
status
-------------- --------------- ----------- ----------------- ---------- -----ops202
controller
100.202.1.2 66:0e:94:23:3c:24 controller online
ops202
compute-100-202 100.202.1.3 00:e0:81:e4:02:97 compute
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
608
online
openstack-show
OpenStack is a cloud operating system that controls large pools of compute, storage, and
networkingresources throughout a data center. This command is used to display an OpenStack instance
on a VNET.
Syntax openstack-show id name name-string name name-string [type
vnet-mgr|vrouter|vlb|dhcp|dns|netzone|ofpd|orphaned|netvm|nat|
openstack|netvmm|ovs] [scope local|fabric] vnet vnet-name
[location fabric-node name] port port-number vlans vlan-list
storage storage-number vrg vrg-name release icehouse|juno
controller-pool controller-pool-string extensions|no-extensions
id
Specifies the ID generated automatically by nvOS.
name name-string
Specifies the name of the OpenStack instance that you
want to modify in the configuration.
type
vnet-mgr|vrouter|vlb|
dhcp|dns|netzone|ofpd|
orphaned|netvm|nat|
openstack|netvmm|ovs
Specifies the type of VNET.
scope local|fabric
Specifies the scope of the VNET.
vnet vnet-name
Specifies the name of the VNET.
location
fabric-node name
Specifies the location of the VNET on the fabric.
port port-number
Specifies the port number for the Openstack instance.
vlans vlan-list
Specifies the list of VLANs assigned to OpenStack.
storage storage-number
Specifies the quantity of storage allocated to OpenStack.
vrg vrg-name
Specifies the Virtual Resource Group (VRG) assigned to
OpenStack.
release icehouse|juno
Specifies the OpenStack release type.
controller-pool
controller-pool-string
Specifies the controller pool assigned to OpenStack.
extensions|
no-extensions
Specifies if extensions are displayed or not.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
Pluribus Networks nvOS Version 2.3.2
609
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, vlans, storage, vrg, release, and
controller-pool added.
Version 2.2
The option, grizzly, removed from the parameter, release,
and the option, icehouse, added. The option, ovs, added to
the parameter, type.
Version 2.3
The parameter havana is deprecated.
Usage Use this command to display information about an OpenStack instance.
Pluribus Networks nvOS Version 2.3.2
610
Examples To display the OpenStack instance, Open-One, use the following command:
CLI (network-admin@pleiades25) > openstack-show format all layout
vertical
id:
b000023:2
name:
ops202
type:
openstack
scope:
fabric
vnet:
vnet202
vnet-service:
shared
state:
enabled
location:
aquila13
storage-pool:
pool-disk1
gateway:
10.12.1.1
template:
no
port:
25000
vlans:
100-120
storage:
0
vrg:
OS-ops202-vrg
release:
havana
controller-pool:
pool-disk1
extensions:
false
id:
b000023:19
name:
ops198
type:
openstack
scope:
fabric
vnet:
vnet198
vnet-service:
shared
state:
enabled
location:
aquila13
storage-pool:
pool-disk1
gateway:
::
template:
no
port:
25000
vlans:
122-140
storage:
0
vrg:
OS-ops198-vrg
release:
havana
controller-pool:
pool-disk1
extensions:
false
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
Pluribus Networks nvOS Version 2.3.2
611
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
612
openstack-controller-create
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to create an OpenStack controller on a VNET.
Syntax openstack-controller-create name name-string storage-pool
storage-pool-name storage storage-number
This parameter is not configurable. It defaults to the
name that you used to create the OpenStack service.
name name-string
Specify one or both of the following options:
Specify a storage pool for the controller. This must be a
datapool and not an rpool.
storage-pool
storage-pool-name
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, extensions, storage-pool, and
storage added.
Version 2.3
The parameters, extensions and storage, deprecated.
Usage Use this command to create an OpenStack controller.
Examples To create an OpenStack controller, openstack-controller-1, and implement extensions, use
the following command:
CLI network-admin@switch > openstack-controller-create name openstack-1
extensions
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
613
Pluribus Networks nvOS Version 2.3.2
614
openstack-controller-delete
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to delete an OpenStack controller on a VNET.
Syntax openstack-controller-delete name name-string
Specify the name of the OpenStack controller.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to delete an OpenStack controller.
Examples To delete an OpenStack controller, openstack-controller-1, use the following command:
CLI network-admin@switch > openstack-controller-delete name
openstack-controller-1
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
615
Pluribus Networks nvOS Version 2.3.2
616
openstack-controller-shutdown
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to shutdown an OpenStack controller on a
VNET.
Syntax openstack-controller-shutdown name name-string
Specify the name of the OpenStack controller.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to shutdown an OpenStack controller.
Examples To shutdown an OpenStack controller, openstack-controller-1, use the following command:
CLI network-admin@switch > openstack-controller-shutdown name
openstack-controller-1
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
617
Pluribus Networks nvOS Version 2.3.2
618
openstack-controller-start
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to start an OpenStack controller on a VNET.
Syntax openstack-controller-start name name-string
Specify a name for the OpenStack controller.
name name-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to start an OpenStack controller.
Examples To start an OpenStack controller, openstack-controller-1, use the following command:
CLI network-admin@switch > openstack-controller-start name
openstack-controller-1
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
619
Pluribus Networks nvOS Version 2.3.2
620
openstack-controller-storage-add
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to add storage to an OpenStack controller on
a VNET.
Syntax openstack-controller-start name name-string hda-size
hda-size-number storage-pool storage-pool-name
name name-string
Specify the name of the OpenStack controller.
hda-size
hda-size-number
Specify the quantity of storage to allow for the
OpenStack controller.
Specify the following option:
Specify the storage pool for the controller. This must be
a datapool type of storage.
storage-pool
storage-pool-name
Defaults None
Access CLI
History .
Version 2.0
Command introduced.
Version 2.3
The parameter, storage, changed to hda-size.
Usage Use this command to add storage to an OpenStack controller.
Examples To add storage to an OpenStack controller, openstack-controller-1, use the following
command:
CLI network-admin@switch > openstack-controller-storage-add name red-os
hda-size 8g
VM running. From outside switch, connect to vnc port :1.
Ex: vncviewer 192.168.23.11:1
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
621
Pluribus Networks nvOS Version 2.3.2
622
openstack-interface-add
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to add an interface to an OpenStack
instance.
Syntax openstack-interface-add openstack-name name-string ip ip-address
netmask netmask [assignment none|dhcp|dhcpv6] vlan vlan-id vxlan
vxlan-id [if mgmtdhcp|dhcpv6] alias-on alias-on-string
exclusive|no-exclusive nic-enable|nic-disable vrrp-id id
vrrp-primary vrrp-primary-string vrrp-priority
vrrp-priority-number vrrp-adv-int mseconds secondary-macs
secondary-macs-string
Specify the name of the OpenStack instance to add the interface.
openstack-name
name-string
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask.
assignment
Specify the method of IP address assignment.
none|dhcp|dhcpv6|autov6
vlan vlan-id
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specify the VXLAN assigned to the interface.
if mgmt|data|span
Specify the type of interface.
alias-on
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
vrrp-id id
Specify the ID assigned by VRRP.
vrrp-primary
vrrp-primary-string
Specify the primary interface for VRRP.
vrrp-priority
vrrp-priority-number
Specify the VRRP priority for the interface.
vrrp-adv-int mseconds
Specify the VRRP advertisement interval in milliseconds. The
range is 10 to 40950 with a default value of 1000.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
Pluribus Networks nvOS Version 2.3.2
623
Usage Use this command to add an interface to an OpenStack instance.
Examples To add an interface to the OpenStack instance, Open-One, with IP address, 192.168.1.1., VLAN
25, and data as the interface, use the following command:
CLI network-admin@switch > openstack-interface-add name Open-One ip
192.168.1.1 netmask 255.255.255.0 assignment none vlan 25 if data
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
624
openstack-interface-modify
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to modify an interface to an OpenStack
instance.
Syntax openstack-interface-modify openstack-name name-string nic
nic-string ip ip-address netmask netmask [assignment
none|dhcp|dhcpv6] vlan vlan-id vxlan vxlan-id [if
mgmt|dhcp|dhcpv6] alias-on alias-on-string
exclusive|no-exclusive nic-enable|nic-disable vrrp-id id
vrrp-primary vrrp-primary-string vrrp-priority
vrrp-priority-number vrrp-adv-int msecondssecondary-macs
secondary-macs-string
Specify the name of the OpenStack instance to modify the
interface.
openstack-name
name-string
Specify the following interface argument:
Specify the interface NIC to modify/
nic nic-string
Specify any of the following options:
ip ip-address
Specify the IP address for the interface.
netmask netmask
Specify the netmask.
assignment
none|dhcp|dhcpv6
Specify the method of IP address assignment.
vlan vlan-id
Specify the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specify the VXLAN, from 0 to 16777215,
assigned to the interface.
if mgmt|data|span
Specify the type of interface.
alias-on
alias-on-string
Specify an alias if desired.
exclusive|
no-exclusive
Specify if the interface is exclusive or not.
nic-enable|
nic-disable
Specify if the NIC is enabled or disabled.
vrrp-primary
vrrp-primary-string
Specify the primary interface for VRRP.
vrrp-priority
vrrp-priority-number
Specify the VRRP priority for the interface.
vrrp-adv-int mseconds
Specify the VRRP advertisement interval in milliseconds.
The range is 10 to 40950 with a default value of 1000.
secondary-macs
secondary-macs-string
Specify a secondary MAC address for the interface.
Defaults None
Access CLI
Pluribus Networks nvOS Version 2.3.2
625
History
Version 2.0
Command introduced.
Version 2.1
The parameters, exclusive, and nic added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to modify an interface to an OpenStack instance.
Examples To modify the interface to the OpenStack instance, Open-One, to IP address, 192.168.1.13.,
use the following command:
CLI network-admin@switch > openstack-interface-modify name Open-One ip
192.168.1.13
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
626
openstack-interface-remove
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to remove an interface to an OpenStack
instance.
Syntax openstack-interface-remove openstack-name name-string nic
nic-string
Specify the name of the OpenStack instance.
openstack-name
name-string
Specify the following interface argument:
Specify the NIC to remove from the interface.
nic nic-string
Defaults None
Access CLI
History Command introduced in nvOS Version 2.0.
Usage Use this command to remove an interface from an OpenStack instance.
Examples To remove the interface, data, from the interface, use the following command:
CLI network-admin@switch > openstack-interface-remove openstack-name
Open-One nic data
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-controller-start
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-show
 openstack-node-add(deprecated)
 openstack-node-modify(deprecated)
 openstack-node-remove(deprecated)
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
627
Pluribus Networks nvOS Version 2.3.2
628
openstack-interface-show
OpenStack is a cloud operating system that controls large pools of compute, storage, and networking
resources throughout a data center. This command is used to display information about an interface in
an OpenStack instance.
Syntax openstack-interface-show openstack-name name-string nic
nic-string ip ip-address netmask netmask [assignment
none|dhcp|dhcpv6] mac mac-address vlan vlan-id vxlan vxlan-id
[if mgmtdhcp|dhcpv6] alias-on alias-on-string vm-nic-type
e1000|virtio exclusive|no-exclusive nic-enable|nic-disable
nic-state down|up
Specifies the name of the OpenStack instance to add the
interface.
openstack-name
name-string
Specify the following interface arguments:
nic nic-string
Specifies the interface NIC to modify/
ip ip-address
Specifies the IP address for the interface.
netmask netmask
Specifies the netmask.
assignment
none|dhcp|dhcpv6
Specifies the method of IP address assignment.
mac mac-address
Specifies the MAC address of the interface.
vlan vlan-id
Specifies the VLAN assigned to the interface.
vxlan vxlan-id
Optionally, specifies the VXLAN assigned to the
interface.
if mgmt|data|span
Specifies the type of interface.
vm-nic-type
e1000|virtio
Specifies the type of virtual NIC assigned to the
interface.
alias-on
alias-on-string
Specifies an alias if configured.
exclusive|
no-exclusive
Specifies if the interface is exclusive or not.
nic-enable|
nic-disable
Specifies if the NIC is enabled or disabled.
nic-state down|up
Specifies the of the NIC as up or down.
secondary-macs
secondary-macs-string
Specifies the secondary MAC address for the interface.
Formatting Options
format
fields-to-display
Display output using a specific parameter. Use all to display all
possible output.
parsable-delim
character
Display output formatted for machine parsing using a specified
delimiter.
sort-asc
Display output in ascending order.
sort-desc
Display output in descending order.
Pluribus Networks nvOS Version 2.3.2
629
show dups
Display duplicate entries in the output.
layout
vertical|horizontal
Format the output in a vertical or horizontal layout.
show-interval
seconds-interval
Repeat the show command at a specified interval.
show-headers|
no-show-headers
Display column headers or not.
limit-output number
Limit the display output to a specific number of entries.
count-output
Display the number of entries in the output. This is useful with
vRouter show commands.
unscaled
Display full values in the output instead of scaled approximate
values.
sum-by
Aggregate output by specific parameters. If sum-by fields are
specified, records that have the same value in sum-by fields are
combined and displayed as one aggregate record. NOTE: This
option is only available for show commands that collect statistics
such as connection-stats-show.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.1
The parameters, exclusive, nic, and nic-state added.
Version 2.2.4
The parameter, secondary-macs, added.
Usage Use this command to display an interface to an OpenStack instance.
Pluribus Networks nvOS Version 2.3.2
630
Examples To display an interface in the OpenStack instance, use the following command:
CLI (network-admin@pleiades25) > openstack-interface-show format all
layout vertical
openstack-name: ops202
nic:
eth0.202
ip:
100.202.1.1/24
assignment:
static
mac:
66:0e:94:23:ac:b9
vlan:
202
vxlan:
0
if:
data
alias-on:
exclusive:
no
nic-config:
disable
nic-state:
up
openstack-name: ops202
nic:
eth0
ip:
10.12.2.202/16
assignment:
static
mac:
66:0e:94:23:d3:79
vlan:
0
vxlan:
0
if:
mgmt
alias-on:
exclusive:
no
nic-config:
enable
nic-state:
up
openstack-name: ops198
nic:
eth0.198
ip:
100.198.1.111/24
assignment:
static
mac:
66:0e:94:23:59:5f
vlan:
198
vxlan:
0
if:
data
alias-on:
exclusive:
no
nic-config:
disable
nic-state:
up
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
Pluribus Networks nvOS Version 2.3.2
631
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
632
openstack-plugin-install
OpenStack is preinstalled on the switch and you can install it on another platform using the plugin
command.
Syntax openstack-plugin-install openstack openstack-name controller
controller-string user user-string
openstack
openstack-name
Specify a name for the OpenStack instance.
controller
controller-string
Specify an IP address for the OpenStack controller.
user user-string
Specify a user.
Defaults None
Access CLI
History
Version 2.0
Command introduced.
Version 2.2
The release, grizzly, is deprecated for the parameter release,
and the option, icehouse added.
Version 2.3
The parameters, password, release, and extensions
deprecated.
Usage Use this command to install an OpenStack controller on another platform using the
pre-installed plugin.
Examples To install OpenStack for Open-Two, controller IP address, 10.9.11.23, and password m0nk3y,
use the following command:
CLI network-admin@switch > openstack-plugin-install openstack Open-Two
controller 10.9.11.23 password m0nk3y
See Also
 openstack-create
 openstack-delete
 openstack-modify
 openstack-show
 openstack-controller-create
 openstack-controller-delete
 openstack-controller-shutdown
 openstack-interface-add
 openstack-interface-modify
 openstack-interface-remove
 openstack-interface-show
 openstack-node-show
 openstack-plugin-install
Pluribus Networks nvOS Version 2.3.2
633
About
Pluribus Networks
Pluribus Networks delivers open, fabric-based
networking that transforms the network into a
strategic business asset. Our easily deployable
architecture improves visibility, control, security
and efficiency for next-generation networks and
the people who run them. Our customers protect
existing IT investments while benefitting from a
disaggregated development platform, robust
analytics and intelligent, interoperable cloud
solutions.
Learn more at www.pluribusnetworks.com and
@pluribusnet.
Pluribus Networks, Inc.
2455 Faber Place, Suite 100, Palo Alto, CA 94303
1-855-GET-VNET / +1 650-289-4717
Copyright© 2016 Pluribus Networks, Inc. All rights reserved.
October 2015