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 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.
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 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. ∂ kit edu
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
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>