bluespice 2.27.3 - installation without installer · export date: 17.10.2018 this document was...
TRANSCRIPT
BlueSpice 2.27.3 - Installation without installer
Page of 2 63Export date: 17.10.2018 This document was created with BlueSpice
Table of contents
1. Installation MediaWiki ........................................................................................................................................ 32. Update MediaWiki ............................................................................................................................................ 103. Installation BlueSpice ...................................................................................................................................... 143.1. File System Permissions .............................................................................................................................. 203.2. Environment variables ................................................................................................................................. 23
4. Configuration of the webservices .................................................................................................................... 254.1. ExtendedSearch ........................................................................................................................................... 264.2. PDF export ................................................................................................................................................... 294.3. VisualDiff (BlueSpice pro only) .................................................................................................................... 324.4. LatexRenderer (BlueSpice pro only) ............................................................................................................ 33
5. Additional settings and optimization ............................................................................................................... 345.1. Caching ........................................................................................................................................................ 355.2. Cronjobs ...................................................................................................................................................... 385.3. Time zone .................................................................................................................................................... 40
6. Further system configuration ........................................................................................................................... 416.1. Apache Tomcat ............................................................................................................................................ 426.2. Memcached ................................................................................................................................................. 466.3. Improve speed performance ........................................................................................................................ 49
7. Security settings .............................................................................................................................................. 527.1. Deactivating installcheck file ....................................................................................................................... 537.2. Save Directories .......................................................................................................................................... 54
8. Advanced configuration ................................................................................................................................... 558.1. Configuration Folder settings.d .................................................................................................................... 568.2. Activation and deactivation of BlueSpice extensions .................................................................................. 578.3. Rebuilding the search index ........................................................................................................................ 61
9. SyntaxHighlight GeSHi ..................................................................................................................................... 62
Page of 3 63Export date: 17.10.2018 This document was created with BlueSpice
1. Installation MediaWiki
Contents
1 Tips for this Document ......................................................................................................................................... 3 2 Requriements ...................................................................................................................................................... 3
2.1 Webserver ................................................................................................................................................. 3 2.2 PHP ............................................................................................................................................................ 3 2.3 MySQL ....................................................................................................................................................... 4
3 Download MediaWiki ............................................................................................................................................ 4 4 Unzip and Copy MediaWiki ................................................................................................................................... 4 5 Starting the Installation ....................................................................................................................................... 4 6 Language Selection ............................................................................................................................................. 4 7 Checking the Installation Environment ................................................................................................................ 5 8 Database Settings ............................................................................................................................................... 5 9 Wiki Settings ........................................................................................................................................................ 6
10 Extended Settings .............................................................................................................................................. 7 11 Deposit LocalSettings.php ablegen .................................................................................................................... 9
This document describes the steps of the MediaWiki Installation, which is essential for the installation of BlueSpice.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the URL to your future BlueSpice installation, e.g. <bluespice-url>
.http://localhost/bluespice
Requriements
Webserver
A webserver (IIS / Apache), which is configured to be accessable for , must already be <bluespice-url>running on the system.
PHP
PHP needs to be integrated in the webserver. Make sure that the following moduls are activated:
php-curlphp-gd
php-tidy
Page of 4 63Export date: 17.10.2018 This document was created with BlueSpice
php-tidy
MySQL
A database server (MariaDB oder MySQL) must be set up completely and needs to be available. You need administrative access (root).
Download MediaWiki
Download the MediaWiki version compatible with BlueSpice www.mediawiki.org. BlueSpice is always compatible with the current LTS version of MediaWiki. You can see the correct version of MediaWiki at the version number of BlueSpice - for example:
BlueSpice version 2.27.x corresponds to MediaWiki version 1.27.x.
Unzip and Copy MediaWiki
Unpack the downloaded archive from MediaWiki. Note that the relevant content is located in a subfolder (for example, mediawiki-1.27.4). Move the contents of this subfolder to .<installpath-bluespice>
Starting the Installation
Call up in your browser. The start page of the installation should be displayed:<bluespice-url>
Continue by clicking "set up the wiki".
Language Selection
You will now be asked for the language during the installation process and the language of your later installation:
Page of 5 63Export date: 17.10.2018 This document was created with BlueSpice
Select the required language and click on "Next".
Checking the Installation Environment
The following page should allow you to skip with "Next" in most cases. If errors (red font) are displayed, there is a need for action at your server environment. Please do the necessary corrections.
Database Settings
On the following page, you will be prompted to enter your database settings.
If the database server is on the same PC as the MediaWiki installation, please do not use "localhost" but "127.0.0.1".The database itself is created in the further process if it does not already exist. You do not have to create the database in advance.The database table prefix does not have to be specified. This only makes sense if you need the database for other database tables than for your MediaWiki installation.Please enter the user name and password of the administrative database user (usually root).
Page of 6 63Export date: 17.10.2018 This document was created with BlueSpice
Click "Next".
On the second page about the database it is recommended to create your own database user for your installation. Deactivate the checkbox "Use the same database account as during the installation process" and enter a username and password of your choice. Activate the checkbox "If not already existing, you have to create the account now".
Then click "Next".
Wiki Settings
Now enter a name of your choice for your wiki.
You can also define an administrative user and his password here. You can change the email address of this
Page of 7 63Export date: 17.10.2018 This document was created with BlueSpice
You can also define an administrative user and his password here. You can change the email address of this user at any time in the user settings.
Leave all the other settings as they are and click "Next".
Extended Settings
The settings on the now displayed page should be set as shown in the following screenshot. Please adjust the email address according to your needs, the paths in the section "Uploading Images and Files" are automatically filled and should be left as they are.
At this point, no MediaWiki standard extensions will be chosen. The neccessary extensions for BlueSpice will be integrated during the BlueSpice setup.
Page of 8 63Export date: 17.10.2018 This document was created with BlueSpice
Then click on "Next". Also confirm the following pages with "Next".
All necessary settings are made now. Please confirm with "Next" again.
Page of 9 63Export date: 17.10.2018 This document was created with BlueSpice
Deposit LocalSettings.php ablegen
Finally, the "LocalSettings.php" will be provided for downloading it. Please do this and move the file to .<installpath-bluespice>
Then call and you should see a complete installation of MediaWiki, where you can log on <bluespice-url>with the previously defined username / password.
Page of 10 63Export date: 17.10.2018 This document was created with BlueSpice
2. Update MediaWiki
Contents
1 Notes ................................................................................................................................................................. 10 2 Requirements .................................................................................................................................................... 10 3 Backup ............................................................................................................................................................... 10
3.1 Backup Database .................................................................................................................................... 10 3.2 ............................................................................................................................................................... 11 3.3 Backup File System ................................................................................................................................. 11
4 Download MediaWiki .......................................................................................................................................... 11 5 Unzip and copy MediaWiki ................................................................................................................................. 11 6 Setup LocalSettings.php .................................................................................................................................... 11 7 Update database schema .................................................................................................................................. 12 8 Check installation .............................................................................................................................................. 13 9 Next Steps ......................................................................................................................................................... 13
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
Notes
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 to your BlueSpice installation, <installpath-bluespice>e.g. (Windows) oder (Linux).C:\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder is representative for the URL of your BlueSpice installation, e.g. <bluespice-url>
.http://localhost/bluespice
Requirements
The requirements for the MediaWiki version 1.27.x can be found in the corresponding .installation manual
Backup
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 and save the database using the <installpath-bluespice>following command:
mysqldump -u <username> -p --lock-tables <database> > database.sql
Page of 11 63Export date: 17.10.2018 This document was created with BlueSpice
For please use your administrative database user (usually "root"). For use the <username> <database>database name of your MediaWiki/BlueSpice installation.
Under Windows, please make sure that the are set correctly to environment variablesaccess the mysqldump command.
Backup File System
Save the complete directory , which now contains the database image, to a <installpath-bluespice>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 onesubfolder (e.g. mediawiki-1.27.1). Move the content of this subfolder to and <installpath-bluespice>overwrite the existing files.
Setup LocalSettings.php
Open the file . Look for the following lines:<installpath-bluespice>/LocalSettings.php
# 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:
return;
Also search the above mentioned lines after lines that contain . Please delete these before require_oncelines.
Page of 12 63Export date: 17.10.2018 This document was created with BlueSpice
Update database schema
Open your command line or terminal in and run the following command there::<installpath-bluespice>
php maintenance/update.php (Linux)php maintenance\update.php (Windows))
Under Windows, make sure that the are set correctly to access environment variablesthe php command.
Under Linux, please note that you have to adjust the file system permissionsafter running the update.php.
When the script is finished with the "Done" message, proceed to the next step.
Page of 13 63Export date: 17.10.2018 This document was created with BlueSpice
Check installation
Open in your browser. You should now have an updated MediaWiki standard installation <bluespice-url>with your current content.
Next Steps
In the next step, you can now .update to the current version of BlueSpice
Page of 14 63Export date: 17.10.2018 This document was created with BlueSpice
3. Installation BlueSpice
Contents
1 Tip for this Document ........................................................................................................................................ 14 2 Requirements .................................................................................................................................................... 14 3 Download BlueSpice .......................................................................................................................................... 14 4 Unzip and Copy BlueSpice ................................................................................................................................. 15 5 Renaming of Relevant Folders ........................................................................................................................... 15 6 Adjusting File System Permissions ..................................................................................................................... 15 7 Checking the Installation Requirements ............................................................................................................ 15 8 Integrating BlueSpice in MediaWiki ................................................................................................................... 16 9 Installation of BlueSpice .................................................................................................................................... 16
10 Check the Installation ...................................................................................................................................... 19 11 Further configuration ....................................................................................................................................... 19
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the URL to your future BlueSpice installation, e.g. <bluespice-url>
.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 . For further information, please take a look <bluespice-url>at the .installation manual for MediaWiki
Download BlueSpice
Download the current version of BlueSpice directly at . The package is named Sourceforge BlueSpice-free-.2.27.3.zip
If you purchased BlueSpice pro, this step is not neccessary. The appropriate package has been provided by the distributor.
Page of 15 63Export date: 17.10.2018 This document was created with BlueSpice
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:
extensionssettings.dskinsBLUESPICE-INSTALLBLUESPICE-LICENSEBLUESPICE-RELEASE-HISTORYBLUESPICE-RELEASE-NOTESinstallcheck.phpLocalSettings.BlueSpice.phpnsfr_img_auth.php (nur BlueSpice pro)
Move this file to and integrate it in the <installpath-bluespice>already existing folder.
Renaming of Relevant Folders
Rename the following folders in as follows:<installpath-bluespice>
extensions/BlueSpiceFoundation/data.template--> extensions/BlueSpiceFoundation/dataextensions/BlueSpiceFoundation/config.template--> extensions/BlueSpiceFoundation/config
Adjusting File System Permissions
Make sure that the following folders in are accessible and writable by the <installpath-bluespice>webserver:
cacheimagesextensions/BlueSpiceFoundation/dataextensions/BlueSpiceFoundation/config
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 in your browser (example: <bluespice-url> 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).
Page of 16 63Export date: 17.10.2018 This document was created with BlueSpice
Integrating BlueSpice in MediaWiki
Now it's time to integrate BlueSpice into MediaWiki. To do this, open the file LocalSettings.php in the folder in an text editor and add the following at the end of the code:<installpath-bluespice>
require_once "$IP/LocalSettings.BlueSpice.php";
Save and exit the file.
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 . Execute the follwoing command:<installpath-bluespice>
php maintenance/update.php (Linux)php maintenance\update.php (Windows))
With Windows, please take care that the are set correctly to environment variablesaccess the php command.
With Linux, please keep in mind that after running the update.php, the file system need to be adjusted again.permissions
Page of 17 63Export date: 17.10.2018 This document was created with BlueSpice
When the script is finished with the "Done" message, proceed to the next step.
Page of 18 63Export date: 17.10.2018 This document was created with BlueSpice
Page of 19 63Export date: 17.10.2018 This document was created with BlueSpice
If the script should stop during the process, restart it.
Check the Installation
Call in your browser. BlueSpice should now be successfully installed and a login with your <bluespice-url>access data should be possible.
Further configuration
Your BlueSpice installation is now ready to use. You can also do some further configuraiton:
Setup of the extended searchSetup of the PDF exportSetup of VisualDiff (only BlueSpice pro)Setup of LatexRenderer (BlueSpice pro only)
Also, some are recommended.security settings
Page of 20 63Export date: 17.10.2018 This document was created with BlueSpice
3.1. File System Permissions
Contents
1 Tips for this Document ....................................................................................................................................... 20 2 Affected Folders ................................................................................................................................................. 20 3 Assignment of Permissions with Windows ......................................................................................................... 20 4 Assignment of Permissions with Linux ............................................................................................................... 21
For trouble-free usage of your BlueSpice installation, the web server requires write permissions to several folders of the file system. However, it is recommended to keep the rights for all other files and folders to a
minimum. This document shows you the relevant folders and the correct permissions setting.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice(Windows) or (Linux)./var/www/bluespice
Affected Folders
The folders, which require write permissions, are:
<installpath-bluespice>/cache<installpath-bluespice>/images<installpath-bluespice>/extensions/BlueSpiceFoundation/config<installpath-bluespice>/extensions/BlueSpiceFoundation/data<installpath-bluespice>/extensions/Widgets/compiled_templates (only BlueSpice pro)
Assignment of Permissions with Windows
Assign "change" rights for this folder for the local user "Everyone".
Page of 21 63Export date: 17.10.2018 This document was created with BlueSpice
Assignment of Permissions with Linux
Here you can assign rights much more strictly, which is also recommended. Transfer the directory recursively to the user root (CHMOD for Files 644, CHMOD for Directories 755) <installpath-bluespice>
and after this, transfer the mentioned directory recursively to the user and the group, under which the Apache Web Server runs (Debian/Ubuntu e.g. "www-data").
In the following, we provide a bash script, which works through this tasks for you with only one command.
To do so, create the file /usr/local/bin/setWikiPerm and copy the following code into this file:
#!/bin/bash
WWW_USER="www-data"WWW_GROUP="www-data"
WWW_HOME=`eval echo ~$WWW_USER`WWW_CFG=$WWW_HOME/.config
if [ $# -eq 0 ]; then echo "You must enter the path of your MediaWiki installation."
Page of 22 63Export date: 17.10.2018 This document was created with BlueSpice
if [ $# -eq 0 ]; then echo "You must enter the path of your MediaWiki installation." exitelif [ ! -d $1 ]; then echo "$1 does not exist or is no path." exitfi
PATH=`echo "$1" | sed -e 's#/$##'`
/usr/bin/find $PATH -type d -exec /bin/chmod 755 {} \;/usr/bin/find $PATH -type f -exec /bin/chmod 644 {} \;
/bin/chown -R root:root $PATH
pathes=( "$PATH/cache" \ "$PATH/images" \ "$PATH/_sf_instances" \ "$PATH/extensions/BlueSpiceFoundation/data" \ "$PATH/extensions/BlueSpiceFoundation/config" \ "$PATH/extensions/Widgets/compiled_templates" \)
for i in "${pathes[@]}"; do if [ -d $i ]; then /bin/chown -R $WWW_USER:$WWW_GROUP $i fidone
if [ ! -d $WWW_CFG ]; then /bin/mkdir $WWW_CFGfi
/bin/chown -R $WWW_USER:$WWW_GROUP $WWW_CFG
/bin/chmod 755 $PATH/extensions/SyntaxHighlight_GeSHi/pygments/create_pygmentize_bundle/bin/chmod 755 $PATH/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize
/usr/bin/find $PATH/extensions/Scribunto/engines/LuaStandalone/binaries/*_linux_* -name 'lua' -type f -exec /bin/chmod 755 {} \;
If needed, replace the content of the variables
WWW_USER="www-data"WWW_GROUP="www-data"
with the approprate user and group of your distribution.
After this, assign CHMOD 755 to this file. Now you can run the script and let it do the complete permission setting automatically with the following command:
setWikiPerm <installpath-bluespice>
Note that when the update.php is executed on the console, the rights can be partially discarded. For this reason, set the rights to "update.php" again.
Page of 23 63Export date: 17.10.2018 This document was created with BlueSpice
1. 2. 3.
4.
3.2. Environment variables
Contents
1 Tips for this Document ....................................................................................................................................... 23 2 Figure out Paths ................................................................................................................................................. 23 3 Enter Environmental Variables .......................................................................................................................... 23
For using console commands for PHP ans MySQL in a comfortable way, some settings in the environment variables should be done. This document describes how to do this.
Tips for this Document
Please, read this manual completely and work through the single installation steps one after another.
Figure out Paths
Please try to figure out in which paths of your Windows installation the following files are located:
php.exemysql.exe
This document uses this paths as for the description:an example
C:\Program Files (x86)\PHP\php-5.6.30\php.exeC:\Program Files\MariaDB 10.1\bin\mysql.exe
Enter Environmental Variables
Press the key combination "Windows + R" to start the input request Start the program "SystemPropertiesAdvanced.exe"Click at "Environment Variables"
Open the variable "Path" at "System variables" with a double click
Page of 24 63Export date: 17.10.2018 This document was created with BlueSpice
4.
5.
6.
7. 8.
With Windows 2012: In the line "Value of Variables", add the paths to php.exe and mysql.exe, separated by semicolon, directly at the beginning of the line. Regarding the path example, this would be "C:\Program Files (x86)\PHP\php-5.6.30\;C:\Program Files\MariaDB 10.1\bin\;"
Windows 2016 and above: Add two new entries with their respective pathnames
Close all windows by clicking on "OK"Restart the command line
Now you should be able to call up the commands "php" and "mysql" without problems in the command line.
Page of 25 63Export date: 17.10.2018 This document was created with BlueSpice
4. Configuration of the webservices
Extended SearchPDF-ExportVisualDiff (BlueSpice pro only)LatexRenderer (BlueSpice pro only)
Page of 26 63Export date: 17.10.2018 This document was created with BlueSpice
4.1. ExtendedSearch
Contents
1 Tips for this Document ....................................................................................................................................... 26 2 Setting-up the Solr-Cores ................................................................................................................................... 26 3 Configurating Tomcat ........................................................................................................................................ 27
3.1 Linux ........................................................................................................................................................ 27 3.2 Windows .................................................................................................................................................. 27
4 Copying of the Solr Application .......................................................................................................................... 27 5 Restarting Tomcat ............................................................................................................................................. 27 6 Activating the Extended Search in BlueSpice .................................................................................................... 28
This document describes the installation of the extended search for BlueSpice. Please take into account, that the must be installed and configured completely.Apache Tomcat server
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the path to the Webapps directory of your Tomcat server, <tomcat-webapps>e.g. (Windows) or C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps /var/lib
(Linux)./tomcat8/webapps
Setting-up the Solr-Cores
Create the following directory:
/opt/bluespice/data (Linux)C:\BlueSpice\bluespice_data (Windows)
Move the directory "solr" from <installpath-bluespice>/extensions/BlueSpiceExtensions to the just created directory. /ExtendedSearch/webservices
Switch to this directory and go to the subfolder . Choose bluespice/conf/lang stopwords_<LANG>.txtthere, which matches your language and replace the file in the folder (one stopwords.txt bluespice/conflevel higher) with this file.
With Linux, please transfer the folder /opt/bluespice/data/solr recursively to the user and group, under which the Tomcat server is running.
Page of 27 63Export date: 17.10.2018 This document was created with BlueSpice
Configurating Tomcat
The Tomcat server needs to know the directory to the Solr core. The following describes how to configure this.
Linux
The distributions differ at this point regarding the configuration file. How this needs to be configured with the distribution you are using can be found in the documentation of the distributor. The following steps explain the configuration using Debian/Ubuntu and Tomcat 8:
Open the file and add the following line at the end: /etc/default/tomcat8
JAVA_OPTS="${JAVA_OPTS} -Dsolr.solr.home=/opt/bluespice/data/solr"
Save the changes and exit the file.
Windows
Open the and switch to the tab "Java". At the field "Java Options", add this configuration interface of Tomcatas the last point in the line:
-Dsolr.solr.home=C:\BlueSpice\bluespice_data\solr
Save this settings by clicking at "Apply".
Copying of the Solr Application
Move the file "solr.war" from the directory <installpath-bluespice>/extensions/BlueSpiceExtensions to /ExtendedSearch/webservices <tomcat-webapps>
Restarting Tomcat
Restart the Tomcat Webserver like described .here
Page of 28 63Export date: 17.10.2018 This document was created with BlueSpice
Activating the Extended Search in BlueSpice
Go to the directory . If the file <installpath-bluespice>/extensions/BlueSpiceExtensions does not exist already, please copy the file BlueSpiceExtensions.local.php BlueSpiceExtensions.
and paste it in the folder. Rename it to . Open this file in a default.php BlueSpiceExtensions.local.phptext editor.
Scroll to the end of the file. There you can find the following line:
#require_once( __DIR__."/ExtendedSearch/ExtendedSearch.setup.php" );
Delete the first character ( ), save and exit the file.#
Open a comman line and change to the directory . Run the following command <installpath-bluespice>there:
php maintenance/update.php (Linux)php maintenance\update.php (Windows))
With Windows, please take care that the are set correctly to environment variablesaccess the command "php".
With Linux. please take care that after running the update.php, the file system must be set again.permissions
As soon as the script finished its work with the message "Done", run a further maintenance script to create the search index:
php extensions/BlueSpiceExtensions/ExtendedSearch/maintenance/searchUpdate.php (Linux)php extensions\BlueSpiceExtensions\ExtendedSearch\maintenance\searchUpdate.php (Windows))
Running this script may take some time. This depends on the amount of content, which has been created in the wiki. When the script was completely executed, the extended search is installed successfully and is ready to use.
Page of 29 63Export date: 17.10.2018 This document was created with BlueSpice
4.2. PDF export
Contents
1 Tips for this Document ....................................................................................................................................... 29 2 Copying the BShtml2PDF Application ................................................................................................................ 29 3 Restart Tomcat .................................................................................................................................................. 29 4 Activating the PDF Export in BlueSpice .............................................................................................................. 29 5 Troubleshooting ................................................................................................................................................. 31
This document describes the installation of BlueSpice - PDF export. Please make sure that the Apache is completely installed and configured at the BlueSpice server.Tomcat server
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the path to the Webapps directory of your Tomcat server, <tomcat-webapps>e.g. (Windows) or C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps /var/lib
(Linux)./tomcat8/webapps
Copying the BShtml2PDF Application
Move the file "BShtml2PDF.war" from the directory <installpath-bluespice>/extensions to /BlueSpiceExtensions/UEModulePDF/webservices <tomcat-webapps>
Restart Tomcat
Restart the Tomcat Webserver like described .here
Activating the PDF Export in BlueSpice
Go to the directory . If the file <installpath-bluespice>/extensions/BlueSpiceExtensions does not exist already, please copy the file BlueSpiceExtensions.local.php BlueSpiceExtensions.
and place it in the same folder under the name . Open this default.php BlueSpiceExtensions.local.phpfile in a text editor.
Scroll to the end of the file.You will find the following lines there:
#require_once( __DIR__."/UniversalExport/UniversalExport.setup.php" );#require_once( __DIR__."/UEModulePDF/UEModulePDF.setup.php" );
Remove the first character (#), save the file and exit it.
Page of 30 63Export date: 17.10.2018 This document was created with BlueSpice
Remove the first character (#), save the file and exit it.
Open a command line and change to the folder. Execute the following command:<installpath-bluespice>
php maintenance/update.php (Linux)php maintenance\update.php (Windows))
In Windows, make sure that the are set correctly to access the environment variablesphp command.
Note that you must update the after running update.php.file system permissions
When the script is finished with the "Done" message, the web service is successfully installed.
Page of 31 63Export date: 17.10.2018 This document was created with BlueSpice
Troubleshooting
If there is a problem with PDF export in BlueSpice, first check the .file system permissions
Page of 32 63Export date: 17.10.2018 This document was created with BlueSpice
4.3. VisualDiff (BlueSpice pro only)
Contents
1 Tips for this Document ....................................................................................................................................... 32 2 Copy of BShtmlDiff ............................................................................................................................................. 32 3 Restart Tomcat .................................................................................................................................................. 32 4 Troubleshooting ................................................................................................................................................. 32
This document describes the installation of VisualDiff from BlueSpice. VisualDiff is a exclusive component of BlueSpice pro! Please note that the must be installed and Apache Tomcat serverconfigured on the BlueSpice server.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the path to the Webapps directory of your Tomcat server, <tomcat-webapps>e.g. (Windows) or C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps /var/lib
(Linux)./tomcat8/webapps
Copy of BShtmlDiff
Move the file "BShtmlDiff.war" from the directory <installpath-bluespice>/extensions to /BlueSpiceVisualDiff/VisualDiff/webservices <tomcat-webapps>
Restart Tomcat
Restart the Tomcat Webserver like described .here
This completes the installation of VisualDiff.
Troubleshooting
If there is a problem with VisualDiff in BlueSpice, first check the .file system permissions
Page of 33 63Export date: 17.10.2018 This document was created with BlueSpice
4.4. LatexRenderer (BlueSpice pro only)
Contents
1 Tip for this Document ........................................................................................................................................ 33 2 Installation of the LatexRenderer application .................................................................................................... 33 3 Restart Tomcat .................................................................................................................................................. 33 4 Troubleshooting ................................................................................................................................................. 33
This document describes the installation of LatexRenderer from BlueSpice. LatexRenderer is a exclusive component of BlueSpice pro! Please note that the must be installed and Apache Tomcat server
configured on the BlueSpice server.
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespiceThe placeholder stands for the path to the Webapps directory of your Tomcat server, <tomcat-webapps>e.g. (Windows) or C:\Program Files\Apache Software Foundation\Tomcat 8.5\webapps /var/lib
(Linux)./tomcat8/webapps
Installation of the LatexRenderer application
Move the file "BSLaTeX2PNG.war" from the directory <installpath-bluespice>/extensions to /BlueSpiceLatexRenderer/LatexRenderer/webservices <tomcat-webapps>
Restart Tomcat
Restart the Tomcat Webserver like described .here
This already completes the installation of LatexRenderer.
Troubleshooting
If there is a problem with LatexRenderer in BlueSpice, first check the .file system permissions
Page of 34 63Export date: 17.10.2018 This document was created with BlueSpice
5. Additional settings and optimization
CachingCronjobsTime zone
Page of 35 63Export date: 17.10.2018 This document was created with BlueSpice
5.1. Caching
Contents
1 Tips for the Document ....................................................................................................................................... 35 2 Linux vs. Windows ............................................................................................................................................. 35 3 Indicate Cache-Directory ................................................................................................................................... 35 4 Name Resolution of the Database ..................................................................................................................... 36 5 Activate Memcached ......................................................................................................................................... 36 6 Increase PHP Memory Limit ............................................................................................................................... 36 7 Activate Bytecode Cache in PHP ........................................................................................................................ 36 8 Deactivate JobQueue ......................................................................................................................................... 37
This document describes different caching options to enhance the performance of your BlueSpice installation.
Tips for the Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Linux vs. Windows
Please note that with equal hardware conditions, BlueSpice empirically runs more performantly on Linux than on Windows servers.
Indicate Cache-Directory
This forces BlueSpice to use the filesystem instead of the database for some internal caches. To do this, create the file /settings.d/001-Directories.php and add the following content:<installpath-bluespice>
<?php
$wgCacheDirectory = "$IP/cache";
Save and close the file.
Note that the directory "cache" in must be writable by the <installpath-bluespice>web server. For more information, read the .file system permissions
Page of 36 63Export date: 17.10.2018 This document was created with BlueSpice
Name Resolution of the Database
If this hasn't already been done while , please make sure that the database server will setting up MediaWikibe adressed via IP if it runs on the same server than BlueSpice. Especially Windows has problems with the resolution of "localhost".
To do this, open /LocalSettings.php and locate the variable . The <installpath-bluespice> $wgDBserverline should ideally be:
$wgDBserver = "127.0.0.1";
Activate Memcached
Create the file /settings.d/001-Memcached.php and add the following content:<installpath-bluespice>
<?php
$wgMainCacheType = CACHE_MEMCACHED; $wgSessionCacheType = CACHE_DB; $wgMemCachedServers = [ "127.0.0.1:11211" ];
Save and close the file.
The prerequisite is an installed and configured memcached server on the BlueSpice server. Read the article for more information.memcached
Increase PHP Memory Limit
A higher memory limit of PHP results in a faster execution. ¶ This can be changed in php.ini. Locate and adjust the following option:
memory_limit = 512M (means 512 MB - varies from the available memory)
After saving and closing php.ini, the web server must be restarted.
Activate Bytecode Cache in PHP
Since PHP 5.5 the bytecode cache "opcache" is included.
This needs to be activated in the php.ini first. Check if the module is integrated there. This is done via the line:
zend_extension=opcache.dll (Windows)zend_extension=opcache.so (Linux)
Page of 37 63Export date: 17.10.2018 This document was created with BlueSpice
Please also note the specification of the distributor for activating PHP modules under Linux.
Please, do the following configuration of the opcache in php.ini. Normally, all options should already exist, but are commented out by semicolon (;) at the beginning of the line. Locate the respective option in php.ini, remove the semicolon at the beginning of the line and adjust the settings as follows:
opcache.enable=1opcache.memory_consumption=512 (means 512 MB - varies from the available memory)opcache.max_accelerated_files=5000opcache.validate_timestamps=1opcache.revalidate_freq=2
After saving and closing php.ini, the web server must be restarted.
Deactivate JobQueue
For this, read the .paragraph "runJobs.php" in the "Cronjobs" article
Page of 38 63Export date: 17.10.2018 This document was created with BlueSpice
5.2. Cronjobs
Contents
1 Tips for this Document ....................................................................................................................................... 38 2 runJobs.php ........................................................................................................................................................ 38 3 processBsEmailBatch.php .................................................................................................................................. 38 4 runNotifications.php (only BlueSpice pro) .......................................................................................................... 39
This document describes cronjobs an related configurations, which should be set for your BlueSpice (depending on the used version).
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
runJobs.php
Time-consuming processes will be moved to a processing queue in the background of BlueSpice. With every page impression, a part of these will be processed. For the case that there are lots of processes in the queue and there are relatively litte page impressions, the tasks will not be processed promptly.
For this reason, the queue should be processed regularly by cronjob.
Now create a cronjob (Windows: "Scheduled task") depending on your operating system. The command to execute is:
php /maintenance/runJobs.php <installpath-bluespice> (Linux)php.exe \maintenance\runJobs.php <installpath-bluespice> (Windows)
It is recommended to specify the complete path to php.exe under Windows. For more information, see the document.environment variables
Execute the cronjob every . 15 minutes
processBsEmailBatch.php
For reports via email sent from MediaWiki, please create a cronjob and run it daily. The command for this is:
php /extensions/BlueSpiceEchoConnector/maintenance/processBsEmailBatch.php <installpath-bluespice> (Linux)php.exe \extensions\BlueSpiceEchoConnector\maintenance\processBsEmailBatch.php <installpath-bluespice> (Windows)
Page of 39 63Export date: 17.10.2018 This document was created with BlueSpice
It is recommended to specify the complete path to php.exe under Windows. For more information, see the document.environment variables
runNotifications.php (only BlueSpice pro)
The BlueSpiceReminder notifies the users by email about upcoming tasks in BlueSpice. For this, a cronjob needs to be executed once a day. This is the command:
php /extensions/BlueSpiceReminder/Reminder/maintenance/runNotifications.php <installpath-bluespice> (Linux)php \extensions\BlueSpiceReminder\Reminder\maintenance\runNotifications.php <installpath-bluespice> (Windows)
It is recommended to specify the complete path to php.exe under Windows. For more information, see the document.environment variables
Page of 40 63Export date: 17.10.2018 This document was created with BlueSpice
5.3. Time zone
Contents
1 Tips for this Document ....................................................................................................................................... 40 2 Changing the Time Zone ................................................................................................................................... 40
Even if every user can change his time zone himself in the user settings, BlueSpice sets the default time zone "Europe/Berlin" when the user first logs in. This document describes how to change this if necessary.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Changing the Time Zone
Open the file /settings.d/001-DefaultSettings.php. In delivery stat, you can find <installpath-bluespice>these two lines there:
$wgLocaltimezone = 'Europe/Berlin';$wgDefaultUserOptions['timecorrection'] = 'ZoneInfo|' . (date("I") ? 120 : 60) . '|Europe/Berlin';
Replace "Europe / Berlin" with your time zone. An overview of all possible time zones can be found in the .official PHP documentation
Save and close the file.
Page of 41 63Export date: 17.10.2018 This document was created with BlueSpice
6. Further system configuration
Environment variables (Windows)Apache TomcatMemcached
Page of 42 63Export date: 17.10.2018 This document was created with BlueSpice
6.1. Apache Tomcat
Contents
1 Installation ......................................................................................................................................................... 42 1.1 Linux ........................................................................................................................................................ 42 1.2 Windows .................................................................................................................................................. 42
1.2.1 Java .............................................................................................................................................. 42 1.2.2 Tomcat ......................................................................................................................................... 43
1.3 Installation Check .................................................................................................................................... 43 2 Configuration ..................................................................................................................................................... 43
2.1 context.xml ............................................................................................................................................. 43 2.2 server.xml ............................................................................................................................................... 44 2.3 Restart Tomcat ........................................................................................................................................ 44
3 Special features under Windows ........................................................................................................................ 44 3.1 Configure Tomcat .................................................................................................................................... 44 3.2 Restart Tomcat ........................................................................................................................................ 44 3.3 Setup Autostart ....................................................................................................................................... 45 3.4 Particular Caution: Java Update ............................................................................................................... 45
This document describes the configuration of the Apache Tomcat server, which is needed for the of BlueSpice.Webservices
Installation
Linux
Install the latest version of the Apache Tomcat server in the package manager of your distribution. The package manager dissolves all dependencies and installs the required packages.
Windows
Java
Apache Tomcat requires the Java Runtime Environment. If these is not already installed at your system, download ( ) and install it. We recommend the 64 bit version for latest systems. www.java.com
Page of 43 63Export date: 17.10.2018 This document was created with BlueSpice
Tomcat
Download the "32-bit/64-bit Windows Service Installer" from the . No modifications Tomcat project websiteare necessary during the installation process. Confirm the single steps with "Next".
Installation Check
If the Apache Tomcat server has been installed and started correcly can be checked by calling up . With a correct installation, the default page of the server will http://<host name-or-ip-of-the-server>:8080
be displayed.
Configuration
Now, two configuration files of the Tomcat server need to be adjusted:
context.xmlserver.xml
Those can - per default - be found at:
with Windows: C:\Program Files\Apache Software Foundation\Tomcat 8.5\confwith Linux: / (the "X" stands for the particular Tomcat version)etc/tomcatX
context.xml
Replace the line
<context>
with
<Context mapperContextRootRedirectEnabled="true">
Page of 44 63Export date: 17.10.2018 This document was created with BlueSpice
server.xml
Please make sure that the complete block
<Connector port="8080" protocol="HTTP/1.1" ... />
is as follows:
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" URIEncoding="UTF-8" redirectPort="8443" address="127.0.0.1" />
Restart Tomcat
Restart the Tomcat server:
Linux: (the "X" stands for the particular Tomcat version)service tomcatX restartWindows: See below: Restart Tomcat
Special features under Windows
Configure Tomcat
All of the following settings need to be done in the configuration interface of Tomcat. These can be found in the start menu under "Configure Tomcat".
Restart Tomcat
The restart can be performed in the first tab of the configuration interface. Stop and then start the service there.
Page of 45 63Export date: 17.10.2018 This document was created with BlueSpice
Setup Autostart
Tomcat will not automatically be started with Windows. This needs to be configured in the first tab, where you also start the service. Switch to "Automatic" under "Startup type" and save this changes with a click on "Apply".
Particular Caution: Java Update
Tomcat requires Java. The path for this is firmly defined in Tomcat. Java, however, changes the installation path with every update. Those needs to be configured in Tomcat after every update to guarantee the functionality of Tomcat.
To do this, switch to the tab "Java" and change the path to jvm.dll under "Java Virtual Machine" - normally this is
.C:\Program Files\Java\>\bin\server\jvm.dll
Page of 46 63Export date: 17.10.2018 This document was created with BlueSpice
6.2. Memcached
Contents
1 Tips for this Document ....................................................................................................................................... 46 2 Linux .................................................................................................................................................................. 46
2.1 Installation ............................................................................................................................................... 46 2.2 Configuration ........................................................................................................................................... 46 2.3 Check the Server ..................................................................................................................................... 47
3 Windows ............................................................................................................................................................ 47 3.1 Requirements .......................................................................................................................................... 47 3.2 Download ................................................................................................................................................ 47 3.3 Installation ............................................................................................................................................... 47 3.4 Starting the MemCacheD Manager .......................................................................................................... 47 3.5 Configuration ........................................................................................................................................... 48
This document describes how to set up the memcached server, with which you can achieve some speed optimization. For the configuration of BlueSpice, also read the paragraph "Activate Memcached" in the "Caching" article.
Tips for this Document
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).
Linux
Installation
Install the memcached server in the package manager of your distribution.
Configuration
Open the file that contains the memcached configuration (for example, /etc/memcached.con under Debian / Ubuntu).Locate the -m argument and increase the amount of memory available depending on the capabilities of your server:
-m 1024
Save and close the file, and restart memcached.
Page of 47 63Export date: 17.10.2018 This document was created with BlueSpice
Check the Server
Verify that the memcached server is running:
netstat -tulpn | grep 11211
If you receive an output that is similar to this, memcached has started successfully:
root@bluespice:/var/www/bluespice# netstat -tulpn | grep 11211 tcp 0 0 127.0.0.1:11211 0.0.0.0:* LISTEN 15163/memcached udp 0 0 127.0.0.1:11211 0.0.0.0:* 15163/memcached root@bluespice:/var/www/bluespice#
Windows
The use of Nick Pirocanac's MemCacheD Manager is highly recommended. This makes the configuration very simple.
Requirements
An installed .NET Framework version 3.5 is required for the MemCacheD Manager.
Download
Download the MemCacheD Manager from .software.informer.com
Installation
During the installation you have hardly any setting possibilities, so you can "click" throuch the installation process without any changes.
Starting the MemCacheD Manager
Always start the MemCacheD Manager from the start menu (right click -> Run as as administratoradministrator)!
Page of 48 63Export date: 17.10.2018 This document was created with BlueSpice
1. 2. 3. 4. 5. 6. 7.
Configuration
In MemCacheD Manager, click "Add Server"Enter the local IP "127.0.0.1" under "Server Name" and click on "Apply"Click "Add Instance"Enter any desired name under "Instance Name" Under Maximum Memory, increase the available memory depending on the capabilities of your serverClick "Apply"Start the new created instance by clicking on "Yes"
The Memcached Server is now installed and configured.
Page of 49 63Export date: 17.10.2018 This document was created with BlueSpice
6.3. Improve speed performance
BlueSpice is optimized for fast read accesses. If your BlueSpice is running slowly, it can have different reasons. Often the search engine is not set up or the corresponding Tomcat server is not available. Also, an incorrect configuration (e.g., caches) may be the cause. Or the performance of your server is too low.
In this Howto you will find the most important solutions for increasing the speed of your BlueSpice instance.
Contents
1 Apache Tomcat Server not available ................................................................................................................. 49 2 Measures to increase performance .................................................................................................................... 49
2.1 Specify cache directory ........................................................................................................................... 49 2.2 Resize the name resolution of the database server ................................................................................ 50 2.3 Enable memcached ................................................................................................................................. 50 2.4 Enable Bytecode Cache in PHP ................................................................................................................ 50 2.5 Increase PHP Memory Limit ..................................................................................................................... 50 2.6 Set up JobQueue ...................................................................................................................................... 51 2.7 Renew the L10N cache ............................................................................................................................ 51
Apache Tomcat Server not available
BlueSpice uses the search engine Apache Lucene / Solr, which supports important services of the wiki. Should saving a page take a long time, this is an indication that you have a problem with the search engine. Or you can simply enter a search query: If the input and the search page does not look as described , herethe is not installed correctly.search engine
Please check the to see if you have completed the installation.Installation manualRestart the Apache Tomcat Server.
Measures to increase performance
Specify cache directory
When you specify a cache directory, the Wiki uses the filesystem for some internal caches instead of the database
## Set $wgCacheDirectory to a writable directory on the web server## to make your wiki go slightly faster. The directory should not## be publically accessible from the web.
$wgCacheDirectory = "$IP/cache";
Please make sure that the folder named here can be described by your web server. See also the notes in the .Installation manual
Learn more: https://www.mediawiki.org/wiki/Manual:$wgCacheDirectory
Page of 50 63Export date: 17.10.2018 This document was created with BlueSpice
Learn more: https://www.mediawiki.org/wiki/Manual:$wgCacheDirectory
Resize the name resolution of the database server
Especially under Windows, the name resolution of "localhost" can lead to delays. Use the IP address instead of the DNS name in the database. To do this, change the server configuration accordingly in LocalSettings.php:
$wgDBserver = "127.0.0.1"; #change IP value to your DB server IP
Enable memcached
Use Memcached as the central cache type. Note that Memchached must be installed and active on the server!
To do this in LocalSettings.php insert this configuration at the end:
$wgMainCacheType = CACHE_MEMCACHED; $wgMemCachedServers = array( "127.0.0.1:11233" );
Enable Bytecode Cache in PHP
Since PHP 5.5, the bytecode cache opcache is delivered with. This must however be activated in the php.ini.
opcache.enable=1
Additional settings:
opcache.memory_consumption=512 opcache.max_accelerated_files=10000 opcache.validate_timestamps=1 opcache.revalidate_freq=2
After changing the php.ini, the web server must be restarted.
Learn more: und http://php.net/manual/de/opcache.configuration.php http://www.hostingadvice.com/how-to/enable-php-5-5-opcache-ubuntu-14-04/
Increase PHP Memory Limit
A higher memory limit of PHP results in a faster execution. This must be specified in php.ini:
memory_limit = 256M
After changing the php.ini, the web server must be restarted.
Page of 51 63Export date: 17.10.2018 This document was created with BlueSpice
Set up JobQueue
Some tasks from MediaWiki can be delayed. Typically, they are processed by calling pages on the wiki. This can lead to delays. To prevent this, the JobQueue must be set up. Create a cronjob or task that runs this script every 10 minutes:
php maintenance/runJobs.php --maxjobs 100
Renew the L10N cache
Only in the case of absolute emergency, you can manually update the local cache, otherwise it will be rewritten every page call. To do this in LocalSettings.php insert this configuration at the end:
$wgLocalisationCacheConf['manualRecache'] = true;
Then execute the following command:
php /maintenance/rebuildLocalisationCache.php --force --lang="de,de-formal,en"
This command should also be set up as an hourly cronjob.
Learn more: https://www.mediawiki.org/wiki/Manual:$wgLocalisationCacheConf
Page of 52 63Export date: 17.10.2018 This document was created with BlueSpice
7. Security settings
File System PermissionsDeactivating installcheck fileSave Directories
Page of 53 63Export date: 17.10.2018 This document was created with BlueSpice
7.1. Deactivating installcheck file
Contents
1 Tips for this Document ....................................................................................................................................... 53 2 Deactivating installcheck.php ............................................................................................................................ 53
As soon as the setup of BlueSpice is completed, you should prevent the execution of the installcheck.php while using the wiki productively.A short instruction can be found in this document.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Deactivating installcheck.php
Switch to the directory and open the file in a text <installpath-bluespice> installcheck.phpeditor. Insert a new line after the first line and insert
die( 'Deactivated.' );
Save and exit the file. The installcheck.php is no longer accessible now.If you need to restore this file at a later time, it is sufficient to temporarily disable inserted line by placing the # character at the beginning of the line.
Page of 54 63Export date: 17.10.2018 This document was created with BlueSpice
7.2. Save Directories
Contents
1 Tips for this Document ....................................................................................................................................... 54 2 Explanation for Saving Directories ..................................................................................................................... 54
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Explanation for Saving Directories
It is highly recommended, to lock several directories to save them from access from external browers, so that calling up the directory or the content delivers the HTTP status code (Forbidden).
To find out how this works with the webserver you are using, please read the documentation of your webserver software.
The following directories should be saved:
<bluespice-url>/cache<bluespice-url>/imagesPlease keep in mind that you need to unblock the subfolder /images/bluespice/flexiskin <bluespice-url>afterwards, because this subfolder must be accessable. <bluespice-url>/mw-config
Page of 55 63Export date: 17.10.2018 This document was created with BlueSpice
8. Advanced configuration
Configuration Folder settings.dActivation and deactivation of BlueSpice-extensionsRebuilding the search index
Page of 56 63Export date: 17.10.2018 This document was created with BlueSpice
8.1. Configuration Folder settings.d
Contents
1 Tip for theDocument .......................................................................................................................................... 56 2 Explanation For the Folder settings.d ................................................................................................................ 56
Tip for theDocument
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
This document provides background information for advanced users. We recommend not to make any changes on BlueSpice, if you are not familiar with the following information.
Explanation For the Folder settings.d
Starting with BlueSpice version 2.27.1, all default settings as well as the modules of BlueSpice are outsourced. All configurations can now be found in separate files in the /settings.d folder.
The files in this folder integrate the standard MediaWiki extensions required for BlueSpice, perform recommended default configurations, and also integrate all BlueSpice-related extensions (free or pro).
The files in the /settings.d folder are automatically integrated in alphabetical order and are therefore prefixed with numbers.If you want to add additional configurations yourself, you can save your own files here. For this, it is recommended to use the prefix 001-.
Additional configurations, which are not packed per default but can be used, can be found at .auf github.com
Page of 57 63Export date: 17.10.2018 This document was created with BlueSpice
8.2. Activation and deactivation of BlueSpice extensions
Contents
1 Tips for this Document ....................................................................................................................................... 57 2 Create a configuration file which will be not overriten while you update BlueSpice .......................................... 57 3 Deactivation of extensions ................................................................................................................................ 57 4 Activation of extensions ..................................................................................................................................... 57
In some cases you could need the possibility to activate or deactivate single extensions of BlueSpice. This document will show you how to do this.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Create a configuration file which will be not overriten while you update BlueSpice
All BlueSpice-extensions are configured in the file <installpath-bluespice>/extensions by default. You should not use this file to /BlueSpiceExtensions/BlueSpiceExtensions.default.php
configure these extensions because it will by overwritten while you update BlueSpice. Copy this file to and do <installpath-bluespice>/extensions/BlueSpiceExtensions/BlueSpiceExtensions.local.php
all changes in this file.
Deactivation of extensions
Search the relevant extension in <installpath-bluespice>/extensions/BlueSpiceExtensions. Uncomment the line which includes the extension by typing "//" at the /BlueSpiceExtensions.local.php
beginning of the line.
Activation of extensions
If you which to activate extensions which are deactivated please search the relevant extension in . <installpath-bluespice>/extensions/BlueSpiceExtensions/BlueSpiceExtensions.local.php
Remove the commentation at the beginning of the line ('#' or '//').
After that open a command line and switch to the folder . Execute the follwoing <installpath-bluespice>command:
php maintenance/update.php (Linux)
Page of 58 63Export date: 17.10.2018 This document was created with BlueSpice
php maintenance/update.php (Linux)php maintenance\update.php (Windows))
With Windows, please take care that the are set correctly to environment variablesaccess the php command.
With Linux, please keep in mind that after running the update.php, the file system need to be adjusted again.permissions
When the script is finished with the "Done" message, proceed to the next step.
Page of 59 63Export date: 17.10.2018 This document was created with BlueSpice
Page of 60 63Export date: 17.10.2018 This document was created with BlueSpice
Page of 61 63Export date: 17.10.2018 This document was created with BlueSpice
8.3. Rebuilding the search index
Contents
1 Tips for this Document ....................................................................................................................................... 61 2 Rebuilding the search index .............................................................................................................................. 61
In some cases it is needed to rebuild the search index. This document will show you the steps to do this.
Tips for this Document
Please, read this manual completely and work through the single installation steps one after another.The placeholder stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
Rebuilding the search index
Please open a command line on your system and change to . Execute the <installpath-bluespice>following command:
php extensions/BlueSpiceExtensions/ExtendedSearch/maintenance/searchUpdate.php (Linux)php extensions\BlueSpiceExtensions\ExtendedSearch\maintenance\searchUpdate.php (Windows))
With Windows, please take care that the are set correctly to environment variablesaccess the php command.
Depending on the size of your contents and uploads this can take a while.
Page of 62 63Export date: 17.10.2018 This document was created with BlueSpice
9. SyntaxHighlight GeSHi
Contents
1 Tips for this Document ....................................................................................................................................... 62 2 SyntaxHighlight_GeSHi and Linux ...................................................................................................................... 62 3 SyntaxHighlight_GeSHi and Windows ................................................................................................................ 62
The MediaWiki-extensions is not running correctly in some cases of setups. This SyntaxHighlight_GeSHidocument will show you how to configure your system environment that you can use the extension.
Tips for this Document
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 stands for the path to your BlueSpice installation, e.g <installpath-bluespice> C:
(Windows) or (Linux).\inetpub\wwwroot\bluespice /var/www/bluespice
SyntaxHighlight_GeSHi and Linux
If you are using Linux as BlueSpice server it's enough make two files executable ( ):chmod 755
<installpath-bluespice>/extensions/SyntaxHighlight_GeSHi/pygments/create_pygmentize_bundle<installpath-bluespice>/extensions/SyntaxHighlight_GeSHi/pygments/pygmentize
For more information please refer to the article " ".File System Permissions
SyntaxHighlight_GeSHi and Windows
First, please install . It is recommended to use the standard installation path (latest version of Python 2.7.x C:).\Python27
After that please open your windows command line and change to the subfolder "Scripts" in the Python installation path. Install the needed package "pygments" by using this command:
pip.exe install pygments
Now tell your BlueSpice installation where the pygmentize.exe can be found by setup this variable in your LocalSettings.php:
$wgPygmentizePath = "c:\\Python27\\Scripts\\pygmentize.exe";
Page of 63 63Export date: 17.10.2018 This document was created with BlueSpice
At the end please take care that the temporary directory of your PHP installation (default: C:\Windows\Temp) is fully writable by your webserver.
With these steps your should have a working system setup to use the SyntaxHighlight_GeSHi without problem.