Page 1
MLNX_VPI for Windows Installation Guide www.mellanox.com
Page 2
Rev 2.1.1 NOTE: THIS INFORMATION IS PROVIDED BY MELLANOX FOR INFORMATIONAL PURPOSES ONLY AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIM- ITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILI...
Page 3
Rev 2.1.1 Table of Contents Chapter 1 Introduction 1.1 Scope 1.2 Web Page and Documentation 1.3 Hardware and Software Requirements 1.3.1 Hardware Requirements 1.3.2 Software Requirements Chapter 2 Ide...
Page 4
Introduction Rev 2.1.1 Introduction 1.1 Scope This document describes how to install and test MLNX_VPI for Windows on a single host machine with Mellanox hardware installed. 1.2 Web Page and Documenta...
Page 5
Rev 2.1.1 Infini Host III Lx (MT25204) - Mellanox Infini Band HCA for PCI Express Ethernet Only Mellanox Connect X EN (MT25448) - PCIe 2.0 2.5GT/s, 10Gig E Ethernet Adapter Mellanox Connect X EN (MT25...
Page 6
Identifying Mellanox Adapters on Your Machine Rev 2.1.1 Identifying Mellanox Adapters on Your Machine Step 1. Open Device Manager. Click start--> Run, and then enter “devmgmt.msc”. Step 2. Check th...
Page 7
Rev 2.1.1 Step 4. Click the Details tab and select Device Instance ID (Windows 2003) or Hardware Ids (Windows 2008/R2) from the Property pull-down menu. Step 5. In the Value display box, check the fie...
Page 8
Downloading MLNX_VPIRev 2.1.1 Downloading MLNX_VPI Follow these steps to download the appropriate MSI to your machine. Step 1. Verify the machine architecture. a. Open a CMD console (Click start-->...
Page 9
Rev 2.1.1 Installing MLNX_VPI This sections provides instructions for two types of installation: “Attended Installation” (see below) An attended installation is an installation procedure that requires...
Page 10
Installing MLNX_VPIRev 2.1.1 Step 2. Select the “I accept the terms in the license agreement” radio button and click Next. Step 3. Choose the destination directory for the installation. Step 4. (Optio...
Page 11
Rev 2.1.1 Note: If you check the maximum performance box (see figure below), you will need to reboot your system at the end of installation. Click Next to continue to the next performance dialog. b. T...
Page 12
Installing MLNX_VPIRev 2.1.1 Step 3. To install the package components, click Install. Step 4. In the following window, enable the components you need (if any). To complete the installation, click Fin...
Page 13
Rev 2.1.1 Note: Even if you do not enable any of the displayed components in this step, you will be able to enable components after the installation completes – see “Port Protocol Configuration” on pa...
Page 14
Installation Results Rev 2.1.1 Installation Results Displaying the Device Manager will show the Mellanox adapter devices and an IPo IB (network) device for each port. Note that MLNX_VPI configures the...
Page 15
Rev 2.1.1 Assigning Port IP After Installation By default, your machine is configured to obtain an automatic IP address via a DHCP server. In some cases, the DHCP server may require the MAC address of...
Page 16
Assigning Port IP After Installation Rev 2.1.1 Step 2. Right-click a Mellanox Local Area Connection and left-click Properties. Step 3. On Windows Server 2003: Select Internet Protocol (TCP/IP) from th...
Page 17
Rev 2.1.1 Step 4. Select the “Use the following IP address:” radio button and enter the desired IP informa- tion. Click OK when you are done. Step 5. Close the Local Area Connection dialog. Step 6. Ve...
Page 18
Port Protocol Configuration Rev 2.1.1 Port Protocol Configuration After MLNX_VPI installation, it is possible to change the network protocol that runs on each port of VPI adapter cards. Each port can ...
Page 19
Rev 2.1.1 Note: The figure below is an example of the displayed Port Protocol sheet for a dual port VPI adapter card. Step 3. In this step, you can perform two different functions: (a) Choose the desi...
Page 20
Advanced Configuration for Infini Band Driver Rev 2.1.1 Advanced Configuration for Infini Band Driver 8.1 WDS Installation To perform a WDS installation for a Windows HPC Server 2008 cluster, follow t...
Page 21
Rev 2.1.1 Step 3. Click “Add” and navigate in the Open dialog to the directory chosen in Step 1. Then go to the INF directory. Step 4. Select the listed INF files and click “Open” to add the files. St...
Page 22
Advanced Configuration for Infini Band Driver Rev 2.1.1 c. Click Add Task --> Deployment --> Run OS command. Mellanox Technologies22
Page 23
Rev 2.1.1 d. Locate the new Run OS command listed under the Deployment section in the editor. Next, select in the Optional pane Continue On Failure to be True and enter the following text in the Descr...
Page 24
Advanced Configuration for Infini Band Driver Rev 2.1.1 Step 7. Select “Node Management” in the navigation pane of HPC Cluster Manager. Step 8. Right-click the desired node and select “Assign Node Tem...
Page 25
Rev 2.1.1 8.2 Modifying Configuration After Installation 8.2.1 Modifying Mellanox HCA Configuration To modify HCA configuration after installation, perform the following steps: a. Open the Registry ed...
Page 26
Advanced Configuration for Ethernet Driver Rev 2.1.1 Advanced Configuration for Ethernet Driver 9.1 Displaying Adapter Related Information To display a summary of network adapter software-, firmware- ...
Page 27
Rev 2.1.1 Step 3. Select the Information tab from the Properties sheet. Note: To save this information for debug purposes, click Save To File and provide the output file name. 9.2 Creating a Load Bala...
Page 28
Advanced Configuration for Ethernet Driver Rev 2.1.1 Step 1. Display the Device Manager. Step 2. Right-click a Mellanox Connect X 10Gb Ethernet adapter (under “Network adapters” list) and left-click P...
Page 29
Rev 2.1.1 Step 3. The LBFO dialog enables creating a new bundle, modifying an existing bundle, or remov- ing a bundle. To create a new bundle, perform the following: – Click the Create button – Enter ...
Page 30
Advanced Configuration for Ethernet Driver Rev 2.1.1 – Click the Commit button – The newly created virtual Mellanox adapter representing the bundle will be displayed by Device Manager under “Network a...
Page 31
Rev 2.1.1 To modify an existing bundle, perform the following: – Select the desired bundle and click Modify – Modify the bundle name, its type, and/or the participating adapters in the bundle – Click ...
Page 32
Advanced Configuration for Ethernet Driver Rev 2.1.1 9.3 Creating a Port VLAN You can create a Port VLAN either on a physical Mellanox Connect X EN adapter or a virtual bun- dle (team). The following ...
Page 33
Rev 2.1.1 Step 2. Right-click a Mellanox network adapter (under “Network adapters” list) and left-click Properties. Select the VLAN tab from the Properties sheet. Physical Adapter Virtual Bundle (Team...
Page 34
Advanced Configuration for Ethernet Driver Rev 2.1.1 Notes: a. After installing the first virtual adapter (VLAN) on a specific port, the port becomes disabled. This means that it is not possible to bi...
Page 35
Rev 2.1.1 2. Left-click Properties. 3. Select the VLAN tab from the Properties sheet. 4. Select the VLAN to be removed. 5. Click Remove and confirm the operation. 9.4 Configuring Advanced Features The...
Page 36
Advanced Configuration for Ethernet Driver Rev 2.1.1 Step 2. Right-click a Mellanox network adapter (under “Network adapters” list) and left-click Properties. Select the Advanced tab from the Properti...
Page 37
Rev 2.1.1 d. If you press Cancel, then the last settings will be restored. 9.4.1 Receive Rings in RSS Mode When Receive Side Scaling (RSS) is enabled, it uses a number of receive rings. Each ring is m...
Page 38
Advanced Configuration for Ethernet Driver Rev 2.1.1 Table 1 - Recommended Number of Receive Rings in RSS Mode No. of Receive Rings Conditions 4 or more Applications demand maximum throughput and maxi...
Page 39
Rev 2.1.1 page http://pci-ids.ucw.cz/read/PC/15b3. In the example above, mt XXXXX=mt25448, and the device is a Connect X EN. c. Query the existing device firmware by running the following: > flint ...
Page 40
Uninstalling MLNX_VPIRev 2.1.1 Uninstalling MLNX_VPI Attended Uninstall To uninstall MLNX_VPI on a single node, perform one of the following options: a. On Windows Server 2003: Click Start->Control...