Intel® QSFP+ Configuration Utility - Windows Server 2016 Nano Server*

Overview

The Intel® QSFP+ Configuration Utility is a command line utility that allows
users to change the link type of the installed QSFP+ module. The supported types
are defined within the adapter's NVM. This utility displays only the devices that
potentially support QSFP+ reconfiguration. Only one port per device is displayed,
since changes affect the device as a whole, not individual ports.

Note: A reboot is required to apply configuration changes. On systems running
Oracle* Solaris* 11, you must perform a full reboot, not a fast reboot.

Supported operating systems

• Microsoft Windows Server 2008 R2* and later
• Windows PE 3.0 and later
• Linux* Kernel 2.6/3.x and later
• Red Hat* Enterprise Linux* 6.5 and later
• SUSE* Linux Enterprise Server 10 SP4 and later
• UEFI 2.1 and later
• Oracle* Solaris* 11
• VMWare* ESXi* 5.5 and later
• FreeBSD* 10.1 and later

Notes

• On systems running Linux, FreeBSD, Solaris, or ESXi, the base driver must be
  present for QCU to function correctly.
• On Microsoft Windows systems, if the driver required to run the tool is not
  present on the system, it will automatically be installed when QCU
  is run.

Running the utility

Using the "/?" option will display a list of supported command line options.

Note: The utility must be run with root/administrator privileges.

Options

The Intel® QSFP+ Configuration Utility can be run with any of the following
command line options.

Notes:

• The dash '-' character can be used in place of the slash '/' character.
• All options are case-sensitive.

/HELP or /?
Displays command line help.

/VERSION
Displays tool version information.

/EXITCODES
Displays exit code help.

/DEVICES
Displays supported devices present in the system.
NOTE: The value "N/A" is displayed in the Mode column if the hardware
supports QSFP+ configuration but the current firmware does not.
See BASIC USAGE EXAMPLES below.

/NIC=XX
Selects a specific adapter (1-32).

/INFO
Displays supported QSFP+ link modes. Use only with /NIC.

/SET [LINK MODE]
Configures selected QSFP+ link mode. Use only with /NIC.

Note: You must reset the platform for the changes to take effect.

Basic usage examples

The following examples show the tool's output for the /DEVICES option,
the /INFO option, and the /SET option.

/DEVICES:
---------
QCU>QCUW64E.EXE /DEVICES
NIC B:D Ven-Dev Mode Adapter Name

1. 01:00 8086-1584 4x10 Intel(R) Ethernet Controller XL710 for 40GbE QSFP+
2. 04:00 8086-1583 N/A Intel(R) Ethernet Controller XL710 for 40GbE backplan

/INFO:
------
> QCUW64E.EXE /NIC=3 /INFO

Intel® QSFP+ Configuration Utility vXX.XX.XX.XX
Copyright © 2015 by Intel Corporation.
Software released under Intel Proprietary License.

Adapter supports QSFP+ Configuration modification.
Current Configuration: 1x40
Supported Configurations: 1x40, 4x10

/SET:
-----
> QCUW64E.EXE /NIC=3 /SET 4x10

Intel® QSFP+ Configuration Utility vXX.XX.XX.XX
Copyright © 2015 by Intel Corporation.
Software released under Intel Proprietary License.

QSFP+ configuration changed. Please reset platform for the changes to take
effect.

Exit codes

The Intel® QSFP+ Configuration Utility returns exit codes to the command line.
A description of each of these codes can be found in the tool by running
QCU /EXITCODES.

Installation

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 tool 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 for
Windows Device Manager. 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: 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: 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 tools on Microsoft* Windows Server* Nano Server

To install the tools on systems running Nano Server, you must use Microsoft*
Windows PowerShell* to copy the tools and their driver files from a host system
running a version of Windows other than Nano Server to the target system
running Nano Server. The tools and their driver files are available from the
installation media in the \TOOLS\Nanox64\SVTools folder.

This is the installation procedure:

1. On the host system, open the installation media and copy the folder
   \TOOLS\Nanox64\SVTools to the target system running Nano Server.
2. Open a Windows PowerShell session to the target system.
3. Navigate to the location of the files you copied in Step 1 above.
4. Run install.bat.

Installing the tools on EFI

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: 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 tools on DOS

The tools support various DOS versions. There is no installation required for
DOS tools. The tools can simply be copied from the DOS directory on the CD to
the drive that they will run from. It is expected that the tools have a clean
boot environment. The tools will not run with memory managers and/or DOS
networking drivers loaded. The tools expect that they have full, unlimited
control of the hardware. The tools WILL NOT run properly if EMM386 is present. 
The tools run in protected mode, 32-bit DOS. Therefore, they will not be
compatible with any TSR programs.

Installing the tool on Linux*

In order to run this tool on Linux*, the base driver must be installed on
the system.

Installing the tool on VMWare* ESXi*Ware* ESXi* 

In order to run this tool on VMWare* ESXi*, the base driver must be installed on
the system.

Note: There are two versions of the utility. For ESXi 6.0 and later, use qcun64e. For prior versions of ESXi, use qcu64e.

Installing the tool on FreeBSD*

In order to run this tool on FreeBSD, the base driver must be installed on
the system.