Page tree
Skip to end of metadata
Go to start of metadata

Relevant version(s): 7.10.x

Context

In some situations it might be necessary to perform a rollback to a previous App Suite revision after an update. To be able to do so Open-Xchange provides an archive of all previous App Suite software revisions as package repositories. This archive will be updated with the predecessor of the most recent App Suite revision once it gets released.

Please be aware that previous App Suite revisions may contain security issues. Rolling back to such a revision may introduce already known security vulnerabilities to your system. Please check with the corresponding release notes for the version that you plan to rollback and any more recent ones in https://software.open-xchange.com/products/appsuite/doc/.

The Archive of previous App Suite revisions can be found in https://software.open-xchange.com/COMPONENT/backend/archive/ where COMPONENT represents the individual component that you want to perform a rollback for. Please note that the archive is protected with your Open-Xchange software repository credentials. For rolling back to one of the provided revisions the package repositories of your system needs to be changed by pointing to the archived revisions of OX App Suite.

Please note that there might be dependencies between the different Open-Xchange component revisions which makes it necessary to install dedicated revisions of other components depending on the ones that you plan to rollback. If unsure please check back with Open-Xchange Support first to prevent an unusable system after the rollback.

Example (Debian Bullseye)

If you have installed the lastest available App Suite version and you plan to perform a rollback for the Components backend appsuiteui and usm to a previous revision then the corresponding lines needs to be changed from your package configuration.

Before:

# OX App Suite Backend
# https://oxpedia.org/wiki/index.php?title=AppSuite:Open-Xchange_Installation_Guide_for_Debian_10.0
deb https://software.open-xchange.com/products/appsuite/7.10.6/backend/DebianBuster/ /
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/backend/updates/DebianBuster /


# OX App Suite UI
# https://oxpedia.org/wiki/index.php?title=AppSuite:Open-Xchange_Installation_Guide_for_Debian_10.0
deb https://software.open-xchange.com/products/appsuite/7.10.6/appsuiteui/DebianBuster/ /
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/appsuiteui/updates/DebianBuster /


# USM
# https://www.oxpedia.org/wiki/index.php?title=AppSuite:Connector_for_Business_Mobility_Installation_Guide
deb https://software.open-xchange.com/products/appsuite/7.10.6/usm/DebianBuster/ /
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/usm/updates/DebianBuster/ /

After:

# OX App Suite Backend
# https://oxpedia.org/wiki/index.php?title=AppSuite:Open-Xchange_Installation_Guide_for_Debian_10.0
#deb https://software.open-xchange.com/products/appsuite/7.10.6/backend/DebianBuster/ /
#deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/backend/updates/DebianBuster /
# Rollback to Backend rev8
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/components/backend/archive/7.10.6-rev8/DebianBuster/ /


# OX App Suite UI
# https://oxpedia.org/wiki/index.php?title=AppSuite:Open-Xchange_Installation_Guide_for_Debian_10.0
#deb https://software.open-xchange.com/products/appsuite/7.10.6/appsuiteui/DebianBuster/ /
#deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/appsuiteui/updates/DebianBuster /
# Rollback to App Suite UI rev5
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/components/appsuiteui/archive/7.10.6-rev5/DebianBuster/ /


# USM
# https://www.oxpedia.org/wiki/index.php?title=AppSuite:Connector_for_Business_Mobility_Installation_Guide
#deb https://software.open-xchange.com/products/appsuite/7.10.6/usm/DebianBuster/ /
#deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/products/appsuite/7.10.6/usm/updates/DebianBuster/ /
# Rollback to USM rev1
deb https://[CUSTOMERID:PASSWORD]@software.open-xchange.com/components/usm/archive/7.10.6-rev1/DebianBuster/ /

Additionally you need to pin the archive packages so that they get installed over the old (more recent) ones. You can find more information about Apt Pinning here. A brute force method doing so would be to create a file /etc/apt/preferences.d/open-xchange-rollback containing the following lines:

Package: *
Pin: origin "software.open-xchange.com"
Pin-Priority: 1000

Once the configuration has been adapted as outlined above the archived revision can be installed using:

apt update
apt dist-upgrade

Please remember to undo the package configuration change and the poinning configuration after a successful rollback.