# Google Workspace Migrate handleiding [[TOC]] ## Wat is Google Workspace Migrate Google Workspace Migrate (GWM) is een door Google ontwikkelde migratietool die je gratis kunt gebruiken bij een betaalde Workspace-licentie. De tool draait op een of meer Windows-servers in je eigen netwerk en kopieert data van de bronomgeving naar Workspace. GWM is specifiek bedoeld voor grote migraties (vanaf ongeveer 1001 gebruikers). Voor kleinere migraties zijn er eenvoudigere tools, zie de tip verderop in dit artikel. Ondersteunde bronnen (situatie 2026): - Microsoft Exchange (2010, 2013, 2016, 2019) - Microsoft SharePoint (2010, 2013, 2016) en SharePoint Online - Microsoft OneDrive - Fileshares (netwerkshares) - Box Enterprise Migreerbare data hangt af van de bron en bestaat onder andere uit: - E-mail, agenda en contactpersonen (vanuit Exchange) - Bestanden en mappen (vanuit SharePoint, OneDrive, fileshares en Box) naar Google Drive :::info title="GWM doet geen Notes, GroupWise of IMAP" Lotus/HCL Notes, Novell GroupWise en losse IMAP-servers vallen niet onder Google Workspace Migrate. Voor e-mailmigraties vanuit die bronnen gebruik je andere tooling, zoals Google Workspace Migration for Microsoft Exchange (GWMME) of de Data Import Service in de Admin-console. ::: ## Architectuur GWM bestaat uit meerdere componenten die je over een of meer Windows-servers verdeelt: - **Platform-server**: beheert de migratiestroom en de configuratie. - **Node-servers (processors)**: voeren het daadwerkelijke datatransport uit. Je kunt meerdere nodes parallel laten draaien voor hogere snelheid. - **Database-servers**: slaan de migratiemetadata op (MySQL en CouchDB). Minimale serverconfiguratie voor een kleine opzet: - Microsoft Windows Server 2016 of 2019. - Ten minste 4 cores, 16 GB RAM en 200 GB SSD voor de platform-server. - .NET Framework 4.5 of nieuwer (en .NET Framework 3.5 voor de CouchDB-server). - Google Chrome voor de beheerconsole. - Netwerktoegang tot de bronserver en internettoegang voor Workspace. Voor grotere migraties verdeel je de rollen over aparte servers. Database-servers vragen aanzienlijk meer resources (richtlijn: 16 cores en 64 GB RAM per server, plus ruime SSD-capaciteit afhankelijk van het aantal objecten). :::tip title="Zet de servers op High performance" Stel het Windows-energieschema in op High performance op alle GWM-servers. Energiebesparing schakelt processors terug en vertraagt de migratie merkbaar. ::: ## Installatie :::howto title="GWM installeren" 1. Download GWM via de officiele Workspace-migratiepagina (`workspace.google.com/products/migrate`) of de downloadlink in de Admin-documentatie. 2. Voer het installatiebestand uit op de Windows-server die je als platform-server gebruikt. 3. Volg de installatiewizard en wijs de rollen (platform, node, database) toe. 4. Open na installatie de GWM-beheerconsole via Chrome op de server. ::: ## Service account configureren GWM gebruikt een service account met domain-wide delegation (DWD) om data te schrijven naar Workspace-accounts. Volg hiervoor de stappen uit het artikel over service accounts en DWD. De benodigde scopes voor GWM zijn onder andere: ``` https://www.googleapis.com/auth/gmail.insert https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/contacts https://www.googleapis.com/auth/drive ``` :::warn title="Beperk de scopes tot wat je migreert" Migreer je alleen bestanden vanuit een fileshare of SharePoint, ken dan ook alleen de Drive-scope toe. Hoe minder brede DWD-scopes, hoe kleiner het beveiligingsrisico als de sleutel uitlekt. ::: ## Migratieproject aanmaken :::howto title="Een migratieproject opzetten" 1. Open de GWM-beheerconsole. 2. Maak een nieuw project aan. 3. Configureer de bronverbinding (bijvoorbeeld Exchange via autodiscover of een directe server-URL, of een SharePoint/OneDrive-verbinding). 4. Configureer de doelverbinding (Workspace via het service account met DWD). 5. Voeg gebruikers toe aan het project via een CSV-bestand of handmatig. 6. Kies de te migreren datatypen en het tijdsbereik. 7. Start een testmigratieronde voor een kleine subset voor je opschaalt. ::: ## Migratiestrategie Een beproefde aanpak voor een grotere organisatie verloopt in drie fasen. In de **pre-migratieronde** migreer je oudere data, bijvoorbeeld alles ouder dan 30 dagen, al ruim voor de cutover. Dat verkleint de hoeveelheid die je op de switch-dag nog moet verwerken. Tijdens de **cutover** migreer je de laatste periode en synchroniseer je de delta, dus de berichten en bestanden die sinds de pre-migratie zijn bijgekomen. In de **post-migratieronde** haal je eventuele items op die tijdens de cutover niet zijn overgezet, en controleer je de volledigheid. :::warn title="Test eerst met een pilotgroep" Migreer altijd eerst een pilotgroep van 5 tot 10 gebruikers voor je de hele organisatie overzet. Controleer of mapstructuren, regels, gedeelde mappen en agenda-afspraken correct zijn meegekomen. ::: ## Prestaties optimaliseren - Voeg extra node-servers toe voor parallelle verwerking. - Plan zware migratierondes buiten kantooruren en geef prioriteitsgebruikers voorrang. - Houd het API-quotumgebruik in de gaten via het dashboard; loop je tegen limieten aan, vraag dan tijdig een quotumverhoging aan. - Zorg voor voldoende bandbreedte tussen de bronserver en de GWM-servers; dit is vaak de echte bottleneck. ## Na de migratie :::howto title="Afronden na de migratie" 1. Verifieer per steekproef dat data correct en volledig is overgezet. 2. Controleer of agenda-afspraken de juiste tijdzone hebben. 3. Schakel de toegang van gebruikers tot de bronserver uit. 4. Verwijder de GWM-installatie en de service account-sleutel zodra de migratie volledig is afgerond. ::: :::faq ### Is Google Workspace Migrate gratis? Ja, GWM is inbegrepen bij een betaalde Workspace-licentie. Je betaalt alleen voor de Windows-servers die je zelf draait en beheert. ### Voor welke organisaties is GWM bedoeld? GWM is ontworpen voor grote migraties, doorgaans vanaf ongeveer 1001 gebruikers. Voor kleinere migraties zijn er eenvoudigere opties die direct vanuit de Admin-console werken. ### Kan ik nog vanuit een on-premises Exchange-server migreren? Ja. De legacy Data Migration Service stopte op 31 mei 2025 met on-premises Exchange, maar GWM en GWMME ondersteunen on-premises Exchange nog steeds als bron. ### Welke tool gebruik ik voor een kleine migratie? Voor kleinere migraties (tot ongeveer 1000 gebruikers) gebruik je de Data Import Service in de Admin-console of GWMME. Die zijn eenvoudiger op te zetten dan GWM. ### Wat als een migratie voor een gebruiker mislukt? Mislukte items worden per taak gelogd. Je kunt gefaalde batches opnieuw starten nadat je de oorzaak hebt opgelost, zonder de hele migratie over te doen. ### Hoe lang duurt een migratie? Dat hangt af van de datahoeveelheid, de prestaties van de bronserver, je bandbreedte en het aantal node-servers. Reken op een ruwe orde van enkele GB per uur per node; meer nodes betekent meer parallelle doorvoer. :::