Intel® Ethernet Adapters and Devices User Guide

ID 705831
Date 06/24/2024
Public
Document Table of Contents

Installing and Uninstalling Intel® Network Connection Tools

This document describes how to install the Intel® Network Connection Tools. See the readme provided for each tool for a detailed explanation of the features available.

Installing the Tool on Microsoft* Windows*

To install the tools’ drivers on Windows, run install.bat from the appropriate directory of the install package.

Although the tools are not installed with install.bat, the driver that the tool requires is copied into the local machine Windows driver directory. To run the tool, launch a Command Prompt window from the Windows Start Menu. Go to the media and directory where the tool is located and run the utility. The readme files for each tool are found in the same directory as the tool. These tools can be manually installed on the local hard drive in any directory.

The tool uses its own driver file (not the same as the system network driver). If the driver sys file already exists in the drivers directory, install.bat may fail to copy. Using the /y switch with install.bat will override and copy the driver file regardless. However, this can be dangerous if an older version of the driver is being used by another application such as Intel® PROSet. If a driver is already present in the drivers directory, try running the tool from the command prompt. If it runs, then the driver is fine. The tool will not run if the driver version present does not match the driver version expected.

Note that you must have access to the %systemroot%\system32\drivers directory. Only the administrator account has these privileges. You must be logged in as administrator or the tools must be run as administrator.

Note that on Windows, any device that is disabled in Device Manager will not be accessible by tools due to no memory resources. You would get an error code 0xC86A800E. To solve this problem, you can do one of the following:

  1. Re-enable the device in Device Manager. Never disable this device when using tools.

  2. Install an NDIS device driver for the device and make sure that it does not have a yellow or red bang by it in Device Manager.

  3. Delete the device from Device Manager and restart the system. The install new hardware wizard should appear on next reboot. Do not cancel this. Just move the window aside and run the tool(s). Generally, you can click Cancel on the wizard but there are some cases where Windows will disable the memory resources, causing you to get back into the same state.

Installing the Tool on EFI

The EFI 1.x tools are not supported in this release.

There is no installation required for EFI tools. The tools can simply be copied from the appropriate directory to the drive that they will run from. The EFI2 binaries are for use with the UEFI Shell 2.X with the UEFI 2.3 HII protocol. EFI2 tools will not run on the EFI Shell 1.X or if the UEFI 2.3 HII protocol is not present.

Note that while EFI supports USB drives, there may be issues running tools from the USB drive. Whether or not there are issues are BIOS specific. If you experience issues, run the tool from hard disk instead.

Installing the Tool on DOS

This tool no longer supports DOS. If you require DOS support, please download a prior version.

Installing the Tool on Linux*

In order to run tools on Linux*, a driver stub must be built and installed on the system. This driver is not related to the network device driver that is used to run the network during live traffic. It is a separate driver used explicitly for tools. Due to the nature of Linux with the number of kernels that can exist, we provide source for the driver module and an install script to build/install it.

The tools support Linux distributions based on kernels 2.6.x. Validation is done randomly on popular distributions such as Red Hat* or Suse*. Configured kernel source that matches the currently installed kernel is required. A working GCC is also required. There are some versions of GCC that had a bug which did not support unnamed structures. These versions of GCC are not supported. If you have compilation errors, try updating your version of GCC. If you have linker errors when installing the driver, you should update your kernel; download the latest stable off www.kernel.org and build/install it.

Note that some distributions such as recent Fedora core versions do not ship with Kernel source. You must download, install, and configure the source in order to get the tools’ driver built on this OS. Installing the kernel source RPM does not solve the problem.

This is the installation procedure:

  1. Log in as root and create a temporary directory to build the Intel® Network Connection Tools driver.

  2. Copy install and iqvlinux.tar.gz to the temporary directory. There are 2 versions of Linux supported: Linux32 (x86)and Linux_​x64 (x64). Copies of the above files exist in the appropriate directory for your platform.

  3. CD to the temporary directory and run ./install. The driver has been installed now, so the files in the temporary directory can be removed.

  4. Copy the tools that you want to use from the appropriate directory of the CD.

Kernel 4.16 or Higher

On Linux kernel 4.16 and higher, the iomem parameter is set to “strict” by default, which may prevent the tool from accessing the MMIO of the device. Trying to update a device when “strict” is set causes the device to lose link during the update process.

If you wish to update a device without losing link, you can either:

  1. Install Linux base drivers (igb or ixgbe) from Release 24.1, or newer.

  2. Set the iomem kernel parameter to relaxed (i.e., iomem=relaxed) and reboot the system before running the update utility.

Installing the Tool on FreeBSD*

In order to run tools on FreeBSD*, a driver stub must be built and installed on the system. This driver is not related to the network device driver that is used to run the network during live traffic. It is a separate driver used explicitly for tools. Due to the nature of FreeBSD with the number of kernels that can exist, we provide source for the driver module and an install script to build/install it.

The tools support FreeBSD distributions version 10.1 and later.

This is the installation procedure:

  1. Log in as root and create a temporary directory to build the Intel® Network Connection Tools driver.

  2. Copy install and iqvfreebsd.tar to the temporary directory. There are two versions of FreeBSD supported: FreeBSD32 (x86) and FreeBSD64e (x64). Copies of the above files exist in the appropriate directory for your platform.

  3. CD to the temporary directory and run ./install. The driver has been installed now, so the files in the temporary directory can be removed.

  4. Copy the tools that you want to use from the appropriate directory of the CD.

Uninstalling Intel Network Connection Tools

Run the uninstall.bat batch file if you need to manually remove the old version (iqvw<architecture>.sys) of the Intel Network Connection Tools driver.

On Windows, you also need to manually remove the iqvsw64e.sys driver.