Mediawiki

Version

- Debian Lenny
- Mediawiki 1.11.xx

Installation

aptitude install  php5 php5-mysql php5-cgi php5-cli phpmyadmin

Konfiguration

Apache

• Anlegen eines WebHosts und des DocumentRoots, der Logfiles und des cgi-bin

PhpMyAdmin

• PhpMyAdmin ist nicht notwendig, erleichtert aber den umgang mit MySQL
• Ich binde den PhpMyAdmin in ein bestehendes Web ein. Wer das nicht möchte legt einen neuen Webhost im Apache2 ein. das einbinden erfolgt dann so:

vi /etc/apache2/site-enable/00xMyWebHost

• Am Ende wird dann die apache.conf von PhpMyAdmin eingebunden

  include /etc/phpmyadmin/apache.conf
</VirtualHost>

• Aufgerufen wird der PhpMyAdmin dan so

http://www.example.org/phpmyadmin

Mediawiki

• Download der aktuellen MediaWiki-Sourcen
• Entpacken des MediaWiki
• Kopieren der Dateien und Verzeichnise im htdocs

cp -a /[UNPACK]/mediawiki-1.xx/* /[HTDOCS]/

php.ini anpassen

vi /etc/php5/apache2/php.ini

  upload_max_filesize = 8M
  memory_limit = 32M

Rechte anpassen

cd /[path_to_wiki]/htdocs
chmod a+w

Datenbank und benutzer anlegen

• Bevor das Setup des Mediawiki ausgeführt werden kann, muss eine Datenbank und ein Benutzer angelegt werden. Dies geht am einfachsten mit PhpMyAdmin
• Rechte des Benutzers

MediaWiki Setup ausführen

http://www.example.org/

Backup

• Das Backup besteht aus drei Teilen
  • 1.) Dies MySQL Datenbank
  • 2.) Das htdocs-Verzeichnis (WEBROOT)
  • 3.) Die Mediawiki-Sourcen
    • Da sich die Datenbanktabellen bei neueren Versionen ändern können, empfehle ich den Restore eines Wiki´s immer auf Basis der selben MediaWiki-Version.

Backup MySQL-DB

 mysqldump \
         --databases [DB_NAME] \
         --all \
         --complete-insert \
         --add-drop-table \
         --host=localhost \
         --user=[DB_USER] \
         --password=[DB_PASSWORD] \
         > /[path_to_backup]/[BACKU_FIELE_NAME.sql]

• Dies kann man mit dem MySQL-Root Benutzer durchführen. Wenn man das Backup automatisiert, sollte man hierfür aber einen Backup-Benutzer anlegen, da das Passwort des Benutzers im Klartext im Script stehen muss. Die Rechte des Backupusers sollten, wie oben gezeigt, eingestellt sein.

Backup htdocs (WEBROOT)

tar czvf mediaWikiWebFiles.tgz /[path_to_web]/htdocs

MediaWiki

• Die MediaWiki Sourcen müssen natürlich nicht im regelmäßigen Backup enthalten sein. Hier reicht es, die Sourcen einmal so zu sichern, dass man jederzeit darauf zurückgreifen kann.

Restore

• Wenn das MediaWiki komplett neu eingerichtet werden muss (z.B durch Ausfall des Servers) empfehle ich erst eine Neuinstallation des Wikis wie oben beschrieben, dadurch wird sichergestellt, dass das Wiki richtig installiert ist. Danach kann der Restore wie weiter beschrieben durchgeführt werden.

Restore Webverzeichnis

tar xzvf /[path_to_backup]/WikiWebRoot.tgz -C /[path_to_web]/

Restore MySQL-DB

• Wenn nicht schon geschehen, wird zuerst die Datenbank mit Hilfe von PhpMyAdmin angelegt
• Danach kann das Backupfile der Datenbank geladen werden

mysql -uroot -p'[PASSWORD]' DB_NAME < /[path_to_backup]/DB_BACKUP_FILE.sql

Upgrade MediaWiki

• In dieser Doku wurde Upgrade von Version 1.11 auf 1.15.1 durchgeführt
• WICHTIG, vor dem Update ein Backup erstellen. (siehe oben)
• Download Madiawiki sourcen

wget http://download.wikimedia.org/mediawiki/1.15/mediawiki-1.15.1.tar.gz

• Entpacken direkt in das aktuelle Wiki-Verzeichnis

tar xvfz mediawiki-1.15.1.tar.gz -C /[path_to_your_wiki]/ --strip-components=1

• AdminSettings.php
  • In diesem Script wird der MySQL-Benutzer mit Password eingetraen, der Root-Rechte in der Datenbank besitzt. Wenn es nicht vorhanden ist, muss es angelegt werden

vi AdminSettings.php
<?php
 $wgDBadminuser      = 'wikiadmin';
 $wgDBadminpassword  = 'adminpass';

/*
 * Whether to enable the profileinfo.php script.
 */
 $wgEnableProfileInfo = false;