Compile and Install the Linux Driver and the Tools

Software Installation for Linux

product_line_custom
Napatech SmartNIC
category
Software Installation Guide

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

  1. Download the product package from supportportal.napatech.com (the Napatech Support Portal).
  2. 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-x.y.z.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.
  3. Install the Napatech driver and tools in one of these ways:
    • By running the product package installer script package_install_3gd-x.y.z.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.
  4. Install by running the product package installer script:
    $ sudo package_install_3gd-x.y.z.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.

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

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