How to update oref0 on your OpenAPS rig in the future

You’ve probably heard about all kinds of cool new features that you want to try. If they’re part of the master branch already, you just need to go enable them (usually by re-running the oref0-setup script). You can see notes about what is included in a particular release in the release notes page for oref0.

However, if it’s a brand-new feature that’s being tested or is recently added to master, you’ll need to install the new version of oref0 first. By the way, if you want to check which version of oref0 you are currently running, npm list -g oref0 and if you want to check which branch cd ~/src/oref0 and then git branch.

If you want to view the commit records between the version you are running and the new version (click here):

  1. cd ~/src/oref0
  2. git fetch will update the local git repository. This does not change anything in your working directory
  3. git status will tell you which branch your working directory is on and how many commits your working directory is behind
  4. git log origin/master (replace master with the branch you are on) will print the commit descriptions. You only need to review the number of log messages corresponding to the number of commits your working directory is behind.
  5. git diff origin/master.. (replace master with the branch you are on) will print the individual file differences between your working copy and the new version.

Step 1 (Master): Install the new version

  1. cd ~/src/oref0 && git checkout master && git pull && sudo npm install -g oref0

(If you get a message that you need to commit or stash, use command git stash)

Trouble Shooting Installing Master: If installing Master fails with something like:

   File "/usr/local/lib/python2.7/dist-packages/parsedatetime/pdt_locales/", line 56, in get_icu 
    result['icu'] = icu = pyicu.Locale(locale) 
AttributeError: 'module' object has no attribute 'Locale

then run pip install parsedatetime==2.5 and then rerun

Alternative Step 1a (Dev): To get on “dev” branch to test even more recently added new stuff

Or, if the feature you want hasn’t been released yet, and you want to test the latest untested development version of oref0, run:

  1. cd ~/src/oref0 && git checkout dev && git pull
  2. npm run global-install

Step 2: Re-run oref0-setup

Now that you’ve updated your oref0 version, you will want to run the oref0-setup script (cd && ~/src/oref0/bin/ again. See this section for a guide of what the setup script will be prompting you to enter.

Step 3: Remember to set your preferences!

Reminder! You’ll need to re-set your preferences in preferences.json. See the preferences page to see what preferences might have changed or become available since your last update.

To edit any of your preferences, you can enter edit-pref (as a shortcut) or cd ~/myopenaps && nano preferences.json

How to update Linux on your OpenAPS rig in the future

Along with updating the OpenAPS software on your rig, you will also want to periodically update your operating system. This isn’t the place for a primer on Linux Commands, but the following two are useful to keep your system updated and as secure as they can be from recently-found bugs:

# apt-get update
# apt-get upgrade

The first fetches all of the updated package lists for your system, and the second upgrades all of your installed packages to their most current versions.