Upgrading

Vor dem Upgrade solltest Du immer das Changelog lesen, um zu sehen, ob sich etwas Wichtiges geändert hat. Um herauszufinden, welche Version benutzt wurde, schau in die Quellen einer HTML-Seite, die mit DokuWiki erstellt wurde - dort sollte etwas stehen wie <meta name=“generator” content=“DokuWiki 2005-02-06” /> ¹⁾.

Der einfachste Weg zum Upgrade führt über folgende Schritte:

• Verschiebe deine alte Installation in ein Backup-Verzeichnis
• Entpacke die neue Version
• Kopiere .htpasswd und .htaccess (falls verwendet) ins neue Installationsverzeichnis
• Kopiere die Inhalte deines alten data-Verzeichnisses ins neue Installationsverzeichnis
• Kopiere alle modifizierten lokalen Konfigurations-Dateien aus dem conf-Verzeichnis ins neue Installationsverzeichnis
• Kopiere alle Plugins in das lib/plugins-Verzeichnis der neuen Installation (sofern sie für die neue Version noch funktionsfähig sind)
• Kopiere Dein template in das lib/tpl-Verzeichnis der neuen Installation (sofern es für die neue Version noch funktionsfähig ist)
• Kopiere alle geänderten Textdateien aus inc/lang/en (oder wo auch immer).

Wenn Du nach dem Upgrade Inkonsistenzen im Verhalten des DokuWiki feststellst, solltest Du die Cache-Dateien in data/_cache/ (data/cache/ in neueren Versionen) löschen. Versichere Dich auch, dass Dein Browser kein altes Sytlesheet gecachet hat.

Solltest Du einfach dein gesamtes conf/-Verzeichnis kopieren, musst Du die Datei conf/msg anpassen - es muss die selbe Nummer wie die sein, die in den eckigen Klammern der Hinweisnachricht der neuen Version angezeigt wird (die Du sehen solltest, sofern Du nicht Check for Updates deaktiviert hast). Versichere Dich auch, dass Du die Datei conf/dokuwiki.php aktualisierst - sie enthält alle voreingestellten Konfigurationseinstellungen; falls sie nicht gesetzt sind, kann es zu Fehlfunktionen kommen. Deine lokalen Änderungen sollten immer in conf/local.php gespeichert sein.

• Example Upgrade Process
• Example Upgrade Process on hosted webspace per FTP

• Upgrading a Web-hosted installation via FTP (a little bit different to the above)

DokuWiki-Version rc2007-05-24 erstellt unterhalb des data/-Verzeichnisses ein neues Verzeichnis index/. Nach dem Upgrade musst Du dieses Verzeichnis manuell erstellen und dem Webserver Schreibzugriffe darauf erteilen, andernfalls wird der Installationsvorgang über das fehlende Verzeichnis meckern und Du kannst Dein Wiki nicht aufrufen. — Michael Klier 2007-05-29 14:47

Wenn Du von einer sehr alten Version aktualisierst, musst Du eventuell einige Verzeichnisstrukturen anpassen. Hier ist eine Liste, die Dir dabei helfen kann (alles aus Sicht des DokuWiki-Hauptverzeichnisses):

• changes.log → data/changes.log
• data/ → data/pages/
• attic/ → data/attic/
• media/ → data/media/

Wenn Du von einer älteren Version als 2005-02-06 aktualisierst, musst du nach der Aktualisierung Deine Daten in UTF8 konvertieren.