12.1.0.1 Release Notes
Preface
This document provides an overview of the changes introduced in this release. References to more detailed information are provided where necessary. The information contained in this document is intended as supplemental information only; it should be used in conjunction with the documentation provided for each component.
Software License Agreement
The software is provided under license agreements and may contain third-party software under separate third-party licensing. Refer to the license files provided with the software for specific details.
If You Need Help
Technical support for all Cornelis products is available 24 hours a day, 365 days a year.
For additional details:
Visit the Cornelis Support page at http://www.cornelisnetworks.com/support
Contact email: support@cornelisnetworks.com
Release Compatibility
This release is backward compatible with the most recent minor release version. For example, Release 12.N is backward compatible with Release 12.N-1 and Release 12.N-1.x.
New in This Release
The following features are new in this release:
Support for new Operating Systems: RHEL/Rocky Linux 9.7 and 10.0
Single Root I/O Virtualization (SR-IOV)
Maintenance Updates
Release Items
The following software package is available for this release:
CN5000_OPXSoftware-<DISTRO>-12_1_0_1-4.tgz
Note
OS RPMs may need to be installed prior to software installation. Dependencies will be flagged during installation.
The following table lists meta package files provided for this release.
RPM Name | Description |
|---|---|
RHEL and SLES | |
cn5000_pkgs_cuda_meta-12_1_0_1-4.x86_64.rpm | CN5000 Meta Package containing all of the required CUDA RPMs |
cn5000_pkgs_non_gpu_meta-12_1_0_1-4.x86_64.rpm | CN5000 Meta Package containing all of the required RPMs |
cn5000_pkgs_rocm_meta-12_1_0_1-4.x86_64.rpm | CN5000 Meta Package containing all of the required ROCm RPMs |
Ubuntu | |
cn5000-pkgs-cuda-meta_12.1.0.1.4-amd64.deb | CN5000 Meta Package containing all of the required CUDA DEBs |
cn5000-pkgs-non-gpu-meta_12.1.0.1.4-amd64.deb | CN5000 Meta Package containing all of the required DEBs |
cn5000-pkgs-rocm-meta_12.1.0.1.4-amd64.deb | CN5000 Meta Package containing all of the required ROCm DEBs |
Refer to Appendix G, Release Package Manifest for the list of RPM and DEB files provided in this release.
System Requirements
This section lists the compatible operating systems and supported hardware.
Operating Systems
This release of the CN5000 OPX Software supports the operating systems listed in the following table.
Operating System | Base Kernel Version |
|---|---|
RHEL 9.4 | 5.14.0-427.13.1el9_4.x86_64 |
RHEL 9.5 | 5.14.0-503.11.1.el9_5.x86_64 |
RHEL 9.6 | 5.14.0-570.12.1.el9_6.x86_64 |
RHEL 9.7 | 5.14.0-611.5.1.el9_7.x86_64 |
RHEL 10.0 | 6.12.0-55.9.1.el10_0.x86_64 |
Rocky Linux 9.5 | 5.14.0-503.14.1.el9_5.x86_64 |
Rocky Linux 9.6 | 5.14.0-570.17.1el9_6.x86_64 |
Rocky Linux 9.7 | 5.14.0-611.5.1.el9_7.x86_64 |
Rocky Linux 10.0 | 6.12.0-55.12.1.el10_0.x86_64 |
SLES 15 SP7 | 6.4.0-150700.53.22.1-default |
Ubuntu 24.04 LTS | 6.8.0-90-generic |
Note
AMD ROCm versions 6.4.1 and onward are not supported on RHEL/Rocky 9.5. Refer to the ROCm Compatibility Matrix.
Supported Hardware
The following tables list the hardware supported in this release.
Hardware | Description |
|---|---|
CN5000 Switch | |
CN5000 Switch, 48-Port, CN5SWE48G2AF | 240/277 VAC in, Dual Power Supply, Air-Cooled, Fan-to-Port |
CN5000 Switch, 48-Port, CN5SWE48G2AP | 240/277 VAC in, Dual Power Supply, Air-Cooled, Port-to-Fan |
CN5000 Switch, 48-Port, CN5SWE48G2WF | 240/277 VAC in, Dual Power Supply, Liquid-Cooled, Fan-to-Port |
CN5000 Switch, 48-Port, CN5SWE48G2WP | 240/277 VAC in, Dual Power Supply, Liquid-Cooled, Port-to-Fan |
CN5000 Switch, 48-Port, CN5SWE48D2AP | 48 VDC in, Dual Power Supply, Air-Cooled, Port-to-Fan |
CN5000 Switch, 48-Port, CN5SWE48D2WP | 48 VDC in, Dual Power Supply, Liquid-Cooled, Port-to-Fan |
CN5000 Director Class Switch and Components | |
CN5000 Director Class Switch, 12 Leaf Slots, CN5SWD12KAB | 240/277 VAC in, Air-Cooled, Base Chassis |
CN5000 Director Class Switch, 12 Leaf Slots, CN5SWD12KAC | 240/277 VAC in, Air-Cooled, FRU Chassis |
CN5000 Director Class Switch, Leaf QSFP112 Module, CN5SWDLQ48A | 48-Port, Air-Cooled |
CN5000 Director Class Switch, Spine Module, CN5SWDSP01A | Air-Cooled |
CN5000 Director Class Switch, 12 Leaf Slots, CN5SWD12KWB | 240/277 VAC in, Liquid-Cooled, Base Chassis |
CN5000 Director Class Switch, 12 Leaf Slots, CN5SWD12KWC | 240/277 VAC in, Liquid-Cooled, FRU Chassis |
CN5000 Director Class Switch, Leaf QSFP112 Module, CN5SWDLQ48W | 48-Port, Liquid-Cooled |
CN5000 Director Class Switch, Spine Module, CN5SWDSP01W | Liquid-Cooled |
Hardware | Description |
|---|---|
CN5000 SuperNIC, CN5HFA2D5ALS | Dual Port, QSFP-DD, x16 PCIe Gen 5, Air-Cooled, Low Profile, Single |
CN5000 SuperNIC, CN5HFA1Q5ALS | Single Port, QSFP, x16 PCIe Gen 5, Air-Cooled, Low Profile, Single |
CN5000 SuperNIC, CN5HFA1Q5NLS | Single Port, QSFP, x16 PCIe Gen 5, Conduction-Cooled, Low Profile, Single |
Hardware | Description |
|---|---|
CPUs | |
4th Gen AMD EPYC Processor | Genoa Zen 4 CPU-based servers |
5th Gen AMD EPYC Processor | Turin Zen 5 CPU-based servers |
4th Generation Intel Xeon Scalable Processor | Sapphire Rapids CPU-based servers |
5th Generation Intel Xeon Scalable Processor | Emerald Rapids CPU-based servers |
GPUs | |
AMD Instinct MI Series GPU | AMD Instinct MI300X and MI200 series Graphic Processing Units |
NVIDIA GPUs | NVIDIA Tesla V100 and later |
Installation Requirements
Refer to the CN5000 Fabric Installation Guide for related software requirements and complete installation procedures.
Best Practices
To obtain the most recent functional and security updates, Cornelis recommends that you download and install the latest versions of the CN5000 Omni-Path software and firmware. Software and Documentation are found in the Cornelis Customer Center.
To ensure optimal performance in your CN5000 fabric, it is important to review the Cornelis performance tuning recommendations in the CN5000 Performance Tuning Guide.
Disable the Repository After OPX Software Installation
Required for RHEL 9.5.
After installing or updating the OPX Software, disable the repository on every node using one of the following methods:
Run the following command:
sudo dnf config-manager --set-disabled <repo>
In the repository file, change
enableto0.
Issues
This section lists the resolved and open issues.
Resolved Issues
The following table lists issues that are resolved in this release.
ID | Description | Resolved in Release |
|---|---|---|
STL-76376 | Kernel crash may occur when hfi1 module is loaded with | 12.1.0.1 |
STL-76375 | MPI or middleware using the OPX Libfabric Provider may experience unreliable results. | 12.1.0.1 |
STL-76373 | Benign hfi1 messages relating to MCTXT interrupt in kernel logs can be ignored. | 12.1.0.1 |
STL-75066 | If IPv6 is enabled on any IPoIB interfaces, the FM sweeps constantly due to changes in multicast group membership. | 12.1.0 |
STL-74951 STL-74672 | On rare occasions, application hangs with an SDMA engine error in DMSG have been observed. | 12.1.0 |
STL-74696 | When running an NVIDIA GPU Cloud (NGC) container such as the "NVIDIA HPC-Benchmarks" package, a segmentation fault may occur. | 12.1.0 |
STL-74672 | On rare occasions, application hangs with an SDMA engine error in DMSG have been observed. | 12.1.0 |
STL-74234 | The mvapich2 packages provided with OPX Software should be ignored and not used. | 12.1.0 |
STL-74218 | IPoIB interfaces on CN5000 currently do not support failover with the Channel Bonding driver in the Linux kernel. | 12.1.0 |
STL-73861 | Hangs occur when using NVMe over Fabric. | 12.1.0 |
STL-73759 | When the FM restarts, different LIDs may get assigned to the nodes. | 12.1.0 |
STL-73267 | When running the | 12.1.0 |
STL-73245 | CN5000 Switch-Switch links do not appear in either | 12.1.0 |
STL-72864 | High CPU utilization seen for hfi1 related interrupts, potentially impacting performance. | 12.1.0 |
STL-72815 |
| 12.1.0 |
STL-72640 | In some cases the dmesg log may contain a message stating:
| 12.1.0 |
STL-72575 | TID updates under heavy load may result in an | 12.1.0 |
STL-72572 | In | 12.1.0 |
STL-72547 | Class Port Info queries are not reporting properly. | 12.1.0 |
Open Issues
The following tables list the open issues for this release.
ID | Description | Workaround |
|---|---|---|
STL-76348 | Running | None. |
STL-76263 | In some circumstances, rebooting a host may cause a panic. | Power cycle the system. |
STL-76222 | Memory overflow may occur when running MVAPICH on Ubuntu platforms. | Set MVP_ENABLE_AFFINITY=0. |
STL-76218 | Crashes may occur when SuperNIC ports have inconsistent | Ensure that |
STL-76144 | Setting the link speed policy to 100G in the opafm.xml file results in the following Fabric Manager error: Invalid Value for Link Speed Policy: 100G | Set the link speed using the Switch CLI command |
STL-76137 | Open MPI traffic fails on SR-IOV Virtual Function devices. | Use the |
STL-76135 | When using SR-IOV, jobs running high processes per node (PPN) may fail on virtual machines with limited resources. | Ensure that the virtual machine is provisioned with at least twice the number of virtual CPUs as the desired number of processes to be run. |
STL-76131 | When using SR-IOV, the dmesg log in the VMs may occasionally show the following warning message: memcpy: detected field-spanning write | Do not run Omni-Path management tools, such as |
STL-76108 | SR-IOV Virtual Function devices on CN5000 cannot query the Subnet Administration. | Do not run tools such as |
STL-75568 | Performance test failures may occur when running ib_send_bw and ib_read_bw with the | Do not use the |
STL-75555 | Errors can occur when installing Ubuntu meta-packages with | Use one of the following:
|
STL-75535 | GADGET4 MPI application hangs with OPX Provider. | Set |
STL-75526 | After installing the OPX Software package on Ubuntu, the opafm service is enabled by default. | Manually disable the opafm service by default. |
STL-75484 | Running | To drop and reinitialize a link, use the Alternately, if |
STL-75395 | When | Disable |
STL-75394 | On some systems running Ubuntu 24.04, the hfi1 driver may fail to start when it is unloaded and reloaded. The system log will contain a message saying | If this message is seen, unload and reload the hfi1 driver again. |
STL-75362 | When using the TCP provider of libfabric, some MPI application may perform poorly or hang when launched with 1 process per core. This has been observed in benchmarks such as OSU Congestion, OSU Collectives, and IMB P2P. | For best results, users should use the OPX provider whenever available. OPX can be explicitly selected by setting the environment variable, |
STL-75331 | Using RDMA Core persistent names with settings other than KERNEL will result in RCCL segmentation faults. | Perform the following:
|
STL-75322 | Upon reverting from 12.0.3 to a previous RHEL/Rocky release certain packages may not be removed. | Use the following command to remove the remaining packages: dnf remove ibacm infiniband-diags libfabric libhfi1verbs libibumad libibverbs libpsm2 librdmacm librdmacm-utils mpi-selector opa-basic-tools opa-fastfabric opa-fm opa-libopamgt rdma-core rdma-core-devel srp_daemon |
STL-75031 | MPI RMA benchmarks may produce an SDMA error (bad address) when using the OPX libfabric provider and environment variable FI_OPX_MIXED_NETWORK=0. | Set FI_OPX_MIXED_NETWORK=1. |
STL-74968 | Updating the Fabric Manager using DNF may not succeed even though an update is available. | Perform the following:
|
STL-74933 | Entries of the form | These messages can be ignored. |
STL-74679 | While running IPoIB in Connected mode, application hangs have been observed. | Configure IPoIB to Datagram mode and rerun the application. |
STL-74625 | When using both ports of a dual-port SuperNIC, the | Use |
STL-74593 | The Quantum Espresso application with Intel MPI may abort with SIGABRT when executed with a higher number of MPI ranks than available user HFI contexts and multiple endpoints per HFI context (FI_OPX_ENDPOINTS_PER_HFI_CONTEXT=2) | Set FI_OPX_ENDPOINTS_PER_HFI_CONTEXT=1 and reduce the number of MPI ranks to be less than or equal to the number of available HFI user contexts. |
STL-74504 | Occasional drops in bandwidth observed during microbenchmark testing. | Refer to the Performance Tuning Guide for platform-specific tuning. |
STL-74477 | Building opxs-kernel-updates from the src.rpm file fails with | Use an environment variable to allow the header file to be detected and used in the build: NVIDIA_DIR=$(ls -d /usr/src/nvidia-* | head -1)
ln -s ${NVIDIA_DIR}/nvidia /usr/src/kernels/5.14.0-503.14.1.el9_5.x86_64/include/nvidiaNote that the exact directory required for the symbolic link will depend on your kernel version. |
STL-74230 | IPoIB interfaces on CN5000 currently do not support failover with the Channel Bonding driver in the Linux kernel. | No workaround. |
STL-74025 | When using IPoIB on CN5000, SuperNICs do not change MTU or join MC groups automatically. | Use the |
STL-73928 | HFI links bounce and the SM reports mapping warnings following the second FM restart. | No Workaround. Links that bounce recover and the fabric stabilizes. |
STL-73738 | Reloading the ipoib kernel module without also reloading the hfi1 module may cause FM errors. | To avoid this, always reload the hfi1 module along with the ipoib module. |
STL-73716 | The | Ignore the congestion flag. |
STL-73714 | Performing an | Counter values in this scenario should be ignored. |
STL-73713 | In a fabric with no data traffic, the Xmit Time Congestion port counter will increment. | No workaround. |
STL-73709 | The | No workaround. |
STL-73669 | Executing | The message may be ignored. |
STL-73531 | Configuring more than two data VLs is not currently supported. Doing so may lead to incorrect mappings of SC to VL. | Limit the number of configured data VLs to two. |
STL-73330 | Some LS-DYNA R14.1.0. benchmarks hang with Open MPI when using the OPX Provider for libfabric. | Set the environment variable FI_OPX_RELIABILITY_SERVICE_USEC_MAX=5000. |
STL-73215 | When running | Use |
STL-73160 | The comments in the Adaptive Routing section of the opafm.xml file do not explain which settings are required for MGAR or for FGAR. | Currently the only field related to FGAR is
All other fields are related to legacy MGAR and will be ignored if |
STL-73140 | The following CN5000 commands do not work as expected:
| Note the following:
|
STL-72673 | OS-release file captured by opacapture is empty. | Use |
STL-72649 | An Open MPI error may occur when using | Contact support@cornelis.com. |
STL-72583 | In some cases the dmesg log may contain a message stating:
| This is cosmetic and will not affect functionality. |
STL-72573 | Hangs and errors have been seen in the OSU alltoall collective test when using the OPX Provider to libfabric with ROCm. | No workaround. |
STL-72541 | Running the | These errors can be ignored. |
STL-72536 STL-72537 | CableInfo errors encountered when using the | Cable information reporting not currently supported. |
STL-72526 | The Fabric Manager system log port numbering is different from Switch CLI command port numbering. | The port number used by the FM is equivalent to twice the switch CLI port name minus one. Contact Cornelis Customer Support for details. |
STL-72523 | Errors occur on RHEL 9.5 after installation of meta package. | Refer to Disable the Repository After OPX Software Installation. |
STL-72431 | The command | Use |
STL-72420 | On some versions of RHEL 9.x, there is a known failure (rdmavt driver deadlock.) recorded in https://issues.redhat.com/browse/RHEL-83851. NOTE: Cornelis has not replicated this problem but it is possible that customers may be affected. | No workaround. |
STL-72205 | FI_OPX_HFI_SELECT=[] does not correctly map to the available adapter in the case in which other adapters in the system have been disabled. | Unload and reload the driver. |
STL-72160 | After uninstalling the meta packages with a package manager, several Cornelis Networks packages remain. | Refer to the CN5000 Maintenance and Troubleshooting Guide, “Remove OPX Software from a Host” for removal of the remaining packages. |
STL-71364 STL-72423 | Some legacy Omni-Path host utilities have been deprecated for CN5000 but are still supported for OPA100. | For a list of commands supported for CN5000, refer to the Man Pages or CN5000 Commands Guide. |
STL-70422 | RCCL hangs on AMD GPUs with opx and aws-ofi-rccl plugin. | Use Verbs over OPX Provider when using RCCL. |
STL-67178 | After boot, the OPX Software hfi1-NVIDIA support is not available. | Review boot configuration to ensure that nvidia-driver will be available when hfi1 is loaded. |
Product Limitations
This release has the following limitations:
Bulk Transfer Service is not available on port 1 of dual port SuperNIC cards.
When running MVAPICH3 with the OPX provider of libfabric, a
*** buffer overflow detected ***error may cause the job to terminate. This issue has been observed when running with a high number of processes, particularly when using 1 process per core (that is, the maximum number of processes the system can support). A workaround is to set environment variable,MV2_ENABLE_AFFINITY=0to disable CPU affinity.Queries to single port adapters will reflect that there are two ports with the first port always showing as offline.
Running of MPI jobs across both CN5000 and OPA100 components in hybrid fabrics (fabrics where CN5000 and OPA100 are connected) is not presently supported.
In the opafm.xml file, the default HFI port for fm0 must be set to "2" for proper operation:
<Name>fm0</Name> <Hfi>1</Hfi> <Port>2</Port>Non-default
MinShareVLMemandDedicatedVLMemvalues are not supported. Only use default values.FM Failover is presently not supported. Use a single Fabric Manager.
NVMe over Fabric is currently not supported.
Some distros versions may ship with ib_qib driver enabled. This driver is incompatible with the CN5000 OPX Software and may result in errors such as
disagrees about version of symbolin logs. Setblacklist ib_qib.During link bring up on a mixed OPA100/CN5000 fabric the FM log may show "Mismatch/Unable to set SCVL_t Map" warnings and link bounces may be observed as the fabric comes up. These messages and link bounces are expected on mixed fabrics and do not indicate a fault.
Enabling vFabrics with QoS results in Neighbor Mismatch/Unable to set SCVL_nt Map and Failed to init SL Maps in the log, and port bounces. There is no workaround. Port bounces are part of the standard recovery mechanism. These messages should only occur once and only when there is a change in the SCVL maps.
opainfo displays a single port adapter as a dual port adapter. No workaround. This is informational.
Ubuntu server fails to boot with more than one CN5000 SuperNIC installed. Ubuntu platforms cannot host multiple SuperNICs.
Bulk Transfer Service (BTS, bulksvc) is not supported on GPU platforms.
MVAPICH-Plus 4.1 for GPU is not supported.