BlueSpice 2.27.0 Update Manual

From BlueSpice

Jump to: navigation, search


Installation Notification

  • 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 is representative for the path, where you unzipped the downloaded extension.
  • The placeholder is representative for the URL of your MediaWiki, e.g. http://localhost/mediawiki.
  • The placeholder is representative for the path to your MediaWiki installation, e.g. C:\xampp\htdocs\mediawiki (Windows) or /var/www/mediawiki (Linux).

Update

1. Create Backup

Always create a backup copy of your current installation before updating the wiki. Make sure that is a complete dump of the database and a backup of the /images directory. 

2. Update Files and Directories

The contains the following directories and files:

  • extensions
  • skins
  • installcheck.php
  • LocalSettings.BlueSpice.php.template
  • LocalSettings.BlueSpiceDistribution.php

Copy the unzipped subfolders into the directory. Overwrite the exsting files.

Delete the directory:

/extensions/BlueSpiceDistribution

Rename the following file:

/LocalSettings.BlueSpice.php.template

to

/LocalSettings.BlueSpice.php

3. Update Config File

Delete the following lines in /LocalSettings.php:

require_once("$IP/extensions/BlueSpiceDistribution/BlueSpiceDistribution.php");
require_once("$IP/extensions/BlueSpiceFoundation/BlueSpiceFoundation.php");
require_once("$IP/extensions/BlueSpiceExtensions/BlueSpiceExtensions.php");
require_once("$IP/skins/BlueSpiceSkin/BlueSpiceSkin.php");

Insert the following lines instead at the end of /LocalSettings.php:

require_once "$IP/LocalSettings.BlueSpice.php";

If you formerly activated/deactivated any extensions, please copy the content of the file

/extensions/BlueSpiceExtensions/BlueSpiceExtensions.default.php

to this file

/extensions/BlueSpiceExtensions/BlueSpiceExtensions.local.php

and make your changes there to activate/deactivate the extensions like before.


4.Ensure Access

The webserver needs write rights for the following directories (with Linux e.g. chmod -R a+w):

  • /cache
  • /images
  • /extensions/BlueSpiceFoundation/data
  • /extensions/BlueSpiceFoundation/config

5. Run Update

5.1. Command Line/Terminal

Open your command line or terminal in and run the following command there:

Windows:

php maintenance/update.php

Linux:

php /maintenance/update.php

The result should look like this:

(...)
Creating bs_whoisonline table...ok
(...)
Creating bs_saferedit table...ok
(...)
...done.

5.2. MediaWiki Web Updater

Open /mw-config/ in your browser and follow the instructions. More information can be found in the MediaWiki Documentation. 

Further Configuration

There are new configurations, which can be done.

1. Use img_auth

If you prefer using img_auth instead of SecureFileStore, please follow these steps: Copy the file

\extensions\BlueSpiceExtensions\BlueSpiceExtensions.default.php

to

\extensions\BlueSpiceExtensions\BlueSpiceExtensions.local.php

Open the file

\extensions\BlueSpiceExtensions\BlueSpiceExtensions.local.php

and deactivate SecureFileStore by commenting out the following line:

require_once( __DIR__."/SecureFileStore/SecureFileStore.setup.php" );

Now add the following line in the LocalSettings.php:

$wgUploadPath = $wgScriptPath."/img_auth.php";

Help

Enjoy using your new BlueSpice for MediaWiki!