Mellanox OFED for Linux User Manual Rev 4.3 Software version 4.3-1.0.1.0 www.mellanox.com Mellanox Technologies NOTE: THIS HARDWARE, SOFTWARE OR TEST SUITE PRODUCT (“PRODUCT(S)”) AND ITS RELATED DOCUMENTATION ARE PROVIDED BY MELLANOX TECHNOLOGIES “AS-IS” WITH ALL FAULTS OF ANY 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 2018. 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®, NPS®, 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 Document Number: 2877 Mellanox Technologies 2 Table of Contents Table of Contents . 3 List of Tables . 9 Chapter 1 Overview . 22 1.1 Stack Architecture . 23 1.1.1 mlx4 VPI Driver . 23 1.1.2 mlx5 Driver . 24 1.1.3 Mid-layer Core. 25 1.1.4 ULPs . 25 1.1.4.1 IP over IB (IPoIB) . 25 1.1.4.2 iSCSI Extensions for RDMA (iSER). 26 1.1.4.3 SCSI RDMA Protocol (SRP). 26 1.1.4.4 User Direct Access Programming Library (uDAPL) . 26 1.1.5 MPI . 26 1.1.6 InfiniBand Subnet Manager . 26 1.1.7 Diagnostic Utilities . 27 1.1.8 Mellanox Firmware Tools . 27 1.2 Mellanox OFED Package. 27 1.2.1 ISO Image. 27 1.2.2 Software Components . 28 1.2.3 Firmware . 28 1.2.4 Directory Structure . 29 1.3 Module Parameters . 29 1.3.1 mlx4 Module Parameters . 29 1.3.1.1 mlx4_ib Parameters. 29 1.3.1.2 mlx4_core Parameters . 31 1.3.1.3 mlx4_en Parameters . 33 1.3.2 mlx5_core Module Parameters . 33 1.3.3 ib_core Parameters. 34 1.3.4 ib_ipoib Parameters . 34 1.4 Device Capabilities . 34 Chapter 2 Installation . 35 2.1 Hardware and Software Requirements . 35 2.2 Downloading Mellanox OFED . 35 2.3 Installing Mellanox OFED . 36 2.3.1 Installation Script . 36 2.3.2 Installation Procedure. 38 2.3.3 Installation Results . 41 Rev 4.3 Mellanox Technologies 3 2.3.4 Installation Logging . 41 2.3.5 openibd Script . 42 2.3.6 Driver Load Upon System Boot . 42 2.3.7 mlnxofedinstall Return Codes . 42 2.4 Installing MLNX_OFED with Innova™ IPsec Adapter Cards. 43 2.5 Uninstalling Mellanox OFED . 43 2.6 Installing MLNX_OFED Using YUM . 43 2.6.1 Setting up MLNX_OFED YUM Repository . 43 2.6.2 Installing MLNX_OFED Using the YUM Tool . 45 2.6.3 Uninstalling Mellanox OFED Using the YUM Tool . 46 2.7 Installing MLNX_OFED Using apt-get . 46 2.7.1 Setting up MLNX_OFED apt-get Repository . 46 2.7.2 Installing MLNX_OFED Using the apt-get Tool . 47 2.7.3 Uninstalling Mellanox OFED Using the apt-get Tool . 47 2.8 Updating Firmware After Installation . 48 2.8.1 Updating the Device Online . 48 2.8.2 Updating Firmware and FPGA Image on Innova IPsec Cards . 49 2.8.3 Updating the Device Manually. 49 2.8.4 Updating the Device Firmware Automatically upon System Boot . 50 2.9 UEFI Secure Boot . 50 2.9.1 Enrolling Mellanox's x.509 Public Key On your Systems . 50 2.9.2 Removing Signature from kernel Modules . 51 2.10 Performance Tuning. 51 2.11 Installing Upstream rdma-core Libraries . 52 2.12 Installing libdisni Package . 52 Chapter 3 Features Overview and Configuration . 53 3.1 Ethernet Network. 53 3.1.1 Interface. 53 3.1.1.1 ConnectX-3/ConnectX-3 Pro Port Type Management . 53 3.1.1.2 ConnectX-4 Port Type Management/VPI Cards Configuration . 54 3.1.1.3 Counters . 54 3.1.1.4 Persistent Naming . 56 3.1.2 Quality of Service (QoS) . 57 3.1.2.1 Mapping Traffic to Traffic Classes . 57 3.1.2.2 Plain Ethernet Quality of Service Mapping . 57 3.1.2.3 RoCE Quality of Service Mapping . 58 3.1.2.4 Map Priorities with set_egress_map . 59 3.1.2.5 Quality of Service Properties . 59 3.1.2.6 Quality of Service Tools. 60 3.1.2.7 Packet Pacing . ..