Mengalami ungraceful shutdown (mati mendadak) pada server produksi tentu menjadi situasi yang cukup menegangkan bagi seorang Sysadmin. Baru-baru ini, saya menangani insiden pada sebuah mail server Zimbra berbasis Rocky Linux 9 yang penyimpanan /opt-nya menggunakan filesystem OpenZFS. Sebelumnya, instalasi OpenZFS pada server tersebut mengacu pada panduan Tutorial Instalasi OpenZFS di Red Hat, Rocky Linux, CentOS, dan Oracle Linux oleh Ahmad Imanudin dengan memilih metode instalasi berbasis kABI-tracking (kmod-zfs). Ketika server mengalami downtime mendadak dan kembali menyala, partisi penyimpanan utama Zimbra di direktori /opt ternyata tidak ter-mount secara otomatis.
Ketika saya mencoba masuk ke user zimbra, muncul peringatan bahwa direktori /opt/zimbra tidak ditemukan:
[root@mail ~]# su - zimbra
su: warning: cannot change directory to /opt/zimbra: No such file or directory
Padahal, ketika diperiksa menggunakan perintah lsblk --fs, partisi disk tempat menyimpan ZFS pool (/dev/vdb1 dengan nama pool zimbrapool) masih terdeteksi dengan utuh. Namun, saat saya mencoba memuat modul ZFS dan memeriksa status pool, muncul error bahwa modul kernel ZFS tidak tersedia untuk kernel yang sedang berjalan.
Pada artikel kali ini, saya akan membagikan langkah demi langkah cara mendiagnosis akar masalahnya, bermigrasi dengan aman dari tipe kABI (kmod-zfs) ke DKMS (zfs-dkms) tanpa menghapus data di dalam pool, melakukan import & mount kembali ke /opt, hingga memverifikasi integritas data menggunakan zpool scrub.
Analisa Penyebab Masalah
Saat perintah modprobe zfs dan zpool status dijalankan, sistem menampilkan pesan error berikut:
[root@mail ~]# modprobe zfs
modprobe: FATAL: Module zfs not found in directory /lib/modules/5.14.0-687.66.1.el9_8.x86_64
[root@mail ~]# zpool status
The ZFS modules cannot be auto-loaded.
Try running 'modprobe zfs' as root to manually load them.
Untuk mengetahui mengapa modul ZFS hilang, kita bisa memeriksa daftar paket ZFS yang terpasang serta lokasi file modul zfs.ko di dalam sistem:
[root@mail ~]# rpm -qa | grep -E 'zfs|kernel-devel'
zfs-release-2-3.el9.noarch
libzfs5-2.2.9-2.el9.x86_64
zfs-2.2.9-2.el9.x86_64
kmod-zfs-2.2.9-2.el9.x86_64
[root@mail ~]# find /lib/modules -name "zfs.ko*"
/lib/modules/5.14.0-611.9.1.el9_7.x86_64/extra/zfs/zfs.ko
/lib/modules/5.14.0-611.55.1.el9_7.x86_64/weak-updates/zfs/zfs.ko
Dari output di atas, terlihat jelas akar permasalahannya:
- Sebelumnya OpenZFS diinstal menggunakan metode kABI-tracking (
kmod-zfs). - Modul
zfs.koyang tersedia hanya ditujukan untuk kernel EL 9.7 (5.14.0-611.*.el9_7.x86_64). - Ketika server reboot pasca insiden, server melakukan booting ke kernel baru EL 9.8 (
5.14.0-687.66.1.el9_8.x86_64). Karena terdapat perubahan kABI antar minor release (9.7 ke 9.8), mekanismeweak-modulestidak menautkan modul lama ke kernel baru.
Solusi terbaik agar hal serupa tidak terulang saat ada pembaruan kernel di masa depan adalah beralih dari tipe kABI (kmod-zfs) ke tipe DKMS (zfs-dkms). Dengan DKMS, modul kernel ZFS akan dikompilasi ulang secara otomatis untuk kernel yang sedang aktif maupun kernel baru yang diinstal nantinya.
Catatan Penting: Proses pergantian paket dari
kmod-zfskezfs-dkmshanya memperbarui driver ZFS di sisi sistem operasi (root disk) dan sama sekali tidak menyentuh atau menghapus data di dalam partisi ZFS pool (/dev/vdb1). Namun, pastikan untuk tidak langsung menjalankan perintahzpool upgradeapabila Anda masih ingin menjaga kompatibilitas pool dengan versi OpenZFS sebelumnya.
Langkah 1: Instalasi Prerequisite DKMS dan Kernel Headers
Karena DKMS akan mengompilasi modul ZFS langsung dari source code untuk kernel yang sedang berjalan, kita memerlukan paket epel-release (penyedia paket dkms), kernel-devel yang sesuai dengan versi uname -r, serta compiler gcc dan make:
# dnf install -y epel-release
# dnf install -y kernel-devel-$(uname -r) kernel-headers-$(uname -r) gcc make
Langkah 2: Migrasi dari kABI (kmod-zfs) ke DKMS (zfs-dkms)
Selanjutnya, nonaktifkan repository zfs-kmod dan aktifkan repository zfs (DKMS), lalu tukar paket kmod-zfs menjadi zfs-dkms dalam satu transaksi menggunakan dnf swap:
# dnf config-manager --disable zfs-kmod
# dnf config-manager --enable zfs
# dnf clean all
# dnf swap --allowerasing kmod-zfs zfs-dkms
Selama proses transaksi berjalan, DKMS akan otomatis mengompilasi dan memasang modul zfs.ko serta spl.ko untuk kernel 5.14.0-687.66.1.el9_8.x86_64:
Running the pre_build script............. done.
Building module(s)............... done.
Signing module /var/lib/dkms/zfs/2.2.11/build/module/zfs.ko
Signing module /var/lib/dkms/zfs/2.2.11/build/module/spl.ko
Running the post_build script... done.
Installing /lib/modules/5.14.0-687.66.1.el9_8.x86_64/extra/zfs.ko.xz
Installing /lib/modules/5.14.0-687.66.1.el9_8.x86_64/extra/spl.ko.xz
Running depmod..... done.
Setelah selesai, verifikasi status DKMS, muat modul ZFS ke kernel, dan pastikan modul dimuat otomatis saat booting:
[root@mail ~]# dkms status
zfs/2.2.11, 5.14.0-687.66.1.el9_8.x86_64, x86_64: installed
[root@mail ~]# modprobe zfs
[root@mail ~]# echo zfs > /etc/modules-load.d/zfs.conf
Langkah 3: Import dan Mount ZFS Pool ke /opt
Sebelum melakukan import pool, pastikan direktori /opt dalam keadaan kosong agar tidak menghalangi proses mounting ZFS:
[root@mail ~]# ls -la /opt
total 4
drwxr-xr-x. 2 root root 6 Nov 3 2024 .
drwxr-xr-x. 22 root root 4096 Mar 21 2026 ..
Lanjutkan dengan meng-import pool zimbrapool dan memeriksa status mountpoint dataset:
[root@mail ~]# zpool import zimbrapool
[root@mail ~]# zfs list -o name,mountpoint,canmount,mounted
NAME MOUNTPOINT CANMOUNT MOUNTED
zimbrapool /zimbrapool on yes
zimbrapool/zimbra /opt on yes
Catatan: Jika ZFS menampilkan peringatan bahwa pool sebelumnya berstatus aktif pada host lain (hal yang wajar setelah ungraceful shutdown) dan menolak melakukan import, Anda dapat menambahkan flag force: zpool import -f zimbrapool (aman dilakukan selama disk tidak di-share dengan server lain). Apabila kolom MOUNTED masih bernilai no, jalankan perintah zfs mount -a.
Pastikan seluruh partisi termount dan kondisi pool dalam keadaan sehat (ONLINE) melalui df -h dan zpool status:
[root@mail ~]# df -h
Filesystem Size Used Avail Use% Mounted on
...
/dev/vda4 49G 9.2G 40G 19% /
zimbrapool/zimbra 489G 3.9G 485G 1% /opt
zimbrapool 485G 128K 485G 1% /zimbrapool
[root@mail ~]# zpool status zimbrapool
pool: zimbrapool
state: ONLINE
config:
NAME STATE READ WRITE CKSUM
zimbrapool ONLINE 0 0 0
vdb1 ONLINE 0 0 0
errors: No known data errors
Langkah 4: Pemulihan Service Zimbra
Karena server mengalami ungraceful shutdown, biasanya terdapat sisa file .pid (stale PID files) di dalam direktori /opt/zimbra/log/. Untuk memastikan seluruh service Zimbra berjalan normal tanpa konflik proses, hentikan service terlebih dahulu, bersihkan file .pid yang tersisa, lalu jalankan ulang:
[root@mail ~]# su - zimbra
[zimbra@mail ~]$ zmcontrol stop
[zimbra@mail ~]$ rm -rf /opt/zimbra/log/*.pid
[zimbra@mail ~]$ zmcontrol start
[zimbra@mail ~]$ zmcontrol status
Host mail.colamen.id
mailbox Running
service webapp Running
stats Running
zimbra webapp Running
zimbraAdmin webapp Running
zimlet webapp Running
zmconfigd Running
Langkah 5: Konfigurasi Auto-Mount Saat Boot dan Verifikasi Integritas Data
Agar ZFS pool otomatis di-import dan di-mount ke /opt setiap kali server di-restart, atur cachefile dan aktifkan layanan systemd ZFS:
[root@mail ~]# zpool set cachefile=/etc/zfs/zpool.cache zimbrapool
[root@mail ~]# systemctl enable --now zfs-import-cache zfs-mount zfs.target
Pastikan file /etc/zfs/zpool.cache sudah terbentuk dan layanan zfs-import-scan dalam kondisi disabled agar tidak bentrok dengan zfs-import-cache saat proses booting:
[root@mail ~]# ls -l /etc/zfs/zpool.cache
-rw-r--r--. 1 root root 1576 Nov 16 10:48 /etc/zfs/zpool.cache
[root@mail ~]# systemctl is-enabled zfs-import-scan
disabled
Terakhir, sebagai langkah pencegahan pasca ungraceful shutdown, jalankan proses scrub di latar belakang untuk memverifikasi checksum seluruh blok data tanpa mengganggu operasional Zimbra:
[root@mail ~]# zpool scrub zimbrapool
[root@mail ~]# zpool status zimbrapool
pool: zimbrapool
state: ONLINE
scan: scrub repaired 0B in 00:00:43 with 0 errors on Mon Nov 16 10:52:44 2026
config:
NAME STATE READ WRITE CKSUM
zimbrapool ONLINE 0 0 0
vdb1 ONLINE 0 0 0
errors: No known data errors
Penutup
Dengan bermigrasi dari kmod-zfs (kABI) ke zfs-dkms (DKMS), masalah modul ZFS yang hilang pasca pembaruan kernel lintas minor release di Rocky Linux 9 dapat teratasi sepenuhnya. ZFS pool zimbrapool kembali termount dengan aman di /opt, seluruh layanan Zimbra berjalan normal, serta hasil zpool scrub memastikan tidak ada data yang korup akibat downtime mendadak.
Apabila rekan-rekan mengalami kesulitan atau memiliki kebutuhan terkait instalasi, pemeliharaan, migrasi, maupun pemulihan data (recovery) Zimbra Mail Server dan infrastruktur Linux, PT. Excellent Infotama Kreasindo menyediakan layanan implementasi dan Excellent Managed Services (EMS). Bagi rekan-rekan yang berminat untuk jasa layanan tersebut bisa langsung kontak & tanya-tanya ke email sales@excellent.co.id.