Mellanox MLNX-OS® User Manual for Ethernet
Total Page:16
File Type:pdf, Size:1020Kb
Mellanox MLNX-OS® User Manual for Ethernet Rev 4.60 Software Version 3.6.3508 www.mellanox.com Mellanox Technologies Confidential NOTE: THIS HARDWARE, SOFTWARE OR TEST SUITE PRODUCT ( PRODUCT(S) ) AND ITS RELATED WITH ALL FAULTS OF ANY ﺴDOCUMENTATION ARE PROVIDED BY MELLANOX TECHNOLOGIES AS-IS KIND AND SOLELY FOR THE PURPOSE OF AIDING THE CUSTOMER IN TESTING APPLICATIONS THAT USE THE PRODUCTS IN DESIGNATED SOLUTIONS . THE CUSTOMER'S MANUFACTURING TEST ENVIRONMENT HAS NOT MET THE STANDARDS SET BY MELLANOX TECHNOLOGIES TO FULLY QUALIFY THE PRODUCT(S) AND/OR THE SYSTEM USING IT. THEREFORE, MELLANOX TECHNOLOGIES CANNOT AND DOES NOT GUARANTEE OR WARRANT THAT THE PRODUCTS WILL OPERATE WITH THE HIGHEST QUALITY. ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY , FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL MELLANOX BE LIABLE TO CUSTOMER OR ANY THIRD PARTIES FOR ANY DIRECT , INDIRECT, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES OF ANY KIND (INCLUDING, BUT NOT LIMITED TO, PAYMENT FOR PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES ; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION ) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY , WHETHER IN CONTRACT , STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE ) ARISING IN ANY WAY FROM THE USE OF THE PRODUCT(S) AND RELATED DOCUMENTATION EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. Mellanox Technologies 350 Oakmead Parkway Suite 100 Sunnyvale, CA 94085 U.S.A. www.mellanox.com Tel: (408) 970-3400 Fax: (408) 970-3403 © Copyright 2017. Mellanox Technologies Ltd. All Rights Reserved. Mellanox®, Mellanox logo, Accelio®, BridgeX®, CloudX logo, CompustorX®, Connect-IB®, ConnectX®, CoolBox®, CORE-Direct®, EZchip®, EZchip logo, EZappliance®, EZdesign®, EZdriver®, EZsystem®, GPUDirect®, InfiniHost®, InfiniBridge®, InfiniScale®, Kotura®, Kotura logo, Mellanox CloudRack®, Mellanox CloudXMellanox®, Mellanox Federal Systems®, Mellanox HostDirect®, Mellanox Multi-Host®, Mellanox Open Ethernet®, Mellanox OpenCloud®, Mellanox OpenCloud Logo®, Mellanox PeerDirect®, Mellanox ScalableHPC®, Mellanox StorageX®, Mellanox TuneX®, Mellanox Connect Accelerate Outperform logo, Mellanox Virtual Modular Switch®, MetroDX®, MetroX®, MLNX-OS®, NP-1c®, NP-2®, NP-3®, Open Ethernet logo, PhyX®, PlatformX®, PSIPHY®, SiPhy®, StoreX®, SwitchX®, Tilera®, Tilera logo, TestX®, TuneX®, The Generation of Open Ethernet logo, UFM®, Unbreakable Link®, Virtual Protocol Interconnect®, Voltaire® and Voltaire logo are registered trademarks of Mellanox Technologies, Ltd. All other trademarks are property of their respective owners. For the most updated list of Mellanox trademarks, visit http://www.mellanox.com/page/trademarks Doc #: MLNX-15-1560-ETH Rev 4.60 Mellanox Technologies Confidential 2 Table of Contents Document Revision History . 5 About this Manual . 26 Chapter 1 Introduction . 30 1.1 System Features . 30 1.2 Ethernet Features. 31 Chapter 2 Getting Started. 33 2.1 Configuring the Switch for the First Time. 33 2.1.1 Re-Running the Wizard. 39 2.2 Starting the Command Line (CLI). 39 2.3 Starting the Web User Interface (WebUI) . 40 2.4 Licenses . 44 2.4.1 Installing MLNX-OS® License (CLI) . 44 2.4.2 Installing MLNX-OS License (Web). 45 2.4.3 Retrieving a Lost License Key . 47 2.4.4 Commands. 48 Chapter 3 User Interfaces . 53 3.1 Command Line Interface Overview. 53 3.1.1 CLI Modes . 53 3.1.2 Syntax Conventions. 54 3.1.3 Getting Help. 54 3.1.4 Prompt and Response Conventions. 55 3.1.5 Using the “no” Form . 56 3.1.6 Parameter Key. 57 3.1.7 CLI Pipeline Operator Commands . 58 3.1.7.1 “include” and “exclude” CLI Filtration Options . 58 3.1.7.2 “watch” CLI Monitoring Option . 59 3.1.7.3 “json-print” CLI Option . 60 3.1.8 CLI Shortcuts . 61 3.2 Web Interface Overview . 62 3.2.1 Setup Menu . 63 3.2.2 System Menu. 64 3.2.3 Security Menu . 65 3.2.4 Ports Menu . 65 3.2.5 Status Menu. 66 3.2.6 ETH Mgmt . 67 3.2.7 IP Route . 67 Rev 4.60 Mellanox Technologies Confidential 1 3.3 Secure Shell (SSH). 68 3.3.1 Adding a Host and Providing an SSH Key . 68 3.3.2 Retrieving Return Codes when Executing Remote Commands. 68 3.4 Management Information Bases (MIBs). 69 3.5 Commands . 72 3.5.1 CLI Session . 72 3.5.2 Banner . 84 3.5.3 SSH . 92 3.5.4 Remote Login. 110 3.5.5 Web Interface . 113 Chapter 4 System Management. 131 4.1 Management Interface . 131 4.1.1 Configuring Management Interfaces with Static IP Addresses . 131 4.1.2 Configuring IPv6 Address on the Management Interface . 131 4.1.3 Dynamic Host Configuration Protocol (DHCP) . 132 4.1.4 Default Gateway . 132 4.1.5 In-Band Management . 132 4.1.6 Configuring Hostname via DHCP (DHCP Client Option 12) . 133 4.1.7 Commands. 134 4.1.7.1 Interface . 134 4.1.7.2 Hostname Resolution . 159 4.1.7.3 Routing . 166 4.1.7.4 Network to Media Resolution (ARP & NDP) . 170 4.1.7.5 DHCP. 176 4.1.7.6 General IPv6 Commands. 179 4.1.7.7 IP Diagnostic Tools. 180 4.2 NTP, Clock & Time Zones . 185 4.2.1 NTP Authenticate . 185 4.2.2 NTP Authentication Key . 185 4.2.3 Commands. 186 4.3 Software Management . 204 4.3.1 Upgrading MLNX-OS Software. 204 4.3.2 Upgrading MLNX-OS HA Groups . 207 4.3.3 Deleting Unused Images. 208 4.3.4 Downgrading MLNX-OS Software . 209 4.3.4.1 Downloading Image. 209 4.3.4.2 Downgrading Image . ..