Setup:Installation Manual/Optimization/Caching

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 installtion 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 <installpath-bluespice> stands for the path to your BlueSpice installation, e.g C:\inetpub\wwwroot\bluespice (Windows) or /var/www/bluespice (Linux).

Linux vs. Windows

Please note that with equal hardware conditions, BlueSpice empirically runs more performantly on Linux than on Windows servers.

Indicate Cache-Directory angeben

This forces BlueSpice to use the filesystem instead of the database for some internal caches. To do this, create the file <installpath-bluespice>/settings.d/001-Directories.php and add the following content:

                    <?php

$wgCacheDirectory = "$IP/cache";

                

Save and close the file. left Beachten Sie, dass das Verzeichnis

Note that the directory "cache" in <installpath-bluespice> durch den Webserver beschreibbar sein muss. Nähere Informationen erhalten Sie auf der Seite Dateisystemrechte.Namensauflösung der Datenbank must be writable by the web server. For more information, read the file system permissions.

Name Resolution of the Database

Sofern Sie dies nicht beim Setup von MediaWiki bereits beachtet haben sorgen Sie dafür, dass der Datenbankserver, sollte er auf dem selben Server wie BlueSpice liegen, möglichst über die IP angesprochen wird. Insbesondere Windows hat sehr oft Probleme beim Auflösen von "localhost".

Öffnen Sie hierzu If this hasn't already been done while setting up MediaWiki, please make sure that the database server will be 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 <installpath-bluespice>/LocalSettings.php und suchen die Variable $wgDBserver. Die Zeile sollte im Idealfall lauten and locate the variable $wgDBserver. The line should ideally be:

$wgDBserver = "127.0.0.1";

Activate Memcached aktivieren

Erstellen Sie hierfür die Datei Create the file <installpath-bluespice>/settings.d/001-Memcached.php und fügen Sie dort folgenden Inhalt ein: Speichern und schließen Sie die Datei.

left Voraussetzung hierfür ist ein installierter und konfigurierter Memcached-Server auf dem BlueSpice-Server. Informationen hierzu erhalten Sie auf der Seite Memcached.

PHP Memory Limit erhöhen

and add the following content:

                    <?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 memcached article for more information.

Increase PHP Memory Limit

Ein höheres Speicherlimit von PHP führt zu einer schnelleren Ausführung. Dies kann in der A higher memory limit of PHP results in a faster execution. ¶ This can be changed in php.ini geändert werden. Suchen Sie dort nach folgender Option und passen Sie diese an. Locate and adjust the following option:

                memory_limit = 512M (entsp.means 512 MB - jevaries nachfrom verfügbaremthe Arbeitsspeicheravailable variabelmemory)

            

Nach dem Abspeichern und Schließen der After saving and closing php.ini muss der Webserver neu gestartet werden, the web server must be restarted.

Activate Bytecode Cache in PHP aktivieren

Seit PHP Since PHP 5.5 wird der Bytecode Cache the bytecode cache "opcache" mit ausgeliefertis included.

Dieser muss zunächst in der This needs to be activated in the php.ini aktiviert werden. Überprüfen Sie dort, ob das Modul eingebunden ist. Dies erfolgt über die Zeile first. Check if the module is integrated there. This is done via the line: 

zend_extension=opcache.dll (Windows)
zend_extension=opcache.so (Linux)

left Beachten Sie unter Linux bitte zusätzlich die jeweiligen Vorgaben des jeweiligen Distributors zum Aktivieren von PHP-Modulen.

Nehmen Sie folgende Konfiguration des opcache in der php.ini vor. Im Regelfall sollten alle Optionen bereits vorhanden, aber mit Semikolon (;) am Zeilenanfang auskommentiert sein. Suchen Sie die jeweilige Option in der php.ini, entfernen das Semikolon am Zeilenanfang und passen Sie die Einstellungen wie folgt an

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=1
opcache.memory_consumption=512 (entsp.means 512 MB - jevaries nachfrom verfügbaremthe Arbeitsspeicheravailable variabelmemory)
opcache.max_accelerated_files=5000
opcache.validate_timestamps=1
opcache.revalidate_freq=2

            

Nach dem Abspeichern und Schließen der After saving and closing php.ini muss der Webserver neu gestartet werden, the web server must be restarted.

Deactivate JobQueue deaktiviere

Lesen Sie hierzu den Abschnitt For this, read the paragraph "runJobs.php" auf der Seite in the "Cronjobs" article.