Environment Setup Instructions

Note

This page describes how to set up the runtime environment on a server with one or more Alveo U30 cards and the Xilinx Video SDK installed. If you have not installed the Xilinx Video SDK yet, please follow the Installation Guide.

1. Setup the environment by sourcing the /opt/xilinx/xcdr/setup.sh script:

   $ source /opt/xilinx/xcdr/setup.sh
   ---------------------------------------
   -----Source Xilinx U30 setup files-----
   XILINX_XRT      : /opt/xilinx/xrt
   PATH            : /opt/xilinx/xrt/bin:/home/user/bin:/home/user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin
   LD_LIBRARY_PATH : /opt/xilinx/xrt/lib:
   PYTHONPATH     : /opt/xilinx/xrt/python:
   XILINX_XRM      : /opt/xilinx/xrm
   PATH            : /opt/xilinx/xrm/bin:/opt/xilinx/xrt/bin:/home/user/bin:/home/user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin
   LD_LIBRARY_PATH : /opt/xilinx/xrm/lib:/opt/xilinx/xrt/lib:
   -----Starting xrmd-----
   rm -f /dev/shm/xrm.data
   rm: cannot remove '/dev/shm/xrm.data': Operation not permitted
   systemctl start xrmd
   ==== AUTHENTICATING FOR org.freedesktop.systemd1.manage-units ===
   Authentication is required to start 'xrmd.service'.
   Authenticating as: user,,, (user)
   Password:
   

2. You will be prompted to enter the root password to start the Xilinx Resource Manager (XRM) daemon.

3. After entering the root password, you will see messages confirming that the devices and XRM plugins have been loaded:

   ==== AUTHENTICATION COMPLETE ===
   -----Load xclbin to devices-----
   {
       "response": {
           "name": "load",
           "requestId": "1",
           "status": "ok"
       }
   }
   
   -----Load xrm plugins-----
   {
       "response": {
           "name": "loadXrmPlugins",
           "requestId": "1",
           "status": "ok"
       }
   }
   
   ---------------------------------------
   

Potential “failed” error code

If you source the setup script on a machine where the Xilinx Video SDK environment has already been initialized, you will see the “failed” status being reported. Note that this is not an issue. This status simply states that your environment is already set up and that the system is ready for use.

-----Load xrm plugins-----
{
    "response": {
        "name": "loadXrmPlugins",
        "requestId": "1",
        "status": "failed",
        "data": {
            "failed": "plugin xrmU30DecPlugin (version 2) is already loaded"
        }
    }
}

---------------------------------------

Ensuring Cards are Detected

After setting up your environment, you can optionally use the included card management tools to confirm that your cards and devices are properly detected.