Het voorbereiden van de site op een upgrade naar Drupal 8

Voordat je een Drupal 6- of Drupal 7-site upgrade naar Drupal 8, is het aanbevolen een aantal stappen te ondernemen om ervoor te zorgen dat het proces soepel verloopt en de gewenste resultaten oplevert.

In tegenstelling tot eerdere grote core-upgrades van Drupal, werkt het upgradeproces van Drupal 8 niet op de plaats van de bestaande site. In plaats daarvan worden configuratie- en contentobjecten gemigreerd van de bronsite naar een schone Drupal 8-site. Zie de pagina Upgraden van Drupal 6 of 7 naar Drupal 8 voor een overzicht van het proces en de belangrijkste verschillen.

Hoewel de upgrade de bronsite niet wijzigt, wordt het aangeraden deze niet uit te voeren op een live site. Het is aanbevolen om een back-up van de live site te gebruiken om een consistente staat van de database te garanderen (geen schrijfbewerkingen tijdens de migratie) en om prestatieproblemen op de live site te voorkomen.

Inventarisatiemodule van de bronsite

Het is belangrijk te begrijpen hoe je bestaande Drupal 6- of Drupal 7-site is opgebouwd voordat je een upgrade naar Drupal 8 uitvoert.

Identificeer de core- en contributed modules die op de bronsite zijn ingeschakeld. Je kunt dit doen door de lijst met modules op de beheerpagina (“Beheer” > “Siteopbouw” > “Modules”) te bekijken of door de pagina “Beschikbare updates” op admin/reports/updates te gebruiken.

Noteer een volledige lijst van ingeschakelde modules op de bronsite en gebruik dit als checklist voor je upgradeplanning. Beantwoord voor elke module de volgende vragen:

• Heb ik deze module nog steeds nodig in Drupal 8?
• Is de module intussen opgenomen in de core van Drupal 8? Bijvoorbeeld, Views is nu onderdeel van de Drupal 8-core.
• Bestaat er een Drupal 8-versie van deze module? Zo niet, heb ik hem nog steeds nodig? Zijn er andere modules die dezelfde functionaliteit kunnen leveren?
• Merk op dat Drupal 6/7-modules niet altijd 1:1 overeenkomen met Drupal 8-modules. Bijvoorbeeld, de Block-module in Drupal 6 en 7 is in Drupal 8 opgesplitst in Block en Custom Block modules.

De upgrade-interface van Drupal 8 laat zien welke modules automatisch kunnen worden bijgewerkt en welke niet. Zie de Upgrade met de webbrowser-pagina voor meer informatie hierover. Je kunt ook de Upgrade Check-module proberen, die een externe service gebruikt om je een schatting van de upgrade-inspanning te geven.

Controleer de pagina met bekende problemen

Het upgradepad van Drupal 6/7 naar Drupal 8 is nog steeds experimenteel, en sommige core-modules hebben mogelijk geen volledig upgradepad. Bij de voorbereiding op de upgrade wordt aanbevolen de pagina Bekende problemen te lezen.

Update je Drupal 6/7-site naar de laatste versies van core en contributed modules

Het upgradeproces gaat ervan uit dat je eerst je oude site hebt bijgewerkt naar de laatste minor release. Als je site bijvoorbeeld draait op Drupal 6.35 core, moet je hem eerst bijwerken naar 6.38.

Als je van plan bent configuratie of content van contributed modules automatisch te migreren, moet je hun laatste versies gebruiken.

Gebruik de pagina Beschikbare updates van je Drupal 6/7-site op admin/reports/updates om te zien of er updates beschikbaar zijn.

Vereisten voor upgrade van Drupal 6/7 naar Drupal 8

• Een nieuwe installatie van Drupal 8 met de coremodules “Migrate” en “Migrate Drupal” ingeschakeld. Als je Drupal 8 via de browserinterface gebruikt, moet je ook de coremodule “Migrate Drupal UI” inschakelen.
• Voor alle vertaalmigraties van de i18n-module in Drupal 6 en Drupal 7 is de installatie van de meertalige Migrate Drupal-module (migrate_drupal_multilingual) op de Drupal 8-site vereist.
• Toegang tot de database van Drupal 6 of 7 vanaf de host waarop je nieuwe Drupal 8-site staat.
• Toegang tot de bestanden van de bronsite.

- Als alleen publieke bestanden worden gebruikt, zijn die toegankelijk via de site-URL.
- Als private bestanden moeten worden gemigreerd, moet de bestandenmap rechtstreeks toegankelijk zijn voor de nieuwe Drupal 8-site en moet je het pad file_private_path in Drupal 8 instellen in settings.php vóór de upgrade.

• Als je Drupal 8 met Drush gebruikt, heb je ook Drush 8 of Drush 9 en drie extra modules nodig.

- Installatie-instructies voor Drush staan op de hierboven genoemde pagina.
- Installeer Migrate Tools
- Installeer Migrate Upgrade
- Installeer Migrate Plus
- Voor meer informatie over de hierboven genoemde modules, zie de lijst van upgrade-modules.
- BELANGRIJK: Let goed op de versiecompatibiliteit van de modules en de gebruikte Drupal 8-coreversie. Op de projectpagina’s van de drie genoemde modules staat duidelijk aangegeven welke versie je moet gebruiken.

Schakel de vereiste core- en contributed modules in Drupal 8 in

Het migratieproces installeert modules niet automatisch op de doelsite Drupal 8. Alleen migraties die betrekking hebben op modules die zowel op de bronsite als op de doelsite zijn geïnstalleerd, worden uitgevoerd. Daarom moet je eerst alle benodigde core- en contributed modules inschakelen op de Drupal 8-site waarvoor je configuratie en content van de bronsite wilt migreren.

Enkele voorbeelden:

• Als de Addressfield-module is ingeschakeld op je Drupal 7-site en je wilt adresgegevens migreren, moet je de Address-module op je Drupal 8-site inschakelen vóór de upgrade. Dit is een goed voorbeeld van modules die niet 1:1 overeenkomen tussen Drupal 7 en Drupal 8. De Address-module in D8 biedt echter de migratie-plugins die nodig zijn om data uit het Addressfield van Drupal 7 te migreren.
• Als de core Forum-module is ingeschakeld op je Drupal 7-site, moet je de core Forum-module inschakelen op je Drupal 8-site vóór de upgrade.

Configureer de Drupal 8-site niet

Houd er rekening mee dat het upgradeproces de configuratie op de Drupal 8-site zal overschrijven, dus voer geen configuratie uit op de Drupal 8-site voordat de upgrade is voltooid. Dit betekent dat je geen contenttypes en velden handmatig hoeft aan te maken vóór de upgrade. De Migrate-module zal deze aanmaken als onderdeel van het migratieproces. In feite is het een veelgebruikte praktijk om Drupal 8 te installeren met het minimale installatieprofiel, omdat het standaardprofiel zijn eigen configuratie introduceert die je mogelijk niet wilt gebruiken. Dit verschilt van hoe Migrate werkte in Drupal 7 en eerdere versies, waar je alle contenttypes en velden handmatig moest voorbereiden.

Maak geen content aan op de Drupal 8-site

Het upgradeproces behoudt unieke ID’s van de bronsite. Als een gebruikersaccount bijvoorbeeld ID 2 had op de bronsite (en dus bereikbaar was op /user/2), dan heeft hetzelfde account ook ID 2 op de Drupal 8-site na de upgrade. Als je een gebruiker aanmaakt op de Drupal 8-site buiten de standaard adminaccount, krijgt die ID 2 – en wanneer de upgrade wordt uitgevoerd, zal de gebruiker met ID 2 van de bronsite deze overschrijven. Dit geldt voor gebruikersaccounts, taxonomietermen, nodes en praktisch alle andere content met numerieke ID’s van de bronsite.

Om dataverlies te voorkomen, maak niets handmatig aan op de Drupal 8-site totdat alle bronsitecontent volledig is geïmporteerd.

De upgrade uitvoeren

Je hebt twee opties om de migratie uit te voeren:

• Via de browserinterface. Dit is eenvoudiger en kan via de UI van de Drupal 8-site. Het biedt echter minder controle over de migratie.
• Met Drush. Dit is krachtiger en sneller en laat selectieve migratie toe, maar vereist extra modules en wordt uitgevoerd via de command line.