APC UPS control system manual Known Issues with BSD USB, Platforms & Versions

If all there things check out and you still can’t see the UPS, something is more seriously wrong than this manual can cover – find expert help. If you are unable to list USB devices or drivers, you kernel may not be USB-capable and that needs to be fixed. Please check if your kernel has the three patches listed in the <apcupsd-source>/examples directory. Each of the files ends with the name .patch, and at the current writing they are:

linux-2.4.20-killpower.patch linux-2.4.20-USB-reject.patch linux-2.6.0-USB-queue-overflow.patch

For example, RedHat 9 and/or pre-2.4.22 kernels are known to need the linux-2.4.20-USB-reject.patch for APC SmartUPS XL series devices.

There are also a few email files that you can consult in the examples directory for additional information and details.

Finally, check your Kernel Config. You will find more information about it at:

Kernel Config.

KNOWN ISSUES WITH BSD USB

The BSD USB driver for apcupsd is BETA software and has some known issues.

-FreeBSD lockups: Some users have experienced lockups (apcupsd stops responding) on FreeBSD systems. In at least one case this problem was worked around by disabling pthreads (—disable-pthreads flag to configure). The problem seems to be caused by a FreeBSD kernel bug.

-FreeBSD kernel panics if USB cable is unplugged while apcupsd is running. This is another kernel bug and is most easily worked around by not hot- unplugging the UPS while apcupsd is running.

PLATFORMS & VERSIONS

The new (beta) FreeBSD USB driver supports FreeBSD, OpenBSD and NetBSD. (Thanks go to the *BSD developers who kept a nearly identical interface across all three platforms.)

The driver has been tested with the following platform versions:

FreeBSD-5.3 (Primary development platform)

28