This repository is under constant development, and as such there will be regular feature additions and bug-fixes. Also make sure to read the release notes for each update, as they may include special commands you need to run.
Docker Install
To update a docker-based auto_rx installation, refer to the docker guide here: https://github.com/projecthorus/radiosonde_auto_rx/wiki/Docker#pulling-the-latest-version-of-the-container
Native Install
For a 'native' install, use the following instructions.
Before updating, stop the auto_rx service by running:
$ sudo systemctl stop auto_rx
In many cases, you will be able to update by simply performing (in the radiosonde_auto_rx directory):
$ git pull
If you are given a warning along the lines of your local changes to the following files would be overwritten, then you've made some kind of change to the version-controlled parts of auto_rx. If you wish to keep the changes, then copy out the listed files somewhere else. Then, to revert the auto_rx files back to their version-controlled versions, run git stash, and then re-run git pull.
Then you should re-build the decoder binaries by running:
$ cd auto_rx
$ ./build.sh
New features will likely involve changes or additions to the configuration file. The Configuration File Change-log also provides information on what settings have been added/changed for each release.
Once all the updates have been performed, restart the auto_rx service using:
$ sudo systemctl restart auto_rx
Upgrading a station from Python 2 to Python 3
If your station has been operating using Python 2 for years, and has now broken with recent updates (e.g. ImportError: cannot import name JSONDecodeError), then it's time to update your station to run using Python 3.
You can either start from scratch with a fresh Raspbian install (and if you are running an old version of Raspbian e.g. stretch, this is a very good idea...), or you should be able to get the required Python 3 dependencies by running:
$ sudo apt-get install python3 python3-numpy python3-setuptools python3-crcmod python3-requests python3-dateutil python3-pip python3-flask
$ cd ~/radiosonde_auto_rx/auto_rx/
$ git pull
$ sudo pip3 install -r requirements.txt
You will then need to update the auto_rx systemd service file to reflect the switch from python to python3, which you can do using:
$ sudo cp auto_rx.service /etc/systemd/system/
You may now need to edit the systemd file to include your username, if it is not pi, by running sudo nano /etc/systemd/system/auto_rx.service.
Now, reload the service file by running:
$ sudo systemctl daemon-reload
Now you should be good to restart auto_rx!