From Fedora Project Wiki
Description
Build a simple generic network install image using lorax, and check it boots.
Setup
- Become root, with
sudo su
orsu
- Install the
lorax
package version you wish to test, on a system with a decent amount of disk space available - Create a working directory for the test (on a partition with a good amount of disk space free), e.g.
mkdir -p /var/tmp/loraxtest
, andcd
to it - Set SELinux to permissive mode, with
setenforce Permissive
How to test
- Create the test image. The basic form of the command to run is
lorax -p Fedora -v (version) -r (release) -s (repository URL) [-s (another repository URL)] ./results/
- Always create an image for the same release and arch as you have installed!
- You can usually use the release number for both -v and -r
- If you have Fedora 41 x86_64 installed, you could run
lorax -p Fedora -v 41 -r 41 -s https://dl.fedoraproject.org/pub/fedora/linux/releases/41/Everything/x86_64/os/ -s http://dl.fedoraproject.org/pub/fedora/linux/updates/41/x86_64/ ./results/
- If you are testing lorax on a not-yet-stable release like Fedora 42, use the Everything repository from a Branched or Rawhide nightly compose (whichever one matches the release you're testing)
- If the command runs successfully, it will produce a network install image as
results/images/boot.iso
. Try booting this image as usual (e.g. by attaching it to a virtual machine, writing it to a USB stick, or writing it to an optical disc) and running a default installation
Expected Results
- The command should run successfully and produce a
results/images/boot.iso
file - The image should boot and install successfully (assuming no underlying problems in the compose it is built from - if you run into a problem, check if the official Everything network install image from the compose you used has the same problem)