English French
Author Name <giardia@fedoraproject.org> 2019-04-08
Before running tests, we need to allow the testsuite to make their heap memory executable with this command:
*Before running the test, be sure your machine has no workload already, like other cpu intensive processes.You can check using the command: top*
Before testing, you need to install some packages:
cd /home/liveuser/kernel-tests
cd kernel-tests
Check https://docs.fedoraproject.org/en-US/quick-docs/creating-and-using-a-live-installation-image/#proc_creating-and-using-live-usb[this guide] for creating a bootable USB stick.
cp config.example .config
*Disclaimer*: You could also install and test the new kernel on your Workstation/Server installation, on a bare metal machine, but make sure you have no important data on that installation, things might go wrong -- don't do this on your production machine!
During a kernel test day, a dedicated web application page is created for uploading results, there you can fill a form with a description of the results you got. Just Click on the *Enter Result* button and fill the form. Enter a username in the *Username* field, in the *Profile* field enter a description of the machine you tested the kernel on, and choose the result of your test from the dropdown menu (failed or pass). In the *Bugs* field you can write the number of a bug (or bug numbers divided by semicolons. i.e. '752855;25532') that you opened on Bugzilla, against that particular kernel. If you found a bug in the kernel, please report it via https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=kernel[this link.] If you don't have a Bugzilla account,you can still log in with your FAS account.
During *Kernel Test Days*, contributors are asked to run a _Kernel Regression Test_ which will help to detect and troubleshoot any issue with a new kernel version, before wider usage. It consist in running a series of tests provided by the https://pagure.io/kernel-tests[Kernel Test Suite]
During kernel test days, the dedicated wiki page will provide a link to download the newly built kernel version to test, directly from koji builds. This is recommended for secure boot users.
During test days a dedicated wiki page will provide a link to download a *test day image* which is a live distro of Fedora with the kernel version to test already in it. The test day image also contain the _test suite_, aka the scripts to test the kernel on your machine. The downloaded .iso file must then be written in a bootable USB stick.
Finally add any other comments or observations you want in the *Comment* field and Click the *Submit Query* button.
git clone https://pagure.io/kernel-tests.git
Here we can decide whether or not to upload the results of our tests to Fedora servers. By default, running the tests will not automatically submit results. They will just run and write results on a log file in /kernel-tests/logs/
If a test fails repeatedly, consider helping by reporting the failure on https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=kernel[Bugzilla]
If you are not using the test day image you will need to clone the kernel-tests repo. Use this command in terminal:
If you are using the _*test day image*_ you already have the kernel-test suite in the kernel-tests folder; enter the folder with