Connectx-3 pro vpi single and dual qsfp+ port adapter card (79 pages)
Summary of Contents for Mellanox Technologies ConnectX-5
Page 1
Mellanox ConnectX®-5 Ex 100Gb/s VPI Single and Dual Adapter Cards User Manual P/N: MCX555A-ECAT, MCX556A-ECAT, MCX556A-EDAT Rev 1.5 www.mellanox.com Mellanox Technologies...
Page 2
ENVIRONMENT HAS NOT MET THE STANDARDS SET BY MELLANOX TECHNOLOGIES TO FULLY QUALIFY THE PRODUCT (S) AND/OR THE SYSTEM USING IT . THEREFORE , MELLANOX TECHNOLOGIES CANNOT AND DOES NOT GUARANTEE OR WARRANT THAT THE PRODUCTS WILL OPERATE WITH THE HIGHEST QUALITY .
Page 5
Appendix C Avertissements de sécurité d’installation (Warnings in French) 68 Appendix D Sicherheitshinweise (Warnings in German) ....70 Appendix E Advertencias de seguridad para la instalación (Warnings in Spanish) 72 Rev 1.5 Mellanox Technologies...
• MCX556A-ECAT Specification Table on page 56 • MCX556A-EDAT Specification Table on page 57 • Updated Linux on page 22 April 2017 • Updated Product Overview on page 9 • Updated Card Installation Instructions on page 15 March 2017 First release Mellanox Technologies...
About This Manual This User Manual describes Mellanox Technologies ConnectX®-5 Ex VPI Single and Dual QSFP28 port PCI Express x16 adapter cards. It provides details as to the interfaces of the board, specifications, required software and firmware for operating the board, and relevant documenta- tion.
Page 10
The Mellanox support downloader contains software, firmware and knowledge database infor- mation for Mellanox products. Access the database from the Mellanox Support web page, http://www.mellanox.com => Support Or use the following link to go directly to the Mellanox Support Download Assistant page, http://www.mellanox.com/supportdownloader/. Rev 1.5 Mellanox Technologies...
Introduction Introduction This is the User Guide for Mellanox Technologies VPI adapter cards based on the ConnectX®-5 integrated circuit device. These adapters connectivity provide the highest performing and most flexible interconnect solution for PCI Express Gen 3.0/4.0 servers used in Enterprise Data Cen- ters, High-Performance Computing, and Embedded environments.
Overlay Networks work scalability issues, it hides the TCP packet from the hardware offloading engines, placing higher loads on the host CPU. ConnectX-5 effectively addresses this by providing advanced NVGRE and VXLAN hardware offload- ing engines that encapsulate and de-capsulate the overlay protocol.
Introduction Table 4 - Features ConnectX-5, utilizing IBTA RDMA (Remote Data Memory Access) and RoCE (RDMA over Converged Ethernet) technology, delivers low-latency and high- RDMA and RDMA over performance over Band and Ethernet networks. Leveraging data center bridging Converged Ethernet (RoCE)
Introduction Connectivity • Interoperable with 1/10/25/40/50/100 Gb/s Ethernet switches • Passive copper cable with ESD protection • Powered connectors for optical and active cable support Rev 1.5 Mellanox Technologies...
• Auto-negotiates to x16, x8, x4, x2, or x1 • Support for MSI/MSI-X mechanisms LED Interface There is one bi-color I/O LED per port located on the adapter card.For LED specifications, please refer to Section 7.8, “Adapter Card LED Operations”, on page Rev 1.5 Mellanox Technologies...
3. After shutting down the system, turn off power and unplug the cord. Remove the card from its package. Please note that the card must be placed on an antistatic surface.Check the card for visible signs of damage. Do not attempt to install the card if damaged. Rev 1.5 Mellanox Technologies...
Please note that the following figures are for illustration purposes only. 1. Before installing the card, make sure that the system is off and the power cord is not con- nected to the server. Please follow proper electrical grounding procedures. Rev 1.5 Mellanox Technologies...
Do not use excessive force when seating the card, as this may damage the system or the adapter. 5. Close the system case. Cables and Modules To obtain the list of supported Mellanox cables for your adapter, please refer to the Cables Refer- ence Table. Rev 1.5 Mellanox Technologies...
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. Rev 1.5 Mellanox Technologies...
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 adapter card from the PCI Express slot. Rev 1.5 Mellanox Technologies...
1. Open Device Manager on the server. Click Start => Run, and then enter “devmgmt.msc”. 2. Expand System Devices and locate your Mellanox ConnectX-5 adapter card. 3. Right click the mouse on your adapter's row and select Properties to display the adapter card properties window.
5. In the Value display 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-5) – this is a valid Mellanox Technologies PCI Device ID.
Step 1. The following example shows a system with an installed Mellanox HCA: # lspci -v | grep Mellanox 86:00.0 Network controller [0207]: Mellanox Technologies MT27620 Family Subsystem: Mellanox Technologies Device 0014 86:00.1 Network controller [0207]: Mellanox Technologies MT27620 Family Subsystem: Mellanox Technologies Device 0014 Download the ISO image to your host.
NFS. To install on all the cluster nodes, use cluster-aware tools (such as pdsh). 1. The firmware will not be updated if you run the install script with the ‘--without-fw-update’ option. Rev 1.5 Mellanox Technologies...
Page 26
For your machine to be part of the InfiniBand/VPI fabric, 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: ./mlnxofedinstall --h Rev 1.5 Mellanox Technologies...
./mlnxofedinstall --without-dkms --add-kernel-support --kernel <kernel version in chroot> --without-fw-update --force For example: ./mlnxofedinstall --without-dkms --add-kernel-support --kernel 3.13.0-85-generic --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. Rev 1.5 Mellanox Technologies...
Page 28
If the installation script has performed a firmware update on your network adapter, com- Step 4. plete the 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" Rev 1.5 Mellanox Technologies...
0000:01:00.0 (PSID: IBM2150110033) To obtain firmware for this device, please contact your HW ven- dor. 4.1.3.4 Installation Logging While installing MLNX_OFED, the install log for each selected package will be saved in a sepa- rate log file. Rev 1.5 Mellanox Technologies...
To prevent this behavior, update the initramfs using the operating systems’ standard tools. Note: The process of updating the initramfs will add the blacklists from step 1, and will pre- vent the kernel from loading the modules automatically. Rev 1.5 Mellanox Technologies...
Mount the ISO image on your machine and copy its content to a shared location in your net- Step 2. work. # mount -o ro,loop MLNX_OFED_LINUX-<ver>-<OS label>-<CPU arch>.iso /mnt Download and install Mellanox Technologies GPG-KEY: Step 3. The key can be downloaded via the following link: Rev 1.5...
# sudo rpm --import RPM-GPG-KEY-Mellanox warning: rpmts_HdrFromFdno: Header V3 DSA/SHA1 Signature, key ID 6224c050: NOKEY Retrieving key from file:///repos/MLNX_OFED/<MLNX_OFED file>/RPM-GPG-KEY-Mellanox Importing GPG key 0x6224C050: Userid: "Mellanox Technologies (Mellanox Technologies - Signing Key v2) <support@mel- lanox.com>" From : /repos/MLNX_OFED/<MLNX_OFED file>/RPM-GPG-KEY-Mellanox Is this ok [y/N]: Check that the key was successfully imported.
Page 33
MLNX_OFED, you can use the mlnx_add_ker- script to build MLNX_OFED for your kernel. nel_support.sh The script will automatically build the matching group RPM packages for your kernel so that you can still install MLNX_OFED via yum. Rev 1.5 Mellanox Technologies...
To update the firmware to the version included in MLNX_OFED package, run: # apt-get install mlnx-fw-updater Update the firmware to the latest version available on Mellanox Technologies’ Web site as described in 4.1.5.3 Uninstalling Mellanox OFED Using the YUM Tool Use the script to uninstall the Mellanox OFED package.
“apt-get” To update the firmware to the version included in MLNX_OFED package, run: # apt-get install mlnx-fw-updater Update the firmware to the latest version available on Mellanox Technologies’ Web site as described in Rev 1.5 Mellanox Technologies...
OEM card and now you wish to (manually) update 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).
The 'mokutil' package is installed on your system • The system is booted in UEFI mode Download the x.509 public key. Step 1. # wget http://www.mellanox.com/downloads/ofed/mlnx_signing_key_pub.der Add the public key to the MOK list using the mokutil utility. Step 2. Rev 1.5 Mellanox Technologies...
After the signature has been removed, a massage as the below will no longer be presented upon module loading: "Request for unknown module key 'Mellanox Technologies signing key: 61feb074fc7292f958419386ffdd9d5ca999e403' err -11" However, please note that a similar message as the following will still be presented: "my_module: module verification failed: signature and/or required key missing - taint-...
Depending on the application of the user's system, it may be necessary to modify the default con- figuration of network adapters based on the ConnectX® adapters. In case that tuning is required, please refer to the Performance Tuning Guide for Mellanox Network Adapters. Rev 1.5 Mellanox Technologies...
64-bit .exe on a 32-bit machine, the wizard will display the follow- ing (or a similar) error message: “The installation package is not supported by this processor type. Contact your vendor” Rev 1.5 Mellanox Technologies...
[Optional] Manually configure your setup to contain the logs option (replace “LogFile” with Step 2. the relevant directory):. MLNX_WinOF2-1_10_<revision_version>_All_x64.exe /v"/l*vx [LogFile]" [Optional] If you do not want to upgrade your firmware version Step 3. MLNX_WinOF2-1_10_<revision_version>_All_x64.exe /v" MT_SKIPFWUPGRD=1" 1. MT_SKIPFWUPGRD default value is False Rev 1.5 Mellanox Technologies...
Page 42
Driver Installation Click Next in the Welcome screen. Step 4. Read then accept the license agreement and click Next. Step 5. Rev 1.5 Mellanox Technologies...
Page 43
Driver Installation Select the target folder for the installation. Step 6. Rev 1.5 Mellanox Technologies...
Page 44
• Performances tools - install the performance tools that are used to measure performance in user environment • Documentation - contains the User Manual and Release Notes • Management tools - installation tools used for management, such as mlxstat Rev 1.5 Mellanox Technologies...
Page 45
Driver Installation • Diagnostic Tools - installation tools used for diagnostics, such as mlx5cmd b. Click Next to install the desired tools. Click Install to start the installation. Step 9. Rev 1.5 Mellanox Technologies...
Page 46
Driver Installation In case that firmware upgrade option was checked in Step 7, you will be notified if a firm- Step 10. ware upgrade is required (See Click Finish to complete the installation. Step 11. Rev 1.5 Mellanox Technologies...
Upon installation completion, the inf files can be located at: • %ProgramFiles%\Mellanox\MLNX_WinOF2\Drivers\<OS> To see the Mellanox network adapters, display the Device Manager and pull down the “Network adapters” menu. 1. MT_NDPROPERTY default value is True 2. MT_SKIPFWUPGRD default value is False Rev 1.5 Mellanox Technologies...
Open a CMD console-> Click Start-> Task Manager-> File-> Run new task-> and enter Step 1. CMD. Extract the driver and the tools: Step 2. MLNX_WinOF2-1_10_All_x64 /a To extract only the driver files. MLNX_WinOF2-1_10_All_x64 /a /vMT_DRIVERS_ONLY=1 Rev 1.5 Mellanox Technologies...
Page 49
Driver Installation Click Next to create a server image. Step 3. Click Change and specify the location in which the files are extracted to. Step 4. Rev 1.5 Mellanox Technologies...
Page 50
Driver Installation Click Install to extract this folder, or click Change to install to a different folder. Step 5. To complete the extraction, click Finish. Step 6. Rev 1.5 Mellanox Technologies...
Download the driver (MLNX_WinOF2_MLNX_WinOF2-1_64_mlx5_All_win2016_x64_- Step 2. fre_1_64_15407.exe). Extract the driver to a local directory (see Section 4.2.5, “Extracting Files Without Running Step 3. Installation”, on page 46). Copy the contents of this directory to C:\WS2016TP5_Drivers. Step 4. Rev 1.5 Mellanox Technologies...
When upgrading the driver on a server where the remote connection was done over Mella- nox device, there will be a loss of connectivity. To upgrade, it is recommended to run a script that will execute all the required upgrade commands. Rev 1.5 Mellanox Technologies...
Verify that your switch and adapter port are compatible • Check that the latest driver is loaded Link light is on, but with no • Check that both the adapter and its link are set to the same speed and communication established duplex settings Rev 1.5 Mellanox Technologies...
-d <mst_device> q ibstat Ports Information ibv_devinfo To download the latest firmware version refer to Firmware Version Upgrade http://www.mellanox.com/supportdownloader cat /var/log/messages dmesg >> system.log Collect Log File journalctl (Applicable on new operating systems) cat /var/log/syslog Rev 1.5 Mellanox Technologies...
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox Infini- Band product.
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox InfiniBand product.
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox InfiniBand product.
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox Infini- Band product.
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox InfiniBand product.
EMC: CE / FCC / VCCI / ICES / RCM RoHS: RoHS-R6 a. The ConnectX-5 adapters supplement the IBTA auto-negotiation specification to get better bit error rates and longer cable reaches. This supplemental feature only initiates when connected to another Mellanox InfiniBand product.
Indicates a valid logical (data activity) link with no active traffic Blinking Green Indicates a valid logical link with active traffic a. 1 Hz Blinking Amber occurs due to running a beacon command for locating the adapter card. Rev 1.5 Mellanox Technologies...
Board Mechanical Drawing and Dimensions All dimensions are in millimeters. All the mechanical tolerances are +/- 0.1mm. Fore the 3D Model of the card, please refer to Models. Figure 3: Mechanical Drawing of the Dual-port Adapter Cards 142.24 68.9 Rev 1.5 Mellanox Technologies...
GUID and a MAC (derived from the GUID). The revision indicated on the labels in the following figures do not necessarily represent the latest revision of the card. Figure 5: MCX555A-ECAT Board Label (Example) Figure 6: MCX556A-ECAT Board Label (Example) Rev 1.5 Mellanox Technologies...
6. Equipment Disposal Disposal of this equipment should be in accordance to all national laws and regula- tions. 7. Local and National Electrical Codes This equipment should be installed in compliance with local and national electrical codes. Rev 1.5 Mellanox Technologies...
Page 69
Caution – Use of controls or adjustment or performance of procedures other than those specified herein may result in hazardous radiation exposure. CLASS 1 LASER PRODUCT and reference to the most recent laser standards: IEC 60 825-1:1993 + A1:1997 + A2:2001 and EN 60825-1:1994+A1:1996+ A2:20. Rev 1.5 Mellanox Technologies...
L’élimination de ce matériel doit s’effectuer dans le respect de toutes les législations et réglementations nationales en vigueur. 7. Codes électriques locaux et nationaux Ce matériel doit être installé dans le respect des codes électriques locaux et nationaux. Rev 1.5 Mellanox Technologies...
Page 71
Mise en garde – l'utilisation de commandes ou de réglages ou l'exécution de procédures autres que ce qui est spécifié dans les présentes peut engendrer une exposition au rayonnement grave. PRODUIT LASER DE CLASSE 1 » et références aux normes laser les plus récentes CEI 60 825-1 Rev 1.5 Mellanox Technologies...
6. Geräteentsorgung Die Entsorgung dieses Geräts sollte unter Beachtung aller nationalen Gesetze Bestim- mungen erfolgen. 7. Regionale und nationale elektrische Bestimmungen t Dieses Gerät sollte unter Beachtung der regionalen und nationalen elektrischen Bes- timmungen installiert werden. Rev 1.5 Mellanox Technologies...
Page 73
8. Strahlenkontak Achtung – Nutzung von Steuerungen oder Einstellungen oder Ausführung von Prozeduren, die hier nicht spezifiziert sind, kann zu gefährlichem Strahlenkon- takt führen. Klasse 1 Laserprodukt und Referenzen zu den aktuellsten Lasterstandards : ICE 60 825-1 Rev 1.5 Mellanox Technologies...
La eliminación definitiva de este equipo se debe efectuar conforme a todas las leyes y reglamentaciones nacionales. 7. Códigos eléctricos locales y nacionales Este equipo se debe instalar conforme a los códigos eléctricos locales y nacionales. Rev 1.5 Mellanox Technologies...
Page 75
Precaución: el uso de controles o ajustes o la realización de procedimientos distintos de los que aquí se especifican podrían causar exposición a niveles de radiación peligrosos. PRODUCTO LÁSER DE CLASE 1 y referencia a las normas de láser más recientes: IEC 60825-1 Rev 1.5 Mellanox Technologies...