Setup:Installation Guide/Docker/Update

Introduction

• Edition: BlueSpice free, distributed on Docker Hub as a Docker image.
• The current 3.1.2 release has no automatic upgrade feature. The automatic upgrade feature will be included at BlueSpice 3.1.3.
• This document covers the manual upgrade process and how to fix some known issues.

Spinning up a new container with old data

We assume you have a BlueSpice installation from Docker Hub. Also, this installation should have been done with using an external data volume.

Example:

                    docker run -d -p 80:80 -v {/my/data/folder}:/data bluespice/bluespice-free

                

1.Back-up your current data folder:

                    sudo cp -Rf /my/data/folder /my/data/current

                

2. Stop your current BlueSpice-free container:

                    docker container stop $your_container_id_or_name

                

3. Remove the container (optional):

                    docker container rm $your_container_id_or_name

                

4. Fetch the new container image:

                    docker pull bluespice/bluespice-free:latest

                

5. Create a new data folder for the new installation:

                    mkdir /my/data/new

                

6. Create a fresh container with the new image:

                    docker run -d -p 80:80 -v {/my/data/new}:/data bluespice/bluespice-free

                

7. When the container boots up, you have an empty wiki. Stop the newly created docker and move back your old backup to the new instance:

                    docker container stop $new_container_name_or_id

                

8. Remove the content of the new container:

                    sudo rm -Rf /my/data/new/*

                

9. Move the backup into /my/data/new:

                    sudo cp -Rf /my/data/current/* /my/data/new/

                

10. Start the newly created container:

                    docker container start $new_container_name_or_id

                

Now, your new container with your old data is up.

But you still have to run some maintenance scripts as well as some fixes:

                    sudo docker exec $new_container_name_or_id chown -Rf mysql:mysql /data/mysql
sudo docker exec $new_container_name_or_id /etc/init.d/mysql restart
sudo docker exec $new_container_name_or_id /opt/docker/setwikiperm.sh /data/www/bluespice/w
sudo docker exec $new_container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/update.php --quick
sudo docker exec $new_container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/rebuildall.php --quick
sudo docker exec $new_container_name_or_id /usr/bin/php /data/www/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick
sudo docker exec $new_container_name_or_id /usr/bin/php /data/www/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php
sudo docker exec $new_container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/runJobs.php

                

Fixing the broken search

The following commands fix the BlueSpiceExtendedSearch indexes:

                    sudo docker exec $container_name_or_id /opt/docker/setwikiperm.sh /data/www/bluespice/w
sudo docker exec $container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/update.php --quick
sudo docker exec $container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/rebuildall.php --quick
sudo docker exec $container_name_or_id /usr/bin/php /data/www/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/initBackends.php --quick
sudo docker exec $container_name_or_id /usr/bin/php /data/www/bluespice/w/extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php

                

su

                    sudo docker exec $container_name_or_id /usr/bin/php /data/www/bluespice/w/maintenance/runJobs.php