openhab/openhab-distro 2.3.0

openHAB 2.3.0

on GitHub

This is the official release of openHAB 2.3.0.

The binaries are available on Bintray and via "Stable" on our APT repository.

New and Noteworthy

The openHAB 2.3 release contains many new features, enhancements and bug fixes, both for the core runtime and for many add-ons.
You can find the most relevant ones listed in detail below.

Quick links:

• Notes about the Core runtime
• Notes about the Add-ons
• Upgrade Process for openHABian, APT, RPM, Manual Installations
• Breaking Changes that require manual interaction after the upgrade.

Relevant Changes

New Addons

The following add-ons are newly introduced with the 2.3 release:

2.x Core

2.x Addons

User Interfaces

1.x Addons

Upgrade Process

openHABian

If you are working with an openHABian setup, the upgrade is quite easy. Regardless of if you are currently using the openHAB 2.2 stable release or one of the latest 2.3 SNAPSHOT builds, switching to openHAB 2.3.0 stable is done in just a few steps:

1. Connect to the SSH command line and execute: sudo openhabian-config
2. Select the "Update" option
3. Wait for the openHABian update to finish, reenter the openHABian configuration tool
4. Select the "openHAB 2.3.0 stable" option

Package-based Installations

For package based installations, you may be asked to replace some configuration files in /var/lib/openhab2. For best results select yes at each of these prompts. Old configurations can be found in the same place, but with dpkg-old appended to it.

APT

Make sure that openHAB is sourced from the latest location, has the correct GPG signing key and that your system can download .deb packages via HTTPS by following the instructions for a stable installation in the docs.

If the above is correct, simply upgrade by using:

sudo apt-get update
sudo apt-get upgrade

Alternatively, you can force apt to install 2.3.0 and it's optional addons with:

sudo apt-get install openhab2=2.3.0-1

## optional addons for offline installation ##
sudo apt-get install openhab2-addons=2.3.0-1
sudo apt-get install openhab2-addons-legacy=2.3.0-1

RPM

openHAB is also distributed in RPM packages. To use them, make sure that openHAB is sourced from the latest location, and has the correct GPG signing key for verification by following the stable installation instructions outlined in the docs.

If the above is correct, then simply upgrade using your systems package manager (yum, dnf, etc.)

sudo yum update

Alternatively, you can force apt to install 2.3.0 and its optional addons with:

sudo yum install openhab2-2.3.0

## optional addons for offline installation ##
sudo yum install openhab2-addons-2.3.0
sudo yum install openhab2-addons-legacy-2.3.0

Manual Installations

Offical update scripts are available that let you update your 2.2 installation to version 2.3:

Linux/MacOS

1. Change to your openHAB root directory (e.g. cd /opt/openhab2)

2. If you are upgrading from a version after and including 2.2.0, then simply run the command:

sudo ./runtime/bin/update 2.3.0

1. If you are upgrading from a version before 2.1.0, you can download and run the update script in one command using:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/openhab/openhab-distro/2.3.0/distributions/openhab/src/main/resources/bin/update)" -- 2.3.0

Windows

To start the update process, run PowerShell as an administrator and use the following commands. Assuming you have openHAB saved in C:\openHAB:

cd C:\openHAB
. .\runtime\bin\update.ps1
Update-openHAB -OHVersion 2.3.0

Now that openHAB has updated, you only need to run the above commands again for future versions.

Breaking Changes that Require Manual Interaction after the Upgrade

Chart settings

The path to the chart settings was updated from org.eclipse.smarthome.ui.chart to org.eclipse.smarthome.chart.

AVM Fritz Binding

The FRITZ_Powerline_546E_Solo is no longer a thing-type. It now is a bridge-type. This can lead to errors after an upgrade when using an existing FRITZ_Powerline_546E_Solo device. It has to be removed and added again to work properly (see here).

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.

Netatmo Binding

The Netatmo binding is now using the new unit of measurement system allowing easy unit conversions. Item types have to be updated like for example replacing Numberby Number:Temperature for the temperature channnels. An update of the rules based on these items could be necessary too.

The following channels were removed: BoilerOn, BoilerOff, Unit, WindUnit and PressureUnit.

Oceanic Binding

The softener Thing Type does no longer exist and is replaced by the serial and ethernet Thing Types.

Weather Underground Binding

The Weather Underground binding is now using the new unit of measurement system allowing easy unit conversions. Item types have to be updated like for example replacing Number by Number:Temperature for the temperature channnels. An update of the rules based on these items could be necessary too.

Yamaha Receiver Binding

The configuration parameter names now use lower camel case convention. Change 'HOST' to 'host', 'PORT' to 'port' etc.