Ayuda de Tableau Server en Windows

Los registros de instalación se escriben en el directorio \Temp de la cuenta de usuario que ejecuta la configuración. En la mayoría de los casos, se encuentra en C:\Users\<user>\AppData\Local\Temp.

Para determinar dónde está el directorio \Temp para el usuario con la sesión iniciada, ejecute el siguiente comando en el símbolo del sistema de Windows: ECHO %Temp%.

El programa de instalación no solicita la ubicación de la instalación

La primera vez que instale Tableau Server, se le pedirá la ubicación de destino de la instalación. Si no ve este mensaje, puede que tenga archivos o directorios de una instalación anterior que no se eliminaron, incluso si desinstaló Tableau. Para eliminar por completo todos los rastros de Tableau 2018.2 o posteriores, ejecute el script tableau-server-obliterate.cmd, luego reinicie el equipo y vuelva a intentar la instalación. Si había instalada una versión anterior a 2018.2, elimine de forma manual todas las carpetas relacionadas con Tableau antes de volver a ejecutar el programa de instalación.

Importante: Si ha creado una copia de seguridad de Tableau (<file>.tsbak) que desea conservar (por ejemplo, para restablecerla en la nueva instalación), copie ese archivo en una ubicación segura en otro equipo para garantizar que no se elimine cuando limpie el equipo de Tableau.

El programa de instalación no reinicia Windows

Cuando usted instala Tableau Server, el programa de instalación puede pedirle que reinicie Windows al final de la instalación. En algunos casos, al hacer clic en Reiniciar no se reinicia el equipo. Esto puede ocurrir cuando un instalador de componentes externo solicita un reinicio de Windows.

Si al hacer clic en Reiniciar no se reinicia Windows, complete la instalación reiniciando manualmente Windows.

La instalación de TSM falla con el error “initialization failed”

Si intenta instalar Tableau Server y la instalación falla con este error:

Tableau server initialization failed
See install log at C:\ProgramData\Tableau\Tableau Server\logs

Este problema puede estar relacionado con los permisos de su equipo. El usuario que ha iniciado sesión en Windows y está instalando Tableau debe tener permisos de administrador en la unidad C, en las carpetas C:\Windows y C:\Windows\System32 y en el archivo cmd.exe. Esto debe cumplirse aunque no esté instalando Tableau en la unidad C.

Para obtener más información, consulte la Base de conocimientos de Tableau(El enlace se abre en una ventana nueva).

No se muestra la pantalla Inicializar TSM

Al instalar o actualizar Tableau Server, si el navegador se abre, pero no aparece nada, podría tener que añadir el nombre de host a la lista de sitios de confianza. También puede borrar la memoria caché del navegador o utilizar un navegador diferente. Para obtener más información, consulte la base de conocimientos de Tableau Server(El enlace se abre en una ventana nueva).

Varios intentos de instalación producen errores

Si intenta instalar Tableau Server y se producen errores, es probable que los siguientes intentos de instalación también produzcan errores, excepto si ejecuta el script tableau-server-obliterate.cmd para eliminar Tableau completamente del equipo.

Importante: Debe ejecutar el script tableau-server-obliterate.cmd desde una línea de comandos de 64 bits. Por ejemplo, ejecute cmd.exe en la carpeta C:\Windows\System32. Si ejecuta el script desde una línea de comandos de 32 bits, el script no eliminará Tableau completamente, y las instalaciones posteriores pueden fallar. Para determinar si está ejecutando una línea de comandos de 64 bits, escriba echo %processor_architecture% en su ventana de comandos. Si el resultado incluye “64” (por ejemplo, AMD64), la línea de comandos es del sistema de 64 bits. Si el resultado incluye “x86” se está ejecutando una línea de 32 bits. Para obtener más información, consulte la documentación de Microsoft apropiada para sus versiones de Windows.

Un intento de instalación con errores puede dejar el equipo en un estado en el que los intentos posteriores también produzcan errores que no parezcan estar relacionados directamente con un intento de instalación anterior.

Para solucionar este problema, ejecute el script tableau-server-obliterate.cmd para eliminar los elementos que permanezcan del intento de instalación anterior y luego reinicie el equipo. Para obtener más información, consulte Ejecutar el script Ejecutar el script tableau-server-obliterate.

Importante: Si ha creado una copia de seguridad de Tableau (<file>.tsbak) que desea conservar (por ejemplo, para restablecerla en la nueva instalación), copie ese archivo en una ubicación segura en otro equipo para garantizar que no se elimine cuando limpie el equipo de Tableau.

El script obliterate genera el error: "refresh-environment-variables.cmd" no se reconoce como un comando externo o interno

Si usa el Panel de control para desinstalar Tableau Server y, después, ejecuta el script tableau-server-obliterate.cmd para eliminar por completo Tableau de su equipo, el script podría generar un error sobre refresh-environment-variables. Eso sucede porque no se movió al directorio temporal un segundo script que invoca el script obliterate. Puede ignorar este error.

Errores de instalación debido a los requisitos de hardware

Tableau Server no se puede instalar si el equipo en el que se lleva a cabo la instalación no cumple los requisitos mínimos de hardware. Los requisitos se aplican a todos los equipos en los que esté instalando Tableau Server. Para obtener información detallada sobre los requisitos mínimos de hardware, consulte Recomendaciones y requisitos de hardware mínimos para Tableau Server.

Errores de instalación o actualización debido a los requisitos de CPU

A partir de la versión 2020.4.0, Tableau Server requiere CPU compatibles con los conjuntos de instrucciones SSE4.2 y POPCNT. No puede instalar ni actualizar Tableau Server 2020.4.0 o posterior en equipos que tengan CPU que no sean compatibles estos conjuntos de instrucciones.

Es posible que vea este mensaje de error al instalar una nueva instalación o en preparación para actualizar una instalación existente: 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

Los conjuntos de instrucciones SSE4.2 y POPCNT llevan utilizándose habitualmente más de 10 años y son compatibles con la mayoría de las CPU nuevas, pero si recibe un error relacionado con los requisitos mínimos del procesador al intentar instalar o actualizar Tableau Server en una máquina virtual (VM), el modo de compatibilidad del procesador puede estar activado en la máquina virtual. Para instalar o actualizar Tableau correctamente en una máquina virtual, asegúrese de que el modo de compatibilidad del procesador esté desactivado.

Ubicación de los registros de actualización

De forma predeterminada, el registro de actualización (app-upgrade.log) se escribe en C:\ProgramData\Tableau\Tableau Server\logs.

Error: No se pudo establecer una conexión con Active Directory

A partir de la versión 2021.2 de Tableau, Tableau Server ya no permite conexiones no seguras con Active Directory. Si su instancia actual de Tableau Server se comunica con Active Directory a través de un canal no cifrado, la actualización fallará.

Para resolver este problema siga estos pasos:

• Investigue y resuelva la conexión segura fallida. Consulte el tema de Microsoft Problemas de conexión LDAP sobre SSL(El enlace se abre en una ventana nueva) .

• Ejecute los siguientes comandos para permitir una conexión no segura en su versión actual de Tableau Server antes de actualizar:

  tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys

  tsm pending-changes apply

  Una vez completada la actualización, recomendamos proteger el canal y luego configurar esta opción enfalse .

  Nota: Por defecto (cuandowgserver.domain.allow_insecure_connection se establece enfalse ), la sincronización del grupo de Active Directory fallará si el canal de comunicación con Active Directory no está cifrado.

Después de la actualización, los mapas no se ven o no se muestran completos

A partir de la versión 2019.2 de Tableau, han cambiado los requisitos de acceso a Internet para los mapas. Si realiza la actualización desde la versión 2019.1.x o anterior a la versión 2019.2.x o posterior y los mapas no se muestran como deberían, asegúrese de que el entorno está configurado para permitir el acceso en el puerto 443 a mapsconfig.tableau.com y api.mapbox.com.

En la versión 2019.1.x o anterior, se debía acceder a maps.tableausoftware.com.

Para obtener más información sobre los requisitos de acceso a Internet, consulte Comunicando con Internet.

Error en el script de actualización: "Error al validar el cambio de versión de Tableau Server".

A la hora de actualizar, si ejecuta el script upgrade-tsm del directorio scripts.<version_code> de la versión anterior, se producirá un error:

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Si aparece este error, cambie al directorio scripts.<version_code> de la versión que acaba de instalar y ejecute el script desde allí.

En la actualización de varios nodos, la inicialización de un modo adicional produce el error “Vuelve a escribir tus credenciales”.

Si intenta inicializar un nodo adicional al actualizar Tableau Server y aparece este error:

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

se trata de una indicación de que el nodo no puede conectarse ni comunicarse con el nodo inicial. Esto puede ocurrir por varios motivos:

• Las credenciales especificadas no son válidas o no las ha escrito bien. Las credenciales deben corresponderse con un usuario que tenga permisos administrativos en el equipo en el que se instaló Tableau Server por primera vez. No necesita usar las credenciales del usuario que creó el archivo de arranque, aunque estas garantizarán que está utilizando credenciales válidas.

• El firewall local del equipo que está intentando añadir no permite la comunicación con el nodo inicial. Para obtener más información, consulte Configuración del firewall local.

Errores de actualización debido a la falta de espacio en disco

Si no hay suficiente espacio en disco para ejecutar el programa de instalación de Tableau Server y llevar a cabo la actualización, se produce un error de instalación. La cantidad necesaria de espacio en disco depende del tamaño de la base de datos del repositorio y del número y el tamaño de las extracciones.

Nota: Al actualizar desde una versión anterior a TSM de Tableau Server (una versión anterior a la 2018.2.0), la desinstalación de Tableau crea un archivo de copia de seguridad del servidor en el directorio de datos. Este archivo de copia de seguridad tiene una extensión .tsbak y es necesario para la actualización. Después de actualizar correctamente, puede eliminar este archivo de forma segura para liberar espacio (cree una copia en un equipo que no forme parte de la instalación de Tableau Server en caso de que necesite el archivo por cualquier motivo). No elimine este archivo hasta que haya completado la actualización y sepa que funciona.

Para liberar espacio en disco:

1. Cree una instantánea de los archivos de registro mediante el comando tsm maintenance ziplogs.

   Después de crear el archivo ziplogs, guárdelo en una ubicación segura que no forme parte de la instalación de Tableau Server.

2. Limpie los archivos innecesarios con el comando tsm maintenance cleanup. Para obtener más información, consulte Eliminar archivos innecesarios.

La actualización falla en el trabajo RebuildSearchIndex

A partir de la versión 2020.1.x, el último paso de una actualización es volver a generar el índice de búsqueda. En este momento se han actualizado todos los servicios, por lo que si se produce un error en este trabajo, puede restablecer manualmente el servidor de búsqueda ejecutando el comando tsm maintenance reset-searchserver. No es necesario borrarlo todo y empezar de nuevo.

El error será:

An error occurred while rebuilding search index.

Para restablecer el servidor de búsqueda:

1. En el nodo inicial, abra un símbolo del sistema como administrador.

   Debe ser un nuevo símbolo de sistema porque el script de actualización actualiza el entorno del sistema a la nueva versión.

2. Vuelva a generar el índice de búsqueda mediante el comando tsm maintenance reset-searchserver.

La actualización falla en 2022.1 y versiones posteriores

Después de actualizar Tableau Server 2022.1 (o posterior), la restauración de una copia de seguridad de Tableau Server como parte de su proceso de actualización 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 ocurre porque Tableau Server 2022.1 (y versiones posteriores) usa un esquema de identidad que es diferente del esquema de identidad que usa la copia de seguridad. Para resolver este problema, consulte Solucionar problemas con la migración de identidades.

La actualización falla en la versión 2020.4.0 o posteriores

A partir de la versión 2020.4.0, la función de actualización de punto de control le permite reintentar una actualización fallida. En general, esto es más útil para administradores de servidores experimentados y profesionales de TI que se sienten cómodos con los archivos de registro de Tableau Server y están dispuestos a buscar a través de ellos. Pero la funcionalidad puede ayudar en todas las actualizaciones con errores porque le permite volver a ejecutar el script upgrade-tsm y el script se ejecuta desde el último paso correcto, lo que ahorra bastante tiempo. Los usuarios con experiencia pueden identificar problemas, como los de espacio en disco o problemas de permisos, corregirlos y volver a ejecutar la actualización.

Si va a actualizar a la versión 2020.4.0 o posterior y se produce un error en la actualización, los pasos siguientes pueden ayudarle a completarla:

• Vuelva a ejecutar el script upgrade-tsm. Los errores de actualización a veces son el resultado de los tiempos de espera durante el proceso de actualización, y volver a ejecutar el script puede permitir que la actualización supere los problemas de sincronización intermitentes u ocasionales. Este es también un paso sencillo y seguro. Volver a ejecutar el script no hará ningún daño y, en el peor de los casos, la actualización volverá a fallar en el mismo punto, pero sin necesidad de seguir ningún paso anterior.

  El script se ubica en el directorio \scripts:

  De forma predeterminada:

  C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\upgrade-tsm.cmd

  Si la actualización de Tableau Server no se realiza correctamente al volver a ejecutar el script de actualización y se siente cómodo con los registros de Tableau Server, puede seguir estos pasos adicionales para solucionar problemas:

• Observe la salida del script en la ventana de comandos (vuelva a ejecutar el script si ya no tiene la ventana de comandos abierta). Debe ejecutar el script en una ventana de comandos con acceso de administrador. Los mensajes de error útiles pueden ayudarle a identificar la causa del error de actualización y darle algunas ideas sobre cómo corregir el problema.

• Consulte el archivo app-upgrade.log. Los errores que se muestran en la línea de comandos también aparecerán en el archivo app-upgrade.log, a menudo con más detalles.

• Consulte el archivo tabadmincontroller.log. Los problemas de actualización que no son fácilmente identificables en las dos instancias anteriores son probablemente el resultado de un problema en un trabajo. El archivo tabadmincontroller.log puede tener más información que le ayude a diagnosticar el problema.

  Nota: Para obtener información sobre las ubicaciones de los archivos de registro, consulte Registros de Tableau Server y ubicación del archivo de registro.

La actualización falla debido a problemas de permisos con la ubicación del archivo de copia de seguridad/restauración

Con versiones de Tableau Server anteriores a 2022.1.0, si la ubicación del archivo para el archivo de copia de seguridad/restauración no tiene los permisos correctos, el script de actualización fallará con un error sobre no poder leer el archivo de copia de seguridad o no poder restaurar el repositorio

A partir de la versión 2022.1, el script de actualización confirma los permisos de la ubicación del archivo para el archivo de copia de seguridad/restauración antes de iniciar la actualización, de modo que el archivo se pueda escribir y leer desde la ubicación durante la actualización a la nueva versión de Tableau Server.

Los errores serán similares a estos:

The runas user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

La ubicación que utiliza TSM para la copia de seguridad y la restauración está definida por la clave de configuración basefilepath.backuprestore y tiene un valor predeterminado que el programa de instalación establece con los permisos correctos, pero estos pueden verse afectados por las reglas de TI de la organización o si cambia la ubicación a una que haya creado usted mismo. Un nuevo comando disponible a partir de 2022.1 le permite comprobar los permisos en la ubicación del archivo de copia de seguridad/restauración inmediatamente después de crearlo, para evitar problemas relacionados con los permisos. Para obtener detalles sobre ese comando, consulte tsm maintenance validate-backup-basefilepath.

Para obtener más información sobre la ubicación del archivo, consulte tsm File Paths.

La actualización se realizó correctamente, pero no se puede acceder a las fuentes de datos publicadas

En escenarios específicos y limitados, después de actualizar Tableau Server de la versión 2021.3 a las versiones anteriores de 2023.1 o 2023.3, los intentos de conectarse o actualizar las fuentes de datos publicadas existentes fallan con este error:

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Esto podría suceder si:

1. Puede actualizar una instalación de Tableau Server que era la versión 2021.3.x en cualquier momento (podría estar ejecutando la versión 2021.3 o haber actualizado de la versión 2021.3 a una versión 2022.x)
   
   y

2. Actualiza esa instalación a primeras versiones de 2023.1 o 2023.3

Sin impacto

No hay problemas en las siguientes situaciones:

• En todas las demás rutas de actualización de 2021.3

• En todas las demás rutas de actualización a 2023.1 o 2023.3

• En todas las nuevas instalaciones de 2023.1 y 2023.3

Más información

A partir del 16 de septiembre de 2024, todas las versiones problemáticas se eliminarán del sitio de descargas. Si necesita actualizar a la versión 2023.1.x o 2023.3.x, actualice a las versiones de lanzamiento de mantenimiento 2023.1.16 o superior, o 2023.3.9 o superior.

Para obtener más información sobre este problema, consulte Problema conocido(El enlace se abre en una ventana nueva).

Problemas comunes de importar la configuración

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

No puede conectarse a TSM

Si puede conectarse a TSM desde el equipo en el que ha instalado Tableau (mediante https://localhost:8850, por ejemplo), pero no puede conectarse desde otro equipo (con https://<server-name>:8850), puede que tenga que configurar el firewall local en el equipo de Tableau Server.

A partir de la versión 2018.2, tendrá que configurar el firewall manualmente. Para obtener más información, consulte Configuración del firewall local.

Confirme que puede acceder al servidor de licencias

El servicio de licencias de Tableau se movió a un nuevo centro de datos el 6 de octubre de 2018. Esto significa que los entornos que necesitaban una configuración especial (por ejemplo, el listado seguro de direcciones IP estáticas) para acceder a licensing.tableau.com o licensing.tableau.com tendrán que actualizarse antes de activar, actualizar o desactivar una clave de producto de Tableau.

Para probar el acceso, escriba la dirección URL y el puerto del servidor de licencias en un explorador:

https://licensing.tableau.com:443

y

https://atr.licensing.tableau.com/_status/healthz

Si puede acceder al servidor, aparece un mensaje "Probar éxito" para el primer servidor y aparece un mensaje "Aceptar" para el segundo.

Tableau Server necesita conectarse a las siguientes ubicaciones de Internet por cuestiones relacionadas con licencias:

• atr.licensing.tableau.com:443

• licensing.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

Las solicitudes de los dominios anteriores pueden estar en el puerto 80 o 443. El puerto 80 se utiliza para la validación de certificados (revocación, cadena de certificados, etc.). El puerto 443 se utiliza para las conexiones SSL.

Las solicitudes a los dominios ocsp.*.amazontrust.com y crl.*.amazontrust.com son administradas por Amazon para obtener información sobre la revocación de certificados. Consulte Características del certificado ACM(El enlace se abre en una ventana nueva) para obtener más información. Le recomendamos que instale los certificados raíz de Amazon en el almacén de confianza de certificados en el equipo que ejecuta Tableau. Para descargar e instalar los certificados raíz de Amazon, consulte Autoridades de certificación(El enlace se abre en una ventana nueva) en el sitio web de Amazon Trust Services.

Verificar la fecha y la hora

Compruebe que la fecha y la hora del equipo inicial de Tableau Server sean correctas. Si el reloj está establecido en una hora y una fecha anteriores a las actuales, no se podrá activar Tableau Server.

Comprobar que el servicio de licencias FlexNet se ha iniciado

Si la fecha y la hora del equipo de Tableau Server son correctas, compruebe que el servicio de licencias FlexNet se esté ejecutando en el equipo inicial de Tableau Server.

1. En el equipo inicial, desde el menú Inicio de Windows, abra services.msc.

2. En el cuadro de diálogo Servicios, compruebe que el estado de Servicio de licencias FlexNet 64 (64 bits) o Servicio de licencias FlexNet (32 bits) sea Iniciado.

   Si FlexNet no aparece como Iniciado, haga clic con el botón derecho en el servicio de licenciamiento FlexNet y seleccione Iniciar.

   Si la opción Iniciar está atenuada, es posible que el servicio esté establecido en Deshabilitado. Para habilitar el servicio:

   1. Haga clic con el botón derecho en el servicio de licenciamiento FlexNet y seleccione Propiedades.

   2. En la lista desplegable Tipo de inicio, seleccione Automático.

   3. Haga clic en el botón Iniciar y, a continuación, en Aceptar.

Obligar a la relectura de la clave de producto

1. En el equipo inicial de Tableau Server, inicie sesión como administrador y abra un símbolo del sistema.

2. Cambie al directorio bin de Tableau Server. De forma predeterminada, es el siguiente:

   C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>

3. Escriba los siguientes comandos:

   tsm stop
   lmreread
   
   tsm start

Enviar el contenido del almacenamiento de confianza al servicio de soporte de Tableau

Si el servicio de licencias FlexNet está instalado y ejecutándose, pero sigue viendo un error, es posible que haya un problema con la información de la clave de producto de Tableau. Para solucionar este problema, realice los pasos siguientes para crear un archivo de información de la clave ubicada en el almacenamiento de confianza.

1. En el equipo inicial de Tableau Server, inicie sesión como administrador y abra un símbolo del sistema.

2. Escriba el comando siguiente:

   serveractutil -view > <machine_name>-LicResults.txt

   Esto crea el archivo <machine_name>-LicResults.txt en el directorio actual. Si no tiene permisos de escritura para esa ubicación y ve un error, cambie a una ubicación en la que tenga permiso para crear un archivo y ejecute el comando de nuevo.

3. Póngase en contacto con Asistencia al cliente de Tableu (http://www.tableau.com/es-es/support/request(El enlace se abre en una ventana nueva)) e incluya el archivo <machine_name>-LicResults.txt que ha creado.

Instalación de tabcmd por separado

tabcmd se instala automáticamente en el nodo inicial de Tableau Server al instalar Tableau Server, pero si desea ejecutarlo en otro equipo, debe descargar e instalar tabcmd por separado. Para obtener información detallada, consulte Instalar tabcmd.

Problemas al instalar tabcmd en Linux

tabcmd requiere Java 11 para funcionar correctamente. En sistemas de tipo RHEL esto se instalará como una dependencia cuando se instale tabcmd. En sistemas de tipo Debian, necesita instalar Java 11 por separado si no está ya instalado.

A partir de julio de 2022, las distribuciones de Debian ya no son compatibles. Para obtener más información, consulte esta publicación de la Comunidad de Tableau(El enlace se abre en una ventana nueva).

Java no está instalado

Si ve errores similares a este al instalar tabcmd, confirme que Java 11 está instalado en su equipo Linux:

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

Se ha instalado una versión incorrecta de Java

Si usted ve los errores similares a estos, confirme que Java 11 está instalado:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

o

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.