Xilinx Alveo U200 Getting Started

Section Revision Summary 06/03/2020 Version 1.5 Chapter 1: Introduction Updated the information. Card Features Added new section. xbutil validate Updated information about specifying -d. 12/18/2019 Version 1.4 XRT and Deployment Package Installation Procedures on Ubuntu Added a note about XRT installation. Chapter 7: Troubleshooting Updated information about installing packages on RedHat and CentOS. Known Issues Added a known issue. 10/31/2019 Version 2019.2 General Updated to the Vitis™ unified software platform throughout. Updated outputs throughout document. Qualified Servers Provided the web link to the qualified servers. Chapter 4: Installing the Deployment Software Replaced xbutil command with the new xbmgmt command for card flashing. Updated output logs. Known Issues Added a known issue. XRT and Deployment Platform Installation Procedures on RedHat and CentOS Replaced xbutil command with the new xbmgmt command for card flashing. Updated output logs. XRT and Deployment Package Installation Procedures on Ubuntu Running xbmgmt flash --scan Replaced xbutil command with the new xbmgmt command when scanning card. Updated output logs. Appendix A: Changing XRT and Target Platform Versions Replaced xbutil command with the new xbmgmt command for card flashing. Updated output logs. Appendix C: Reverting the Card to Factory Image Added new appendix. 07/23/2019 Version 2019.1 Upgrade from 2018.x to 2019.1 in RedHat and CentOS Corrected answer record links Upgrade from 2018.2 to 2018.3 in RedHat and CentOS Upgrade from 2018.2 to 2018.3 in Ubuntu Downgrade from 2018.3 to 2018.2 in Ubuntu 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. Revision History UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 2 Send Feedback

General Added support for Alveo U280 production card. Appendix A: Changing XRT and Target Platform Versions Updated upgrade and downgrade steps. 06/05/2019 Version 2019.1 General Updated outputs throughout document. Qualified Servers Updated table of validated servers. Card Interfaces and Details Added information on status LEDs. Installing the Card Added image of an installed Alveo card. Chapter 4: Installing the Deployment Software Updated installation, upgrade, and downgrade flows for 2019.1 release. Chapter 6: Next Steps Added information on additional development resources. Chapter 7: Troubleshooting Updated troubleshooting and known issues. 02/12/2019 Version 1.3 General Added support for Alveo U280 ES card. Modifying the Installation on RedHat and CentOS, Modifying the Installation on Ubuntu Updated instructions on upgrading and downgrading XRT and the deployment shell. Appendix D: Generating the xbmgmt flash --update Command Updated instructions. 01/23/2019 Version 1.2 XRT and Deployment Platform Installation Procedures on RedHat and CentOS, XRT and Deployment Package Installation Procedures on Ubuntu Updated instructions on running xbutil flash. Appendix D: Generating the xbmgmt flash --update Command Added new information on how to generate the options needed to run xbutil flash. 12/21/2018 Version 1.1 Minimum System Requirements Updated system requirements. XRT and Deployment Platform Installation Procedures on RedHat and CentOS Updated installation flow. Modifying the Installation on RedHat and CentOS Added new information on upgrading and downgrading deployment software. Modifying the Installation on Ubuntu 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. N/A Revision History UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 3 Send Feedback

Revision History...............................................................................................................2 Chapter 1: Introduction.............................................................................................. 6 Card Features...............................................................................................................................6 Minimum System Requirements...............................................................................................7 Qualified Servers......................................................................................................................... 8 Chapter 2: Unpacking...................................................................................................9 Accelerator Card Overview.........................................................................................................9 Chapter 3: Card Installation Procedures......................................................... 12 Safety Instructions.................................................................................................................... 12 Before You Begin.......................................................................................................................14 Installing the Card.....................................................................................................................15 Chapter 4: Installing the Deployment Software......................................... 20 XRT and Deployment Platform Installation Procedures on RedHat and CentOS............. 20 XRT and Deployment Package Installation Procedures on Ubuntu................................... 24 Chapter 5: Card Bring-Up and Validation........................................................27 Running lspci............................................................................................................................. 27 Running xbmgmt flash --scan................................................................................................. 28 xbutil validate............................................................................................................................ 29 Chapter 6: Next Steps.................................................................................................31 Chapter 7: Troubleshooting.................................................................................... 32 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 Getting Started with Alveo Accelerator Cards 4 Send Feedback

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 Getting Started with Alveo Accelerator Cards 5 Send Feedback

U280 Alveo™ Data Center accelerator cards and applies to Vitis™ release 2019.2 and later. If you are using an earlier SDAccel™ release, follow the instructions in v1.3 of Getting Started with Alveo Data Center Accelerator Cards (UG1301). The Xilinx® Alveo™ U200/U250/U280 Data Center accelerator cards are peripheral component interconnect express (PCIe®) Gen3 x16 compliant cards featuring the Xilinx Virtex® UltraScale+™ technology. These cards accelerate compute-intensive applications such as machine learning, data analytics, video processing, and more. The Alveo U200/U250/U280 Data Center accelerator cards are available in passive and active cooling configurations. Different system configurations are available for running, developing, and debugging applications on your Alveo accelerator cards: • Running Applications: To run accelerated applications, install an Alveo card into a system as described in Chapter 3: Card Installation Procedures along with the required deployment software to support running applications as described in Chapter 4: Installing the Deployment Software. • Developing Applications: To develop FPGA accelerated applications, it is necessary to install both the deployment software and the development software. Development software installation, described in Chapter 6: Next Steps, installs both a development target platform and the Vitis environment. This configuration does not have an Alveo card installed and is used for development along with debugging in emulation modes. • Running, Developing, and Debugging Applications: By installing the Alveo card along with both the deployment and development software on a single machine, you can configure a system for developing and running accelerated applications. 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. Chapter 1: Introduction UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 6 Send Feedback

Card Component U200 U250 U280 FPGA UltraScale+ XCU200-2FSGD2104E UltraScale+ XCU250-2LFIGD2104E UltraScale+ XCU280-L2FSVH2892E DDR4 64 gigabyte (GB) 4x DDR4 16 GB 32 gigabyte (GB) 2x DDR4 16 GB 2400 mega-transfers per second (MT/s), 64-bit with error correcting code (ECC) DIMM x4/x8 unregistered dual inline memory module (UDIMM) support HBM – – ✓ Configuration Options 1 gigabit (Gb) Quad Serial Peripheral Interface (SPI) flash memory Micro-AB universal serial bus (USB) JTAG configuration port PCIe 16-lane PCI Express PCIe Integrated Endpoint block connectivity Gen1, 2, or 3 up to x16 I2C Bus ✓ ✓ ✓ Status LEDs ✓ ✓ ✓ Power Management Power management with system management bus (SMBus) voltage, current, and temperature monitoring External Power Sources 65W PCIe slot functional with PCIe slot power only 150 W PCIe slot functional with 110 A max VCCINT current PCIe slot power and 6-pin PCIe AUX power cable connected 225 W PCIe slot functional with 160 A max VCCINT current PCIe slot power and 8-pin PCIe AUX power cable connected Flash Memory Onboard reprogrammable flash configuration memory UART Universal asynchronous receiver-transmitter (UART) access through the USB port Configuration UltraScale+ device configurable over USB/JTAG and Quad SPI configuration flash memory Minimum System Requirements The minimum system requirements for running the Alveo™ U200/U250/U280 Data Center accelerator cards are listed below: Table 2: Minimum System Requirements Component Requirement Motherboard PCI Express® 3.0-compatible with one dual-width x16 slot. System Power Supply 225W via PCI Express Slot connection and 8-pin PCI Express Auxiliary Power cable. Operating System Linux, 64-bit: • Ubuntu 16.04, 18.04 • CentOS 7.4, 7.5, 7.6 • RHEL 7.4, 7.5, 7.6 Chapter 1: Introduction UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 7 Send Feedback

Component Requirement System Memory For deployment installations, a minimum of 16 GB plus application memory requirements is required. For development installations, a minimum of 64 GB of device memory is required, but 80 GB is recommended. Internet Connection Required for downloading drivers and utilities. Hard disk space Satisfy the minimum system requirements for your operating system. Licensing None required for application deployment. For the application development environment, see Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393). For additional specifications and details on the acceptable environmental conditions, see Alveo 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. Chapter 1: Introduction UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 8 Send Feedback

Card Interfaces and Details Alveo™ cards are available in both passive and active cooling configurations; see Passive and Active Cooling Cards. The interfaces of each are identical, except the fan included on active cooled cards. The card includes the following interfaces, and are shown in the following figure: 1. A PCI Express® card connector. 2. A PCI Express Auxiliary Power Connector. This connector is shown in Figure 4. Connector is not compatible with an ATX12V/EPS12V power source. 3. Two QSFP interfaces. Currently these interfaces are not supported by the deployment platform. 4. A Micro-USB connector for maintenance purposes. 5. A fan for the active cooled card configuration. 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. Chapter 2: Unpacking UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 9 Send Feedback

Fan (for Active configuration only) PCIe Connector Micro-USB Interface Network Interface Note: On the Alveo U280 card, the Micro-USB is located on the opposite end of the card between the PCB board and the enclosure. Passive and Active Cooling Cards Alveo™ cards are available in both active and passive cooling configurations, as shown in the following figures. The passive cooling card is designed to be installed into a data center server, where controlled air flow provides direct cooling. The active cooling card is designed to be installed into a PC environment where the air flow is uncontrolled; consequently, this configuration includes a heat sink and fan enclosure cover to provide appropriate cooling. 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). Note: The U280 related specifications in this document apply to production U280 cards. Any differences in U280 ES1 card specifications and capabilities are documented in the U280 ES1 Known Issues Xilinx Answer 71925. Chapter 2: Unpacking UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 10 Send Feedback

Figure 3: Passive Cooled Card Configuration Chapter 2: Unpacking UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 11 Send Feedback

To reduce the risk of fire, electric shock, or injury, always follow basic safety precautions. CAUTION! You must always use an ESD strap or other antistatic device when handling hardware. ATTENTION! Il est fortement recommandé d'utiliser un bracelet ESD ou autres dispositifs antistatiques. VORSICHT! Beim Umgang mit Hardware müssen sie immer ein Erdungs Armband oder ein anderes antistatisches Gerät verwenden. Safety Instructions Safety Information To ensure your personal safety and the safety of your equipment: • Keep your work area and the computer/server clean and clear of debris. • Before opening the computer/system cover, unplug the power cord. Dispositif de Sécurité Pour assurer votre sécurité personnelle et la sécurité de votre équipement: • Maintenez votre zone de travail et l'ordinateur/serveur propre et dégagé de débris. • Avant d'ouvrir le capot de l'ordinateur/système, débranchez le cordon d'alimentation. Sicherheitsinformation Um ihre persönliche Sicherheit und die Sicherheit ihrer Ausrüstung zu gewährleisten: • Halten sie ihren Arbeitsbereich und den Computer / Server sauber und frei von Ablagerungen. • Ziehen sie vor dem Öeffnen der Computer / Systemabdeckung das Netzkabel ab. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 12 Send Feedback

Electrostatic discharge (ESD) can damage electronic components when they are improperly handled, and can result in total or intermittent failures. Always follow ESD-prevention procedures when removing and replacing components. To prevent ESD damage: • Use an ESD wrist or ankle strap and ensure that it makes skin contact. Connect the equipment end of the strap to an unpainted metal surface on the chassis. • Avoid touching the card against your clothing. The wrist strap protects components from ESD on the body only. • Handle the card by its bracket or edges only. Avoid touching the printed circuit board or the connectors. • 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 entraîner des défaillances totales ou intermittentes. Suivez toujours les procédures de prévention contre les ESD lors du retrait et remplacement des composants. Pour prévenir les dommages dus aux ESD: • Utilisez une sangle de poignet ou de cheville anti-ESD et assurez-vous qu'elle est en contact avec la peau. Branchez l'extrémité du cable de la sangle à une surface métallique non peinte du châssis et a la masse. • Évitez de mettre en contact la carte de circuit imprimé ou les connecteurs avec vos vêtements. La sangle de poignet protège la carte ou connecteurs contre les ESD du corps seulement. • Manipulez la carte uniquement par son support ou par ses bords. Évitez de toucher la carte de circuit imprimé ou les connecteurs. • Ne posez la carte de circuit imprimé ou les connecteurs que sur une surface antistatique telle que le sac anti-statique fourni avec la carte. • Si vous retournez la carte a Xilinx, remettez-la dans son sac antistatique immédiatement. Vorsicht Elektrostatische Entladung Elektrostatische Entladung (ESD) kann elektronische Bauteile beschädigen, wenn sie unsachgemäß behandelt werden, und es kann zu totalen oder zeitweiligen Ausfällen kommen. Befolgen sie beim Entfernen und Austauschen von Komponenten stets die ESD- Schutzmaßnahmen. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 13 Send Feedback

• Verwenden sie einen ESD-Handgelenk-oder Knöchelriemen und stellen sie sicher, dass er Hautkontakt hat. Verbinden sie das Ende des Riemens mit einer unlackierten Metalloberfläche am Gehäuse. • Berühren sie die Karte nicht mit ihrer Kleidung. Der Riemen schützt Komponenten nur vor ESD am Körper. • Fassen sie die Karte nur an der Halterung oder an den Kanten an. Berühren sie nicht die Leiterplatte oder die Anschlüsse. • 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. Before You Begin IMPORTANT! Alveo™ cards are delicate and sensitive electronic devices; equipment is to be installed by a qualified technician only. This equipment is intended for installation in a Restricted Access Location. IMPORTANT! Les cartes Alveo™ sont des appareils électronique sensibles et fragiles; l'équipement doit être installé par un technicien certifié seulement. Cet équipement est destiné à être installé dans un lieu d'accès restreint. WICHTIG! Die Karten Alveo™ sind sensible und empfindliche elektronische Geräte. Das Gerät darf nur von einem qualifizierten Techniker installiert werden. Dieses Gerät ist für die Installation an einem Ort mit begrenztem Zugang vorgesehen. • Verify that the minimum card space is available to install your card. Card specifications and dimensions can be found in Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) and Alveo U280 Data Center Accelerator Cards Data Sheet (DS963). Note: The specifications in Alveo U280 Data Center Accelerator Cards Data Sheet (DS963) apply to production U280 cards. Any differences in U280 ES1 card specifications and capabilities are documented in the U280 ES1 Known Issues Xilinx Answer Record 71925. • Check for card compatibility with the system. Also check for proper system requirements such as power, bus type, and physical dimensions to support the card. • Ensure that appropriate PCIe Auxiliary Power source is available, and not an ATX12V/EPS12V power source. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 14 Send Feedback

IMPORTANT! Do not unplug the Alveo™ AUX power connector while in the power-up state (hot-plug is not allowed). IMPORTANT! Ne débranchez pas le connecteur auxiliaire d'alimentation des cartes Alveo™ pendant qu’elles sont sous-tension (“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. If you encounter any issues during installation, see Chapter 7: Troubleshooting and Known Issues. Also see AR-71752 for additional known issues. 1. Host power supply must be disconnected. 2. For enclosed computers, open your computer by removing the casing. 3. If necessary, remove the two adjacent PCIe® x16 slot covers corresponding to the PCIe x16 slot in which you are installing the Alveo card. 4. Plug the Alveo card in the PCIe x16 slot on the motherboard. 5. Connect the AUX power connector to the Alveo card, ensure the plug is mechanically fixed (with the click). IMPORTANT! Operation of the Alveo™ cards only with AUX power connector is not allowed. IMPORTANT! Le fonctionnement des cartes Alveo™ uniquement avec le connecteur auxiliaire n'est pas autorisé. WICHTIG! Der Betrieb von Alveo™-Karten nur mit AUX Connector ist nicht zulässig. The Alveo card has an 8-pin female PCIe AUX power connector. Depending on your server or computer, an additional PCI Express Auxiliary power cable or adapter may be needed. Consult your computer documentation for additional information. For actively cooled cards, connect the power cable to the AUX power connector at top of the card as shown in the following figure. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 15 Send Feedback

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. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 16 Send Feedback

WARNING! Alveo cards are not compatible with an ATX12V/EPS12V power source. Do not force connection to a CPU (ATX12V/EPS12V) power source. This will damage the Alveo card and void the warranty. ATTENTION! Les cartes Alveo ne sont pas compatibles avec une source d'alimentation ATX12V / EPS12V. Ne forcez pas la connexion à une source d'alimentation CPU (ATX12V / EPS12V). Cela endommagerait la carte Alveo et annulerait la garantie. WARNUNG! Alveo-Karten sind nicht mit einer ATX12V / EPS12V-Stromquelle kompatibel. Erzwingen Sie keine Verbindung zu einer CPU-Stromquelle (ATX12V / EPS12V). Dadurch wird die Alveo-Karte beschädigt und die Garantie erlischt. The power-supply can have an 8-pin or a 6-pin power connector configuration. Some power supplies label this cable PCIe Auxiliary Power or VGA. These connector configurations are not pin compatible with other power source types. Do not force a connection to any power source other than PCIe Auxiliary Power. IMPORTANT! Only 140W of power is available with the 6-pin connector (65 Watts from PCIe connector with 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). Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 17 Send Feedback

partir de la source du connecteur PCIe 12V et 75 watts à partir du connecteur AUX à 6-broches). 215W est disponible avec le connecteur à 8-broches (65 watts à partir de la source du connecteur PCIe 12V et 150 watts à partir du connecteur 8-broches). WICHTIG! Mit dem 6-Pin-Anschluss stehen nur 140 W zur Verfügung (65 Watt vom PCIe-Anschluss mit 12 V- Quelle und 75 Watt vom 6-Pin-Anschluss). 215W ist mit dem 8-Pin-Anschluss erhältlich (65 Watt von 12V- PCIe-Anschluss und 150 Watt vom 8-Pin-Anschluss). The following example shows a successfully installed active configuration Alveo card. Figure 6: Installed Alveo Card PCIe Edge Connector PCIe AUX Power Cable 6. If you previously removed the computer casing, re-install the casing. 7. Connect the power cord and turn on the computer. 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). Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 18 Send Feedback

the terminal: $ sudo lspci -vd 10ee: 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 Subsystem: Xilinx Corporation Device 000e Flags: bus master, fast devsel, latency 0, IRQ 136 Memory at de000000 (32-bit, non-prefetchable) [size=32M] Memory at e0000000 (32-bit, non-prefetchable) [size=64K] Capabilities: [40] Power Management version 3 Capabilities: [48] MSI: Enable- Count=1/1 Maskable- 64bit+ Capabilities: [70] Express Endpoint, MSI 00 Capabilities: [100] Advanced Error Reporting Capabilities: [1c0] #19 Capabilities: [400] Access Control Services Kernel driver in use: xclmgmt Kernel modules: xclmgmt Note: If this card has previously been installed, the lspci output will be similar to the one shown in Running lspci. If you do not see a message similar to either of these, see Chapter 7: Troubleshooting. Chapter 3: Card Installation Procedures UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 19 Send Feedback

This chapter details the procedures for installing deployment software on RedHat/CentOS and Ubuntu operating systems. All software installations use standard Linux RPM and Linux DEB packages and require root access. The deployment software consists of the following software packages: • Xilinx® runtime (XRT): XRT provides the libraries and drivers for an application to run on Alveo™ cards. • Deployment platform: The deployment platform provides the base firmware needed to run pre-compiled applications. It cannot be used to compile or create new applications. To create new applications, install the development software detailed in Chapter 6: Next Steps. While you can also install the development software on a machine with an installed card, doing so is not necessary to run applications. For platform features and details, see Alveo Data Center Accelerator Card Platforms User Guide (UG1120). If you encounter any issues during installation, see Chapter 7: Troubleshooting and 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. WICHTIG! Root-Zugriff ist für alle Software- und Firmware-Installationen erforderlich. XRT and Deployment Platform Installation Procedures on RedHat and CentOS Use the following steps to download and install the XRT and deployment platform using a .rpm installation package. Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 20 Send Feedback

Changing XRT and Target Platform Versions. IMPORTANT! The installation packages referenced here are updated regularly and the file names frequently change. If you copy and paste any commands from this user guide, be sure to update the placeholders in those commands to match the downloaded packages. IMPORTANT! Les packages d'installation référencés ici sont mis à jour régulièrement et les noms de fichier changent fréquemment. Si vous copiez et collez des commandes de ce guide, veillez à mettre à jour les espaces réservés dans ces commandes pour qu'ils correspondent aux packages téléchargés. WICHTIG! Die hier genannten Installationspakete werden regelmäßig aktualisiert und die Dateinamen ändern sich häufig. Wenn Sie Befehle aus diesem Benutzerhandbuch kopieren und einfügen, müssen Sie die Platzhalter in diesen Befehlen entsprechend den heruntergeladenen Paketen aktualisieren. 1. XRT installation requires Extra Packages for Enterprise Linux (EPEL) and a related repository. The initial setup depends on whether you are using RedHat or CentOS. For Redhat: a. Open a terminal window and enter the following command: $ sudo yum-config-manager --enable rhel-7-server-optional-rpms This enables an additional repository on your system. b. Enter the following command to install EPEL: $ sudo yum install -y https://dl.fedoraproject.org/pub/epel/epel- release-latest-7.noarch.rpm For CentOS: • Enter the following command in a terminal window: $ sudo yum install epel-release This installs and enables the repository for Extra Packages for Enterprise Linux (EPEL). 2. Run the following two commands to install kernel headers and kernel development packages. Ensure that uname is surrounded by backticks ( `) and not single quotes ('): $ sudo yum install kernel-headers-`uname -r` $ sudo yum install kernel-devel-`uname -r` Note: If these yum commands fail because they cannot find packages matching your kernel version, set up a Vault repository. For more information, see related topic, Creating a Vault Repository for CentOS. 3. After the above command completes, reboot your machine. 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 Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 21 Send Feedback

5. Install the XRT installation package by running the following command from within the directory where the installation packages reside. is the latter part of the installation package file name. $ sudo yum install ./xrt_.rpm This will install the XRT and its necessary dependencies. Follow the instructions when prompted throughout the installation. 6. Install the deployment platform installation package: $ sudo yum install ./xilinx--.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. After installing the deployment platform you will see the following message: DSA package installed successfully. Please flash card manually by running below command: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell Note: When installing 2019.1 or earlier deployment platform packages, the displayed instructions use the xbutil rather than the xbmgmt command to flash. Flashing with xbutil is being deprecated and will not be supported in future releases. It is recommended to use the xbmgmt command to flash the Alveo card. 7. Flash the firmware to the Alveo card using the command displayed in the output of the previous step. It has the following format: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell If you have multiple cards installed or need to regenerate the command, follow the steps given in the related topic Generating the xbmgmt flash --update Command. 8. You will be asked to confirm the update, as shown below. Type y and press the Enter key. Status: shell needs updating Current shell: Shell to be flashed: Are you sure you wish to proceed? [y/n]: Flashing will take up to 10 minutes. IMPORTANT! Do not enter Ctrl + c in the terminal while the firmware is flashing as this can cause the card to become inoperable. IMPORTANT! N'entrez pas Ctrl + c dans le terminal lorsque le micrologiciel clignote, car cela pourrait rendre la carte inutilisable. WICHTIG! Geben Sie im Terminal nicht Strg + c ein, während die Firmware blinkt, da dies dazu führen kann, dass die Karte nicht mehr funktioniert. Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 22 Send Feedback

command returns Card Not Found, perform a cold reboot, and retry. Otherwise, see Chapter 7: Troubleshooting. Updating SC firmware on card[0000:65:00.0] INFO: found 4 sections ..................................... INFO: Loading new firmware on SC Updating shell on card[0000:65:00.0] INFO: ***Found 700 ELA Records Idcode byte[0] ff Idcode byte[1] 20 Idcode byte[2] bb Idcode byte[3] 21 Idcode byte[4] 10 Enabled bitstream guard. Bitstream will not be loaded until flashing is finished. Erasing flash................................... Programming flash................................... Cleared bitstream guard. Bitstream now active. Successfully flashed Card[0] 1 Card(s) flashed successfully. Cold reboot machine to load the new image on card(s). If you have previously upgraded the card, you will see a message similar to the following: Probing card[0]: Shell on FPGA is up-to-date 0 Card(s) flashed successfully. 9. Cold boot your machine to load the new firmware image on the FPGA. IMPORTANT! Be sure to fully power off the machine and then power it on again. The image will not boot from flash if the machine is only rebooted. IMPORTANT! Assurez-vous d'éteindre complètement la machine, puis de la rallumer. L'image flash ne démarrera pas si la machine n'est pas redémarrée. WICHTIG! Schalten Sie das Gerät vollständig aus und wieder ein. Das Image startet nicht von Flash, wenn der Computer nur neu gestartet wird. 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 Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 23 Send Feedback

Procedures on Ubuntu Note: When installing XRT on Ubuntu, if the 2015 version of pyopencl is installed on your system, you must uninstall it. The XRT installation will install the 2019 version of pyopencl and will return an error if the 2015 version is installed. For more information, see Xilinx Answer Record 73055. Use the following steps to download and install the XRT and deployment platform using a .deb installation package. For details on upgrading or downgrading the XRT and deployment package, see Appendix A: Changing XRT and Target Platform Versions. IMPORTANT! The installation packages referenced here are updated regularly and the file names frequently change. If you copy and paste any commands from this user guide, be sure to update the placeholders in those commands to match the downloaded packages. IMPORTANT! Les packages d'installation référencés ici sont mis à jour régulièrement et les noms de fichier changent fréquemment. Si vous copiez et collez des commandes de ce guide, veillez à mettre à jour les espaces réservés dans ces commandes pour qu'ils correspondent aux packages téléchargés. WICHTIG! Die hier genannten Installationspakete werden regelmäßig aktualisiert und die Dateinamen ändern sich häufig. Wenn Sie Befehle aus diesem Benutzerhandbuch kopieren und einfügen, müssen Sie die Platzhalter in diesen 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 • Alveo U280 Product Page 2. Install the XRT installation package by running the following command from within the directory where the installation packages reside. is the latter part of the installation package file name. $ sudo apt install ./xrt_.deb This will install the XRT along with any necessary dependencies. Follow the instructions when prompted throughout the installation. 3. Install the deployment installation packages required for the card: $ sudo apt install ./xilinx--.deb Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 24 Send Feedback

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. After installing the deployment platform you will see the following message: DSA package installed successfully. Please flash card manually by running below command: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell Note: When installing 2019.1 or earlier deployment platform packages, the displayed instructions use the xbutil rather than the xbmgmt command to flash. Flashing with xbutil is being deprecated and will not be supported in future releases. It is recommended to use the xbmgmt command to flash the Alveo card. 4. Flash the firmware to the Alveo card using the command displayed in the output of the previous step. It has the following format: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell If you have multiple cards installed or need to regenerate the command, follow the steps given in the related topic, Generating the xbmgmt flash --update Command. 5. You will be asked to confirm the update, as shown below. Type y and press the Enter key. Status: shell needs updating Current shell: Shell to be flashed: Are you sure you wish to proceed? [y/n]: Flashing will take up to 10 minutes. IMPORTANT! Do not enter Ctrl + c in the terminal while the firmware is flashing as this can cause the card to become inoperable. IMPORTANT! N'entrez pas Ctrl + c dans le terminal lorsque le micrologiciel clignote, car cela pourrait rendre la carte inutilisable. WICHTIG! Geben Sie im Terminal nicht Strg + c ein, während die Firmware blinkt, da dies dazu führen kann, dass die Karte nicht mehr funktioniert. Successfully flashing a new card results in a message similar to the one shown below. If the command returns Card Not Found, perform a cold reboot, and retry. Otherwise, see Chapter 7: Troubleshooting. Updating SC firmware on card[0000:65:00.0] INFO: found 4 sections ..................................... INFO: Loading new firmware on SC Updating shell on card[0000:65:00.0] INFO: ***Found 700 ELA Records Idcode byte[0] ff Idcode byte[1] 20 Idcode byte[2] bb Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 25 Send Feedback

Idcode byte[4] 10 Enabled bitstream guard. Bitstream will not be loaded until flashing is finished. Erasing flash................................... Programming flash................................... Cleared bitstream guard. Bitstream now active. Successfully flashed Card[0] 1 Card(s) flashed successfully. Cold reboot machine to load the new image on card(s). If you have previously updated the card, you will see a message similar to the following: Probing card[0]: Shell on FPGA is up-to-date 0 Card(s) flashed successfully. 6. Cold boot your machine to load the new firmware image on the FPGA. IMPORTANT! Be sure to fully power off the machine and then power it on again. The image will not boot from flash if the machine is only rebooted. IMPORTANT! Assurez-vous d'éteindre complètement la machine, puis de la rallumer. L'image flash ne démarrera pas si la machine n'est pas redémarrée. WICHTIG! Schalten Sie das Gerät vollständig aus und wieder ein. Das Image startet nicht von Flash, wenn der Computer nur neu gestartet wird. 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 Chapter 4: Installing the Deployment Software UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 26 Send Feedback

After installing the XRT and deployment platform, the card installation can be verified using the following commands, which are explained in more detail below. • lspci • xbmgmt flash --scan • 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. These utilities include multiple commands to validate and identify the installed card(s) and report additional card details including memory, PCIe®, platform name, and system information. See Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393) for a detailed list of commands. Set the environment to use the utilities by running the following command. Note that the command is dependent on the command shell you are using. Use the following command in csh shell: $ source /opt/xilinx/xrt/setup.csh Use the following command in bash shell: $ source /opt/xilinx/xrt/setup.sh Running lspci 1. Enter the following command: $ sudo lspci -vd 10ee: Chapter 5: Card Bring-Up and Validation UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 27 Send Feedback

similar to the one below. Note that for each card, there will be two physical functions found: one for management and one for user. See https://xilinx.github.io/XRT/master/html/ platforms.html for additional details. 03:00.0 Processing accelerators: Xilinx Corporation Device 5020 Subsystem: Xilinx Corporation Device 000e Physical Slot: 4 Flags: bus master, fast devsel, latency 0, NUMA node 0 Memory at d2000000 (64-bit, prefetchable) [size=32M] Memory at d4000000 (64-bit, prefetchable) [size=128K] Capabilities: [40] Power Management version 3 Capabilities: [60] MSI-X: Enable+ Count=33 Masked- Capabilities: [70] Express Endpoint, MSI 00 Capabilities: [100] Advanced Error Reporting Capabilities: [1c0] #19 Capabilities: [e00] Access Control Services Kernel driver in use: xclmgmt Kernel modules: xclmgmt 03:00.1 Processing accelerators: Xilinx Corporation Device 5021 Subsystem: Xilinx Corporation Device 000e Physical Slot: 4 Flags: bus master, fast devsel, latency 0, IRQ 26, NUMA node 0 Memory at d0000000 (64-bit, prefetchable) [size=32M] Memory at d4020000 (64-bit, prefetchable) [size=64K] Memory at c0000000 (64-bit, prefetchable) [size=256M] Capabilities: [40] Power Management version 3 Capabilities: [60] MSI-X: Enable+ Count=33 Masked- Capabilities: [70] Express Endpoint, MSI 00 Capabilities: [100] Advanced Error Reporting Capabilities: [e00] Access Control Services Kernel driver in use: xocl Kernel modules: xocl Note: For deployment platforms earlier than 2018.3, User PF is assigned to function 0 and Management PF is assigned to function 1. Running xbmgmt flash --scan Use the xbmgmt flash --scan command to view and validate the card's current firmware version, as well as display the installed card details, including card BDF, platform name, and timestamp. 1. Enter the following command: $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan Chapter 5: Card Bring-Up and Validation UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 28 Send Feedback

Card [0000:65:00.0] Card type: u200 Flash type: SPI Flashable partition running on FPGA: xilinx_u200_xdma_201830_2,[ID=0x000000005d1211e8],[SC=4.2.0] Flashable partitions installed in system: xilinx_u200_xdma_201830_2,[ID=0x000000005d1211e8],[SC=4.2.0] In this example, the BDF is 0000:65:00.0. The name of the platform and associated ID, along with the SC firmware version, running on the FPGA are found under Flashable partition running on FPGA while the ones installed in the system are found under Flashable partitions installed in system. In the above output example, the platform on the FPGA and system are identical; the deployment platform is named xilinx_u200_xdma_201830_2, the ID is 0x000000005d1211e8 and the SC version is 4.2.0. In the outputs above, ID is the timestamp and SC refers to the Satellite Controller. 2. Verify that the deployment platform version installed on the FPGA is identical to that installed on the system. You can do this by making sure the lines under Flashable partition running on FPGA and Flashable partitions installed in system are identical. If these versions do not match, see Chapter 7: Troubleshooting. xbutil validate The xbutil validate command validates the correct installation by performing the following set of tests: 1. Validates the device found. 2. Checks PCIe link status. 3. Runs a verify kernel on the card. 4. Performs the following data bandwidth tests: a. 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 Chapter 5: Card Bring-Up and Validation UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 29 Send Feedback

the command will validate all cards in the system. 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 7: Troubleshooting. sudo /opt/xilinx/xrt/bin/xbutil validate INFO: Found 1 cards INFO: Validating card[0]: xilinx_u200_xdma_201830_2 INFO: == Starting AUX power connector check: INFO: == AUX power connector check PASSED INFO: == Starting PCIE link check: INFO: == PCIE link check PASSED INFO: == Starting verify kernel test: INFO: == verify kernel test PASSED INFO: == Starting DMA test: Buffer Size: 256 MB Host -> PCIe -> FPGA write bandwidth = 8391.65 MB/s Host <- PCIe <- FPGA read bandwidth = 12167 MB/s INFO: == DMA test PASSED INFO: == Starting device memory bandwidth test: ........... Maximum throughput: 52428 MB/s INFO: == device memory bandwidth test PASSED INFO: == Starting PCIE peer-to-peer test: P2P BAR is not enabled. Skipping validation INFO: == PCIE peer-to-peer test SKIPPED INFO: == Starting memory-to-memory DMA test: bank0 -> bank1 M2M bandwidth: 12022.2 MB/s bank0 -> bank2 M2M bandwidth: 12060.7 MB/s bank0 -> bank3 M2M bandwidth: 12064.1 MB/s bank1 -> bank2 M2M bandwidth: 12064.1 MB/s bank1 -> bank3 M2M bandwidth: 12058.4 MB/s bank2 -> bank3 M2M bandwidth: 12059 MB/s INFO: == memory-to-memory DMA test PASSED INFO: Card[0] validated successfully. INFO: All cards validated successfully. Note: The DMA bandwidth can vary depending upon NUMA/affinity. Chapter 5: Card Bring-Up and Validation UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 30 Send Feedback

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. If you are an application developer who wants to develop and deliver accelerated applications, install the Vitis™ software platform. It allows you to develop, debug, and optimize accelerated applications for Alveo cards. Installation instructions can be found in Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393). For an overview of developing accelerated applications with Alveo™ with accompanying guided examples, see https://developer.xilinx.com/en/articles/acceleration-basics.html. For complete details on the development flow and getting started in Vitis, see Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400). For an introduction to Vitis methodology, see Vitis Unified Software Platform Documentation (UG1416). Chapter 6: Next Steps UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 31 Send Feedback

Table 3: Card Troubleshooting Issue Potential Cause Fix Card not found. Card not correctly installed. Reinstall the card following the installation instructions. 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. Ensure maintenance USB cable is removed before booting system. Kernel version is incompatible. Run uname -r to check the kernel version. Ensure that the kernel version matches the version listed for your OS in Chapter 4: Installing the Deployment Software. lspci no longer recognizes the card. Card is overheating. Ensure that operating ambient conditions do not exceed specifications and passive cards are in a system that provides adequate airflow. XRT installation incomplete or unsuccessful. Missing dependent packages. Contact your Linux administrator. Deployment platform installation incomplete or unsuccessful. Missing dependent packages. Contact your Linux administrator. xbmgmt --flash returns the error: Specified DSA is not applicable Correct type of deployment platform package not installed. Install the correct type of deployment platform package. Unable to install packages on RedHat and CentOS. Incorrect permissions for download directory, for example, a /home/ directory. Download the packages to a directory where root has read access (for example, /tmp ). Use the full path to the RPM package when installing. yum will fail with a relative path to RPM package. Chapter 7: Troubleshooting UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 32 Send Feedback

Issue Potential Cause Fix When running xbutil the following message is displayed: Failed to open device: 0000:3b:00.0 INFO: Found total 1 card(s); 0 are usable. Driver has not loaded successfully or the card is not flashed successfully. Perform a cold reboot. XRT package fails to install on CentOS7.4, CentOS7.5, or CentOS7.6 Kernel development headers are missing. The XRT package is missing a dependency on kernel-devel and kernel-headers. Manually install kernel-devel and kernel-header with yum install: $ sudo yum install kernel- headers-`uname -r` $ sudo yum install kernel- devel-`uname -r` Note: Do not run sudo yum upgrade. This will update the kernel-headers to an incompatible version. Flashing the card does not complete after 20 minutes. The flash operation has failed. Perform cold-reboot and then re-flash the card. Run time fails with following message: Error: Failed to find Xilinx platform Failed to source the setup.sh script. Source /opt/xilinx/xrt/setup.sh When installing the XRT, you see the following message: N: Can't drop privileges for downloading as file '/root/ xrt_201802.2.1.79_16.04.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied) This is caused by running sudo apt install as root. The XRT will install correctly, despite the error. You can find more information about this error on AskUbuntu. Known Issues The following table lists known issues. See Xilinx Answer Record 71752 and Xilinx Answer Record 71975 for additional known issues. Table 4: Known Issues Area Description Comments/Recommendations xbmgmt xbmgmt commands do not work. There are no errors indicating this in output. Reinstall the XRT package. Chapter 7: Troubleshooting UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 33 Send Feedback

Area Description Comments/Recommendations General On CentOS 7.5, driver may not be loaded properly after boot up (or reboot). After boot up (or reboot), run these two commands to load the device driver: $ sudo rmmod xclmgmt $ sudo modprobe xclmgmt General The Alveo card has not trained to the full expected PCI Express link width or link speed. The output from xbutil validate will look like the following: $ INFO: Validating device[0]: INFO: Checking PCIE link status: FAILED WARNING: Device trained to lower spec. Expect: Gen3x16, Current: Gen2x16 Ensure that the Alveo card is plugged into a Gen 3x16 capable slot, and that the power cable is connected. Then cold reboot and see if the card trains to the correct settings. General The card is not present when running xbutil or lspci. The card may not have been ready when the server enumerated PCI Express. Potential Fix: Warm Reboot the server, Disable Fast Boot. General Card does not show up when running lspci and the red LED on the card is illuminated. When card is first installed in server, BIOS may not recognize the card correctly and red LED on card is illuminated, indicating an error. Cold boot the server four times until the blue LED on the card is illuminated, indicating the card is successfully running. If the red LED is still illuminated, disconnect the power to the sever for 5 minutes and repeat the step above. General FAILED TO INSTALL PYOPENCL error encountered during XRT installation. It is necessary to upgrade pip and python using the following commands prior to installing XRT. 1. sudo pip install --upgrade pip 2. sudo python -m pip install numpy Chapter 7: Troubleshooting UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 34 Send Feedback

Versions The Alveo™ Data Center Accelerator card target platform and XRT revisions can change significantly between releases. To ensure a successful upgrade (or downgrade) of the Alveo card XRT and platform, carefully follow the instructions for your specific release pairing. Failure to adhere to these procedures can result in an unstable installation or other issues. The procedures for changing between the 2018.2 and 2018.3 releases differ from changing between 2018.x (2018.2 and 2018.3) and 2019.1 as well as the 2019.2 releases due to significant architectural changes in the Alveo card platform and XRT. Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. IMPORTANT! Do not enter Ctrl + c in the terminal while the firmware is flashing as this can cause the card to become inoperable. IMPORTANT! N'entrez pas Ctrl + c dans le terminal lorsque le micrologiciel clignote, car cela pourrait rendre la carte inutilisable. WICHTIG! Geben Sie im Terminal nicht Strg + c ein, während die Firmware blinkt, da dies dazu führen kann, dass die Karte nicht mehr funktioniert. RedHat and CentOS During upgrading, downgrading, or uninstalling, it can be useful to list the currently installed 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 Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 35 Send Feedback

Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. To upgrade from the 2018.2 to the 2018.3 release, perform the following steps. 1. Remove the current XRT and platform versions. $ sudo yum remove xrt 2. Download the XRT associated with the 2018.3 platform version and install it with the following command: $ sudo yum install < rpm-dir >/xrt_.rpm 3. Download the desired deployment platform installation package and install it with the following command: $ sudo yum install /xilinx--.rpm 4. Run the following command and confirm that the value in Flashable partitions installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash -a all 6. To load the new firmware image on the FPGA, cold boot the machine. 7. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 8. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Downgrade from 2018.3 to 2018.2 in RedHat and CentOS Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 36 Send Feedback

1. Remove the current XRT and platform versions. $ sudo yum remove xrt 2. Download the 2018.2 version of XRT and install it with the following command: $ sudo yum install < rpm-dir >/xrt_.rpm 3. Download the desired deployment platform installation package and install it with the following command: $ sudo yum install /xilinx--.rpm 4. Run the following command and confirm that the value in Flashable partitions installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash -a all 6. To load the new firmware image on the FPGA, cold boot the machine. 7. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 8. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Upgrade from 2018.x to 2019.1 in RedHat and CentOS Note: For links to the available shell and XRT revisions, see Chapter 4: Installing the Deployment Software. To upgrade from either the 2018.2 or 2018.3 release to the 2019.1 release, perform the following steps. 1. Remove the current XRT and shell versions. $ sudo yum remove xrt Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 37 Send Feedback

$ sudo yum install /xrt_.rpm 3. Restore the card to the original manufacturing state. $ sudo /opt/xilinx/xrt/bin/xbutil flash -r 4. Cold reboot the system. 5. To confirm that the shell running on the FPGA is either GOLDEN_2 or GOLDEN_5, review the output from the following command. $ sudo /opt/xilinx/xrt/bin/xbutil flash scan For example, you might see xilinx_u250_GOLDEN_2. 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. IMPORTANT! Si l'image GOLDEN_2 est en cours d'exécution sur le FPGA, consultez attentivement l'avis de conception relatif à la corruption dorée de la carte accélératrice de centre de données Alveo, disponible dans l'enregistrement de réponse Xilinx AR-71915. Suivez les instructions de réparation associées à Xilinx Answer avant de poursuivre. WICHTIG! Wenn das GOLDEN_2-Image auf dem FPGA ausgeführt wird, lesen Sie die Designempfehlung zur Goldenen Beschädigung der Alveo Data Center-Beschleunigerkarte unter Xilinx Answer Record AR-71915. Führen Sie die mit der Xilinx Answer verbundenen Reparaturanweisungen aus, bevor Sie fortfahren.. 6. Download the desired deployment shell installation package and install it. $ sudo yum install /xilinx--.rpm 7. Run the following command and confirm that the value in Shell package installed in system field matches what was just installed, and that the SC field for Shell running on FPGA is not blank. See Running xbmgmt flash --scan for an explanation of the output. $ 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. $ sudo /opt/xilinx/xrt/bin/xbutil flash -a all 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 Shell running on FPGA and Shell package installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbutil flash scan Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 38 Send Feedback

Upgrade from 2018.x to 2019.2 in RedHat and CentOS Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. To upgrade from either the 2018.2 or 2018.3 release to the 2019.2 release, perform the following steps. 1. Remove the current XRT and platform versions. $ sudo yum remove xrt 2. Download the 2019.2 version of XRT and install it with the following command. $ sudo yum install /xrt_.rpm 3. Restore the card to the original manufacturing state. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 4. Cold reboot the system. 5. To confirm that the platform running on the FPGA is either GOLDEN_2 or GOLDEN_5, review the output from the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan For example, you might see xilinx_u250_GOLDEN_2. 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. IMPORTANT! Si l'image GOLDEN_2 est en cours d'exécution sur le FPGA, consultez attentivement l'avis de conception relatif à la corruption dorée de la carte accélératrice de centre de données Alveo, disponible dans l'enregistrement de réponse Xilinx AR-71915. Suivez les instructions de réparation associées à Xilinx Answer avant de poursuivre. WICHTIG! Wenn das GOLDEN_2-Image auf dem FPGA ausgeführt wird, lesen Sie die Designempfehlung zur Goldenen Beschädigung der Alveo Data Center-Beschleunigerkarte unter Xilinx Answer Record AR-71915. Führen Sie die mit der Xilinx Answer verbundenen Reparaturanweisungen aus, bevor Sie fortfahren.. 6. Download the desired deployment platform installation package and install it. $ sudo yum install /xilinx--.rpm Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 39 Send Feedback

installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. $ 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. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 11. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Downgrade from 2019.1 to 2018.x in RedHat and CentOS Note: For links to the available shell and XRT revisions, see Chapter 4: Installing the Deployment Software. To downgrade from the 2019.1 to the 2018.3 or 2018.2 release, perform the following steps. 1. Restore the card to the original manufacturing state by running the following command from XRT 2019.1. $ sudo /opt/xilinx/xrt/bin/xbutil flash -r 2. Remove the current XRT and shell versions. $ sudo yum remove xrt 3. Cold reboot the system. 4. Follow the installation procedures outlined in Chapter 4: Installing the Deployment Software. Downgrade from 2019.2 to 2018.x in RedHat and CentOS Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 40 Send Feedback

1. Restore the card to the original manufacturing state by running the following command from XRT 2019.2. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 2. Remove the current XRT and platform versions. $ sudo yum remove xrt 3. Cold reboot the system. 4. Follow the installation procedures outlined in Chapter 4: Installing the Deployment Software. Uninstalling Packages in RedHat and CentOS To completely uninstall the Alveo XRT and deployment platform packages, run the following command in a Linux terminal. Uninstalling XRT also uninstalls the deployment platform. $ sudo yum remove Note: Make sure that all of the platform packages are displayed in the output terminal after running the command. 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. Ubuntu During upgrading, downgrading, or uninstalling, it can be useful to list the currently installed 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 Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. To upgrade from the 2018.2 to the 2018.3 release, perform the following steps. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 41 Send Feedback

$ sudo apt remove xrt 2. Download the XRT associated with the 2018.3 platform version and install it with the following command: $ sudo apt install /xrt_.deb 3. Download the desired deployment platform installation package and install it with the following command: $ sudo apt install /xilinx--.deb 4. Run the following command and confirm that the value in Flashable partitions installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash -a all 6. To load the new firmware image on the FPGA, cold boot the machine. 7. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 8. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Downgrade from 2018.3 to 2018.2 in Ubuntu Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. To downgrade from the 2018.3 to the 2018.2 release, perform the following steps. 1. Remove the current XRT and platform versions. $ sudo apt remove xrt 2. Download the 2018.2 version of XRT and install it with the following command: $ sudo apt install /xrt_.deb Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 42 Send Feedback

following command: $ sudo apt install /xilinx--.deb 4. Run the following command and confirm that the value in Flashable partitions installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. To load the new firmware image on the FPGA, cold boot the machine. 7. Run the following command to confirm that the output under the Flashable partition running on FPGA and Flashable partitions installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 8. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Upgrade from 2018.x to 2019.1 in Ubuntu Note: For links to the available shell and XRT revisions, see Chapter 4: Installing the Deployment Software. To upgrade from either the 2018.2 or 2018.3 release to the 2019.1 release, perform the following steps. 1. Remove the current XRT and shell versions. $ sudo apt remove xrt 2. Download the 2019.1 version of XRT and install it with the following command. $ sudo apt install /xrt_.deb 3. Restore the card to the original manufacturing state. $ sudo /opt/xilinx/xrt/bin/xbutil flash -r 4. Cold reboot the system. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 43 Send Feedback

output from the following command. $ sudo /opt/xilinx/xrt/bin/xbutil flash scan For example, you might see xilinx_u250_GOLDEN_2. 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. IMPORTANT! Si l'image GOLDEN_2 est en cours d'exécution sur le FPGA, consultez attentivement l'avis de conception relatif à la corruption dorée de la carte accélératrice de centre de données Alveo, disponible dans l'enregistrement de réponse Xilinx AR-71915. Suivez les instructions de réparation associées à Xilinx Answer avant de poursuivre. WICHTIG! Wenn das GOLDEN_2-Image auf dem FPGA ausgeführt wird, lesen Sie die Designempfehlung zur Goldenen Beschädigung der Alveo Data Center-Beschleunigerkarte unter Xilinx Answer Record AR-71915. Führen Sie die mit der Xilinx Answer verbundenen Reparaturanweisungen aus, bevor Sie fortfahren.. 6. Download the desired deployment shell installation package and install it. $ sudo apt install /xilinx--.deb 7. Run the following command and confirm that the value in Shell package installed in system field matches what was just installed, and that the SC field for Shell running on FPGA is not blank. See Running xbmgmt flash --scan for an explanation of the output. $ 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. $ sudo /opt/xilinx/xrt/bin/xbutil flash -a all 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 Shell running on FPGA and Shell package installed in system fields match. $ sudo /opt/xilinx/xrt/bin/xbutil flash scan 11. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Upgrade from 2018.x to 2019.2 in Ubuntu Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 44 Send Feedback

following steps. 1. Remove the current XRT and platform versions. $ sudo apt remove xrt 2. Download the 2019.2 version of XRT and install it with the following command. $ sudo apt install /xrt_.deb 3. Restore the card to the original manufacturing state. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 4. Cold reboot the system. 5. To confirm that the platform running on the FPGA is either GOLDEN_2 or GOLDEN_5, review the output from the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan For example, you might see xilinx_u250_GOLDEN_2. 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. IMPORTANT! Si l'image GOLDEN_2 est en cours d'exécution sur le FPGA, consultez attentivement l'avis de conception relatif à la corruption dorée de la carte accélératrice de centre de données Alveo, disponible dans l'enregistrement de réponse Xilinx AR-71915. Suivez les instructions de réparation associées à Xilinx Answer avant de poursuivre. WICHTIG! Wenn das GOLDEN_2-Image auf dem FPGA ausgeführt wird, lesen Sie die Designempfehlung zur Goldenen Beschädigung der Alveo Data Center-Beschleunigerkarte unter Xilinx Answer Record AR-71915. Führen Sie die mit der Xilinx Answer verbundenen Reparaturanweisungen aus, bevor Sie fortfahren.. 6. Download the desired deployment platform installation package and install it. $ sudo apt install /xilinx--.deb 7. Run the following command and confirm that the value in Flashable partitions installed in system field matches what was just installed, and that the SC field for Flashable partition running on FPGA is not blank. See Running xbmgmt flash -- scan for an explanation of the output. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 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. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 45 Send Feedback

$ 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. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan 11. Validate the card as described in Chapter 5: Card Bring-Up and Validation. Downgrade from 2019.1 to 2018.x in Ubuntu Note: For links to the available shell and XRT revisions, see Chapter 4: Installing the Deployment Software. To downgrade from the 2019.1 to the 2018.3 or 2018.2 release, perform the following steps. 1. Restore the card to the original manufacturing state by running the following command from XRT 2019.1. $ sudo /opt/xilinx/xrt/bin/xbutil flash -r 2. Remove the current XRT and shell versions. $ sudo apt remove xrt 3. Cold reboot the system. 4. Follow the installation procedures outlined in Chapter 4: Installing the Deployment Software. Downgrade from 2019.2 to 2018.x in Ubuntu Note: For links to the available platform and XRT revisions, see Chapter 4: Installing the Deployment Software. To downgrade from the 2019.2 to the 2018.3 or 2018.2 release, perform the following steps. 1. Restore the card to the original manufacturing state by running the following command from XRT 2019.2. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --factory_reset 2. Remove the current XRT and platform versions. $ sudo apt remove xrt 3. Cold reboot the system. 4. Follow the installation procedures outlined in Chapter 4: Installing the Deployment Software. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 46 Send Feedback

To completely uninstall the Alveo XRT and deployment platform packages, run the following command in a Linux terminal. Uninstalling XRT also uninstalls the deployment platform. $ sudo apt remove Note: Make sure that all of the platform packages are displayed in the output terminal after running the command. 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. Appendix A: Changing XRT and Target Platform Versions UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 47 Send Feedback

CentOS On CentOS, yum install kernel-headers always installs the latest version of the headers, but might not match your kernel version. This causes the installation of XRT to skip compilation of the driver modules and will silently fail. To correctly install XRT, you must create a vault repository file that points to versions matching the kernel. The following is an example repository for CentOS 7.4 created in the following file: /etc/yum.repos.d/centos74.repo # CentOS-Base-7.4.repo # # This repo is locked to 7.4.1708 version # # C7.4.1708 [C7.4.1708-base] name=CentOS-7.4.1708 - Base baseurl=http://vault.centos.org/7.4.1708/os/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-updates] name=CentOS-7.4.1708 - Updates baseurl=http://vault.centos.org/7.4.1708/updates/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-extras] name=CentOS-7.4.1708 - Extras baseurl=http://vault.centos.org/7.4.1708/extras/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-centosplus] name=CentOS-7.4.1708 - CentOSPlus baseurl=http://vault.centos.org/7.4.1708/centosplus/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 [C7.4.1708-fasttrack] name=CentOS-7.4.1708 - CentOSPlus baseurl=http://vault.centos.org/7.4.1708/fasttrack/$basearch/ gpgcheck=1 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7 enabled=1 Appendix B: Creating a Vault Repository for CentOS UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 48 Send Feedback

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". Appendix B: Creating a Vault Repository for CentOS UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 49 Send Feedback

Image The Alveo™ card can be reverted to factory (Golden) image. This requires that XRT 2019.2 release or later is installed on the same system as the Alveo accelerator card. The steps to revert the card using this method are listed below. Note: If using XRT 2019.1, follow the steps given in v2019.1 of Getting Started with Alveo Data Center Accelerator Cards (UG1301). 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. Cold-reboot by power cycling the system to complete the reverting process. 5. Validate that the card has been reverted to factory image by running the following command. $ sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan An output similar to the following is displayed. Card [0000:65:00.0] Card type: uxx Flash type: SPI Flashable partition running on FPGA: xilinx_uxx_GOLDEN_x,[SC=x.x] Flashable partitions installed in system: (None) In the output above, under Flashable partition running on FPGA, note GOLDEN in the name. This indicates that the card has successfully been reverted to factory image. Appendix C: Reverting the Card to Factory Image UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 50 Send Feedback

update Command 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 --card To obtain the necessary card_bdf and shell_name options, run the following xbmgmt flash --scan command. For more information, see Running xbmgmt flash --scan. sudo /opt/xilinx/xrt/bin/xbmgmt flash --scan You will see an output similar to the output below. In this example, the Flashable partition running on FPGA does not match Flashable partitions installed in system, implying that the Flashable partition running on FPGA needs to be updated using the xbmgmt flash --update command. Card [0000:65:00.0] Card type: u200 Flash type: SPI Flashable partition running on FPGA: xilinx_u200_xdma_201830_1,[ID=0x000000005bece8e1],[SC=3.1] Flashable partitions installed in system: xilinx_u200_xdma_201830_2,[ID=0x000000005d1211e8],[SC=4.2.0] • card_bdf: Specifies the BDF of the card to flash. In the above example, the BDF is 0000:65:00.0. This option is only required if you have multiple cards installed on the server. • shell_name: Specifies the platform (formerly referred to as shell) that is used to flash the card. The shell_name for flashing is provided under Flashable partitions installed in system. In the above example, the shell_name is xilinx_u200_xdma_201830_2. For the example output above, the xbmgmt flash command is: sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell xilinx_u200_xdma_201830_2 --card 0000:65:00.0 Appendix D: Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 51 Send Feedback

output will show the same package information for both Flashable partition running on FPGA and Flashable partitions installed in system. If you have multiple cards installed on the server, you must run the xbmgmt flash command separately for each card. IMPORTANT! Use a separate xbmgmt flash  command to flash each card in the system. 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. Appendix D: Generating the xbmgmt flash --update Command UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 52 Send Feedback

Notices Xilinx Resources For support resources such as Answers, Documentation, Downloads, and Forums, see Xilinx Support. Documentation Navigator and Design Hubs Xilinx® Documentation Navigator (DocNav) provides access to Xilinx documents, videos, and support resources, which you can filter and search to find information. To open DocNav: • From the Vivado® IDE, select Help → Documentation and Tutorials. • 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: • In DocNav, click the Design Hubs View tab. • On the Xilinx website, see the Design Hubs page. Note: For more information on DocNav, see the Documentation Navigator page on the Xilinx website. Appendix E: Additional Resources and Legal Notices UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 53 Send Feedback

1. Vitis Unified Software Platform Documentation: Application Acceleration Development (UG1393) 2. Vitis Unified Software Platform Documentation (UG1416) 3. Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400) 4. Vitis 2020.1 Software Platform Release Notes in the Vitis Unified Software Platform Documentation (UG1416) 5. Vitis Application Acceleration Development Flow Tutorials (GitHub) Alveo Documents 1. Alveo U200 and U250 Data Center Accelerator Cards Data Sheet (DS962) 2. Alveo Data Center Accelerator Card Platforms User Guide (UG1120) 3. Alveo U280 Data Center Accelerator Cards Data Sheet (DS963) Additional Xilinx Resources 1. Xilinx licensing website: https://www.xilinx.com/getproduct 2. Vitis Developer Zone: https://www.xilinx.com/products/design-tools/vitis/vitis-platform.html 3. Xilinx Community Forums: https://forums.xilinx.com 4. Xilinx Third-Party End User License Agreement 5. End-User License Agreement Please Read: Important Legal Notices 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 CONDITIONS, EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, OR FITNESS FOR ANY PARTICULAR PURPOSE; and (2) Xilinx shall not be liable (whether in contract or tort, including negligence, or under any other theory of liability) for any loss or damage of any kind or nature related to, arising under, or in connection with, the Materials (including your use of the Appendix E: Additional Resources and Legal Notices UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 54 Send Feedback

(including loss of data, profits, goodwill, or any type of loss or damage suffered as a result of any action brought by a third party) even if such damage or loss was reasonably foreseeable or Xilinx had been advised of the possibility of the same. Xilinx assumes no obligation to correct any errors contained in the Materials or to notify you of updates to the Materials or to product specifications. You may not reproduce, modify, distribute, or publicly display the Materials without prior written consent. Certain products are subject to the terms and conditions of Xilinx's limited warranty, please refer to Xilinx's Terms of Sale which can be viewed at https:// www.xilinx.com/legal.htm#tos; 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 use of Xilinx products in such critical applications, please refer to Xilinx's Terms of Sale which can be viewed at https://www.xilinx.com/legal.htm#tos. AUTOMOTIVE APPLICATIONS DISCLAIMER AUTOMOTIVE PRODUCTS (IDENTIFIED AS "XA" IN THE PART NUMBER) ARE NOT WARRANTED FOR USE IN THE DEPLOYMENT OF AIRBAGS OR FOR USE IN APPLICATIONS THAT AFFECT CONTROL OF A VEHICLE ("SAFETY APPLICATION") UNLESS THERE IS A SAFETY CONCEPT OR REDUNDANCY FEATURE CONSISTENT WITH THE ISO 26262 AUTOMOTIVE SAFETY STANDARD ("SAFETY DESIGN"). CUSTOMER SHALL, PRIOR TO USING OR DISTRIBUTING ANY SYSTEMS THAT INCORPORATE PRODUCTS, THOROUGHLY TEST SUCH SYSTEMS FOR SAFETY PURPOSES. USE OF PRODUCTS IN A SAFETY APPLICATION WITHOUT A SAFETY DESIGN IS FULLY AT THE RISK OF CUSTOMER, SUBJECT ONLY TO APPLICABLE LAWS AND REGULATIONS GOVERNING LIMITATIONS ON PRODUCT LIABILITY. Copyright © Copyright 2018-2020 Xilinx, Inc. Xilinx, the Xilinx logo, Alveo, Artix, Kintex, Spartan, Versal, Virtex, Vivado, Zynq, and other designated brands included herein are trademarks of Xilinx in the United States and other countries. OpenCL and the OpenCL logo are trademarks of Apple Inc. used by permission by Khronos. PCI, PCIe, and PCI Express are trademarks of PCI-SIG and used under license. AMBA, AMBA Designer, Arm, ARM1176JZ-S, CoreSight, Cortex, PrimeCell, Mali, and MPCore are trademarks of Arm Limited in the EU and other countries. All other trademarks are the property of their respective owners. Appendix E: Additional Resources and Legal Notices UG1301 (v1.5) June 3, 2020 www.xilinx.com Getting Started with Alveo Accelerator Cards 55 Send Feedback