Intel® Omni-Path Fabric Host Software — User Guide
Total Page:16
File Type:pdf, Size:1020Kb
Intel® Omni-Path Fabric Host Software User Guide Rev. 16.0 January 2020 Doc. No.: H76470, Rev.: 16.0 You may not use or facilitate the use of this document in connection with any infringement or other legal analysis concerning Intel products described herein. You agree to grant Intel a non-exclusive, royalty-free license to any patent claim thereafter drafted which includes subject matter disclosed herein. No license (express or implied, by estoppel or otherwise) to any intellectual property rights is granted by this document. All information provided here is subject to change without notice. Contact your Intel representative to obtain the latest Intel product specifications and roadmaps. The products described may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Intel technologies’ features and benefits depend on system configuration and may require enabled hardware, software or service activation. Performance varies depending on system configuration. No computer system can be absolutely secure. Check with your system manufacturer or retailer or learn more at intel.com. Intel, the Intel logo, Intel Xeon Phi, and Xeon are trademarks of Intel Corporation in the U.S. and/or other countries. *Other names and brands may be claimed as the property of others. Copyright © 2015–2020, Intel Corporation. All rights reserved. Intel® Omni-Path Fabric Host Software User Guide January 2020 2 Doc. No.: H76470, Rev.: 16.0 Revision History—Intel® Omni-Path Fabric Revision History Date Revision Description January 2020 16.0 Updates to this document include: • Updated links to Intel® Omni-Path documentation set in Intel® Omni-Path Documentation Library. • Renamed section from IB Bonding to IPoIB Bonding. • Updated instructions for Create RHEL* IB Bonding Interface Configuration Script and Create SLES* IB Bonding Interface Configuration Script • Updated Running MPI Applications with Intel® MPI Library as TMI has been deprecated in Intel MPI 2019. • Removed information for running MPI over IPoIB in Running Open MPI Applications. • Updated publication link in Intel® Omni-Path Driver and PSM2 Support for GPUDirect*. • Added link to Configuring Non-Volatile Memory Express* (NVMe*) over Fabrics on Intel® Omni-Path Architecture Application Note in Non-Volatile Memory (NVM) Express* over Fabrics. October 2019 15.0 Updates to this document include: • Updated Preface to include new Best Practices. • Removed Chapter Using Sandia* OpenSHMEM and globally removed SHMEM throughout document; it is no longer supported. • Updated multi-rail information in Multi-Rail Support in PSM2. • Updated opaconfig to add ARPTABLE_TUNING question to -- answer option. June 2019 14.0 Updates to this document include: • Added new Troubleshooting section: Viewing IPoIB Hardware Addresses. March 2019 13.0 Updates to this document include: • Updated CLI command opaconfig to remove -r root option. • In the Update Existing Exports File and RDMA Configuration File section, corrected the instructions for updating the rdma.conf file, correcting the port number information in Step 2 to 20049. February 2019 12.0 Updates to this document include: • Updated the following CLI commands: — opaautostartconfig — opaconfig December 2018 11.0 Updates to this document include: • Added new CLI command: opasystemconfig • Updated opaconfig • Updated opasaquery September 2018 10.0 Updates to this document include: • Global change: Removed Verbs-only builds for Open MPI and MVAPICH2 (gcc) as well as those built with the Intel compiler for Open MPI and MVAPICH2. • Changed all textual references of OpenMPI to Open MPI • Updated Intel Omni-Path Architecture Overview. continued... Intel® Omni-Path Fabric Host Software January 2020 User Guide Doc. No.: H76470, Rev.: 16.0 3 Intel® Omni-Path Fabric—Revision History Date Revision Description • Updated the following CLI commands: — opaconfig — opaportconfig — opaportinfo — opasaquery — opasmaquery April 2018 9.0 Updates to this document include: • Removed section SHMEM Description and Configuration • Minor text updates in Introduction • Updated Installed Layout • Updated Configuring IPoIB Driver • Updated IB Bonding Interface Configuration Scripts and instructions found in Create RHEL* IB Bonding Interface Configuration Script and Create SLES* IB Bonding Interface Configuration Script • Updated IBM* Platform* MPI • Added Using PSM2 Features for GPUDirect*. • Updated section Multiple Bandwidth / Message Rate Test • Added new CLI command: hfi1_eprom • Updated the following CLI commands: — opaautostartconfig — opaconfig — opapacketcapture — opapmaquery — opaportconfig — opasaquery — opasmaquery • Removed opatmmtool. October 2017 8.0 Updates to this document include: • Added IPv4/IPv6 Dual Stack Support • Added new chapter Using Sandia* OpenSHMEM • Added Descriptions of Command Line Tools including the following CLI tools: opa-arptbl-tuneup, opaautostartconfig, opa- init-kernel, opa_osd_dump, opa_osd_exercise, opa_osd_perf, opa_osd_query, opacapture, opaconfig, opafabricinfo, opagetvf, opagetvf_env, opahfirev, opainfo, opapacketcapture, opapmaquery, opaportconfig, opaportinfo, oparesolvehfiport, opasaquery, opasmaquery, and opatmmtool • Updated the following CLI commands: — opaconfig — opasaquery August 2017 7.0 Updates to this document include: • Updated section PSM2 Compatibility • Updated section Intel MPI Library • Updated appendix hfidiags User Guide April 2017 6.0 Updates to this document include: • Added Intel Omni-Path Documentation Library to Preface. • Added Intel Omni-Path Architecture Overview • Updated sections Intel Omni-Path Software Overview and Host Software Stack • Updated Intel Distributed Subnet Administration • Updated Multi-Rail Support in PSM2 continued... Intel® Omni-Path Fabric Host Software User Guide January 2020 4 Doc. No.: H76470, Rev.: 16.0 Revision History—Intel® Omni-Path Fabric Date Revision Description • Updated Configuring IPoIB Driver • Updated Running MPI on Intel Omni-Path Host Fabric Interfaces • Updated Using Other MPIs • Added IBM* Platform* MPI • Added Using NFS Over RDMA with Intel OPA Fabrics • Added Intel Omni-Path Driver and PSM2 Support for GPUDirect* • Added Non-Volatile Memory (NVM) Express* over Fabrics • Default MTU size is changed from 8K to 10K • Globally, updated the following filepaths: — from /usr/lib/opa-fm/samples/ to /usr/share/opa-fm/ samples/ — from /usr/lib/opa-fm/etc/opafm* to /usr/lib/opa- fm/bin/opafm* — from /etc/sysconfig/opafm.xml to /etc/opa-fm/ opafm.xml — from /etc/sysconfig/* to /etc/* — from /usr/lib/opa/ to /usr/share/opa/ — from /usr/lib/opa/src/* to /usr/src/opa/* December 2016 5.0 Updates to this document include: • Added sections Intel Omni-Path Architecture Overview, Intel Omni- Path Software Overview, and Host Software Stack. • Multi-Rail Support in PSM2: clarified behavior when PSM2_MULTIRAIL is not set in multiple fabrics. Added Multi-Rail Overview section. • Added hfidiags User Guide (moved from Software Installation Guide to this document). • Globally, updated the following filepaths: — from /opt/opa to /usr/lib/opa — from /var/opt/opa to /var/usr/lib/opa — from /opt/opafm to /usr/lib/opa-fm — from /var/opt/opafm to /var/usr/lib/opa-fm • Added Cluster Configurator for Intel Omni-Path Fabric to Preface. August 2016 4.0 Updates to this document include: • Added Setting up Open MPI with SLURM. • Removed pre-built PGI* MPIs from "Installing University of Houston OpenSHMEM" section. The PGI* compiler is supported, however, pre-built PGI* MPIs are not included in the software package. • Added Intel Omni-Path Routing Features and Innovations. May 2016 3.0 Global updates to document. February 2016 2.0 Global updates to document. November 2015 1.0 Global updates to document. Intel® Omni-Path Fabric Host Software January 2020 User Guide Doc. No.: H76470, Rev.: 16.0 5 Intel® Omni-Path Fabric—Contents Contents Revision History..................................................................................................................3 Preface............................................................................................................................. 12 Intended Audience..................................................................................................... 12 Intel® Omni-Path Documentation Library.......................................................................12 How to Search the Intel® Omni-Path Documentation Set........................................ 14 Cluster Configurator for Intel® Omni-Path Fabric.............................................................15 Documentation Conventions........................................................................................ 15 Best Practices............................................................................................................ 16 License Agreements....................................................................................................16 Technical Support.......................................................................................................16 1.0 Introduction................................................................................................................17 1.1 Intel® Omni-Path Architecture Overview.................................................................. 17 1.1.1 Host Fabric Interface................................................................................. 19 1.1.2 Intel® OPA Switches..................................................................................19