Before you begin
For more information about supported versions of Linux, please refer to the relevant Release Summary.
- Linux kernel development headers
- GCC version 4.0 or later
- GNU make
- GCC version 4.0 or later
- GNU make
- flex and bison or lex and yacc. Some versions of lex are insufficient to compile libpcap; if this is the case, install flex and bison.
- glibc version 2.5 or later
- ncurses version 5.0 or later (only applies to the monitoring and profiling tools)
To install the Napatech Linux driver including libraries, tools, and optionally libpcap:
- Download the product package from supportportal.napatech.com (the Napatech Support Portal).
Unpack the product package.
$ tar xzf ntanl_package_3gd-x.y.z-linux.tar.gz $ cd ntanl_package_3gd-x.y.z-linuxThe unpacked product directory contains:
- A PDF with product package release notes
- readme_3gd-x.y.z.txt, describing the product package content
- package_install_3gd.sh, a product package install script.
- A documentation subdirectory.
- A source_rpm subdirectory with sample source RPMs for the driver and tools components.
- A subdirectory for each product package component, in general containing release notes and an installer file for the component.
Install the Napatech driver and tools in one of these ways:
- By running the product package installer script package_install_3gd.sh, located in the root directory. This will install the driver software, the tools, documentation, FPGA images and imgctrl, and optionally a version of libpcap.
- By running installer scripts for the individual components.
- For the driver and tools packages, by building RPM packages from source RPM packages and installing the resulting RPM packages.
Install by running the product package installer script:
$ sudo package_install_3gd.sh
If the product package installer script detects that a version of the driver software is already installed, you will be offered the choice between updating the existing installation, deleting the existing installation before commencing, or quitting the installation script.
You will be offered the option of installing a version of libpcap with Napatech extensions. For more information about libpcap with Napatech extensions, please refer to DN-0428.
Alternatively, install by running individual component installer scripts:
To compile and install the driver, execute the driver install script:
$ cd software $ sudo nt_driver_3gd_linux-x.y.z-short-sha1.run
To get information about driver install script options, run nt_driver_3gd_linux-x.y.z-short-sha1.run --help
For instance, the --installpath <directory> option allows you to select a user-defined installation directory instead of /opt/napatech3/.
To install the tools, execute the tools install script:
$ cd tools $ sudo nt_tools_3gd_linux-x.y.z-short-sha1.run
To get information about tools install script options, run nt_tools_3gd_linux-x.y.z-short-sha1.run --help
- To compile and install the driver, execute the driver install script:
- Alternatively, for the driver and tools packages, by building RPM packages from source RPM packages and installing the resulting RPM packages. This process is described in Building and Installing RPM Packages for the Napatech Driver and Tools.
Optionally, to list installed Napatech SmartNICs, run the imgctrl
tool with root privileges:
$ sudo /opt/napatech3/bin/imgctrl -q imgctrl v126.96.36.199-38534 (Sep 29 2017 08:15:04) (Logfile: /tmp/imgctrl.log) Scanning for Napatech adapters.. Adapter 0: PCI SLOT : 0000:00:09.0 PCI DEVICE ID : 0175 PCI LANES : x8 ADAPTER TYPE : NT20E3_2_PTP_NEBS PCI Express Gen3 2x10Gb SFP+ platform . . .
imgctrl is a stand-alone tool for updating and controlling the FPGA firmware on Napatech SmartNICs. As a security measure, imgctrl will not run if the Napatech kernel mode driver is loaded. Please refer to DN-0487 for more information about the imgctrl tool.
The /opt/napatech3/ directory (or a user-defined one) including subfolders is created; and the driver is installed and compiled to match the target Linux kernel version.