Mediawiki Server: Erstinstallation, Backup und Recovery
angepasste Anweisungen für OpenSuse-Server. Alle Befehle als root.
Erstinstallation (neue Wiki)
Dependencies
- auf http://software.opensuse.org/search mediawiki One-click-installer suchen und installieren
(z.B. von Michael Knight)
Dies installiert alle notwendigen Pakete (mysql, php, ...). Das mediawiki-repository kann jetzt wieder entfernt werden, da in Folge am besten gleich die neueste Version von Mediawiki installiert wird.
MySQL konfigurieren und starten (bei Erstbenutzung)
rcmysql start mysql_secure_installation # in obigem Dialog ein root password eingeben. In Folge wird in dieser # Anleitung davon ausgegangen, dass das Passwort: mysql_rootpw eingegeben # wurde.
Jetzt im yast/System/Systemdienste das Autostarthäkchen setzen.
Apache konfigurieren und starten
Am besten per yast/Netzwerkdienste/Http-Server. Die defaults sind ok (Htmlseiten werden im Ordner /srv/www/htdocs abgelegt. Hier gleich das Häkchen setzen, dass der Port für die Firewall geöffnet wird.
Ein Neustart des Webservers ist jederzeit mit rcapache2 restart
möglich.
Wikipedia runterladen, installieren, konfigurieren
Im Ordner /srv/www/htdocs/mediawiki sollte eine (veraltete Mediawiki)-Installation stehen. Die kann dort als Referenz erst einmal bleiben. Wir downloaden und installieren jetzt die neueste Version von http://www.mediawiki.org/wiki/Download. Zum Zeitpunkt des Artikelschreibens ist dies die Version 1.14. Es wird an dieser in den Ordner wiki installiert. Dieser Ordner erscheint in der Webseite. Bitte in den folgenden Schritten anpassen, da eine nachträgliche Umbenennung zwar nicht unmöglich, aber etwas frickelig ist.
cd /srv/www/htdocs wget http://download.wikimedia.org/mediawiki/1.14/mediawiki-1.14.0.tar.gz tar xf mediawiki-1.14.0.tar.gz mv mediawiki-1.14.0/ wiki chown -R root:www wiki/
Im Webbrowser jetzt die Adresse http://localhost/wiki aufrufen. Der freundlichen Aufforderung Please set up the wiki first. folgen, zB.:
... # Anstatt "FritzMeier" und "wiki_pwmeier" bitte # eigene Werte verwenden. Admin username: FritzMeier Password: wiki_pwmeier Password confirm: wiki_pwmeier ... # Anstelle von "wikidb", "wikiuser" kann man, anstelle von # "mysql_wikiuserpw" sollte man andere Werte verwenden. # Database name ist der Name der mysql Datenbank. Database name: wikidb # Name des Datenbankusers, der in MySQL automatisch angelegt und mit # den nötigen Rechten versehen wird DB username: wikiuser DB password: mysql_wikiuserpw DB password confirm: mysql_wikiuserpw ... # Hier kommt der mysql root account von weiter oben rein Superuser account: [x] Superuser name: root Superuser password: mysql_rootpw
Jetzt kann der Install Mediwiki Button geklickt werden.
Dies legt in MySQL eine neue Datenbank namens wikidb an,
erzeugt in mysql den User wikiuser mit den notwendigen Rechten
für diese DB und - last not least - erstellt im Ordner
/srv/www/htdocs/wiki/config
die Datei
LocalSettings.php
. Diese muss verschoben werden:
mv /srv/www/htdocs/wiki/config/LocalSettings.php /srv/www/htdocs/wiki/config
Das wars. Die Mediawiki ist jetzt fertig zum Bearbeiten unter http://localhost/wiki.
Backup
Nur zwei Dinge sind zu tun, um alle relevanten Daten zu sichern.
wikidb mysql Datenbank dumpen
Wobei wikidb der weiter oben gewählte Datenbankname ist. Das einzugebende Passwort ist lautet in diesem Tutorial mysql_rootpw, in einer konkreten Installation natürlich anders.
mysqldump wikidb -u root -p > wikidb.sqldump
Datei wikidb.sqldump zippen und sichern.
Mediawiki sichern (hauptsächlich wegen LocalSettings.php)
cd /srv/www/htdocs tar czf wiki.tgz wiki/
Sichern.
Recovery (gesichertes Backup wieder einspielen)
- die Schritte der Erstinstallation durchführen.
je nachdem ob mysql und apache bereits laufen, nur die Punkte bei "Wikipedia runterladen, installieren, konfigurieren" abarbeiten. (Zwecks Anlegen des wikiusers und der wikidb in mysql durch das Config-script der Mediawiki).
- den sqldump in mysql zurückspielen.
mysql wikidb -u root -p < wikidb.sqldump
- Variante 1: Anpassungen aus der gesicherten LocalSettings.php in die neue übertragen.
# meld ist ein grafisches Tool zum interaktiven Einarbeiten von diffs meld LocalSettings.php LocalSettings.php.old
- Variante 2: alte Mediawiki aus wiki.tgz regenerieren
Durch Abarbeiten der folgenden Befehle startend vom mv
Befehl lässt sich auch das Stammverzeichnis einer Wikipedia verschieben(umbenennen).
(setzt voraus, dass der Ordner wiki/config nicht folgend der Installationsanweisung der Mediawiki nach Konfiguration gelöscht wurde :-[)
cd /srv/www/htdocs tar czf wiki.tgz wiki/ cd wiki mv LocalSettings.php LocalSettings.php.old # jetzt Konfiguration wie im Punkt # "Wikipedia runterladen, installieren, konfigurieren" beschrieben # durchführen firefox http://localhost/wiki .... mv config/LocalSettings.php # Anpassungen aus der gesicherten LocalSettings.php in die neue übertragen. meld LocalSettings.php LocalSettings.php.old