Actualizar la puerta de enlace independiente de Tableau Server

Este tema lo guía a través del proceso de actualización de la puerta de enlace independiente de Tableau Server. El proceso descrito en este tema es el mismo para todas las actualizaciones de versión. Esto significa que puede usar este proceso para actualizaciones de versiones principales (por ejemplo, 2022.1 a 2023.1) y de versiones de mantenimiento (2022.1.1 a 2023.1.1).

Debe usar un instalador para la puerta de enlace independiente de Tableau Server con una versión principal que coincida con la versión de Tableau Server. Recomendamos que las versiones de mantenimiento (2022.1.1 o 2022.1.2, por ejemplo) también coincidan, pero esto no es un requisito. Si los "recursos estáticos" cambian entre versiones y las versiones no coinciden, es posible que vea un impacto inesperado en la imagen. Por ejemplo, es posible que los mapas no estén actualizados si la puerta de enlace independiente tiene una versión anterior a Tableau Server.-

Descripción general

El proceso de actualización de la puerta de enlace independiente es en realidad un proceso de desinstalación y luego reinstalación del software. Sin embargo, puede minimizar la configuración y el tiempo de inactividad general siguiendo el proceso que se describe en este tema.

El proceso descrito en este tema asume que tiene una implementación funcional de Tableau Server y la puerta de enlace independiente de Tableau Server en ejecución. Si está actualizando la implementación del backend de Tableau Server como parte de su actualización, le recomendamos que actualice primero los servidores de puerta de enlace independiente, valide la conectividad básica con un cliente de Tableau y luego continúe con la actualización de Tableau Server.

Los pasos detallados en este tema se resumen aquí:

  1. Copie algunos archivos existentes para usarlos durante la actualización.
  2. Ejecute el script de borrado para eliminar la puerta de enlace independiente.
  3. Instale la nueva versión de la puerta de enlace independiente.
  4. Opcional: sobrescriba el archivo tsighk-auth con la copia original.
  5. Actualice la configuración de TLS.
  6. Opcional: actualice el backend de Tableau Server
  7. Reinicie el servicio de puerta de enlace independiente.

Paso 1: Copie los archivos para referencia

Es posible que deba hacer referencia a los ajustes de configuración almacenados en los siguientes archivos. Copie estos archivos en una ubicación segura y accesible (las rutas de los archivos son la ubicación predeterminada):

  • ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf
  • ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub
  • ProgramData\Tableau\tableau_tsig\config\environment.bash

Paso 2: Eiminela puerta de enlace independiente

Para eliminar Independent Gateway de los servidores, ejecute el script tableau-tsig-obliterate.cmd:

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

  2. Ejecute el script tableau-tsig-obliterate.cmd:

    C:\Program Files\Tableau\tableau_tsig\packages\scripts.<version_code>\tableau-tsig-obliterate.cmd -y -y -y

  3. Reinicie el equipo.

Paso 3: Instale la puerta de enlace independiente

Descargue la versión de la puerta de enlace independiente a la que desea actualizar y luego siga el mismo procedimiento de instalación que se describe en el tema Instalar Tableau Server con puerta de enlace independiente.

Al igual que con la instalación original, deberá especificar la configuración de inicialización como parte de la configuración. Para usar los mismos valores, haga referencia al archivo enviornment.bash que copió en el paso 1. No sobrescriba el nuevo archivo bash con el original.

Paso 4: (Opcional) Sobrescriba el archivo tsighk-auth con la copia original

El archivo tsighk-auth es un archivo de configuración que almacena una cadena única llamada authsecret. Authsecret se usa para verificar que el Tableau Server de back-end se comunica con una instancia de confianza de la puerta de enlace independiente. Cuando configuró la instancia original de la puerta de enlace independiente, tuvo que actualizar un archivo de configuración en el back-end de Tableau Server con el authsecret.

Si su política de seguridad lo permite, puede continuar usando el authsecret original en la puerta de enlace independiente. Si lo hace, evitará el proceso de actualización y reinicio del Tableau Server de back-end con un nuevo authsecret.

Para mantener el authsecret original, sobrescriba el archivo tsighk-auth.conf (ubicado en ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf) con la copia que guardó en el paso 1.

Si su directiva de seguridad requiere que actualice el secreto de autenticación, tome nota del nuevo secreto de autenticación que generó el proceso de instalación. Actualizará el Tableau Server de back-end con el nuevo authsecret más adelante en el proceso.

Paso 5: Actualice la configuración de TLS de mantenimiento

Si no configuró TLS para la comunicación de mantenimiento (HK) entre las instancias de la puerta de enlace independiente y la implementación de Tableau Server de back-end, puede omitir este paso.

Si configuró HK TLS, debe copiar manualmente la configuración del archivo original httpd.conf.stub en el archivo ubicado en ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub). No sobrescriba el archivo nuevo con el archivo original, ya que el archivo más nuevo puede incluir otras configuraciones.

  1. Actualice los ajustes de configuración de TLS relevantes en el siguiente bloque:

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    Para obtener más información sobre esta configuración, consulte Configurar TLS en puerta de enlace independiente.

  2. Cuando haya terminado de actualizar httpd.conf.stub, guárdelo.

  3. Copie httpd.conf.stub y luego guarde para sobrescribir httpd.conf en el mismo directorio.

Paso 6: (Opcional) Actualizar la implementación de Tableau Server de back-end

Si copió el archivo authsecret original (tsighk-auth.conf) a la nueva instancia de la puerta de enlace independiente como se describe en el paso 4, entonces puede omitir este paso.

Si está actualizando el secreto de autenticación en la implementación de Tableau Server de back-end, debe actualizar el archivo tsig.json en el nodo inicial con el nuevo authsecret. Consulte Instalar Tableau Server con puerta de enlace independiente Cuando haya terminado, ejecute los siguientes comandos TSM:

tsm stop
tsm topology external-services gateway update -c tsig.json
tsm start

Paso 7: Reinicie el servicio tsig-httpd

Cuando haya terminado con la configuración, reinicie el servicio tsig-httpd.