Hari Uji Kernel
Panduan singkat untuk Hari Uji Kernel.
Selama Hari Uji Kernel, para kontributor diminta untuk menjalankan Uji Regresi Kernel yang membantu mendeteksi dan memperbaiki masalah pada versi kernel baru sebelum digunakan secara luas. Uji ini terdiri dari serangkaian pengujian yang disediakan oleh Kernel Test Suite
Tujuan utama Hari Uji Kernel adalah untuk menguji kernel baru pada sebanyak mungkin mesin yang berbeda. Oleh karena itu, setiap Hari Uji Kernel diumumkan beberapa hari sebelumnya melalui artikel di Fedora Magazine.
Apa yang harus dilakukan selama Hari Uji Kernel
Hal pertama yang perlu dilakukan adalah mendapatkan versi kernel yang tepat untuk diuji. Ada beberapa cara untuk memperoleh dan mengujinya:
Menggunakan citra hari uji
Selama hari uji, halaman wiki khusus akan menyediakan tautan untuk mengunduh citra hari uji, yaitu distro live Fedora dengan versi kernel yang akan diuji sudah di dalamnya. Citra ini juga menyertakan test suite, yaitu skrip untuk menguji kernel pada mesin Anda. Berkas .iso yang diunduh harus ditulis ke USB yang dapat di-boot.
| Lihat panduan berikut untuk membuat USB yang dapat di-boot. |
Anda kemudian dapat melakukan boot dari citra live tersebut dan menjalankan pengujian tanpa khawatir merusak sistem operasi utama Anda.
Menggunakan Mesin Virtual
Anda juga dapat menginstal versi kernel yang diperlukan pada Mesin Virtual dengan Fedora terbaru dan melakukan pengujian di sana. Dalam hal ini, tambahkan repositori Copr berikut pada Fedora yang berjalan di VM Anda: tautan ini.
Setelah repositori ditambahkan, instal kernel yang akan diuji:
sudo dnf upgrade && sudo dnf install kernel-5.0.0-200.fc29.x86_64
-
Dalam contoh di atas, kita menginstal kernel-5.0.0-200 pada Fedora 29 dengan arsitektur 64-bit.
-
Lakukan reboot dan Anda siap untuk melakukan pengujian.
Menggunakan Koji
Selama Hari Uji Kernel, halaman wiki khusus akan menyediakan tautan untuk mengunduh versi kernel baru yang akan diuji langsung dari build Koji. Metode ini direkomendasikan untuk pengguna dengan Secure Boot.
| Penafian: Anda juga dapat menginstal dan menguji kernel baru pada instalasi Workstation/Server di mesin fisik, tetapi pastikan tidak ada data penting di sana karena kemungkinan terjadi kesalahan — jangan lakukan ini di mesin produksi Anda! |
Menyiapkan pengujian (dan mendapat Fedora Badge!)
Sebelum melakukan pengujian, Anda perlu menginstal beberapa paket berikut:
sudo dnf install gcc make git libtirpc python3-fedora keyutils libtirpc-devel policycoreutils-python-utils
-
Jika Anda menggunakan *citra hari uji*, Anda sudah memiliki kernel-test suite di folder kernel-tests; masuk ke folder tersebut dengan perintah
cd /home/liveuser/kernel-tests
-
Jika Anda tidak menggunakan citra hari uji, Anda perlu mengkloning repositori kernel-tests. Gunakan perintah ini di terminal:
git clone [https://pagure.io/kernel-tests.git](https://pagure.io/kernel-tests.git)
Perintah tersebut akan mengunduh folder yang sama seperti pada citra hari uji, beserta skrip pengujiannya. Setelah pengunduhan selesai, masuk ke folder kernel-tests:
cd kernel-tests
Setelah berada di folder kernel-tests, saatnya mengedit beberapa berkas konfigurasi; pertama, salin isi dari berkas config.example ke berkas tersembunyi baru bernama .config
cp config.example .config
Sekarang edit berkas .config dengan editor favorit Anda.
Di sini Anda dapat menentukan apakah hasil pengujian akan dikirim ke server Fedora atau tidak. Secara default, menjalankan pengujian tidak akan otomatis mengirim hasil. Hasil hanya akan disimpan ke berkas log di /kernel-tests/logs/
-
Untuk mengirim hasil secara anonim: edit berkas
.configdengansubmit=anonymous -
Untuk mengirim hasil dengan akun FAS Anda: edit berkas
.configdengansubmit=authenticateddanusername=<nama pengguna FAS Anda>
Jika Anda menautkan hasil pengujian ke akun FAS, Anda juga akan mendapatkan Fedora badge!
Hasil pengujian Anda akan diunggah ke halaman ini
Menjalankan pengujian
| Sebelum menjalankan pengujian, pastikan mesin Anda tidak sedang menjalankan beban kerja lain, seperti proses intensif CPU. Anda dapat memeriksa dengan perintah: top |
Sebelum menjalankan pengujian, kita perlu mengizinkan test suite untuk membuat memori heap dapat dieksekusi dengan perintah berikut:
sudo semanage boolean -m --on selinuxuser_execheap
| Setelah selesai melakukan pengujian, kembalikan boolean SELinux selinuxuser_execheap ke kondisi default dengan perintah: sudo semanage boolean -m --off selinuxuser_execheap |
Sekarang mari kita mulai pengujiannya!
Untuk menjalankan serangkaian pengujian dasar, gunakan perintah berikut:
sudo ./runtests.sh
Untuk menjalankan pengujian performa, gunakan perintah berikut:
sudo ./runtests.sh -t performance
Hasil yang diharapkan adalah semua pengujian lulus. Namun, beberapa pengujian mungkin gagal sesekali karena beban sistem. Apa pun hasilnya, unggah ke halaman hasil Hari Uji Kernel yang sesuai!
Selama Hari Uji Kernel, halaman web khusus disediakan untuk mengunggah hasil pengujian. Anda dapat mengisi formulir dengan deskripsi hasil yang diperoleh. Klik tombol Enter Result dan isi formulir. Masukkan nama pengguna di kolom Username, deskripsi mesin yang diuji di kolom Profile, dan pilih hasil pengujian dari menu drop-down (fail atau pass). Di kolom Bugs, tulis nomor bug (dapat dipisahkan titik koma, misalnya '752855;25532') yang Anda laporkan di Bugzilla terhadap kernel tersebut. Jika menemukan bug, laporkan melalui tautan ini. Jika belum memiliki akun Bugzilla, Anda dapat masuk menggunakan akun FAS Anda.
| Jika pengujian gagal berulang kali, pertimbangkan untuk membantu dengan melaporkan kegagalan melalui Bugzilla |
Terakhir, tambahkan komentar atau catatan apa pun pada kolom Comment dan klik tombol Submit Query.
*Selesai!*
Terima kasih telah membantu tim Fedora menguji kernel terbaru di mesin Anda!
Jika Anda ingin membantu lebih lanjut, bergabunglah dengan tim Fedora Quality Assurance dan usulkan kasus uji baru untuk kernel yang belum ada di halaman ini.
Want to help? Learn how to contribute to Fedora Docs ›