Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-user:services:ups:software.nut [2018/12/12 07:07] – [Pre 18.06] moved old issues to old notes cshoredanieldocs:guide-user:services:ups:software.nut [2018/12/12 08:01] – [Post 18.06.2 / Commmit c95a1d3 on openwrt-18.06 / Commit f48b060 on master] better title cshoredaniel
Line 8: Line 8:
 NUT was updated with more UCI in commit [[https://github.com/openwrt/packages/commit/a23c4e85c5f6c9f9dcf67743b93c492ba833e365|a23c4e85]], which appears in the 18.06 release. NUT was updated with more UCI in commit [[https://github.com/openwrt/packages/commit/a23c4e85c5f6c9f9dcf67743b93c492ba833e365|a23c4e85]], which appears in the 18.06 release.
  
-===== 18.06 / Commit a23c4e85 =====+===== 18.06 and beyond =====
  
 <color #ed1c24>NOTE: configuration has **changed**</color>:  It's now all done through UCI (see below) (and the UCI is changed). <color #ed1c24>NOTE: configuration has **changed**</color>:  It's now all done through UCI (see below) (and the UCI is changed).
  
 +
 +<WRAP center round tip 60%>
 If you wish to use a 'standard' NUT config just remove the symlinks in /etc/nut and replace them with regular NUT configuration files. If you wish to use a 'standard' NUT config just remove the symlinks in /etc/nut and replace them with regular NUT configuration files.
 +</WRAP>
 +==== 18.06 / Commit a23c4e85 ====
  
 <WRAP center round alert 60%> <WRAP center round alert 60%>
-Due to changes in procd (or the OpenWrt shell wrapper around starting and stopping services with procd) stopping/restarting NUT stopped working properly.  Work is underway to remedy this.  Unfortunately issues were not reported before the 18.06 release, so it's not clear which (if any) point release will get the full set of fixes.  Note that #6966 fixes most of the issues but there are some nits remaining.+Due to changes in procd (or the OpenWrt shell wrapper around starting and stopping services with procd) stopping/restarting NUT stopped working properly.  Work is underway to remedy this.  Unfortunately issues were not reported before the 18.06 release.  18.06.1 has fixes for the most troublesome of the issues, and 18.06.2 should resolve the rest. 
 + 
 +[[https://github.com/openwrt/packages/pull/7638|PR #7638]] / [[https://github.com/openwrt/packages/commit/c95a1d3da89cb62eacc1d8217b861b36194d8838|Commmit c95a1d3]] Resolves these issues in the 18.06 branch. 
 +This should be in the next 18.06.x point release (18.06.2). 
 + 
 +See <del>[[https://github.com/openwrt/packages/pull/6897|PR #6987]], [[https://github.com/openwrt/packages/issues/6997|Issue #6997]], [[https://github.com/openwrt/packages/issues/6966|Issue #6966]], and [[https://github.com/openwrt/packages/issues/6843|Issue #6843]]</del> 
 +</WRAP> 
 + 
 +==== Commit f48b060 on master ==== 
 + 
 +<WRAP center round important 60%> 
 +With [[https://github.com/openwrt/packages/commit/f48b060fa752fdf6556080dc1af221363f9b1ef4|Commit f48b060 on master]] all known issues are resolved. 
 + 
 +</WRAP> 
 + 
 +<WRAP center round important 60%> 
 + 
 + 
 +[[https://github.com/openwrt/packages/pull/7167/commits/8ff6a83a541b114437eab170a0760c1c04263aa2|Commit 8ff6a83]] adds building of serial drivers by default. 
 + 
 +[[https://github.com/openwrt/packages/pull/7167/commits/daa974cff0bef94c71277e703c32b3fd36f1411b|Commit daa974c]] completes the USB UPS hotplugging in which a USB UPS driver can be run as non-root and the USB device will be given the right permissions.
  
-See [[https://github.com/openwrt/packages/pull/6897|PR #6987]], [[https://github.com/openwrt/packages/issues/6997|Issue #6997]], [[https://github.com/openwrt/packages/issues/6966|Issue #6966]], and [[https://github.com/openwrt/packages/issues/6843|Issue #6843]]+[[https://github.com/openwrt/packages/pull/7592/commits/a5d06ce1106644b26a1b9d0ad87220d772d6b862|Commit a5d06ce]] adds hotplug support for serial UPSes when using a standare serial-to-USB cable.
 </WRAP> </WRAP>
  
Line 135: Line 159:
 === config driver_global === === config driver_global ===
  
-**WIP**: Commit TBA+<WRAP center round important 60%> 
 +[[https://github.com/openwrt/packages/commit/44e57d4bdfe93214e9c031f181533bb0e4ef25ca|Commit 44e57d4]] (adds the following variables) and [[https://github.com/openwrt/packages/commit/f48b060fa752fdf6556080dc1af221363f9b1ef4| Commit f48b060]] (fixes synchronous setting) 
 +</WRAP>
  
 ^ Option           ^ Type           ^ Required ^ Default      ^ Description    ^ ^ Option           ^ Type           ^ Required ^ Default      ^ Description    ^
Line 185: Line 211:
 ^ notransferoids   | boolean        | no       | false        | Disable the monitoring of the low and high voltage transfer OIDs in the hardware. This will remove input.transfer.low and input.transfer.high from the list of variables. This should only be used on APCC Symmetra equipment which has strangeness in the three-phase power reporting. | ^ notransferoids   | boolean        | no       | false        | Disable the monitoring of the low and high voltage transfer OIDs in the hardware. This will remove input.transfer.low and input.transfer.high from the list of variables. This should only be used on APCC Symmetra equipment which has strangeness in the three-phase power reporting. |
  
-**WIP**: Additional parameters: Commit TBA+<WRAP center round important 60%> 
 +[[https://github.com/openwrt/packages/commit/44e57d4bdfe93214e9c031f181533bb0e4ef25ca|Commit 44e57d4]] (adds the following variables) 
 +</WRAP> 
  
 ^ Option           ^ Type            ^ Required                ^ Default      ^ Description    ^ ^ Option           ^ Type            ^ Required                ^ Default      ^ Description    ^
-^ synchronous      | yes or not      | no                      |    no        | Whether UPS must read all data from UPS before getting new data |+^ synchronous      | yes or no       | no                      |    no        | Whether UPS must read all data from UPS before getting new data |
 ^ maxstartdelay    | integer         | no                      |    45        | How long NUT waits for driver to start before giving up | ^ maxstartdelay    | integer         | no                      |    45        | How long NUT waits for driver to start before giving up |
 ^ retrydelay       | integer         | no                      |            | How long NUT waits to retry starting driver | ^ retrydelay       | integer         | no                      |            | How long NUT waits to retry starting driver |
Line 197: Line 226:
  
 config override 'override_[variable_name]' config override 'override_[variable_name]'
- 
-**WIP**: Commit TBA 
  
 e.g. ''config override 'override_battery_charge_low''' creates ups.conf entry for ''override.battery.charge.low = '' e.g. ''config override 'override_battery_charge_low''' creates ups.conf entry for ''override.battery.charge.low = ''
Line 206: Line 233:
  
 config default 'default_[variable_name]' config default 'default_[variable_name]'
- 
-**WIP**: Commit TBA 
  
 e.g. ''config default 'default_battery_charge_low''' creates ups.conf entry for ''default.battery.charge.low = '' e.g. ''config default 'default_battery_charge_low''' creates ups.conf entry for ''default.battery.charge.low = ''
Line 214: Line 239:
  
 config override 'other_[parameter]' config override 'other_[parameter]'
- 
-**WIP**: Commit TBA 
  
 e.g. ''config other 'other_parameter''' creates ups.conf entry for ''parameter = '' e.g. ''config other 'other_parameter''' creates ups.conf entry for ''parameter = ''
Line 222: Line 245:
 ^ value            | varies         | yes                     | //none//      | A way to handle currently unknown (to UCI) parameters | ^ value            | varies         | yes                     | //none//      | A way to handle currently unknown (to UCI) parameters |
  
-config override 'otherflag_[paramter]' +config override 'otherflag_[parameter]'
- +
-**WIP**: Commit TBA+
  
 e.g. ''config override 'otherflag_extraflag''' creates ups.conf entry for ''extraflag'' e.g. ''config override 'otherflag_extraflag''' creates ups.conf entry for ''extraflag''
  • Last modified: 2019/08/31 07:08
  • by tmomas