Downgrade openBIS to previous version

Installation & maintenance
1

Dear all,

has anyone downgraded their instance back to a previous version and could offer some help on how to do that?
We are currently running 20.10.8 as a multi-group setup.

Best,
Julia

2

Dear Julia, technically upgrade and downgrade of the openBIS instance is a matter to run the desired version with the same database and data store configured. It is matter of organization and how the upgrading procedure and configuration management is planned.
For example in the case of Docker based setup we describe here
https://openbis.readthedocs.io/en/latest/system-documentation/docker/usage.html
The upgrade is to change the “openbis/openbis-app:20.10.7;” to “openbis/openbis-app:20.10.8;” and restart the container and downgrade is to change the “openbis/openbis-app:20.10.8;” to “openbis/openbis-app:20.10.7;”.

In the context of standalone setup our way of organization is to keep the installation with folders with concrete release wher all of them are identically configured.

drwxrwxr-x  4 openbis openbis 4096 Jun 25 12:14 openbis-20.10.6
drwxrwxr-x  4 openbis openbis 4096 Jul  1 13:17 openbis-20.10.7
drwxrwxr-x  4 openbis openbis 4096 Jul  5 12:11 openbis-20.10.8
drwxrwxr-x  4 openbis openbis 4096 Jul 24 12:26 openbis-20.10.9

and upgrade/downgrade is the matter of which one is running. The simplest method of activating which one is active is for example by symlink.

lrwxrwxrwx  1 openbis openbis   41 Jul 25 10:32 openbis -> /home/openbis/openbis-20.10.9

Regards,
Artur

3

Dear @artur.pedziwilk ,

thank you for providing your workflow for the downgrade. Unfortunately, we have not created separate installation folders for our standalone setup and are relying on the backup folder created by the upgrade script.

Since our test server runs in a docker, I simulated the following downgrade workflow there as a test:

1. update 20.10.7 to 20.10.8

2. downgrade to 20.10.7 as follows:

I am trying to reconstruct the installation folder for 20.10.7 by copying the 20.10.8 folder

cp -ra openBIS-20.10.8 openBIS-20.10.7

and using the content of the corresponding backup folder instead of the content of openBIS-20.10.7/servers. I also restored the configuration files with

openBIS-20.10.7/bin/restore-config-from-backup.sh backup-20.10.7/config-backup

I activated openbis by a symlink

lrwxrwxrwx. 1 openbis openbis                     15 Jul 29 13:29 openbis -> openBIS-20.10.7

and restart the server. Unfortunally the webUI returns the following error after login:

ImportError: No module named xls […/…/core-plugins/eln-lims/11/as/services/as-eln-lims-api/script.py] (Context: )

So, I think I’ve missed something?
I would be grateful for a hint.

Best,
Susanne