Getting Started with Alveo U30 on Premises

Important Information and Prerequisites

  • The Xilinx Video SDK must be installed on a server with one of more Xilinx Alveo U30 cards already installed.

  • PCIe bifurcation must be enabled on each slot with an Alveo U30 card. Check the BIOS settings to make sure this is the case.

  • The installation instructions require a bash shell. Make sure to be using one when installing the packages.

  • The installation instructions provided should only be used with the OEM version of the Alveo U30 card. If you do not have an OEM card, or if you are unsure of which card version you have, please contact Xilinx.

  • If you need to upgrade a system with version 0.95.0 (Alpha) or older installed, please contact Xilinx.


Install the Xilinx Video SDK

  1. Download the packages included in this repository:

    git clone https://github.com/Xilinx/video-sdk -b v1.5 --depth 1
    
  2. Navigate to the directory containing the packages corresponding to your Operating System:

    cd ./video-sdk/release/<os>
    
  3. Install the software packages:

    ./install.sh
    
  4. Program the binary images in the nonvolatile flash memories of the devices on your Alveo U30 cards:

    sudo ./u30flashall.sh
    
  5. Cold boot the machine to have the cards use the new binaries:

    sudo shutdown now
    
  6. After the cold boot is complete, check if all the cards are up to date:

    cd ./video-sdk/release/<os>
    sudo ./u30flashall.sh
    
    • If all cards are up to date, the script will report so and terminate. You can proceed to the next step.

    • Otherwise, you will see one or more messages indicating “Actions to perform: Program Satellite Controller (SC) image” and the script will perform the required Satellite Controller updates. After all updates are completed, perform a warm reboot of the machine.

  7. Test that the installation was successful with the command below. This script will run a validation test on each of the devices in your system. For each of the tests, you should see a message indicating “Validated successfully [1 device(s)]”:

    ./u30validateall.sh
    

Set Up the Runtime Environment

Note: These steps below should be performed each time you open a new terminal on your system.

  1. Set up the runtime environment:

    source /opt/xilinx/xcdr/setup.sh
    
    • At the prompt, enter the root password to start the Xilinx Resource Manager (XRM) daemon.

    • The script finishes with messages indicating that the devices and XRM plugins have been successfully loaded.

  2. Optionally verify that the cards are correctly detected:

    xbutil examine
    
  3. You are now ready to use the Xilinx video acceleration cards installed in your system.


Run Your First Examples

See the tutorials and examples page to learn how to run jobs on your system.