Compile and Install the Linux Driver and the Tools

Before you begin

For more information about supported versions of Linux, please refer to the relevant Release Summary.

The following are required in order to build and install the driver software:

Linux kernel development headers
GCC version 4.0 or later
GNU make

The following are required in order to build and install libpcap:

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.

The following libraries are needed to run the tools:

glibc version 2.5 or later
ncurses version 5.0 or later (only applies to the monitoring and profiling tools)

Note: Root privileges are required for installing and compiling the Linux driver and the tools.

Steps

To install the Napatech Linux driver including libraries, tools, and optionally libpcap:

Procedure

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-linux
```
The 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:
1. 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/.
2. 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
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 v3.5.5.3-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.

Results

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.