Open Fabrics Enterprise Distribution (OFED) Version 1.5.4 Release Notes December 2011 =============================================================================== Table of Contents =============================================================================== 1. Overview, which includes: - OFED Distribution Rev 1.5.4 Contents - Supported Platforms and Operating Systems - Supported HCA and RNIC Adapter Cards and Firmware Versions - Tested Switch Platforms - Third party Test Packages - OFED sources 2. Change log 3. Known Issues =============================================================================== 1. Overview =============================================================================== These are the release notes of OpenFabrics Enterprise Distribution (OFED) release 1.5.4. The OFED software package is composed of several software modules, and is intended for use on a computer cluster constructed as an InfiniBand subnet or iWARP network. Note: If you plan to upgrade the OFED package on your cluster, please upgrade all of its nodes to this new version. 1.1 OFED 1.5.4 Contents ----------------------- The OFED package contains the following components: - OpenFabrics core and ULPs: - IB HCA drivers (mthca, mlx4, qib, ehca) - iWARP RNIC driver (cxgb3, nes) - core - Upper Layer Protocols: IPoIB, SDP, SRP Initiator and target, iSER Initiator and target, RDS, uDAPL, qlgc_vnic and NFS-RDMA*. - OpenFabrics utilities: - OpenSM (OSM): InfiniBand Subnet Manager - Diagnostic tools - Performance tests - MPI: - OSU MPI stack supporting the InfiniBand and iWARP interface - Open MPI stack supporting the InfiniBand and iWARP interface - OSU MVAPICH2 stack supporting the InfiniBand and iWARP interface - MPI benchmark tests (OSU benchmarks, Intel MPI benchmarks, Presta) - Extra packages: - open-iscsi: open-iscsi initiator with iSER support - ib-bonding: Bonding driver for IPoIB interface - infinipath-psm: Performance-Scaled Messaging API, an accelerated interface to QLogic HCAs - Sources of all software modules (under conditions mentioned in the modules' LICENSE files) - Documentation Notes: 1. iSER Target and NFS-RDMA are of Beta quality. 2. All other OFED components are of production quality. 3. See release notes for each package in the docs directory. 4. Any Topspin copyright belongs to Cisco Systems, Inc. 1.2 Supported Platforms and Operating Systems --------------------------------------------- o CPU architectures: - x86_64 - x86 - ppc64 - ia64 o Linux Operating Systems: - RedHat EL5 up6 2.6.18-238.el5 - RedHat EL5 up7 2.6.18-274.el5 - RedHat EL6 2.6.32-71.el6 - RedHat EL6.1 2.6.32-131.0.15.el6 - RedHat EL6.2 2.6.32-220.el6 - SLES10 SP4 2.6.16.60-0.85.1-smp - SLES11 2.6.27.19-5-default - SLES11 SP1 2.6.32.12-0.7-default - Scientific Linux 6.1 2.6.32-131.0.15.el6 - kernel.org 2.6.30 - 3.0 * * Minimal QA for these versions 1.3 HCAs and RNICs Supported ---------------------------- This release supports IB HCAs by Mellanox Technologies, Qlogic and IBM as well as iWARP RNICs by Chelsio Communications and Intel. o Mellanox Technologies HCAs (SDR, DDR and QDR Modes are Supported): - ConnectX(R) and ConnectX EN (fw-25408 Rev 2.9.1000) - ConnectX-2 (fw-ConnectX2 Rev 2.9.1000) - ConnectX-2 EN (fw-ConnectX2 Rev 2.9.1000) - ConnectX-3 (fw-ConnectX3 Rev 2.10.0000) For official firmware versions please see: http://www.mellanox.com/content/pages.php?pg=firmware_download o Qlogic HCAs: - QLogic TrueScale DDR PCIe x8 and x16 HCAs - QLogic TrueScale QDR PCIe x8 Gen2 HCAs o IBM HCAs: - GX Dual-port SDR 4x IB HCA - GX Dual-port SDR 12x IB HCA - GX Dual-port DDR 4x IB HCA - GX Dual-port DDR 12x IB HCA o Chelsio RNICs: - S310/S320 10GbE Storage Accelerators - R310/R320 10GbE iWARP Adapters o Intel RNICs: - NE020 10Gb iWARP Adapter 1.4 Switches Supported ---------------------- This release was tested with switches and gateways provided by the following companies: - Qlogic - Flextronics - Oracle (Sun) - Mellanox 1.5 Third Party Packages ------------------------ The following third party packages have been tested with OFED 1.5.4: - Intel MPI, Version 3.2.2 - Intel MPI, Version 4.0 1.6 OFED Sources ---------------- All sources are located under git://git.openfabrics.org/ Kernel sources: git://git.openfabrics.org/ofed_1_5/linux-2.6.git ofed_kernel_1_5 User level Sources are downloaded from http://www.openfabrics.org/downloads/ as written in the BUILD_ID The kernel sources are based on Linux 2.6.30 mainline kernel. Its patches are included in the OFED sources directory. For details see HOWTO.build_ofed. The list of maintainers is available under: http://www.openfabrics.org/downloads/MAINTAINERS =============================================================================== 2. Change log =============================================================================== OFED-1.5.4 Main Changes from OFED 1.5.3.2 ------------------------------------------------------------------------------- 1. Add kernel 3.0 support 2. Add RHEL6.2 support 3. Add NFSRDMA to the list of packages to be installed by default on supported platforms 4. Add new InfiniBand link speeds: EDR/FDR/FDR10 5. OFA Kernel: See ofa_kernel.changelog.txt 6. Updated packages: libibverbs-1.1.4-1.24.gb89d4d7 libmlx4-1.0.1-1.20.g6771d22 libnes-1.1.3 libcxgb3-1.3.1 libcxgb4-1.2.0 dapl-2.0.34 ibacm-1.0.5 librdmacm-1.0.15 infinipath-psm-2.9-926.1005_open ibutils-1.5.7-0.1.g05a9d1a perftest-1.3.0-0.56.gd6f6093 mstflint-1.4-1.18.g1adcfbf Management: libibmad-1.3.8 infiniband-diags-1.5.12 opensm-3.3.12 MPI: mvapich2-1.7-5.2011svn5031 OFED-1.5.3.2 Main Changes from OFED 1.5.3.1 ------------------------------------------------------------------------------- 1. Add RHEL5.7 support 2. Add RHEL6.1 support 3. Add kernel.org 2.6.37 - 2.6.39 support 4. ib-bonding-0.9.0-43 (SLES10 SP4 support) OFED-1.5.3.1 Main Changes from OFED 1.5.3 ------------------------------------------------------------------------------- 1. Fix QIB support on SLES10 SP3 OFED-1.5.3 Main Changes from OFED 1.5.2 ------------------------------------------------------------------------------- 1. Updated packages: dapl-2.0.32 librdmacm-1.0.14.1 ibacm-1.0.4 libibmad-1.3.7 libibumad-1.3.7 infiniband-diags-1.5.8 opensm-3.3.9 ibutils-1.5.7 libibverbs-1.1.4-1.22.g7257cd3.tar.gz libmlx4-1.0.1-1.18.gb810a27.tar.gz libnes-1.1.1 infinipath-psm-1.14 libsdp-1.1.108-0.15.gd7fdb72 mstflint-1.4-0.9.gc683022 sdpnetstat-1.60-0.3.gb6e7425 perftest-1.3.0-0.42.gf350d3d - MPI openmpi-1.4.3-1 mvapich2-1.6-2 2. Added RHEL6 support 3. Added RHEL5.6 support 4. Improved RAW Ethernet QP support (requires ConnectX/ConnectX2 FW >= 2.8.0600) 5. NFSoRDMA was removed from the list of packages in the install script to prevent its installation by default. To force NFSoRDMA installation, add the following lines to the ofed.conf: nfsrdma=y rnfs-utils=y To get ofed.conf, run # ./install.pl -p After adding the lines above to ofed.conf, to install OFED run # ./install.pl -c ofed.conf OFED-1.5.2 Main Changes from OFED 1.5.1 ------------------------------------------------------------------------------- 1. Added RHEL5.5, SLES11 SP1 and kernel 2.6.33 support 2. /etc/modprobe.conf deprecated ib_ipoib use /etc/modprobe.d/ib_ipoib.conf ib_sdp use /etc/modprobe.d/ib_sdp.conf mlx4_en use /etc/modprobe.d/mlx4_en.conf 3. Added RAW Ethernet QP support in libibverbs 4. Added multicast support in perftest 5. Added new package: ibacm. See ibacm_release_notes.txt 6. Added new package infinipath-psm. 7. Updated packages: libibverbs to rev 1.1.4-0.14.gb6c138b libehca to rev 1.2.2-0.1.g69e1a88 libmlx4 to rev 1.0-0.13.g4e5c43f libnes to rev 1.1.0 librdmacm to rev 1.0.13 dapl to rev 2.0.30 compat-depl to rev 1.2.19 libsdp to rev 1.1.103 mstflint to rev 1.4-0.6.g63179f4 perftest to rev 1.3.0-0.27 rds-tools to rev 2.0.4 Management: opensm to rev 3.3.7 libibmad to rev 1.3.6 libibumad to rev 1.3.6 infiniband-diags to rev 1.5.7 MPI: openmpi to rev 1.4.2-1 mvapich2 to rev 1.5.1-2.p1 mpitests to rev 3.2-923 OFED-1.5.1 Main Changes from OFED 1.5 ------------------------------------------------------------------------------- 1. Added RoCEE support - see RoCEE_README.txt 2. Added enhanced atomic operations to ConnectX (kernel only). See mlx4_release_notes.txt. 3. Updated Open MPI to rev 1.4.1-2ofed 4. Updated MVAPICH2 to rev 1.4.1 5. Updated DAPL to rev 2.0.27 6. Updated libnes to rev 1.0.1 7. Updated librdmacm to rev 1.0.11 8. Removed tvflash RPM 9. NFS-RDMA is not supported on SLES10 SP3 10. Fixed IPv6 support and IPv4 routing corner cases for RDMA CM 11. Bug fixes OFED-1.5 Main Changes from OFED 1.4.2 ------------------------------------------------------------------------------- Note: For details regarding the various changes, please see the release notes for each package in the docs directory. 2.1 General changes o Kernel code based on 2.6.30 o libraries location - all userspace libraries can be downloaded from http://www.openfabrics.org/downloads/ See BUILD_ID for exact locations o Qlogic moved the low level driver from ipath to qib. 2.2 SDP o Performance improvements o Zero copy in beta level 2.3 uDAPL o New UCM provider (ofa-v2-mlx4_0-1u) with IB UD-based CM per process. It is more scalable than rdma_cm (cma) or socket cm (scm). o Common code base with WinOF 2.1 o Bug fixes 2.4 perftest o Renamed tests: ib_rdma_bw -> rdma_bw ib_rdma_lat -> rdma_lat 2.5 Management o OpenSM - Support for Mesh Analysis for LASH routing algorithm - Reloadable OpenSM configuration (preliminary implementation) - Routing paths sorted balancing (for UpDown and MinHops) - Weighted LID matrices calculation (for UpDown, MinHop and DOR) - I/O nodes connectivity (for FatTree) 2.6 MPI: a. OSU MVAPICH 1.2.0 b. Open MPI 1.4 c. OSU MVAPICH2 1.4 d. MPI tests 3.2 2.7 iSER: o Available on: - kernel.org: 2.6.30 and higher - RHEL5.4 2.8 NFS-RDMA o Added support for RHEL5.4, SLES10 SP3, kernel.org 2.6.25 and 2.6.30. Kernels 2.6.26 and 2.6.27 are not supported o NFS-RDMA is in Beta level =============================================================================== 3. Known Issues =============================================================================== The following is a list of general limitations and known issues of the various components of the OFED 1.5.4 release. 1. When upgrading from an earlier OFED version, the installation script does not stop the earlier OFED version prior to uninstalling it. Workaround: Stop the old OFED stack (/etc/init.d/openibd stop) before upgrading to OFED 1.5.3 or reboot the server after OFED installation. 2. Memory registration by the user is limited according to administrator setting. See "Pinning (Locking) User Memory Pages" in OFED_tips.txt for system configuration. 3. Fork support from kernel 2.6.12 and above is available provided that applications do not use threads. fork() is supported as long as the parent process does not run before the child exits or calls exec(). The former can be achieved by calling wait(childpid), and the latter can be achieved by application specific means. The Posix system() call is supported. 4. The qib driver is supported only on 64-bit platforms. 5. When installing OFED on OpenSuse or Ubuntu, use the --without-depcheck option of the install.pl script. 6. IPoIB: brctl utilities do not work on IPoIB interfaces. The reason for that is that these utilities support devices of type Ethernet only. 7. "openibd stop" can sometime fail with the error: Unloading ib_cm [FAILED] ERROR: Module ib_cm is in use by ib_ipoib Workaround: run "openibd stop" again or remove ib_ipoib aliases from /etc/modprobe.d/ib_ipoib.conf. 8. When working with ISCSI over IPoIB or mlx4_en, you must disable LRO (even if IPoIB is set to connected mode). This is due to a bug in older kernels which causes a kernel panic. 9. On SLES11, and in case uninstall is failing, check the error log and remove the remaining RPMs manually using 'rpm -e '. 10. On SLES11, set allow_unsupported_modules parameter to 1 in file: /etc/modprobe.d/unsupported-modules. Without this the modules will not load. Note: See the release notes of each component for additional issues.