Version 5.1.1

From Cloudrexx Development Wiki
Jump to: navigation, search

Release Notes

Siehe Release Notes

Systemanforderungen

Die Seite Versionen gibt Auskunft über die für den Betrieb nötigen Versionen von PHP und MySQL/MariaDB. Des weiteren werden je nach PHP-Version diverse PHP-Erweiterungen benötigt. Eine Liste welche Erweiterungen in welcher Version benötigt werden findet sich unter Systemanforderungen.

Installation

Das Service Pack 1 für das Release 5.1 steht nur als Update-System für ältere Releases zur Verfügung. Ein Neuinstallationspaket wird nicht angeboten. Zum Betrieb des Service Packs der Version 5.1 muss eine bestehende Installation mit dem Update-Paket aktualisiert werden. Für das Setup einer neuen Website-Installation muss das letzte Neuinstallationspaket (v5.0 SP2) installiert werden und dann mit dem Update-Paket auf das Service Pack 1 der Version 5.1 aktualisiert werden.

Update

Das frei verfügbare Update-System zur Aktualisierung einer älteren Version auf das Service Pack 1 der Version 5.1 kann im offiziellen Download-Archiv bezogen werden. Nach der Ausführung des Update-Systems muss die neue Version eingerichtet werden, damit die Website wieder wunschgemäss funktioniert. Die nachfolgenden Abschnitte helfen Ihnen bei der Einrichtung der aktualisierten Website.

Customizing Migration

Falls individuelle Anpassungen am Programmcode vorgenommen wurden, so müssen diese aufs neue Framework migriert werden. Siehe Migration Guide 5.x

Hinweis: Das Update-System erkennt allfällige individuelle Anpassungen am Programmcode automatisch und listet betroffene Systemdateien (gemäss Identifikation von modifizierten Systemdateien) am Ende des Vorgangs auf. Für jede betroffene Systemdatei werden zwei Angaben wie folgt ausgegeben: 
Datei: /<datei>
Sicherung: /customizing/<datei>_5.0.2_backup_25.01.2021

Erläuterung:

  • Datei: Vollständiger Dateipfad der modifizierten Systemdatei
  • Sicherung: Ablagepfad der angelegten Kopie der modifizierten Systemdatei
Hinweis: Auf Grund eines Fehlers in der Update-Routine werden identifizierte Dateien aus den Verzeichnissen /core, /core_modules und /modules doppelt aufgeführt.


Bevor modifizierte Systemdateien identifiziert werden, werden Systemdateien, von welchen eine gleichnamige Datei im Verzeichnis /customizing besteht, ins /customizing Verzeichnis geschoben unter Anwendung des folgenden Schemas:

/customizing/<datei>_<version>[_<index>]

Platzhalter Beschreibung Beispiel
<datei> Vollständiger Dateipfad der Systemdatei. /core/Routing/Url.class.php
<version> Versionsnummer der Ausgangsinstallation. 5.0.2
<index> Falls im Verzeichnis /customizing bereits eine Datei nach dem Schema <datei>_<version> vorhanden ist, dann wird dem Dateinamen ein Index angehängt. _1

Hinweis: Die Verschiebung dieser Systemdateien wird am Ende des Update-Systems nicht aufgeführt.


Anschliessend erfolgt die effektive Identifikation von modifizierten Systemdateien:

Ist eine Systemdatei modifiziert, so wird diese als Backup ins Verzeichnis /customizing nach folgendem Schema kopiert (unter Beibehaltung der Verzeichnisstruktur):

/customizing/<datei>_<version>[_backup_<datum>[_<index>]]

Platzhalter Beschreibung Beispiel
<datei> Vollständiger Dateipfad der Systemdatei. /core/Routing/Url.class.php
<version> Versionsnummer der Ausgangsinstallation. 5.0.2
<datum> Datum zum Zeitpunkt der Ausführung des Updates (Format: d.m.Y) 26.03.2021
<index> Falls im Verzeichnis /customizing bereits eine Datei nach dem Schema <datei>_<version>_backup_<datum> vorhanden ist, dann wird dem Dateinamen ein Index angehängt. _1
Interpretation der /customizing-Dateien

Wie sind die Dateien im Verzeichnis /customizing nach einem Update, basierend auf deren Dateinamen, zu interpretieren?

Dateiname Herkunft Beispiel Bedeutung
/customizing/<datei> Manuell /customizing/core/Routing/Url.class.php Modifizierte Datei, welche bei aktivierter Option Individuelle Kundenanpassungen im Einsatz war. Dies ist die manuell angelegte Customizing-Datei.
Aktion: Diese Datei muss auf die neue Version portiert werden.
Tipp: Zur Identifikation der individuellen Anpassungen hat das Update-System die original Systemdatei nach /customizing/<datei>_<version>[_<index>] verschoben.
/customizing/<datei>_<version> Update-System /customizing/core/Routing/Url.class.php_5.0.2 Abhängig davon, ob die Datei am Ende des Update-Vorgangs bei der Liste der modifizierten Dateien aufgeführt ist oder nicht.
  • Datei ist aufgeführt:
    Kopie der modifizierten Systemdatei /<datei>.
    Wichtig: Falls eine gleichnamige Datei nach dem Schema /customizing/<datei>_<version>_backup_<datum> besteht, kann diese Datei ignoriert und gelöscht werden.
    Aktion (sofern Datei nicht überflüssig): Diese Datei muss mit der original Datei (aus dem Release-Paket) vergleichen werden, um die individuellen Anpassungen zu identifizieren, welche ggf. auf die neue Version portiert werden müssen.
  • Datei ist nicht aufgeführt:
    Backup der Datei /<datei> da eine gleichnamige Datei im Verzeichnis /customizing vorhanden ist.
    Hinweis: Die Datei dient als Referenz zur Identifikation der effektiven Änderungen in der gleichnamigen Datei im /customizing-Verzeichnis (mit einem Diff-Tool).
    Wichtig: Falls eine gleichnamige Datei nach dem Schema /customizing/<datei>_<version>_<index> besteht, kann diese Datei ignoriert und gelöscht werden.
/customizing/<datei>_<version>_<index> Update-System /customizing/core/Routing/Url.class.php_5.0.2_1 Backup der Datei /<datei> da eine gleichnamige Datei im Verzeichnis /customizing vorhanden ist.

Zum Zeitpunkt der Ausführung des Update-Systems bestand bereits eine Datei nach dem Schema /customizing/<datei>_<version> (angelegt durch einen vorgängig ausgeführten Update-Versuch).

Hinweis: Die Datei dient als Referenz zur Identifikation der effektiven Änderungen in der gleichnamigen Datei im /customizing-Verzeichnis (mit einem Diff-Tool).
Wichtig: Falls mehrere Dateien der gleichnamigen Datei nach diesen Schema vorhanden sind, dann ist jene mit dem höchsten Index jene Datei, welche das relevante Backup von /<datei> darstellt. Alle anderen gleichnamigen Dateien können ignoriert und gelöscht werden.
/customizing/<datei>_<version>_backup_<datum> Update-System /customizing/core/Routing/Url.class.php_5.0.2_backup_26.03.2021 Kopie der modifizierten Systemdatei /<datei>.

Zum Zeitpunkt der Ausführung des Update-Systems bestand bereits eine Datei nach dem Schema /customizing/<datei>_<version> (auf Grund eines Bugs der Update-Routine oder angelegt durch einen vorgängig ausgeführten Update-Versuch).

Wichtig: Falls eine gleichnamige Datei nach dem Schema /customizing/<datei>_<version>_backup_<datum>_<index> besteht, kann diese Datei ignoriert und gelöscht werden.
Aktion (sofern Datei nicht überflüssig): Diese Datei muss mit der original Datei (aus dem Release-Paket) vergleichen werden, um die individuellen Anpassungen zu identifizieren, welche ggf. auf die neue Version portiert werden müssen.
/customizing/<datei>_<version>_backup_<datum>_<index> Update-System /customizing/core/Routing/Url.class.php_5.0.2_backup_26.03.2021_1 Kopie der modifizierten Systemdatei /<datei>.

Zum Zeitpunkt der Ausführung des Update-Systems bestand bereits eine Datei nach dem Schema /customizing/<datei>_<version>_backup_<datum> (auf Grund eines Bugs der Update-Routine oder angelegt durch einen vorgängig ausgeführten Update-Versuch).

Wichtig: Falls mehrere Dateien der gleichnamigen Datei nach diesen Schema vorhanden sind, dann ist jene mit dem höchsten Index jene Datei, welche von /<datei> kopiert wurde. Alle anderen gleichnamigen Dateien können ignoriert und gelöscht werden.
Aktion: Diese Datei muss mit der original Datei (aus dem Release-Paket) vergleichen werden, um die individuellen Anpassungen zu identifizieren, welche ggf. auf die neue Version portiert werden müssen.

Migration von Cloudrexx 5.0 und älter

Falls von einer Cloudrexx Version 5.0 (inkl. Service Pakete) und älter aus aktualisiert wurde, so müssen folgende Arbeiten ausgeführt werden:

  1. HTTP Strict Transport Security konfigurieren
  2. Browser-Cache leeren

HTTP Strict Transport Security

Falls HTTP Strict Transport Security (HSTS) genutzt werden soll, so muss HTTPS sowohl fürs Front- wie auch fürs Backend erzwungen wird. Dazu muss wie folgt vorgegangen werden:

  1. In der Adminkonsole den Bereich Administration > Grundeinstellungen > System öffnen
  2. Im Reiter Website die Option Verwendetes Protokoll auf HTTPS setzen.
  3. Im Reiter Administrationsoberfläche die Option Verwendetes Protokoll auf HTTPS setzen.
Hinweis: Cloudrexx überschreibt eine allfällig bereits vorhandene HSTS-Konfiguration des Servers. Aus diesem Grund ist die Umstellung auf HTTPS bei den Grundeinstellungen von Cloudrexx zwingend Notwendig, um HSTS nutzen zu können. Ohne Erzwingung von HTTPS deaktiviert Cloudrexx HSTS.

Browser-Cache leeren

Damit die neue Version korrekt funktioniert (insbesondere die Adminkonsole) wird empfehlen den Cache des Browsers zu leeren.

Migration von Contrexx 4 und älter

Falls von einer Contrexx Version 4 und älter aus aktualisiert wurde, so müssen folgende Arbeiten ausgeführt werden:

  1. Alle Arbeiten gemäss Abschnitt Cloudrexx 5.0 und älter
  2. Anwendungsvorlagen aktualisieren
  3. DSGVO umsetzen
  4. Cronjob installieren
  5. Caching einrichten

Anwendungsvorlagen aktualisieren

Ab der Version 5 wird der Inhalt von Anwendungsseiten (Seiten im Content Manager, welche zu einer Anwendung gehören) im Webdesign Template gepflegt. Die entsprechenden Template Dateien werden Anwendungsvorlagen genannt.

Während dem Update wird der Inhalt aller Anwendungsseiten in entsprechende Anwendungsvorlagen im Webdesign Template migriert.

Nach dem Update müssen die Anwendungsvorlagen aller Anwendungen auf deren korrekte Funktion geprüft werden. Ggf. müssen Platzhalter, Template Block und/oder CSS/JS-Anweisungen ersetzt/migriert werden. Die verfügbaren Platzhalter/Template-Blöcke und deren Struktur ist dem Platzhalterverzeichnis zu entnehmen.

DSGVO umsetzen

Damit die Richtlinien zur DSGVO eingehalten werden, folgen Sie der Anleitung DSGVO

Cronjob installieren

Cloudrexx 5 benötigt die Einrichtung eines Cronjobs. Weitere Informationen und eine Anleitung ist dem folgenden Artikel zu entnehmen:

Caching einrichten

Um die bestmögliche Performance zu erhalten, wird die Konfiguration des Cachings gemäss Anleitung empfohlen.

Migration von BETA Release

Zur Migration eines BETA-Releases der Version 5 auf das STABLE-Release kann das normale Update-System nicht genutzt werden.

Kontaktieren Sie den Hersteller-Support, falls Sie eine BETA-Installation aktualisieren möchten.

Retrieved from "https://wiki.cloudrexx.com/index.php?title=Version_5.1.1&oldid=27906"