Possible small error in documentation for updating openHAB on Windows

Samir.E · November 18, 2018, 9:16am

Hi all,
don’t know where to comment on a small documentation issue that I stumbled upon, I hope this is the fairly correct place to do it.

When updating openHAB (in my case from 2.1 to 2.3) there are instructions on how to do it:

Under “Updating the openHAB Runtime” there are a number of files that should be deleted before updating, This because the new version of the files needs to be used and when copying files you are NOT supposed to overwrite any files (according to the documentation). But there is one file missing that also should be deleted = updated, at least that is how I solved my problem with no logs after the update (I replaced it with the new one):

userdata\etc\org.ops4j.pax.logging.cfg

Since it is important that this file is updated I guess it would be a good idea to have that file also in the list of files to be deleted = files that will be updated (since you are not supposed to overwrite when updating).

Please correct me if I am wrong, just thought this would be a good idea to add since it took me some time to find out what was going on with my non existing logs after the update.

One of the posts I read to find this out was this one:

but since it still is “wrong” in the documentation I thought I would make sense to write a small post of this.

vzorglub · November 18, 2018, 9:18am

@Samir.E

You can edit the docs yourself by following this link: https://github.com/openhab/openhab-docs/edit/master/installation/windows.md

The link is located at the bottom of the page in the docs

sihui · November 18, 2018, 10:47am

There are two other chances to catch those important updates:

Watch the update script for Linux distros:

github.com

openhab/openhab-distro/blob/main/distributions/openhab/src/main/resources/bin/update.lst

[[MSG]]
[2.2.0]
NOTE;Logging configuration has changed. 'org.ops4j.pax.logging.cfg' has been backed up and restored to defaults!
NOTE;*.rules files are now validated upon startup. Files with errors will from now on be logged and ignored by the runtime.

[2.3.0]
ALERT;Nest Binding: The 'camera' Thing Type now has channel groups. Add 'camera#' before the channel ID in the channel UID of existing camera channels. The 'time_to_target_mins' channel of the 'thermostat' Thing Type is renamed to 'time_to_target'
ALERT;Oceanic Binding: The 'softener' Thing Type no longer exists and is replaced by the 'serial' and 'ethernet' Thing Types
ALERT;Yamaha Receiver Binding: The configuration parameter names now use lower camel case convention. Change 'HOST' to 'host', 'PORT' to 'port' etc

[2.4.0]
ALERT;Astro Binding: The 'kilometer' and 'miles' channels have been replaced by a new 'distance' channel
ALERT;Jeelink Binding: The 'currentWatt' and 'maxWatt' channels have been replaced with 'currentPower' and 'maxPower' channels
ALERT;WeatherUnderground Binding: A bridge has been added on top of the current things, you need to add a bridge containing your api-key.
ALERT;ZWave Binding: Major changes have been merged to support features such as security. All things must be deleted and re-added. Refer to https://community.openhab.org/t/zwave-binding-updates/51080 for further information.
ALERT;Synop Binding is now using UoM. 'wind-speed-ms' and 'wind-speed-knots' channels have been replaced by a single 'wind-speed' channel.
ALERT;Amazonechocontrol Binding: The account thing does not have settings anymore. You have to login at amazon once again through the proxy server http(s)://<YourOpenHAB>/amazonechocontrol
ALERT;Milight Binding: The various available bulb types do not appear in the Paper UI Inbox anymore. The correct bulb need to be added manually. The bulb "zone" is now a configuration. Bulb Things need to be recreated to apply this change.
ALERT;Hue emulation: The item to hue ID mapping is no longer stored in files, but in the openHAB storage service. You need to rediscover "devices" in all services that use the hue emulation (Amazon Echo, Google Home, etc).

This file has been truncated. show original

[[MSG]]

[2.2.0]

NOTE;Logging configuration has changed. 'org.ops4j.pax.logging.cfg' has been backed up and restored to defaults!

Subscribing to the Announcement section:

The links refer to
Release openHAB 2.2.0 · openhab/openhab-distro · GitHub and from there the breaking changes:

The logging framework has been upgraded to log4j2, which results in a different format of the logger configuration. So in case you have done changes to the org.ops4j.pax.logging.cfg file, please re-apply those to the new version in the log4j2 format. For an example configuration, see [this community post](https://community.openhab.org/t/log4j2-sample-config/33284).