Apcupsd是一款可以在Linux、UNIX、macOS和Windows上运行的APC UPS管理软件。支持APC和APC的OEM品牌产品对UPS进行通信,支持主机在断电后自动关机,同时也支持网络UPS的功能。
以前还有在线文档,现在已经没了:www.apcupsd.org自动跳转下载地址。
不过安装好了以后,在安装路径\apcupsd\doc\manual.html
中有这个文档的本地版。
目前的版本是3.14.14,而且很久没有更新了
下载连接https://sourceforge.net/projects/apcupsd/
下载好后是一个安装程序。
这里的UPS用Apc BK650 作为演示。
安装软件本体
部分windows版本需要以管理员权限运行。
首先,把UPS的数据线插入计算机,系统中会多出一个电池图标
设备管理器中会多出HID UPS电池和American Power Conversion USB UPS两个设备
之后开始安装程序,一路下一步,没什么好说的。
这里默认全选
安装位置可随意指定,之后正式进入安装。安装时会弹出几次警告。
此警告是表示没有安装USB驱动,后续需要自己另外安装。
安装完成,此时点击Next会弹出配置文件(apcupsd.conf),
apcupsd.conf暂时用不上,直接关闭即可
之后还是一路下一步,保持默认选项即可,中间会弹出几个警告,基本都是提示服务安装成功之类的
安装完成。默认会弹出发布文档ReleaseNotes.txt,关掉即可。
之后windows server右下角图标栏会多出一个图标,由于没有安装USB驱动,所以会显示“?”。
之后安装USB驱动。
安装USB驱动
注意!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
这里安装的驱动不是HID UPS电池
而是American Power Conversion USB UPS
打开设备管理器,右键更新驱动程序。
浏览我的电脑以查找驱动。
选择驱动文件位置:
是在安装位置的。apcupsd\driver
文件中,图中直接安装在C盘。之后下一步
安装
安装成功。
安装成功后,设备管理器-电池中的HID UPS会变成American Power Conversion USB UPS(Apcupsd);而人体学输入设备中的American Power Conversion USB UPS会消失。
此时右下角图标栏Apcupsd的图标会变成一个插头的状态。
双击打开会显示当前的配置,电池健康状态等信息。
配置文件说明
配置文件路径:安装路径\apcupsd\etc\apcupsd\apcupsd.conf
日志文件路径:安装路径\apcupsd\etc\apcupsd\apcupsd.events
注意!每次修改配置文件后需要重启apcupsd服务才能生效!
用记事本打开文件
对于Bk650这种简单的后背式USB UPS只需要关注以下几点即可:
文件中#号后面的是注释。
- MINUTES:在UPS还能运行多久(分钟)时关机。
- TIMEOUT:UPS断电后多久自动关机(秒)。
例如
TIMEOUT 60 表示在市电断电后60秒执行关机程序。
修改完成后保存,关闭。之后重启Apcupsd服务即可。
注意!对windows图标栏中的插头右键Exit不是退出服务。这只是退出了Apcupsd的一个图形监控软件apctray.exe
真正的服务进程是apcupsd.exe
重启也很简单,开始菜单,Apcupsd。Stop Apcupsd(停止服务);Start Apcupsd(启动服务)。
常见错误
1:安装USB驱动时没有证书、证书不被信任、第三方INF不包含数字签名…………
检查USB驱动文件中是否缺少证书。若缺少以下文件,需要卸载Apcupsd,重新安装
路径:安装位置\apcupsd\driver
2:安装USB驱动后出现 American Power Conversion USB UPS(Apcupsd)“该设备无法启动(代码10)”
原因:安装USB驱动时错误的选择了电池目录中的“HID UPS电池”,而不是人体学输入设备中的“American Power Conversion USB UPS”
解决方案,卸载American Power Conversion USB UPS(Apcupsd),以正确的方法重新安装。
最后进行断电测试
注意!如果你的NAS、服务器使用CRPS冗余电源,不要把两个电源插头都插到BK650上;一个插头插BK650上面,另一个插头插市电上。否则很可能会让UPS失去作用。
配置网络UPS
Apcupsd支持多种通信模式,但BK650只有最基本的USB模式。所以SNMP、PCNET等模式均无法使用;只能使用UPSTYPE net模式。一个作为主机(Master),其余的作为从机(Slave)。
注意!BK650配置这个功能需要在断电时保证主机和从机之间网络畅通。具体来说路由器,交换机之类的网络设备也要用UPS供电。或者两台机器直接用网线连起来。
假设主机的内网地址为10.0.0.25
重点配置文件
主机 | 从机 |
UPSCABLE usb | UPSTYPE net |
UPSTYPE usb | UPSCABLE ether |
DEVICE | DEVICE 10.0.0.25:3551 |
NETSERVER on | |
NISIP 0.0.0.0 | |
NISPORT 3551 | |
ANNOYDELAY 10 | |
EVENTSFILEMAX 10 | EVENTSFILEMAX 10 |
BATTERYLEVEL 5 | BATTERYLEVEL 5 |
ONBATTERYDELAY 6 | ONBATTERYDELAY 6 |
之后记得开放防火墙。
(待续)