AVED Installing the Deployment package onto the Host Server¶

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

Unzip the deployment archive

unzip amd_v80_gen5x8_23.2_exdes_2_xbtest_stress_20240409.zip

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

cd amd_v80_gen5x8_23.2_exdes_2_xbtest_stress_20240409

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_2_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.


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


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


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


==========================================================================
Installing AMI & XBTEST
==========================================================================
Reading package lists...
Building dependency tree...
Reading state information...
The following packages were automatically installed and are no longer required:
  augeas-lenses libaugeas0 libruby3.0 rake ruby ruby-augeas ruby-deep-merge
  ruby-net-telnet ruby-rbtree ruby-rubygems ruby-selinux ruby-shadow
  ruby-sorted-set ruby-webrick ruby-xmlrpc ruby3.0 rubygems-integration
Use 'sudo apt autoremove' to remove them.
The following NEW packages will be installed:
  ami xbtest
0 upgraded, 2 newly installed, 0 to remove and 11 not upgraded.
Need to get 0 B/1,307 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_2_xbtest_stress_20240409/sw_packages/ami_2.2.0-0.0bab29e5.20240409_amd64_22.04.deb ami amd64 2.2.0-0.0bab29e5.20240409 [183 kB]
Get:2 /home/user/amd_v80_gen5x8_23.2_exdes_2_xbtest_stress_20240409/sw_packages/xbtest_7.0-5009311_amd64_22.04.deb xbtest amd64 7.0-5009311 [1,124 kB]
Selecting previously unselected package ami.
(Reading database ... 229186 files and directories currently installed.)
Preparing to unpack .../ami_2.2.0-0.0bab29e5.20240409_amd64_22.04.deb ...
Unpacking ami (2.2.0-0.0bab29e5.20240409) ...
Selecting previously unselected package xbtest.
Preparing to unpack .../xbtest_7.0-5009311_amd64_22.04.deb ...
-e
Installing xbtest package

Unpacking xbtest (7.0-5009311) ...
Setting up xbtest (7.0-5009311) ...
-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 (2.2.0-0.0bab29e5.20240409) ...
Module ami not loaded. Skipping 'rmmod'.
Creating symlink /var/lib/dkms/ami/2.2.0/source -> /usr/src/ami-2.2.0

Kernel preparation unnecessary for this kernel. Skipping...

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

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

depmod...
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.
Scanning processes...
Scanning processor microcode...
Scanning linux images...

Running kernel seems to be up-to-date.

The processor microcode seems to be up-to-date.

No services need to be restarted.

No containers need to be restarted.

No user sessions are running outdated binaries.

No VM guests are running outdated hypervisor (qemu) binaries on this host.

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

Page Revision: v. 14