Clark's Home page

Tecnicismi vari di un Sysadmin Linux ma anche qualcosa della sua vita

apcupsd server —

Il demone apcupsd si installa con il solito apt-get install apcupsd che si tira dietro le dipendenze.
La configurazione si trova nel file /etc/apcupsd/apcupsd.conf il file è molto lungo e ben commentato con molte spiegazioni, di seguito epurato di tutti i commenti e delle parti che non sono usate la configurazione per un demone che gestisce la macchina a cui è collegato fisicamente e contemporaneamente fa da “net server” per dei client remoti.
## apcupsd.conf v1.1 ##
#
# “apcupsd” POSIX config file
UPSCABLE usb ###Specifica il tipo di collegamento fisico con l’UPS
UPSTYPE usb ###Indica il driver da utilizzare il driver USB rileva automaticamente il modello
LOCKFILE /var/lock ###Directory utilizzata da apcupsd per creare i lock file Serve ad evitare che due istanze del programma utilizzino contemporaneamente lo stesso UPS.
SCRIPTDIR /etc/apcupsd ###Directory dove si trovano gli script eseguiti durante gli eventi
PWRFAILDIR /etc/apcupsd ###Storicamente era la directory dove veniva creato il file powerfail con le versioni moderne è usata raramente ma viene lasciata per compatibilità.
NOLOGINDIR /etc ###Quando viene creato il file /etc/nologin gli utenti normali non possono più effettuare il logins olo root può accedere serve durante lo shutdown.
ONBATTERYDELAY 6 ###Quando manca la corrente apcupsd non fa nulla per 6 secondi Solo se il blackout dura almeno 6 secondi considera reale l’evento Serve ad evitare interventi inutili durante microinterruzioni.
BATTERYLEVEL 5 ### Shutdown quando la batteria arriva al 5%
MINUTES 3 ###Shutdown quando il tempo residuo stimato è inferiore a 3 minuti L’arresto avviene se si verifica uno qualsiasi dei criteri di spegnimento configurati (batteria al 5%, tempo residuo sotto i 3 minuti, oppure timeout, se impostato).
TIMEOUT 0 ###Timeout massimo trascorso a batteria 0=disabilitato
ANNOY 300 ###Ogni 300 secondi (5 minuti) viene inviato un messaggio agli utenti collegati
ANNOYDELAY 60 ###Aspetta 60 secondi prima di iniziare ad inviare tali messaggi. 0/60/360…
NOLOGON disable ###Decide quando impedire nuovi login disable non viene creato
KILLDELAY 0 ###Dopo aver inviato il comando di shutdown al sistema operativo non aspetta
NETSERVER on ###Fondamentale trasforma questo nodo nel Master
NISIP 192.168.2.240 ###IP sulla subnet dove ci saranno i/il client net
NISPORT 3551 ###Porta TCP del protocollo APC I client si collegano qui.
EVENTSFILE /var/log/apcupsd.events ###File dove vengono registrati gli eventi
EVENTSFILEMAX 10 ###Dimensione massima del file eventi Significa circa 10KB.
UPSCLASS standalone ###Indica la classe dell’installazione Con NETSERVER on, standalone è la scelta corretta per un unico UPS collegato direttamente a questo server che poi condivide lo stato in rete.
UPSMODE disable ###È un parametro storico utilizzato nelle vecchie configurazioni di condivisione seriale Con connessione USB e NETSERVER on viene normalmente lasciato a disable perché non è più utilizzato.
STATTIME 0 ###Ogni quanti secondi salvare le statistiche nel file di stato con 0 non salva periodicamente
STATFILE /var/log/apcupsd.status ###File destinato alle statistiche periodiche Poiché STATTIME è a 0, di fatto rimane inutilizzato.
LOGSTATS off ###Non registra periodicamente i dati dell’UPS nel syslog riduce il rumore nei log.
DATATIME 0 ###Intervallo con cui aggiornare il file dati con 0 è disabilitato.
BEEPSTATE T ###Controlla il buzzer dell’UPS T significa Toggle: il comando cambia lo stato corrente del cicalino (se è attivo lo disattiva, se è disattivo lo attiva).
SELFTEST 336 ###Programma l’autotest dell’UPS Il valore è espresso in ore Ogni due settimane l’UPS effettuerà un breve test della batteria.

OBBLIGATORIO:

/etc/default/apcupsd cambaire da no a yes per far partire il demone allo start del computer

OBBLIGATORIO:

se sul server che fa da net server gira un firewall la porta 3551 in tcp va aperta.
Verifica se tutto funziona

root@perseo:/home/guardian# apcaccess status
APC : 001,043,1007
DATE : 2026-07-24 13:23:25 +0200
HOSTNAME : perseo
VERSION : 3.14.14 (31 May 2016) debian
UPSNAME : perseo
CABLE : USB Cable
DRIVER : USB UPS Driver
UPSMODE : Stand Alone
STARTTIME: 2026-07-24 10:50:45 +0200
MODEL : Smart-UPS 1500 RM
STATUS : ONLINE
LINEV : 228.9 Volts
LOADPCT : 18.8 Percent
BCHARGE : 100.0 Percent
TIMELEFT : 22.0 Minutes
MBATTCHG : 5 Percent
MINTIMEL : 3 Minutes
MAXTIME : 0 Seconds
OUTPUTV : 228.9 Volts
SENSE : High
DWAKE : -1 Seconds
DSHUTD : 90 Seconds
LOTRANS : 208.0 Volts
HITRANS : 253.0 Volts
RETPCT : 0.0 Percent
ITEMP : 23.8 C
ALARMDEL : 30 Seconds
BATTV : 27.7 Volts
LINEFREQ : 50.0 Hz
LASTXFER : No transfers since turnon
NUMXFERS : 0
TONBATT : 0 Seconds
CUMONBATT: 0 Seconds
XOFFBATT : N/A
SELFTEST : NO
STESTI : 14 days
STATFLAG : 0x05000008
MANDATE : 2005-11-12
SERIALNO : AS0546233813
BATTDATE : 2005-11-12
NOMOUTV : 230 Volts
NOMBATTV : 24.0 Volts
FIRMWARE : 617.3.I USB FW:1.5
END APC : 2026-07-24 13:24:16 +0200

status online è la conferma del funzionamento corretto


Categorised as: Linux | Sistemi operativi | utilità | Work

Comments are disabled on this post


Comments are closed.