Zuletzt bearbeitet vor 9 Monaten
von Margit Link-Rodrigue

Setup:Installationsanleitung/Installation BlueSpice WikiFarm: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
Keine Bearbeitungszusammenfassung
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:
{{Hinweisbox|boxtype=note|Note text=BlueSpiceWikiFarm muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.}}
{{Hinweisbox|boxtype=note|Note text=BlueSpiceWikiFarm muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.}}
==Voraussetzungen PHP==
==Voraussetzungen PHP==
Bitte stellen Sie sicher, dass die PHP-Erweiterung ZIP archiviert ist, die für BlueSpiceWikiFarm zusätzlich benötigt wird.
Bitte stellen Sie sicher, dass die PHP-Erweiterung ZIP archiviert ist, die für BlueSpiceWikiFarm zusätzlich benötigt wird,  um Instanzen löschen zu können.


==Sicherstellen des korrekten Pfades im Dateisystem==
==Sicherstellen des korrekten Pfades im Dateisystem==
Wichtig für den Betrieb von BlueSpiceWikiFarm ist, dass BlueSpice im Verzeichnis <code>/w</code> des DocumentRoot Ihres Webservers bzw. VirtualHosts liegt.<br />
Wichtig für den Betrieb von BlueSpiceWikiFarm ist, dass BlueSpice im Verzeichnis <code>/w</code> des DocumentRoot Ihres Webservers bzw. VirtualHosts liegt.<br />Bitte stellen Sie also sicher, dass Sie die komplette Codebase dorthin verschieben, sofern dies noch nicht der Fall ist.<br /><br />Nötig für einen fehlerfreien Betrieb ist anschließend, dass die Variable<code>$wgScriptPath</code> in der <code>LocalSettings.php</code> den Pfad <code>/w</code> beinhaltet.<br />
Bitte stellen Sie also sicher, dass Sie die komplette Codebase dorthin verschieben, sofern dies noch nicht der Fall ist.<br /><br />
Nötig für einen fehlerfreien Betrieb ist anschließend, dass die Variable <code>$wgScriptPath</code> in der <code>LocalSettings.php</code> den Pfad <code>/w</code> beinhaltet.<br />
<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
$wgScriptPath = "/w";
$wgScriptPath = "/w";
Zeile 19: Zeile 17:
*<code>_sf_archive</code> - hier werden gelöschte Farminstanzen inklusive deines Datanbankdump als ZIP-Archiv abgelegt
*<code>_sf_archive</code> - hier werden gelöschte Farminstanzen inklusive deines Datanbankdump als ZIP-Archiv abgelegt


Achten Sie darauf, dass diese Ordner durch den Webserver beschreibbar sind ([[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|siehe auch unsere Hinweise im Helpdesk hierzu]])!
Achten Sie darauf, dass diese Ordner durch den Webserver beschreibbar sind ([[Setup:Installationsanleitung/Sicherheitseinstellungen/Dateisystemrechte|siehe Sicherheitseinstellungen]])!


chown -R www-data:root $BS_DATA_DIR/_sf_instances $BS_DATA_DIR/_sf_archive
chmod -R 755 $BS_DATA_DIR/_sf_instances $BS_DATA_DIR/_sf_archiv
==Anlegen der LocalSettingsAppend.php==
==Anlegen der LocalSettingsAppend.php==
Das Einbinden der Erweiterung "BlueSpiceWikiFarm" setzt zunächst eine zusätzliche Kofigurationsdatei mit dem Namen <code>LocalSettingsAppend.php</code> voraus. Legen Sie diese Datei auf selber Ebene wie die <code>LocalSettings.php</code> an und füllen Sie diese mit folgendem Inhalt:<br />
Das Einbinden der Erweiterung "BlueSpiceWikiFarm" setzt zunächst eine zusätzliche Kofigurationsdatei mit dem Namen <code>LocalSettingsAppend.php</code> voraus. Legen Sie diese Datei auf selber Ebene wie die <code>LocalSettings.php</code> an und füllen Sie diese mit folgendem Inhalt:<br />
Zeile 45: Zeile 45:
Konfigurieren Sie diese RewriteRules für die Ebene des DocumentRoot Ihres Webservers bzw. Ihres VirtualHosts.
Konfigurieren Sie diese RewriteRules für die Ebene des DocumentRoot Ihres Webservers bzw. Ihres VirtualHosts.


{{Textbox|boxtype=note|header=|text=Bei Problemen mit Leerzeichen im Seitennamen: Fügen Sie <code>RewriteRule ^([^\ ]*)\ (.*)$ $1_$2 [E=rspace:yes,N]</code>  hinzu,falls diese "rewrite rule" nicht bereits angegeben ist.|icon=yes}}
==Neue Rechte bei MySql anlegen==
<syntaxhighlight lang="mysql">
GRANT ALL ON ´sfr\_%´.* to ´bluespice´@´127.0.0.1´ identified by ´password´;
</syntaxhighlight>
==Wichtig für Windows Farming==
<nowiki>https://www.mediawiki.org/wiki/Manual:$wgPhpCli</nowiki>
== cronjobs ==
Muss als Apache-user ausgeführt werden:<syntaxhighlight lang="bash">
*/5 * * * * php /var/www/bluespice/w/extensions/BlueSpiceWikiFarm/SimpleFarmer/maintenance/RunForAll.php --script=maintenance/runJobs.php
*/1 * * * * php /var/www/bluespice/w/extensions/BlueSpiceWikiFarm/SimpleFarmer/maintenance/FarmProcessRunner.php
</syntaxhighlight>
==Abschluss==
==Abschluss==
Die Installation der BlueSpiceWikiFarm ist nun abgeschlossen. Sie erreichen die Farmverwaltung ab sofort im Hauptwiki unter der Spezialseite "Special:SimpleFarmer" (Farmverwaltung).
Die Installation der BlueSpiceWikiFarm ist nun abgeschlossen. Sie erreichen die Farmverwaltung ab sofort im Hauptwiki unter der Spezialseite "Special:SimpleFarmer" (Farmverwaltung).

Aktuelle Version vom 7. Februar 2024, 11:07 Uhr

Eine existierende BlueSpice pro Installation kann problemlos durch BlueSpiceWikiFarm erweitert werden. Die existierende Installation nimmt dabei die Rolle des Hauptwikis (= Farmverwaltung) an. Die Inhalte dort bleiben bestehen und können dort wie gewohnt weiterhin gepflegt werden.

Hinweis:BlueSpiceWikiFarm muss separat erworben werden und ist kein automatischer Bestandteil von BlueSpice pro.

Voraussetzungen PHP[Bearbeiten | Quelltext bearbeiten]

Bitte stellen Sie sicher, dass die PHP-Erweiterung ZIP archiviert ist, die für BlueSpiceWikiFarm zusätzlich benötigt wird, um Instanzen löschen zu können.

Sicherstellen des korrekten Pfades im Dateisystem[Bearbeiten | Quelltext bearbeiten]

Wichtig für den Betrieb von BlueSpiceWikiFarm ist, dass BlueSpice im Verzeichnis /w des DocumentRoot Ihres Webservers bzw. VirtualHosts liegt.
Bitte stellen Sie also sicher, dass Sie die komplette Codebase dorthin verschieben, sofern dies noch nicht der Fall ist.

Nötig für einen fehlerfreien Betrieb ist anschließend, dass die Variable$wgScriptPath in der LocalSettings.php den Pfad /w beinhaltet.

$wgScriptPath = "/w";

Erstellen der nötigen Ordner für BlueSpiceWikiFarm[Bearbeiten | Quelltext bearbeiten]

BlueSpiceWikiFarm benötigt im Ordner /w auf selber Ebene wie die LocalSettings.php zwei zusätzliche Ordner, die Sie dort anlegen müssen:

  • _sf_instances - hier werden alle Daten und Konfigurationen für die jeweiligen Instanzen abgelegt
  • _sf_archive - hier werden gelöschte Farminstanzen inklusive deines Datanbankdump als ZIP-Archiv abgelegt

Achten Sie darauf, dass diese Ordner durch den Webserver beschreibbar sind (siehe Sicherheitseinstellungen)!

chown -R www-data:root $BS_DATA_DIR/_sf_instances $BS_DATA_DIR/_sf_archive
chmod -R 755 $BS_DATA_DIR/_sf_instances $BS_DATA_DIR/_sf_archiv

Anlegen der LocalSettingsAppend.php[Bearbeiten | Quelltext bearbeiten]

Das Einbinden der Erweiterung "BlueSpiceWikiFarm" setzt zunächst eine zusätzliche Kofigurationsdatei mit dem Namen LocalSettingsAppend.php voraus. Legen Sie diese Datei auf selber Ebene wie die LocalSettings.php an und füllen Sie diese mit folgendem Inhalt:

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

Einbinden der Erweiterung "BlueSpiceWikiFarm"[Bearbeiten | Quelltext bearbeiten]

Ersetzen Sie in der LocalSettings.php die Zeile

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

durch

require_once "$IP/extensions/BlueSpiceWikiFarm/BlueSpiceWikiFarm.php";

Konfiguration Webserver[Bearbeiten | Quelltext bearbeiten]

Im Ordner extensions/BlueSpiceWikiFarm/SimpleFarmer/doc finden Sie Beispieldateien für RewriteRules, die für BlueSpiceWikiFarm nötig sind:

  • htaccess.template - RewriteRules für Apache
  • web.config.template - RewriteRules für IIS

Konfigurieren Sie diese RewriteRules für die Ebene des DocumentRoot Ihres Webservers bzw. Ihres VirtualHosts.

Bei Problemen mit Leerzeichen im Seitennamen: Fügen Sie RewriteRule ^([^\ ]*)\ (.*)$ $1_$2 [E=rspace:yes,N] hinzu,falls diese "rewrite rule" nicht bereits angegeben ist.

Neue Rechte bei MySql anlegen[Bearbeiten | Quelltext bearbeiten]

GRANT ALL ON ´sfr\_%´.* to ´bluespice´@´127.0.0.1´ identified by ´password´;

Wichtig für Windows Farming[Bearbeiten | Quelltext bearbeiten]

https://www.mediawiki.org/wiki/Manual:$wgPhpCli

cronjobs[Bearbeiten | Quelltext bearbeiten]

Muss als Apache-user ausgeführt werden:

*/5 * * * * php /var/www/bluespice/w/extensions/BlueSpiceWikiFarm/SimpleFarmer/maintenance/RunForAll.php --script=maintenance/runJobs.php
*/1 * * * * php /var/www/bluespice/w/extensions/BlueSpiceWikiFarm/SimpleFarmer/maintenance/FarmProcessRunner.php

Abschluss[Bearbeiten | Quelltext bearbeiten]

Die Installation der BlueSpiceWikiFarm ist nun abgeschlossen. Sie erreichen die Farmverwaltung ab sofort im Hauptwiki unter der Spezialseite "Special:SimpleFarmer" (Farmverwaltung).

Wichtig!Sollte der localhost nicht erreichbar sein, laden Sie sich die IIS Erweiterung "URL Rewrite" herunter. https://www.iis.net/downloads/microsoft/url-rewrite



Feedback zur Dokumentation ist im Community-Forum möglich.