Hwan'Story › @kim-hwan

리눅스에서 APC UPS와의 상호작용을 위한 데몬 설치

· (수정 ) · 조회 2487

리눅스에서 APC UPS와의 상호작용을 위한 데몬 설치

집에서 운영 중인 서버가 간헐적인 정전이나 기타 이유로 인하여 전원이 나가는 경우가 간간히 발생했었다.

그런 문제를 해결하기 위하여 이번에 APC의 UPS를 구매하게 되었는데, 리눅스 시스템에서 해당 UPS와 상호작용을 위하여 설정하는 방법을 정리한다. (데비안 계열의 리눅스 기준으로 설명한다)

869180_600.jpg

⬆️이번에 구매한 APC BX1200MI-GR 모델

apcupsd 설치

아래 명령어를 입력하여 apcupsd를 설치한다.

sudo apt install apcupsd

apcupsd 설정

설치가 완료되었으면 이제 설정을 해야한다.

내가 구매한 모델은 USB를 이용하여 연결이 가능한 모델이어서 USB 연결 기준으로 설명한다.

아래 명령어를 입력하여 데몬 설정 파일을 연다.

sudo vi /etc/apcupsd/apcupsd.conf

...
...
...
UPSCABLE usb
...
...
...
UPSTYPE usb
...
...
...
DEVICE
...
...
...

위와 같이 3개의 설정을 변경해준다,

  1. UPSCABLE usb
    • UPS와 usb를 통하여 연결했기 때문에 usb로 설정한다.
  2. UPSTYPE usb
    • usb를 통한 연결 정의
  3. DEVICE
    • 기본값으로는 tty... 라고 적혀있는데 usb 연결 시에는 아무것도 써주지 않아야 한다. (자동으로 찾는다)

기타 나머지 자세한 설정들이 존재하는데, 해당 설정마다 모두 주석이 달려있기 때문에 읽어보고 설정하기 바란다.

그 후 아래 명령어로

sudo vi /etc/default/apcupsd

# Defaults for apcupsd initscript (unused with systemd as init).
# Set to "yes" to enable startup of apcupsd.
ISCONFIGURED=yes

ISCONFIGURED 부분이 처음에는 no로 되어 있는데 yes로 바꿔서 구성이 완료되었음을 저장한다.

그 후 서비스가 자동실행 되도록 아래 명령어를 입력하여 활성화 시켜준다.

sudo systemctl enable apcupsd

서비스 재실행

sudo systemctl restart apcupsd

아래 명령어를 입력하여 연결되어 있는 ups의 상태를 볼 수 있다.

apcaccess

APC      : 001,036,0867
DATE     : 2022-12-24 17:19:26 +0900  
HOSTNAME : kimhwan
VERSION  : 3.14.14 (31 May 2016) debian
UPSNAME  : kimhwan
CABLE    : USB Cable
DRIVER   : USB UPS Driver
UPSMODE  : Stand Alone
STARTTIME: 2022-12-24 16:29:59 +0900  
MODEL    : Back-UPS BX1200MI 
STATUS   : ONLINE 
LINEV    : 221.0 Volts
LOADPCT  : 11.0 Percent
BCHARGE  : 100.0 Percent
TIMELEFT : 41.0 Minutes
MBATTCHG : 50 Percent
MINTIMEL : 3 Minutes
MAXTIME  : 0 Seconds
SENSE    : Low
LOTRANS  : 140.0 Volts
HITRANS  : 300.0 Volts
ALARMDEL : 30 Seconds
BATTV    : 13.4 Volts
LASTXFER : Automatic or explicit self test
NUMXFERS : 0
TONBATT  : 0 Seconds
CUMONBATT: 0 Seconds
XOFFBATT : N/A
SELFTEST : OK
STATFLAG : 0x05000008
BATTDATE : 2001-01-01
NOMINV   : 230 Volts
NOMBATTV : 12.0 Volts
NOMPOWER : 650 Watts
FIRMWARE : 294201G -302201G 
END APC  : 2022-12-24 17:19:42 +0900

정상적으로 연결되어 정보를 받아온다.

다른 서버와의 추가 연결 방법

현재 UPS와 서버가 usb를 통하여 연결되어 설정이 되어 있는데, 해당 UPS에는 사실 총 2대의 서버가 연결되어 있다.

그런데 UPS에는 한 개의 usb 포트밖에 없기 때문에 usb를 통하여 서버와 추가로 연결은 불가능하다.

더 비싼 제품의 UPS에는 snmp를 이용한 네트워크 방식으로 UPS를 연결할 수 있지만 내가 구매한 모델은 그러한 기능은 탑재되어 있지 않다.

그래서 메인서버에 설정했던 apcupsd의 기능을 이용해서 추가로 연결하는 방법을 정리한다.

추가 연결을 위한 apcupsd 설정

usb로 연결이 되어 있는 서버에서 아래 명령어를 입력하여 데몬 설정 파일을 연다.

sudo vi /etc/apcupsd/apcupsd.conf

...
...
...
NETSERVER on
...
...
...
NISIP 0.0.0.0
...
...
...
NISPORT 3551
...
...
...

위와 같이 3개의 설정을 변경해준다.

  1. NETSERVER on
  2. NISIP 0.0.0.0
    • 외부 접속을 위해서 loopback ip를 0.0.0.0으로 변경한다.
  3. NISPORT 3551
    • 원하는 포트 설정 (나는 기본값을 사용했다)

그 후 아래 설정파일을 열어서 현재 서버의 정보와 추가로 연결할 서버의 정보를 입력한다.

sudo vi /etc/apcupsd/hosts.conf

# Network UPS Tools - hosts.conf
#
# This file does double duty - it lists the systems that multimon will
# monitor, and also specifies the systems that upsstats is allowed to 
# watch.  It keeps people from feeding random addresses to upsstats,
# among other things.  upsimage also uses this file to know who it 
# may speak to. upsfstats too.
#
# Usage: list systems running upsd that you want to monitor
#
# MONITOR <address> "<host description>"
#
# Please note, MONITOR must start in column 1 (no spaces permitted)
#
# Example: 
# MONITOR 10.64.1.1 "Finance department"
# MONITOR 10.78.1.1 "Sierra High School data room #1"
#
MONITOR x.x.x.x "Proxmox-MainServer"
MONITOR x.x.x.x "Proxmox-SubServer"

서비스 재실행

sudo systemctl restart apcupsd


이제 추가 연결을 위한 서버에서도 위에서 했던것과 동일하게 apcupsd 설치를 진행하고 설정을 해야 한다.

아래 명령어를 입력하여 데몬 설정 파일을 연다.

sudo vi /etc/apcupsd/apcupsd.conf

...
...
...
UPSCABLE ether
...
...
...
UPSTYPE net
...
...
...
DEVICE x.x.x.x:3551
...
...
...
NETSERVER on
...
...
...
NISIP 0.0.0.0
...
...
...
NISPORT 3551
...
...
...

위와 같이 6개의 설정을 변경해준다,

DEVICE x.x.x.x:3551 부분은 UPS와 연결되어 있는 서버의 IP를 입력한다.

그 후 동일하게 apcaccess 명령어를 입력해서 상태를 보면 정상적으로 연결이 된 것을 볼 수 있다.

APC      : 001,037,0928
DATE     : 2022-12-24 17:33:43 +0900  
HOSTNAME : deskmini
VERSION  : 3.14.14 (31 May 2016) debian
UPSNAME  : kimhwan
CABLE    : Ethernet Link
DRIVER   : NETWORK UPS Driver
UPSMODE  : Stand Alone
STARTTIME: 2022-12-24 16:29:36 +0900  
MASTERUPD: 2022-12-24 17:33:43 +0900  
MASTER   : 192.168.0.92:3551
MODEL    : Back-UPS BX1200MI 
STATUS   : ONLINE SLAVE 
LINEV    : 219.0 Volts
LOADPCT  : 11.0 Percent
BCHARGE  : 100.0 Percent
TIMELEFT : 41.0 Minutes
MBATTCHG : 50 Percent
MINTIMEL : 3 Minutes
MAXTIME  : 0 Seconds
SENSE    : Low
LOTRANS  : 140.0 Volts
HITRANS  : 300.0 Volts
BATTV    : 13.4 Volts
LASTXFER : Automatic or explicit self test
NUMXFERS : 0
TONBATT  : 0 Seconds
CUMONBATT: 0 Seconds
XOFFBATT : N/A
SELFTEST : OK
STATFLAG : 0x05000408
BATTDATE : 2001-01-01
NOMINV   : 230 Volts
NOMBATTV : 12.0 Volts
NOMPOWER : 650 Watts
FIRMWARE : 294201G -302201G 
END APC  : 2022-12-24 17:33:51 +0900

이제 갑자기 전원이 나가는 상황에서도 서버가 종료되지 않거나, 정상적으로 종료과정을 거칠 수 있는 시간을 벌 수 있게 되었다.

아래는 실제 설치한 UPS의 모습

image.png

관련 게시글

댓글 3개

XEM 2024. 11. 20.

이게 바로 제가 원했던 기능이었습니다. 명쾌한 솔루션에 정말 큰 도움을 받았습니다. 감사합니다!

ㅇㅇ 2025. 12. 20.

이번에 구매하고 적용하려합니다 미리 감사드립니다

upsking 2026. 9. 9.

ㄳㄳ