Survey
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
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