Which tests to run
Tests with a Milestone of Alpha, Beta or Final are the most important. Optional tests are less so, but still useful to run. The milestone indicates that for that milestone release or a later one to be approved for release, the test must have been run against the release candidate build (so at Beta, all Alpha and Beta tests must have been run, for instance). However, it is important to run the tests for all milestones as early and often as possible. Please refer to the test coverage page linked above and try to find and run tests which have not been run at all, or not run recently, for the current release.
How to test
1. Download one or more media for testing:
| Image | ppc64 | ppc64le |
|---|---|---|
| nightly compose path | Rawhide nightly path f27 nighly path f27 nighly path | Rawhide nightly path f27 nighly path |
| Cloud base images | None | f27 Beta-1.3 f27 Beta-1.5 RC-1.6 |
| Atomic images | None | RC-1.6 |
| Docker images | None | f27 Beta-1.3 f27 Beta-1.5 Minimal RC-1.6 Base RC-1.6 |
2. Perform one or more of the test cases and add your results to the table below
- You can submit results by editing the page directly for reporting test results.
3. If a test fails, file a bug report. You may propose the bug as a release blocker or freeze exception bug for the appropriate release - see blocker bug process and freeze exception bug process.
Tracker bugs
Some tests must be run against particular Products or images - for example, the #Default boot and install tests. If no particular product or image is specified either in this page or the test case page, you can use any appropriate image. For example, you can run most of the #General Tests with the Server install images.
If you notice a problem during a test which does not constitute a complete failure of the test, you should still file a bug report, but it may not be appropriate to propose it as a release blocker bug. Use your judgment in deciding this, with reference to the Fedora_Release_Criteria, which these tests are intended to verify. If you are unsure, err on the side of proposing the bug as a blocker.
Key
See the table below for a sample format for test results. All test results are posted using the result template.
| Test Result | Explanation | Code Entered |
|---|---|---|
| Untested - This test has not been run, and is available for anyone to contribute feedback. | {{result|none}}
| |
| Passed - The test has been run and the tester determine the test met the expected results | {{result|pass|robatino}}
| |
| Inprogress - An inprogress result is often used for tests that take a long time to execute. Inprogress results should be temporary and change to pass, fail or warn. | {{result|inprogress|adamwill}}
| |
| Failed - Indicates a failed test. A link to a bug must be provided. See Template:Result for details on providing bug information. | {{result|fail|jlaska|XYZ|ZXY}}
| |
| [1] | Warning - This test completed and met the expected results of the test, but other issues were encountered during testing that warrant attention.
|
{{result|warn|rhe}} <ref>Brief description about the warning status</ref>
|
| Multiple results - More people can easily provide results to a single test case. | {{result|pass|hongqing}} {{result|warn|kparal}}
| |
| Result from previous test run - This test result is directly moved from the test run of previous <build>. | {{result|pass|previous <build> run}}
| |
| Unsupported - An unsupported test or configuration. No testing is required. |
Test Matrix
Cloud Provider Setup
Expand one of the sections below for instructions on setting up and running these testcases on a specific provider. More information can be found on the Fedora Cloud page and the Cloud Working Group website.
Amazon EC2 (via management console)
Personal account
- Obtain an AWS account (the approval process can take several hours).
Fedora group account
Amazon provides us with a community account. This account is currently used by: Fedora Infra, CentOS, Fedora-CI, openQA, logdetective, CoreOS, Cloud, ABRT, and others.
To avoid costs, you can contact the Infrastructure team and request access to Fedora's AWS account for testing purposes, per this SOP.
- Check your groups at https://accounts.fedoraproject.org/user/<ACCOUNT>.
- You must be in the aws-* FAS group (or another group with access) to perform this action.
- To access the AWS Console via Ipsilon authentication, use this SAML link.
Launch an Instance
- Log in to the AWS Management Console.
- Navigate to the EC2 console.
- To select the desired Amazon Machine Image (AMI), you can either:
- Use the "Direct launch link" (if provided).
- Search for and select the desired AMI in the IMAGES > AMIs section of the EC2 console.
- Ensure that your instance's security group is configured to allow SSH access (default TCP port 22).
- Launch an instance with the AMI.
Amazon EC2 (via Testing Farm)
Testing Farm Access - Testing Farm provides a streamlined way for Fedora and CentOS Stream contributors to access Amazon machines for testing. More information about public ranch users can be found here.
- Access Method: You can access Amazon images via Testing Farm; see the installation steps.
- Obtain API Key: Generate your public API key for Testing Farm. Note: The API key is shown only once and is distinct from the API ID. Generate API key.
- In Terminal:
export TESTING_FARM_API_TOKEN=<TOKEN> - Search: Find the appropriate nightly build and architecture from the latest datagrepper message (e.g., x86_64 or aarch64).
- In Terminal (Reserve Machine): Use the following command as an example:
testing-farm request --sanity --compose Fedora-Cloud-Base-AmazonEC2.x86_64-Rawhide-20251119.0 --arch x86_64 --reserve
Openstack
- Use your own OpenStack deployment
- Provide or create an SSH keypair
- Make sure that your security group allows for SSH (default tcp port 22)
- Log in to the Horizon dashboard
- Find the image URL at http://cloud.fedoraproject.org/ or as provided in release candidate documents.
- Add the image to OpenStack, either using the OpenStack web dashboard (see step 4 here) or with glance image-create --name "Fedora version" --disk-format qcow2 --container-format bare --is-public true --copy-from url
- Launch the instance (in the dashboard, under the "Images" heading, click the "Launch" button for the appropriate image
Local testing
- You can deploy the cloud image locally either using the well-known
virt-installtool or a Fedora-specifictestcloudtool. See Local cloud testing with virt-install or Testcloud quickstart guide, respectively. - Once logged in the virtual cloud instance, you can perform the tests below.
Openstack Cloud base
| Milestone | Test Case | Bare Metal | PKVM BE | PKVM LE | PVM | ||||
|---|---|---|---|---|---|---|---|---|---|
| BE | LE | Guest BE | Guest LE | Guest BE | Guest LE | LPAR BE | LPAR LE | ||
| Alpha | QA:Testcase_base_startup | ||||||||
| Alpha | QA:Testcase_base_system_logging | ||||||||
| Final | QA:Testcase_Services_start | ||||||||
| Final | QA:Testcase_base_selinux | ||||||||
| Final | QA:Testcase_base_service_manipulation | ||||||||
Atomic
| Milestone | Test Case | Bare Metal | PKVM BE | PKVM LE | PVM | ||||
|---|---|---|---|---|---|---|---|---|---|
| BE | LE | Guest BE | Guest LE | Guest BE | Guest LE | LPAR BE | LPAR LE | ||
| Alpha | QA:Testcase_base_startup | ||||||||
| Alpha | QA:Testcase_base_system_logging | ||||||||
| Final | QA:Testcase_Services_start | ||||||||
| Final | QA:Testcase_base_selinux | ||||||||
| Final | QA:Testcase_base_service_manipulation | ||||||||
- ↑ no /var/log/secure
Modular
| Milestone | Test Case | Bare Metal | PKVM BE | PKVM LE | PVM | ||||
|---|---|---|---|---|---|---|---|---|---|
| BE | LE | Guest BE | Guest LE | Guest BE | Guest LE | LPAR BE | LPAR LE | ||
| Optional | QA:Testcase_base_startup | ||||||||
- ↑ Ksinny image: base-runtime-27-ppc64le.tar.xz 2017-09-22 07:31 with following steps: 1) Docker installation on the Fedora 27 LPAR. 2) Loading of the Docker image. 3) Creation of a Docker container based on the image previously loaded. 4) Check a CLI (i.e bash) can be accessed into the container. 5) Check some dnf commands related to modules (list, install...).
- ↑ Server DVD iso image from https://kojipkgs.fedoraproject.org/compose/latest-Fedora-Modular-27/compose/Server/ppc64le/iso/ location. Anaconda starts in text mode but unable to perform the "Software selection", no numerical choice provided.
Docker Container Minimal Base
| Milestone | Test Case | Bare Metal | PKVM BE | PKVM LE | PVM | ||||
|---|---|---|---|---|---|---|---|---|---|
| BE | LE | Guest BE | Guest LE | Guest BE | Guest LE | LPAR BE | LPAR LE | ||
| Optional | QA:Testcase_base_startup | ||||||||
- ↑ RHBZ #1440875
- ↑ 1: Docker installation on the Fedora 27 VM (packages docker and systemd-container which is required by systemd). 2: loading of the Docker image. 3: Creation of a Docker container based on the image previously loaded. 4: Check a CLI (i.e bash) can be accessed into the container. 5: Check network access by executing a "microdnf update" and "microdnf install httpd".
Docker Base
| Milestone | Test Case | Bare Metal | PKVM BE | PKVM LE | PVM | ||||
|---|---|---|---|---|---|---|---|---|---|
| BE | LE | Guest BE | Guest LE | Guest BE | Guest LE | LPAR BE | LPAR LE | ||
| Optional | QA:Testcase_base_startup | ||||||||
- ↑ RHBZ #1440875
- ↑ 1: Docker installation on the Fedora 27 VM (packages docker and systemd-container which is required by systemd). 2: loading of the Docker image. 3: Creation of a Docker container based on the image previously loaded. 4: Check a CLI (i.e bash) can be accessed into the container. 5: Check network access by executing a "dnf repolist".
