Upgrade Guide

When a version upgrade requires specific steps, it will be documented below.

Upgrading to v3+ from v2

The release can be found here

Breaking Changes

Python 3.7 or higher is now required. Active support ended June 2020 and security updates stopped in June 2023.

WeeWX 4 or higher is required. Support for Python 3 was introduced in WeeWX 4 in April 2020.

MQTTSubscribe now validates the MQTTSubscribe configuration on startup and the default behavior is to stop on any errors. Ideally this would have been in release 1. If false errors are reported, or if for some reason one to run MQTTSubscribe anyway, setting stop_on_validation_errors=false will only log the errors.

Upgrade Steps

While one could use weectl (or even just copy the new MQTTSubscribe.py), it is recommended that these steps be followed. Following the steps include running MQTTSubscribe in configuration mode to validate the configuration prior to restarting WeeWX. If any errors are found, they can be corrected or stop_on_validation_errors can be set to false.