Ecco come risolvere i problemi che potresti riscontrare durante la configurazione di Google Workspace Migrate e nel corso di una migrazione.
Errori relativi alle associazioni | Monitoraggio di una migrazione | Errori relativi ai bridge
Risolvere i problemi relativi alle associazioni o alla connessioni
Apri sezione | Comprimi tutto e torna all'inizio della pagina
Controllare i log dell'host del servizio- Per trovare i log:
- In un'installazione della piattaforma: vai a C:\Programmi\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log.
- Nell'installazione di un nodo: vai a C:\Programmi\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log.
Nota: se utilizzi una versione precedente di Google Workspace Migrate, potresti dover utilizzare G Suite nel percorso anziché Google Workspace.
- Apri il log e scorri fino alla fine.
- Risolvi i problemi pertinenti, se presenti.
Puoi ignorare tranquillamente il messaggio "Access denied: Symmetric encryption is required for this service request but not configured" (Accesso negato: la crittografia simmetrica è obbligatoria per questa richiesta di servizio, ma non è configurata).
- Se non riesci a risolvere il problema, vai a Contattare l'assistenza per i problemi relativi a Google Workspace Migrate.
- Accedi alla piattaforma Google Workspace Migrate e, nell'angolo in alto a destra, fai clic su Servers (Server).
- Verifica che i nodi siano riportati nell'elenco.
- Verifica che lo stato dei nodi sia impostato su Ready (Pronto), in verde.
Se ricevi un messaggio di errore durante il tentativo di associare un nodo alla piattaforma Google Workspace Migrate, controlla se il nodo è in esecuzione:
- In un browser sul computer che esegue la piattaforma, inserisci l'indirizzo IP e la porta del nodo (ad esempio http://192.0.2.1:5131).
- Se la piattaforma può raggiungere il nodo e il servizio nodo è in esecuzione, verrà visualizzato il messaggio "Node is running" (Nodo in esecuzione).
- Se viene visualizzato un messaggio di errore, prova le seguenti opzioni:
- Se si tratta di un errore di rete, risolvilo e riprova.
- Riavvia il servizio nodo.
- Reinstalla l'applicazione del nodo. Per informazioni dettagliate, segui i passaggi descritti in Installare i server nodo.
Se ricevi questo errore:
- Vai al log dell'host del servizio del server nodo.
Per maggiori dettagli, vedi Controllare i log dell'host del servizio.
- Controlla se viene visualizzato il seguente errore: L'indirizzo dell'host della piattaforma fornito https://platformserver:443/Hub non è raggiungibile.
- Se viene visualizzato un messaggio di errore, prova le seguenti opzioni:
- Verifica la connessione di rete al server della piattaforma. Se si verifica un problema di rete, risolvilo e riavvia il servizio nodo.
- Se la piattaforma è configurata con un certificato TLS, in un browser sul computer che la esegue, inserisci l'indirizzo IP e la porta della piattaforma (ad esempio, https://192.0.2.1:5131). Inoltre, controlla che il certificato TLS sia valido e che non sia scaduto.
Se viene visualizzato un messaggio invalid_grant nel log dell'host, assicurati che le seguenti condizioni siano soddisfatte:
- Hai attivato tutti gli ambiti API per il tuo account di destinazione. Per informazioni dettagliate, vedi Utilizza Google Cloud Console per attivare le API.
- L'account di servizio dispone delle autorizzazioni necessarie per gli ambiti richiesti nella Console di amministrazione Google. Per l'autorizzazione, utilizza il tuo ID client OAuth 2.0 e non l'ID client dell'account di servizio. Per informazioni dettagliate, vedi Creare l'ID client web per OAuth.
Se la migrazione è lenta o non viene eseguita affatto, l'errore potrebbe essere correlato ai livelli delle quote API di Google Workspace. Per informazioni dettagliate, vedi Utilizzo delle quote.
Monitorare lo stato e l'avanzamento di una migrazione
Apri sezione | Comprimi tutto e torna all'inizio della pagina
Monitorare le partizioniQuando esegui un'analisi o un bridge, puoi monitorare lo stato delle partizioni.
- Nella piattaforma Google Workspace Migrate, fai clic su Scans (Analisi) o Bridges (Bridge).
- Sull'analisi o sul bridge che vuoi controllare, fai clic su Logs (Log)
Partition logs (Log Partizione).
- In State (Stato), controlla lo stato delle partizioni:
- Ready (Pronta): pronta per iniziare.
- Starting (In fase di avvio): è in corso la preparazione per la migrazione o l'analisi.
- Crawling (Scansione in corso): è in corso la lettura dei dati dal sistema di origine.
- Processing (In fase di elaborazione): è in corso la preparazione alla scrittura dei dati nel sistema di destinazione.
- Committing (Esecuzione del commit in corso): è in corso la scrittura dei dati nel sistema di destinazione.
- Cancelled (Annullata): operazione non riuscita. Vai a Risolvere i problemi relativi alle partizioni annullate.
- Completed (Completata): l'operazione è stata portata a termine.
- Skipped (Ignorata): questo stato viene visualizzato in caso di nuovo tentativo di un'operazione non riuscita, che viene ignorata perché non sono presenti errori.
Se lo stato di una partizione risulta Canceled (Annullata) nel log Partition (Partizione), usa le opzioni seguenti per risolvere il problema.
Opzione 1: controlla i codici di errore
Per individuare i codici di errore, posiziona il puntatore del mouse su una riga del log Partition (Partizione) e fai clic su More (Altro) Partition log (Log Partizione). Utilizza il codice associato all'errore per risolvere il problema. Per informazioni dettagliate, vedi Interpretare i messaggi di errore di Google Workspace Migrate.
Opzione 2: controlla i nodi
Utilizza il log Partition (Partizione) per verificare se tutte le partizioni di un nodo sono state annullate. Tutti i nodi annullati di solito indicano problemi di connessione, ad esempio dovuti al fatto che il servizio di origine è temporaneamente non disponibile. Completa i passaggi descritti in Errore durante l'associazione di un nodo. Quindi, prova a ripetere l'analisi o a eseguire una migrazione delta.
Opzione 3: controlla il log Partition execution (Esecuzione della partizione)
Se il problema riguarda più nodi, puoi esaminare il log Partition execution (Esecuzione della partizione). Per visualizzare il log Execution (Esecuzione) associato a una partizione:
- Apri il log Partition (Partizione).
- Posiziona il cursore del mouse su una riga del log e fai clic su More (Altro)
- Fai clic su State (Stato)
- Esamina gli errori per individuarne la causa e risolvere il problema.
- Riprova a eseguire l'analisi o la migrazione.
Se rilevi un aumento di errori simili nel riepilogo della migrazione, è probabile che la configurazione della migrazione non sia corretta.
Controlla i seguenti elementi della configurazione per assicurarti che siano impostati correttamente:
- Assicurati che le API, in particolare SDK Admin, siano attivate correttamente nella Console di amministrazione Google. Per informazioni dettagliate, vedi Utilizza Google Cloud Console per attivare le API.
- Assicurati che l'account utente esista nell'account di origine e in Google Workspace Migrate. Verifica che l'account non sia stato bloccato, sospeso o rinominato.
- Verifica che per tutti gli utenti siano attivati i servizi Google Workspace Migrate necessari (ad esempio Gmail o Google Drive). Per informazioni dettagliate, vai a Requisiti di Google Workspace.
Se visualizzi questo errore nei log dell'host, potrebbe essere necessario consentire le app di terze parti per i file di Drive.
Per risolvere il problema, segui i passaggi descritti in Consentire alle app di terze parti di lavorare su file archiviati su Drive.
Correggere gli errori relativi ai bridge
Apri sezione | Comprimi tutto e torna all'inizio della pagina
Eseguire un bridge come migrazione deltaLa migrazione delta consente spesso di risolvere molti errori. Una migrazione delta consente di identificare gli errori persistenti e di rimuovere i problemi temporanei, ad esempio le limitazioni di frequenza e i livelli di quota, i problemi di rete e gli errori di tipo 401. Puoi eseguire una migrazione delta più volte per risolvere i problemi. Per informazioni dettagliate, vedi Prepararsi per il passaggio definitivo.
| Parola chiave o errore 60008 | Passaggi per la risoluzione dei problemi |
|---|---|
| No mapping found (Nessuna mappatura trovata). | Potresti riscontrare questo errore se stai eseguendo la migrazione dei dati di un Drive condiviso da un account Google Workspace Migrate a un altro e hai creato manualmente i Drive condivisi nel nuovo account. Per risolvere il problema:
|
| Transaction that the affected item depended on failed (La transazione da cui dipendeva l'elemento interessato non è riuscita). | Esamina gli altri elementi con errori nello stesso bridge e risolvi i relativi problemi. Una volta risolti i problemi, esegui un bridge delta. |
|
Parent object failed to migrate (La migrazione dell'oggetto padre non è riuscita). Potresti anche visualizzare il seguente messaggio: The bridge execution was halted or completed prior to dependency of the transaction being completed (L'esecuzione del bridge è stata interrotta o completata prima del completamento della dipendenza della transazione). |
La migrazione dell'oggetto padre dell'elemento interessato non è riuscita o la migrazione dell'oggetto figlio è stata eseguita prima di quella dell'oggetto padre. Per risolvere il problema:
|
| Target parent entities removed, renamed, or moved to another location after a migration. When another bridge attempted to migrate the source parent or child entities again, they couldn't be found. (Entità padre di destinazione rimosse, rinominate o spostate in un'altra posizione dopo una migrazione.Quando un altro bridge ha tentato di eseguire di nuovo la migrazione delle entità padre o figlio di origine, non è stato possibile trovarle). |
|
| Source-to-target mapping pair isn't supported (La coppia di mappatura origine-destinazione non è supportata). | Esamina le mappature per assicurarti che le posizioni di origine e di destinazione siano valide. Per informazioni dettagliate, vai a Creare e gestire una mappatura per Exchange, SharePoint, Condivisioni file, Box o Google Workspace Migrate |
| LocationNotFound | Non è stato possibile eseguire la migrazione di un Drive condiviso Google Workspace a un Drive condiviso nell'account di destinazione perché l'utente di destinazione non ha una licenza Google Workspace che include Drive condivisi. Controlla le licenze del tuo account di destinazione e riprova. |
| OrphanedContent |
Potresti visualizzare questo errore anche se il proprietario dell'elemento orfano non è specificato come account di origine nella mappatura.Google Workspace Migrate non eseguirà la migrazione dell'elemento e mostrerà un codice di errore 60008. L'errore è inevitabile in questa situazione. Nota: i file orfani in una posizione di destinazione diversa probabilmente derivano da un problema separato. Questo può verificarsi, ad esempio, se non è stata specificata una cartella di destinazione nella mappatura per gli elementi orfani e questi elementi vengono inseriti nella cartella principale Il mio Drive dell'utente di destinazione. |
| Nessuna mappatura trovata per l'utente |
|
Se la migrazione dei file non riesce e viene visualizzato questo errore:
- Apri il log Transaction (Transazione).
- In Error Code (Codice di errore), cerca 1029 per determinare se la migrazione della cartella principale non è riuscita.
- Se la cartella principale non è stata migrata, controlla il codice di errore e risolvi il problema.
- Eseguire un bridge delta.
Se esegui la migrazione dei file da un Drive condiviso a un altro, assicurati di utilizzare una mappatura delle identità che mappa le origini agli utenti target nel bridge.
- Nella piattaforma Google Workspace Migrate, fai clic su Scans (Analisi) o Bridges (Bridge).
- Sull'analisi o sul bridge che vuoi controllare, fai clic su Logs (Log)
- Posiziona il cursore del mouse sulla transazione e fai clic su More (Altro)
- Utilizza la tabella per individuare gli errori comuni relativi alle transazioni e i passaggi per risolvere i problemi.
| Messaggio e codice di errore | Passaggi per la risoluzione dei problemi |
|---|---|
| Transaction in a Failed state (Transazione in stato Non riuscita) | Individua la transazione e risolvi il problema utilizzando le informazioni riportate nei dettagli sulla transazione. |
| Error message: The request type does not allow write operations (Messaggio di errore: Il tipo di richiesta non consente le operazioni di scrittura)
Error code: 1048640 (Codice di errore: 1048640) |
Il gestore di richieste per il tipo di oggetto non è in grado di scrivere l'oggetto nell'account di destinazione (ad esempio, l'elemento di origine non ha un tipo equivalente in Google Workspace).
Controlla che la mappatura della posizione sia impostata correttamente e che le mappature siano logiche. |
| Error message: An internal connector error occurred (Messaggio di errore: errore interno nel connettore)
Error code: 2097125 (Codice di errore: 2097125) |
Controlla i messaggi di errore nei log Transaction (Transazione) ed Execution (Esecuzione). Se il messaggio di errore non aiuta a risolvere il problema, verifica i dettagli nei log dell'host della piattaforma o del servizio nodo. |
| The bridge execution was halted or completed prior to dependency of the transaction being completed (L'esecuzione del bridge è stata interrotta o completata prima della dipendenza della transazione) | L'elemento non è stato trasferito perché dipendeva dalla precedente migrazione di un altro elemento, che non è andata a buon fine. Ad esempio, la migrazione di un file in una cartella non è stata eseguita perché non era stata creata la cartella su Drive.
Nell'errore, individua ABHierarchicalPath.Path e prendi nota dell'elemento associato. Quindi, trova l'elemento nei log delle transazioni per capire perché la migrazione non è riuscita. |
Una transazione nel log Transaction (Transazione) potrebbe essere ignorata per i seguenti motivi:
- Stai eseguendo una migrazione delta e l'oggetto non è cambiato rispetto alla migrazione precedente.
- L'oggetto è stato escluso da una condizione di filtro nel modello di impostazioni.
- Stai eseguendo la migrazione di contenuti email a un gruppo e un allegato di grandi dimensioni viene ignorato.
- Stai usando un modello di impostazioni di un Drive condiviso, ma stai eseguendo una migrazione di contenuti a Il mio Drive.
A seconda dell'origine della migrazione, esistono altri motivi per cui un elemento potrebbe essere ignorato:
- SharePoint: una cartella viene ignorata perché non fa parte di una raccolta documenti.
- Exchange: le bozze delle email vengono ignorate durante la migrazione a Google Gruppi.
- Box: la revisione di un file viene ignorata perché vuota.
- Condivisioni file: un elemento viene ignorato perché i nodi non dispongono di autorizzazioni sufficienti per accedervi.
- Gmail: i messaggi di Chat (elementi che si trovano sotto l'etichetta Chat) vengono ignorati.
Quando esegui la migrazione da un Drive condiviso all'altro utilizzando il modello di impostazioni Predefinito, GWM crea il nuovo Drive condiviso nell'account di destinazione, ma potrebbe non eseguire la migrazione dei dati dal Drive condiviso di origine. I motivi sono i seguenti:
- Non è presente alcuna mappatura delle identità per l'origine e la destinazione.
- L'opzione Consenti utenti non mappati nel modello non è selezionata.
Esistono due modi per correggere il problema:
- Crea un modello personalizzato dal modello di impostazioni Predefinito e seleziona Consenti utenti non mappati.
- Aggiungi una mappatura delle identità.
Il report sulle transazioni potrebbe essere troppo grande per essere scaricato. Risolvi il problema con queste opzioni:
Opzione 1: aggiungi filtri prima della migrazione
Per ridurre le dimensioni del report, filtra il log delle transazioni per cercare dati specifici, ad esempio lo stato di completamento o il codice di errore. Per i dettagli, vedi Monitorare l'avanzamento della migrazione.
Opzione 2: scarica il log con i filtri
Puoi utilizzare la riga di comando per specificare come scaricare il log delle transazioni:
- Per ridurre il numero di elementi nel log, utilizza l'opzione transactionState.
- Per aumentare il tempo necessario per scaricare il log, utilizza l'opzione queryTimeout.
Per maggiori dettagli, vedi Scarica i log utilizzando la riga di comando.
Se le migrazioni sono più lente del previsto, verifica di soddisfare i seguenti requisiti di sistema.
Livelli di quota API di Google
Le impostazioni della quota possono causare codici di errore, ad esempio 403 Accesso negato, 429 Troppe richieste o 503 Servizio non disponibile. Per verificare se i livelli di quota influiscono sulla velocità di migrazione:
- Controlla le quote nella console Google Cloud. Per la procedura, vai a Visualizza le quote nella console Google Cloud.
- Modifica le quote per supportare l'utilizzo delle risorse. Per i passaggi, vai a Gestisci le quote utilizzando la console.
Impostazioni di limitazione lato client
Le impostazioni di limitazione gestiscono la velocità con cui i client possono inviare richieste ai servizi Google. A volte, le impostazioni causano codici di errore, ad esempio 403 Accesso negato, 429 Troppe richieste o 503 Servizio non disponibile.
Questi codici di errore possono derivare da tassi di limitazione troppo elevati in Google Workspace Migrate (GWM). Se la limitazione lato client è elevata senza una limitazione lato server significativa, la modifica delle impostazioni di padding in GWM può essere utile.
Prima di iniziare
- Queste modifiche devono essere tentate solo da amministratori esperti, poiché gli aggiornamenti potrebbero avere conseguenze indesiderate.
- I passaggi seguenti impostano la strategia di limitazione di Google, ma potresti anche dover utilizzare altre origini dati, tra cui googleThrottlingStrategy, exchangeThrottlingStrategy e sharepointThrottlingStrategy.
Per eseguire l'override delle strategie di limitazione predefinite su GWM versione 2.1.54.0 e successive:
- Sul server della piattaforma, crea la directory: C:\ProgramData\AppBridge\Overrides
- Aggiungi un file JSON denominato throttling_settings.json.
- Utilizzando il Blocco note, aggiungi il seguente testo al file JSON:
{
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
} - Salva il file JSON.
- Nella barra delle applicazioni di Windows, fai clic su
.
- Arresta il servizio GWM e riavvialo.
Limitazioni del firewall
Per ridurre le interferenze con le operazioni su disco e di rete, disinstalla il software antivirus, gli scanner di sicurezza e altri software non essenziali dai server Workspace.
Google Workspace Migrate utilizza MySQL per archiviare le impostazioni di configurazione e i dettagli di logging. Se la connessione MySQL è intermittente o non risponde, vai a Controlla i log dell'host del servizio e segui i passaggi per l'installazione di una piattaforma.
Se visualizzi errori MySQL per AppBridgeServiceHost.log:
- Vai a Risolvere i problemi di MySQL.
- Se hai ancora bisogno di aiuto, consulta Contattare l'assistenza per problemi relativi a Google Workspace Migrate.
Hai ancora bisogno di aiuto?
Vai a Contattare l'assistenza per problemi relativi a Google Workspace Migrate.
Google, Google Workspace e marchi e loghi correlati sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle rispettive società a cui sono associati.