Intel Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA

Download PDF
ID 683633
Date 12/04/2020
Public
Document Table of Contents
Document Table of Contents x
1. About This Document 2. Introduction 3. Getting Started 4. Installing the OPAE Software Package 5. Identifying the Flash Image and BMC Firmware 6. Running FPGA Diagnostics 7. Running the OPAE in a Non-Virtualized Environment 8. Running the OPAE in a Virtualized Environment 9. Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives 10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA A. Updating the FIM and BMC Firmware B. Handling Graceful Thermal Shutdown C. FPGA Device Access Permission D. Memlock Limit E. Hugepage Settings F. Troubleshooting Frequently Asked Questions (FAQ) G. Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2.1 Release
1. About This Document x
1.1. Intended Audience 1.2. Acronym List 1.3. Acceleration Glossary
3. Getting Started x
3.1. Intel Acceleration Stack Hardware Features 3.2. System Requirements 3.3. Installing the Intel® PAC with Intel® Arria® 10 GX FPGA Card In the Host Machine 3.4. Installing the Intel Acceleration Stack
3.4. Installing the Intel Acceleration Stack x
3.4.1. Installing the Intel Acceleration Stack Runtime Package on the Host Machine 3.4.2. Installing the Intel Acceleration Stack Development Package on the Host Machine 3.4.3. Understanding the Extracted Intel® PAC with Intel® Arria® 10 GX FPGA Release Package
4. Installing the OPAE Software Package x
4.1. RHEL 7.6: Installing the OPAE Framework from Prebuilt Binaries (RPM) 4.2. Ubuntu: Installing the OPAE Framework from Prebuilt Binaries (deb) 4.3. (Optional) Building and Installing the OPAE Software from Source Code 4.4. Installing the OPAE PACSign
7. Running the OPAE in a Non-Virtualized Environment x
7.1. Loading an AFU Image into the FPGA 7.2. OPAE Sample Application Programs
7.2. OPAE Sample Application Programs x
7.2.1. Running the Hello FPGA Example
8. Running the OPAE in a Virtualized Environment x
8.1. Updating Settings Required for VFs 8.2. Configuring the VF Port on the Host 8.3. Running the Hello FPGA Example on Virtual Machine
8.3. Running the Hello FPGA Example on Virtual Machine x
8.3.1. Disconnecting the VF from the VM and Reconnecting to the PF
A. Updating the FIM and BMC Firmware x
A.1. Selecting the Correct Update Method
A.1. Selecting the Correct Update Method x
A.1.1. Updating FPGA Flash and BMC Firmware
F. Troubleshooting Frequently Asked Questions (FAQ) x
F.1. Why do I see a 'No Suitable slots found' message when running fpgaconf on my AFU image? F.2. How do I flash the FIM or program the AFU in a multicard system? F.3. Which environment variables are required? F.4. What actions do I take if I see the error message 'Error enumerating resources: no driver available'? F.5. Troubleshooting OPAE Installation on RHEL
1. About This Document
2. Introduction
3. Getting Started
4. Installing the OPAE Software Package
5. Identifying the Flash Image and BMC Firmware
6. Running FPGA Diagnostics
7. Running the OPAE in a Non-Virtualized Environment
8. Running the OPAE in a Virtualized Environment
9. Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives
10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA
A. Updating the FIM and BMC Firmware
B. Handling Graceful Thermal Shutdown
C. FPGA Device Access Permission
D. Memlock Limit
E. Hugepage Settings
F. Troubleshooting Frequently Asked Questions (FAQ)
G. Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2.1 Release

3.3. Installing the Intel® PAC with Intel® Arria® 10 GX FPGA Card In the Host Machine

Follow these instructions to install the Intel® PAC with Intel® Arria® 10 GX FPGA card.

Precautions for Hardware Installation

You must open the server chassis to install the Intel® PAC with Intel® Arria® 10 GX FPGA card. Follow all safety precautions and the electrostatic discharge (ESD) guidelines provided to avoid damaging the server or the Intel® PAC with Intel® Arria® 10 GX FPGA.

Warning: To avoid electric shock, power down your server and unplug it from the power outlet before opening the server chassis.

ESD Guidelines

Electronics components on the Intel® PAC with Intel® Arria® 10 GX FPGA and server are sensitive to ESD. To avoid damaging them, please follow these ESD prevention guidelines:

  • Wear a grounded ESD strap during the Intel® PAC with Intel® Arria® 10 GX FPGA installation.
  • Leave the Intel® PAC with Intel® Arria® 10 GX FPGA in its ESD-safe packaging until you are ready to install the card.
  • During installation, handle the Intel® PAC with Intel® Arria® 10 GX FPGA only by the edge of the board.
  • Never touch any exposed circuitry, edge connectors, or printed circuits on the Intel® PAC with Intel® Arria® 10 GX FPGA or server.
  • Do not put the Intel® PAC with Intel® Arria® 10 GX FPGA on any metal surface during installation.
  • If you must put the Intel® PAC with Intel® Arria® 10 GX FPGA down, put the card in the ESD-safe packaging.
  1. Open your server chassis.
  2. Identify an available PCIe* Gen3 x16 mechanical slot with enough clearance to house the Intel® PAC with Intel® Arria® 10 GX FPGA.
  3. Remove any I/O panel covers for the slot you are using.
  4. Install the Intel® PAC with Intel® Arria® 10 GX FPGA in the PCIe* slot by inserting the PCIe* x16 edge connector and ensuring the card retention hook is properly engaged.
  5. If supported by your server chassis, use the two screws provided to secure the I/O panel bracket to the server chassis.
  6. Reinstall the chassis cover.
  7. Enable the following options in the BIOS if you plan on using virtualization/containers:
    • Intel VT-x (Intel Virtualization Technology for IA-32 and Intel 64 Processors)
    • Intel VT-d (Intel Virtualization Technology for Directed I/O)
Level Two Title