Benutzer-Werkzeuge

Webseiten-Werkzeuge


kb:software:dokuwiki:upgrade

Dokuwiki 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!
  • 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
    • 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.
  • 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.
  • 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

kb/software/dokuwiki/upgrade.txt · Zuletzt geändert: 2019/05/28 11:33 von heil