Classic tarball

Setup Docker Stack

Ensure the Docker Stack is running according to the BlueSpice Docker installation guide.

Import Database

Run the following command on the host system to create a dump of the BlueSpice MySQL database:

mysqldump -u root -p bluespice > /tmp/dump.sql

Delete the automatically created database inside the Docker container (Docker stack has to be running):

./bluespice-deploy exec -T database mariadb  <<< "drop database bluespice;"

Create a new empty database:

./bluespice-deploy exec -T database mariadb  <<< "create database bluespice;"

Import the database into the Docker container (Docker Stack has to be running):

cat /tmp/dump.sql | ./bluespice-deploy exec -T database mariadb bluespice

Copy Images

Copy the images directory into the Docker data directory. Replace $DATADIR with your actual DATADIR ($DATADIR is set in .env):

cp -r images $DATADIR/wiki/bluespice/

SSL Certificates (if not using Let's Encrypt)

If you're using self-signed or manually managed SSL certificates, move (and convert if necessary) your certificate and key to the following location:

$DATADIR/proxy/certs/wiki.example.com.crt

$DATADIR/proxy/certs/wiki.example.com.key

Ensure the certificate filenames match the domain used.

Certificates using Let's Encrypt

See BlueSpice Docker installation guide

Migrate Configuration

The following files and folders can contain local changes:

settings.d/ directory
all LocalSettings.php files
extensions/BlueSpiceFoundation/data/ directory

Move the relevant changes to

$DATADIR/wiki/bluespice/pre-init-settings.php

or

$DATADIR/wiki/bluespice/post-init-settings.php

Update the Wiki

Run this from your new server where the Docker stack is running on:

cd $DATADIR/bluespice-deploy/compose

./bluespice-deploy exec wiki-task run-updates

Re-index the search:

./bluespice-deploy exec wiki-task "php /app/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick"

./bluespice-deploy exec wiki-task "php /app/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php --quick"

./bluespice-deploy exec wiki-task "php /app/bluespice/w/maintenance/runJobs.php"

PDF exclude - start

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

PDF exclude - end