Aktualisierung

Auch verfügbar in English, Español, Français, Русский, 简体中文


Aktualisiere dein WackoWiki von 6.0 auf 6.1.


Siehe auch den Migrationsleitfaden für WackoWiki Version 6.0, 5.0.
PHP 8

1. Vorbereitungen

  1. Überprüfe die Voraussetzungen und lies die Versionshinweise.
  2. Mache eine Datensicherung
    1. deines Wiki-Ordners
    2. deiner Wiki-Datenbank (z.Bsp. mit phpMyAdmin)

WICHTIG
Erstelle ein Sicherungskopie deiner Daten! Bevor irgendetwas getan wird, sollten die bestehende Datenbank und die Dateien gesichert werden. Außerdem ist sicherzustellen, dass während der Migration niemand die Datenbank benutzt, da dies zu Datenverlusten führen kann.

  1. Es ist unbedingt erforderlich, dass vor dem Upgrade eine Datensicherung deiner WackoWiki-Datenbank durchgeführt wird.
  2. Der Aktualisierungsvorgang überträgt deine vorhandenen Daten der Installation von der alten Version auf die neue Version. Die Migration von der neuen Version zurück zur alten Version wird nicht unterstützt.

2. Aktualisierung

2.1. Download

  1. Lade die neue Version herunter.
  2. Extrahiere die neue Datei wackowiki-6.1.x.zip
  3. Entferne alle Wacko-Ordner und Dateien von deiner aktuellen Installation, mit Ausnahme von
    • config/config.php
    • file/
  4. Kopiere die neuen (wacko.6.x.y) Dateien in deinen Wacko-Ordner
  5. Lösche die Cache-Datei unter cache/config/config.php
  6. Überprüfe die Dateiberechtigungen

2.2. Installer

WackoWiki R6.1 Upgrade: Spracheinstellungen

Rufe die URI example.com/wiki-ordner/ in deinem Browser auf, der Installer startet und sagt, dass du von der Version 6.x.y auf die Version 6.1.x aktualisierst.


3. Nachbereitung

3.1. Konfiguration

Wenn benutzerdefinierte Werte in der constant.php, router.conf, csp_custom.conf Datei oder anderweitig gesetzt wurden, müssen diese Werte erneut gesetzt oder zusammengeführt werden.

3.2. Daten-Synchronisation

Nach erfolgreichem Upgrade können die Datensätze der Tabelle page_link und file_link für alle Intrasite-Links neu generiert werden.

  • Admin Panel -> Daten-Synchronisation -> Wiki-Links
tune the re-rendering settings to avoid timeouts or reaching the memory limit

Man kann die Einstellungen für das erneute Rendern der Wikiseiten anpassen, um Zeitüberschreitungen oder das Erreichen der Speichergrenze zu vermeiden. Dies ist vor allem für Shared Hosting oder Server, die man nicht selbst verwaltet, interessant. Der Server beendet dann möglicherweise das Skript ohne weitere Ankündigung.


Wenn das Rendering fehlschlägt, reduziere einfach die Anzahl der Seiten, die es pro Durchgang rendern soll, das Redirect LIMIT ist auf 10 gesetzt. Wenn die Weiterleitungsbegrenzung erreicht wird, stellt das Skript einen Link Weiter » zur Verfügung, welchen man anklicken muss, um den nächsten Satz an Seiten zu rendern. Vermeide außerdem mögliche Session-Timeouts, während das Skript läuft.

3.3. Änderungen

  1. Es schreibt jetzt die sitemap.xml in den xml/ Ordner, bitte prüfe und aktualisiere deine robots.txt, bspw. 
    • Sitemap: https://wiki.example.com/xml/sitemap.xml.gz
  2. Erfordert jetzt das ICU Datums und Zeit-Format welches vom IntlDateFormatter verwendet wird, bitte aktualisiere deine individuellen Einstellungen im Adminpanel.
    • config DateTime::format IntlDateFormatter
      date_format d.m.Y dd.MM.yyyy
      time_format H:i HH:mm
      time_format_seconds H:i:s HH:mm:ss
  3. Um den Hash für alle vor WackoWiki 6.1.19 hochgeladenen Dateien zu erstellen, nutze die {{adminupdate}} Aktion.
    • Punkt: Set missing file hash for legacy records in file table
  4. Entferne alle Datensicherungen welche vor 6.1.21 erstellt wurden aus dem file/backup/ Ordner oder ersetze das backup.log mit einer JSON formatierten Version.
    • {
    "cluster": "",
    "data": "wacko_acl;wacko_auth_token;wacko_config;wacko_category;wacko_category_assignment;wacko_external_link;wacko_file;wacko_file_link;wacko_menu;wacko_page;wacko_page_link;wacko_revision;wacko_user;wacko_user_setting;wacko_usergroup;wacko_usergroup_member;wacko_watch",
    "files": "file/global;file/perpage",
    "size": 104080339,
    "structure": "wacko_acl;wacko_auth_token;wacko_cache;wacko_config;wacko_category;wacko_category_assignment;wacko_external_link;wacko_file;wacko_file_link;wacko_log;wacko_menu;wacko_page;wacko_page_link;wacko_referrer;wacko_revision;wacko_user;wacko_user_setting;wacko_usergroup;wacko_usergroup_member;wacko_watch",
    "time": 1681202531,
    "wacko_version": "6.1.21"
}

3.4. Angepasste Themen, Aktionen, Formatierer, Handler und andere Modifikationen

Prüfe und aktualisiere deine eigenen Modifikationen und Erweiterungen. Schaue nach geänderten Funktionen, Datenbankänderungen oder geänderten CSS-Klassen.


  1. Bitte siehe unter community folder oder Patches section nach verfügbaren Aktualisierungen.
  2. Merge possible core changes in your own theme

4. Notes

  1. Leave a comment here if something is not clear or you have further questions.
  2. Do not hesitate to improve this instruction and the wording.