Mati listrik mendadak merupakan ancaman utama bagi infrastruktur homelab dan server. Tanpa sistem manajemen power supply otomatis, mati lampu dapat menyebabkan corrupt pada database, kerusakan file sistem (filesystem corruption), hingga kerusakan hardware. Memanfaatkan Network UPS Tools (NUT) pada Linux Debian atau Ubuntu memungkinkan pengaturan auto-shutdown yang terkoordinasi secara efisien.
Jika Anda hanya memiliki satu unit UPS (Uninterruptible Power Supply) namun harus melindungi beberapa perangkat sekaligus—seperti file server, hypervisor, micro-services dan smart home hub—kabel USB UPS tentu tidak bisa dicolokkan ke semua perangkat secara bersamaan. Solusinya adalah setup NUT (Network UPS Tools) Server agar satu unit UPS dapat dimonitor secara terpusat dan memicu graceful shutdown otomatis ke seluruh klien melalui jaringan lokal (LAN).
- Kapan dan Di Mana Menggunakan Sistem Ini?
- Keuntungan Penerapan NUT Server
- Skema Timeline Urutan Shutdown
- Contoh skenario
- Langkah demi Langkah Konfigurasi NUT Server
- Konfigurasi Klien NUT Pertama — Synology NAS (Menit ke-2)
- Konfigurasi Klien NUT Kedua — Proxmox VE (Menit ke-5)
- Uji Simulasi
- Troubleshooting
- Yang Perlu Diperhatikan (Best Practice)
Kapan dan Di Mana Menggunakan Sistem Ini?
Sistem ups monitoring dan auto-shutdown terpusat ini ideal diterapkan pada skenario berikut:
- Homelab & Mini Server: Saat Anda menggunakan perangkat hemat listrik seperti SBC (Single Board Computer Armbian/Ubuntu) atau Mini PC yang terhubung ke satu UPS untuk melindungi semua perangkat di rak yang sama.
- Infrastruktur Kantor Skala Kecil-Menengah (SMB): Ketika satu unit UPS berkapasitas menengah (seperti APC Back-UPS BX1600MI-MS) menopang NAS, server aplikasi, dan perangkat jaringan sekaligus.
- Ekosistem Multi-Platform: Environment yang menggabungkan berbagai sistem operasi berbeda dalam satu jaringan, seperti Proxmox VE, Synology DSM, Linux Server, hingga container Docker.
Keuntungan Penerapan NUT Server
- Multi-Client & Cross-Platform: Satu daemon NUT di Linux Ubuntu / Debian mampu melayani puluhan klien lintas platform secara bersamaan melalui protokol TCP standar pada port
3493. - Mencegah Kerusakan Data (Data Corruption): Seluruh virtual machine (VM), kontainer Docker, dan volume pada NAS dimatikan secara clean sebelum baterai UPS habis.
- Urutan Shutdown Terkendali (Hierarchical Shutdown): Menggunakan penjadwalan waktu (
upssched), perangkat yang paling sensitif terhadap data (Synology NAS) dimatikan terlebih dahulu, disusul oleh hypervisor (Proxmox), baru kemudian NUT Server dan UPS. - Menjaga Kesehatan Baterai UPS (Battery Lifespan): Sistem tidak memaksa baterai UPS terkuras hingga 0% (deep discharge), sehingga usia pakai aki internal jauh lebih awet.
Skema Timeline Urutan Shutdown
Untuk memastikan tidak terjadi tabrakan proses saat listrik PLN padam (ONBATT), berikut adalah skema jeda waktu yang digunakan:
| Urutan | Perangkat | Waktu Tunggu (ONBATT) | Aksi yang Dijalankan |
|---|---|---|---|
| 1 | Synology NAS | 2 Menit (120 detik) | Masuk ke Safe Mode lalu shutdown. |
| 2 | Proxmox VE | 5 Menit (300 detik) | Mematikan semua VM/LXC lalu mematikan host. |
| 3 | NUT Server | Sisa Baterai 20% & Runtime 5 Menit (300 detik) | Memicu Forced Shutdown (FSD), membuat file killpower, lalu mematikan perangkat NUT Server. |
| 4 | UPS APC BX1600MI-MS | +30 Detik setelah NUT Server mati | Mematikan total UPS dan standby-off sampai listrik PLN kembali pulih. |
Contoh skenario
Saat UPS beralih ke mode baterai (ONBATT) saat listrik PLN padam, saya mengatur agar beberapa perangkat yang rentan terhadap kerusakan file akibat mati mendadak, seperti File Server (Synology NAS) dan Server Proxmox, melakukan shutdown otomatis. Hal ini juga membantu mengurangi beban UPS, sehingga perangkat jaringan seperti switch, router, dan modem dapat bertahan lebih lama untuk menjaga koneksi internet tetap aktif sampai sisa kapasitas baterai ≤ 20% atau sisa runtime ≤ 5 menit (300 detik), sebelum UPS benar-benar mati hingga listrik PLN kembali pulih.
Perangkat yang digunakan dalam contoh artikel ini :
- UPS APC Back-UPS BX1600MI-MS dengan port USB untuk monitoring.
- SBC / STB yang hemat listrik sebagai NUT Server menggunakan Armbian Ubuntu.
- Server Proxmox VE dan Synology NAS sebagai klien NUT.
Langkah demi Langkah Konfigurasi NUT Server
Setup NUT Server (Master) di SBC Armbian Ubuntu
Karena untuk menghemat daya saat menggunakan mode baterai, saya memanfaatkan SBC (seperti Raspberry, OrangePi, STB) sebagai NUT Server atau primary host yang bertugas mengirim indikator status UPS ke perangkat lain.
Instalasi Paket NUT (Network UPS Tools)
Pastikan kabel data USB dari UPS sudah tertancap langsung ke port USB SBC Armbian.
sudo apt update
sudo apt install -y nut nut-client nut-server
Konfigurasi Driver UPS (/etc/nut/ups.conf):
Untuk membuat NUT Master (Armbian) memicu shutdown otomatis dan mematikan UPS (killpower) berdasarkan sisa baterai (misalnya 20%) atau sisa waktu (runtime, misalnya 5 menit / 300 detik) Anda cukup mengandalkan fitur bawaan NUT yaitu status LOWBATT (LB) yang dikombinasikan dengan parameter FINALDELAY. Dengan metode ini, driver usbhid-ups akan memaksa status UPS berubah menjadi LB (Low Battery) begitu ambang batas persentase atau runtime tercapai, meskipun firmware UPS belum menganggapnya kritis.
cat << 'EOF' | sudo tee /etc/nut/ups.conf
[ups]
driver = usbhid-ups
port = auto
vendorid = 051d
desc = "APC Back-UPS BX1600MI-MS"
# Memaksa driver menghitung sendiri batas Low Battery (LB)
ignorelb
# Trigger Low Battery saat sisa baterai <= 20%
override.battery.charge.low = 20
# Trigger Low Battery saat sisa runtime <= 300 detik (5 menit)
override.battery.runtime.low = 300
# Jeda 30 detik sebelum UPS dimatikan total setelah NUT Server shutdown
offdelay = 30
ondelay = 60
EOF
Catatan penting: Nama bagian wajib [ups] agar kompatibel secara bawaan dengan Synology NAS.
Konfigurasi User (/etc/nut/upsd.users):
Gunakan username monuser dan password secret karena Synology DSM menggunakannya secara hardcoded.
cat << 'EOF' | sudo tee /etc/nut/upsd.users
[admin]
password = password_admin_anda
actions = SET
instcmds = ALL
upsmon master
[monuser]
password = secret
upsmon slave
EOF
Konfigurasi Monitor Master (/etc/nut/upsmon.conf):
Buka /etc/nut/upsmon.conf dan sesuaikan parameter berikut.
cat << 'EOF' | sudo tee /etc/nut/upsmon.conf
MONITOR ups@localhost 1 admin password_admin_anda primary
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
NOTIFYFLAG ONLINE SYSLOG+WALL
NOTIFYFLAG ONBATT SYSLOG+WALL
NOTIFYFLAG LOWBATT SYSLOG+WALL
NOTIFYFLAG FSD SYSLOG+WALL
RBWARNTIME 43200
NOCOMMWARNTIME 300
FINALDELAY 5
EOF
Atur Mode Jaringan (/etc/nut/nut.conf & /etc/nut/upsd.conf):
Secara default, NUT hanya listen koneksi lokal (127.0.0.1). Ganti mode netserver di /etc/nut/nut.conf dan buka akses ke seluruh jaringan di /etc/nut/upsd.conf:
echo "MODE=netserver" | sudo tee /etc/nut/nut.conf
echo "LISTEN 0.0.0.0 3493" | sudo tee -a /etc/nut/upsd.conf
Restart Services & Verifikasi:
sudo systemctl restart nut-driver.target nut-server nut-monitor
sudo systemctl enable nut-server nut-monitor
Pastikan data terbaca dengan menjalankan perintah:
upsc ups@localhost
Jika berhasil, parameter seperti battery.charge, battery.runtime, dan ups.status: OL (Online) akan tampil di layar.
Konfigurasi Klien NUT Pertama — Synology NAS (Menit ke-2)
- Masuk ke Web Dashboard Synology DSM.
- Buka Control Panel → Hardware & Power → tab UPS.
- Centang Enable UPS support.
- Pada bagian UPS type, pilih Synology UPS server
- Pilih opsi waktu tunggu sebelum masuk ke Safe Mode, atur ke 2 minutes (120 detik).
- Masukkan IP Address SBC Armbian (misal:
192.168.99.8) pada kolom Network UPS server IP, lalu klik Apply.
Konfigurasi Klien NUT Kedua — Proxmox VE (Menit ke-5)
Buka Shell Proxmox VE sebagai root dan jalankan langkah berikut:
Instal nut-client dan Atur Mode:
apt update && apt install -y nut-client
echo "MODE=netclient" > /etc/nut/nut.conf
Konfigurasi Monitor Proxmox (/etc/nut/upsmon.conf):
(Ganti 192.168.1.8 dengan IP Armbian Anda).
cat << 'EOF' > /etc/nut/upsmon.conf
RUN_AS_USER root
MONITOR [email protected] 1 monuser secret secondary
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
NOTIFYCMD /sbin/upssched
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 15
DEADTIME 15
POWERDOWNFLAG /etc/killpower
NOTIFYFLAG ONLINE SYSLOG+WALL+EXEC
NOTIFYFLAG ONBATT SYSLOG+WALL+EXEC
NOTIFYFLAG LOWBATT SYSLOG+WALL+EXEC
NOTIFYFLAG FSD SYSLOG+WALL+EXEC
NOTIFYFLAG COMMOK SYSLOG+WALL
NOTIFYFLAG COMMBAD SYSLOG+WALL
RBWARNTIME 43200
NOCOMMWARNTIME 300
FINALDELAY 5
EOF
Atur Timer Shutdown Menit ke-5 (/etc/nut/upssched.conf & /etc/nut/upssched-cmd):
mkdir -p /var/run/nut/upssched
chmod 777 /var/run/nut/upssched
cat << 'EOF' > /etc/nut/upssched.conf
CMDSCRIPT /etc/nut/upssched-cmd
PIPEFN /var/run/nut/upssched/upssched.pipe
LOCKFN /var/run/nut/upssched/upssched.lock
AT ONBATT * START-TIMER proxmox-shutdown 300
AT ONLINE * CANCEL-TIMER proxmox-shutdown
AT LOWBATT * EXECUTE proxmox-shutdown
AT FSD * EXECUTE proxmox-shutdown
EOF
cat << 'EOF' > /etc/nut/upssched-cmd
#!/bin/sh
case $1 in
proxmox-shutdown)
logger -t upssched-cmd "Timer 5 menit setelah UPS masuk mode baterai. Mematikan Proxmox VE sekarang..."
/sbin/shutdown -h +0
;;
esac
EOF
chmod 755 /etc/nut/upssched-cmd
Pastikan Direktori /run/nut Dibuat Otomatis Saat Booting:
cat << 'EOF' > /etc/tmpfiles.d/nut-client.conf
d /run/nut 0770 root nut -
d /run/nut/upssched 0777 root root -
EOF
systemd-tmpfiles --create /etc/tmpfiles.d/nut-client.conf
systemctl restart nut-monitor && systemctl enable nut-monitor
Uji Simulasi
Sebelum mengandalkan sistem ini saat mati lampu sungguhan, lakukan dua tahap pengujian berikut:
Simulasi Timer Tanpa Mematikan Perangkat (15 Detik)
Buka terminal SSH pada Armbian dan Proxmox secara berdampingan, lalu jalankan pemantauan log real-time:
journalctl -f -g "battery|line power|FSD|ups|upssched"
Cabut kabel listrik utama UPS APC dari stopkontak PLN selama 15 detik, lalu colokkan kembali.
Pastikan pada terminal muncul log:
- UPS ups@… on battery
New timer: proxmox-shutdown (300 seconds)(di Proxmox)
Saat kabel dicolokkan kembali, pastikan muncul log Cancelling timer yang menandakan penghitung waktu mundur berhasil dibatalkan otomatis.
atau memastikan apakah driver USB mendeteksi perubahan status baterai:
watch -n 2 "upsc ups@localhost ups.status battery.charge"
Simulasi Penuh (Full Blackout Test)
Lakukan di luar jam kerja dengan mencabut kabel PLN dan membiarkannya selama 8–10 menit. Amati urutan lampu indikator dan layar monitor:
- Menit ke-2: Synology NAS mulai berkedip dan mati total.
- Menit ke-5: Seluruh VM dan LXC di Proxmox otomatis di shutdown, disusul host Proxmox mati.
- Baterai sisa 20% atau Runtime sisa 5 Menit: SBC Armbian mati, dan 60 detik kemudian UPS APC akan berbunyi klik lalu UPS mati total.
Troubleshooting
Error: Driver not connectedsaat menjalankanupsc ups@localhost:
Periksa apakah UPS terdeteksi oleh USB dengan perintahlsusb(cari ID051d). Pastikan barisuser = rootsudah ditambahkan di bagian paling atas/etc/nut/ups.conf, lalu jalankansudo upsdrvctl startuntuk melihat pesan error spesifiknya.- Pesan
Failed to read '/usr/lib/tmpfiles.d/nut-common-tmpfiles.conf'di Proxmox:
Ini adalah bug minor paketnut-clientDebian. Salin file konfigurasi tmpfiles Anda dengan perintah:cp /etc/tmpfiles.d/nut-client.conf /usr/lib/tmpfiles.d/nut-common-tmpfiles.conflalu restartnut-monitor. - Log
upsschedtidak muncul saat pengujian:
Pastikan file/etc/nut/upsmon.conftidak memiliki barisNOTIFYFLAGganda tanpa parameter+EXEC. Menggunakan konfigurasi bersih denganRUN_AS_USER rootseperti pada tutorial di atas akan menyelesaikan masalah ini. - UPS langsung menyalakan listrik tanpa jeda
ondelay = 70:
Seri rumahan APC Back-UPS BX1600MI-MS mengabaikan perintahondelaymelalui USB karena keterbatasan firmware relai internalnya. Solusinya, atur Power On Delay langsung melalui pengaturan BIOS PC Proxmox Anda. - Beban CPU 100% pada proses
usbhid-ups:
Disebabkan oleh USB HID Interrupt In storm / tight loop — firmware USB UPS terus-menerus membanjiri bus USB dengan paket interrupt sehinggalibusbberputar tanpa jeda. Solusinya adalah menambahkan flagpollonlydi/etc/nut/ups.confagar driver mengabaikan jalur interrupt dan hanya mengambil data sesuai jadwalpollinterval.
Yang Perlu Diperhatikan (Best Practice)
- Aktifkan QEMU Guest Agent di Proxmox VE:
Pastikan opsi QEMU Guest Agent berstatus Enabled pada setiap VM di Proxmox agar perintah shutdown pada menit ke-5 dikirim secara graceful ke sistem operasi di dalam VM. - Atur Auto Power Recovery di BIOS & DSM:
- Proxmox VE: Masuk ke BIOS/UEFI dan atur Restore on AC Power Loss ke Power On (tambahkan Power On Delay 60 detik jika didukung motherboard).
- Synology NAS: Pada menu Control Panel → Hardware & Power → General, centang opsi Restart automatically when power supply issue is fixed.
- Hindari Penggunaan USB Hub Pasif:
Selalu hubungkan kabel USB UPS langsung ke port USB utama di board SBC Armbian untuk mencegah koneksi terputus (USB disconnect) saat terjadi fluktuasi tegangan. - Cek Riwayat Log Secara Berkala:
Gunakan perintahjournalctl -b -1 -g "upsmon|upssched"di Linux atau menu Log Center di Synology DSM setelah terjadi pemadaman listrik untuk memastikan seluruh skrip berjalan sesuai jadwal.