Installation Manual BlueSpice 2.27.3 Without Installer
- 1 Tip for this Document
- 2 Requirements
- 3 Download BlueSpice
- 4 Unzip and Copy BlueSpice
- 5 Renaming of Relevant Folders
- 6 Adjusting File System Permissions
- 7 Checking the Installation Requirements
- 8 Integrating BlueSpice in MediaWiki
- 9 Installation of BlueSpice
- 10 Check the Installation
- 11 Further configuration
This document describes the steps for the installation of BlueSpice version 2.27.3 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
- The placeholder
<bluespice-url>stands for the URL to your future BlueSpice installation, e.g. http://localhost/bluespice.
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 the current version of BlueSpice directly at Sourceforge. The package is named BlueSpice-free-2.27.3.zip.
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:
- 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:
Adjusting File System Permissions
Make sure that the following folders in
<installpath-bluespice> are accessible and writable by the webserver:
Detailed information about the file system permissions can also be found in 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).
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:
Save and exit the file.
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))
When the script is finished with the "Done" message, proceed to the next step.
If the script should stop during the process, restart it.
Check the Installation
<bluespice-url> in your browser. BlueSpice should now be successfully installed and a login with your access data should be possible.
Your BlueSpice installation is now ready to use. You can also do some further configuraiton:
- Setup of the extended search
- Setup of the PDF export
- Setup of VisualDiff (only BlueSpice pro)
- Setup of LatexRenderer (BlueSpice pro only)
Also, some security settings are recommended.