power / knowledge

NUT의 설정 파일이 나뉘는 방식과 MODE 정하기

paul 2025.10.07 193words (1m)

NUT은 설정 파일이 여러 개고 처음 보면 어디에 뭘 써야 할지 헷갈린다. 파일이 나뉜 기준은 역할이다.

파일 담당
ups.conf 어떤 UPS를 어떤 드라이버로 열지
upsd.conf UPS 상태를 넘겨주는 서버가 어디서 듣는지
upsd.users 그 서버에 누가 어떤 권한으로 붙는지
upsmon.conf 상태를 보고 언제 어떻게 끌지
upssched.conf 이벤트에 타이머나 조건을 걸 때

드라이버가 UPS에서 값을 읽고, upsd 가 그걸 중계하고, upsmon 이 받아서 판단한다. 그래서 UPS가 물린 기계에는 세 개가 다 필요하고, 감시만 하는 기계에는 upsmon 만 있으면 된다.

MODE

/etc/nut/nut.confMODE 가 그 기계에서 무엇을 띄울지 정한다.

의미
none 아무것도 자동으로 시작하지 않는다
standalone UPS 하나가 이 기계만 보호한다. 세 계층을 다 띄운다
netserver standalone과 같은데 네트워크로도 열어준다
netclient upsmon 만 띄운다. UPS는 다른 기계에 물려 있다

UPS 하나로 여러 대를 보호하는 구성이라 이렇게 나눴다.

bash
# UPS가 물린 쪽
MODE=netserver
bash
# 감시만 하는 쪽 (Proxmox, TrueNAS)
MODE=netclient

netserver 는 네트워크로 열리므로 upsd.conf 의 LISTEN과 upsd.users 를 같이 손봐야 한다.

POWEROFF_WAIT

bash
POWEROFF_WAIT=15s

OS가 다 꺼진 뒤 UPS 자체의 출력을 끊기까지 기다리는 시간이다. 이 사이에 전기가 돌아올 수도 있어서 곧바로 끊지 않고 여유를 뒀다.