Mellanox OFED Linux User's Manual
Total Page:16
File Type:pdf, Size:1020Kb
Mellanox OFED for Linux User Manual Rev 1.5.3-3.0.0 Last Modified: February, 2012 www.mellanox.com NOTE: THIS HARDWARE, SOFTWARE OR TEST SUITE PRODUCT (“PRODUCT(S)”) AND ITS RELATED DOCUMENTA- TION 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 PROD- UCTS IN DESIGNATED SOLUTIONS. THE CUSTOMER'S MANUFACTURING TEST ENVIRONMENT HAS NOT MET THE STANDARDS SET BY MELLANOX TECHNOLOGIES TO FULLY QUALIFY THE PRODUCTO(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 MERCHANT- ABILITY, 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, SPE- CIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES OF ANY KIND (INCLUDING, BUT NOT LIMITED TO, PAY- MENT 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 CON- TRACT, 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 POSSIBIL- ITY OF SUCH DAMAGE. Mellanox Technologies Mellanox Technologies, Ltd. 350 Oakmead Parkway PO Box 586 Hermon Building Sunnyvale, CA 94085 Yokneam 20692 U.S.A. Israel www.mellanox.com Tel: +972-4-909-7200 Tel: (408) 970-3400 Fax: +972-4-959-3245 Fax: (408) 970-3403 © Copyright 2011. Mellanox Technologies. All rights reserved. Mellanox®, BridgeX®, ConnectX®, SwitchX®, CORE-Direct®, InfiniBridge®, InfiniHost®, InfiniScale®, PhyX®, Virtual Protocol Interconnect® and Voltaire® are registered trademarks of Mellanox Technologies, Ltd. FabricIT™, MLNX-OS™ and Unbreakable-Link™ are trademarks of Mellanox Technologies, Ltd. All other trademarks are property of their respective owners.. 2 Mellanox Technologies Document Number: 2877 Table of Contents Chapter 1 Mellanox OFED Overview . 13 1.1 Introduction to Mellanox OFED - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 13 1.2 Introduction to Mellanox VPI Adapters - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 13 1.3 Mellanox OFED Package - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 14 1.3.1 ISO Image. 14 1.3.2 Software Components. 14 1.3.3 Firmware. 15 1.3.4 Directory Structure . 15 1.4 Architecture - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 15 1.4.1 mthca HCA (IB) Driver . 16 1.4.2 mlx4 VPI Driver . 16 1.4.3 Mid-layer Core . 17 1.4.4 ULPs . 17 1.4.5 MPI . 18 1.4.6 InfiniBand Subnet Manager . 18 1.4.7 Diagnostic Utilities . 18 1.4.8 Mellanox Firmware Tools . 19 1.5 Quality of Service - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19 Chapter 2 Installation . 20 2.1 Hardware and Software Requirements - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 20 2.1.1 Hardware Requirements . 20 2.1.2 Software Requirements. 21 2.2 Downloading Mellanox OFED - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21 2.3 Installing Mellanox OFED- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21 2.3.1 Pre-installation Notes . 22 2.3.2 Installation Script . 22 2.3.3 Installation Procedure . 25 2.3.4 Installation Results . 29 2.3.5 Post-installation Notes . 31 2.4 Updating Firmware After Installation - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 31 2.5 Uninstalling Mellanox OFED- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 32 Chapter 3 Configuration Files . 33 Chapter 4 Driver Features . 34 4.1 RDMA over Converged Ethernet - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 34 4.1.1 RoCE Overview . 34 4.1.2 Software Dependencies. 34 4.1.3 Firmware Dependencies . 34 4.1.4 General Guidelines . 34 4.1.5 Ported Applications. 34 4.1.6 GID Tables . 35 4.1.7 Using VLANs . 35 4.1.8 Reading Port Counters Statistics. 36 4.1.9 A Detailed Example . 37 4.1.10 Configuring DAPL over RoCE. 42 4.2 Reliable Datagram Sockets - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 43 4.2.1 Overview. 43 4.2.2 RDS Configuration . 43 4.3 Sockets Direct Protocol - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 43 4.3.1 Overview. 43 4.3.2 libsdp.so Library . 44 4.3.3 Configuring SDP. 44 4.3.4 Environment Variables . 47 4.3.5 Converting Socket-based Applications. 47 Mellanox Techologies 1 4.3.6 BZCopy – Zero Copy Send . 54 4.3.7 Using RDMA for Small Buffers. 55 4.4 SCSI RDMA Protocol- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 55 4.4.1 Overview. ..