Post any comments, questions, or issues with APCUPSD Plug-in for HS3 in this Forum. The APCUPSD allows HS3 to monitor mutiple APC UPS devices. Each monitored UPS device must be running apcupsd (http://www.apcupsd.org) or NUT (http://www.networkupstools.org). The plugin will communicate with apcupsd via a TCP/IP connection. The primary features:
The plug-in is available from the HS3 updater.
Compatibility
This plugin requires HS3 Version 3.0.0.68 or higher.
Version History
Version 3.3.2.2 (Beta)
Version 3.3.1.1 (Beta)
Version 3.3.1.0 (Beta)
Version 3.3.0.0
Version 3.2.0.4
Version 3.2.0.3
Version 3.2.0.2
Version 3.2.0.1
Version 3.2.0.0
Version 3.0.6.3
Version 3.0.6.2
Version 3.0.6.1
Version 3.0.6.0
Version 3.0.5.0
Version 3.0.4.4
- Monitors local UPS or UPS attached to remote computers
- Retrieves UPS information from multiple APCUPSD or NUT drivers running on target computers
- HS3 devices for each monitored UPS
- Event triggers
- Event actions
- Trend chart of power line voltage, load and battery charge
The plug-in is available from the HS3 updater.
Compatibility
This plugin requires HS3 Version 3.0.0.68 or higher.
Version History
Version 3.3.2.2 (Beta)
- Removed the hyperlink in the UPS device name due to issues in HS4. To rebuild the device status pairs after upgrading to this version, shutdown the plugin, edit the hspi_apcupsd.ini file (in the config sub-directory of the HS3 or HS4 installation) to remove the line that starts with "gIconSet=", save the ini file and start the plugin
- Documentation update and small internal improvement.
- Upon plugin start, do not set values for HS3 devices: last transfer reason, last on battery, last off battery, time on battery, total time on battery, and number of transfers.
- Added optional Energy API / Database support for new "Watts" HS3 device per device. If enabled entries are added to the Energy Database on a selected interval. See PDF documentation of additional details.
Version 3.3.1.1 (Beta)
- Added additional "Watts" HS3 device per UPS displaying the calculated current consumed watts.
- Added configuration properties per UPS to set the default nominal line voltage and nominal power. These default values are used in the Watts calculation for UPS configurations when these values are not provided by the APCUPSD or NUT (i.e. not available for the type of UPS).
Version 3.3.1.0 (Beta)
- Parsing updated for NUT status related to detect and update HS3 UPS Status device setting when the low battery information is sent to the plugin for certain NUT drivers.
- HS3 Status Flag device value now contains the numeric value of all flags
- Added two new triggers when specific flags are set or reset in HS3 Status Flag device.
Version 3.3.0.0
- Added Linux / Debian support. This version is available in Beta section of the Updater.
Version 3.2.0.4
- Fix status update if master/slave setup is used.
Version 3.2.0.3
- Parsing of time left for foreign countries (apcupsd includes a dot while locale for decimal separator is different)
- Fix conversion of default 60 seconds for interval to double (string in code was 60.0 while locale for decimal is not dot
Version 3.2.0.2
- Fixed resetting device values upon shutdown
Version 3.2.0.1
- Release version of 3.2.0.0 beta version.
Version 3.2.0.0
- New contemporary icons. Current icon selection for the plugin will follow the "Status Icon Set" selection in the HS3 setup. Note that the plug-in image directory (..html\images\apcupsd\*) is purged during installation to reorganize icons and support multiple sets. Icon selection is update when plugin starts and the selection made in HS3 changed compared to when the plugin started last time.
- Plug-in exe file name and assembly casing name changed (with migration code to support existing triggers/actions/devices)
- workaround for bug 2760 (http://bugzilla.homeseer.com/bugzill...ug.cgi?id=2760)
- Changed device value display string of UPS name device to include host, port and NUT UPS name
- Fixed monitoring NUT UPS upon startup
- Fixed device value of Time Left HS3 device (was always zero in latest version due to a regression)
- Removing additional entries added to Event list (debugging in prior version)
- When monitoring via NUT added UPS configuration to select NUT UPS
- Added support for NUT in addition to APCUPSD. This enables monitoring UPS setups using NUT instead of APCUPSD, though NUT typically only sends a subset of the the settings available from APCUPSD. NAS devices seem to often use NUT.
- Enable specifying UPS host by IP address instead of hostname
- Plugin logs now go to Logs folder of HS3 installation
- For some HS3 device updating string instead of AdditionalData to decrease HSTouch plugin overhead
- Only update the Additional data for devices that use if it changed (Alarms for example)
- Fixes parsing of apcupsd numeric values not usng the Local while the plugin / computer is using the country Locale.
- Test version support parsing of apcupsd numeric values not usng the Local while the plugin / computer is using the country Locale.
- Internal code updates / refactoring
- Internal fixes related to cleanup
- Fixed installer / updater issue
Version 3.0.6.3
- Revised default Device Type strings
Version 3.0.6.2
- Added logging when parsing APCUPSD data stream
Version 3.0.6.1
- Fixes log debugging flag not saved correctly to ini file
- Calling UnRegisterAllLinks upon shutdown
- Fixed firing triggers upon certain conditions especially when events are cloned
Version 3.0.6.0
- HS3 UPS devices values storing a UPS time stamp (for example start time, last update time, last on battery) are set as the Unix timestamp
- HS3 UPS device values storing a UPS duration (for example time left, time on battery) are set as the converted value in units of seconds
Version 3.0.5.0
- Changed device configuration so that they can trigger events based on status change
Version 3.0.4.4
- Initial version to updater
Comment