Seminar Enonic XP 8 – Upgrade von XP 7.16 auf XP 8 und App-Migration

Das Seminar plant und erprobt den Major-Upgrade-Pfad von einer aktuellen XP-7.16-Basis auf Enonic XP 8. Plattform-, Daten-, Konfigurations- und Anwendungsänderungen werden getrennt analysiert und anschließend in einer kontrollierten Gesamtmigration zusammengeführt.

Eine repräsentative XP-7-Anwendung wird inventarisiert, technisch angepasst, in einer parallelen XP-8-Umgebung installiert und mit migrierten Daten geprüft. Cutover, vollständiger Clusterneustart, Rückfall und Nachkontrolle werden als dokumentierter Ablauf behandelt.

Inhaltsübersicht

1. Readiness und Bestandsaufnahme
2. Upgradearchitektur und Parallelumgebung
3. Runtime, Java und Build-System
4. YAML-Migration der Deskriptoren
5. TypeScript, Bibliotheken und Benennung
6. Universal APIs und Webänderungen
7. Berechtigungen und Identitäten
8. Konfiguration, Logging und Metriken
9. Datenexport, Dump und Migration
10. Content Studio, Guillotine und Frontends
11. Testprogramm und Probeupgrade
12. Cutover, Neustart und Rollback
13. Nachkontrolle und Stabilisierung

Lernziele

• Upgrade-Readiness und vollständige Abhängigkeiten bewerten
• Apps, Build, TypeScript, YAML und APIs auf XP 8 migrieren
• Rechte-, Daten-, Konfigurations- und Companion-App-Änderungen beherrschen
• Test-, Cutover- und Rollbackverfahren realistisch durchführen
• Nachkontrolle und technischen Schuldenabbau planen

Praxisorientierte Lernschritte

1. Readiness und Bestandsaufnahme

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Plattformversion, Apps, Integrationen, Datenvolumen und Betriebsmodell inventarisieren
2. Schritt 2: XP-8-Kompatibilität jeder eigenen und fremden Anwendung nachweisen
3. Schritt 3: Blocker, Verantwortliche und Freigabekriterien in einem Upgrade-Backlog erfassen

2. Upgradearchitektur und Parallelumgebung

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: bestehende XP-7.16-Umgebung und neue XP-8-Zielumgebung getrennt planen
2. Schritt 2: Netzwerk, Storage, Konfiguration und Zugriff für QA und Produktion vorbereiten
3. Schritt 3: Datenübernahme, Synchronisationsstopp und Umschaltpunkt festlegen

3. Runtime, Java und Build-System

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Laufzeit- und JVM-Anforderungen der Zielversion prüfen
2. Schritt 2: Gradle, XP-Plugin, Abhängigkeiten und Testframework aktualisieren
3. Schritt 3: reproduzierbaren XP-8-Build mit eindeutigen Artefakten erzeugen

4. YAML-Migration der Deskriptoren

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: XML-basierte CMS- und App-Deskriptoren vollständig erfassen
2. Schritt 2: Schemas, Namespaces und Deskriptoren nach YAML überführen
3. Schritt 3: automatisch migrierte Ergebnisse gegen Editor und Laufzeit fachlich prüfen

5. TypeScript, Bibliotheken und Benennung

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: veraltete Begriffe, Funktionen und Bibliotheksaufrufe identifizieren
2. Schritt 2: Content- und Node-Operationen auf aktualisierte Funktionen umstellen
3. Schritt 3: striktere Validierung für IDs, Namen und Deskriptoren mit Tests absichern

6. Universal APIs und Webänderungen

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: bestehende HTTP-Services und Controllerpfade inventarisieren
2. Schritt 2: Endpunkte als Universal APIs und standardisierte HTTP-Funktionen neu strukturieren
3. Schritt 3: Clients, VHosts, Authentifizierung und Fehlerverträge kompatibel anpassen

7. Berechtigungen und Identitäten

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Annahmen zur Rechtevererbung und Branchwirkung im Bestand finden
2. Schritt 2: explizite ACLs und hierarchische Anwendung für XP 8 planen
3. Schritt 3: Service Accounts, ID-Provider-Kontext und Security-Negativtests aktualisieren

8. Konfiguration, Logging und Metriken

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: System-, App-, VHost- und Loggingkonfiguration vergleichen
2. Schritt 2: entfallene oder geänderte Optionen gezielt bereinigen
3. Schritt 3: Monitoring auf OpenMetrics und neue Zustandsprüfungen umstellen

9. Datenexport, Dump und Migration

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: ausreichenden Speicher und konsistente Sicherungen vorbereiten
2. Schritt 2: Repository-Daten in geeigneter Granularität exportieren oder dumpen
3. Schritt 3: Daten in XP 8 laden und mit technischen sowie fachlichen Prüfsummen vergleichen

10. Content Studio, Guillotine und Frontends

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: kompatible Versionen der redaktionellen und API-bezogenen Apps bereitstellen
2. Schritt 2: Content Studio 6, Guillotine und gegebenenfalls Next.XP integrieren
3. Schritt 3: Redaktion, Preview, GraphQL und Publishing mit repräsentativen Szenarien abnehmen

11. Testprogramm und Probeupgrade

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Funktions-, Integrations-, Berechtigungs-, Performance- und Restoretests bündeln
2. Schritt 2: vollständiges Probeupgrade in QA mit gemessener Dauer durchführen
3. Schritt 3: Abweichungen, manuelle Schritte und Abbruchkriterien in das Runbook einarbeiten

12. Cutover, Neustart und Rollback

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Freeze, letzte Datensicherung und Umschaltung zeitlich koordinieren
2. Schritt 2: Major-Upgrade mit vollständigem Neustart der Zielumgebung durchführen
3. Schritt 3: bei fehlgeschlagenen Gates kontrolliert auf die Ausgangsumgebung zurückschalten

13. Nachkontrolle und Stabilisierung

Der Arbeitsblock verbindet fachliche Einordnung, nachvollziehbare Umsetzung und kontrollierte Prüfung. Konfigurationen, Entscheidungen und Prüfergebnisse werden als wiederverwendbare Projektnachweise dokumentiert.

1. Schritt 1: Daten, Berechtigungen, Apps, Schnittstellen und Monitoring nach dem Start prüfen
2. Schritt 2: Performancebaseline und Fehlerbudget für die Stabilisierungsphase festlegen
3. Schritt 3: temporäre Migrationshilfen entfernen und verbleibende technische Schulden priorisieren

Zielgruppe und Vorkenntnisse

Zielgruppe: Enonic-Entwickler, Plattformbetrieb, DevOps, Solution Architects, technische Projektleitung und Migrationsteams mit bestehenden XP-7-Installationen.

Vorkenntnisse: Fundierte praktische Erfahrung mit Enonic XP 7.16, eigenen Apps, Gradle, TypeScript, Konfiguration, Backup und produktivem Plattformbetrieb.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Konfigurations- oder Implementierungsschritte und kontrollierte Fehlerfälle vertieft. Jede Übung besitzt definierte Ausgangswerte, Prüfpunkte und Dokumentationsanforderungen. Dadurch bleiben die erarbeiteten Abläufe für Projekt- und Betriebsstandards nachvollziehbar.