Upgraden met een webbrowser
Voordat je begint
Lees voordat je begint met upgraden eerst de voorgaande pagina’s van deze handleiding:
Zorg ervoor dat je de laatste versie van Drupal 8 gebruikt. Je kunt jouw versie controleren op de statusrapportpagina van je Drupal 8 site (/admin/reports/status). De migratietools zijn nog steeds in ontwikkeling, dus om de nieuwste migratieverbeteringen te hebben moet je je Drupal core up-to-date houden.
Zorg ervoor dat de volgende kernmodules zijn ingeschakeld op je Drupal 8 site:
- Migrate
- Migrate Drupal
- Migrate Drupal UI
Installeer en activeer de contributed modules op de Drupal 8 site waarvan je de configuratie en inhoud vanaf de bronsite wilt migreren.
De bronsite definiëren
- Start het upgradeproces door naar /upgrade op je Drupal 8 site te gaan. Als je een «Pagina niet gevonden»-fout krijgt, controleer dan of de module «Migrate Drupal UI» is ingeschakeld.
- Definieer de databaseverbinding van je Drupal 6/7 bronsite. Als de bronsite een databaseprefix gebruikt, vouw de extra opties uit en geef de prefix op.
- Geef de mappen op van de publieke en private bestanden van je bronsite, zodat bestanden kunnen worden gekopieerd naar je Drupal 8 site.
- Zie de screenshot hieronder.
Bekijk de pre-upgrade analyse
Als de databasegegevens correct zijn, verschijnt de overzichtspagina zoals hieronder getoond. Deze pagina geeft een samenvatting van de upgrade-status van alle geïnstalleerde modules op de oude site.
Als sitebouwer moet je de modules die niet worden bijgewerkt zorgvuldig beoordelen. Voor elke module bepaal je of je Drupal 8 site kan functioneren zonder die module. Laten we enkele modules van de screenshot als voorbeeld gebruiken:
- Addressfield levert een veldtype voor het opslaan van adresgegevens.
- Als je doorgaat met upgraden, zullen nodes met adressen van de bronsite naar Drupal 8 gemigreerd worden zonder adres, wat waarschijnlijk niet het gewenste resultaat is.
- Dit kan worden opgelost door de Address module in Drupal 8 te installeren en in te schakelen.
- Met andere woorden: voer nog niet de echte upgrade uit, maar installeer eerst de ontbrekende Drupal 8 module en start dan opnieuw het upgradeproces. Vervolgens zie je dat het Address veld in de lijst staat als module die wél wordt bijgewerkt.
- Color – een core module in Drupal 7 waarmee je eenvoudig de kleurenschema’s van thema’s kunt aanpassen.
- Er is momenteel geen upgrade-pad voor het migreren van Color configuratie van Drupal 7 naar Drupal 8.
- Je kunt de instellingen handmatig configureren op je Drupal 8 site na de upgrade.
- Het is veilig om door te gaan met upgraden, maar houd er rekening mee dat Color instellingen niet automatisch worden gemigreerd.
- Views maakt het mogelijk lijstweergaven van content te bouwen.
- Zelfs als je Views in Drupal 8 hebt ingeschakeld (nu in core), verschijnt Views als «Niet bijgewerkt». Dit komt omdat er geen automatisch migratiemechanisme bestaat voor Views configuratie van Drupal 6/7 naar Drupal 8.
- Het is veilig om door te gaan, maar je zult je Views handmatig opnieuw moeten aanmaken in Drupal 8.
De lijst van modules die worden gemigreerd is standaard ingeklapt. Als je deze opent zie je wat er naar de nieuwe site gaat. Bijvoorbeeld: de Block module van de bronsite wordt opgesplitst in twee modules in Drupal 8. Dit is enkel ter informatie.
ID-conflictwarnings
Zoals beschreven in de voorbereidingsstap, moet de Drupal 8 site volledig leeg zijn bij de upgrade. Als je bijvoorbeeld handmatig een node aanmaakt in Drupal 8 vóór de upgrade en je bronsite heeft een node met hetzelfde ID, zal het migratiesysteem de handmatig gemaakte node overschrijven.
Als er conflicterende ID’s worden gedetecteerd, verschijnt een waarschuwing zoals hieronder. Je kunt dit negeren (met risico op dataverlies) of de upgrade stoppen en een alternatieve aanpak gebruiken zoals beschreven in de documentatie over bekende problemen.
Upgrade uitvoeren
De pre-upgrade analyse is de laatste stap voor de echte upgrade. Dit is je laatste kans om te annuleren. Zodra je op «Upgrade uitvoeren» klikt, start het proces.
Afhankelijk van de hoeveelheid content/configuratie op de bronsite kan de upgrade lang duren (mogelijk uren bij grote datasets). Door wachtwoordversleuteling duren gebruikersaccounts extra lang. Je krijgt continu feedback tijdens het proces, zowel voortgang als foutmeldingen:
Nieuwe meldingen verschijnen bovenaan de pagina en oude verdwijnen onderaan terwijl het proces doorgaat.
Migratielogs bekijken
Alle meldingen tijdens de upgrade kunnen later nog bekeken worden. Na afloop ga je naar de homepage van de site en zie je een overzicht:
Hier kun je de geregistreerde meldingen bekijken en fouten controleren. De module gebruikt de ingebouwde logging van Drupal, dus standaard kun je logs in de database bekijken via:
Je kunt filteren op meldingen (voor positieve feedback) of fouten (voor problemen tijdens migratie). Als er iets misgaat, kan dit een bug zijn (controleer de issue queue of neem contact op met de migratiegroep) of je dataset is te groot (probeer in dat geval de upgrade met Drush).