Dokuwiki - FAQ Installation / Upgrade

Die nachfolgende Liste beschreibt, wie ich mein Dokuwiki auf den neusten Stand bringe. Es ist zugegebenermaßen eine etwas harte Methode, hat aber auch zur Folge, das ich ganz sicher weiß, dass das Wiki danach wirklich auf dem neusten Stand ist.

1. Schritt: Vorbereitungen

Nachsehen, welche (zusätzlichen) Plugins im alten Wiki installiert waren und auch in Zukunft benötigt werden.
Download der aktuellen Dokuwiki-Installationsdateien.
Download des Plugins Searchindex.
Download der zusätzlichen Plugins-Installationsdateien.
- Hinweis: Achten Sie beim Download aller Plugins darauf, dass diese mit der neuen Dokuwiki-Installation kompatibel sind.
Download des bestehenden Wikis vom eigenen Server (als Datensicherung). Es empfiehlt sich, wirklich alles herunterzuladen!
Selbst geänderte Dateien herunterladen:
- Ordner „lib > tpl > dokuwiki > images“: enthält selbst erstellte Logo-Dateien
Erstellen eines Screenshots der bestehenden Benutzerverwaltung.
Erstellen eines Screenshots der bestehenden Zugangsverwaltung.
Erstellen eines Screenshots der bestehenden Konfiguration.
Erstellen eines Screenshots der bestehenden Einstellungen des Template-Designs.
Auf dem Server: Löschen aller Dateien und Verzeichnisse außer:
- data/media
- Ordner „media“ umbenennen in „media-echtdateien“
- data/pages
- Ordner „pages“ umbenennen in „pages-echtdateien“
- ggf. selbst erstellte .htaccess-Dateien (insbesondere im Root-Verzeichnis von Dokuwiki)
- ggf. selbst erstellte .htaccess-https-Dateien (insbesondere im Root-Verzeichnis von Dokuwiki)
- ggf. selbst erstellte .htaccess-Dateien (auch im data-Verzeichnis nachsehen und ggf. anpassen)
- ggf. selbst erstellte robots.txt-Dateien
- ggf. Dokuwiki-Dateien, die User definierte Inhalte haben (z.B. Stylesheet etc.)
- ggf. selbst angelegte Verzeichnisse oder Dateien, die eigentlich nichts mit der Dokuwiki-Installation zu tun haben.

2. Schritt: Installation durchführen

Umstellung der PHP-Version auf dem Server. Prüfen Sie dazu die bestehende Installation auf ihre Versionsnummer und vergleichen Sie, ob diese mit dem neuen Dokuwiki kompatibel ist.
- Diesen Link aufrufen, um PHP-Versin zu prüfen (Login notwendig)
Entpacken des Dokuwikis auf dem lokalen PC.
Entpacken und einsortieren der Plugins auf dem lokalen PC (man kann auf diesen Schritt verzichten, sofern man die Plugins später mit der Funktion zur Installation von Plugins installiert).
Hinweis: Denken Sie unbedingt an die Installation des Plugin Searchindex!
Upload der Installationsdateien vom PC auf den Server. Achtung: folgende Dateien nicht überschreiben (sofern dieses notwendig ist - siehe weiter oben):
- .htaccess
- .htaccess-https
- robots.txt
Dateirechte für den Ordner „data“ und alle darunterliegenden Ordner auf „777“ setzen.
Aufrufen der install.php und Durchführen der Installationsroutine. Dann speichern klicken.
Aufrufen der Sprachversion „de“. Dann speichern klicken.
- Hinweis: Ich benutze immer die Sprachversion „de“ und nicht „de-informal“, da manche Plugins zwar eine „de“-Übersetzung aufweisen, jedoch keine „de-informal“-Übersetzung. Hat man im Wiki jedoch „de-informal“ ausgewählt, kann das Plugin die Sprache nicht erkennen und nutzt dann für das Plugin die englischsprachige Fassung (und nicht die deutschsprachige Fassung).
Löschen der Datei install.php (per FTP).
Ordner „media“ löschen.
Ordner „media-echtdateien“ umbenennen in „media“
Ordner „pages“ löschen.
Ordner „pages-echtdateien“ umbenennen in „pages“

3. Schritt: Wiki konfigurieren

Eingabe der Daten in der Benutzerverwaltung (siehe vorher erstellten Screenshot).
Eingabe der Daten in der Zugangsverwaltung (siehe vorher erstellten Screenshot).
Eingabe der Daten in der Konfiguration (siehe vorher erstellten Screenshot).
Eingabe der Daten in der Einstellungen des Template-Designs (siehe vorher erstellten Screenshot).
Wiederherstellen der Logodateien.
Wiederherstellen der .htaccess-Dateien
Wiederherstellen der robots.txt-Dateien
Starten Sie das Plugin Searchindex und lassen Sie den Index neu erstellen.

4. Schritt: Funktionsprüfung

Rufen Sie Ihr Wiki auf.
Legen Sie eine neue Seite an und speichern diese.
Löschen Sie die Seite wieder.
Rufen Sie bestehende Seiten auf, klicken Sie dort auf bearbeiten und klicken Sie danach auf speichern.

Siehe auch:
https://www.dokuwiki.org/install:upgrade
http://www.dokuwiki.org/update_check