From Fedora Project Wiki

Revision as of 17:38, 12 September 2024 by Adamwill (talk | contribs) (mark plasma upgrade as 'optional' for now as it is not recommended in the upgrade docs)

Template documentation [edit]

This documentation is transcluded from Template:Installation test matrix/doc. It will not be transcluded on pages that use this template.
Wikitcms core page
This page is a core component of the Wikitcms system for storing release validation testing results in the Fedora wiki. This system relies on specific expectations regarding page naming, contents, and categorization. Please take special care when editing this page, especially if you change any element of wiki syntax, especially templating elements. If you are at all unsure about the consequences of your planned change, please contact the QA group before applying it.
This template contains the Installation 'test matrix' of test cases that are usually executed as part of release validation testing. It is pulled into release validation results pages using several nested templates, and can be used in other pages as appropriate. If all you need to do is add, remove or edit a Installation validation test case, though, don't worry about that stuff, and put it in here.

Please click [show] in each table to view the tests of each media installation, and click [edit] to post your test results using the syntax in Key Section.

Image sanity

Details
The result column titles are variants in Pungi/productmd parlance. For each variant, the checksums for all images in that variant can be checked; the maximum size for all images in that variant which have a maximum size can be checked; and repoclosure and fileconflicts can be checked for any DVD image in that variant. Any failure for any tested image should be filed as a bug and reported as a failure here. Please provide the bug ID and a short note of exactly which image(s) failed as a comment.
Milestone Test Case Everything Server Workstation Cloud Spins Container Labs
Basic / Final QA:Testcase_Mediakit_Checksums
none
none
none
none
none
none
none
Beta QA:Testcase_Mediakit_ISO_Size
none
none
none
none
none
none
none
Final QA:Testcase_Mediakit_Repoclosure
none
Final QA:Testcase_Mediakit_FileConflicts
none

Default boot and install (x86_64)

Single test table
In all of these tests, the test case used is QA:Testcase_Boot_default_install. That is where the links point. The same test needs to be run for multiple images, target platforms, and install media. Note that the non-installer-based AArch64 disk images are covered by the later #AArch64 disk images section. The VM columns are for results from testing in a virtual machine. The CD/DVD columns are for results from testing on a real system with the image written to a real CD or DVD. The USB columns are for results from testing on a real system with the image written to a USB stick.
Expected coverage
For Beta, we expect a reasonable sampling of tests across the table, with at least some testing for VM and USB boot method, both firmware types, and each major class of deliverable (netinst, live and DVD). For Final, we expect full coverage for Basic / Final rows with VM and USB boot method. Optical boot testing from physical media in Final is optional (but blocking if issues are found) for supported images.
Milestone Image VM BIOS VM UEFI USB BIOS USB UEFI CD/DVD BIOS (Optional) CD/DVD UEFI (Optional)
Basic / Final Workstation live
none
none
none
none
none
none
Basic / Final Everything netinst
none
none
none
none
none
none
Basic / Final Server netinst
none
none
none
none
none
none
Basic / Final Server dvd
none
none
none
none
none
none
Basic / Final KDE live
none
none
none
none
none
none
Optional Silverblue dvd-ostree
none
none
none
none
none
none
Optional Kinoite dvd-ostree
none
none
none
none
none
none
Optional Xfce live
none
none
none
none
none
none
Optional LXDE live
none
none
none
none
none
none
Optional LXQt live
none
none
none
none
none
none
Optional MATE live
none
none
none
none
none
none
Optional Cinnamon live
none
none
none
none
none
none
Optional SoaS live
none
none
none
none
none
none
Optional Budgie live
none
none
none
none
none
none
Optional i3 live
none
none
none
none
none
none
Optional Sway live
none
none
none
none
none
none


Default boot and install (aarch64)

Single test table
In all of these tests, the test case used is QA:Testcase_Boot_default_install. That is where the links point. The same test needs to be run for multiple targets. Note that the non-installer-based disk images are covered by the later #AArch64 disk images section. The VM UEFI column is for results from testing in a virtual machine. The USB UEFI column is for results from testing on a real system with the image written to a USB stick.
Expected coverage
For Beta, we expect full coverage of the VM UEFI tests, and at least one USB UEFI test. For Final, we expect full coverage.
Milestone Image VM UEFI USB UEFI
Basic / Final Server netinst
none
none
Basic / Final Server dvd
none
none


Fedora Media Writer

Milestone Test Case Fedora 40 Fedora 41 Fedora 42 Windows 10 Windows 11 macOS
Beta / Optional QA:Testcase_USB_fmw
none
none
none
none
none
none


AArch64 disk images

Single test table
In all of these tests, the test case used is QA:Testcase_arm_image_deployment. That is where the links point. The same test needs to be run for multiple images and target platforms.
Milestone Image aarch64 VM aarch64 HW
Basic Minimal
none
none
Basic / Optional Workstation
none
none
Basic / Optional Server
none
none
Basic / Optional KDE
none
none
Optional Xfce
none
none
Optional SoaS
none
none


PXE boot

Milestone Test Case x86_64 aarch64
Beta QA:Testcase_Boot_Methods_Pxeboot
none
none

Virtualization

Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Basic QA:Testcase_Install_to_Previous_KVM
none
none
none
Beta QA:Testcase_Install_to_Current_KVM
none
none
none
Optional QA:Testcase_Boot_Methods_Xen_Para_Virt
none
none
none
Milestone Test Case Linux host Windows host macOS host
Optional QA:Testcase_Install_to_VirtualBox
none
none
none


Storage devices

Milestone Test Case x86_64 aarch64
Basic QA:Testcase_install_to_NVMe
none
none
Basic QA:Testcase_install_to_SATA
none
none
Basic QA:Testcase_install_to_PATA
none
Basic QA:Testcase_install_to_SCSI
none
none
Basic QA:Testcase_install_to_SAS
none
none
Beta QA:Testcase_install_to_firmware_RAID
none
Beta QA:Testcase_install_to_hardware_RAID
none
none
Beta QA:Testcase_install_to_VirtIO
none
none
Final QA:Testcase_install_to_iSCSI_no_authentication
none
none
Final QA:Testcase_install_to_FCoE_target
none
Optional QA:Testcase_install_to_multipath
none

Guided storage configuration

Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Basic QA:Testcase_partitioning_guided_empty
none
none
none
Basic QA:Testcase_partitioning_guided_delete_all
none
none
none
Basic QA:Testcase_partitioning_guided_multi_select
none
none
none
Beta QA:Testcase_partitioning_guided_delete_partial
none
none
none
Beta QA:Testcase_partitioning_guided_free_space
none
none
none
Beta QA:Testcase_partitioning_guided_encrypted
none
none
none
Beta QA:Testcase_partitioning_guided_multi_empty_all
none
none
none

Guided storage shrinking

Environments
For this test, the column headings refer to the storage volume type to be shrunk, not the one chosen to replace it for the new installation.
Milestone Test Case ext4 NTFS
Final QA:Testcase_partitioning_guided_shrink
none
none

Custom storage configuration

Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Beta QA:Testcase_partitioning_custom_btrfs
none
none
none
Beta QA:Testcase_partitioning_custom_btrfs_preserve_home
none
none
none
Beta QA:Testcase_partitioning_custom_standard_partition_ext4
none
none
none
Beta QA:Testcase_partitioning_custom_lvm_ext4
none
none
none
Beta QA:Testcase_partitioning_custom_software_RAID
none
none
none
Final QA:Testcase_partitioning_custom_lvmthin
none
none
none
Final QA:Testcase_partitioning_custom_standard_partition_xfs
none
none
none
Final QA:Testcase_partitioning_custom_with_swap
none
none
none

Advanced custom storage configuration

Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Beta QA:Testcase_partitioning_blivet_btrfs
none
none
none
Beta QA:Testcase_partitioning_blivet_btrfs_preserve_home
none
none
none
Beta QA:Testcase_partitioning_blivet_standard_partition_ext4
none
none
none
Beta QA:Testcase_partitioning_blivet_lvm_ext4
none
none
none
Beta QA:Testcase_partitioning_blivet_software_RAID
none
none
none
Final QA:Testcase_partitioning_blivet_lvmthin
none
none
none
Final QA:Testcase_partitioning_blivet_standard_partition_xfs
none
none
none
Final QA:Testcase_partitioning_blivet_with_swap
none
none
none

User interface

Milestone Test Case Result
Basic QA:Testcase_Anaconda_User_Interface_Graphical
none
Basic QA:Testcase_Anaconda_User_Interface_Text
none
Basic QA:Testcase_Anaconda_User_Interface_VNC
none
Basic QA:Testcase_Anaconda_User_Interface_VNC_Vncconnect
none
Milestone Test Case x86_64 BIOS x86_64 UEFI
Basic / Final QA:Testcase_Anaconda_User_Interface_Basic_Video_Driver (Workstation Live)
none
none
Basic / Final QA:Testcase_Anaconda_User_Interface_Basic_Video_Driver (KDE Live)
none
none
Milestone Test Case x86_64 aarch64
Beta QA:Testcase_Anaconda_User_Interface_serial_console
none
none

Installation repositories

Milestone Test Case Result
Basic QA:Testcase_install_repository_Mirrorlist_graphical
none
Basic QA:Testcase_install_repository_HTTP_graphical
none
Basic QA:Testcase_install_repository_HTTP_variation
none
Beta QA:Testcase_install_repository_NFS_graphical
none
Beta QA:Testcase_install_repository_NFS_variation
none
Final QA:Testcase_install_repository_NFSISO_variation
none
Final QA:Testcase_install_repository_Hard_drive_variation
none

Package sets

Milestone Test Case Result
Beta QA:Testcase_Package_Sets_Minimal_Package_Install
none
Optional QA:Testcase_Package_Sets_KDE_Package_Install
none

Kickstart

Milestone Test Case Result
Basic QA:Testcase_kickstart_user_creation
none
Beta QA:Testcase_Kickstart_Http_Server_Ks_Cfg
none
Beta QA:Testcase_Kickstart_File_Path_Ks_Cfg
none
Beta QA:Testcase_Kickstart_Hd_Device_Path_Ks_Cfg
none
Beta QA:Testcase_Kickstart_Nfs_Server_Path_Ks_Cfg
none

Upgrade

Milestone Test Case x86_64 aarch64
Beta QA:Testcase_upgrade_gnome-software_current_workstation
none
none
Beta QA:Testcase_upgrade_gnome-software_previous_workstation
none
none
Beta QA:Testcase_upgrade_dnf_current_workstation
none
none
Beta QA:Testcase_upgrade_dnf_previous_workstation
none
none
Beta QA:Testcase_upgrade_dnf_current_workstation_encrypted
none
none
Beta QA:Testcase_upgrade_dnf_previous_workstation_encrypted
none
none
Beta QA:Testcase_upgrade_dnf_current_server
none
none
Beta QA:Testcase_upgrade_dnf_previous_server
none
none
Beta QA:Testcase_upgrade_dnf_current_kde
none
Beta QA:Testcase_upgrade_dnf_previous_kde
none
Beta QA:Testcase_upgrade_dnf_current_minimal
none
none
Beta QA:Testcase_upgrade_dnf_previous_minimal
none
none
Optional QA:Testcase_upgrade_plasma-discover_current_kde
none
none
Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Beta QA:Testcase_upgrade_dnf_current_any
none
none
none
Beta QA:Testcase_upgrade_dnf_previous_any
none
none
none


Internationalization and Localization

Milestone Test Case Result
Final QA:Testcase_Arabic_Language_Install
none
Final QA:Testcase_Asian_Language_Install
none
Final QA:Testcase_Cyrillic_Language_Install
none
Final QA:Testcase_Non-English_European_Language_Install
none
Optional QA:Testcase_default_font_installation
none

Miscellaneous

Milestone Test Case x86_64 aarch64
Basic QA:Testcase_Anaconda_user_creation
none
none
Milestone Test Case Result
Basic QA:Testcase_Anaconda_save_traceback_to_bugzilla (GUI mode)
none
Basic QA:Testcase_Anaconda_save_traceback_to_bugzilla (text mode)
none
Basic QA:Testcase_Anaconda_updates.img_via_URL
none
Final QA:Testcase_Anaconda_updates.img_via_installation_source
none
Final QA:Testcase_Anaconda_updates.img_via_local_media
none
Optional QA:Testcase_Anaconda_traceback_debug_mode (GUI mode)
none
Optional QA:Testcase_Anaconda_traceback_debug_mode (text mode)
none
Milestone Test Case x86_64 BIOS x86_64 UEFI aarch64
Beta QA:Testcase_Anaconda_rescue_mode
none
none
none
Final QA:Testcase_dualboot_with_windows (Windows 10)
none
none
Final QA:Testcase_dualboot_with_windows (Windows 11)
none
Final QA:Testcase_dualboot_with_macOS
none
Optional QA:Testcase_Install_Image_Boot_Local
none