Installation Manual Bluespice 2.27.1 Without Installer

From BlueSpice

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


This document describes the steps for the installation of BlueSpice version 2.27.1 without the installer.

Tip for this Document

  • Please, read this manual completely and work through the single installtion 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) or /var/www/bluespice (Linux).
  • The placeholder <bluespice-url> stands for the URL to your future BlueSpice installation, e.g. http://localhost/bluespice.

Requirements

For the installation of BlueSpice, a completely installed and configured MediaWiki version 1.27.x is required. This must be accessible with a browser under <bluespice-url>. For further information, please take a look at the installation manual for MediaWiki.

Download BlueSpice

Download the current version of BlueSpice directly at Sourceforge. The package is named BlueSpice-free-2.27.1.zip.

Hint.jpg
If you purchased BlueSpice pro, this step is not neccessary. The appropriate package has been provided by the distributor. 

Unzip and Copy BlueSpice

Unpack the downloaded archive with BlueSpice.  Note that the relevant content is located in a subfolder (bspw. bluespice-free). Those contains the following files and directories: 

Setup:Setup bluespice packagecontent.jpg
  • extensions
  • settings.d
  • skins
  • BLUESPICE-INSTALL
  • BLUESPICE-LICENSE
  • BLUESPICE-RELEASE-HISTORY
  • BLUESPICE-RELEASE-NOTES
  • installcheck.php
  • LocalSettings.BlueSpice.php
  • nsfr_img_auth.php (nur BlueSpice pro)

Move this file to <installpath-bluespice> and integrate it in the already existing folder. 

Renaming of Relevant Folders

Rename the following folders in <installpath-bluespice> as follows:

  • extensions/BlueSpiceFoundation/data.template
    --> extensions/BlueSpiceFoundation/data
  • extensions/BlueSpiceFoundation/config.template
    --> extensions/BlueSpiceFoundation/config

Adjusting File System Permissions

Make sure that the following folders in <installpath-bluespice> are accessible and writable by the webserver:

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

Detailed information about the file system permissions can also be found in our installation manual at the security settings

Checking the Installation Requirements

Call up the file installcheck.php at <bluespice-url> in your browser (example: http://localhost/installcheck.php).  Correct all red (error) and ideally yellow (warning) declared messages (mostly in the php.ini) like specified. Please note, that changes in the php.ini may require a restart of the webserver. Do not continue until you have been able to remove at least all errors (red). 

Setup:Setup bluespice installcheck.jpg

Integrating BlueSpice in MediaWiki

Now it's time to integrate BlueSpice into MediaWiki. To do this, open the file LocalSettings.php in the folder <installpath-bluespice> in an text editor and add the following at the end of the code: 

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

Save and exit the file.

Hint.jpg
Beginning with BlueSpice version 2.27.1, all default settings as well bitte single modules of BlueSpice are outsourced, so BlueSpice can be integrated into MediaWiki with only this one line. For more technical information about this also take a look at our documentation for advanced users.

Installation of BlueSpice

Open a command line and switch to the folder <installpath-bluespice>. Execute the follwoing command:

php maintenance/update.php (Linux)
php maintenance\update.php (Windows))
Hint.jpg
With Windows, please take care that the environment variables are set correctly to access the php command. 

Hint.jpg
With Linux, please keep in mind that after running the update.php, the file system permissions need to be adjusted again.

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

Setup:Setup bluespice maintenance update.jpg

If the script should stop during the process, restart it.

Check the Installation

Call <bluespice-url> in your browser. BlueSpice should now be successfully installed and a login with your access data should be possible.

Setup:Setup bluespice finished.jpg

Further configuration

Your BlueSpice installation is now ready to use. You can also do some further configuraiton: 

Also, some security settings are recommended.