OpenLiteSpeed tidak mau start: mengatasi lsws failed, inactive, masked, dan segfault

Saat semua situs di server CyberPanel down sekaligus, OpenLiteSpeed biasanya penyebabnya. Jebakannya: systemctl restart lsws memperbaiki kasus mudah dan menyembunyikan kasus sulit. Panduan ini menelusuri status dan penyebab dalam urutan yang paling cepat menemukan masalah sebenarnya.

Baca status dengan benar

systemctl is-active lsws     # active | inactive | failed | activating
systemctl is-enabled lsws    # enabled | disabled | masked

Status	Arti	Aksi
inactive + tanpa error di journal	Memang tidak berjalan	systemctl start lsws
disabled	Tidak start saat boot	systemctl enable lsws
masked	Dikunci sengaja	systemctl unmask lsws && systemctl enable --now lsws (hanya jika Anda tahu kenapa di-mask)
failed	Mencoba start lalu crash	Jangan restart buta. Baca journal, di bawah.
activating lebih dari 30 dtk	Macet saat start	Tunggu, cek lagi, lalu perlakukan sebagai failed

Disk dan memori dulu

df -h / ; df -i /
free -m
dmesg -T | grep -iE "out of memory|killed process|segfault" | tail

OpenLiteSpeed perlu menulis /tmp/lshttpd/lshttpd.pid dan socket-nya. Tanpa ruang atau inode ia gagal diam-diam. Jika disk di atas 95%, bersihkan dengan aman sebelum langkah lain, atau paket apa pun yang Anda reinstall mungkin ikut corrupt.

Enam penyebab nyata, dan perbaikannya

journalctl -xeu lsws -n 60 --no-pager
tail -n 80 /usr/local/lsws/logs/error.log
/usr/local/lsws/bin/openlitespeed -t     # uji config

1. Port 80 atau 443 dipakai

ss -ltnp 'sport = :80'
ss -ltnp 'sport = :443'

Jika Anda melihat apache2, httpd, nginx, atau caddy, web server lain merebut port (sering karena sebuah paket menarik Apache sebagai dependency). Pastikan bukan Anda yang sengaja memasangnya, lalu:

systemctl disable --now apache2 2>/dev/null || systemctl disable --now httpd 2>/dev/null
systemctl disable --now nginx 2>/dev/null
systemctl restart lsws

2. PID file basi

Setelah crash atau reboot tidak bersih, PID file lama bisa menghalangi proses baru.

rm -f /tmp/lshttpd/lshttpd.pid
mkdir -p /tmp/lshttpd && chown nobody:nogroup /tmp/lshttpd   # AlmaLinux: nobody:nobody
systemctl start lsws

3. Konfigurasi tidak valid

openlitespeed -t atau error.log melaporkan parse error, sering di vhost conf yang diedit manual atau setengah tertulis oleh operasi CyberPanel yang gagal. Backup direktori config sebelum menyentuhnya:

cp -a /usr/local/lsws/conf /root/lsws-conf-backup-$(date +%F)

Lalu perbaiki file yang disebut log, atau sementara beri komentar vhost yang rusak di httpd_config.conf, start lsws, dan buat ulang vhost itu dari CyberPanel.

4. File SSL sebuah vhost hilang

Jika file sertifikat atau key sebuah situs terhapus atau renewal gagal setengah jalan, OpenLiteSpeed menolak memulai listener. Temukan file yang hilang:

grep -hE "keyFile|certFile" /usr/local/lsws/conf/vhosts/*/vhost.conf | awk '{print $2}' | while read f; do [ -f "$f" ] || echo "HILANG $f"; done

Buat pasangan self-signed sementara di path itu agar server hidup, lalu terbitkan sertifikat asli dari CyberPanel:

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -subj "/CN=localhost" \
  -keyout /path/privkey.pem -out /path/fullchain.pem
systemctl restart lsws

5. Kehabisan memori

dmesg menunjukkan Killed process ... (openlitespeed) atau (lsphp). Hidupkan dulu, lalu beri server ruang:

sync; echo 3 > /proc/sys/vm/drop_caches
systemctl restart lsws
# jika belum ada swap:
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo "/swapfile none swap sw 0 0" >> /etc/fstab

Lalu kurangi PHP children di pengaturan external app lsphp di konsol WebAdmin, atau pindah ke paket lebih besar; swap itu bantalan, bukan obat.

6. Binary corrupt (segfault)

Dibahas detail berikutnya, karena ini yang paling sering salah ditangani.

Kasus segfault secara detail

Journal menunjukkan Main process exited, code=killed, status=11/SEGV atau error.log kosong karena proses mati sebelum sempat menulis log. Periksa binary-nya:

file /usr/local/lsws/bin/openlitespeed
ls -la /usr/local/lsws/bin/
/usr/local/lsws/bin/openlitespeed -v

File 0 byte, data alih-alih ELF 64-bit, atau -v yang ikut segfault mengonfirmasinya. Binary kemungkinan besar tertulis saat disk penuh selama update paket otomatis. Perbaikannya reinstall paket; ia mengganti binary dan membiarkan /usr/local/lsws/conf utuh. Backup config tetap, karena tidak ada ruginya:

cp -a /usr/local/lsws/conf /root/lsws-conf-backup-$(date +%F)

# Ubuntu
apt-get clean && apt-get install --reinstall -y openlitespeed

# AlmaLinux / Rocky
dnf clean all && dnf reinstall -y openlitespeed

systemctl restart lsws

Jika package manager tidak menemukan openlitespeed, repositori LiteSpeed sudah terhapus. Tambahkan lagi (Ubuntu: wget -O - https://repo.litespeed.sh | bash; skrip yang sama bekerja di AlmaLinux) lalu jalankan reinstall lagi.

Verifikasi

systemctl is-active lsws
ss -ltnp 'sport = :80' | grep -c litespeed
for d in $(ls /usr/local/lsws/conf/vhosts/); do
  printf "%-30s " "$d"; curl -sk -o /dev/null -w "%{http_code}\n" -H "Host: $d" https://127.0.0.1/
done

Active, listening, dan setiap situs menjawab 200/301/302. Jika lsws active tetapi sebuah situs menjawab 503, masalahnya sudah pindah ke backend PHP situs itu; lihat 503 di website.