Skip to main content

Cornelis Technical Documentation

12.4.0

Download PDF

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:

New in This Release

The following features are new in this release:

  • Maintenance Updates

Firmware Components

This release contains the firmware components listed in the following table.

Firmware Components

Description

File Name

Version

BMC Firmware

CN5000.BMCFirmware-12.4.0.0.10.pkg

12.4.0



System Requirements

This section lists the supported hardware.

Supported Hardware

The following tables list the hardware supported in this release.

Switch Products

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



Installation Requirements

Refer to the CN5000 Maintenance and Troubleshooting Guide for instructions to update the switch firmware.

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.

Issues

This section lists the resolved and open issues.

Resolved Issues

The following table lists issues that are resolved in this release.

Issues Resolved in this Release

ID

Description

Resolved in Release

STL-76775

Ports that have been disabled may be re-enabled after a reboot of the switch.

12.4.0



Open Issues

The following table lists the open issues for this release.

Open Issues

ID

Description

Workaround

STL-78122

After restarting the Fabric Manager, the switch does not rejoin IPoIB multicast groups.

Restart IPoIB on the switch by disabling and re-enabling it:

network ib --disable
network ib --enable

STL-77842

nmap port scan of IPoIB address causes switch instability.

Do not run nmap port scan against the switch over the IPoIB network.

STL-77720

The switch IPoIB interface (ib0) fails to establish carrier and remains down when the fabric's default multicast group MTU is configured above 4096 bytes (for example, 10K MTU for Accelerated IP/AIP support).

None.

STL-77407

Unable to delete IPoIB IPv6 address after adding it.

None.

STL-76677

When removing SSH keys, partial matches of the comment could remove more keys than intended.

When removing an SSH key, use the entire comment of the key.



Product Limitations

This release has the following product limitations:

  • The OpenBMC Web User Interface is not supported.

  • Updating the switch components (BMC/ASIC) in-band with the firmware update tool fails if the switch is running firmware older 12.2.x. You must update the firmware to 12.2 or greater before using in-band firmware updates.

Download PDF

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:

New in This Release

The following features are new in this release:

  • Maintenance Updates

Firmware Components

This release contains the firmware components listed in the following table.

Firmware Components

Description

File Name

Version

Firmware Update Tool (includes updateAgent)

CN5000_FW_UPDATE_Agent-12.4.0.0.7.tgz

12.4.0



System Requirements

This section lists the supported hardware.

Supported Hardware

The following tables list the hardware supported in this release.

SuperNIC Products

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



Installation Requirements

Refer to the CN5000 Maintenance and Troubleshooting Guide for instructions to update the switch firmware.

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.

Issues

This section lists the resolved and open issues.

Resolved Issues

The following table lists issues that are resolved in this release.

Issues Resolved in this Release

ID

Description

Resolved in Release

STL-72988

STL-72556

When updating firmware in a CN5000 SuperNIC in a management node, updateAgent times out when the FM is running at the same time.

12.4.0



Open Issues

The following table lists the open issues for this release.

Open Issues

ID

Description

Workaround

STL-77756

After updating the SuperNIC firmware using updateAgent, one or more SuperNIC cards in a multi-card system may remain in a "Pending" firmware state following an AC power cycle. Additional AC power cycles do not resolve the issue.

Re-run the updateAgent firmware update on the affected SuperNIC card(s).

To help ensure all cards complete the firmware update on the first attempt, fully power off the system (not just a power cycle) and wait at least one minute before powering back on, allowing all card capacitors to fully discharge.

STL-75609

The updateAgent tool may become stuck when downgrading SuperNIC firmware.

Use updateAgent -f when downgrading firmware.

STL-73195

When updating the SuperNIC firmware using updateAgent -v, the following error may occur:

While waiting for a response to PLDM type 05 and command code 14, a message with type 05 and command 15 was received 

Retry the updateAgent -v command.



Product Limitations

None.

Download PDF

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:

New in This Release

The following features are new in this release:

  • Automatic Context Sharing

    Refer to the CN5000 Performance Tuning Guide for details.

  • One-Sided RMA Acceleration over HFI Service (HFISVC)

    Refer to the CN5000 Performance Tuning Guide for details.

  • Maintenance Updates

Release Items

The following software package is available for this release:

CN5000_OPXSoftware-<DISTRO>-12.4.0.0.16.tgz

The following table lists meta package files provided for this release.

Note

OS RPMs may need to be installed prior to software installation. Dependencies will be flagged during installation.

Meta Packages

RPM Name

Description

RHEL and SLES

cn5000_pkgs_cuda_meta-12_4_0_0-16.x86_64.rpm

CN5000 Meta Package containing all of the required CUDA RPMs

cn5000_pkgs_non_gpu_meta-12_4_0_0-16.x86_64.rpm

CN5000 Meta Package containing all of the required RPMs

cn5000_pkgs_rocm_meta-12_4_0_0-16.x86_64.rpm

CN5000 Meta Package containing all of the required ROCm RPMs

Ubuntu

cn5000-pkgs-cuda-meta_12.4.0.0.16_amd64.deb

CN5000 Meta Package containing all of the required CUDA DEBs

cn5000-pkgs-non-gpu-meta_12.4.0.0.16_amd64.deb

CN5000 Meta Package containing all of the required DEBs

cn5000-pkgs-rocm-meta_12.4.0.0.16_amd64.deb

CN5000 Meta Package containing all of the required ROCm DEBs



Refer to Appendix A, 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.

Supported Operating Systems for This Release 

Operating System

Base Kernel Version

RHEL/Rocky Linux 9.4

5.14.0-427.13.1el9_4.x86_64

RHEL/Rocky Linux 9.6

5.14.0-570.12.1.el9_6.x86_64

RHEL/Rocky Linux 9.7

5.14.0-611.5.1.el9_7.x86_64

RHEL/Rocky Linux 9.8

5.14.0-687.5.3.el9_8.x86_64

RHEL/Rocky Linux 10.1

6.12.0-124.8.1.el10_1.x86_64

RHEL/Rocky Linux 10.2

6.12.0_211.7.3.el10_2.x86_64

SLES 15 SP7

6.4.0-150700.51-default

SLES 16

6.12.0_160000.5_default

Ubuntu 24.04 LTS

6.8.0

Ubuntu 26.04 LTS

7.0.0



Supported GPU Software

This release supports the GPU Software versions listed in the following table.

Note

The libfabric source rpm can be rebuilt to work with other ROCm and CUDA versions. Contact support@cornelis.com for assistance if needed.

GPU Software Versions per OS

Operating System

CUDA Version

ROCm Version

RHEL/Rocky Linux 9.4

13.1

6.2.0

RHEL/Rocky Linux 9.6

12.9

6.4.2

RHEL/Rocky Linux 9.7

13.1

7.1.1

RHEL/Rocky Linux 9.8

13.3 Update 1

7.14

RHEL/Rocky Linux 10.1

13.1

7.2.0

RHEL/Rocky Linux 10.2

13.3 Update 1

7.14

SLES 15 SP7

13.0

6.4.3

SLES 16

13.2

7.14

Ubuntu 24.04 LTS

12.9

6.1.2

Ubuntu 26.04 LTS

13.3

7.14



Supported Hardware

The following tables list the hardware supported in this release.

Switch Products

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



SuperNIC Products

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



Processors

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.

Important

Upgrades from pre-12.4 releases require a full uninstall of the existing CN5000 OPX Software (including removing all residual packages from hosts and repositories) prior to installing version 12.4 or later.

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.

Issues

This section lists the resolved and open issues.

Resolved Issues

The following table lists issues that are resolved in this release.

Issues Resolved in this Release

ID

Description

Resolved in Release

STL-79194

Transfers using GPU (ROCm) buffers over the OPX Provider may abort with SDMA Abort errno=22 (Invalid argument) and dmesg entry amdgpu: Error in Pinning BO to domain: 4.

12.4.0

STL-78983

Running certain verbs tests, such as nsdperf with verbs MR sizes > 4 GB, may result in errors.

12.4.0

STL-77873

Megatron-LM training (Llama3-8B) hangs on multi-node configurations when using NCCL_NET=OFI with the OPX Provider.

12.4.0

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

12.4.0

STL-75362

When using the TCP provider of libfabric, some MPI applications 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.

12.4.0

STL-74933

Entries of the form hfi1_0: lost_mctxt_intr forcing int for 2 and MCTXT interrupt, but no status bits set may appear in logs.

12.4.0

STL-72573

Hangs and errors have been seen in the OSU alltoall collective test when using the OPX Provider to libfabric with ROCm.

12.4.0

STL-72423

Some legacy Omni-Path host utilities have been deprecated for CN5000 but are still supported for OPA100.   

12.4.0

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.

12.4.0



Open Issues

The following tables list the open issues for this release.

Open Issues

ID

Description

Workaround

STL-79912

NCCL collectives may timeout or hang when running with non-NVLink GPU pairs on the same node.

Set NCCL_CUMEM_ENABLE=0.

STL-79864

When MPS is set to 256 before loading the hfi1 kernel module, a kernel halt condition may occur.

Set MPS=256 after hfi1 is loaded.

Refer to the CN5000 Performance Tuning Guide for more details.

STL-79845

When ipoib_tx_mode=hfisvc is set, transmit throughput remains low.

IPoIB HFI Service (HFISVC) transmit mode requires that hfi1 be loaded before ib_ipoib.

Refer to the CN5000 Performance Tuning Guide for the required load order and how to verify it.

STL-79799

Unexpected system fault and reboot may occur while running traffic with ipoib_tx_mode=hfisvc and use_bulksvc=N.

Operating with ipoib_tx_mode=hfisvc and use_bulksvc=N is an unsupported configuration.

Refer to the CN5000 Performance Tuning Guide or contact Cornelis Technical Support for help with configurations.

STL-79771

Installing the Ubuntu distribution perftest package attempts to uninstall OPX Software due to package conflicts.

Build and run perftest from source using the upstream repository: Perftest (GitHub).

STL-79587

In distro Truescale drivers (ib_qib.ko) are incompatible with modern rdmavt kernel modules.

Blacklist ib_qib or remove the .ko file to prevent error messages. Truescale is no longer compatible with the shipping OPX Software 12.x releases.

STL-79559

When running RCCL over its built-in verbs transport (NCCL_NET=IB), RCCL uses only two SuperNICs per node for inter-node communication, regardless of how many are installed. Additional SuperNICs are initialized but transmit no traffic, limiting collective communication bandwidth.

NOTE: This is a RCCL defect (ROCm/rocm-systems#11138).

Perform one of the following:

  • Use aws-ofi-rccl with the OPX Provider: This transport utilizes all installed SuperNICs without configuration changes.

  • Or, modify the verbs topology XML file:

    1. Capture the topology: -x NCCL_TOPO_DUMP_FILE=/path/to/topo.xml

    2. Edit the file to give each <net ... guid="..."/> a unique guid value.

    3. Apply the topology file at runtime: -x NCCL_TOPO_FILE=/path/to/topo.xml

    Regenerate the XML file if the node hardware, SuperNIC count, or driver changes.

STL-79524

In certain Linux distributions, the default DHCP service does not support InfiniBand or IP over InfiniBand (IPoIB) interfaces.

Contact your Linux distribution vendor for approved alternative DHCP packages or configuration workarounds for IPoIB interfaces.

STL-79445

Five-minute timeouts may occur in BeeGFS when RDMA connections are enabled (connUseRDMA = true).

NOTE: A patch is pending per Beegfs (GitHub).

Set connUseRDMA = false.

STL-79193

On SLES distros, the hfi1 driver version may appear incorrect.

To ensure the correct driver is running, use the srcversion field.

STL-78398

On nodes running Ubuntu 24.04 with OPX Software installed, the srp_daemon service continuously generates ib_srp errors in dmesg. These errors include repeated SRP LOGIN rejections, failed path record queries (status −22), and failed SCSI host connections.

The errors persist indefinitely and can consume excessive CPU resources until the srp_daemon process is stopped.

Stop the srp_daemon service or disable it from starting at boot.

  • To stop the service immediately: sudo systemctl stop srp_daemon

  • To prevent it from starting on subsequent reboots: sudo systemctl disable srp_daemon

NOTE: Disabling srp_daemon will prevent automatic discovery of SCSI RDMA Protocol (SRP) targets. If SRP storage is not in use on the affected nodes, this workaround has no functional impact.

STL-78397

On Ubuntu 24.04, the opafm service may intermittently fail to start at boot, reporting:

ibwarn: get_abi_version: can't read ABI version from /sys/class/infiniband_mad/abi_version
Invalid config detected! Couldn't find device for instance 0!

Couldn't find device for instance 0! This is caused by a boot-time race condition.

After a reboot, perform the following:

  1. Check the service status: systemctl status opafm.

  2. If the service shows as failed, wait until the system has fully come up.

  3. Restart the service manually: systemctl restart opafm.

STL-78250

A Verbs SEND operation using PIO may fail to detect that send credits have been returned. This causes the send path to get stuck, preventing further send operations even though the hardware is ready.

Set piothreshold=0 in the HFI1 driver module parameters.

STL-78089

ROCm HIP pointer queries may cause a process hang during teardown. This is a known ROCm issue related to OpenMP target allocations recorded in https://github.com/ROCm/rocm-systems/issues/7099.

Use HIP-managed allocations (e.g., hipMalloc()) instead of OpenMP target allocations for buffers used with OPX GPU-direct/HMEM operations. Avoid mixing OpenMP target allocations with HIP pointer introspection until the ROCm issue is resolved upstream.

STL-77891

When installing or uninstalling the opxs-kernel-updates-kmp-default package on SLES 16, warnings appear stating that the RPM's post-install or post-uninstall scriptlet failed.

These warnings can be ignored.

STL-77578

CableInfo errors encountered when using the opasmaquery -o cableinfo command with direct-routed packets.

Use LID-routed packets to get cable information.

STL-77479

Running opatop may report over line rate.

None.

STL-77171

On SLES, building the kernel driver RPMs may fail when multiple kernels are installed.

Perform the following:

  1. Uninstall any unused kernels including kernel-*devel packages.

  2. Build the RPM package.

    You can do this on any node running the target kernel.

  3. Deploy the RPM once it is built.

STL-76907

The following Lustre Error may occur:

Write request failed with -14

NOTE: This is a general defect that affects all Lustre 2.17.0 stacks (refer to Lustre-Release Issue #16

Avoid this issue by disabling hybrid IO functionality using the following command on the MGS server:

lctl set_param -P llite.*.hybrid_io=0

STL-76435

opapmaquery fails with the following error when querying performance counters for more than approximately 14 ports simultaneously on a single switch.

Invalid Attribute or Attribute Modifier

NOTE: The PMA response has a maximum payload size that limits the number of ports that can be returned in a single query.

Split the port select mask (-n option) into multiple smaller queries, each covering a subset of ports.

For example, on a 48-port switch, query ports in groups of 20 or fewer:

opapmaquery -o getdatacounters -l <LID> -n 0x0000000FFFFF # ports 0-19

opapmaquery -o getdatacounters -l <LID> -n 0x00FFFFF00000 # ports 20-39

opapmaquery -o getdatacounters -l <LID> -n 0xFF0000000000 # ports 40-47

STL-76348

Running opapaquery -o focusport reports same neighbor LID if the switch is connected to a dual-port SuperNIC.

None.

STL-76323

SuperNICs may intermittently fail to enumerate on the PCIe bus or initialize after a cold boot or power cycle. In affected systems, one or more SuperNICs may be absent from the OS, preventing the node from participating in the fabric until the device is successfully detected and initialized.

Power cycle the server.

STL-76313

Kernel messages such as the following may be seen:

CPORT request wait interrupted
Dropping incoming CPORT message

Set the hfi1 module parameter cport_mad_to=5.

STL-75568

Performance test failures may occur when running ib_send_bw and ib_read_bw with the -D (duration) option.

Do not use the -D option.

STL-75484

Running opaportconfig with the disable option immediately followed by running opaportconfig with the enable option will result in the link staying down.

To drop and reinitialize a link, use the bounce option to opaportconfig.

Alternately, if opaportconfig is run from a script, insert a one second delay (sleep 1) between the disable and enable commands.

STL-74968

Updating the Fabric Manager using DNF may not succeed even though an update is available.

Perform the following:

  1. Uninstall the current opa-fm package.

  2. Install the opa-fm package using:

    dnf install opa-fm-<full version name>

STL-74477

Building opxs-kernel-updates from the src.rpm file fails with nvidia/nv-p2p.h not detected.

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/nvidia

Note that the exact directory required for the symbolic link will depend on your kernel version.

STL-74025

When using IPoIB, SuperNICs do not change MTU or join MC groups automatically.

Use the ip tool from the command line to manually take the interface down and back up.

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-73714

Performing an opapmaquery to a "B" port on a switch where subdivision is not enabled returns non-zero counter values.

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-73669

Executing opasmaquery -o scvlr for nodes that do not support SC-VLr mappings will result in a message indicating a failure.

The message may be ignored.

STL-73215

When running opasmaquery -o sminfo on CN5000 SuperNICs, SMA fields show all 0s and SM State Inactive.

Use opasaquery -o sminfo or opareport to show correct SA SMInfo data.

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 FineGrained. In order to enable FGAR, set the following:

<AdaptiveRouting>1</AdaptiveRouting> 

<FineGrained>1</FineGrained> 

All other fields are related to legacy MGAR and will be ignored if FineGrained is enabled.

STL-73140

The following CN5000 commands do not work as expected:

  • opaextractbadlinks 

  • opafabricanalysis 

  • opahfirev 

  • opapacketcapture 

  • opaverifyhosts 

Note the following:

  • opapacketcapture must be invoked as opapacketcapture -d /dev/hfi1_0_diagpkt2 for SuperNICs due to its default port 2.

  • opaverifyhost can take up to one minute to execute.

  • All other commands currently have no workarounds.

STL-72583

In some cases the dmesg log may contain a message stating:

invalid logical state transition PORT_DOWN > PORT_ACTIVE.

This is cosmetic and will not affect functionality.

STL-72541

Running the opainfo command when ports are inactive results in the following errors: MAD failed and Failed to get PMA Port Status.

These errors can be ignored.

STL-72536

STL-72537

CableInfo errors encountered when using the opasmaquery -o cableinfo command.

Cable information reporting not currently supported.

STL-72526

The Fabric Manager system log port numbering is different from Switch CLI command port numbering.

For details, contact support@cornelis.com for technical advisory TA0061.

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-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-72028

Hangs have been seen in the NCCL alltoall_perf test when using the OPX provider to libfabric.

No workaround.

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-70552

Rebuilding Open MPI or mvapich2 with FastFabric utilities (do_openmpi_build and do_mvapich2_build) will return an error if using the Intel icx compiler.

These utilities are compatible only with the Intel ICC compiler. Rebuild Open MPI or mvapich2 using the ICC compiler, or rebuild manually.

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.

STL-64974

Failures have been observed when running the IMB-EXT "Window" benchmark using the OPX Provider and ppn greater than (num_user_contexts/2).

To run the IMB-EXT benchmark with the OPX Provider and higher PPN, reload the hfi1 module with an increased num_user_contexts value. For example, if the server has 40 physical cores and you want to run one IMB-EXT process per core, increase the number of hfi1 contexts to 80. See the CN5000 Performance Tuning Guide, “HFI1 Driver Module Parameters” for instructions.

The benchmark can now be run with #contexts/2 = 40 PPN, one for each CPU core.



Product Limitations

This release has the following limitations:

  • OPX Software releases 12.2.0 and 12.3.0 cannot be simultaneously deployed in an Omni-Path fabric with Bulk Transfer Service (BTS) enabled due to wire protocol differences introduced by recent performance optimizations.

  • If you plan to deploy in a hybrid fabric with OPA100 and CN5000 interoperating together, contact support@cornelis.com for guidance before deploying this release.

  • IPoIB connected mode and the verbs IPoIB datapath with Accelerated IP (AIP) disabled have been deprecated. Both remain functional in this release but are no longer recommended, may exhibit known issues, and will be removed in a future release.

    The supported configurations are IPoIB datagram mode with AIP enabled (default), and the AIP HFISVC transmit mode (ipoib_tx_mode=hfisvc).

  • 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 the environment variable MV2_ENABLE_AFFINITY=0 to 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 as follows for proper operation:

    For Version I SuperNIC boards:

    <Name>fm0</Name>    
    <Hfi>1</Hfi>     
    <Port>2</Port> 

    For Version II SuperNIC boards:

    <Name>fm0</Name>    
    <Hfi>1</Hfi>     
    <Port>1</Port> 

    To determine which generation board you have, refer to the Prerequisites under CN5000 Maintenance and Troubleshooting Guide, "Replace the SuperNIC".

  • Non-default MinShareVLMem and DedicatedVLMem values are not supported. Only use default values.

  • Some distros versions may ship with ib_qib driver enabled. This driver is incompatible with the OPX Software and may result in errors such as disagrees about version of symbol in logs. Set blacklist ib_qib.

  • During link bring up on a mixed OPA100/CN5000/CN6000 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 Omni-Path installed. Ubuntu platforms cannot host multiple SuperNICs.

  • MVAPICH-Plus 4.1 for GPU is not supported.

  • The sph_exa application in SpecHPC hangs when using Open MPI. Set the following when running Open MPI:

    -mca topo ^treematch
  • ibtracert is not supported in the Omni-Path environment. As an alternative, use opareport -o links or opaextractlink.

Download PDF

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:

New in This Release

  • Maintenance Updates

Firmware Components

This release contains the firmware components listed in the following table.

Firmware Components

Description

File Name

Version

SuperNIC Firmware (includes UEFI 12.1.0.10.0)

CN5000.SuperNICFirmware-12.4.0.0.8-V1.pkg

12.4.0



System Requirements

This section lists the supported hardware.

Supported Hardware

The following tables list the hardware supported in this release.

SuperNIC Products

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



Installation Requirements

Refer to the CN5000 Maintenance and Troubleshooting Guide for instructions to update the switch firmware.

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.

Issues

This section lists the resolved and open issues.

Resolved Issues

The following table lists issues that are resolved in this release.

Issues Resolved in this Release

ID

Description

Resolved in Release

STL-78579

On the RDE NetworkDeviceFunction resource, the SystemGUID and PermanentSystemGUID properties report a synthesized value that does not match the host sys_image_guid and cannot be verified against any host source. This is an informational identity field with no functional impact.

12.4.0

STL-78577

Per-port InfiniBand identity is not discoverable on the RDE Port resource because it exposes only a synthesized Ethernet MAC address and does not report the InfiniBand PortGUID.

12.4.0

STL-78574

The link state that RDE reports may be inconsistent or incorrect for management clients because the mapping from InfiniBand physical port states (Offline, Init, Polling) to the Redfish Port LinkStatus enumeration is unverified and undocumented.

12.4.0

STL-78573

RDE management clients may incorrectly identify the fabric as Ethernet. On an InfiniBand HFI, the Redfish/RDE Port resource reports PortProtocol and LinkNetworkTechnology as Ethernet and provides a synthesized MAC address. These values conflict with the sibling NetworkDeviceFunction, which correctly reports InfiniBand.

12.4.0

STL-72988

When updating firmware in a CN5000 SuperNIC in a management node, updateAgent times out when the FM is running at the same time.

12.4.0

STL-71647

On rare occasions, the link may come up at a width less than 4X.

12.4.0



Open Issues

The following table lists the open issues for this release.

Open Issues

ID

Description

Workaround

STL-78576

Inventory and asset management tools cannot identify the product from Redfish because the Model and SKU properties on the RDE NetworkAdapter and PCIeDevice resources report the raw PCI device ID (0x0001) instead of the product name and SKU.

None.

STL-77756

After updating the SuperNIC firmware using updateAgent, one or more SuperNIC cards in a multi-card system may remain in a "Pending" firmware state following an AC power cycle. Additional AC power cycles do not resolve the issue.

Re-run the updateAgent firmware update on the affected SuperNIC card(s).

To help ensure all cards complete the firmware update on the first attempt, fully power off the system (not just a power cycle) and wait at least one minute before powering back on, allowing all card capacitors to fully discharge.

STL-76776

Network connectivity may fail after hot-swapping cables of different types on the SuperNIC.

Reboot the host to detect the new cables.

STL-76555

HPC service nodes with live user sessions (such as head, NFS, and Lustre nodes) may be disrupted after a SuperNIC firmware update with updateAgent. Activating the new firmware requires a full server power-off; a warm reboot or adapter-level reset will not work.

None.

STL-76323

SuperNICs may intermittently fail to enumerate on the PCIe bus or initialize after a cold boot or power cycle. In affected systems, one or more SuperNICs may be absent from the OS, preventing the node from participating in the fabric until the device is successfully detected and initialized.

Power cycle the server.

STL-75609

The updateAgent tool may become stuck when downgrading SuperNIC firmware.

Use updateAgent -f when downgrading firmware.

STL-75344

PXE boot over IPv4 intermittently fails with PXE-E18: Server response timeout.

None.

STL-74502

When updating SuperNIC firmware with multiple SuperNIC adapters in a server, some cards may fail to properly update.

Disable the port on the failed SuperNIC cards using opaportconfig -p n disable (where “n” is the port number) and perform the update again.

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-73195

When updating the SuperNIC firmware using updateAgent -v, the following error may occur:

While waiting for a response to PLDM type 05 and command code 14, a message with type 05 and command 15 was received

Retry the updateAgent -v command.

STL-73088

On some dual-port devices, inbound IPoIB traffic may fail after a system reboot, or after restarting the FM and IPoIB interfaces on the FM node.

Ping out from the unreachable interface, and IP traffic will resume.

STL-72817

When reading hfi1 port counters from sysfs, you will receive an Invalid Argument return code.

This message can be ignored.

STL-72583

In some cases the dmesg log may contain a message stating:

invalid logical state transition PORT_DOWN > PORT_ACTIVE.

This is cosmetic and will not affect functionality.

STL-72598

In some cases, when unloading hfi1 or ib_ipoib, the dmesg log may display an error stating:

hfi1_tid_rdma_flush_wait: no rcd for QP

This message can be ignored.



Product Limitations

This release has the following product limitations:

  • lspci does not enumerate the SuperNIC with ASPM enabled, causing the BIOS screen on Intel D50DNP platforms to lock up. Disable ASPM in the BIOS.

  • SuperNICs received from Cornelis with firmware version prior to 12.0.2.0.6 do not include UEFI (Option ROM). Contact Cornelis Customer Support for firmware and update procedures.

  • Update agent fails to update the SuperNIC Firmware when the OPX Software version is 12.0.2 or newer and SuperNIC Firmware is version is 12.0.1.

    To work around this limitation, reduce OPX Software version to 12.0.1, update the SuperNIC Firmware to version 12.0.2, then reinstall the 12.0.2 or newer OPX Software.

  • CN5000 SuperNIC enumerates at x4 PCIe width on some platforms if the width is not forced to x16 in the BIOS. Configure the BIOS to enforce PCIe x16 width.

Download PDF

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:

New in This Release

The following features are new in this release:

  • Maintenance Updates

Firmware Components

This release contains the firmware components listed in the following table.

Firmware Components

Description

File Name

Version

Switch Firmware

CN5000.SwitchFirmware-12.4.0.0.6-V1.pkg

12.4.0



System Requirements

This section lists the supported hardware.

Supported Hardware

The following tables list the hardware supported in this release.

Switch Products

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



Installation Requirements

Refer to the CN5000 Maintenance and Troubleshooting Guide for instructions to update the switch firmware.

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.

Issues

This section lists the resolved and open issues.

Resolved Issues

The following table lists the resolved issues for this release.

Issues Resolved in this Release

ID

Description

Resolved in Release

STL-71647

On rare occasions, the link may come up at a width less than 4X.

12.4.0



Open Issues

The following table lists the open issues for this release.

Open Issues

ID

Description

Workaround

STL-74480

When a switch port operating in subdivided (2X) mode is disabled and re-enabled, it does not return to full-width 4X mode.

After replacing a bifurcated (Y-cable) connection with a straight QSFP cable, a switch power cycle is required to restore the port to 4X mode.

STL-74370

ASIC firmware update may fail with the following message:

Error during firmware update

Not that this message is seen when checking the status using the firmware update -s command.

Retry the ASIC firmware update.

STL-73361

On rare occasions, links connecting a CN5000 switch to an OPA100 adapter may unexpectedly bounce.

No action required, the link will self recover.

STL-72526

The Fabric Manager system log port numbering is different from Switch CLI command port numbering.

For details, contact support@cornelis.com for technical advisory TA0061.



Product Limitations

This release has the following product limitations:

  • Updating the switch components (BMC/ASIC) in-band with the firmware update tool fails if the switch is running firmware older 12.2.x. You must update the firmware to 12.2 or greater before using in-band firmware updates.