Finding the MAC on the Adapter Card......................................................................68
Document Revision History ......................................................................................71
Page 6
6
About This Manual
This User Manual describes NVIDIA® Mellanox®ConnectX®-6 Dx Ethernet adapter cards. It provides
details as to the interfaces of the board, specifications, required software and firmware for operating
the board, and relevant documentation.
Ordering Part Numbers
The table below provides the ordering part numbers (OPN) for the available ConnectX-6 Dx Ethernet
adapter cards.
ConfigurationOPNMarketing Description
25GbE PCIe
OPNs
50GbE OPNsMCX623102AC-
100GbE OPNsMCX623105AN-
MCX621102ACADAT
MCX621102ANADAT
MCX621102AEADAT
MCX623102ACADAT
MCX623102ANADAT
GDAT
MCX623102ANGDAT
MCX623102ASGDAT
MCX623102AEGDAT
CDAT
MCX623105AECDAT
ConnectX®-6 Dx EN adapter card, 25GbE, Dual-port SFP28, PCIe 4.0 x8,
Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 25GbE, Dual-port SFP28, PCIe 4.0 x8,
No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 25GbE, Dual-port SFP28, PCIe 4.0 x8,
Crypto, No Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 25GbE, Dual-port SFP28, PCIe 4.0
x16, Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 25GbE, Dual-port SFP28, PCIe 4.0
x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 50GbE, Dual-port SFP56, PCIe 4.0
x16, Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 50GbE , Dual-port SFP56, PCIe 4.0
x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 50GbE, Dual-port SFP56, PCIe 4.0
x16, Secure Boot, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 50GbE, Dual-port SFP56, PCIe 4.0
x16, Crypto, No Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Single-port QSFP56, PCIe
4.0 x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Single-port QSFP56, PCIe
4.0 x16, Crypto, No Secure Boot, Tall Bracket
100GbE with PPS
In/Out OPNs
MCX623106ACCDAT
MCX623106ANCDAT
MCX623106ASCDAT
MCX623106AECDAT
MCX623106PCCDAT
MCX623106PNCDAT
MCX623106PECDAT
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0
x16, Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0
x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0
x16, Secure Boot, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0
x16, Crypto, No Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, with PPS In/Out, PCIe 4.0 x16, Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, with PPS In/Out, PCIe 4.0 x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, with PPS In/Out, PCIe 4.0 x16, Crypto, No Secure Boot, Tall Bracket
Page 7
7
ConfigurationOPNMarketing Description
200GbE OPNsMCX623105AC-
VDAT
MCX623105ANVDAT
MCX623105ASVDAT
MCX623105AEVDAT
ConnectX®-6 Dx EN adapter card, 200GbE, Single-port QSFP56, PCIe
4.0 x16, Crypto and Secure Boot, Tall Bracket
ConnectX®-6 Dx EN adapter card, 200GbE , Single-port QSFP56, PCIe
4.0 x16, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 200GbE, Single-port QSFP56, PCIe
4.0 x16, Secure Boot, No Crypto, Tall Bracket
ConnectX®-6 Dx EN adapter card, 200GbE, Single-port QSFP56, PCIe
4.0 x16, Crypto, No Secure Boot, Tall Bracket
Intended Audience
This manual is intended for the installer and user of these cards.The manual assumes basic familiarity
with Ethernet network and architecture specifications.
Technical Support
Customers who purchased Mellanox products directly from Mellanox are invited to contact usthrough
the following methods:
•
URL:http://www.mellanox.com> Support
•
E-mail:support@mellanox.com
•
Tel: +1.408.916.0055
Customers who purchased Mellanox M-1 Global Support Services, please see your contract fordetails
regarding Technical Support.
Customers who purchased Mellanox products through a Mellanox approved reseller should first
seekassistance through their reseller.
Related Documentation
Mellanox OFED for
Linux User Manual
and Release Notes
WinOF-2 for
WindowsUser Manual
and Release Notes
Mellanox VMware for
Ethernet User Manual
and Release Notes
Mellanox Firmware
Utility (mlxup) User
Manual and Release
Notes
Mellanox Firmware
Tools (MFT) User
Manual
User Manual describing OFED features, performance, band diagnostic, tools
content and configuration. SeeMellanox OFED for Linux Documentation.
User Manual describing WinOF-2 features, performance, Ethernet diagnostic, tools
content and configuration. SeeWinOF-2 for Windows Documentation.
User Manual describing the various components of the Mellanox ConnectX®
NATIVE ESXi stack. See http://www.mellanox.comProducts > Software > Ethernet
Drivers > VMware Driver
Mellanox firmware update and query utility used to update the firmware. Seehttp:/
User Manual describing the set of MFT firmware management tools for a single
node. SeeMFT User Manual.
Page 8
8
IEEE Std 802.3
Specification
IEEE Ethernet specification at http://standards.ieee.org/
PCI Express
Specifications
Mellanox LinkX
Interconnect
Solutions
Industry Standard PCI Express Base and Card Electromechanical Specifications at
https://pcisig.com/specifications
Mellanox LinkX Ethernet cables and transceivers are designed to maximize the
performance of High-Performance Computing networks, requiring highbandwidth, low-latency connections between compute nodes and switch nodes.
Mellanox offers one of industry’s broadest portfolio 40Gb/s, 56Gb/s, 100Gb/s and
200Gb/s cables, including Direct Attach Copper cables (DACs), copper splitter
cables, Active Optical Cables (AOCs) and transceivers in a wide range of lengths
from 0.5m to 10km.Mellanox tests every product in an end-to-end environment
ensuring a Bit Error Rate of less than 1E-15.Read more at https://
When discussing memory sizes, MB and MBytes are used in this document to mean size in mega
Bytes. The use of Mb or Mbits (small b) indicates size in mega bits. In this document PCIe is used to
mean PCI Express.
Revision History
A list of the changes made to this document are provided inDocument Revision History.
Page 9
9
Introduction
Product Overview
This is the
User Manual
for Mellanox Technologies Ethernet adapter cards based on the ConnectX®-6
Dx integrated circuit device.
As the world's most advanced cloud SmartNIC, ConnectX-6 Dx provides up to two ports of 25, 50 or
100Gb/s or a single-port of 200Gb/s Ethernet connectivity, powered by 50Gb/s PAM4 SerDes technology
and PCIe Gen 4.0 host connectivity.ConnectX-6 Dx continues among Mellanox's innovation path in
scalable cloud fabrics, delivering unparalleled performance and efficiency at every scale. ConnectX-6
Dx's innovative hardware offload engines, including IPsec and TLS inline data-in-motion encryption, are
ideal for enabling secure network connectivity in modern data-center environments. Please refer toFe
ature and Benefits for more details.
Mellanox ConnectX-6 Dx 25GbE Adapter Cards
Part NumberMCX621102AC-
ADAT
Form Factor/
Dimensions
Data Transmission
Rate
Network Connector
Type
PCIe InterfacePCIe Gen 4.0 SERDES @ 16.0GT/s x8PCIe Gen 4.0 SERDES @ 16.0GT/s
5.59in. x 2.71in (142.00mm x 68.90mm)
Ethernet: 1/10/25 Gb/s
Dual-port
SFP28
MCX621102AE-
ADAT
Dual-port
SFP28
MCX621102AN-
ADAT
Dual-port SFP28Dual-port
MCX623102ACADAT
SFP28
x16
MCX623102AN-
ADAT
Dual-port SFP28
Crypto√√-√-
Secure Boot√--√-
Adapter IC Part
Number
RoHSRoHS Compliant
MT28928A0CCCF-CE
MT28928A0NCCF-CE
MT28928A0NCCF-CE
MT28928A0CCCF-CE
MT28928A0NCCF-CE
Mellanox ConnectX-6 Dx 50GbE Adapter Cards
Part NumberMCX623102AC-GDATMCX623102AN-GDAT MCX623102AS-GDAT
Form Factor/Dimensions 5.59in. x 2.71in (142.00mm x 68.90mm)
Data Transmission RateEthernet: 1/10/25/40/50 Gb/s
Network Connector Type Dual-port SFP56
PCIe InterfacePCIe Gen 4.0 SERDES @ 16.0GT/s x16
Page 10
10
Crypto√√--
Secure Boot√--√
Adapter IC Part NumberMT28928A0-CCCF-CE MT28928A0-
MemoryPCI Express - stores and accesses Ethernet fabric connection information and packet data.
Overlay
Networks
RDMA
overConve
rged
Ethernet
(RoCE)
Mellanox
PeerDirect
®
CPU
Offload
•
•
SPI Quad - includes 256Mbit SPI Quad Flash device (MX25L25645GXDI-08G device by
Macronix)
•
FRU EEPROM - Stores the parameters and personality of the card. The EEPROM capacity
is 128Kbit. FRU I2C address is (0x50) and is accessible through the PCIe SMBus(Available
only in QSFP cards).
In order to better scale their networks, data center operators often create overlay networks that
carry traffic from individual virtual machines over logical tunnels in encapsulated formats such as
NVGRE and VXLAN. While this solves network scalability issues, it hides the TCP packet from the
hardware offloading engines, placing higher loads on the host CPU. Mellanox ConnectX-6 Dx
effectively addresses this by providing advanced NVGRE and VXLAN hardware offloading engines
that encapsulate and de-capsulate the overlay protocol.
Mellanox ConnectX-6 Dx, utilizing RoCE (RDMA over Converged Ethernet) technology, delivers
low-latency and high-performance over Band and Ethernet networks. Leveraging data center
bridging (DCB) capabilities as well as Mellanox ConnectX-6 Dx advanced congestion control
hardware mechanisms, RoCE provides efficient low-latency RDMA services over Layer 2 and
Layer 3 networks.
Mellanox PeerDirect® communication provides high-efficiency RDMA access by eliminating
unnecessary internal data copies between components on the PCIe bus (for example, from GPU to
CPU), and therefore significantly reduces application run time. Mellanox ConnectX-6 Dx advanced
acceleration technology enables higher cluster efficiency and scalability to tens of thousands of
nodes.
Adapter functionality enabling reduced CPU overhead allowing more available CPU for
computation tasks.
Open vSwitch (OVS) offload using ASAP2- Accelerated Switch and Packet
• Flexible match-action flow tables
• Tunnelingencapsulation / decapsulation
Quality of
Service
(QoS)
Hardwarebased I/
OVirtualiza
tion
Support for port-based Quality of Service enabling various application requirements for latency
and SLA.
Mellanox ConnectX-6 Dx provides dedicated adapter resources and guaranteed isolation and
protection for virtual machines within the server.
A consolidated compute and storage network achieves significant cost-performance advantages
over multi-fabric networks. Standard block and file access protocols can leverage
• RDMA for high-performance storage access
• NVMe over Fabric offloads for target machine
• Erasure Coding
• T10-DIF Signature Handover
isolation and protection for virtual machines (VM) within the server.
• Tag Matching and Rendezvous Offloads
• Adaptive Routing on Reliable Transport
• Burst Buffer Offloads for Background Checkpointing
Mellanox offers a full IEEE 1588v2 PTP software solution, as well as time-sensitive related
features called “5T”. Mellanox PTP and 5T software solution are designed to meet the most
demanding PTP profiles. ConnectX-6 Dx incorporates an integrated Hardware Clock (PHC) that
allows ConnectX-6 Dx to achieve sub 20u Sec accuracy and also offers many timing related
functions such as time-triggered scheduling or time-based SND accelerations (time-based
ASAP²) . Furthermore, the 5T technology enables the software application to transmit fronthaul
(ORAN) compatible in high bandwidth. The PTP part supports slave clock, master clock, and
boundary clock.
ConnectX-6 Dx PTP solution allows you to run any PTP stack on your host.
With respect to testing and measurements, selected Mellanox adapters allow you to use the PPSout signal from onboard SMA connecter, ConnectX-6 Dx also allows to measure PTP in scale, with
PPS-In signal. The PTP HW clock on the Network adapter will be sampled on each PPS-In signal,
and the timestamp will be sent to the SW.
Enabled in MCX623106PN-CDAT, MCX623106PE-CDAT and MCX623106PC-CDAT.
Operating Systems/Distributions
•
RHEL/CentOS
•
Windows
•
FreeBSD
•
VMware
•
OpenFabrics Enterprise Distribution (OFED)
•
OpenFabrics Windows Distribution (WinOF-2)
Connectivity
•
Interoperable with 1/10/25/40/50/100/200 Gb/s Ethernet switches
•
Passive copper cable with ESD protection
•
Powered connectors for optical and active cable support
Page 14
14
Manageability
Mellanox ConnectX-6 Dx technology maintains support for manageability through a BMC. Mellanox
ConnectX-6 Dx PCIe stand-up adapter can be connected to a BMC using MCTP over SMBus or MCTP
over PCIe protocols as if it is a standard Mellanox PCIe stand-up adapter. For configuring the adapter
for the specific manageability solution in use by the server, please contact Mellanox Support.
Page 15
15
Interfaces
The below figures show the component side of the Mellanox ConnectX-6 Dx adapter card. Each
numbered interface that is referenced in the figures is described in the following table with a link to
detailed information.
The below figures are for illustration purposes only and might not reflect the current revision
of the adapter card.
CalloutItemDescription
1“ConnectX-6 Dx IC”Mellanox ConnectX-6 Dx IC on the board.
2“PCI Express Interface"PCIe Gen 3.0/4.0 through an x8/x16 edge connector.
3“Ethernet SFP28/SFP56/QSFP56
Interface”
4“Networking Ports LEDs Interface”There are two I/O LEDs per port to indicate speed
“SMBus Interface”Allows BMC connectivity using MCTP over SMBus or
“Voltage Regulators”Voltage supply pins that feed onboard regulators.
Ethernet traffic is transmitted through the adapter's
SFP28/SFP56/QSFP56 connectors. The networking
connectors allow for the use of modules, optical and
passive cable interconnect solutions.
and link status.
MCTP over PCIe protocols.
Page 16
16
ConnectX-6 Dx IC Interface
The ConnectX®-6 Dx EN family of adapter IC devicesdelivers two ports of 10/25/40/50/100Gb/s or a
single-port of 200Gb/s Ethernet connectivity paired with best-in-class hardware capabilities that
accelerate and secure cloud and data-center workloads.
Encryption
Applies to Crypto OPNs only.
ConnectX-6 Dx brings security to every end-point, including:
•
Purpose-built inline acceleration engines that offload IPsec and TLS data-in-motion and XTSAES data-at-rest cryptographic operations.
•
Stateful firewall solution acceleration, powered by Open vSwitch connection tracking and
Mellanox’s ASAP2 technology.
•
Embedded hardware root-of-trust and support for RSA-based secure firmware update and
secure boot, providing guaranteed integrity of the network adapter.
Ethernet SFP28 / SFP56 / QSFP56 Interfaces
The network ports of the ConnectX-6 Dx adapter card are compliant with the IEEE 802.3 Ethernet
standards listed in Features and Benefits. Ethernet traffic is transmitted through the SFP28 / SFP56 /
QSFP56connector on the adaptercard.
The adapter card includes special circuits to protect from ESD shocks to the card/server when
plugging copper cables.
PCI Express Interface
ConnectX-6 Dx adapter cards support PCI Express Gen 3.0/4.0 (1.1 and 2.0 compatible) through x8/16
edge connectors. The device can be either a master initiating the PCI Express bus operations, or a
slave responding to PCI bus operations.
The following lists PCIe interface features:
•
PCIe Gen 4.0 and 3.0 compliant, 2.0 and 1.1 compatible
•
2.5, 5.0, 8.0, or 16.0 GT/s link rate x8 or x16 lanes
•
Auto-negotiates to x16, x8, x4, x2, or x1
•
Support for MSI/MSI-X mechanisms
Networking Ports LEDs Interface
For the networking ports LEDs description, follow the below table depending on the OPN you have
Scheme 3: One Bi-Color LED and one Single Color
LED
Scheme 1: One Bi-Color LED
There is one bicolor(Yellow and Green) I/O LED per port to indicate speed and link status.
Physical and Logical Link Indications
StateBi-Color LED (Yellow/Green)
Physical link speed
Beacon command for locating the adapter card1Hz blinking Yellow
Error4Hz blinking Yellow indicates a problem with the link
Physical Activity• A constant Green indicates a physical link with the
maximum networking speed.
• A constant Yellow indicates a physical link with less than
the maximum networking speed.
Link Up• A constant Green indicates a physical link with
themaximum networking speed.
• A constant Yellow indicates a physical link with less than
the maximum networking speed.
Scheme 3: One Bi-Color LED and one Single Color LED
There are two I/O LEDs per port to indicate speed and link status. LED1 is a bicolor LED (Yellow and
green) and LED2 is a single color LED (green).
Physical and Logical Link Indications (Ethernet Mode)
StateBi-Color LED (Yellow/Green)
Physical link speed
Beacon command for locating the
adapter card
Error4Hz blinking Yellow indicates a problem
1Hz blinking YellowOFF
with the link
Single Color LED (Green)
Logical link/activity
ON
Page 18
18
StateBi-Color LED (Yellow/Green)
Physical link speed
Single Color LED (Green)
Logical link/activity
Physical Activity• A constant Green indicates a physical
link with the maximum networking speed.
• A constant Yellow indicates a physical
link with less than the maximum
networking speed.
Link Up• A constant Green indicates a physical
link with themaximum networking speed.
• A constant Yellow indicates a physical
link with less than the maximum
networking speed.
Blinking
ON
SMBus Interface
ConnectX-6 Dx technology maintains support for manageability through a BMC. ConnectX-6 Dx PCIe
stand-up adapter can be connected to a BMC using MCTP over SMBus or MCTP over PCIe protocols as
if it is a standard Mellanox PCIe stand-up adapter. For configuring the adapter for the specific
manageability solution in use by the server, please contact Mellanox Support.
Voltage Regulators
The voltage regulator power is derived from the PCI Express edge connector 12V supply pins. These
voltage supply pins feed on-board regulators that provide the necessary power to the various
components on the card.
Heatsink
The heatsink is attached to the ConnectX-6 Dx IC in order to dissipate the heat. It is attached either by
using four spring-loaded push pins that insert into four mounting holes, or by screws. ConnectX-6 Dx
IC has a thermal shutdown safety mechanism that automatically shuts down the ConnectX-6 Dx card in
cases of high-temperature event, improper thermal coupling or heatsink removal.
Page 19
19
Hardware Installation
Installation and initialization of ConnectX-6 Dx adapter cards require attention to the mechanical
attributes, power specification, and precautions for electronic equipment.
Safety Warnings
Safety warnings are provided here in the English language. For safety warnings in other
languages, refer to the Adapter Installation Safety Instructions document available on
mellanox.com.
Please observe all safety warnings to avoidinjury and prevent damage to system components. Note
that not all warnings are relevant to all models.
Unable to render include or excerpt-include. Could not retrieve page.
Installation Procedure Overview
The installation procedure of ConnectX-6 Dx adapter cards involves the following steps:
StepProcedureDirect Link
1Check the system’s hardware and software
requirements.
2Pay attention to the airflow consideration within the
host system
3Follow the safety precautionsRefer to Safety Precautions
4Unpack the packageRefer to Unpack the package
5Follow the pre-installation checklistRefer to Pre-Installation Checklist
6(Optional) Replace the full-height mounting bracket
with the supplied short bracket
7Install the ConnectX-6 Dx and PCIe Auxiliary
connection cards in the system
8Connect cables or modules to the cardRefer to Cables and Modules
9Identify ConnectX-6 Dx in the systemRefer to Identifying Your Card
Refer to System Requirements
Refer to Airflow Requirements
Refer to Bracket Replacement
Instructions
Refer to Installation Instructions
Page 20
20
System Requirements
Hardware Requirements
Unless otherwise specified, Mellanox products are designed to work in an environmentally
controlled data center with low levels of gaseous and dust (particulate) contamination.
The operation environment should meet severity level G1 as per ISA 71.04 for gaseous
contamination and ISO 14644-1 class 8 for cleanliness level.
A system with a PCI Express slot of corresponding bus width is required for installing the card.
For proper operation and performance, please make sure to use a PCIe slot with a
corresponding bus width and that can supply sufficient power to your card. Refer to the
Specifications section of the manual for more power requirements.
Airflow Requirements
ConnectX-6 Dx adapter cards are offered with two airflow patterns: from the heatsink to the network
ports.
Please refer to the Specificationssection for airflow numbers for each specific card model.
All cards in the system should be planned with the same airflow direction.
Software Requirements
•
See Operating Systems/Distributionssection under the Introduction section.
•
Software Stacks - Mellanox OpenFabric software package MLNX_OFED for Linux, WinOF-2 for
Windows, and VMware. See the Driver Installationsection.
Safety Precautions
The adapter is being installed in a system that operates with voltages that can be lethal. Before
opening the case of the system, observe the following precautions to avoid injury and prevent damage
to system components.
•
Remove any metallic objects from your hands and wrists.
•
Make sure to use only insulated tools.
•
Verify that the system is powered off and is unplugged.
•
It is strongly recommended to use an ESD strap or other antistatic devices.
Page 21
21
Unpacking the Package
Check against the package contents list that all the parts have been sent.Check the parts for visible
damage that may have occurred during shipping. Please note that the cards must be placed on an
antistatic surface.
CategoryQty.Item
Cards1ConnectX-6 Dx adapter card
Accessories1Adapter card short bracket
1Adapter card tall bracket (shipped assembled on
the card)
Please note that if the card is removed hastily from the antistatic bag, the plastic ziplock may
harm the EMI fingers on the networking connector. Carefully remove the card from the
antistatic bag to avoid damaging the EMI fingers.
Pre-Installation Checklist
1.
Verify that your system meets the hardware and software requirements stated above.
2.
Shut down your system if active.
Turn off the power to the system, and disconnect the power cord. Refer to the system
documentation for instructions. Before you install the ConnectX-6 Dx card, make sure that the
system is disconnected from power.
3.
(Optional) Check the mounting bracket on the card.
If required for your system, replace the full-height mounting bracket that is shipped mounted on
the card with the supplied low-profile bracket. Refer toBracket Replacement Instructions.
Page 22
22
Bracket Replacement Instructions
The ConnectX-6 Dx card is usually shipped with an assembled high-profile bracket. If this form factor
is suitable for your requirements, you can skip the remainder of this section and move toInstallation
Instructions. If you need to replace the high-profile bracket with the short bracket that is included in
the shipping box, please follow the instructions in this section.
Due to risk of damaging the EMI gasket, it is not recommended to replace the bracket more
than three times.
To replace the bracket you will need the following parts:
•
The new brackets of the proper height
•
The 2 screws saved from the removal of the bracket
Removing the Existing Bracket
1.
Using a torque driver, remove the two screws holding the bracket in place.
2.
Separate the bracket from the ConnectX-6 Dx card.
Be careful not to put stress on the LEDs on the adapter card.
3.
Save the two screws.
Installing the New Bracket
1.
Place the bracket onto the card until the screw holes line up.
Do not force the bracket onto the adapter card.
2.
Screw on the bracket using the screws saved from the bracket removal procedure above.
Use a torque driver to apply up to 2 lbs-in torque on the screws.
Installation Instructions
This section provides detailed instructions on how to install your adapter card in a system.
Please note that the following figures are for illustration purposes only.
Connect the adapter Card in an available PCI Express x16 slot in the chassis.
Step 1:Locate an available PCI Express x16 slot and insert the adapter card to the chassis.
Page 23
23
Step 2:Applying even pressure at both corners of the card, insert the adapter card in a PCI
Express slot until firmly seated.
Do not use excessive force when seating the card, as this may damage the chassis.
The adapter is installed in a system that operates with voltages that can be lethal. Before uninstalling
the adapter card, please observe the following precautions to avoid injury and prevent damage to
system components.
1.
Remove any metallic objects from your hands and wrists.
2.
It is strongly recommended to use an ESD strap or other antistatic devices.
3.
Turn off the system and disconnect the power cord from the server.
Card Removal
Please note that the following images are for illustration purposes only.
1.
Verify that the system is powered off and unplugged.
2.
Wait 30 seconds.
3.
To remove the card, disengage the retention mechanisms on the bracket (clips or screws).
4.
Holding the adapter card from its center, gently pull the ConnectX-6 and Auxiliary Connections
cards out of the PCI Express slot.
The installation instructions include steps that involve a retention clip to be used while
connecting the Cabline harnesses to the cards. Please note that this is an optional accessory.
To uninstall the adapter card, see Uninstalling the Card.
Cables and Modules
To obtain the list of supported Mellanox cables for your adapter, please refer to theCables Reference
Tableathttp://www.mellanox.com/products/interconnect/cables-configurator.php.
Cable Installation
1.
All cables can be inserted or removed with the unit powered on.
2.
To insert a cable, press the connector into the port receptacle until the connector is firmly
seated.
a.
Support the weight of the cable before connecting the cable to the adapter card. Do this
by using a cable holder or tying the cable to the rack.
b.
Determine the correct orientation of the connector to the card before inserting the
connector. Do not try and insert the connector upside down. This may damage the
adapter card.
c.
Insert the connector into the adapter card. Be careful to insert the connector straight into
the cage. Do not apply any torque, up or down, to the connector cage in the adapter card.
d.
Make sure that the connector locks in place.
When installing cables make sure that the latches engage.
Always install and remove cables by pushing or pulling the cable and connector
in a straight line with the card.
3.
After inserting a cable into a port, the Green LED indicator will light when the physical
connection is established (that is, when the unit is powered on and a cable is plugged into the
port with the other end of the connector plugged into a functioning port).See LED
Interfaceunder the Interfaces section.
4.
After plugging in a cable, lock the connector using the latching mechanism particular to the
cable vendor. When data is being transferred the Green LED will blink. See LED Interfaceunder
the Interfaces section.
5.
Care should be taken as not to impede the air exhaust flow through the ventilation holes. Use
cable lengths which allow for routing horizontally around to the side of the chassis before
bending upward or downward in the rack.
6.
To remove a cable, disengage the locks and slowly pull the connector away from the port
receptacle. LED indicator will turn off when the cable is unseated.
Identifying the Card in Your System
On Linux
Get the device location on the PCI bus by running lspci and locating lines with the string“Mellanox
Technologies”:
Page 26
26
On Windows
1.
Open Device Manager on the server. ClickStart=>Run, and then enterdevmgmt.msc.
2.
ExpandSystem Devicesand locate your Mellanox ConnectX-6 Dx adapter card.
3.
Right click the mouse on your adapter's row and selectPropertiesto display the adapter card
properties window.
4.
Click theDetailstab and selectHardware Ids(Windows 2012/R2/2016) from thePropertypull-
down menu.
PCI Device (Example)
5.
In theValuedisplay box, check the fields VEN and DEV (fields are separated by ‘&’). In the
display example above, notice the sub-string “PCI\VEN_15B3&DEV_1003”: VEN is equal to
0x15B3 – this is the Vendor ID of Mellanox Technologies; and DEV is equal to 1018 (for
ConnectX-6 Dx) – this is a valid Mellanox Technologies PCI Device ID.
If the PCI device does not have a Mellanox adapter ID, return to Step 2 to check
another device.
The list of Mellanox Technologies PCI Device IDs can be found in the PCI ID
repository at http://pci-ids.ucw.cz/read/PC/15b3.
Uninstalling the Card
Safety Precautions
The adapter is installed in a system that operates with voltages that can be lethal. Before uninstalling
the adapter card, please observe the following precautions to avoid injury and prevent damage to
system components.
Page 27
27
1.
Remove any metallic objects from your hands and wrists.
2.
It is strongly recommended to use an ESD strap or other antistatic devices.
3.
Turn off the system and disconnect the power cord from the server.
Card Removal
Please note that the following images are for illustration purposes only.
1.
Verify that the system is powered off and unplugged.
2.
Wait 30 seconds.
3.
To remove the card, disengage the retention mechanisms on the bracket (clips or screws).
4.
Holding the adapter card from its center, gently pull the ConnectX-6 and Auxiliary Connections
cards out of the PCI Express slot.
Please use the relevant driver installation section.
•
Linux Driver Installation
•
Windows Driver Installation
•
VMware Driver Installation
Linux Driver Installation
This section describes how to install and test the Mellanox OFED for Linux package on a single server
with a Mellanox ConnectX-5 adapter card installed.
Prerequisites
RequirementsDescription
PlatformsA server platform with a Mellanox ConnectX-6 Dx EN adapter
card installed (firmware: fw-ConnectX6Dx)
Required Disk Space for Installation1GB
Device IDFor the latest list of device IDs, please visit the Mellanox
website athttp://www.mellanox.com/page/
firmware_HCA_FW_identification.
Operating SystemLinux operating system.
For the list of supported operating system distributions and
kernels, please refer to the
file.
InstallerPrivilegesThe installation requires administrator (root) privileges on
the target machine.
Mellanox OFED Release Notes
Downloading Mellanox OFED
1.
Verify that the system has a Mellanox network adapter installed.
The following example shows a system with an installed Mellanox adapter card:
In the output example above, the first two rows indicate that one card is installed in a PCI slot
with PCI Bus address 05 (hexadecimal), PCI Device number 00 and PCI Function number 0 and
1. The other card is installed in a PCI slot with PCI Bus address 82 (hexadecimal), PCI Device
number 00 and PCI Function number 0 and 1.
2.
Download the ISO image to your host.
The image’s name has the format MLNX_OFED_LINUX-<ver>-<OS label><CPU arch>.iso.
You can download and install the latest OpenFabrics Enterprise Distribution (OFED) software
package available via the Mellanox web site athttp://www.mellanox.com> Products > Software
> Ethernet Drivers > Linux SW/Drivers > Download..
Scroll down to the Download wizard, and click the Download tab.
b.
Choose your relevant package depending on your host operating system.
c.
Click the desired ISO/tgzpackage.
d.
To obtain the download link, accept the End User License Agreement (EULA).
3.
Use the md5sum utility to confirm the file integrity of your ISO image. Run the following
command and compare the result to the value provided on the download page.
Installing Mellanox OFED
Installation Script
The installation script, mlnxofedinstall, performs the following:
•
Discovers the currently installed kernel
•
Uninstalls any software stacks that are part of the standard operating system distributionor
another vendor's commercial stack
•
Installs the MLNX_OFED_LINUX binary RPMs (if they are available for the currentkernel)
•
Identifies the currently installed Mellanox network adapters and automatically upgrades the
firmware.
Note:The firmware will not be updated if you run the install script with the ‘--without-fwupdate’ option.
Note: If you wish to perform a firmware upgrade using customized FW binaries, you canprovide
a path to the folder that contains the FW binary files, by running --fw-image-dir. Using this
option, the FW version embedded in the MLNX_OFED package will beignored.Example:
Usage
Pre-existing configuration files will be saved with the extension “.conf.rpmsave”.
The installation script removes all previously installed Mellanox OFED packages and re-installs from
scratch. You will be prompted to acknowledge the deletion of the old packages.
•
If you need to install Mellanox OFED on an entire (homogeneous) cluster, a commonstrategy is
to mount the ISO image on one of the cluster nodes and then copy it to ashared file system such
as NFS. To install on all the cluster nodes, use cluster-awaretools (such as pdsh).
•
If your kernel version does not match with any of the offered pre-built RPMs, you canadd your
kernel version by using the “mlnx_add_kernel_support.sh” script locatedinside the
MLNX_OFED package.
On Redhat and SLES distributions with errata kernel installed there is no need to use
the mlnx_add_kernel_support.sh script. The regular installation can be performed and
weak updates mechanism will create symbolic links to the MLNX_OFED kernel
modules.
Page 30
30
The “mlnx_add_kernel_support.sh” script can be executed directly from the mlnxofedinstall
# ./MLNX_OFED_LINUX-x.x-x-rhel6.3-x86_64/mlnx_add_kernel_support.sh -m /tmp/MLNX_OFED_LINUX-x.x-x-rhel6.3x86_64/ --make-tgz
Note: This program will create MLNX_OFED_LINUX TGZ for rhel6.3 under /tmp directory.
All Mellanox, OEM, OFED, or Distribution IB packages will be removed.
Do you want to continue?[y/N]:y
See log file /tmp/mlnx_ofed_iso.21642.log
Building OFED RPMs. Please wait...
Removing OFED RPMs...
Created /tmp/MLNX_OFED_LINUX-x.x-x-rhel6.3-x86_64-ext.tgz
./mlnxofedinstall --h
# mount -o ro,loop MLNX_OFED_LINUX-<ver>-<OS label>-<CPU arch>.iso /mnt
script. For further information, please see '--add-kernel-support' option below.
On Ubuntu and Debian distributions drivers installation use Dynamic Kernel Module
Support (DKMS) framework. Thus, the drivers' compilation will take place on the host
during MLNX_OFED installation. Therefore, using "mlnx_add_kernel_support.sh" is
irrelevant on Ubuntu and Debian distributions.
Example
The following command will create a MLNX_OFED_LINUX ISO image for RedHat 6.3 under the /
tmp directory.
•
The script adds the following lines to /etc/security/limits.conf for the userspace components
such as MPI:
•
* soft memlock unlimited
•
* hard memlock unlimited
•
These settings set the amount of memory that can be pinned by a user space application
to unlimited. If desired, tune the value unlimited to a specific amount of RAM.
For your machine to be part of thefabric, a Subnet Manager must be running on one of the fabric
nodes. At this point, Mellanox OFED for Linux has already installed the OpenSM Subnet Manager on
your machine.
For the list of installation options, run:
The DKMS (on Debian based OS) and the weak-modules (RedHat OS) mechanisms rebuild the
initrd/initramfs for the respective kernel in order to add the MLNX_OFED drivers.
When installing MLNX_OFED without DKMS support on Debian based OS, or without KMP
support on RedHat or any other distribution, the initramfs will not be changed. Therefore, the
inbox drivers may be loaded on boot. In this case, openibd service script will automatically
unload them and load the new drivers that come with MLNX_OFED.
Installation Procedure
1.
Login to the installation machine as root.
2.
Mount the ISO image on your machine.
3.
Run the installation script.
Page 31
31
/mnt/mlnxofedinstall
Logs dir: /tmp/MLNX_OFED_LINUX-x.x-x.logs
This program will install the MLNX_OFED_LINUX package on your machine.
Note that all other Mellanox, OEM, OFED, RDMA or Distribution IB packages will be removed.
Those packages are removed due to conflicts with MLNX_OFED_LINUX, do not reinstall them.
Starting MLNX_OFED_LINUX-x.x.x installation ...
........
........
Installation finished successfully.
Attempting to perform Firmware update...
Querying Mellanox devices firmware ...
For unattended installation, use the --force installation option while running the
MLNX_OFED installation script:
/mnt/mlnxofedinstall --force
MLNX_OFED for Ubuntu should be installed with the following flags in the root
environment:
./mlnxofedinstall --without-dkms --add-kernel-support --kernel <kernel
version in chroot> --without-fw-update --force
Note that the path to kernel sources (--kernel-sources) should be added if the sources
are not in their default location.
In case that your machine has the latest firmware, no firmware update will occur and
the installation script will print at the end of the installation a message similar to the
following:
Device #1:
---------Device Type: ConnectX-6 Dx
Part Number: MCX623106AC-CDAT
Description: ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0 x16,
Crypto and Secure Boot, Tall Bracket
PSID: MT_2190110032
PCI Device Name: 0b:00.0
Base MAC: 0000e41d2d5cf810
Versions: Current Available
FW 16.22.0228 16.22.0228
Status: Up to date
Page 32
32
In case that your machine has an unsupported network adapter device, no firmware
update will occur and one of the following error messages below will be printed. Please
contact your hardware vendor for help on firmware updates.
Error message 1:
Device #1:
----------
Device Type: ConnectX-6 Dx
Part Number: MCX623106AC-CDAT
Description: ConnectX®-6 Dx EN adapter card, 100GbE, Dual-port QSFP56, PCIe 4.0 x16,
Crypto and Secure Boot, Tall Bracket
PSID: MT_2190110032
PSID: MT_2190110032
PCI Device Name: 0b:00.0
Base MAC: 0000e41d2d5cf810
Versions: Current Available
FW 16.22.0228 N/A
Status: No matching image found
Error message 2:
The firmware for this device is not distributed inside Mellanox driver: 0000:01:00.0 (PSID:
IBM2150110033)
To obtain firmware for this device, please contact your HW vendor.
4.
If the installation script has performed a firmware update on your network adapter,
completethe step relevant to your adapter card type to load the firmware:
•ConnectX-5/ConnectX-5 Ex - perform a standard reboot
Otherwise, restart the driver by running: /etc/init.d/openibd restart
After installation completion, information about the Mellanox OFED installation, such as prefix, kernel
version, and installation parameters can be retrieved by running the command /etc/infiniband/info.
Most of the Mellanox OFED components can be configured or reconfigured after the installation, by
modifying the relevant configuration files. See the relevant chapters in this manual for details.
The list of the modules that will be loaded automatically upon boot can be found in the /etc/infiniband/
openib.conf file.
Installation Results
SoftwareMost of MLNX_OFED packages are installed under the “/usr” directory
•
except for the following packages which are installed under the “/opt”
directory:
•
fca and ibutils
•
The kernel modules are installed under
•
/lib/modules/`uname -r`/updates on SLES and Fedora
Distributions
•
/lib/modules/`uname -r`/extra/mlnx-ofa_kernel on RHEL and
other Red Hat like Distributions
Page 33
33
FirmwareThe firmware of existing network adapter devices will be updated if the
The installation script is run in default mode; that is, without
the option ‘--without-fw-update’
•
The firmware version of the adapter device is older than the
firmware version included with the Mellanox OFED ISO image
Note: If an adapter’s flash was originally programmed with an
Expansion ROM image, the automatic firmware update will also
burn an Expansion ROM image.
•
In case that your machine has an unsupported network adapter device,
no firmware update will occur and the error message below will be
The firmware for this device is not distributed inside Mellanox driver:
0000:01:00.0 (PSID: IBM2150110033)
To obtain firmware for this device, please contact your HW vendor.
printed.
Installation Logs
While installing MLNX_OFED, the install log for each selected package will be saved in a separate log
file.The path to the directory containing the log files will be displayed after running the installation
script in the following format: "Logs dir: /tmp/MLNX_OFED_LINUX-<version>.<PD>.logs".
Example:
openibd Script
As of MLNX_OFED v2.2-1.0.0 the openibd script supports pre/post start/stop scripts:
This can be controlled by setting the variables below in the /etc/infiniband/openibd.conf file.
Example:
An example of OPENIBD_POST_START script for activating all interfaces is provided in the
MLNX_OFED package under the docs/scripts/openibd-post-start-configure-interfaces/ folder.
Driver Load Upon System Boot
Upon system boot, the Mellanox drivers will be loaded automatically.
To prevent automatic load of the Mellanox drivers upon system boot:
1.
Add the following lines to the "/etc/modprobe.d/mlnx.conf" file.
[mlnx_ofed]
name=MLNX_OFED Repository
baseurl=file:///<path to extracted MLNX_OFED package>/RPMS
enabled=1
gpgkey=file:///<path to the downloaded key RPM-GPG-KEY-Mellanox>
gpgcheck=1
# yum repolist
Loaded plugins: product-id, security, subscription-manager
This system is not registered to Red Hat Subscription Management. You can use subscription-manager to
register.
repo id repo name status
mlnx_ofed MLNX_OFED Repository 108
rpmforge RHEL 6Server - RPMforge.net - dag 4,597
Create a yum repository configuration file called "/etc/yum.repos.d/mlnx_ofed.repo"with the
following content:
7.
Check that the repository was successfully added.
Installing MLNX_OFED Using the YUM Tool
After setting up the YUM repository for MLNX_OFED package, perform the following:
1.
View the available package groups by invoking:
Where:
Page 36
36
mlnx-ofed-all Installs all available packages in MLNX_OFED.
mlnx-ofed-basic Installs basic packages required for running Mellanox cards.
mlnx-ofed-guest Installs packages required by guest OS.
mlnx-ofed-hpc Installs packages required for HPC.
mlnx-ofed-hypervisor Installs packages required by hypervisor OS.
mlnx-ofed-vma Installs packages required by VMA.
mlnx-ofed-vma-eth Installs packages required by VMA to work over Ethernet.
mlnx-ofed-vma-vpi Installs packages required by VMA to support VPI.
Note: MLNX_OFED provides kernel module RPM packages with KMP support for RHEL and
SLES. For other operating systems, kernel module RPM packages are provided only for the
operating systems' default kernel. In this case, the group RPM packages have the supported
kernel version in their package's name.
Example:
If you have an operating system different than RHEL or SLES, or you have installed a kernel that
is not supported by default in MLNX_OFED, you can use the mlnx_add_kernel_support.sh script
to build MLNX_OFED for your kernel.
The script will automatically build the matching group RPM packages for your kernel so that you
can still install MLNX_OFED via yum.
Please note that the resulting MLNX_OFED repository will contain unsigned RPMs, therefore,
you should set 'gpgcheck=0' in the repository configuration file.
2.
Install the desired group.
Uninstalling MLNX_OFED Using the YUM Tool
Use the script /usr/sbin/ofed_uninstall.sh to uninstall the Mellanox OFED package. The script is part of
the ofed-scripts RPM.
Installing MLNX_OFED Using apt-get Tool
This type of installation is applicable to Debian and Ubuntu operating systems.
Page 37
37
Setting up MLNX_OFED apt-get Repository
# deb file:/<path to extracted MLNX_OFED package>/DEBS ./
Extract the MLNX_OFED pacakge on a shared location in your network.
You can download it from http://www.mellanox.com > Products > Software> Ethernet Drivers.
3.
Create an apt-get repository configuration file called"/etc/apt/sources.list.d/mlnx_ofed.list"
with the following content:
4.
Download and install Mellanox Technologies GPG-KEY.
5.
Check that the key was successfully imported.
6.
Update the apt-get cache.
Installing MLNX_OFED Using the apt-get Tool
After setting up the apt-get repository for MLNX_OFED package, perform the following:
In case that you ran the mlnxofedinstall script with the ‘--without-fw-update’ option or you are using an
OEM card and now you wish to (manually) update the firmware on your adapter card(s), you need to
perform the steps below. The following steps are also appropriate in case that you wish to burn newer
firmware that you have downloaded from Mellanox Technologies’ Web site (http://www.mellanox.com >
Support > Firmware Download).
1.
Get the device’s PSID.
Page 39
39
2.
mlxfwmanager_pci | grep PSID
PSID: MT_1210110019
mlxfwmanager_pci -i <fw_file.bin>
fw_updater: Firmware was updated. Please reboot your system for the changes to take effect.
fw_updater: Didn't detect new devices with old firmware.
MLNX_EXCLUDE_DEVICES="00:05.0,00:07.0"
Download the firmware BIN file from the Mellanox website or the OEM website.
3.
Burn the firmware.
4.
Reboot your machine after the firmware burning is completed.
Updating the Device Firmware Automatically upon System Boot
As of MLNX_OFED v3.1-x.x.x, firmware can be automatically updated upon system boot.The firmware
update package (mlnx-fw-updater) is installed in the “/opt/mellanox/mlnx-fw-updater” folder, and
openibd service script can invoke the firmware update process if requested on boot.
If the firmware is updated, the following message is printed to the system’s standard logging file:
Otherwise, the following message is printed:
Please note, this feature is disabled by default. To enable the automatic firmware update upon system
boot, set the following parameter to “yes” “RUN_FW_UPDATER_ONBOOT=yes” in the openibd service
configuration file “/etc/infiniband/openib.conf”.
You can opt to exclude a list of devices from the automatic firmware update procedure. To do so, edit
the configurations file “/opt/mellanox/mlnx-fw-updater/mlnx-fw-updater.conf” and provide a comma
separated list of PCI devices to exclude from the firmware update.
Example:
UEFI Secure Boot
All kernel modules included in MLNX_OFED for RHEL7 and SLES12 are signed with x.509 key to
support loading the modules when Secure Boot is enabled.
Enrolling Mellanox's x.509 Public Key on Your Systems
In order to support loading MLNX_OFED drivers when an OS supporting Secure Boot boots on a UEFIbased system with Secure Boot enabled, the Mellanox x.509 public key should be added to the UEFI
Secure Boot key database and loaded onto the system key ring by the kernel.
Follow these steps below to add the Mellanox's x.509 public key to your system:
Prior to adding the Mellanox's x.509 public key to your system, please make sure that (1) The
'mokutil' package is installed on your system, and (2) The system is booted in UEFI mode.
Add the public key to the MOK list using the mokutil utility.
3.
Reboot the system.
The pending MOK key enrollment request will be noticed by shim.efi and it will launch MokManager.efi
to allow you to complete the enrollment from the UEFI console. You will need to enter the password
you previously associated with this request and confirm the enrollment. Once done, the public key is
added to the MOK list, which is persistent. Once a key is in the MOK list, it will be automatically
propagated to the system key ring and subsequent will be booted when the UEFI Secure Boot is
enabled.
To see what keys have been added to the system key ring on the current boot, install the
'keyutils' package and run: #keyctl list %:.system_keyring#
Removing Signature from kernel Modules
The signature can be removed from a signed kernel module using the 'strip' utility which is provided by
the 'binutils' package.The strip utility will change the given file without saving a backup. The operation
can be undo only by resigning the kernel module. Hence, we recommend backing up a copy prior to
removing the signature.
To remove the signature from the MLNX_OFED kernel modules:
1.
Remove the signature.
After the signature has been removed, a message as the below will no longer be presented upon
module loading:
However, please note that a similar message as the following will still be presented:
This message is only presented once, upon first module boot that either has no signature or
whose key is not in the kernel key ring. Therefore, this message may go unnoticed. Once the
system is rebooted after unloading and reloading a kernel module, the message will appear.
(Note that this message cannot be eliminated.)
2.
Update the initramfs on RHEL systems with the stripped modules.
Page 41
41
Performance Tuning
echo %PROCESSOR_ARCHITECTURE%
Depending on the application of the user's system, it may be necessary to modify the default
configuration of network adapters based on the ConnectX® adapters. In case that tuning is required,
please refer to the Performance Tuning Guide for Mellanox Network Adaptersat https://
community.mellanox.com/docs/DOC-2489.
Windows Driver Installation
For Windows, download and install the latest Mellanox WinOF-2 for Windows software package
available via the Mellanox web site at: http://www.mellanox.com> Products > Software > Ethernet
Drivers > Download. Follow the installation instructions included in the download package (also
available from the download page).
The snapshots in the following sections are presented for illustration purposes only. The
installation interface may slightly vary, depending on the operating system in use.
Software Requirements
DescriptionPackage
Windows Server 2012 R2MLNX_WinOF2-2_10_All_x64.exe
Windows Server 2012
Windows Server 2016
Windows Server 2019
Windows 8.1 Client (64 bit only)
Windows 10 Client (64 bit only)
Note: The Operating System listed above must run with administrator privileges.
Downloading Mellanox WinOF-2 Driver
To download the executable file according to your operating system, please follow the steps below:
1.
Obtain the machine architecture.
a.
To go to the Start menu, position your mouse in the bottom-right corner of the Remote
Desktop of your screen.
b.
Open a CMD console. (Click Task Manager > File > Run new task, and enter CMD.)
c.
Enter the following command.
On an x64 (64-bit) machine, the output will be “AMD64”.
Go to the Mellanox WinOF-2 web page athttp://www.mellanox.com> Products > Ethernet
Drivers > Windows SW/Drivers.
3.
Download the exe image according to the architecture of your machine (see Step 1).The name
of the .exe is in the following format:MLNX_WinOF2-<version>_x<arch>.exe.
Installing the incorrect exe file is prohibited. If you do so, an error message will be displayed.
For example, if you try to install a 64-bit executable file on a 32-bit machine, the wizard will
display the following (or a similar) error message: “The installation package is not supported
by this processor type. Contact your vendor.”
Installing Mellanox WinOF-2 Driver
The snapshots in the following sections are for illustration purposes only. The installation
interface may slightly vary, depending on the used operating system.
This section provides instructions for two types of installation procedures, and bothrequire
administrator privileges:
•
Attended Installation -An installation procedure that requires frequent user intervention.
•
Unattended Installation -An automated installation procedure that requires no user
intervention.
Both Attended and Unattended installations require administrator privileges.
Attended Installation
The following is an example of an installation session.
1.
Double click the .exe and follow the GUI instructions to install MLNX_WinOF2.
2.
[Optional] Manually configure your setup to contain the logs option (replace “LogFile” with the
relevant directory):
3.
[Optional] If you do not want to upgrade your firmware version. (Note:MT_SKIPFWUPGRD
default value is False.)
Page 43
43
4.
Click Next in the Welcome screen.
5.
Read and accept the license agreement and click Next.
6.
Select the target folder for the installation.
Page 44
44
7.
The firmware upgrade screen will be displayed in the following cases:
•
If the user has an OEM card. In this case, the firmware will not be displayed.
•
If the user has a standard Mellanox card with an older firmware version, the
firmware will be updated accordingly. However, if the user has both an OEM card
and a Mellanox card, only the Mellanox card will be updated.
Page 45
45
8.
Select a Complete or Custom installation, followStepaonward.
a.
Select the desired feature to install:
•
Performances tools - install the performance tools that are used to measure
performance inuserenvironment
•
Documentation - contains the User Manual and Release Notes
•
Management tools - installation tools used for management, such asmlxstat
•
Diagnostic Tools - installation tools used for diagnostics, such as mlx5cmd
b.
Click Next to install the desired tools.
Page 46
46
9. Click Install to start the installation.
10. In case firmware upgrade option was checked inStep 7, you will be notified if a firmware upgrade is
required (see).
Click Change and specify the location in which the files are extracted to.
Page 50
50
5.
Click Install to extract this folder, or click Change to install to a different folder.
Page 51
51
6.•To complete the extraction, click Finish.
Firmware Upgrade
If the machine has a standard Mellanox card with an older firmware version, the firmware will be
automatically updated as part of the WinOF-2 package installation.
For information on how to upgrade firmware manually, please refer to the MFT User Manual atwww.m
Install the image according to the steps described in the MFT User Manual.
The following procedure requires custom boot image downloading, mounting and
booting from a USB device.
Page 54
54
Updating Adapter Firmware
[server1]# ./mlxup
Querying Mellanox devices firmware ...
Device Type: ConnectX-6 Dx
Part Number: MCX623105AN-VDAT
Description: ConnectX®-6 Dx EN adapter card, 200GbE , Single-port QSFP56, PCIe 4.0 x16, No Crypto, Tall Bracket
PSID: MT_2190110032
PCI Device Name: 0000:06:00.0
Base GUID: e41d2d0300fd8b8a
Versions: Current Available
FW 16.23.1020 16.24.1000
Status: Update required
Device Type: ConnectX-6 Dx
Part Number: MCX623105AN-VDAT
Description: ConnectX®-6 Dx EN adapter card, 200GbE , Single-port QSFP56, PCIe 4.0 x16, No Crypto, Tall Bracket
PSID: MT_2170110021
PCI Device Name: 0000:07:00.0
Base MAC: 0000e41d2da206d4
Versions: Current Available
FW 16.24.1000 16.24.1000
Status: Up to date
Perform FW update? [y/N]: y
Device #1: Up to date
Device #2: Updating FW ... Done
Restart needed for updates to take effect.
Log File: /var/log/mlxup/mlxup-yyyymmdd.log
Each adapter card is shipped with the latest version of qualified firmware at the time of manufacturing.
However, Mellanox issues firmware updates occasionally that provide new features and bug fixes. To
check that your card is programmed with the latest available firmware version, download the mlxup
firmware update and query utility. The utility can query for available Mellanox adapters and indicate
which adapters require a firmware update. If the user confirms, mlxup upgrades the firmware using
embedded images. The latest mlxup executable and documentation are available from http://
Server unable to find theadapterEnsure that the adapter is placed correctly
The adapter no longer worksReseat the adapter in its slot or a different slot, if
Adapters stopped working afterinstalling another
adapter
Link indicator light is offTry another port on the switch
Link light is on, but with nocommunication
established
•
•
Make sure the adapter slot and the adapter are
compatible
Install the adapter in a different PCI Express slot
•
Use the drivers that came with the adapter or
download the latest
•
Make sure your motherboard has the latest BIOS
•
Try to reboot the server
•
necessary
•
Try using another cable
•
Reinstall the drivers for the network driver files
may be damaged or deleted
•
Reboot the server
•
Try removing and re-installing all adapters
•
Check that cables are connected properly
•
Make sure your motherboard has the latest BIOS
•
•
Make sure the cable is securely attached
•
Check you are using the proper cables that do not
exceed the recommended lengths
•
Verify that your switch and adapter port are
compatible
•
Check that the latest driver is loaded
•
Check that both the adapter and its link are set to
the same speed and duplex settings
LinuxTroubleshooting
Environment Informationcat /etc/issue
uname -a
cat /proc/cupinfo | grep ‘model name’ | uniq
ofed_info -s
ifconfig -a
ip link show
ethtool <interface>
ethtool -i <interface_of_Mellanox_port_num>
ibdev2netdev
Card Detectionlspci | grep -i Mellanox
Page 56
56
Mellanox Firmware Tool (MFT)Download and install MFT:http://www.mellanox.com/
PCI Express Gen 3.0/4.0: SERDES @ 16.0GT/s, 16 lanes (2.0 and 1.1 compatible)
Voltage: 12V
PowerCable TypePCIe Gen 3.0PCIe Gen 4.0
Typical Power
Maximum PowerPassive Cables18.92W19.74W
Maximum power available through SFP56 port:2.5W (each port)
Voltage: 3.3Aux
Maximum current: 100mA
Temperature
Humidity
(b)
Passive Cables14.87W15.68W
Operational0°C to 55°C
Non-operational-40°C to 70°C
90% relative humidity
(c)
Environmenta
l
Regulatory
Altitude (Operational)3050m
Cable TypeHot Aisle - Heatsink to Port
Airflow Requirements @ 55C
SafetyCB / cTUVus / CE
EMCCE / FCC / VCCI / ICES / RCM
RoHSRoHS compliant
(d)(e)
Passive Cable300LFM
Active 0.8 Cable400LFM
Active 2.5W Cable500LFM
a.Power numbers are provided for passive cables only. For board power numbers while using active
cables, please add the outcome of the following formula to the passive cables power numbers stated
above:
Active_Module_Power
xN
umber_of_Modules
x1.1 (efficiency factor)
b. Typical power for ATIS traffic load.
c. For both operational and non-operational states.
d. Airflow is measured in wind tunnel.
e.Contact Mellanox for airflow numbers with other active modules' power levels.
Page 59
59
MCX623102A[C/N/S/E]-GDAT Specifications
PhysicalSize: 5.59in. x 2.71in (142.00mm x 68.90mm)
Connector: DualSFP56 Ethernet (copper and optical)
All dimensions are in millimeters. All the mechanical tolerances are +/- 0.1mm.
Page 66
66
Dual-Port SFP28/SFP56 Adapter Card
Short Bracket
Tall Bracket
Single-Port QSFP56 Adapter Card
Short Bracket
Tall Bracket
Page 67
67
Dual-Port QSFP56 Adapter Card
Short Bracket
Tall Bracket
Page 68
68
Finding the MAC on the Adapter Card
Each Mellanox adapter card has a different identifier printed on the label: serial number and the card
MAC for the Ethernet protocol.
The product revisions indicated on the labels in the following figures do not necessarily
represent the latest revisions of the cards.
MCX621102AC-ADAT Board Label ExampleMCX621102AN-ADAT Board Label Example
MCX623102AC-ADAT Board Label ExampleMCX623102AN-ADAT Board Label Example
MCX623102AC-GDAT Board Label ExampleMCX623102AN-GDAT Board Label Example
Page 69
69
MCX623102AS-GDAT Board Label Example MCX623106AS-CDAT Board Label Example
MCX623106AC-CDAT Board Label ExampleMCX623106AN-CDAT Board Label Example
MCX623105AC-VDAT Board Label ExampleMCX623105AN-VDAT Board Label Example
Page 70
70
MCX623105AS-VDAT Board Label Example
Page 71
71
Document Revision History
DateRevisionDescription of Changes
Sep. 20201.8Updated power numbers in "Specifications".
Aug. 20201.7Updated power numbers in "Specifications".
Aug. 20201.6Updated LED specifications in "Interfaces".
Jul. 20201.5Updatedpower numbers in "Specifications".
Jul. 20201.4Updated power numbers in "Specifications".
Jun. 20201.3Updated airflow numbers.
Added the following OPNs to all relevant sections:
•
MCX621102AE-ADAT
•
MCX623102AS-GDAT
•
MCX623102AC-GDAT
•
MCX623106AE-CDAT
•
MCX623106PC-CDAT
•
MCX623106PN-CDAT
•
MCX623106PE-CDAT
•
MCX623105AE-VDAT
May. 20201.2Updated power numbers.
Feb. 20201.1Added the following OPNs to all relevant sections:
•
MCX623106AS-CDAT
•
MCX623105AS-VDAT
•
MCX623102AS-GDAT
Nov. 20191.0First release
Page 72
Mellanox Technologies | 350 Oakmead Parkway Suite 100, Sunnyvale, CA 94085 http://
www.mellanox.com
Notice
This document is provided for information purposes only and shall not be regarded as a warranty of a
certain functionality, condition, or quality of a product. Neither NVIDIA Corporation nor any of its direct
or indirect subsidiaries (collectively: “NVIDIA”) make any representations or warranties, expressed or
implied, as to the accuracy or completeness of the information contained in this document and
assumes no responsibility for any errors contained herein. NVIDIA shall have no liability for the
consequences or use of such information or for any infringement of patents or other rights of third
parties that may result from its use. This document is not a commitment to develop, release, or deliver
any Material (defined below), code, or functionality.
NVIDIA reserves the right to make corrections, modifications, enhancements, improvements, and any
other changes to this document, at any time without notice.
Customer should obtain the latest relevant information before placing orders and should verify that
such information is current and complete.
NVIDIA products are sold subject to the NVIDIA standard terms and conditions of sale supplied at the
time of order acknowledgement, unless otherwise agreed in an individual sales agreement signed by
authorized representatives of NVIDIA and customer (“Terms of Sale”). NVIDIA hereby expressly objects
to applying any customer general terms and conditions with regards to the purchase of the NVIDIA
product referenced in this document. No contractual obligations are formed either directly or
indirectly by this document.
NVIDIA products are not designed, authorized, or warranted to be suitable for use in medical, military,
aircraft, space, or life support equipment, nor in applications where failure or malfunction of the
NVIDIA product can reasonably be expected to result in personal injury, death, or property or
environmental damage. NVIDIA accepts no liability for inclusion and/or use of NVIDIA products in such
equipment or applications and therefore such inclusion and/or use is at customer’s own risk.
NVIDIA makes no representation or warranty that products based on this document will be suitable for
any specified use. Testing of all parameters of each product is not necessarily performed by NVIDIA. It
is customer’s sole responsibility to evaluate and determine the applicability of any information
contained in this document, ensure the product is suitable and fit for the application planned by
customer, and perform the necessary testing for the application in order to avoid a default of the
application or the product. Weaknesses in customer’s product designs may affect the quality and
reliability of the NVIDIA product and may result in additional or different conditions and/or
requirements beyond those contained in this document. NVIDIA accepts no liability related to any
default, damage, costs, or problem which may be based on or attributable to: (i) the use of the NVIDIA
product in any manner that is contrary to this document or (ii) customer product designs.
No license, either expressed or implied, is granted under any NVIDIA patent right, copyright, or other
NVIDIA intellectual property right under this document. Information published by NVIDIA regarding
third-party products or services does not constitute a license from NVIDIA to use such products or
services or a warranty or endorsement thereof. Use of such information may require a license from a
third party under the patents or other intellectual property rights of the third party, or a license from
NVIDIA under the patents or other intellectual property rights of NVIDIA.
Reproduction of information in this document is permissible only if approved in advance by NVIDIA in
writing, reproduced without alteration and in full compliance with all applicable export laws and
regulations, and accompanied by all associated conditions, limitations, and notices.
THIS DOCUMENT AND ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES,
DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS (TOGETHER AND SEPARATELY,
“MATERIALS”) ARE BEING PROVIDED “AS IS.” NVIDIA MAKES NO WARRANTIES, EXPRESSED,
IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO THE MATERIALS, AND EXPRESSLY
DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY, AND FITNESS
FOR A PARTICULAR PURPOSE. TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL
NVIDIA BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT,
SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND
REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN
IF NVIDIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Notwithstanding any
damages that customer might incur for any reason whatsoever, NVIDIA’s aggregate and cumulative
Page 73
Mellanox Technologies | 350 Oakmead Parkway Suite 100, Sunnyvale, CA 94085 http://
www.mellanox.com
liability towards customer for the products described herein shall be limited in accordance with the
Terms of Sale for the product.
Trademarks
NVIDIA, the NVIDIA logo, and Mellanox are trademarks and/or registered trademarks of Mellanox
Technologies Ltd. and/or NVIDIA Corporationin the U.S. and in other countries. Other company and
product names may be trademarks of the respective companies with which they are associated.
For the complete and most updated list of Mellanox trademarks, visit http://www.mellanox.com/page/