Update Manual from MediaWiki 1.23.x to 1.27.x

From BlueSpice

< Setup:Installation Manual‎ | MediaWiki
Jump to: navigation, search

This document describes the update of MediaWiki from version 1.23.x to 1.27.x as a basis for the installation of BlueSpice 2.27.x


  • Please read this manual completely and follow the installation steps in the given order.
  • For editing the configuration files in a text editor, it is necessary to save the files in UTF-8 code without BOM (Byte Order Mark).
  • The placeholder <installpath-bluespice> is representative for the path to your BlueSpice installation, e.g. C:\inetpub\wwwroot\bluespice (Windows) oder /var/www/bluespice (Linux).
  • The placeholder <bluespice-url> is representative for the URL of your BlueSpice installation, e.g. http://localhost/bluespice.


The requirements for the MediaWiki version 1.27.x can be found in the corresponding installation manual.


It is absolutely necessary to create a backup copy of your current installation before updating the wiki.

Backup Database

To back up your database, use the on-board "mysqldump" program from MySQL / MariaDB: To do this, please open a console, change the directory <installpath-bluespice> and save the database using the following command:

mysqldump -u <username> -p --lock-tables <database> > database.sql

For <username> please use your administrative database user (usually "root"). For <database> use the database name of your MediaWiki/BlueSpice installation.

Under Windows, please make sure that the environment variables are set correctly to access the mysqldump command.


Backup File System

Save the complete directory <installpath-bluespice>, which now contains the database image, to a different location on your server.
For security reasons, immediately delete the file <installpath-bluespice>/database.sql.

Download MediaWiki

Please download MediaWiki 1.27.x under www.mediawiki.org.

Unzip and copy MediaWiki

Unzip the downloaded MediaWiki archive. Please make sure that all relevant content is placed in one subfolder (e.g. mediawiki-1.27.1). Move the content of this subfolder to <installpath-bluespice> and overwrite the existing files.

Setup LocalSettings.php

Open the file <installpath-bluespice>/LocalSettings.php. Look for the following lines:

# End of automatically generated settings.
# Add more configuration options below.

Insert the following lines right before the code above:

wfLoadSkin( 'CologneBlue' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Vector' );

Also add the following line at the end of the code:


Also search before the above mentioned lines after lines that contain require_once. Please delete these lines.

Update database schema

Open your command line or terminal in <installpath-bluespice> and run the following command there::

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))
Under Windows, make sure that the environment variables are set correctly to access the php command.

Under Linux, please note that you have to adjust the file system permissions after running the update.php.

When the script is finished with the "Done" message, proceed to the next step.

Setup:Setup bluespice maintenance update.jpg

Check installation

Open <bluespice-url> in your browser. You should now have an updated MediaWiki standard installation with your current content.

Next Steps

In the next step, you can now update to the current version of BlueSpice.