Upgrade notes

The upgrade notes only describe necessary changes that you might need to make to your setup in order to use a new role release. Refer to the Changelog for more details about what has changed.

Upgrade from v0.1.X to v0.2.X

All inventory variables have been renamed so you might need to update your inventory. This script can come in handy to update a subset of variable names:

#!/bin/bash
## Upgrade inventory variables for migration from ypid.epoptes v0.1.X to v0.2.X.
## The script is idempotent.

git ls-files -z "$(git rev-parse --show-toplevel)" | xargs --null -I '{}' find '{}' -type f -print0 \
 | xargs --null sed --in-place --regexp-extended '
     s/linuxmuster_net_server_epoptes_/epoptes__/g;
     s/epoptes__room_definition/epoptes__rooms/g;
     s/linuxmuster_net_display_manager/epoptes__enforce_dm/g;
     s/epoptes__via_postsync_image_name/epoptes__postsync_image_name/g;
   '

The script is bundled with this role under ./docs/scripts/upgrade-from-v0.1.X-to-v0.2.X and can be invoked from there.

Note that you will need to update your inventory manually according to the documentation. The epoptes__rooms variable has been changed from a list to a dictionary which you might need to update manually in your inventory.