Upgrading instructions to super clarify Python 3 upgrade.

This commit is contained in:
Dan Helfman 2017-07-22 20:52:29 -07:00
parent 8bfffd8cf7
commit 919d7573c3

View file

@ -65,7 +65,7 @@ To install borgmatic, run the following command to download and install it:
sudo pip install --upgrade borgmatic sudo pip install --upgrade borgmatic
Make sure you're using Python 3, as borgmatic does not support Python 2. (You Make sure you're using Python 3, as borgmatic does not support Python 2. (You
may have to use "pip3" instead of "pip".) may have to use "pip3" or similar instead of "pip".)
Then, generate a sample configuration file: Then, generate a sample configuration file:
@ -84,8 +84,12 @@ following:
sudo pip install --upgrade borgmatic sudo pip install --upgrade borgmatic
(You may have to use "pip3" or similar instead of "pip", so Python 3 gets
used.)
However, see below about special cases. However, see below about special cases.
### Upgrading from borgmatic 1.0.x ### Upgrading from borgmatic 1.0.x
borgmatic changed its configuration file format in version 1.1.0 from borgmatic changed its configuration file format in version 1.1.0 from
@ -93,9 +97,22 @@ INI-style to YAML. This better supports validation, and has a more natural way
to express lists of values. To upgrade your existing configuration, first to express lists of values. To upgrade your existing configuration, first
upgrade to the new version of borgmatic: upgrade to the new version of borgmatic:
As of version 1.1.0, borgmatic no longer supports Python 2. If you were
already running borgmatic with Python 3, then you can simply upgrade borgmatic
in-place:
sudo pip install --upgrade borgmatic sudo pip install --upgrade borgmatic
Then, run: But if you were running borgmatic with Python 2, uninstall and reinstall instead:
sudo pip uninstall borgmatic
sudo pip3 install borgmatic
The pip binary names for different versions of Python can differ, so the above
commands may need some tweaking to work on your machine.
Once borgmatic is upgraded, run:
sudo upgrade-borgmatic-config sudo upgrade-borgmatic-config