Xilinx Alveo U50 User manual

Alveo U50 Data Center
Accelerator Card Installaon
Guide
UG1370 (v1.8) October 28, 2021
Xilinx is creating an environment where employees, customers, and
partners feel welcome and included. To that end, we’re removing non-
inclusive language from our products and related collateral. We’ve
launched an internal initiative to remove language that could exclude
people or reinforce historical biases, including terms embedded in our
software and IPs. You may still find examples of non-inclusive
language in our older products as we work to make these changes and
align with evolving industry standards. Follow this link for more
information.

Revision History
The following table shows the revision history for this document.
Section Revision Summary
10/28/2021 Version 1.8
General Updates Removed U50DD related information.
Card Features Updated format and information.
XRT and Deployment Platform Installation Procedures on
RedHat and CentOS
Updated installation steps for 2021.1 update.
XRT and Deployment Platform Installation Procedures on
Ubuntu
Updated installation steps for 2021.1 update.
Chapter 7: Troubleshooting Updated to direct users to more detailed troubleshooting
and known issues content located in the Alveo Card Debug
Guide and AR71752.
12/09/2020 Version 1.7
Chapter 1: Introduction Updated description for latest tools version.
Minimum System Requirements Updated supported operating system.
XRT and Deployment Platform Installation Procedures on
RedHat and CentOS
Updated installation procedure.
XRT and Deployment Platform Installation Procedures on
Ubuntu
Updated installation procedure.
xbutil validate Removed note about XRT installation on Ubuntu.
Known Issues Updated to remove a known issue about XRT installation.
Generating the xbmgmt flash --update Command Updated output log.
Appendix A: Regulatory and Compliance Information Added appendix.
06/04/2020 Version 1.6
Chapter 1: Introduction Updated the information.
Card Features Added new section.
Card Interfaces and Details Added a caution.
Known Issues •Added a known issue about installing the U50 card
deployment package.
•Added a known issue about downgrading to a beta
platform.
Downgrading Packages Added information about downgrading to a beta platform.
02/27/2020 Version 1.5
XRT and Deployment Platform Installation Procedures on
RedHat and CentOS
Replaced steps 4, 6, 7, 8, and 9 to document the new
installation steps for U50. Replaced all mentions of zip files
with tar.gz.
XRT and Deployment Platform Installation Procedures on
Ubuntu
Replaced steps 1, 2, 3, and the log file of step 6 to document
the new installation steps for U50. Replaced all mentions of
zip files with tar.gz.
Running lspci Revised log file in step 2.
Running xbmgmt flash --scan Revised output, platform, and ID information in step 1.
Revision History
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 2
Send Feedback

Section Revision Summary
Upgrading Packages Updated step 1 to include a link to chapter 4; removed steps
2-6.
01/07/2020 Version 1.4
Installing the Card Updated to add notes about UL Listed Servers and card
handling.
12/18/2019 Version 1.3
General Updated output logs.
Qualified Servers Updated the section and provided the web link to the
qualified servers information.
XRT and Deployment Platform Installation Procedures on
Ubuntu
Added a note about XRT installation.
10/31/2019 Version 1.2
General Updated to the Vitis™ unified software platform throughout.
Updated outputs throughout the document.
Chapter 4: Installing the Deployment Software Replaced xbutil command with the new xbmgmt
command for card flashing. Updated output logs.
Running xbmgmt flash --scan Replaced xbutil command with the new xbmgmt
command when scanning card. Updated output logs.
Known Issues Added a link to Xilinx Answer Record 72766.
Added a known issue.
Changing XRT and Target Platform Versions Replaced xbutil command with the new xbmgmt
command for card flashing. Updated output logs.
09/18/2019 Version 1.1
General updates Updated sample outputs.
Card Interfaces and Details Added card interface related information and updated
images.
Known Issues Included a link to Xilinx Answer Record 71752.
Added information about power.
08/05/2019 Version 1.0
Initial release N/A
Revision History
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 3
Send Feedback

Table of Contents
Revision History...............................................................................................................2
Chapter 1: Introduction.............................................................................................. 6
Chapter 2: Accelerator Card Overview............................................................... 7
Card Features...............................................................................................................................7
Minimum System Requirements...............................................................................................8
Qualified Servers......................................................................................................................... 8
Card Interfaces and Details........................................................................................................8
Chapter 3: Card Installation Procedures......................................................... 10
Safety Instructions.................................................................................................................... 10
Before You Begin.......................................................................................................................12
Installing the Card.....................................................................................................................13
Chapter 4: Installing the Deployment Software......................................... 15
XRT and Deployment Platform Installation Procedures on RedHat and CentOS............. 16
XRT and Deployment Platform Installation Procedures on Ubuntu...................................18
Chapter 5: Card Bring-Up and Validation........................................................21
Environment Setup................................................................................................................... 21
Running lspci............................................................................................................................. 22
Confirm Firmware Installation ................................................................................................22
Card Validation.......................................................................................................................... 23
Chapter 6: Next Steps.................................................................................................25
Chapter 7: Troubleshooting.................................................................................... 26
Appendix A: Regulatory and Compliance Information...........................27
Safety Compliance.....................................................................................................................27
EMC Compliance........................................................................................................................27
CE Directives.............................................................................................................................. 28
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 4
Send Feedback

CE Standards..............................................................................................................................28
Other Compliance Statements................................................................................................ 29
Compliance Markings............................................................................................................... 32
Appendix B: Additional Resources and Legal Notices............................. 34
Xilinx Resources.........................................................................................................................34
Documentation Navigator and Design Hubs.........................................................................34
References..................................................................................................................................35
Please Read: Important Legal Notices................................................................................... 36
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 5
Send Feedback

Chapter 1
Introduction
This document provides hardware and soware installaon procedures for the half-height, half-
length Xilinx® Alveo™ U50 data center accelerator card and applies to XRT 2021.1 and later. For
installaon procedures using previous XRT versions, see v1.7 of Alveo U50 Data Center
Accelerator Card Installaon Guide (UG1370).
If you encounter any issues during installaon, see Chapter 7: Troubleshoong. For Alveo Data
Center accelerator card known issues and general informaon, see AR71752.
Dierent system conguraons are available for running, developing, and debugging applicaons
on your Alveo accelerator cards:
•Running Applicaons: To congure a system to run accelerated applicaons, install an Alveo
card into a system as described in Chapter 3: Card Installaon Procedures along with the
required deployment soware to support running applicaons as described in Chapter 4:
Installing the Deployment Soware.
•Developing Applicaons: To develop FPGA accelerated applicaons, it is necessary to install
both the deployment soware and the development soware. Development soware
installaon, described in Chapter 6: Next Steps, consists of installing both a development
target plaorm and the Vis™ environment. This conguraon does not have an Alveo card
installed and is used for development along with debugging in emulaon modes.
•Running, Developing, and Debugging Applicaons: By installing the Alveo card along with
both the deployment and development soware on a single machine, you can congure a
system for developing and running accelerated applicaons. With the card installed,
developers can debug applicaons in both emulaon modes and on the hardware.
Chapter 1: Introduction
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 6
Send Feedback

Chapter 2
Accelerator Card Overview
Card Features
The Alveo U50 data center accelerator card is PCIe® Gen3 x16 compliant and Gen4 x8
compable featuring the Xilinx 16 nm UltraScale+™ technology. It features 8 GB HBM to provide
high-performance, adaptable acceleraon for memory-bound, compute-intensive applicaons
including database, analycs, and machine learning inference.
The Alveo U50 accelerator card features are as follows.
Table 1: Alveo U50 Features
Card Component Alveo U50
FPGA UltraScale+™ XCU50 FPGA
HBM 8 GB - two 4 gigabyte (GB) HBM memory stacks
Split into 32 256 MB channels
Network Interface 1x QSFP28
Supporting 100 GbE, 40 GbE, or 4x10/25 GbE
PCIe 16-lane PCI Express
PCIe Integrated Endpoint block connectivity
Gen1, 2, or 3 up to x16, Gen4 x8
Single or dual Gen4 x8
I2C Bus ✓
Status LEDs ✓
Power Management Power management with system management bus (SMBus)
voltage, current, and temperature monitoring
Electrical Design Power 75W PCIe slot functional with PCIe slot power only
Configuration Options 1 gigabit (Gb) Quad Serial Peripheral Interface (SPI) flash
memory
UltraScale+ device configurable over USB/JTAG and Quad
SPI configuration flash memory
UART UART access through the maintenance connector
Chapter 2: Accelerator Card Overview
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 7
Send Feedback

Note: The Alveo U50 card has separate power rails for FPGA fabric and HBM memory. Developers must
ensure their designs do not draw too much power for each rail. The HBM rail is a 10W rail, and may limit
HBM performance (see AR75222). For details on how to monitor power and temperature, see Monitor
Card Power and Temperature.
Minimum System Requirements
The minimum system requirements for running the Alveo™ U50 Data Center accelerator cards
are listed in the following table.
Table 2: Minimum System Requirements
Component Requirement
Motherboard PCI Express® 3.0-compliant with one x16 slot.
System Power Supply 75W via PCI Express slot connection.
Operating System For the latest OS support see the Xilinx Runtime (XRT) Release Notes.
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 system 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 details on the acceptable environmental condions, see Alveo U50 Data Center Accelerator
Cards Data Sheet (DS965).
Qualified Servers
The Xilinx Qualied Servers Catalog provides a list of servers that Alveo cards are fully qualied.
Card Interfaces and Details
The Alveo™ U50 accelerator card is available in a passive cooling conguraon and is designed
for installaon into a data center server where controlled air ow provides direct cooling to the
card. The card includes the following interfaces.
Chapter 2: Accelerator Card Overview
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 8
Send Feedback

• A PCI Express® card connector
• One QSFP28 connector supporng 100 GbE, 40 GbE, or 4x10/25 GbE
• Maintenance Connector
Used to program the card in RTL ow through the programming cable. For more informaon
see the Alveo Programming Cable User Guide (UG1377).
Figure 1: Alveo U50 PQ Card with Half-Height Bracket
CAUTION! Alveo accelerator cards are designed to be installed into a data center server, where controlled
air ow provides direct cooling. If the cooling enclosure is removed from the card and the card is powered-
up, external fan cooling airow MUST be applied to prevent over-temperature shut-down and possible
damage to the card electronics. Removing the cooling enclosure voids the board warranty.
For card specicaons, dimensions, list of card features, and block diagram, see Alveo U50 Data
Center Accelerator Cards Data Sheet (DS965).
Chapter 2: Accelerator Card Overview
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 9
Send Feedback

Chapter 3
Card Installation Procedures
To reduce the risk of re, electric shock, or injury, always follow basic safety precauons.
CAUTION! You must always use an ESD strap or other anstac device when handling hardware.
ATTENTION! Il est fortement recommandé d'uliser un bracelet ESD ou autres disposifs anstaques.
VORSICHT! Beim Umgang mit Hardware müssen sie immer ein Erdungs Armband oder ein anderes
anstasches 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'alimentaon.
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 Önen der Computer / Systemabdeckung das Netzkabel ab.
Chapter 3: Card Installation Procedures
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 10
Send Feedback

Electrostatic Discharge Caution
Electrostac discharge (ESD) can damage electronic components when they are improperly
handled, and can result in total or intermient failures. Always follow ESD-prevenon 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 anstac surface such as the bag supplied in your kit.
• If you are returning the card to Xilinx Product Support, place it back in its anstac 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 intermientes. Suivez toujours les procédures de prévenon
contre les ESD lors du retrait et remplacement des composants.
Pour prévenir les dommages dus aux ESD:
•Ulisez une sangle de poignet ou de cheville an-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 mere 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 anstaque telle
que le sac an-staque fourni avec la carte.
• Si vous retournez la carte a Xilinx, remeez-la dans son sac anstaque immédiatement.
Vorsicht Elektrostatische Entladung
Elektrostasche 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 Enernen und Austauschen von Komponenten stets die ESD-
Schutzmaßnahmen.
Chapter 3: Card Installation Procedures
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 11
Send Feedback

So verhindern sie ESD-Schäden:
• 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 Metalloberä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
Leiterplae oder die Anschlüsse.
• Legen sie die Karte nur auf einer anstaschen Oberäche ab, z.B. dem anstaschen Beutel
der mit dem Kit mitgeliefert wurde.
• Wenn sie die Karte an den Xilinx Product Support zurücksenden, legen Sie sie bie sofort
wieder in den anstaschen Beutel.
Before You Begin
IMPORTANT! Alveo™ cards are delicate and sensive electronic devices; equipment is to be installed by a
qualied technician only. This equipment is intended for installaon in a Restricted Access Locaon.
IMPORTANT! Les cartes Alveo™ sont des appareils électronique sensibles et fragiles; l'équipement doit
être installé par un technicien ceré seulement. Cet équipement est desné à être installé dans un lieu
d'accès restreint.
WICHTIG! Die Karten Alveo™ sind sensible und empndliche elektronische Geräte. Das Gerät darf nur
von einem qualizierten Techniker installiert werden. Dieses Gerät ist für die Installaon an einem Ort mit
begrenztem Zugang vorgesehen.
• Verify that the minimum card space is available to install your card. Card specicaons and
dimensions can be found in Alveo U50 Data Center Accelerator Cards Data Sheet (DS965).
• Determine if a half or full height bracket is necessary for the installaon. If the bracket needs
to be changed, do this before following the installaon steps.
• Check for card compability with the system. Also check for proper system requirements such
as power, bus type, and physical dimensions to support the card.
Related Information
Minimum System Requirements
Qualied Servers
Replacing the Bracket
Chapter 3: Card Installation Procedures
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 12
Send Feedback

Replacing the Bracket
The Alveo U50 card can be used with either a full-height or half-height bracket. Depending on
your system, it may be necessary to switch between the full and half-height bracket on the card.
The bracket is secured to the card with four screws, as shown in the gure below. To replace the
bracket, follow the instrucons below.
1. Remove screws 1 and 2 from the card.
2. Remove screws 3 and 4 from the card.
3. Remove the bracket from the card.
4. Place the new bracket on the card and align it with the card's connectors and screw locaons.
5. Replace screws 1 and 2 on the new bracket.
6. Replace screws 3 and 4 on the new bracket.
Figure 2: Screw Locations on Bracket
1 2 3 4 X25852-101221
Installing the Card
The following procedure is a guide for the Xilinx® Alveo™ U50 Data Center accelerator card
installaon. Consult your computer documentaon for addional informaon.
Chapter 3: Card Installation Procedures
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 13
Send Feedback

Note: For use with UL Listed Servers or ITE.
If you encounter any issues during installaon, see Chapter 7: Troubleshoong.
1. Shut down the host computer and unplug the power cord.
2. Open your computer by removing the casing.
3. If necessary, remove the adjacent PCIe® slot cover corresponding to the PCIe slot in which
you are installing the Alveo card.
4. Plug the Alveo card into the PCIe x16 slot on the motherboard.
5. Re-install the computer casing.
6. Connect the power cord and turn on the computer.
WARNING! Do not power-on a passively cooled card without adequate forced airow across the card
with proper air ow direcon, otherwise the card can be damaged. This card can heat up aer use in
the server. Use cauon when handling. For more informaon, see Alveo U50 Data Center Accelerator
Cards Data Sheet (DS965).
7. To verify that the device has been installed correctly, enter the following Linux command in
the terminal:
$ sudo lspci -vd 10ee:
If the card is successfully installed and found by the operang system, a message similar to
the one below will be displayed.
This is a sample output for an installed Alveo U50 card:
65:00.0 Processing accelerators: Xilinx Corporation Device D020
Subsystem: Xilinx Corporation Device 000e
Flags: bus master, fast devsel, latency 0, IRQ 135
Memory at 38bffc000000 (64-bit, prefetchable) [size=32M]
Memory at 38bffe000000 (64-bit, prefetchable) [size=128K]
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: [1f0] Virtual Channel
Capabilities: [e00] 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 similar message, see Chapter 7: Troubleshoong.
Chapter 3: Card Installation Procedures
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 14
Send Feedback

Chapter 4
Installing the Deployment Software
This chapter details the procedures for installing deployment soware on RedHat/CentOS and
Ubuntu operang systems. All soware installaons use standard Linux RPM and Linux DEB
packages and require root access.
The deployment soware consists of the following soware packages:
•Xilinx® runme (XRT): XRT provides the libraries and drivers for an applicaon to run on
Alveo™ cards and also includes xbul and xbmgmt ulies. Ulity command line help can
always be obtained using the --help opon.
•Deployment plaorm: The deployment plaorm provides the base rmware needed to run
pre-compiled applicaons. It cannot be used to compile or create new applicaons. To create
new applicaons, install the development soware detailed in Chapter 6: Next Steps. While
you can also install the development soware on a machine with an installed card, doing so is
not necessary to run applicaons.
All installaon packages can be downloaded from the Geng Started tab of the respecve Alveo
card landing page:
•Alveo U50 Product Page
If you encounter any issues during installaon, see Chapter 7: Troubleshoong. For known issues
and general informaon, see AR71752.
IMPORTANT! Root access is required for all soware and rmware installaons.
IMPORTANT! L'accès Root est requis pour toutes les installaons logicielles et rmware.
WICHTIG! Root-Zugri ist für alle Soware- und Firmware-Installaonen erforderlich.
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 15
Send Feedback

XRT and Deployment Platform Installation
Procedures on RedHat and CentOS
Use the following steps to download and install the XRT and deployment plaorm using a .rpm
installaon package.
For details on upgrading or downgrading the XRT and deployment plaorm, see Changing XRT
and Target Plaorm Versions .
1. XRT installaon requires Extra Packages for Enterprise Linux (EPEL) and a related repository.
If not already installed, install EPEL on your system by following the steps provided in XRT
Installaon.
2. Run the following commands to install kernel headers and kernel development packages.
Ensure that uname is surrounded by backcks ( `) and not single quotes (').
$ sudo yum install kernel-headers-`uname -r`
$ sudo yum install kernel-devel-`uname -r`
3. Aer the previous command completes, warm boot your machine.
4. From the Geng Started tab of the Alveo U50 Product page, use the selecon tool to display
and download the Xilinx® runme (XRT) and deployment target plaorm installaon
packages.
Download the packages by clicking on the displayed package names.
5. Install the XRT installaon package by running the following command from within the
directory where the installaon packages reside. <version> is the laer part of the
installaon package le name.
$ sudo yum install ./xrt_<version>.rpm
This will install the XRT and its necessary dependencies. Follow the instrucons when
prompted throughout the installaon.
6. Unpack the deployment target plaorm tar.gz le into a single directory. The locaon of
the directory is not important, however the directory should not contain any other les.
7. Install the deployment packages. From within the directory where the installaon packages
were unpacked, run the following command. This will install all deployment packages.
sudo yum install ./*.rpm
8. Flash the plaorm rmware on the card. Aer installing the deployment packages in the
previous step, the following message is displayed:
Partition package installed successfully.
Please flash card manually by running below command:
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <shell_name>
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 16
Send Feedback

With XRT 2021.1 or greater, it is necessary to use the following new command to ash the
card rather than the one displayed in the above message. It assumes only one deployment
plaorm is installed on the card. If more than one plaorm is installed the --image opon
needs to be added. See xbmgmt documentaon for details.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where management BDF is the card to be programmed. See Displaying Card BDF Values to
obtain the device management BDF.
Flashing can take several minutes.
IMPORTANT! Do not enter Ctrl + c in the terminal while the rmware is ashing 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 inulisable.
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 funkoniert.
IMPORTANT! If you have mulple cards installed in the system, you must run the above xbmgmt
program command separately for each card.
A message similar to the following will be displayed aer successfully ashing the card:
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
If the card has been ashed with the current plaorm rmware, you will see a message
similar to the following.
Device(s) up-to-date and do not need to be flashed.
9. Cold boot the machine to load the new rmware image on the FPGA.
IMPORTANT! Be sure to fully power o the machine and then power it on again. The image will not
boot from ash if the machine is only rebooted.
IMPORTANT! Assurez-vous d'éteindre complètement la machine, puis de la rallumer. L'image ash 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.
10. Update the SC rmware on the card. Run the following command to update the SC rmware
on the card. It is the idencal command used to ash the plaorm rmware on the card.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 17
Send Feedback

Where management BDF is the card requiring SC rmware update. See Displaying Card BDF
Values to obtain the device management BDF.
Updang the SC rmware can take several minutes.
IMPORTANT! If you have mulple cards installed in the system, you must run the above xbmgmt
program command separately for each card.
A message similar to the following will be displayed aer a successful SC rmware update,
where the device management BDF is given in square brackets.
Report
[0000:af:00.0] : Successfully flashed
1 device(s) flashed successfully.
******************************************************************
Warm reboot is required to recognize new SC image on the device.
******************************************************************
If the card already has the current rmware, a message similar to the following is displayed
and no addional installaon steps are necessary.
Device(s) up-to-date and do not need to be flashed.
11. Warm boot the system for XRT to recognize the new SC image.
The installaon for deployment is now complete. Chapter 5: Card Bring-Up and Validaon
provides steps to validate the card has been installed successfully.
XRT and Deployment Platform Installation
Procedures on Ubuntu
Use the following steps to download and install the XRT and deployment plaorm using a .deb
installaon package.
For details on upgrading or downgrading the XRT and deployment plaorm, see Changing XRT
and Target Plaorm Versions.
1. From the Geng Started tab of the Alveo U50 Product Page, use the selecon tool to display
the desired Xilinx runme (XRT) and deployment target installaon package.
Download the packages by clicking on the displayed package names.
2. Install the XRT installaon package by running the following command from within the
directory where the installaon packages reside. <version> is the laer part of the
installaon package le name.
$ sudo apt install ./xrt_<version>.deb
This will install the XRT along with any necessary dependencies. Follow the instrucons
when prompted throughout the installaon.
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 18
Send Feedback

3. Unpack the tar.gz le into a single directory. The locaon of the directory is not important,
however the directory should not contain any other les.
4. Install the deployment packages. From within the directory where the installaon packages
were unpacked, run the following command. This will install all deployment packages.
sudo apt install ./*.deb
5. Flash the plaorm rmware on the card. Aer installing the deployment packages in the
previous step, the following message is displayed:
Partition package installed successfully.
Please flash card manually by running below command:
$ sudo /opt/xilinx/xrt/bin/xbmgmt flash --update --shell <shell_name>
With XRT 2021.1 or greater, it is necessary to use the new command below to ash the card
rather than the one displayed in the above message. It assumes only one deployment
plaorm is installed on the card. If more than one plaorm is installed the --image opon
needs to be added. See xbmgmt documentaon for details.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where management BDF is the card to be programmed. See Displaying Card BDF Values to
obtain the device management BDF.
Flashing can take several minutes.
IMPORTANT! Do not enter Ctrl + c in the terminal while the rmware is ashing 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 inulisable.
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 funkoniert.
IMPORTANT! If you have mulple cards installed in the system, you must run the above xbmgmt
program command separately for each card.
A message similar to the following will be displayed aer successfully ashing the card:
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
If the card has been ashed with the current plaorm rmware, you will see a message
similar to the following.
Device(s) up-to-date and do not need to be flashed.
6. Cold boot the machine to load the new rmware image on the FPGA.
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 19
Send Feedback

IMPORTANT! Be sure to perform a cold boot to fully power o the machine and then power it on
again. The image will not boot from ash if the machine is only rebooted.
IMPORTANT! Inier un démarrage a froid en appuyant sur le bouton d’alimentaon de la machine,
puis rallumer la machine. L’image ash ne démarrera pas sans un démarrage a froid.
WICHTIG! Führen Sie einen Kaltstart aus, indem Sie das Gerät vollständig aus und wieder
einschalten. Das Image startet nicht von Flash, wenn der Computer nur neu gestartet wird.
7. Update the SC rmware on the card. Run the following command to update the SC rmware
on the card. It is the idencal command used to ash the plaorm rmware on the card.
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management
BDF>
Where management BDF is the card requiring SC rmware update. See Displaying Card BDF
Values to obtain the device management BDF.
Updang the SC rmware can take several minutes.
IMPORTANT! If you have mulple cards installed in the system, you must run the above
xbmgmt
program command separately for each card.
A message similar to the following will be displayed aer a successful SC rmware update,
where the device management BDF is given in square brackets.
Report
[0000:af:00.0] : Successfully flashed
1 device(s) flashed successfully.
******************************************************************
Warm reboot is required to recognize new SC image on the device.
******************************************************************
If the card already has the current rmware, a message similar to the following is displayed
and no addional installaon steps are necessary.
Device(s) up-to-date and do not need to be flashed.
8. Warm boot the system for XRT to recognize the new SC image.
The installaon for deployment is now complete. Chapter 5: Card Bring-Up and Validaon
provides steps to validate the card has been installed successfully.
Chapter 4: Installing the Deployment Software
UG1370 (v1.8) October 28, 2021 www.xilinx.com
Alveo U50 Data Center Accelerator Card Installation Guide 20
Send Feedback