AVED Installing the Deployment package onto the Host Server

  1. Before AVED installation, ensure that Xilinx RunTime library (XRT) has been removed. It’s not possible to have AVED management interface (AMI) and XRT running on the same host at the same time.

# --- Ubuntu -----------------------------
# Check if XRT is installed
apt list | grep xrt

# Remove XRT if present
sudo apt remove xrt

# --- RHEL -------------------------------
# Check if XRT is installed
yum list | grep xrt

# Remove XRT if present
sudo yum remove xrt

  1. Unzip the deployment archive

unzip amd_v80_gen5x8_23.2_exdes_1_xbtest_stress_20231205.zip

  1. Change the directory into the folder which was created during the unzip

cd amd_v80_gen5x8_23.2_exdes_1_xbtest_stress_20231205

  1. Run the AVED_install bash script

Note: this will need to be run as sudo.

sudo ./aved_install.sh

The AVED_install script will perform the following tasks:

  • Remove any previous AVED deployment installations (including AMI and xbtest software installations).

  • Copy AVED deployment archive contents (excluding sw_packages) to the /opt/amd/aved/<AVED Design Name>/ directory. The AVED Design Name for this example is amd_v80_gen5x8_23.2_exdes_1_xbtest_stress.

  • Install the AMI & xbtest software packages.


Example aved_install script output:

sudo ./aved_install.sh
==========================================================================
Removing previous AVED installations
==========================================================================


WARNING: apt does not have a stable CLI interface. Use with caution in scripts.


WARNING: apt does not have a stable CLI interface. Use with caution in scripts.


==========================================================================
Removing previous installation of AVED HW
==========================================================================


==========================================================================
Installing New AVED deployment
==========================================================================


==========================================================================
AVED Deployment files copied to /opt/amd/aved/amd_v80_gen5x8_23.2_exdes_1_xbtest_stress
==========================================================================


==========================================================================
Installing AMI & XBTEST
==========================================================================

Reading package lists... Done
Building dependency tree
Reading state information... Done
Note, selecting 'ami' instead of './sw_packages/ami_1.8.0-0.e223bc72.20231205_amd64_22.04.deb'
Note, selecting 'xbtest' instead of './sw_packages/xbtest_7.0-4064028_amd64_22.04.deb'
The following package was automatically installed and is no longer required:
  libsysmetrics1
Use 'sudo apt autoremove' to remove it.
The following NEW packages will be installed:
  ami xbtest
0 upgraded, 2 newly installed, 0 to remove and 73 not upgraded.
Need to get 0 B/1,183 kB of archives.
After this operation, 0 B of additional disk space will be used.
Get:1 /home/user/amd_v80_gen5x8_23.2_exdes_1_xbtest_stress_20231205/sw_packages/ami_1.8.0-0.e223bc72.20231205_amd64_22.04.deb ami amd64 1.8.0-0.e223bc72.20231205 [148 kB]
Get:2 /home/user/amd_v80_gen5x8_23.2_exdes_1_xbtest_stress_20231205/sw_packages/xbtest_7.0-4064028_amd64_22.04.deb xbtest amd64 7.0-4064028 [1,033 kB]
dpkg: warning: failed to open configuration file '/home/user/.dpkg.cfg' for reading: Permission denied
Selecting previously unselected package ami.
(Reading database ... 286388 files and directories currently installed.)
Preparing to unpack .../ami_1.8.0-0.e223bc72.20231205_amd64_22.04.deb ...
Unpacking ami (1.8.0-0.e223bc72.20231205) ...
Selecting previously unselected package xbtest.
Preparing to unpack .../xbtest_7.0-4064028_amd64_22.04.deb ...
-e
Installing xbtest package

Unpacking xbtest (7.0-4064028) ...
dpkg: warning: failed to open configuration file '/home/user/.dpkg.cfg' for reading: Permission denied
Setting up xbtest (7.0-4064028) ...
-e
xbtest package installed successfully

To run xbtest:

        1) Setup environment:
                * If using csh, refresh your environment by running rehash. Otherwise, refer to the manual for your shell or start a new session.

        2) Run verify test on card with BDF <bdf>:
                xbtest -d <BDF> -c verify

        3) For more info, try:
                xbtest -h
Setting up ami (1.8.0-0.e223bc72.20231205) ...
Module ami not loaded. Skipping 'rmmod'.

Creating symlink /var/lib/dkms/ami/1.8.0/source ->
                 /usr/src/ami-1.8.0

DKMS: add completed.

Kernel preparation unnecessary for this kernel.  Skipping...

Building module:
cleaning build area...
cd driver; make; cd .......
cleaning build area...

DKMS: build completed.

ami.ko:
Running module version sanity check.
 - Original module
   - No original module exists within this kernel
 - Installation
   - Installing to /lib/modules/5.4.0-165-generic/updates/dkms/

depmod...

DKMS: install completed.
INFO: Loading new ami Linux kernel modules
Done! If you are not running in bash you may need to refresh your environment before using AMI in the current shell.
If using csh, run 'rehash'. Otherwise, refer to the manual for your shell or start a new session.

==========================================================================
AVED Installation Complete
==========================================================================

Page Revision: v. 12