Upgrade from 2018.x to 2019.1 in Ubuntu Downgrade from 2018.3 to 2018.2 in RedHat and CentOS Chapter 1: Introduction 06/27/2019 Version 2019.1 Qualified Servers Updated server requirements. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 3
Added new information on upgrading and downgrading deployment software. Known Issues Updated known issues. Appendix B: Creating a Vault Repository for CentOS Added new appendix. 10/02/2018 Version 1.0 Initial Xilinx release. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Known Issues..........................33 Appendix A: Changing XRT and Target Platform Versions ....35 RedHat and CentOS........................35 Ubuntu............................41 Appendix B: Creating a Vault Repository for CentOS .......48 UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 5
........50 Appendix D: Generating the xbmgmt flash --update Command ..51 Appendix E: Additional Resources and Legal Notices ......53 Xilinx Resources.........................53 Documentation Navigator and Design Hubs.................53 References..........................54 Please Read: Important Legal Notices................... 54 UG1301 (v1.5) June 3, 2020 www.xilinx.com...
With the card installed, developers can debug applications in both emulation modes and on the hardware. Card Features Features of the Alveo U200/U250/U280 data center accelerator cards are listed in the following table. UG1301 (v1.5) June 3, 2020 www.xilinx.com...
U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963). Qualified Servers A list of servers on which Alveo cards are fully qualified on can be found here: https:/ /www.xilinx.com/products/boards-and-kits/alveo/qualified-servers.html. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
WARNING! Hazardous moving parts. Keep away from fan blades. ATTENTION! Pièces mobiles peuvent etre dangereuses. Éloignez-vous des lames du ventilateur. WARNUNG! Gefährliche bewegliche Teile. Halten sie sich von Lüfterflügeln fern. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 10
For card specifications, dimensions, list of card features, and block diagram see Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963).
Page 11
Chapter 2: Unpacking Figure 2: Active Cooled Card Configuration Figure 3: Passive Cooled Card Configuration UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
• Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen. • Ziehen sie vor dem Öeffnen der Computer / Systemabdeckung das Netzkabel ab. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 13
• Put the card down only on an antistatic surface such as the bag supplied in your kit. • If you are returning the card to Xilinx Product Support, place it back in its antistatic bag immediately. Attention aux Décharge Électrostatique (ESD) L'ESD peut endommager les composants électroniques lorsqu'ils sont mal manipulés, et peut...
• Legen sie die Karte nur auf einer antistatischen Oberfläche ab, z.B. dem antistatischen Beutel der mit dem Kit mitgeliefert wurde. • Wenn sie die Karte an den Xilinx Product Support zurücksenden, legen Sie sie bitte sofort wieder in den antistatischen Beutel.
(“hot-plug” n'est pas autorisé). WICHTIG! Trennen Sie den Alveo™-Stromanschluss-Stecker nicht im eingeschalteten Zustand (Hot-Plug ist nicht zulässig). The following procedure is a guide for the Xilinx ® Alveo™ Data Center accelerator card installation. Consult your computer documentation for additional information.
Page 16
Figure 4: Connecting the Power Cable to Actively Cooled Cards For passively cooled cards, connect the power cable to the AUX power connector at the side of the card as shown in the following figure. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 17
12V source, and 75 Watts from the 6-pin AUX connector). 215W is available with the 8-pin connector (65 Watts from PCIe connector 12V source, and 150 Watts from the 8-pin AUX connector). UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 18
WARNING! Do not power-on a passively cooled card without adequate forced airflow across the card with proper airflow direction, otherwise the card can be damaged. For more information, see Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963).
Page 19
If the card is successfully installed and found by the operating system, a message similar to the one below will be displayed. This is a sample output for an installed Alveo U200 card: 65:00.0 Processing accelerators: Xilinx Corporation Device d000...
If you encounter any issues during installation, see Chapter 7: Troubleshooting Known Issues. See Xilinx Answer Record 71752 for additional known issues. IMPORTANT! Root access is required for all software and firmware installations. IMPORTANT! L'accès Root est requis pour toutes les installations logicielles et firmware.
Page 21
4. Download both the XRT and deployment platform installation packages associated with your card from the Getting Started tab in one of the following locations: • Alveo U200 Product Page • Alveo U250 Product Page UG1301 (v1.5) June 3, 2020 www.xilinx.com...
Page 22
$ sudo yum install ./xilinx-<card>-<version>.rpm The deployment software sources are now installed on the system. The installation of the drivers, runtime software, and utilities are in the /opt/xilinx/ directory and contains the xrt and dsa sub-directories. The dsa folder contains the deployment platform installation.
Page 23
The installation for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up and Validation to validate the installation. Related Information Creating a Vault Repository for CentOS Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Befehlen entsprechend den heruntergeladenen Paketen aktualisieren. 1. Download both the XRT and deployment installation packages associated with your card from the Getting Started tab in one of the following locations: • Alveo U200 Product Page • Alveo U250 Product Page •...
Page 25
The deployment software sources are now installed and deployed on the system. The installation of the drivers, runtime software, and utilities are in the /opt/xilinx/ directory and contains the xrt and dsa sub-directories. Note that the dsa folder contains the deployment platform installation.
Page 26
The installation for deployment is now complete. You can go directly to Chapter 5: Card Bring-Up and Validation to validate the installation. Related Information Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
• xbutil validate The lspci Linux command is used to validate the card as seen by the OS, as was done when installing the card. The second and third commands use the Xilinx ® xbmgmt and xbutil utilities, that are included during the XRT package installation.
DMA test - Data transfer between host and card memory through PCIe. b. Memory test - Data transfer between kernels and card memory. The validate command has the format: xbutil validate -d <card_bdf> UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 30
Run the validate command shown below: $ /opt/xilinx/xrt/bin/xbutil validate If the card was installed correctly, you will see a high-level summary of the tests performed similar to the following output. If the output is not similar to the one shown below, see Chapter Troubleshooting.
What you have done so far allows you to deploy and run accelerated applications on your system. Alveo™ Accelerated Solutions page provides information and links to available Xilinx and third-party accelerated applications. These include video processing, financial computing, machine learning, and data analytics.
Check if the card shows up by typing the following Linux command: lspci -vd 10ee: Card not compatible with server. Use qualified server. See Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) for system compatibilities. Maintenance USB cable attached.
Run time fails with following message: Failed to source the setup.sh script. Source /opt/xilinx/xrt/setup.sh Error: Failed to find Xilinx platform When installing the XRT, you see the This is caused by running sudo apt The XRT will install correctly, despite following message: the error.
Page 34
It is necessary to upgrade pip and python using the following commands encountered during XRT installation. prior to installing XRT. sudo pip install --upgrade sudo python -m pip install numpy UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Alveo packages. To list all currently installed platform packages, run the following command in a Linux terminal: $ yum list installed | grep xilinx To list the currently installed XRT package, run the following command: $ yum list installed | grep xrt UG1301 (v1.5) June 3, 2020...
Page 36
If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
Page 37
If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
Page 38
$ sudo /opt/xilinx/xrt/bin/xbutil flash scan If the package does not match, try to install the deployment shell package again. If the SC field for Shell running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
Page 39
IMPORTANT! If the GOLDEN_2 image is running on the FPGA, carefully review the Design Advisory for Alveo Data Center Accelerator Card Golden Corruption, found at Xilinx Answer Record AR-71915. Complete the repair instructions associated with the Xilinx Answer prior to proceeding.
Page 40
If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
Alveo packages. To list all currently platform packages, run the following command in a Linux terminal: $ apt list --installed | grep xilinx To list the currently installed XRT package, run the following command: $ apt list --installed | grep xrt Upgrade from 2018.2 to 2018.3 in Ubuntu...
Page 42
If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash the firmware to the Alveo card.
Page 43
If the package does not match, try to install the deployment platform package again. If the SC field for Flashable partition running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 5. Flash. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash -a all 6.
Page 44
$ sudo /opt/xilinx/xrt/bin/xbutil flash scan If the package does not match, try to install the deployment shell package again. If the SC field for Shell running on FPGA is blank, then follow the instructions in Xilinx Answer Record AR-71760. 8. Flash the firmware to the Alveo card.
Page 45
IMPORTANT! If the GOLDEN_2 image is running on the FPGA, carefully review the Design Advisory for Alveo Data Center Accelerator Card Golden Corruption, found at Xilinx Answer Record AR-71915. Complete the repair instructions associated with the Xilinx Answer prior to proceeding.
Page 46
Appendix A: Changing XRT and Target Platform Versions 8. Flash the firmware to the Alveo card. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update 9. To load the new firmware image on the FPGA, cold boot the machine. 10. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match.
Page 47
If not, manually list the packages using the list command at the beginning of this section, then delete the remaining packages using the remove command. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
Page 49
Note: For CentOS 7.5, create the repo file /etc/yum.repos.d/centos75.repo and add the above content, replacing "7.4.1708" with "7.5.1804". Similarly, for CentOS 7.6, create the repo file /etc/ yum.repos.d/centos76.repo and add the above content, replacing "7.4.1708" with "7.6.1810". UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
1. Open a terminal window. 2. Run the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 3. Enter y to continue. The following message is displayed on completion. Shell is reset succesfully Cold reboot machine to load new shell on card 4.
To flash the firmware installed in the system to the Alveo™ card, use the xbmgmt flash -- update command. The format of the xbmgmt flash --update command is: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <shell_name> --card <card_bdf> To obtain the necessary card_bdf and shell_name options, run the following xbmgmt flash --scan command.
Page 52
IMPORTANT! Utilisez une commande xbmgmt flash distincte pour faire flasher chaque carte du système. WICHTIG! Verwenden Sie einen separaten xbmgmt flash-Befehl, um jede Karte im System zu flashen. UG1301 (v1.5) June 3, 2020 www.xilinx.com Send Feedback Getting Started with Alveo Accelerator Cards...
• On Windows, select Start → All Programs → Xilinx Design Tools → DocNav. • At the Linux command prompt, enter docnav. Xilinx Design Hubs provide links to documentation organized by design tasks and other topics, which you can use to learn key concepts and address frequently asked questions. To access the Design Hubs: •...
The information disclosed to you hereunder (the "Materials") is provided solely for the selection and use of Xilinx products. To the maximum extent permitted by applicable law: (1) Materials are made available "AS IS" and with all faults, Xilinx hereby DISCLAIMS ALL WARRANTIES AND...
Page 55
IP cores may be subject to warranty and support terms contained in a license issued to you by Xilinx. Xilinx products are not designed or intended to be fail-safe or for use in any application requiring fail-safe performance; you assume sole risk and liability for...
Need help?
Do you have a question about the Alveo U200 and is the answer not in the manual?
Questions and answers