Kernel Test Days
Eine Kurzanleitung für die Kernel Test Days.
Während der Kernel Test Days werden alle Mitwirkenden gebeten, einen Kernel-Regressionstest durchzuführen. Dieser Test dient dazu, Probleme mit einer neuen Kernelversion vor der breiteren Verwendung zu erkennen und zu beheben. Er besteht aus der Ausführung einer Reihe von Tests, die von der Kernel Test Suite bereitgestellt werden.
Das Hauptziel eines Kernel Test Days ist es, einen neuen Kernel auf möglichst vielen verschiedenen Rechnern zu testen. Daher wird jeder neue Kernel Test Day einige Tage im Voraus mit einem Beitrag im Fedora Magazine angekündigt.
Was ist an den Kernel Test Days zu tun?
Als Erstes muss die richtige Kernel-Version für den Test besorgt werden. Es gibt verschiedene Möglichkeiten, den Kernel zu erhalten und ihn zu testen:
Verwenden eines Test-Day-Abbilds
Während der Testtage stellt eine spezielle Wiki-Seite einen Link zum Herunterladen eines Test-Day-Abbilds bereit. Dieses Abbild ist eine Live-Distribution von Fedora mit der zu testenden Kernel-Version. Es enthält außerdem die Testsuite, also die Skripte zum Testen des Kernels auf Ihrem Rechner. Die heruntergeladene .iso-Datei muss anschließend auf einen bootfähigen USB-Stick geschrieben werden.
| Lesen Sie in dieser Anleitung, wie Sie einen bootfähigen USB-Stick erstellen können. |
Anschließend können Sie das Live-Abbild starten und die Tests ausführen, ohne befürchten zu müssen, Ihr Betriebssystem zu beschädigen.
Verwendung einer virtuellen Maschine
Sie können die benötigte Kernelversion auch auf einer virtuellen Maschine mit einer aktuellen Fedora-Version installieren und den Test in der VM durchführen. Fügen Sie dazu einfach diese Copr-Paketquelle in der Fedora-Distribution Ihrer VM hinzu.
Wenn Sie die Paketquelle hinzugefügt haben, installieren Sie den zu testenden Kernel:
$ sudo dnf upgrade && sudo dnf install kernel-5.0.0-200.fc29.x86_64
-
Im obigen Beispiel installieren wir Kernel-5.0.0-200 auf Fedora 29 mit 64-Bit-Architektur.
-
Starten Sie das System neu und Sie können mit dem Testen beginnen.
Koji verwenden
Während der Kernel Test Days stellt die entsprechende Wiki-Seite einen Link zum Herunterladen der neu erstellten Kernel-Version zum Testen direkt von Koji Builds bereit. Dies wird Nutzern von Secure Boot empfohlen.
| Achtung: Sie könnten den neuen Kernel auch auf Ihrer Workstation/Ihrem Server, also auf einem Bare-Metal-Rechner, installieren und testen. Stellen Sie jedoch sicher, dass sich auf dieser Installation keine wichtigen Daten befinden, da sonst etwas schiefgehen könnte – führen Sie dies nicht auf Ihrem Produktivsystem durch! |
Lassen Sie uns die Tests vorbereiten (und uns ein neues Fedora-Abzeichen verdienen!)
Vor dem Testen müssen Sie einige Pakete installieren:
$ sudo dnf install gcc make git libtirpc python3-fedora keyutils libtirpc-devel policycoreutils-python-utils
-
Wenn Sie das *Test-Day-Abbild* verwenden, befindet sich die Kernel-Testsuite bereits im Verzeichnis „kernel-tests“. Wechseln Sie in dieses Verzeichnis mit
$ cd /home/liveuser/kernel-tests
-
Wenn Sie nicht das Test-Day-Abbild verwenden, müssen Sie das Kernel-Tests-Repository klonen. Verwenden Sie dazu folgenden Befehl im Terminal:
$ git clone https://pagure.io/kernel-tests.git
Dadurch wird dasselbe Verzeichnis heruntergeladen, das sich im Test-Day-Abbild befindet und die Testskripte enthält. Sobald der Download abgeschlossen ist, wechseln Sie in das Verzeichnis „kernel-tests“:
$ cd kernel-tests
Sobald Sie sich im Verzeichnis kernel-tests befinden, ist es an der Zeit, einige Konfigurationsdateien zu bearbeiten; zuerst müssen Sie den Inhalt der Datei config.example in eine neue, versteckte Datei namens .config kopieren.
$ cp config.example .config
Bearbeiten Sie nun die .config-Datei mit Ihrem bevorzugten Editor.
Hier können wir entscheiden, ob die Ergebnisse unserer Tests auf die Fedora-Server hochgeladen werden sollen oder nicht. Standardmäßig werden die Ergebnisse beim Ausführen der Tests nicht automatisch übermittelt. Sie werden lediglich ausgeführt und die Ergebnisse in eine Protokolldatei unter /kernel-tests/logs/ geschrieben.
-
Sie können Ergebnisse anonym übermitteln: Bearbeiten Sie die Datei
.configmit der Zeilesubmit=anonymous. -
Um die zu übermittelnden Ergebnisse mit Ihrem FAS-Benutzernamen zu verknüpfen, bearbeiten Sie die Datei
.configmitsubmit=authenticatedundusername=<Ihr FAS-Benutzername>
Wenn Sie Ihre Einreichung mit Ihrem FAS-Benutzernamen verknüpfen, erhalten Sie außerdem ein Fedora-Abzeichen!
Die Ergebnisse Ihres Tests werden hier hochgeladen.
Tests ausführen
| Vor dem Ausführen des Tests stellen Sie sicher, dass Ihr Rechner nicht bereits ausgelastet ist, zum Beispiel durch andere rechenintensive Prozesse. Sie können dies mit dem Befehl „top“ überprüfen. |
Vor dem Ausführen der Tests müssen wir der Testsuite mit diesem Befehl erlauben, ihren Heap-Speicher ausführbar zu machen:
$ sudo semanage boolean -m --on selinuxuser_execheap
| Wenn Sie die Tests abgeschlossen haben, denken Sie daran, die boolesche SELinux-Variable selinuxuser_execheap wieder auf den Standardzustand zurückzusetzen, indem Sie den folgenden Befehl ausführen: sudo semanage boolean -m --off selinuxuser_execheap |
Jetzt lassen Sie uns mit dem Testen beginnen!
Um die grundlegenden Tests auszuführen, verwenden Sie diesen Befehl:
$ sudo ./runtests.sh
Um die Performance-Testreihen auszuführen, verwenden Sie diesen Befehl:
$ sudo ./runtests.sh -t performance
Das erwartete Ergebnis ist, dass die Tests erfolgreich sind. Aufgrund der Systemlast können jedoch vereinzelt Tests fehlschlagen. Tragen Sie Ihre Testergebnisse bitte auf der entsprechenden Ergebnisseite des Kernel Test Days ein!
An einem Kernel Test Day wird eine spezielle Webseite zum Hochladen der Ergebnisse bereitgestellt. Dort können Sie ein Formular mit einer Beschreibung Ihrer Ergebnisse ausfüllen. Klicken Sie einfach auf Enter Result und füllen Sie das Formular aus. Geben Sie im Feld Username einen Benutzernamen ein, im Feld Profi eine Beschreibung des Rechners, auf dem Sie den Kernel getestet haben, und wählen Sie das Testergebnis (fehlgeschlagen oder bestanden) aus dem Auswahlmenü. Im Feld Bugs können Sie die Nummer eines Bugs (oder die durch Semikola getrennten Bugnummern, zum Beispiel „752855;25532“) eintragen, den Sie in Bugzilla für diesen Kernel gemeldet haben. Wenn Sie einen Bug im Kernel gefunden haben, melden Sie ihn bitte über diesen Link. Falls Sie kein Bugzilla-Konto besitzen, können Sie sich trotzdem mit Ihrem FAS-Konto anmelden.
| Wenn ein Test wiederholt fehlschlägt, helfen Sie bitte mit, indem Sie den Fehler in Bugzilla melden. |
Fügen Sie abschließend im Feld Comment weitere Kommentare oder Anmerkungen hinzu und klicken Sie auf Submit Query.
*Fertig!*
Vielen Dank, dass Sie dem Fedora-Team beim Testen des neuesten Kernels auf Ihrem Rechner geholfen haben!
Wenn Sie noch mehr helfen möchten: Treten Sie dem Fedora Quality Assurance-Team bei und schlagen Sie neue Testfälle für den Kernel vor, die noch nicht auf dieser Seite vorhanden sind.
Want to help? Learn how to contribute to Fedora Docs ›