Intel® Acceleration Stack User Guide: Intel® FPGA Programmable Acceleration Card N3000-N/2

Download PDF
ID 683362
Date 11/01/2021
Public
Document Table of Contents
Document Table of Contents x
1. About this Document 2. System Requirements 3. Hardware Installation 4. Installing the OPAE Software 5. Identify the Intel® MAX® 10 BMC Version 6. Intel XL710 Driver Installation and Firmware Update 7. Updating the Retimer Firmware 8. OPAE Tools 9. Sample Test: Native Loopback 10. Configuring Ethernet Interfaces 11. Testing Network Loopback Using Data Plane Development Kit (DPDK) 12. Graceful Shutdown 13. Single Event Upset (SEU) 14. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000-N/2 A. Troubleshooting B. fpgabist Sample Output
1. About this Document x
1.1. Acronym List
3. Hardware Installation x
3.1. Installing the Intel® FPGA PAC N3000-N/2
4. Installing the OPAE Software x
4.1. Install the Release Package
4.1. Install the Release Package x
4.1.1. Remove Previous OPAE Packages 4.1.2. Install the Acceleration Stack for Runtime 4.1.3. Install the Acceleration Stack for Development 4.1.4. Verify the OPAE Installation
4.1.2. Install the Acceleration Stack for Runtime x
4.1.2.1. For RHEL 4.1.2.2. For CentOS
4.1.2.2. For CentOS x
4.1.2.2.1. Download kernel 4.19 4.1.2.2.2. Build and Install kernel 4.19 4.1.2.2.3. Install OPAE in kernel 4.19
5. Identify the Intel® MAX® 10 BMC Version x
5.1. FPGA Factory Image Overview
6. Intel XL710 Driver Installation and Firmware Update x
6.1. Installing the Intel XL710 Driver 6.2. Updating the Intel XL710 Firmware
8. OPAE Tools x
8.1. Using fpgasupdate 8.2. Using fpgainfo 8.3. Test PCIe and External Memories with fpgabist 8.4. Test Network Loopback using fpgadiag
10. Configuring Ethernet Interfaces x
10.1. Modifying the Interface Maximum Transmission Unit (MTU) Size 10.2. Setting Forward Error Correction (FEC) Mode 10.3. Ethernet Pause Flow Control 10.4. Get Link Statistics 10.5. Ethernet Link Status
11. Testing Network Loopback Using Data Plane Development Kit (DPDK) x
11.1. Test Using an External Traffic Generator 11.2. Revert Back from DPDK to OPAE
12. Graceful Shutdown x
12.1. Using OPAE
13. Single Event Upset (SEU) x
13.1. OPAE Handling of SEU
A. Troubleshooting x
A.1. If OPAE installation verification fails, how to install OPAE manually?
B. fpgabist Sample Output x
B.1. For 4x25G Configuration B.2. For 2x2x25G Configuration
1. About this Document
2. System Requirements
3. Hardware Installation
4. Installing the OPAE Software
5. Identify the Intel® MAX® 10 BMC Version
6. Intel XL710 Driver Installation and Firmware Update
7. Updating the Retimer Firmware
8. OPAE Tools
9. Sample Test: Native Loopback
10. Configuring Ethernet Interfaces
11. Testing Network Loopback Using Data Plane Development Kit (DPDK)
12. Graceful Shutdown
13. Single Event Upset (SEU)
14. Document Revision History for Intel Acceleration Stack User Guide: Intel® FPGA PAC N3000-N/2
A. Troubleshooting
B. fpgabist Sample Output

4.1.2.1. For RHEL

  1. Unpack the runtime (rte) installer files for RHEL:
    $ tar xvfz n3000_ias_1_3_1_pv_rte_RHEL_installer.tar.gz 

    $ cd n3000_ias_1_3_1_pv_rte_RHEL_installer
    It consists of:
  2. The script automatically installs dependent packages. The following commands enable required repos for dependent package installation. Failure to enable these repos results in installation errors.
    Note: You must run the remaining steps in this section as root. 
    # subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
    # dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
  3. Enable RHEL for Real Time (RT) repository and install Real Time group:
    #  subscription-manager repos --enable rhel-8-for-x86_64-rt-rpms

    # dnf --releasever=8.2 --disablerepo=epel* groupinstall RT
  4. When the RHEL for RT kernel is installed, it is automatically set to be the default kernel and is used on the next boot. To verify that the RT kernel is the default kernel:
    # grubby --default-kernel
    Sample output:
    /boot/vmlinuz-4.18.0-193.14.3.rt13.67.el8_2.x86_64

    The above output, rt indicates that the RT kernel is the default kernel. A reboot is required to ensure the change to RT Kernel.

  5. Run the OPAE install script to install the OPAE driver, OPAE tools and any package dependencies:
    # ./n3000-1.3.8-3-rte-el8-setup.sh -y --owner <user[:group]>
    Sample output:
    Running setup
Beginning installation
Processing group "OPAE Software"
Analyzing dependencies...
Installing OPAE Software dependencies
Analyzing packages to install...
	Installing OPAE Software packages...
		opae-intel-fpga-driver-2.0.1-10.x86_64.rpm
		opae.admin-1.0.3-2.el8.noarch.rpm
		opae-libs-1.3.7-5.el8.x86_64.rpm
		opae-tools-1.3.7-5.el8.x86_64.rpm
		opae-tools-extra-1.3.7-5.el8.x86_64.rpm
		opae-devel-1.3.7-5.el8.x86_64.rpm
Processing group "OPAE PACSign"
Analyzing dependencies...
Analyzing packages to install...
	Installing OPAE PACSign packages...
		opae.pac_sign-1.0.4-3.el8.x86_64.rpm
Extracting opae-1.3.7-5.tar.gz
Extracting opae.admin-1.0.3.tar.gz
Extracting opae.pac_sign-1.0.4.tar.gz
Source /root/intelrtestack/bin/init_env.sh to setup your environment.
Changing ownership on /root/intelrtestack
Installation done
see /tmp/opae_install_2020-08-09_16_43_56.log for details
    Tip:
    • --owner allows you to change the ownership of installation directories to a specified user. Not listing owner results in use of default setting which is root.
    • -y option is required because interactive operation where the user is asked for specific settings rather defaults is not supported.
    • -v option provides verbose output and is useful for debugging install issues.
    • -h option lists all script options.
Level Two Title