Upgrade to BlueSpice 3
This document describes the upgrade of BlueSpice from version 2.27.x to the current version BlueSpice 3.
- Please, read this manual completely and work through the single installation steps one after another.
- For editing the configuration files with a text editor, the files must be saved in UTF-8 coding without BOM (Byte Order Mark).
- The placeholder
<installpath-bluespice>stands for the path to your BlueSpice installation, e.g
C:\inetpub\wwwroot\bluespice(Windows regarding the documentation "Folder structure under Windows") or
- The placeholder
<tomcat-webappsstands for the path to the webapps directory of your Tomcat server, e.g
C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps(Windows) or
Make sure that your BlueSpice 2 version is up to date.
It is recommended to first create a complete new installation of BlueSpice 3 in parallel with BlueSpice 2 and then transfer the data to the new system.
First of all, rename your current installation directory. For example, from
Then, copy the new program files to the original installation location. Now you should have two directories, for example
/var/www/bluespice227 with the program files of BlueSpice 2.27 and
/var/www/bluespice with the program files of BlueSpice 3.
Next, uploaded files and configuration files managed by BlueSpice must be transferred to the new installation. Just move the directories
extensions/BlueSpiceFoundation/config from the old installation location to the new one.
Next, the main configuration file must be transferred and adapted. Copy the
LocalSettings.php file from the old installation location to the new one.
Open the file
<installpath-bluespice>/LocalSettings.php. Look for the following lines:
# End of automatically generated settings. # Add more configuration options below.
Delete all following lines. If you have made additional configurations - apart from steps outlined in the old installation manual - below these lines, make sure to keep these additional configurations.
Insert the following line at the end of LocalSettings.php:
Close and save the file.
Open your command line or terminal an change to the directory
<installpath-bluespice>. Run the following command there:
php maintenance/update.php (Linux) php maintenance\update.php (Windows)
Checking the installation
<bluespice-url> in your browser. Your BlueSpice upgrade should now be completed. Logging in with your access data should be possible.