diff --git a/Installing-on-OpenBSD.md b/Installing-on-OpenBSD.md index 19d958b..cf356ef 100644 --- a/Installing-on-OpenBSD.md +++ b/Installing-on-OpenBSD.md @@ -114,6 +114,27 @@ Once installed as described above there may come a time when you want to update `# rcctl start radicale3` +# Updates to Python (or to OpenBSD) +Whenever [Python](https://python.org) is updated (which often happens when [OpenBSD](https://openbsd.org) is updated) the [virtual Python environment](https://docs.python.org/3/library/venv.html) does not automatically reflect these changes. Updating the [virtual Python environment](https://docs.python.org/3/library/venv.html) essentially means creating a new one. + +Note: This also updates Radicale to the newest version. + +1. Stop the Radicale service:\ +`# rcctl stop radicale3` +2. [Optional] Make a backup of the existing [virtual Python environment](https://docs.python.org/3/library/venv.html), e.g. by renaming it:\ +`# mv /usr/local/lib/radicale /usr/local/lib/radicale-backup` +3. Recreate the [virtual Python environment](https://docs.python.org/3/library/venv.html) as described [above](#installing-radicale): + - Create a [virtual Python environment](https://docs.python.org/3/library/venv.html) to avoid mixing [pkg_add(1)](https://man.openbsd.org/pkg_add) and [pip](https://pypi.org/project/pip/) managed code:\ +`# python3 -m venv /usr/local/lib/radicale` + - [Optional] Update [pip](https://pypi.org/project/pip/) in the [virtual Python environment](https://docs.python.org/3/library/venv.html) to silence warnings when using [pip](https://pypi.org/project/pip/):\ +`# /usr/local/lib/radicale/bin/pip install --upgrade pip` + - Install Radicale into the [virtual Python environment](https://docs.python.org/3/library/venv.html):\ +`# /usr/local/lib/radicale/bin/pip install radicale` +4. Make any required changes to the configuration if the new version of Radicale requires any changes. +5. Start the Radicale service:\ +`# rcctl start radicale3` +6. [Optional] Remove the backup created in step 2 when everything is working as expected. + # Other Check which version of Radicale is installed:\