Upgrading Software

Upgrade existing omnipy installation

Each new release of omnipy will require both Android APS and the omnipy software to be updated. The latest versions can be found in the master branch of omnipy and omnipod-master branch of AndroidAPS at the following locations:

https://github.com/winemug/omnipy
https://github.com/winemug/AndroidAPS

Backing up previous omnipy installation

We recommend to backup the current setup before upgrading to another one.

To do this, start by using ssh to connect to your raspberry pi.

Then to backup with today's date (replace the YYYYMMDD by your date):

cd ~
tar -cvzf omnipy_backup_YYYYMMDD.tar.gz omnipy

(Note if you need to restore the backup in future then:

cd ~
mv omnipy omnipy_revert
tar -xvzf omnipi_backup_YYYYMMDD.tar.gz
sudo reboot

)

Once the backup is done, you can proceed to the omnipy update as follows.

Upgrading omnipy

Type the following to update to the latest repository version.

cd ~/omnipy
git stash
git pull

(Note that if you want to use a different branch, eg dev, then you would need this to be:

cd omnipy
git checkout dev
git pull

)

Then type the following to start the upgrade: bash ~/omnipy/scripts/pi-update.sh

Unless you want to perform some of the steps in the installation script again, you can answer 'n' to all five questions and then the script will reinstall the necessary service files for the updated software to start working again:

Welcome to omnipy update script
This script will let you reconfigure omnipy as in the setup script
Do you want update to the latest version in the github repository? n

Do you want reinstall the dependencies? n

Do you want reconfigure the API password? n
Do you want test the RileyLink? n
Do you want reconfigure bluetooth personal area network? n

Updating service scripts and restarting services
Warning: omnipy.service changed on disk. Run 'systemctl daemon-reload' to reload units.
Warning: omnipy-beacon.service changed on disk. Run 'systemctl daemon-reload' to reload units.

Configuration updated.

After this, if you have an active pod, you will have to reconfigure it as described in the pod setup link.

Upgrading AAPS

Follow the instructions in Android APS setup - Step 2 to re-create the APK file (make sure you update your local repository with a "pull" first), copy it over to your android device and perform the installation. Android will update the existing installation and you won't need to reconfigure the AndroidAPS application. (Note for further information on upgrading AndroidAPS please see https://androidaps.readthedocs.io/en/latest/EN/Installing-AndroidAPS/Update-to-new-version.html).