Visible to Intel only — GUID: evr1522432516615
Ixiasoft
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
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
Visible to Intel only — GUID: evr1522432516615
Ixiasoft
4.3. (Optional) Building and Installing the OPAE Software from Source Code
- Complete the following steps to install Intel FPGA Driver:
- Remove any previous version:
RHEL:
sudo yum remove opae*
Ubuntu:sudo apt-get remove opae* sudo apt-get remove python-opae.admin sudo apt-get remove python3-opae.pac-sign
- Install the Extra Packages for Enterprise Linux (EPEL):
RHEL:
sudo yum install https://dl.fedoraproject.org/pub/epel/\ epel-release-latest-7.noarch.rpm
- Change to the OPAE installation software directory:
cd $OPAE_PLATFORM_ROOT/sw
- Install the driver:
RHEL:
sudo yum install opae-intel-fpga*.rpm
Ubuntu:sudo dpkg -i opae-intel-fpga-driver_*.deb
- Remove any previous version:
- Build and install the OPAE SDK from source:
- Change to the OPAE software directory and extract the .tar file:
cd $OPAE_PLATFORM_ROOT/sw tar xf opae*.tar.gz
- Complete the following steps to build the OPAE software:
cd opae* mkdir build && cd build cmake .. -DBUILD_ASE=OFF -DCMAKE_INSTALL_PREFIX=<path to install directory> -DCMAKE_BUILD_TYPE=Release
For example:
cmake .. -DBUILD_ASE=ON -DCMAKE_INSTALL_PREFIX=/home/john/\ opaeinstall -DCMAKE_BUILD_TYPE=Release
Note: You may get an error because the cmake command cannot find the git repository. You can safely ignore this error message. You do not need the git repository to successfully build the OPAE software. - Run the following command to build the executables and libraries:
make install
Note: By default, if you choose the RPM installation flow, the binaries, libraries and include files are under /usr/. If you build and install the OPAE from the source flow, the binaries, libraries, and include files are under <path to install directory>. - Set the appropriate environment variable to ensure tools, libraries, and include files are in your search path. To avoid rerunning this command whenever you restart or open a new terminal, add these directory environment variables to your shell configuration file, /etc/bashrc.
export PATH=<path to OPAE install directory>/bin:$PATH
export C_INCLUDE_PATH=<path to OPAE install directory>/include:\ $C_INCLUDE_PATH
To check for static libraries use the following paths:- RHEL:
export LIBRARY_PATH=<path to OPAE install directory>\ /lib64:$LIBRARY_PATH
- Ubuntu:
export LIBRARY_PATH=<path to OPAE install directory>\ /lib:$LIBRARY_PATH
To check for shared libraries use the following paths:- RHEL:
export LD_LIBRARY_PATH=<path to OPAE install directory>/\ lib64:$LD_LIBRARY_PATH
- Ubuntu:
export LD_LIBRARY_PATH=<path to OPAE install directory>/\ lib:$LD_LIBRARY_PATH
- RHEL:
- Change to the OPAE software directory and extract the .tar file: