Cookies helfen uns bei der Bereitstellung von BlueSpice. Durch die Nutzung von BlueSpice erklärst du dich damit einverstanden, dass wir Cookies speichern.

3. Wiki Software 2.22

Dieses Dokument beschreibt die Installation einer fiktiven Wiki Software 2.22.0.



Hinweise zur Installation

  • Beim Editieren von Konfigurationsdateien mit einem Texteditor müssen die Dateien in UTF-8 Kodierung ohne BOM (Byte Order Mark) gespeichert werden.
  • Der Platzhalter <unzipped-archive> steht stellvertretend für den Pfad, wo Sie die heruntergeladene Erweiterung entpackt haben.
  • Der Platzhalter <mediawiki-url> steht stellvertretend für die URL zu Mediawiki, z.B. http://localhost/mediawiki.
  • Der Platzhalter <installpath-mediawiki> steht stellvertretend für den Pfad zur Mediawiki-Installation, z.B. C:\xampp\htdocs\mediawiki (Windows) oder /var/www/mediawiki (Linux).

Voraussetzungen

MediaWiki

Für die Installation von Wiki Software wird ein bereits installiertes und fertig konfiguriertes MediaWiki der Version 1.19.x - 1.22.x vorausgesetzt. Dieses muss (bei gestartetem Web- und Datenbankserver) im Browser unter <mediawiki-url> erreichbar sein.

Browser

Zur Benutzung von Wiki Software wird Firefox ab Version 3.6+ oder Internet Explorer ab Version 9+ empfohlen. Andere Browser (wie Internet Explorer 8) sollten funktionieren, sind bislang aber nicht ausreichend getestet worden.

Server

  • Webserver (Apache 2+, IIS 6+)
  • PHP Version 5.3, PHP 5.4. PHP 5.5 sollte funktionieren, ist aber nicht ausreichend getestet worden.
  • PHP Version 5.3.1 hat einen Bug, weswegen MediaWiki nicht funktioniert. Dies betrifft z. B. auch Xampp 1.7.3.
  • Java JRE 1.6 oder JRE 1.7
  • MySQL 5.x

    Folgende Zugangsdaten zum Datenbankserver müssen bekannt sein:
    • Host/IP-Adresse und Port
    • Username und Passwort für den Root-User (Create/Drop-Statements) und den Wiki-User
      (wurde ggf. während der Installation von MediaWiki angelegt)
      Bei einer Installation mit XAMPP ist als Benutzername "root" mit leerem Passwort voreingestellt.
    • Name der benutzten Datenbank
    • Das Tabellen-Präfix in der benutzten Datenbank

Installation

Komponenten von Wiki Software

Das <unzipped-archive> enthält die folgenden Verzeichnisse und Dateien:

  • extensions
  • skins
  • installcheck.php

Kopieren Sie die entpackten Elemente direkt in das Verzeichnis <installpath-mediawiki>.

Folgende Verzeichnisse müssen umbenannt werden:

  • <installpath-mediawiki>/extensions/WikiSoftwareExtensions/WikiSoftwareExtensions.php.template zu <installpath-mediawiki>/extensions/WikiSoftwareExtensions/WikiSoftwareExtensions.php
  • <installpath-mediawiki>/extensions/WikiSoftwareFoundation/data.template zu <installpath-mediawiki>/WikiSoftwareFoundation/data
  • <installpath-mediawiki>/extensions/WikiSoftwareFoundation/config.template zu <installpath-mediawiki>/extensions/WikiSoftwareFoundation/config

Für folgende Verzeichnisse müssen Schreibrechte für den Webserver gesetzt werden:

(Unter Linux z.B. chmod -R a+w <path>)

  • <installpath-mediawiki>/cache
  • <installpath-mediawiki>/images
  • <installpath-mediawiki>/extensions/WikiSoftwareFoundation/data
  • <installpath-mediawiki>/extensions/WikiSoftwareFoundtaion/config

Überprüfen der Voraussetzungen

Um weitere Voraussetzungen für die Installation überprüfen zu können, rufen Sie <mediawiki-url>/installcheck.php über den Browser auf. Angezeigt werden die weiteren Voraussetzungen und Informationen zur Installation sowie auftretende Fehler (z. B. bei fehlender Berechtigung).

Wenn hier alles in Ordnung (grünes "OK") ist, kann zum Setup von Wiki Software übergegangen werden.

Setup von wiki Software

Öffnen Sie die Datei <installpath-mediawiki>/LocalSettings.php in einem Texteditor und fügen Sie ganz unten folgende Zeilen hinzu:

require_once("$IP/extensions/WikiSoftwareDistribution/WikiSoftwareDistribution.php");
require_once("$IP/extensions/WikiSoftwareFoundation/WikiSoftwareFoundation.php");
require_once("$IP/extensions/WikiSoftwareExtensions/WikiSoftwareExtensions.php");
require_once("$IP/skins/WikiSoftwareSkin/WikiSoftwareSkin.php");

Konfiguration von Wiki Software

Führen Sie in der Kommandozeile folgenden Befehl aus:

php <installpath-mediawiki>\maintenance\update.php

Die Ausgabe sollte etwa so aussehen:

(...)
Creating bs_whoisonline table...ok
(...) 
Creating bs_saferedit table...ok
(...)
...done.

Wiki Software 2.22 for MediaWiki kann jetzt bereits unter <mediawiki-url> im Browser aufgerufen werden.

Sicherheit

Nachdem Ihr Wiki Software erfolgreich eingerichtet wurde, führen Sie zur Erhöhung der Sicherheit bitte folgende Schritte aus:

  • Entfernen Sie die Datei <installpath-mediawiki>/installcheck.php
  • Damit das SecureFileStore-Feature funktionieren kann, verbieten Sie den direkten HTTP-Zugang zu dem Verzeichnis <installpath-mediawiki>/images
  • Falls Sie das FlexiSkin-Feature benutzen möchten, müssen Sie das Verzeichnis <installpath-mediawiki>/images/wiki/flexiskin von der oben genannten Regel ausschließen.

Erhöhung der Performanz

Falls Sie Windows benutzen, versichern Sie sich, dass Sie in Ihrer LocalSettings.php $wgDBserver = "127.0.0.1"; anstelle von $wgDBserver = "localhost"; benutzen (wegen einem MySQL-Problem mit IPv6).

Fast fertig

Wenn Sie den Universal Export oder die Erweiterte Suche von Wiki Software nicht verwenden möchten, sind Sie hier bereits fertig. Falls doch, führen Sie die folgenden Schritte durch:

Webservices

Die Wiki Software-Erweiterungen "Erweiterte Suche" und "Universal Export" sind als Java-Webservices realisiert. Diese müssen auf einem Applikationsserver wie Apache Tomcat bereitgestellt werden. Für die folgende Beschreibung gehen wir von einer laufenden Tomcat-Installation bei $CATALINA_HOME aus.

Erweiterte Suche

Die Tomcat-Anbindung muss mit URIEncoding="UTF-8" konfiguriert werden:

Verändern Sie zum Konfigurieren die Datei $CATALINA_HOME\conf\server.xml (Windows) oder $CATALINA_HOME/conf/server.xml (Linux):

<Connector port="8080" maxHttpHeaderSize="8192" URIEncoding="UTF-8" ...

Erstellen Sie ein Verzeichnis für den Suchindex und kopieren Sie das Verzeichnis solr von <unzipped-archive>/extensions/WikiSoftwareExtensions/ExtendedSearch/webservices wie folgt:

Unter Windows:

mkdir C:\xampp\wiki_data
copy <unzipped-archive>\extensions\WikiSoftwareExtensions\ExtendedSearch\webservices\solr C:\xampp\wiki_data\

Unter Linux:

mkdir -p /opt/wiki_data
cp -r <unzipped-archive>/extensions/WikiSoftwareExtensions/ExtendedSearch/webservices/solr/opt/wiki_data/
chown -R tomcat6 /opt/wiki_data/solr # given that tomcat6 is the tomcat user

Der Pfad zu der Solr-Konfiguration (solr-Verzeichnis enthält solr.xml) muss in Tomcat über die Variable solr.solr.home gesetzt werden:

Unter Windows fügen Sie die folgenden Zeilen am Anfang der Datei $CATALINA_HOME\bin\catalina.bat ein:

set JAVA_OPTS=%JAVA_OPTS% -Dsolr.solr.home=C:\xampp\wiki_data\solr

Unter Linux (Debian) fügen Sie die folgenden Zeilen am Ende der Datei /etc/default/tomcat6 ein:

JAVA_OPTS="$JAVA_OPTS -Dsolr.solr.home=/opt/wiki_data/solr"

Starten Sie Tomcat neu.

Kopieren Sie "solr.war" aus dem entpackten Archiv nach <unzipped-archive>/extensions/WikiSoftwareExtensions/ExtendedSearch/webservices nach $CATALINA_HOME\webapps\ (Windows) $CATALINA_HOME/webapps/ (Linux):

Vergewissern Sie sich, dass die Datei <installpath-mediawiki>/extensions/WikiSoftwareExtensions/WikiSoftwareExtensions.php folgende Zeilen enthält:

require_once( __DIR__."/ExtendedSearch/ExtendedSearch.setup.php" );

Führen Sie "update.php" erneut aus:

Linux:

php <installpath-mediawiki>/maintenance/update.php

Windows:

php <installpath-mediawiki>\maintenance\update.php

Konfigurieren Sie die Erweiterte Suche und den Webservice über Ihren Browser:

Wiki (linke Navigation) -> Admin -> Einstellungen -> Wiki -> Wiki - MediaWiki-Einstellungen -> Erweiterte Suche:

Universal Export

Mit WikiSoftware 2.22 werden zwei PDF Export Backends ausgeliefert. Die folgende Tabelle bietet einen kurzen Überblick:

  bn2pdf.war BSHtml2PDF.war
JRE 6 7
Apache Tomcat 6 7
Implementierung SOAP Servlet 3.0
URL in WikiAdmin (i.e.) http://localhost:8080/bn2pdf http://localhost:8080/BShtml2PDF

Kopieren Sie die gewünschte WAR Datei nach $CATALINA_HOME\webapps\ (Windows) $CATALINA_HOME/webapps/ (Linux).

Vergewissern Sie sich, dass <installpath-mediawiki>/extensions/WikiSoftwareExtensions/WikiSoftwareExtensions.php die folgenden Zeilen enthält:

require_once( __DIR__."/UniversalExport/UniversalExport.setup.php" );
require_once( __DIR__."/UEModulePDF/UEModulePDF.setup.php" );

Aktivieren Sie den Universal Export in Ihrem Browser und konfigurieren Sie den neuen Webservice:

Wiki (linke Navigation) -> Admin -> Einstellungen -> Wiki -> Wiki - MediaWiki-Einstellungen -> UniversalExport PDF Modul

Ende

Ihre Wiki Software-Installation sollte jetzt einsatzbereit sein. Viel Spaß!

Anhänge

Diskussionen