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:

Zum Umziehen des Mediawiki von den alten "Webs" (Mediawiki-Version 1.27) auf die neue Hardware, Server test-web1... test-web4 (Mediawiki-Version 1.31.7) bitte zunächst die Datenbank sichern und die selbst eingebundenen Extensions überprüfen (z.B. Auth_remoteuser), da auch hier ggf. eine neue Version installiert werden muss.

 

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 vorgebenen 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 ablegen.

Beispiel "Auth_remoteuser":

https://www.mediawiki.org/wiki/Extension:Auth_remoteuser -> "Download" -> 1.31 auswählen -> "Continue" -> ...tar.gz-Datei abspeichern und ins extension-Verzeichnis ablegen.

Altes Verzeichnis (z.B.  Auth_remoteuser -> Auth_remoteuser_bak) umbenennen, neue Extension auspacken.

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

 CategoryTree
 Cite
 CiteThisPage
 CodeEditor
 ConfirmEdit
 Gadgets
 ImageMap
 InputBox
 Interwiki
 LocalisationUpdate
 MultimediaViewer
 Nuke
 OATHAuth
 ParserFunctions
 PdfHandler
 Poem
 Renameuser
 ReplaceText
 SpamBlacklist
 SyntaxHighlight_GeSHi
 TitleBlacklist
 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:

Die Server werden spätestens zum 1.7.2020 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 wie unten angegeben "Updaten".

Vorher die LocalSettings.php anpassen

Als Skins bitte nur:

wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Timeless' );
wfLoadSkin( 'Vector' );

nutzen, andere Skins müssen in der LocalSettings.php auskommentiert werden (mit führendem #), z.B.

#wfLoadSkin( 'CologneBlue' );

oder die Zeile komplett entfernt 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>