Vorbereitung der Website auf das Upgrade auf Drupal 8

Vor dem Upgrade einer Drupal 6- oder Drupal 7-Website auf Drupal 8 wird empfohlen, einige Schritte zu unternehmen, um sicherzustellen, dass der Prozess reibungslos verläuft und die gewünschten Ergebnisse liefert.

Im Gegensatz zu früheren Major-Core-Upgrades aktualisiert der Upgrade-Prozess in Drupal 8 die Quellseite nicht direkt. Stattdessen werden Konfigurations- und Inhaltsobjekte von der Quellseite auf eine saubere Drupal 8-Installation übertragen. Für eine Übersicht über den Prozess und die wesentlichen Unterschiede siehe die Seite Upgrade von Drupal 6 oder 7 auf Drupal 8.

Obwohl das Upgrade die Quellseite nicht verändert, wird empfohlen, das Upgrade nicht auf einer Live-Site durchzuführen. Stattdessen sollte ein Backup der Live-Site verwendet werden, um einen konsistenten Datenbankzustand zu gewährleisten (während der Migration keine Datenbankänderungen) und die Performance der Live-Site nicht zu beeinträchtigen.

Inventarmodul der Quellseite

Es ist wichtig, die Struktur Ihrer bestehenden Drupal 6- oder Drupal 7-Seite zu verstehen, bevor Sie das Upgrade auf Drupal 8 starten.

Ermitteln Sie die Kern- und Contrib-Module, die auf der Quellseite aktiviert sind. Dazu können Sie die auf der Modulverwaltungsseite („Administration“ > „Aufbau“ > „Module“) aufgelisteten Module prüfen oder die Seite „Verfügbare Updates“ unter admin/reports/updates nutzen.

Erstellen Sie eine vollständige Liste der auf der Quellseite aktivierten Module und verwenden Sie diese als Checkliste für Ihre Upgrade-Planung. Beantworten Sie für jedes Modul folgende Fragen:

• Benötige ich dieses Modul auch in Drupal 8?
• Ist das Modul in Drupal 8 Core enthalten? Zum Beispiel ist Views jetzt Teil des Drupal 8 Core.
• Gibt es eine Drupal-8-Version des Moduls? Wenn nicht, benötige ich es trotzdem? Gibt es andere Module, die dieselbe Funktionalität bieten?
• Beachten Sie, dass Drupal 6/7-Module nicht unbedingt 1:1 auf Drupal 8-Module abgebildet werden. Zum Beispiel wurde das Block-Modul in Drupal 6 und 7 in die Module Block und Custom Block in Drupal 8 aufgeteilt.

Die Drupal 8 Web-Upgrade-Oberfläche zeigt an, welche Module automatisch migriert werden können und welche nicht. Siehe Upgrade über den Webbrowser für weitere Informationen zu dieser Analyse. Sie können auch das Upgrade-Check-Modul ausprobieren, das einen externen Dienst nutzt, um eine Schätzung der Upgrade-Dauer zu geben.

Prüfen Sie die Seite mit bekannten Problemen

Der Upgrade-Pfad von Drupal 6/7 zu Drupal 8 ist noch experimentell, und einige Kernmodule haben möglicherweise keinen vollständigen Upgrade-Pfad. Lesen Sie vor dem Upgrade die Seite Bekannte Probleme.

Aktualisieren Sie Ihre Drupal 6/7-Seite auf die neuesten Versionen von Kern- und Contrib-Modulen

Der Upgrade-Prozess geht davon aus, dass Ihre alte Seite auf der neuesten Minor-Version läuft. Wenn Ihre Site zum Beispiel mit Drupal 6.35 läuft, müssen Sie sie zuerst auf 6.38 aktualisieren.

Wenn Sie planen, Konfiguration oder Inhalte aus Contrib-Modulen automatisch zu migrieren, verwenden Sie deren neueste Versionen.

Nutzen Sie die Seite „Verfügbare Updates“ Ihrer Drupal 6/7-Site unter admin/reports/updates, um zu prüfen, ob Updates verfügbar sind.

Voraussetzungen für den Wechsel von Drupal 6/7 zu Drupal 8

• Eine neue Drupal 8-Installation mit aktivierten Kernmodulen „Migrate“ und „Migrate Drupal“. Wenn Sie das Upgrade über die Benutzeroberfläche des Browsers durchführen, müssen Sie außerdem das Kernmodul „Migrate Drupal UI“ aktivieren.
• Für alle Übersetzungsmigrationen aus dem Internationalisierungsmodul Drupal 6 und 7 (i18n) muss das mehrsprachige Migrate Drupal Modul (migrate_drupal_multilingual) auf Drupal 8 installiert sein.
• Zugriff auf die Drupal 6- oder 7-Datenbank vom Host, auf dem Ihre neue Drupal 8-Site läuft.
• Zugriff auf die Dateien der Quellseite.

                         - Öffentliche Dateien sind über die Website-URL zugänglich.
                         - Private Dateien müssen für die neue Drupal 8-Site direkt zugänglich sein, und Sie müssen file_private_path in der Drupal 8 settings.php vor dem Upgrade konfigurieren.

• Wenn Sie mit Drush auf Drupal 8 upgraden, benötigen Sie außerdem Drush 8 oder Drush 9 und drei zusätzliche Module.

                         - Installationsanleitungen für Drush finden Sie auf der oben genannten Seite.
                         - Installieren Sie Migrate Tools
                         - Installieren Sie Migrate Upgrade
                         - Installieren Sie Migrate Plus
                         - Weitere Informationen zu den oben genannten Modulen finden Sie unter Liste der Upgrade-Module.
                         - WICHTIG: Achten Sie besonders auf die Kompatibilität der Modulversionen mit Ihrer Drupal 8-Core-Version. Die entsprechenden Versionen sind auf den Seiten der drei genannten Module klar angegeben.

Aktivieren der erforderlichen Kern- und Contrib-Module in Drupal 8

Der Migrationsprozess installiert Module auf der Zielseite Drupal 8 nicht automatisch. Es werden nur Migrationen ausgeführt, die Module betreffen, die sowohl auf der Quell- als auch auf der Zielseite aktiviert sind. Deshalb müssen Sie alle Kern- und Zusatzmodule auf Ihrer Drupal 8-Site aktivieren, für die Sie Konfiguration und Inhalte von der Quellseite migrieren möchten.

Ein paar Beispiele:

• Wenn auf Ihrer Drupal 7-Quellseite das Modul Addressfield aktiviert ist und Sie Adressdaten migrieren möchten, müssen Sie das Modul Address auf Ihrer Drupal 8-Site aktivieren, bevor Sie mit dem Upgrade beginnen. Dies ist ein gutes Beispiel, bei dem Module nicht 1:1 zwischen Drupal 7 und Drupal 8 übereinstimmen. Das Drupal 8 Address-Modul stellt jedoch die notwendigen Migrate-Plugins bereit, um Daten aus dem Drupal 7 Addressfeld zu migrieren.
• Wenn auf der Quellseite das Kernforum-Modul von Drupal 7 aktiviert ist, müssen Sie auch das Kernforum-Modul auf Ihrer Drupal 8-Seite aktivieren, bevor Sie mit dem Upgrade beginnen.

Ändern Sie die Drupal 8-Site nicht

Bedenken Sie, dass der Upgrade-Prozess die Konfiguration auf der Drupal 8-Seite überschreibt, daher sollten Sie keine Änderungen an der Drupal 8-Site vor Abschluss des Upgrades vornehmen. Das bedeutet, dass Sie nicht alle Inhaltstypen und Felder manuell anlegen müssen, bevor Sie dieses Upgrade starten. Das Migrate-Modul wird sie im Migrationsprozess erstellen. Üblicherweise wird Drupal 8 mit dem Minimalprofil installiert, da das Standardprofil eigene Konfiguration mitbringt, die Sie möglicherweise nicht benötigen. Das unterscheidet sich von früheren Drupal-Versionen, wo man alle Inhaltstypen und Felder vorbereiten musste, bevor Migrate ausgeführt werden konnte.

Erstellen Sie keine Inhalte auf der Drupal 8-Site

Der Upgrade-Prozess unterstützt eindeutige IDs von der Quellseite. Zum Beispiel: Wenn ein Benutzerkonto auf der Quellseite die ID 2 hatte (also unter relativem Pfad /user/2 erreichbar), dann wird nach dem Upgrade dieses Konto unter /user/2 auf der Drupal 8-Seite erreichbar sein. Wenn Sie ein Benutzerkonto auf der Drupal 8-Seite außerhalb des Standard-Admin-Kontos manuell erstellen und ihm die Benutzer-ID 2 zugewiesen wird, dann wird beim Upgrade das Benutzerkonto mit der ID 2 von der Quellseite dieses Konto überschreiben. Das gilt auch für Benutzerkonten, Taxonomie-Begriffe, Knoteninhalte und praktisch alle anderen Inhalte mit numerischen IDs von der Quellseite.

Um Datenverlust zu vermeiden, erstellen Sie keine Inhalte manuell auf der Drupal 8-Seite, bis der gesamte Quellinhalt vollständig importiert wurde.

Ausführen des Upgrades

Sie haben zwei Möglichkeiten, die Migration durchzuführen:

• Verwendung der Browser-Benutzeroberfläche. Dies ist der einfachere Weg und kann über die Benutzeroberfläche der Drupal 8-Site durchgeführt werden. Allerdings bietet es weniger Kontrolle über die Migration.
• Verwendung von Drush. Dies ist zuverlässiger und schneller, ermöglicht selektive Migrationen, erfordert jedoch zusätzliche Module und wird über die Kommandozeile ausgeführt.