Update from 4.5 to 5.1

With version 4.5 of BlueSpice, there were two options for installation:

bluespice-deploy container stack → Upgrade from bluespice-deploy installation
Classic tarball → Upgrade from classic tarball installation

Based on which of those you are starting from, the update to BlueSpice version 5.1 may require different steps.

Create a backup Before performing any of the following steps, make sure to make a backup of all databases and filesystem locations related to the process.

Special cases

Before running the database schema updates, based on the previously installed edition of BlueSpice and optionally enabled extensions, some minor changes on the database may be required.

Extension:OATHAuth

TBD

Extension:OpenIDConnect

ALTER TABLE openid_connect DROP COLUMN oidc_id;
ALTER TABLE openid_connect ADD PRIMARY KEY (oidc_user);

Duplicate keys In case the openid_connect table contains duplicate entries of oidc_subject, you can safely remove all duplicates, that have a tailing slash in the oidc_issuer field.

HINT: FARM

Collabpads database update

TBD

SAML authentication

If you were using SAML with the previous version of BlueSpice, you will probably need to re-register the Service Provider with your Identity Provider.

To do so, download the new metadata.xml file from https://<wikiserver>/_sp/module.php/saml/sp/metadata.php/default-sp

PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end