The UPSD module monitors an APCC Smart UPS for power and emergency events. The module displays a real time summary page of information about the UPS, its status and the current power line input details. Also displayed is a logfile showing all the power events that have been recorded.
A spare serial port is necessary for the APCC data cable.
UPSD can be set to shutdown the computer during a power outage event when the runtime remaining on the battery drops below a certain threshold. Note: access to the Super User (root) account is necessary to set this up.
The module is also tuneable and configurable to match the environment that it is monitoring.
The following parameters can be set on either the initial load of the UPSD module or optionally at a later stage with the configuration page.
| -c | This option loads the UPSD module configuration page into the /upsd/config.html url allowing anyone to configure or reconfigure the module. Note: it is more secure to configure the module on its initial load and not to select this option. |
|---|---|
| -l | This option links the UPSD configuration page to the index or home page. This allows quick access of the configuration page and the modules parameters. Note: this option depends on the -c option being selected. |
| -p port | This specifies the serial port of the computer to which the UPS is attached to via the data cable. For Solaris this port is /dev/cua/? and for Linux can be /dev/ttyS? |
| -s script | Defines the shutdown script to be executed when the UPS drops below the runtime threshold set. This script must be contained in a directory which is in the search PATH variable. |
| -n name | Defines the 8 character name that the UPS is known by. |
| -S | This option turns on the safety mode of the UPSD module. When this mode is enabled the shutdown script will not be executed although plenty of log messages will be issued. This mode is useful for testing that the configuration is Ok. |
| -t threshold | Specifies the runtime left shutdown threshold. When the amount of runtime left falls below this threshold the UPSD module will execute the shutdown script as defined by the -s option. |
| -a interval | Specifies the time between carrying out a aliveness/status check of the UPS. |
| -i interval | Specifies the time between obtaining status information about the UPS and the power line input data. |
| -r refresh | This option specifies the number of seconds between client browser refreshes. |
| -z log size | This option specifies the number of entries displayed in the log contained on the index or home page. |
This software is compatible with (and has been tested on) the APCC Smart UPS series. More information can be found about APCC here and in specifically about the Smart UPS here.
Here are some other links associated with monitoring an APCC UPS.
Copyright © 2000 Tortuga Technologies Pty Ltd. All rights reserved.
last updated 18-February-2000