WackoWiki: Legacy-Upgrade von 5.5 nach 6.0

https://wackowiki.org/doc     Version: 3 (20.05.2024 11:53)

Legacy-Upgrade von 5.5 nach 6.0

Auch verfügbar in English[link1], Français[link2], Русский[link3]

Aktualisiere dein WackoWiki von 5.5 auf 6.0.


Siehe auch den Migrationsleitfaden für WackoWiki Version 6.1[link4], 5.0[link5].
Unicode

1. Vorbereitungen

  1. Überprüfe die Voraussetzungen[link6] und lies die Versionshinweise[link7].
  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. Vor-Upgrade-Routinen für R6.0

Überspringe diesen Abschnitt, wenn kein Upgrade von R5.5 erfolgt.

Stelle sicher, dass du die Version R5.5.17[link8] verwendest, ein Upgrade von früheren Versionen wird nicht unterstützt. Führe die folgenden Routinen in deinem WackoWiki R5.5.17 aus, bevor du auf R6.0.x aktualisierst.

2.1. Konvertieren der Tabellen und Datensätze in UTF-8

database UTF-8 conversion script
Der erste Teil der Routinen ist vor dem Upgrade auf R6.0.x auszuführen.

3. Aktualisierung

3.1. Download

  1. Lade die neue Version herunter[link10].
  2. Extrahiere die neue Datei wacko.r6.0.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[link11]

3.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 5.5.x auf die Version 6.0.x aktualisierst.

4. Nachbereitung

4.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.

4.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.
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.

4.3. Besonderheiten bei der Unicode-Umstellung

Überspringe diesen Abschnitt, wenn kein Upgrade von R5.5 erfolgt.

Die Umstellung auf Unicode ist ein laufender Prozess. Es kann eine manuelle Anpassung über einen längeren Zeitraum erfordern. Nachstehend werden wir unsere Erfahrungen, Erkenntnisse und möglichen Lösungen beschreiben.

4.3.1. Ersetze alte transliterierte Links und Supertag-Referenzen

Erstelle ein Datensicherung, bevor du einen SQL-UPDATE-Befehl ausführst. Ein Fehler und man kann all seine Daten verlieren.
UPDATE prefix_page SET body = REPLACE(body, '/Doc/Русский/Obnovlenie', '/Doc/Русский/Обновление');


mögliche Fälle
  1.  ((!/el ÅëëçíéêÜ @@el)) -> ((!/el Ελληνικά))	
  2.  ((/Doc/Русский/Obnovlenie ru)) -> ((/Doc/Русский/Обновление ru))	
  3. file:/forum/discussion/ifmodifiedsinceheaderdoesnotworks/403_network_analysis.png
 -> 
file:/Forum/Discussion/IfModifiedSinceHeaderDoesNotWorks/403_network_analysis.png

Alternativ kann die Aktion {{admin_replace}} verwendet werden, um diese Zeichenfolgen zu ersetzen[link13].

Hinweis

Achte außerdem auf defekte interne oder eingehende Links. Der tag der Seite ist jetzt akzent- und groß-/kleinschreibungsabhängig[link14], was vorher mit dem Supertag funktionierte, kann jetzt 404er ergeben.

Setze body_r zurück, so dass der Parser die Seiten mit dem geänderten Inhalt neu rendert.
UPDATE prefix_page SET body_r = '';