1. Home
  2. Docs
  3. Linux
  4. Monitoring
  5. Cara Setup NUT (Network UPS Tools) Auto-Shutdown Server

Cara Setup NUT (Network UPS Tools) Auto-Shutdown Server

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?

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:

UrutanPerangkatWaktu Tunggu (ONBATT)Aksi yang Dijalankan
1Synology NAS2 Menit (120 detik)Masuk ke Safe Mode lalu shutdown.
2Proxmox VE5 Menit (300 detik)Mematikan semua VM/LXC lalu mematikan host.
3NUT ServerSisa Baterai 20% & Runtime 5 Menit (300 detik)Memicu Forced Shutdown (FSD), membuat file killpower, lalu mematikan perangkat NUT Server.
4UPS APC BX1600MI-MS+30 Detik setelah NUT Server matiMematikan 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)

  1. Masuk ke Web Dashboard Synology DSM.
  2. Buka Control Panel → Hardware & Power → tab UPS.
  3. Centang Enable UPS support.
  4. Pada bagian UPS type, pilih Synology UPS server
  5. Pilih opsi waktu tunggu sebelum masuk ke Safe Mode, atur ke 2 minutes (120 detik).
  6. 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:

  1. UPS ups@… on battery
  2. 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 connected saat menjalankan upsc ups@localhost:
    Periksa apakah UPS terdeteksi oleh USB dengan perintah lsusb (cari ID 051d). Pastikan baris user = root sudah ditambahkan di bagian paling atas /etc/nut/ups.conf, lalu jalankan sudo upsdrvctl start untuk melihat pesan error spesifiknya.
  • Pesan Failed to read '/usr/lib/tmpfiles.d/nut-common-tmpfiles.conf' di Proxmox:
    Ini adalah bug minor paket nut-client Debian. Salin file konfigurasi tmpfiles Anda dengan perintah:
    cp /etc/tmpfiles.d/nut-client.conf /usr/lib/tmpfiles.d/nut-common-tmpfiles.conf lalu restart nut-monitor.
  • Log upssched tidak muncul saat pengujian:
    Pastikan file /etc/nut/upsmon.conf tidak memiliki baris NOTIFYFLAG ganda tanpa parameter +EXEC. Menggunakan konfigurasi bersih dengan RUN_AS_USER root seperti pada tutorial di atas akan menyelesaikan masalah ini.
  • UPS langsung menyalakan listrik tanpa jeda ondelay = 70:
    Seri rumahan APC Back-UPS BX1600MI-MS mengabaikan perintah ondelay melalui 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 sehingga libusb berputar tanpa jeda. Solusinya adalah menambahkan flag pollonly di /etc/nut/ups.conf agar driver mengabaikan jalur interrupt dan hanya mengambil data sesuai jadwal pollinterval.

Yang Perlu Diperhatikan (Best Practice)

  1. 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.
  2. 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.
  3. 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.
  4. Cek Riwayat Log Secara Berkala:
    Gunakan perintah journalctl -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.
Tags , ,
guest

0 Comments
Oldest
Newest Most Voted