AMD EPYC Linux Validation Exerciser Suite

AMD EPYC Linux Validation Exerciser Suite (ELVES) is a Linux Kernel test suite for AMD EPYC servers created and maintained by the AMD Linux test validation team.

The purpose is to host AMD EPYC feature-specific test cases that can run on the upstream Linux kernel. This test repository will include AMD EPYC feature-specific tests, such as IOMMU, RAS, PQOS, Bus Lock Trap, and virtualization-related test cases, as well as details on how each feature can be validated on AMD EPYC servers.

This repository contains a wrapper script and configuration files to allow the user to set up Avocado Test Framework and run a suite of tests to help verify AMD EPYC Feature on baremetal and in a virtual machine environment.

Supported Linux Distributions Version

Host Operating system - Ubuntu 24.04.2 LTS (Noble Numbat)
Guest Operating system - Ubuntu 24.04.2 LTS (Noble Numbat)

Supported component versions

The test cases published in this repository are validated with the following component versions:

• Baremetal OS kernel:
  • Minimum upstream kernel version: v6.14
  • Latest tested upstream version: v6.15.1
• KVM guest kernel:
  • upstream version: v6.15.1
• QEMU: v9.2.3
• OVMF (EDK2): edk2-stable202502

Supported Hardware

AMD EPYC 3rd Generation Processors Family 19h (codenamed "Milan")
AMD EPYC 4th Generation Processors Family 19h (codenamed "Genoa")
AMD EPYC 5th Generation processors Family 1Ah (codenamed "Turin")

Steps to run the testcases

Note: Tests should be run with the superuser permissions.

1. Ensure that python3 and python3-pip packages are installed on the host operating system.

   apt install python3 python3-pip

2. If virtualization testcases need to be run, the guest disk image should be created by running create_guest_image.sh provided in this repository

   git clone https://github.com/AMDESE/elves.git
   cd elves
   bash create_guest_image.sh

   Note:

   1. Disk image creation is supported only for Ubuntu 24.04 LTS (Noble Numbat).
   2. When creating a guest image on a physical host with the SIT kernel module enabled, the appliance's IPv4 interface may fail to configure properly due to interference from the SIT0 interface. This issue is fixed in upstream libguestfs commit.

3. Bootstrap the avocado environment:

   python3 ./avocado-setup.py --bootstrap --enable-kvm --install-deps --no-download

   Note: Remove --enable-kvm flag from above command if you are planning to run only baremetal testcases
   

4. The AMD EPYC Feature specific test cases published for baremetal/host and virtualization:

   Baremetal testcases published under configuration file : elves/config/tests/host/AMD_elves.cfg
   Virtualization testcases published under configuration file : elves/config/tests/guest/qemu/AMD_elves.cfg
   

   Below are the locations of current Baremetal AMD EPYC Feature specific test cases hosted in avocado-misc-tests:

   ras/amd/mce_mca
   qos/pqos/
   buslock/
   io/iommu/
   io/iommu/amd/
   memory/page_table.py
   

   There exists a readme file in each of above the test directories explaining the feature and the input requirements.

   Below are the current AMD EPYC virtualization Feature specific test cases hosted in tp-qemu

   AMD CVM guest boot tests: qemu/tests/amd_cvm_boot.py
   Guest boot tests in different IOMMU modes: qemu/tests/qemu_pci_passthrough.py
   

5. To run the testcases users should be updating the testcase specific inputs, guidance for which is provided in the respective test README files and test configuration files. Running the testcases:

   Running both baremetal and virtualization testcases:
   python3 ./avocado-setup.py --nrunner --vt qemu --run-suite host_AMD_elves,guest_AMD_elves --guest-os 24.04-server.x86_64 --no-download
   Running only baremetal testcases:
   python3 ./avocado-setup.py --nrunner --run-suite host_AMD_elves --no-download
   Running only virtualization testcases:
   python3 ./avocado-setup.py --nrunner --vt qemu --run-suite guest_AMD_elves --guest-os 24.04-server.x86_64 --no-download

The ELVES project is forked off of tests. We intend to funnel back changes to the parent project as relevant.

Reference Kernel Configurations

The reference_kconfig folder contains sample host and guest kernel configuration files used to validate the test cases in this repository.

References:

Avocado Test Framework
Avocado Test Framework documenation
Avocado Tests repository
Avocado-vt Plugin for KVM
KVM Tests: Qemu Test repository, Libvirt Test repository

Known Issues and Limitation:

Refer to Issues in this repository for details on bugs, limitations, future enhancements, and investigations.

Click here to open a new issue.