Seminar TYPO3 v14: Upgrade und Migration auf Version 14 LTS

Das Seminar behandelt das Upgrade auf TYPO3 v14 LTS als kontrolliertes Migrationsprojekt. Ausgangsanalyse, Erweiterungskompatibilität, Codeanpassung, Datenmigration, Tests und Produktionsumschaltung werden mit eindeutigen Abbruch- und Rückfallkriterien verbunden.

Die Inhalte sind auf einzelseminar mit hohem Praxisanteil ausgelegt. Theorie, Demonstration, geführte Konfiguration und kontrollierte Übungen greifen unmittelbar ineinander.

Lernziele

• Projektbestand und Upgrade-Risiken vollständig erfassen
• Core, Extensions und eigenen Code kompatibel vorbereiten
• Composer-Upgrade und Upgrade-Wizards sicher durchführen
• Funktion, Daten, Sicherheit und Performance systematisch testen
• Cutover, Rollback und Nachsorge dokumentiert umsetzen

Inhaltsübersicht

1. Bestandsaufnahme und Zielbild
2. Risiko- und Ablaufplanung
3. Extension-Kompatibilität
4. Eigener Code und Deprecations
5. Composer-Upgrade und Core-Aktualisierung
6. Datenbank und Upgrade-Wizards
7. Funktionale und redaktionelle Tests
8. Performance und Sicherheit nach dem Upgrade
9. Cutover, Rollback und Nachsorge

Kapitel 1: Bestandsaufnahme und Zielbild

Inhaltsübersicht des Kapitels

• Systeminventar erstellen
• Zielarchitektur festlegen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Systeminventar erstellen, Zielarchitektur festlegen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 1.1: Systeminventar erstellen

Fachliche Ausarbeitung: Core-Version, PHP, Datenbank, Extensions, eigener Code, Integrationen und Betriebsumgebung vollständig erfasst. Praktische Umsetzung: Eine technische Inventarliste mit Eigentümern und Abhängigkeiten erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 1.2: Zielarchitektur festlegen

Fachliche Ausarbeitung: Zielversion, unterstützte Plattformen, Composer-Modus, Site Sets und abzulösende Altlasten definiert. Praktische Umsetzung: Ein verbindliches Zielbild mit Nicht-Zielen formuliert. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 2: Risiko- und Ablaufplanung

Inhaltsübersicht des Kapitels

• Upgrade-Pfade bestimmen
• Backup und Staging vorbereiten
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Upgrade-Pfade bestimmen, Backup und Staging vorbereiten. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 2.1: Upgrade-Pfade bestimmen

Fachliche Ausarbeitung: Zulässige Versionssprünge, Zwischenstände und notwendige Vorarbeiten in eine Reihenfolge gebracht. Praktische Umsetzung: Einen Migrationsplan mit Meilensteinen und Abbruchpunkten erstellt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 2.2: Backup und Staging vorbereiten

Fachliche Ausarbeitung: Datenbank, Dateien, Konfiguration, Geheimnisse und Produktionsdaten für einen sicheren Teststand kopiert. Praktische Umsetzung: Einen wiederherstellbaren Staging-Ausgangspunkt mit dokumentiertem Restore erzeugt. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 3: Extension-Kompatibilität

Inhaltsübersicht des Kapitels

• Erweiterungen bewerten
• Abhängigkeiten bereinigen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Erweiterungen bewerten, Abhängigkeiten bereinigen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 3.1: Erweiterungen bewerten

Fachliche Ausarbeitung: Versionsfreigaben, Wartungsstatus, Ersatz, Entfernung und eigener Anpassungsbedarf je Paket erfasst. Praktische Umsetzung: Eine Entscheidungslistе für alle installierten Extensions erstellt. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 3.2: Abhängigkeiten bereinigen

Fachliche Ausarbeitung: Unnötige Pakete, veraltete Constraints und konfliktbehaftete Bibliotheken vor dem Core-Upgrade korrigiert. Praktische Umsetzung: Composer-Abhängigkeiten in einen lösbaren Zielzustand überführt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 4: Eigener Code und Deprecations

Inhaltsübersicht des Kapitels

• Änderungsbedarf finden
• Code schrittweise modernisieren
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Änderungsbedarf finden, Code schrittweise modernisieren. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 4.1: Änderungsbedarf finden

Fachliche Ausarbeitung: Deprecation-Logs, Core-Changelog, statische Analyse und Tests zur Lokalisierung veralteter APIs genutzt. Praktische Umsetzung: Eine priorisierte Liste von Codeanpassungen erstellt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 4.2: Code schrittweise modernisieren

Fachliche Ausarbeitung: Alte APIs, globale Zustände und nicht unterstützte Konfiguration durch aktuelle Strukturen ersetzt. Praktische Umsetzung: Mehrere Anpassungen mit kleinem Änderungsumfang und Tests umgesetzt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 5: Composer-Upgrade und Core-Aktualisierung

Inhaltsübersicht des Kapitels

• Versionsanforderungen anpassen
• Installationszustand prüfen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Versionsanforderungen anpassen, Installationszustand prüfen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 5.1: Versionsanforderungen anpassen

Fachliche Ausarbeitung: Core-Pakete, Extensions, PHP-Plattform und Lockfile kontrolliert auf die Zielversion ausgerichtet. Praktische Umsetzung: Ein nachvollziehbares Composer-Update ohne ungewollte Nebenaktualisierungen durchgeführt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 5.2: Installationszustand prüfen

Fachliche Ausarbeitung: Paketstatus, Autoloading, Systemmeldungen und grundlegender Backend-Zugriff direkt nach dem Upgrade kontrolliert. Praktische Umsetzung: Kritische Startfehler vor der Datenmigration behoben. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 6: Datenbank und Upgrade-Wizards

Inhaltsübersicht des Kapitels

• Schema kontrolliert aktualisieren
• Upgrade-Wizards vollständig ausführen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Schema kontrolliert aktualisieren, Upgrade-Wizards vollständig ausführen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 6.1: Schema kontrolliert aktualisieren

Fachliche Ausarbeitung: Datenbankschema, entfernte Felder, neue Indizes und eigene Tabellenänderungen geprüft. Praktische Umsetzung: Schemaänderungen mit Backup und Prüfprotokoll ausgeführt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Schritt 6.2: Upgrade-Wizards vollständig ausführen

Fachliche Ausarbeitung: Angezeigte Wizards, Voraussetzungen, Wiederholbarkeit und verbleibende Hinweise einzeln bearbeitet. Praktische Umsetzung: Alle notwendigen Migrationen dokumentiert und Restmeldungen begründet. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 7: Funktionale und redaktionelle Tests

Inhaltsübersicht des Kapitels

• Kernfunktionen abnehmen
• Berechtigungen und Datenintegrität prüfen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Kernfunktionen abnehmen, Berechtigungen und Datenintegrität prüfen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 7.1: Kernfunktionen abnehmen

Fachliche Ausarbeitung: Backend, Seiten, Inhalte, Medien, Formulare, Suche, Sprache und Erweiterungen anhand kritischer Pfade getestet. Praktische Umsetzung: Eine rollenbezogene Abnahmeliste mit dokumentierten Befunden durchlaufen. Die Arbeitsschritte werden nachvollziehbar dokumentiert und anhand eines fachlichen Prüfkriteriums kontrolliert.

Schritt 7.2: Berechtigungen und Datenintegrität prüfen

Fachliche Ausarbeitung: Benutzergruppen, Seitenrechte, Datensätze, Beziehungen und Übersetzungen auf unbeabsichtigte Änderungen kontrolliert. Praktische Umsetzung: Mehrere Stichproben und automatisierte Datenprüfungen durchgeführt. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 8: Performance und Sicherheit nach dem Upgrade

Inhaltsübersicht des Kapitels

• Technische Baseline vergleichen
• Sicherheitskonfiguration nachziehen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Technische Baseline vergleichen, Sicherheitskonfiguration nachziehen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 8.1: Technische Baseline vergleichen

Fachliche Ausarbeitung: Antwortzeiten, Fehlerprotokolle, Cache, Datenbank und Hintergrundaufgaben vor und nach dem Upgrade verglichen. Praktische Umsetzung: Relevante Abweichungen gemessen und priorisiert. Abschließend erfolgt eine Prüfung auf Konsistenz, Wartbarkeit und sichere Wiederholbarkeit.

Schritt 8.2: Sicherheitskonfiguration nachziehen

Fachliche Ausarbeitung: Neue Defaults, CSP, Dateirechte, Secrets, Extensions und Systemmeldungen auf die Zielversion abgestimmt. Praktische Umsetzung: Eine aktualisierte Sicherheitsbaseline abgenommen. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Kapitel 9: Cutover, Rollback und Nachsorge

Inhaltsübersicht des Kapitels

• Produktionsumschaltung vorbereiten
• Rückfall und Nachkontrolle sicherstellen
• Kontrollpunkt und Dokumentation

Dieses Kapitel behandelt Produktionsumschaltung vorbereiten, Rückfall und Nachkontrolle sicherstellen. Die Reihenfolge orientiert sich am üblichen Arbeitsprozess von der Vorbereitung über die Umsetzung bis zur Prüfung.

Schritt 9.1: Produktionsumschaltung vorbereiten

Fachliche Ausarbeitung: Wartungsfenster, Inhaltssperre, Datensynchronisierung, Deployment und Smoke Tests minutengenau geplant. Praktische Umsetzung: Einen Cutover-Ablauf mit Verantwortlichen und Entscheidungspunkten erstellt. Die entstandene Lösung wird mit einer Checkliste geprüft und bei Abweichungen gezielt korrigiert.

Schritt 9.2: Rückfall und Nachkontrolle sicherstellen

Fachliche Ausarbeitung: Rollback-Kriterien, Wiederherstellung, Monitoring, Support und Abschlussprüfung verbindlich festgelegt. Praktische Umsetzung: Einen simulierten Abbruch mit erfolgreicher Rückkehr zum Ausgangszustand durchgeführt. Ein definierter Kontrollpunkt gleicht Konfiguration, Funktion und redaktionelle Wirkung miteinander ab.

Kontrollpunkt und Dokumentation

Die Arbeitsergebnisse des Kapitels werden auf fachliche Vollständigkeit, sichere Konfiguration und reproduzierbare Umsetzung geprüft. Festgestellte Abweichungen werden priorisiert, korrigiert und in einer kompakten Betriebs- oder Redaktionsnotiz festgehalten.

Didaktischer Aufbau

Jeder Themenblock beginnt mit einer Einordnung, wird am System demonstriert und anschließend praktisch umgesetzt. Übungen bauen aufeinander auf, sodass am Ende eine zusammenhängende, prüfbare TYPO3-Konfiguration oder ein vollständiger redaktioneller Arbeitsablauf vorliegt.