Solucionar problemas con la migración de identidades
No se puede restaurar la copia de seguridad
Después de actualizar a Tableau Server 2022.1 (o versiones posteriores), restaurar una copia de seguridad de Tableau Server puede generar el siguiente error:
"La copia de seguridad no se puede restaurar porque Tableau Server usa las nuevas tablas del servicio de identidad de forma predeterminada".
Este problema puede producirse cuando Tableau Server necesita ejecutar la migración de identidades, que es un proceso necesario para rellenar el servicio de identidad. El servicio de identidad es un esquema de identidades que se introdujo a partir de Tableau Server 2022.1 y que se utiliza para aprovisionar y autenticar usuarios. Para evitar posibles problemas, el proceso de restauración no puede continuar cuando Tableau Server detecta que la copia de seguridad de Tableau Server usa un esquema de identidades diferente al de la versión que se está restaurando.
Nota: El servicio de identidad es el esquema de identidades predeterminado en las versiones 2022.1-2022.1.7, 2022.3-2022.3.9 y 2023.1-2023.15 de Tableau Server.
Para resolver este problema, realice los siguientes pasos.
Paso 1: Habilitar legacy-identity-mode y restaurar la copia de seguridad
- Abra un símbolo del sistema como administrador en el nodo inicial (nodo en el que esté instalado TSM).
Configure Tableau Server 2022.1 (o versiones posteriores) para usar el modo de almacenamiento de identidades heredado al ejecutar los siguientes comandos:
tsm authentication legacy-identity-mode enabletsm pending-changes applyTableau Server debe usar el modo de almacenamiento de identidades heredado para completar el servicio de identidad. Para obtener más información sobre el comando TSM, consulte
tsm authentication legacy-identity-mode.Restaure la copia de seguridad nuevamente para permitir que la migración se inicie al ejecutar los siguientes comandos:
tsm maintenance restore --file <file_name>tsm startImportante: después de restaurar la copia de seguridad, la migración completa el servicio de identidad con información de identidades. Para obtener información general acerca de cómo restaurar una copia de seguridad, consulte Restaurar a partir de una copia de seguridad.
Paso 2: Validar y completar la migración de identidades
- Inicie sesión en Tableau Server como administrador.
En el panel de navegación izquierdo, seleccione Usuarios (o Todos los sitios > Usuarios para un Tableau Server de varios sitios) y luego haga clic en la página Migración de identidad para verificar que la migración haya comenzado.
Puede supervisar y administrar su progreso mediante la página de migración de identidad dedicada disponible en la página de usuarios de Tableau Server. Para obtener más información, consulte Administrar la migración de identidades.
Resuelva o reconozca todos los conflictos de identidad como se describe en Resolver conflictos de migración de identidades para que la pestaña Todos los errores muestre "0" como en la imagen a continuación.
Aplique una de las siguientes opciones:
Para ejecutar el trabajo de migración de identidad ahora, junto al encabezado Descripción general de la migración, haga clic en la flecha desplegable Editar programa y luego seleccione Ejecutar ahora.
- Como alternativa, puede esperar a que se ejecute el trabajo de migración durante la próxima hora programada.
Una vez completada la migración, desde la página Migración de identidad, valide que la Descripción general de la migración muestre 100 % completa.
Paso 3: Configurar Tableau Server para usar el servicio de identidad
- Abra un símbolo del sistema como administrador en el nodo inicial (nodo en el que esté instalado TSM).
Ejecute los comandos siguientes:
tsm authentication legacy-identity-mode disabletsm pending-changes applyNota: Después de ejecutar los comandos anteriores, la página Migración de identidad dedicada se elimina y ya no se puede acceder a ella. Se puede acceder a la página solo cuando
tsm authentication legacy-identity-modeestá habilitado.
Una vez que Tableau Server está configurado para usar el servicio de identidad, cuando los usuarios inician sesión en Tableau Server, Tableau Server busca sus identidades de usuario usando sus identificadores en el almacén de identidades configurado. A partir de los identificadores, se devuelven los identificadores únicos universales (UUID) y se usan para hacer coincidir las identidades de usuario existentes de Tableau Server. Este proceso luego genera sesiones para los usuarios y completa el flujo de trabajo de autenticación.
"Error inesperado" en la página Migración de identidades
Después de resolver o reconocer todas las identidades de usuario de la página Migración de identidades, verá un mensaje de "Error inesperado". Este mensaje puede mostrarse cuando ha intentado resolver o confirmar más de 1000 identidades de usuario a la vez.
Para resolver este problema, seleccione y resuelva o confirme 1000 o menos identidades de usuario y vuelva a intentarlo.
Para obtener más información sobre la administración de conflictos de identidades, consulte Resolver conflictos de migración de identidades.
El progreso de la migración parece no responder o está atascado
Si el estado de la migración o la barra de progreso de la migración no responden o están atascados, confirme que ha resuelto y reconocido todos los conflictos de usuario en Errores de migración.
Para resolver este problema, asegúrese de que todos los conflictos se resuelvan y reconozcan seleccionando una o más identidades de usuarios en la pestaña Todos los errores y haciendo clic en Reconocer en el menú desplegable Acciones. Realice esta tarea hasta que la pestaña Todos los errores muestre "0". Para obtener más información sobre la administración de conflictos de identidades, consulte Resolver conflictos de migración de identidades.
Nota: Una vez resueltos o atendidos todos los conflictos de identidad, los trabajos de migración deben ejecutarse antes de que pueda habilitar el servicio de identidad para Tableau Server. Puede ejecutar los trabajos de migración ahora haciendo clic en la flecha desplegable Editar programación junto al encabezado Descripción general de la migración y luego seleccionando Ejecutar ahora. Cuando la descripción general de la migración muestre 100 % completa, puede configurar Tableau Server para usar el servicio de identidad. Para obtener más información, consulte Paso 3: Completar la migración de identidades.
La ventana emergente “Migración de identidades en progreso” persiste
La notificación “Migración de identidades en progreso” persiste a pesar de completar la migración de identidades porque el servicio de identidad todavía no se ha habilitado. Para completar la migración de identidades, el servicio de identidad debe estar habilitado en Paso 4: Configurar Tableau Server para usar el servicio de identidad para que Tableau Server pueda utilizar la estructura de identidad que habilita la capacidad de grupos de identidades.
Desaparece la página de migración de identidad
Cuando se completa la migración de identidad y Tableau Server está configurado para usar el servicio de identidad, la página de migración de identidad dedicada se elimina y ya no se puede acceder a ella. La página Migración de identidades es necesaria solo para la migración de identidades o cuando tsm authentication legacy-identity-mode está habilitado.
Los usuarios no pueden iniciar sesión
Una vez completada la migración de identidades y habilitado el servicio de identidad, algunos usuarios no pueden iniciar sesión en Tableau Server. En la mayoría de los casos, este problema les sucede a usuarios cuyas identidades tuvieron conflictos y posteriormente fueron Confirmadas durante la migración de identidades. Las identidades de los usuarios que se confirmaron no se migran al servicio de identidad y posteriormente se ignoran durante las sincronizaciones de grupos de Active Directory (AD) o LDAP en el futuro.
Si los usuarios asociados con esas identidades de usuario confirmadas requieren acceso a Tableau Server de nuevo, agregue manualmente los usuarios a Tableau Server. Una vez que los usuarios se agregan manualmente, las sincronizaciones posteriores de grupos de AD o LDAP reconocen las identidades de los usuarios y se sincronizan como se esperaba.
Revertir la migración de identidades
Si hay problemas que usted crea que los causa el servicio de identidad, como que ciertos usuarios no puedan iniciar sesión en Tableau Server, puede usar el comando tsm authentication legacy-identity-mode para volver a usar el modo de almacenamiento de identidades heredado. Después de la reversión, tanto los nuevos usuarios que se agregaron después de la migración de identidades como los usuarios que solo podían iniciar sesión en Tableau Server antes de la migración pueden iniciar sesión en Tableau Server sin ningún problema.
Después de revertir el servicio de identidad al modo de almacenamiento de identidades heredado, puede usar la página Migración de identidades para ejecutar la migración de las identidades de usuario problemáticas. Para obtener más información sobre la administración de conflictos de identidades, consulte Resolver conflictos de migración de identidades.