image image image image image

On This Page

For Windows, download and install the latest NVIDIA WinOF-2 for Windows software package available via the NVIDIA web site at: http://www.nvidia.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.

Hardware and Software Requirements

DescriptionPackage
Windows Server 2012 R2MLNX_WinOF2-1_10_All_x64.exe
Windows Server 2012
Windows Server 2016
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 NVIDIA WinOF-2 Driver

To download the executable file according to your operating system, please follow the steps below:

  1. Obtain the machine architecture.
    1. To go to the Start menu, position your mouse in the bottom-right corner of the Remote Desktop of your screen.
    2. Open a CMD console. (Click Task Manager > File > Run new task, and enter CMD.)
    3. Enter the following command.

      echo %PROCESSOR_ARCHITECTURE%

      On an x64 (64-bit) machine, the output will be “AMD64”.

  2. Go to the NVIDIA WinOF-2 web page at http://www.nvidia.com > Products >InfiniBand/VPI 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 NVIDIA WinOF-2 Driver

This section provides instructions for two types of installation procedures:

  • 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.

WinOF-2 supports adapter cards based on the NVIDIA ConnectX®-4 and above family of adapter IC devices only. If you have ConnectX-3 and ConnectX-3 Pro on your server, you will need to install WinOF driver. For details on how to install WinOF driver, please refer to WinOF User Manual.

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):

    MLNX_WinOF2-1_10_<revision_version>_All_x64.exe /v"/l*vx [LogFile]"
  3. [Optional] If you do not want to upgrade your firmware version. (Note: MT_SKIPFWUPGRD default value is False.)

    MLNX_WinOF2-1_10_<revision_version>_All_x64.exe /v" MT_SKIPFWUPGRD=1"
  4. Click Next in the Welcome screen.
  5. Read then accept the license agreement and click Next.
  6. Select the target folder for the installation.
  7. The firmware upgrade screen will be displayed in the following cases:
    1. If the user has an OEM card. In this case, the firmware will not be displayed.
    2. If the user has a standard NVIDIA card with an older firmware version, the firmware will be updated accordingly. However, if the user has both an OEM card and a NVIDIA card, only the NVIDIA card will be updated.
  8. Select a Complete or Custom installation, follow Step a and on.
    1. Select the desired feature to install:
      1. Performance tools - install the performance tools that are used to measure performance in user environment
      2. Documentation - contains the User Manual and Release Notes
      3. Management tools - installation tools used for management, such as mlxstat
      4. Diagnostic Tools - installation tools used for diagnostics, such as mlx5cmd
    2. Click Next to install the desired tools.
  9. Click Install to start the installation.
  10. In case that firmware upgrade option was checked in Step 7, you will be notified if a firmware upgrade is required. See TBD.
  11. Click Finish to complete the installation.

Unattended Installation

If no reboot options are specified, the installer restarts the computer whenever necessary without displaying any prompt or warning to the user. Use the /norestart or /forcerestart standard command-line options to control reboots.

The following is an example of an unattended installation session.

  1. Open a CMD console. (Click Task Manager > File > Run new task, and enter CMD.)
  2. Install the driver. Run:

    MLNX_WinOF2-1_10_<revision_version>_All_x64.exe /S /v/qn
  3. [Optional] Manually configure your setup to contain the logs option:

    MLNX_WinOF2-1_10_All_x64.exe /S /v/qn /v”/l*vx [LogFile]"
  4. [Optional] if you want to control whether to install ND provider or not. (Note: MT_NDPROPERTY default value is True.)

    MLNX_WinOF2-1_10_All_x64.exe /vMT_NDPROPERTY=1
  5. [Optional] If you do not wish to upgrade your firmware version. (Note: MT_SKIPFWUPGRD default value is False.)

    MLNX_WinOF2-1_10_All_x64.exe /vMT_SKIPFWUPGRD=1

Applications that hold the driver files (such as ND applications) will be closed during the unattended installation.

Installation Results

Upon installation completion, you can verify the successful addition of the network card(s) through the Device Manager.
Upon installation completion, the inf files can be located at: %ProgramFiles%\Mellanox\MLNX_WinOF2\Drivers\<OS>
To see the NVIDIA network adapters, display the Device Manager and pull down the Network adapters menu.

Extracting Files Without Running Installation

To extract the files without running installation, perform the following steps.

  1. Open a CMD console. (Click Task Manager > File > Run new task, and enter CMD.)
  2. Extract the driver and the tools:

    MLNX_WinOF2-1_10_All_x64 /a

    To extract only the driver files.

    MLNX_WinOF2-1_10_All_x64 /a /vMT_DRIVERS_ONLY=1
  3. Click Next to create a server image.
  4. Click Change and specify the location in which the files are extracted to.
  5. Click Install to extract this folder, or click Change to install to a different folder.
  6. To complete the extraction, click Finish.

Uninstalling NVIDIA WinOF-2 Driver

Attended Uninstallation

To uninstall MLNX_WinOF2 on a single node: 

  1. Click Start > Control Panel > Programs and Features > MLNX_WinOF2 > Uninstall.
    (NOTE: This requires elevated administrator privileges)

Unattended Uninstallation

To uninstall MLNX_WinOF2 in unattended mode:

  1. Open a CMD console. (Click Task Manager > File > Run new task, and enter CMD.)
  2. To uninstall the driver, run:

    MLNX_WinOF2-1_10_All_x64.exe /S /x /v"/qn"

Firmware Upgrade

If the machine has a standard NVIDIA 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 at www.nvidia.com >Products > Ethernet Drivers > Firmware Tools.

Deploying the Driver on a Nano Server

Offline Installation

To deploy the Driver on a Nano Server:

  1. Go to the NVIDIA WinOF web page at http://www.nvidia.com > Products > Ethernet Drivers > Windows SW/Drivers.
  2. Download the driver (MLNX_WinOF2_MLNX_WinOF2-1_64_mlx5_All_win2016_x64_fre_1_64_15407.exe).
  3. Extract the driver to a local directory (see Extracting Files Without Running Installation).
  4. Copy the contents of this directory to C:\WS2016TP5_Drivers. 
    The directory contents should appear as follows:


    This location should be specified for DriversPath property when injecting driver into the Nano server image:

    New-NanoServerImage -MediaPath \\Path\To\Media\en_us -BasePath .\Base -TargetPath .\InjectingDrivers.vhdx -DriversPath C:\WS2016TP5_Drivers
  5. Create the Nano server image. Follow the instructions in the TechNet article for "Getting Started with Nano Server".

Online Update

  1. Go to the NVIDIA WinOF web page at http://www.nvidia.com > Products >Ethernet Drivers > Windows SW/Drivers.
  2. Download the driver package.
  3. Extract the NVIDIA drivers to a local directory (see Extracting Files Without Running Installation).
  4. Open a remote connection to the Nano server.
  5. Copy all the driver files to the Nano server
  6. Install the driver:

    pnputil -I -a <Driver_Folder>\mlx5.inf

When upgrading the driver on a server where the remote connection was done over NVIDIA 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.