XRT and Deployment Platform Installation Procedures on RedHat and CentOS

Use the following steps to download and install the XRT and deployment platforms using .rpm installation package.

For details on upgrading or downgrading the XRT and deployment platform, see Modifying XRT or Platform.

XRT installation 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 on the XRT Installation page.
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`
```
After the previous command completes, reboot your machine.
From the Getting Started tab of the Varium C1100 compute adaptor product page, download the Xilinx Runtime (XRT) and deployment target platform installation packages associated with your OS and version. To download the packages, click on the displayed package names.
Install the XRT installation package by running the following command from within the directory where the XRT installation packages reside. <version> is the latter part of the installation package file name.
```
$ sudo yum install ./xrt_<version>.rpm
```
This will install the XRT and its necessary dependencies. Follow the instructions when prompted throughout the installation.
Unpack the deployment target platform tar.gz file into a single directory. The location of the directory is not important, however the directory should not contain any other files.
Install the deployment packages. From within the directory where the installation packages were unpacked, run the following command. This will install all deployment packages.
```
$ sudo yum install ./*.rpm
```
After you install the deployment packages, 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>
```
Flash the platform firmware on the card.
With XRT 2021.1 or greater, you must use the following new command to flash the card, rather than the command displayed in the previous system message. This assumes only one deployment playform is installed on the card.
```
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF>
```
Where <management BDF> is the card to be programmed. To obtain the device management BDF, see Displaying Card BDF Values.

This can take several minutes.

Important: If you have multiple cards installed in the system, you must run the above xbmgmt program command separately for each card.

Note: If more than one platform is installed, then the --image option needs to be added. For details, see xbmgmt documentation.

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.

After successfully flashing the card, a message similar to the following is displayed:
```
1 device(s) flashed successfully.
****************************************************
Cold reboot machine to load the new image on device(s).
****************************************************
```
If the card has been flashed with the current platform firmware, a message similar to the following is displayed:
```
Device(s) up-to-date and do not need to be flashed.
```
Cold boot the 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.
Update the SC firmware on the card. Run the following command to update the SC firmware on the card. It is the identical command used to flash the platform firmware on the card. This can take several minutes to complete.
```
$ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF>
```
Where <management BDF> is the card to be programmed. To obtain the device management BDF, see Displaying Card BDF Values.

Important: If you have multiple 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 after a successful SC firmware 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 firmware, a message similar to the following is displayed and no additional installation steps are necessary.
```
Device(s) up-to-date and do not need to be flashed.
```
Warm boot the system for XRT to recognize the new SC image.

The installation for deployment is now complete. You can go directly to Card Bring-Up and Validation.

XRT and Deployment Platform Installation Procedures on RedHat and CentOS - 1.1 English

Varium C1100 Compute Adaptor Installation Guide (UG1525)