Packetwatch.net

Apcupsd in Windows



Last modified: Jun. 11, 2010

Contents
1 - Summary
2 - Dependencies
3 - Apcupsd installation
4 - Service configuration
5 - Apcaccess example
6 - Apctray example
7 - Service check


1 - Summary

This guide will show how to install apcupsd in Windows. Apcupsd is used
for power management and controlling of APC UPS's. This has been tested in
Windows 2000, XP, 2003 and 2008.


2 - Dependencies

You will need to have Windows configured to send emails using Blat. You will
will also need some information about the UPS and the UPS cable.
  Model number
  UPS cable type
The serial port or USB ports will need to be enabled in the BIOS of the
computer. If you enabled the serial port in the BIOS and plan to use it, you
can find out what the serial COM port is by doing the following. Type the
following in at the Run button on the Start Menu. This will open the device
management console.
  devmgmt.msc
Expand Port (COM & LPT) to find the serial COM port number in the computer.

Serial COM ports
For this guide we will use the serial port. 3 - Apcupsd installation Download the apcupsd Windows package at http://www.apcupsd.org/. Run the installer and keep all components selected to be installed.
Apcupsd installation options
I set the destination folder to be C:\Program Files\apcupsd. Uncheck the box to edit the client configuration file (apcupsd.conf). On the next screen, keep the box checked next to Install Apcupsd as a Service and uncheck the box next to Start Apcupsd now. Next, you will get a message that says the apcupsd service has been successfully installed.
Register service
Keep the box checked to Install the icon in the System Tray. Next, you will get a message that says the apctray has been successfully installed.
Apctray option
The apcupsd service and the apctray application have been successfully installed. 4 - Service configuration We need to make a change in the registry to the apcupsd service so that it will kill the power to the UPS after the computer has been shut down. Open the registry editor by typing the following at the Run button on the Start Menu. regedit Navigate to the following area and change the ImagePath entry to end in -p. HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Apcupsd
Killpower option
Set it so that the apcupsd service will start when the system starts up. Open the services management console by typing the following at the Run button on the Start Menu. services.msc Set the Apcupsd UPS Monitor service to have it's startup type to be Automatic.
Service starts at boot
You can modify the apccontrol script to send email notifications for different UPS events. The apccontrol script is the following file. C:\Program Files\apcupsd\etc\apcupsd\apccontrol.bat Navigate to C:\Program Files\apcupsd\etc\apcupsd and make a backup of the apccontrol.bat file. Afterwards, edit the apccontrol.bat file. The configuration file that the apcupsd service will use is the following file. C:\Program Files\apcupsd\etc\apcupsd\apcupsd.conf You can create your own configuration file. Here is a simple example. This uses an APC UPS 940-0095A serial cable. ## apcupsd.conf v1.1 ## UPSCABLE 940-0095A UPSTYPE apcsmart DEVICE COM1 UPSCLASS standalone UPSMODE disable Navigate to C:\Program Files\apcupsd\etc\apcupsd and make a backup of the apcupsd.conf file. Afterwards, edit the apcupsd.conf file. Open a command prompt and start the apcupsd service.
Start up service
The service has successfully started. Also, you will now see the apctray icon in the lower right-hand corner of the screen near where the time is displayed.
Apctray status
5 - Apcaccess example This command prints the UPS model number, software version, status, load percentage, battery charge and other information.
Apcaccess information
6 - Apctray example You can view the apcaccess information graphically by right-clicking on the apctray icon and selecting Status.
Apctray information
7 - Service check Reboot your computer. Log in like normal and check to see that the apcupsd service is running. Open the services management console by typing the following at the Run button on the Start Menu. services.msc Check to make sure that the apcupsd service has started.
Service check
That's it, now you have apcupsd running in Windows.

Last modified: Thu Jan 1 00:00:00 1970 UTC
Packetwatch Research 2002-2017.