Solución de problemas de migraciones de archivos de Migration Manager
En este artículo se describe cómo resolver problemas y errores que puede experimentar al usar El Administrador de migración para la migración de recursos compartidos de archivos.
- Requisitos previos y configuración
- Mensajes de error del agente
- Problemas con la dirección URL del sitio de destino
- Mensajes de error comunes
- Error de instalación del agente
- El agente se desconectó
- La tarea está atascada en estado "en cola"
- El informe de tareas no se puede descargar
- Errores de migración en informes de tareas
- Los informes de errores de migración de Google contienen HTML
- Códigos de error
- Los administradores de ubicación geográfica no pueden acceder a la funcionalidad completa del Administrador de migración
- Los administradores de grupos heredados de SharePoint no pueden acceder a la funcionalidad completa del Administrador de migración
- La colección de sitios "XXXX" no se puede crear ni actualizar
- Tarea de examen bloqueada en estado "en cola"
Compruebe los requisitos previos y la configuración
Asegúrese de que cumple los requisitos previos para la instalación del agente y de que ha revisado los puntos de conexión necesarios. Los clientes de la nube de administración pública deberían confirmar que establecieron la configuración correctamente.
Aprovisionamiento previo de cuentas de OneDrive Si va a migrar a cuentas de OneDrive, asegúrese de que las cuentas se aprovisionan previamente antes de migrar. Para hacerlo, puede usar un script (como se muestra aquí): aprovisionar previamente OneDrive para los usuarios de su organización.
Mensajes de error del agente
Message | Acción |
---|---|
No se pudo instalar el agente de migración. Cierre el programa de instalación e inténtelo de nuevo. | Es posible que esté usando una versión no actualizada del archivo de configuración del agente para instalar el agente. Consulte Error de instalación del agente a continuación para obtener más información. |
El usuario actual no tiene acceso al recurso compartido de archivos de origen | Asegúrese de que el recurso compartido de archivos de origen sea un recurso compartido de archivos de red. Verifique que la cuenta de Windows asociada al agente tiene permisos de lectura en el recurso compartido de archivos que desea migrar. |
El recurso compartido de archivos de origen no existe | Asegúrese de que el recurso compartido de archivos de origen sea un recurso compartido de archivos de red existente. Confirme que la cuenta de Windows asociada al agente tiene permisos de lectura en el recurso compartido de archivos que desea migrar. |
Problemas con la dirección URL del sitio de destino
Message | Acción recomendada |
---|---|
Sitio de destino o web no existe | Confirme que el sitio de destino o el subsitio existe. Si tiene una cuenta de OneDrive, asegúrese de que se ha aprovisionado previamente. |
No se pudo comprobar la existencia del sitio o web. | Confirme que el sitio de destino o el subsitio existe. |
Mensajes de error frecuentes
Message | Acción recomendada |
---|---|
Carpeta de origen no válida | Confirme que la ruta de acceso especificada es correcta y sigue el formato correcto Confirme que tiene acceso de lectura a la carpeta. |
El sitio no se puede crear ni actualizar | Asegúrese de que tiene permisos para crear el sitio y de que la dirección URL es válida Si el sitio existe, confirme que es el administrador de la colección de sitios Si todavía se produce un error, cree el sitio manualmente y apunte la herramienta de migración a este sitio recién creado. |
Error al examinar el archivo: el nombre de la carpeta no es válido | Vea Nombres o tipos de archivos no válidos en OneDrive y SharePoint |
Error al examinar el archivo: la ruta de acceso de destino es demasiado larga | Vea Nombres de archivo y tipos de archivo no válidos en OneDrive y SharePoint La ruta de acceso completa, incluido el nombre de archivo, debe contener menos de 400 caracteres para OneDrive y SharePoint. |
Error al examinar el archivo: no hay suficiente espacio en disco para empaquetar el archivo | El espacio en disco disponible para la carpeta de trabajo de migración es demasiado pequeño para el tamaño de su archivo de origen. Aumente el tamaño de la carpeta de trabajo y vuelva a intentarlo. |
Error de empaquetado: no se puede abrir el archivo | Error de empaquetado debido a un origen no existente. Compruebe si puede tener acceso a la carpeta raíz de origen. |
Una tarea duplicada ya se ha creado. | El archivo CSV usado para realizar la migración masiva no puede tener entradas duplicadas. Retire la(s) línea(s) duplicada(s) y vuelva a intentarlo. |
No se migró la carpeta primaria | No se migró la carpeta primaria, por lo que no se pueden migrar todos los elementos de la carpeta. Compruebe la carpeta principal y vuelva a intentar la migración. |
Error de instalación del agente
Problema: El agente de migración no se puede instalar al usar una versión anterior del archivo de configuración del agente para instalarlo.
Diagnóstico o investigación:
El problema puede deberse a un archivo clientsetup.exe desactualizado.
Mitigación:
- Vaya al Centro de migración en el Centro de administración de SharePoint e inicie sesión con una cuenta que tenga permisos de administrador para su organización.
- Seleccione Descargue el archivo de configuración del agente.
- Ejecute el archivo clientsetup.exe en el equipo o máquina virtual donde quiera instalar el agente. Siga las instrucciones para finalizar la instalación del agente.
Emitir: El agente de migración no se instala correctamente o el clientsetup.exe no se puede abrir.
Ejemplo:
Diagnóstico o investigación:
Si no se puede abrir el clientsetup.exe :
- Inicie sesión en Windows como administrador o proporcione el nombre de usuario y la contraseña del administrador cuando abra la aplicación. La cuenta de administrador debería haberse agregado al dominio.
Si se han producido errores durante el proceso de instalación:
- El mensaje de error debería incluir el motivo del error y las acciones adecuadas que deben realizarse si es posible.
- Si los errores no sugieren acciones para resolver, el problema podría deberse a un error de red temporal u otros problemas desconocidos.
Mitigación:
Si no se puede abrir el clientsetup.exe:
- Inicie sesión en Windows como administrador.
- Vuelva a abrir la aplicación clientsetup.exe o proporcione el nombre de usuario y la contraseña del administrador cuando abra la aplicación.
Si se han producido errores durante el proceso de instalación:
- En caso de errores con acciones específicas indicadas, lleve a cabo la acción correspondiente y vuelva a abrir el archivo clientsetup.exe.
- Para otros errores no específicos, asegúrese de que la cuenta de administrador se ha agregado al dominio. Cierre la ventana de la aplicación y vuelva a intentar la instalación.
El agente se desconectó
Problema: El "estado" del agente se atasca como "Desconectado" y nunca vuelve.
Diagnóstico o investigación:
- Compruebe el estado de la red en el equipo en el que está instalado el agente.
- Si ha cambiado la contraseña de la cuenta de administrador del espacio empresarial que ha iniciado sesión o se han aplicado otros cambios críticos similares a la cuenta de administrador del espacio empresarial que requerirían el inicio de sesión, todos los agentes se desconectarán y se necesitará la reinstalación en todos ellos.
- Si el agente no pudo actualizarse automáticamente, es probable que la versión sea demasiado antigua. Vuelva a instalar el agente.
- La expiración del token también puede causar la desconexión del agente.
Mitigación:
- Si hay un problema de red, corríjalo. El agente debería reconectarse poco después.
- Si hay cambios críticos en la cuenta de administrador del espacio empresarial que requieren que se vuelva a iniciar sesión: vuelva a instalar el agente en todos los equipos.
- Si no se aplica ninguna de estas condiciones, empiece por volver a instalar el agente primero.
La tarea está atascada en estado En cola
Problema El estado de una tarea se queda en "En cola" y no se programa para ejecutarse en un agente.
Diagnóstico o investigación:
- Asegúrese de que hay agentes instalados para este espacio empresarial. Deberían aparecer en la lista de agentes.
- Compruebe el estado de cada agente. Deberían establecerse en "Habilitado".
- Un estado de "En uso" indica que el agente ya está procesando otra tarea. El agente no podrá tener asignadas más tareas sin finalizar la actual.
- Si un agente se muestra como "Deshabilitado", habilítelo.
- Si aparece como "Desconectado" durante mucho tiempo, marque la casilla de verificación Agente desconectado.
Mitigación:
- Si hay disponibles agentes habilitados en la lista, pero las tareas no se han programado durante mucho tiempo: cree otra tarea que sea la misma. A veces se corrige el problema.
No se puede descargar el informe de tareas
Problema: el informe de tareas no se puede descargar desde el vínculo del panel de detalles de la tarea.
- El vínculo Descargar informe de tarea está deshabilitado.
- El vínculo Descargar informe de tarea se muestra activo, pero no sucede nada después de hacer clic en él.
Diagnóstico o investigación:
- El vínculo "Descargar informe de tarea" se deshabilita hasta que finalice la tarea. Los informes solo están disponibles una vez que el estado de la tarea ha pasado a "Completado" o "Error". Las tareas en las que se produjo un error debido al tiempo de espera también tendrán un vínculo de informe de tareas deshabilitado.
- Si no se pueden descargar informes para tareas finalizadas, que no han agotado el tiempo de espera, es probable que se hayan producido errores durante el proceso de migración que interrumpieron la carga de los informes en SharePoint. Sin embargo, se pueden encontrar localmente siempre y cuando existan.
Mitigación:
En el equipo que ha completado la tarea, pruebe a recuperar los informes.
- En la carpeta %AppData%\Microsoft\SPMigration\Logs\Migration\MigrationTool[tenant_site], o < your-Customized-Working-Folder >\Migration\MigrationTool[tenant_site], ordene las subcarpetas por su hora de modificación. Busque la subcarpeta cuya hora modificada sea la más cercana a la hora de inicio de la tarea. Si los informes de tareas existen, estarán en la carpeta "Informe" de esta subcarpeta.
O bien
- Si se produce un error en la tarea, vaya a la carpeta %AppData%\Microsoft\SPMigration\Logs y ordene las subcarpetas por la hora de modificación. Busque la subcarpeta cuya hora modificada sea la más cercana a la hora de inicio de la tarea. El informe de errores está en esta subcarpeta.
Errores de migración en informes de tareas
Problema: Se produce un error en las tareas de migración por varias razones y se detallan en los informes de tareas.
Diagnóstico o investigación:
Las razones por las que se ha podido producir un error deberían estar ya escritas en detalle en los informes, junto con soluciones sugeridas.
Si no puede descargar los informes de tareas, consulte Informe de tareas no se puede descargar.
Mitigación:
Busque el error específico aquí para obtener más información: Códigos de error.
Si recibe un error similar al siguiente: SUBMITING FAILURE Failed to Submit the Job to Server: Unknown failed reason when submiting a job. 0x01610002
Compruebe la configuración de cualquier aplicación antivirus que esté instalada en el equipo del agente. Agregue estas dos aplicaciones de migración como excepciones para que no se interrumpa el tráfico de migración:
- microsoft.sharepoint.migration.clientservice.exe
- microsoft.sharepoint.migration.mthost.exe
El informe de errores de Google muestra código HTML en el informe
Problema: Los informes de errores generados para una migración de Google a veces tienen código HTML incrustado en el informe.
Detalles:
Las API de Google devuelven errores HTML que se incluyen en los informes generados. Esto puede ocurrir cuando hay un error de carga del servidor de Google.
Mitigación:
Ejecute menos transacciones simultáneas.
Estado:
Este es un problema conocido. Tiempo estimado no establecido.
No se admiten administradores de ubicación geográfica
El Administrador de migración no admite el rol de administrador de ubicación geográfica para ciertos escenarios. En el caso de las migraciones de recursos compartidos de archivos, estos usuarios no pueden acceder a la pestaña exámenes. En el caso de las migraciones en la nube, los usuarios no pueden tener acceso ni a los exámenes ni a la pestaña migraciones.
Solución alternativa. Asigne al usuario de ubicación geográfica un rol de administrador de SharePoint o de administrador global.
- En el Centro de administración, vaya a la página Usuarios>Usuarios activos.
- En la página Usuarios activos, seleccione el usuario cuyo rol de administrador desea cambiar. En el panel desplegable, en Roles, seleccione Administrar roles.
- Seleccione el rol de administrador que quiere asignar al usuario. Si no ve el rol que está buscando, seleccione Mostrar todo en la parte inferior de la lista.
Los administradores de grupos heredados de SharePoint no pueden acceder a las pestañas de exámenes y migraciones
Los roles de administrador de SharePoint creados como resultado de unirse a un grupo de Azure no son totalmente compatibles con el Administrador de migración. En el caso de las migraciones de recursos compartidos de archivos, estos usuarios no pueden acceder a la pestaña exámenes. En el caso de las migraciones en la nube, los usuarios no pueden tener acceso ni a los exámenes ni a la pestaña migraciones.
Solución alternativa. Hasta que esto se resuelva, asigne al usuario un rol de administrador de SharePoint o un rol de administrador global.
- En el Centro de administración, vaya a la página Usuarios>Usuarios activos.
- En la página Usuarios activos, seleccione el usuario cuyo rol de administrador desea cambiar. En el panel desplegable, en Roles, seleccione Administrar roles.
- Seleccione el rol de administrador que quiere asignar al usuario. Si no ve el rol que está buscando, seleccione Mostrar todo en la parte inferior de la lista.
La colección de sitios "XXXX" no se puede crear ni actualizar
El nombre principal de usuario (UPN) al que se hace referencia no es válido. Para crear o actualizar una colección de sitios de OneDrive, microsoft Entra ID debe contener el UPN al que se hace referencia. Compruebe la dirección URL de destino y valide que el usuario existe en Microsoft Entra ID.
Tarea de examen bloqueada en estado "en cola"
Problema: el estado de un examen del recurso compartido de archivos permanece en "En cola" y nunca se programa en que se ejecute un agente.
Diagnóstico/investigación
- Compruebe la columna Grupo del agente para ver las tareas de examen. Solo se pueden programar los agentes del grupo Agente predeterminado .
Mitigación
- Si no hay ningún agente en el grupo Agente predeterminado , cambie el grupo del agente existente a Predeterminado. Las tareas de examen que se han bloqueado ahora deben salir de este estado.
Códigos de error
Código de error | Acción recomendada |
---|---|
0x00000000 | Error inesperado. |
0x01110001 | Motivo desconocido. |
0x0111000B | La ruta de acceso es demasiado larga. |
0x0111000F | No se ha migrado la carpeta primaria. Compruebe el informe de error para determinar el archivo y vuelva a intentarlo. |
0x01110003 | No se puede acceder a la carpeta de origen. |
0x01110009 | No se pueden recuperar los metadatos del archivo. |
0x01110010 | Caracteres no válidos en el nombre de archivo Compruebe los nombres de archivos del informe con <>:"?*/, |
0x01110011 | No se admite el elemento "tiempo de creación" o "tiempo de modificación". |
0x0201000D | Compruebe si existe la lista o si puede acceder a ella en el sitio de origen y el sitio de destino. |
0x02050008 | No se puede acceder al almacenamiento local. Reinicie la migración. |
0x02010023 | No se admite la plantilla de lista de origen. Pruebe con otro. |
0x0201000C | Compruebe sus credenciales y, a continuación, vuelva a escribir su nombre de usuario y contraseña. |
0x02010017 | Debe ser administrador de la colección de sitios. |
0x02060009 | 1- No se puede crear la colección de sitios porque la dirección URL ya está en uso o una dirección URL no válida. |
2- No se puede crear la colección de sitios porque la dirección URL contiene un carácter no válido. | |
3- La colección de sitios no se puede crear ni actualizar. | |
0x02060007 | 1- No se puede crear la colección de sitios porque la dirección URL ya está en uso o una dirección URL no válida. |
2- No se puede crear la colección de sitios porque la dirección URL contiene un carácter no válido. | |
0x02010018 | 1. Compruebe sus credenciales y vuelva a intentarlo. |
2. Se ha producido un error al acceder a SharePoint. Compruebe sus credenciales y vuelva a intentarlo. | |
3. Se ha producido un error de acceso a SharePoint. Compruebe las credenciales y su conexión de red y vuelva a intentarlo. | |
4. Se ha producido un error de acceso a SharePoint. Compruebe las credenciales y la dirección URL del sitio y vuelva a intentarlo. | |
5. Se ha producido un error de acceso a SharePoint. Compruebe sus credenciales y el formato de la dirección URL. Vuelva a intentarlo. | |
6. Se ha producido un error de acceso a SharePoint. Compruebe sus credenciales y vuelva a intentarlo. Si el problema persiste, cree un caso de soporte técnico. | |
7. Se ha producido un error de acceso a SharePoint. Compruebe las credenciales e intente abrir el sitio en un explorador. | |
0x0204000A | No se puede crear el archivo de paquete. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración. |
0x02030001 | 1. Compruebe sus credenciales. Reinicie la migración. |
2. Compruebe sus credenciales. Reinicie la migración. | |
3. Compruebe las credenciales y su conexión de red. Reinicie la migración. | |
4. Compruebe las credenciales y la dirección URL del sitio. Reinicie la migración. | |
5. Compruebe sus credenciales y el formato de la dirección URL. Reinicie la migración. | |
6. Compruebe las credenciales y reinicie la migración. Si el problema persiste, cree un caso de soporte técnico. | |
7. Compruebe las credenciales e intente abrir el sitio en un explorador. Reinicie la migración. | |
0x02010008 | Confirme la ruta y el formato del archivo de asignación de usuarios y que tiene permiso para acceder a él. |
0x02050001 | Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración. |
0x02010002 | Compruebe el estado de la red. Si puede acceder a los sitios de origen desde un explorador, cree un caso de soporte técnico. |
0x02010010 | Asegúrese de que las listas de origen y destino tienen la misma plantilla. |
0x0204000D | Durante la migración, deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración. |
0x02040012 | El almacenamiento temporal en su equipo local es demasiado bajo. El Administrador de migración almacena en caché el paquete en la carpeta de trabajo. Expanda el almacenamiento temporal y vuelva a intentarlo. |
0x02030003 | Hay demasiados elementos con permisos exclusivos. Simplifique la lista de permisos reduciendo el número de permisos exclusivos. Reinicie la migración. |
0x02050001 | El archivo de almacenamiento local está dañado. La carpeta de trabajo se ha modificado o cambiado durante la migración. Vuelva a intentar la migración. |
0x02080001 | El archivo del paquete se ha modificado o eliminado al cargarlo. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración. |
0x02040009 | No se puede crear el paquete porque no se encuentra el directorio. Deben cerrarse todos los archivos y carpetas de la carpeta de trabajo del Administrador de migración, %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. Reinicie la migración. |
0x02010020 | Desactive la migración del historial de versiones en la configuración del Administrador de migración o active la versión en SPO. |
0x0201000E | Compruebe si la configuración global ha filtrado caracteres especiales en la ruta de acceso de destino o si la ruta de acceso contiene caracteres incompatibles. |
0X0201000F | URL del sitio no válida. Compruebe si la URL del sitio es válida. Intente acceder a la URL a través de un navegador. Si se trata de una cuenta de OneDrive, asegúrese de que se ha aprovisionado previamente antes de migrar. |
0x0207001 | No tiene acceso a la carpeta de tareas. Compruebe si puede acceder a %appdata%\Microsoft\SPMigration\Logs\Migration\MigrationToolStorage. |
0x01410010 | Se ha producido un fallo debido a la falta de dependencias en los elementos de la lista. Compruebe los detalles en FailureSummaryReport.csv. Compruebe si las dependencias se han incluido en su ámbito de migración. |
0x01510001 | Los paquetes no se han podido cargar. Si tiene almacenamiento Azure personalizado, compruebe si puede acceder al almacenamiento Azure y compruebe si puede acceder al sitio de destino. Intente migrar de nuevo. |
0x01510001 | No se cargó el trabajo en el servidor: error al cargar el archivo durante la migración. |
0x02070009 | Varios paquetes no se han podido cargar. Detenga la tarea y compruebe la conexión de red. |
0x01710009 | Se ha producido un error debido a fallos al final del trabajo; algunos elementos han fallado en el paquete. Reinicie la migración. |
0x01710009 | Errores o tiempos de espera para que el servidor procese el archivo: no se han migrado todos los elementos del paquete. |
0x01610001 | El contenedor de Azure expiró. Vuelva a intentar la tarea de migración. |
0x01710006 | Errores o tiempo de espera del servidor que procesa el archivo: error grave del trabajo. |
0x01710004 | Errores o tiempo de espera del servidor que procesa el archivo. Error al buscar el nombre de la carpeta. Puede que el elemento exista en otra lista o sitio en la misma colección de sitios. O el elemento está en la papelera de reciclaje |
0x0131000F | No se pudo leer el archivo. El archivo ha sido revisado. |