En este artículo se explica cómo solucionar problemas que pueden surgir al configurar Google Workspace Migrate y hacer una migración.
Errores de asociación | Hacer el seguimiento de una migración | Errores de puente
Solucionar problemas de asociación o de conexión
Abrir sección | Ocultar todo y volver al principio
Comprobar los registros del host de servicio- Para encontrarlos, sigue estos pasos:
- En una instalación de plataforma, ve a C:\Archivos de programa\Google Workspace Migrate\Google Workspace Migrate Platform\AppBridgeServiceHost.log.
- En una instalación de nodo, ve a C:\Archivos de programa\Google Workspace Migrate\Google Workspace Migrate Platform Node\AppBridgeServiceHost.log.
Nota: Si tienes una versión anterior de Google Workspace Migrate, es posible que tengas que usar la ruta con G Suite en lugar de Google Workspace.
- Abre el registro y desplázate hasta el final.
- Si hay algún problema relevante, corrígelo.
Puedes ignorar el mensaje "Access denied: Symmetric encryption is required for this service request but not configured" (Acceso denegado: el cifrado simétrico es necesario para esta solicitud de servicio, pero no está configurado).
- Si no puedes solucionar el problema, ve al artículo Contactar con el servicio de asistencia para resolver problemas con Google Workspace Migrate.
- Inicia sesión en la plataforma Google Workspace Migrate y, en la esquina superior derecha, haz clic en Servers (Servidores).
- Comprueba que los nodos aparezcan en la lista.
- Comprueba que el estado de los nodos sea Ready (Listo) (color verde).
Si recibes un mensaje de error al intentar asociar un nodo a la plataforma Google Workspace Migrate, comprueba si el nodo se está ejecutando:
- En el navegador de un equipo que ejecute la plataforma, introduce la dirección IP y el puerto del nodo (por ejemplo, http://192.0.2.1:5131).
- Si la plataforma puede acceder al nodo y el servicio de nodos se está ejecutando, verás el mensaje "Node is running" (El nodo se está ejecutando).
- Si aparece un error, prueba con estas opciones:
- Si se trata de un error de red, resuélvelo e inténtalo de nuevo.
- Reinicia el servicio de nodos.
- Vuelve a instalar la aplicación de nodo. Para obtener información detallada, sigue los pasos que se indican en el apartado Instala los servidores de nodo.
Si aparece este error:
- Ve al registro del host de servicio del servidor de nodos.
Consulta más información sobre cómo comprobar los registros del host de servicio.
- Comprueba si hay el siguiente error: The provided platform host address https://platformserver:443/Hub was unreachable (La dirección del host de la plataforma proporcionada https://platformserver:443/Hub no estaba accesible).
- Si aparece el error, prueba con estas opciones:
- Comprueba la conexión de red al servidor de la plataforma. Si hay un problema con la red, resuélvelo y reinicia el servicio de nodos.
- Si la plataforma está configurada con un certificado TLS, en un navegador del ordenador que ejecute la plataforma, introduce la dirección IP y el puerto (por ejemplo, https://192.0.2.1:5131). Comprueba también que el certificado TLS sea válido y que no haya caducado.
Si aparece el mensaje invalid_grant en el registro del host, comprueba lo siguiente:
- Has habilitado todos los permisos de la API de tu cuenta de destino. Para obtener información detallada, consulta el apartado Activa las APIs mediante la Consola de Google Cloud.
- La cuenta de servicio está autorizada para los permisos requeridos en la consola de administración de Google. Utilizas tu ID de cliente de OAuth 2.0 para la autorización, no el ID de cliente de tu cuenta de servicio. Para obtener información detallada, consulta el artículo Crear el ID de cliente web de OAuth.
Si la migración se ejecuta lentamente o no se ejecuta, es posible que el error esté relacionado con los niveles de cuota de la API de Google Workspace. Consulta información detallada en el artículo Trabajar con cuotas.
Hacer un seguimiento del estado y el progreso de una migración
Abrir sección | Ocultar todo y volver al principio
Supervisar particionesAl ejecutar un análisis o un puente, puedes monitorizar el estado de las particiones.
- En la plataforma Google Workspace Migrate, haz clic en Scans (Análisis) o en Bridge (Puente).
- En el análisis o puente que quieras comprobar, haz clic en Logs (Registros)
Partition log (Registro de partición).
- En State (Estado), comprueba el estado de las particiones:
- Ready (Lista): lista para empezar.
- Starting (Iniciando): preparada para migrar o analizar.
- Crawling (Rastreando): leyendo datos del sistema de origen.
- Processing (Procesando): preparándose para escribir datos en el sistema de destino.
- Committing (Confirmando): escribiendo los datos en el sistema de destino.
- Cancelled (Cancelada): operación no realizada. Consulta el apartado Solucionar problemas con particiones canceladas.
- Completed (Completada): la partición ha terminado.
- Skipped (Omitida): se muestra cuando se intenta procesar transacciones fallidas. Se ha omitido porque no se ha detectado ningún error.
Si encuentras una partición con el estado Cancelled (Cancelada) en el registro de partición, sigue las opciones que se indican a continuación para solucionar el problema.
Opción 1: Comprobar los códigos de error
Para localizar los códigos de error, coloca el cursor sobre una fila del registro de partición y haz clic en More (Más) Partition log (Registro de partición). Para solucionar el problema, usa el código de error asociado. Para obtener información detallada, consulta el artículo Interpretar los mensajes de error de Google Workspace Migrate.
Opción 2: Comprobar los nodos
Utiliza el registro de la partición para comprobar si se han cancelado todas las particiones de un nodo. Que todos los nodos estén cancelados suele indicar que hay problemas de conexión; por ejemplo, el servicio de origen no está disponible temporalmente. Completa los pasos que se indican en el apartado No se ha podido asociar un nodo. A continuación, vuelve a hacer el análisis o una migración delta.
Opción 3: Comprobar el registro de ejecución de particiones
Si el problema afecta a varios nodos, puedes examinar el registro de ejecución de particiones. Para ver el registro de ejecución asociado a una partición, sigue estos pasos:
- Abre el registro de la partición.
- Coloca el cursor sobre una fila del registro y haz clic en More (Más)
- Haz clic en State (Estado)
- Revisa los fallos para identificar y solucionar la causa del problema.
- Vuelve a hacer el análisis o la migración.
Si se produce un aumento de errores similares en el resumen de la migración, es probable que la configuración de la migración no sea correcta.
Comprueba si se han configurado correctamente los siguientes elementos de la configuración:
- Asegúrate de que las APIs, en particular el SDK de administrador, estén habilitadas correctamente en la consola de administración de Google. Para obtener información detallada, consulta el apartado Activa las APIs mediante la Consola de Google Cloud.
- Asegúrate de que la cuenta de usuario existe en la cuenta de origen y en Google Workspace Migrate. Verifica que la cuenta no se ha congelado, suspendido o cambiado de nombre.
- Verifica que todos los usuarios tengan activados los servicios de Google Workspace Migrate necesarios (por ejemplo, Gmail o Google Drive). Para obtener información detallada, consulta el apartado Requisitos de Google Workspace.
Si aparece este error en los registros del host, es posible que tengas que permitir el uso de aplicaciones de terceros con archivos de Drive.
Para solucionar el problema, sigue los pasos que se indican en el apartado Permitir que los usuarios utilicen aplicaciones de terceros con archivos almacenados en Drive.
Corregir errores de puente
Abrir sección | Ocultar todo y volver al principio
Ejecutar un puente como una migración deltaA menudo, se pueden corregir muchos errores ejecutando una migración delta. Una migración delta identifica los errores persistentes y elimina los problemas temporales, como los límites de frecuencia y los niveles de cuota, los problemas de red y los errores 401. Puedes ejecutar una migración delta varias veces para solucionar problemas. Para obtener información detallada, consulta el artículo Preparar la activación.
| Error 60008 o palabra clave | Pasos para solucionarlo |
|---|---|
| No mapping found (No se ha encontrado ninguna mapeado). | Es posible que veas este error si migras datos de una unidad compartida de una cuenta de Google Workspace Migrate a otra y has creado las unidades compartidas manualmente en la nueva cuenta. Para solucionar el problema:
|
| Transaction that the affected item depended on failed (No se ha completado la transacción de la que dependía el elemento). | Examina otros elementos que han dado error en el mismo puente y soluciona esos problemas. Cuando soluciones los problemas, ejecuta un puente delta. |
|
Parent object failed to migrate (No se ha podido migrar el objeto principal). Es posible que también aparezca el mensaje "The bridge execution was halted or completed prior to dependency of the transaction being completed" (La ejecución del puente se ha detenido o ha finalizado antes de que la transacción se haya completado). |
No se ha podido migrar el objeto principal del elemento afectado o el objeto secundario se ha migrado antes que el principal. Para solucionar el problema, haz lo siguiente:
|
| Target parent entities removed, renamed, or moved to another location after a migration (Se han quitado entidades superiores de destino, se les ha cambiado el nombre o se han movido a otra ubicación después de una migración). When another bridge attempted to migrate the source parent or child entities again, they couldn't be found (Cuando otro puente intentó migrar de nuevo las entidades principales o secundarias de origen, no las encontró). |
|
| Source-to-target mapping pair isn't supported (No se admite el mapeado de origen a destino). | Revisa tus mapeados para asegurarte de que las ubicaciones de origen y de destino sean válidas. Para obtener información detallada, consulta cómo crear y gestionar mapeados de Exchange, SharePoint, sistemas de archivos compartidos, Box o Google Workspace Migrate . |
| LocationNotFound | No se ha podido migrar una unidad compartida de Google Workspace a una unidad compartida de la cuenta de destino porque el usuario de destino no tiene una licencia de Google Workspace que incluya unidades compartidas. Comprueba las licencias de tu cuenta de destino y vuelve a intentarlo. |
| OrphanedContent |
Este error también puede aparecer si no se especifica el propietario del elemento huérfano como cuenta de origen del mapeado. Google Workspace Migrate no migrará el elemento y mostrará el código de error 60008. El error es inevitable en esta situación. Nota: Es probable que los archivos huérfanos que se encuentren en una ubicación objetivo diferente se deban a otro problema. Por ejemplo, si no se especifica ninguna carpeta de destino en el mapeado de elementos huérfanos y estos se colocan en la carpeta raíz Mi unidad del usuario objetivo. |
| No mapping found for user (No se ha encontrado ningún mapeado para el usuario) |
|
Si no se pueden migrar archivos y aparece este error:
- Abre el registro de transacción.
- En Error Code (Código de error), busca 1029 para determinar si no se ha podido migrar la carpeta superior.
- Si la carpeta principal no se ha migrado, comprueba el código de error y soluciona el problema.
- Ejecutar un puente delta.
Si vas a migrar archivos de una unidad compartida a otra, asegúrate de usar un mapeado de identidades que asigne fuentes a usuarios de destino en el puente.
- En la plataforma Google Workspace Migrate, haz clic en Scans (Análisis) o en Bridge (Puente).
- En el análisis o puente que quieras comprobar, haz clic en Logs (Registros)
- Coloca el cursor sobre la transacción en cuestión y haz clic en More (Más)
- En la tabla puedes encontrar errores de transacción habituales y pasos para solucionar problemas.
| Código y mensaje de error | Pasos para solucionarlo |
|---|---|
| El estado de la transacción es Failed (Fallido). | Localiza la transacción y soluciona los problemas con la información de sus detalles. |
| Mensaje de error: The request type does not allow write operations (El tipo de solicitud no permite hacer operaciones de escritura).
Código de error: 1048640 |
El controlador de solicitudes del tipo de objeto no puede escribir el objeto en la cuenta de destino (por ejemplo, el elemento de origen no tiene un tipo equivalente en Google Workspace).
Comprueba si el mapeado de ubicación está configurado correctamente y si los mapeados son lógicos. |
| Mensaje de error: An internal connector error occurred (Se ha producido un error interno del conector).
Código de error: 2097125 |
Consulta los mensajes de error en los registros de transacciones y ejecuciones. Si el mensaje de error no es de ayuda, consulta los registros del host de servicio de la plataforma o del nodo para obtener información detallada. |
| La ejecución del puente se ha detenido o completado antes de que la dependencia de la transacción se completara. | El elemento no se ha transferido porque dependía de otro elemento que se estaba migrando en primer lugar, pero no se migró correctamente. Por ejemplo, un archivo de una carpeta no se ha migrado porque la carpeta no se ha creado en Drive.
En el error, busca ABHierarchicalPath.Path y anota el elemento asociado. A continuación, busca el elemento en los registros de transacciones para averiguar por qué no se ha podido migrar. |
Puede que se omita una transacción de tu registro de transacciones por los siguientes motivos:
- Estás haciendo una migración delta, pero el objeto no ha cambiado desde la migración anterior.
- El objeto se ha excluido mediante una condición de filtro en la plantilla de configuración.
- Estás migrando contenido de correo a un grupo y se omiten los archivos adjuntos de gran tamaño.
- Estás usando una plantilla de configuración de una unidad compartida, pero estás migrando contenido a Mi unidad.
En función del origen de la migración, otros motivos por los que se puede omitir un elemento son los siguientes:
- SharePoint se omite una carpeta porque no forma parte de una biblioteca de documentos.
- Exchange: los borradores de correo se omiten cuando se migran a Grupos de Google.
- Box: se omite una revisión de un archivo porque la revisión está vacía.
- Sistemas de archivos compartidos: se omite un elemento porque los nodos no tienen suficientes permisos para acceder a él.
- Gmail: se omiten los mensajes de Chat (elementos de la etiqueta Chat).
Al migrar entre unidades compartidas con la plantilla de configuración Predeterminada, GWM creará la nueva unidad compartida en la cuenta de destino, pero es posible que no migre los datos de la unidad compartida de origen. Esto se debe a lo siguiente:
- No hay ningún mapeado de identidades para el origen y el destino.
- La opción Permitir usuarios sin mapear de la plantilla no está marcada.
Hay dos formas de corregir este problema:
- Crea una plantilla personalizada a partir de la plantilla de configuración Predeterminada y marca la casilla Permitir usuarios sin mapear.
- Añadir un mapeado de identidades.
Es posible que el informe de transacciones sea demasiado grande para descargarlo. Prueba estas opciones para solucionar el problema:
Opción 1: Añadir filtros antes de migrar
Para reducir el tamaño del informe, filtra el registro de transacciones para buscar datos específicos, como el estado de finalización o el código de error. Consulta información detallada en el artículo Supervisar el desarrollo de una migración.
Opción 2: Descargar el registro con filtros
Puedes usar la línea de comandos para especificar cómo descargar el registro de transacciones:
- Para reducir el número de elementos del registro, usa la opción transactionState.
- Para aumentar el tiempo que puede tardar en descargarse el registro, usa la opción queryTimeout.
Para obtener más información, consulta el artículo Descargar los registros con la línea de comandos.
Si las migraciones son más lentas de lo esperado, comprueba que cumples los siguientes requisitos del sistema.
Niveles de cuota de las APIs de Google
La configuración de tus cuotas puede provocar códigos de error, como el 403 (Error prohibido), el 429 (Demasiadas solicitudes) o el 503 (Servicio no disponible). Para comprobar si los niveles de cuota están afectando a la velocidad de migración, sigue estos pasos:
- Consulta las cuotas en la consola de Google Cloud. Para ver los pasos, consulta Ver cuotas en la consola de Google Cloud.
- Ajusta las cuotas para que se adapten al uso de tus recursos. Para ver los pasos, consulta Gestionar las cuotas con la consola.
Configuración de limitación del lado del cliente
Los ajustes de limitación controlan la frecuencia con la que los clientes pueden enviar solicitudes a los servicios de Google. A veces, la configuración provoca códigos de error, como el error 403 (Prohibido), el 429 (Demasiadas solicitudes) o el 503 (Servicio no disponible).
Estos códigos de error pueden deberse a que las tasas de limitación son demasiado altas en Google Workspace Migrate (GWM). Si la limitación del lado del cliente es alta y no hay una limitación significativa del lado del servidor, puede ser útil ajustar la configuración del relleno en GWM.
Antes de empezar
- Solo los administradores con experiencia deberían intentar hacer estos cambios, ya que las actualizaciones pueden tener consecuencias no deseadas.
- En los siguientes pasos se define la estrategia de limitación de Google, pero también es posible que tengas que usar otras fuentes de datos, como googleThrottlingStrategy, exchangeThrottlingStrategy y sharepointThrottlingStrategy.
Para anular las estrategias de limitación predeterminadas en las versiones 2.1.54.0 y posteriores de GWM, sigue estos pasos:
- En el servidor de la plataforma, crea el directorio C:\ProgramData\AppBridge\Overrides.
- Añade un archivo JSON llamado throttling_settings.json.
- Con el Bloc de notas, añade el siguiente texto al archivo JSON:
{
"googleThrottlingStrategy": {
"throttlingModel": "ADAPTIVE_THROTTLING",
"adaptiveThrottlePadding": 32,
"adaptiveThrottleAcceptanceRatio": 1.1,
"adaptiveThrottleIntervalMs": 60000
}
} - Guarda el archivo JSON.
- En la bandeja del sistema de Windows, haz clic en
.
- Detén el servicio de GWM y vuelve a iniciarlo.
Restricciones del cortafuegos
Para reducir las interferencias con las operaciones de disco y de red, desinstala el software antivirus, los escáneres de seguridad y otro software no esencial de los servidores de Workspace.
Google Workspace Migrate usa MySQL para almacenar los ajustes de configuración y los detalles de los registros. Si tu conexión MySQL es intermitente o no responde, ve a Comprobar los registros del host de servicio y sigue los pasos para una instalación de plataforma.
Si ves errores de MySQL en AppBridgeServiceHost.log:
- Consulta el artículo Solucionar problemas de MySQL.
- Si sigues necesitando ayuda, consulta el artículo Contactar con el servicio de asistencia para resolver problemas con Google Workspace Migrate.
¿Necesitas ayuda?
Consulta el artículo Contactar con el servicio de asistencia para resolver problemas con Google Workspace Migrate.
Google, Google Workspace, así como las marcas y los logotipos relacionados, son marcas de Google LLC. Todos los demás nombres de empresas y productos son marcas de las empresas con las que están asociadas.