Anlegen eines Wikis

Wikis finden heutzutage vielerorts Verwendung, doch wenn jeder sich die Wiki-Software selbst installiert, ist dies Ressourcen-Verschwendung, und es besteht zudem die Gefahr, dass nicht immer die aktuelle, sichere Software-Version verwendet wird. Deswegen bieten wir eine vorinstallierte Software mit automatischen Updates an, die nur noch konfiguriert werden muss.

 

MediaWiki

MediaWiki-Logo MediaWiki ist eines der beliebtesten Wikis und wird z.B. auch für die Wikipedia eingesetzt. Deshalb stellen wir eine globale Installation des MediaWikis zur Verfügung, die über die Debian-Update-Mechanismen automatisch aktualisiert wird. Die einzelnen Wiki-Instanzen verweisen dann nur noch auf diese globale Installation; lediglich die Konfigurationsdatei der jeweiligen Wiki-Instanz liegt lokal vor.

Installation

Das Wiki wird in einem (eigenen) Unterverzeichnis des eigenen Web-Auftritts (z.B. $HOME/www.oe.kit.edu/wiki) installiert. Im Weiteren werden wir das Beispiel mit dem eigenen Web-Auftritt weiterverfolgen; die Vorgehensweise gilt analog natürlich auch für die persönliche Homepage.

Zum Anlegen des Wikis gibt es ein Script, das auf dem Webserver aufgerufen werden muss. Deshalb steht am Anfang das Einloggen auf dem Webserver. Zum Aufruf des Skriptes muss man per ssh eingeloggt sein. ssh-Login auf die Webserver ist nur mit dem Webaccount <oe-web-00...> und innerhalb des KIT-Netzes möglich.

   ssh <webaccount>@www.oe.kit.edu

Das Script wird nun mit der gewünschten URL des neuen Wikis aufgerufen; dabei wird das Verzeichnis auch gleich angelegt, falls es noch nicht existiert:

   mediawiki www.oe.kit.edu/wiki

Jetzt muss die vom Script ausgegebene Konfigurations-URL aufgerufen werden - hier alles (ggf. gemäß Anleitung) ausfüllen; dabei wird die Konfigurationsdatei erzeugt und die benötigten Datenbanken angelegt. Der Zugang zum Datenbankserver muss ggf. vorher angelegt werden (-> MySQL):

   https://www.oe.kit.edu/wiki/mw-config/

(Der Kommentar auf der Installationsseite zu /var/lib/mediawiki/config/LocalSettings.php und /etc/mediawiki bezieht sich nur auf eine globale Installation und kann ignoriert werden).
Die erzeugte LocalSettings.php muss im lokalen Wiki-Verzeichnis abgelegt werden:

   /home/ws/<webaccount>/www.oe.kit.edu/htdocs/wiki/

Wenn sie während der Konfiguration Extensions ausgewählt haben, müssen diese noch im lokalen extension-Verzeichnis verlinkt werden:

mit cd ins Verzeichnis extensions wechseln und jeweilige Extension wie folgt verlinken, z.B.:

   ln -s /usr/share/mediawiki/extensions/ConfirmEdit/ ConfirmEdit

 

Nach erfolgter Konfiguration des neuen Wikis ruft man erneut das Installations-Script auf; dabei wird die neu erzeugte Konfigurationsdatei aktiviert und die Konfigurationsseite entfernt:

   mediawiki www.oe.kit.edu/wiki

Jetzt sollte dem Einsatz des neuen Wikis nichts mehr im Wege stehen!

Umzug Mediawiki

Wiki-Umzug 2024:

Auf den neuen Webservern wird die Mediawiki Version 1.39.x zur Verfügung gestellt. Der Umzug der zentral installierten Mediawikis auf diese Version sollte in zwei Schritten gemacht werden (1.31. -> 1.35. -> 1.39), da es andernfalls zu Datenverlust kommen kann (Handbuch:Aktualisierung - MediaWiki).

Dafür wird für alle Mediawiki-Installationen auf den laufenden Webservern Anfang April (der genaue Termin wird noch bekannt gegeben) ein Upgrade auf die  Version 1.35. gemacht. Das Mediawiki-Upgrade auf die Version 1.39. erfolgt dann "individuell" mit dem Umzug des jeweiligen Webservers auf das neue Betriebssystem

Der Download von Extensions, die nicht zentral vorhanden sind (z.B. Auth_remoteuser) in den Versionen passend zu Mediawiki 1.35. und Mediawiki 1.39. kann jetzt schon gemacht werden.

 

Datenbanksicherung:

https://www.scc.kit.edu/phpmyadmin

Datenbankserver auswählen, der für das Mediawiki konfiguriert ist. Login mit Benutzernamen und Passwort, die für das Mediawiki genutzt werden.

"Exportieren" -> "Angepasst"  -> gewünschte Datenbank anklicken.
Die restlichen Einstellungen können beibehalten werden. Nach unten scrollen

-> "Ok" klicken, Datenbank wird lokal auf ihrem Rechner abgespeichert.

 

Datenbank exportieren

 

etc.

 

Extensions:

Mediwiki-Extension suchen und passende Version im Verzeichnis .../extensions/ ablegen.

Beispiel "Auth_remoteuser": 

https://www.mediawiki.org/wiki/Extension:Auth_remoteuser -> "Download" -> 1.39 auswählen -> "Continue" -> ...tar.gz-Datei abspeichern und ins extension-Verzeichnis ablegen.
Ältere Version müssen über das Repository ausgewählt und heruntergeladen werden. Zum Aktivieren Verzeichnis (z.B.  Auth_remoteuser -> Auth_remoteuser_bak) umbenennen, neue Extension auspacken. Dies erst zum Zeitpunkt der Umzüge machen.

Download Auth_remoteuser Version 1.35
Download Auth_remoteuser Version 1.39

Bereits vorhandene Extensions:

Die folgenden Extensions sind bereits installiert (unter /usr/share/mediawiki/extensions-core/) und brauchen im lokalen extension-Verzeichnis nur verlinkt zu werden, falls sie genutzt werden sollen. Beispiel für die Verlinkung von ConfirmEdit:

mit cd ins Verzeichnis extensions wechseln und das folgendende aufrufen

ln -s /usr/share/mediawiki/extensions/ConfirmEdit/ ConfirmEdit

Extensions Mediawiki 1.31.x Extensions Mediawiki 1.39.x
  AbuseFilter
CategoryTree CategoryTree
Cite Cite 
CiteThisPage CiteThisPage
CodeEditor CodeEditor
ConfirmEdit ConfirmEdit
Gadgets Gadgets
ImageMap ImageMap
 InputBox  InputBox
Interwiki Interwiki
LocalisationUpdate  
  Math
MultimediaViewer MultimediaViewer
Nuke Nuke
OATHAuth OATHAuth
  PageImages
ParserFunctions ParserFunctions
PdfHandler PdfHandler
Poem Poem
Renameuser Renameuser
ReplaceText ReplaceText
  Scribunto
  SecureLinkFixer
SpamBlacklist SpamBlacklist
SyntaxHighlight_GeSHi SyntaxHighlight_GeSHi
  TemplateData
  TextExtracts
TitleBlacklist TitleBlacklist
  VisualEditor
WikiEditor WikiEditor

 

LocalSettings.php und Wiki-Verzeichnis:

Die LocalSetting.php sichern und eine "Archiv-Sicherung" des Wiki-Verzeichnisses über den Aufruf des tar-Befehls machen. Falls sich das Wiki im Unterverzeichnis /wiki/ befindet lautet der Befehl z.B.:

tar -cvf archiv_wiki.tar $HOME/www.oe.kit.edu/htdocs/wiki/

 

Migration 1. Schritt auf Mediawiki 1.35:

Der konzertierte Umzug aller Mediawikis auf Version 1.35. wird voraussichtlich von uns Webmastern gemacht, der genaue Termin und Details werden noch bekannt gegeben. LocalSettings.php müssen überprüft und ggf. angepasst werden.

Migration 2. Schritt auf Mediawiki 1.39:

Die Webserver werden spätestens zum 30.6.2024 umgestellt. Bitte vor der Migration des Mediawiki webmaster does-not-exist.kit edu kontaktieren. Wir stellen den Server auf die neue Hardware um, dann können sie sich wie gewohnt einloggen und das Wiki  "updaten", bzw. wir führen das Update aus.

Vorher die LocalSettings.php anpassen:
obsolet ist:
require_once( "$IP/includes/DefaultSettings.php" )
wenn benötigt bitte in 
require_once "$IP/includes/PlatformSettings.php"   
ändern oder aus der Konfiguration entfernen.

Ggf. muss 
$wgCacheDirectory = "$IP/cache"
ergänzt werden.

Zum Upgrade, wie beim Neuanlegen das Mediawiki-Skript aufrufen. Falls das Wiki z.B. in einem Unterverzeichnis angelegt wurde: 

   mediawiki www.oe.kit.edu/wiki

 

mediawiki-Skript Ausgabe

 

Nach der Konvertierung ist das Mediawiki auf den alten Servern nicht mehr aufrufbar.

Ggf. können auch wir die Migration für sie durchführen.

Server-Konfiguration

Um neue Seiten im Wiki über eine URL zu erzeugen muss der Server dafür konfiguriert werden.

<Directory /home/ws/OE-web-0024/www.<OE>.kit.edu/htdocs/wiki/>
    ProxyErrorOverride Off
</Directory>