Instalar Tableau Server con puerta de enlace independiente

Se aplica a: Tableau Advanced Management

Este tema lo guía a través del proceso de instalación de la puerta de enlace independiente de Tableau Server.

Seguir este proceso dará como resultado una configuración de puerta de enlace independiente con una conexión directa a la implementación backend de Tableau Server. Puede obtener más información sobre los modos de conexión directos y de retransmisión en el tema Configurar Tableau Server con la puerta de enlace independiente.

Requisitos previos

Debe tener un servidor dedicado con al menos 2 núcleos (4 vCPU), 8 GB de RAM y 100 GB de espacio libre en disco.
Debe utilizar Tableau Server 2022.1 o una versión posterior.
Debe usar un instalador para la puerta de enlace independiente de Tableau con una versión principal (por ejemplo, 2022.1) que coincida con la versión de Tableau Server. Recomendamos que las versiones de mantenimiento (2022.1.1 o 2022.1.5, 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.
Debe tener una licencia válida de Advanced Management activada en Tableau Server. Para obtener más información sobre Advanced Management, consulte Acerca de Tableau Advanced Management en Tableau Server.
De forma predeterminada, la puerta de enlace independiente debe poder comunicarse con la implementación de backend de Tableau Server en los puertos 80 y 21319 durante la instalación. Puede cambiar estos puertos predeterminados durante la inicialización como se describe más adelante en este tema.
Verifique que su implementación de Tableau Server esté completa y en buen estado antes de instalar y configurar la puerta de enlace independiente.
Verifique que no esté ejecutando ninguna otra aplicación web en la computadora donde está instalando la puerta de enlace independiente. Por ejemplo, si Apache httpd está instalado en el equipo, desinstálelo o configure httpd para que no escuche activamente en el puerto 80.

Instalar Tableau Server y la puerta de enlace independiente

La instalación de la puerta de enlace independiente se realiza mediante un de paquete de instalación independiente que incluye "tsig" como parte del nombre del archivo para distinguirlo del instalador completo de Tableau Server. Le recomendamos que instale la puerta de enlace independiente después de instalar Tableau Server y confirmar que funciona como se esperaba. Para instalar debe ser el usuario root (o ser capaz de sudo a root). Puede instalar una o más instancias de la puerta de enlace independiente, pero cada instancia de la puerta de enlace independiente debe instalarse por separado. Si está instalando varias instancias para alta disponibilidad o para distribuir una gran carga de clientes, repita los pasos de instalación para cada instancia.

Después de la instalación, se le pedirá que ejecute un script llamado initialize-tsig para completar la instalación. El script toma la información que usted proporciona mediante parámetros y configura la puerta de enlace independiente. Una vez que la puerta de enlace independiente esté completamente instalada, debe ejecutar un comando TSM en el nodo inicial de Tableau Server para configurar el servidor con detalles sobre la instancia de la puerta de enlace independiente.

La instalación de IG consta de estos pasos:

Ejecute el instalador específico de la plataforma.
Ejecute el script posterior a la instalación.
Habilite la instancia de la puerta de enlace independiente mediante TSM.

Paso 1: Descargue e instale Tableau Server

Instalar e inicializar TSM: siga las instrucciones de este tema y complete los pasos 1-5, que ejecutan el programa de instalación e instalan TSM.
Activar y registrar Tableau Server: proporcione la clave del Tableau Server y la clave de Advanced Management en el paso de activación. Tendrá que ejecutar el siguiente comando dos veces, primero con la clave de producto de Tableau Server y luego con la clave de producto de Advanced Management:
tsm licenses activate -k <product key>
Configurar los ajustes de nodo iniciales: siga las instrucciones del tema para configurar las opciones iniciales del nodo.

Paso 2: Descargar e instalar la puerta de enlace independiente

Instale la puerta de enlace independiente de Tableau Server con el administrador del paquete de su distribución y, a continuación, ejecute un script para inicializar la puerta de enlace independiente. El script se incluye con el paquete instalado.

La puerta de enlace independiente se instala en el directorio /opt.

Inicie sesión con un usuario que tenga acceso sudo en el equipo donde quiere instalar la puerta de enlace independiente.
Nota: Para evitar posibles complicaciones, se recomienda una cuenta de usuario que no incluya ningún carácter especial (por ejemplo, no ASCII, "+", "-"). Estos pueden causar problemas, incluidos errores en la instalación completa de la puerta de enlace independiente, dependiendo de cómo esté configurado su entorno.
Descargue el paquete del instalador .rpm o .deb en la página de descargas y notas de la versión de Tableau Server.
Vaya al directorio en el que copió el paquete .rpm o .deb.
Utilice el gestor de paquetes para instalar el paquete de la puerta de enlace independiente.
No lo instale en una ubicación que utilice un enlace simbólico o en un directorio de un volumen del Sistema de archivos en red (NFS). Ejecute los siguientes comandos para instalar la puerta de enlace independiente, donde <version> tiene el formato versión principal-secundaria-mantenimiento (por ejemplo: 2022-1-0).
- Para distribuciones similares a RHEL incluyendo CentOS:
  sudo yum update
  sudo yum install tableau-tsig-<version>.x86_64.rpm
- En Ubuntu:
```
sudo apt-get update
sudo apt-get upgrade
sudo apt-get -y install gdebi-core
sudo gdebi -n tableau-tsig-<version>_amd64.deb
```

Iniciar la puerta de enlace independiente de Tableau Server

El siguiente paso es ejecutar el script initialize-tsig.

Vaya al directorio scripts:

cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/

Ejecute el siguiente script para inicializar e iniciar la puerta de enlace independiente:
sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>
Los únicos parámetros necesarios para el script initialize-tsig son --accepteula y -c.
- --accepteula:: debe incluir este parámetro para aceptar el Acuerdo de licencia de usuario final (EULA) de Tableau. Puede encontrar un enlace al acuerdo de licencia de usuario final (EULA) en la siguiente ubicación:
  /opt/tableau/tableau_tsig/packages/docs.<version_code>/
- -c: debe incluir este parámetro para especificar la ubicación de red de todos los nodos en el grupo Tableau Server. Estos nodos pueden estar enviando solicitudes de "limpieza" a la puerta de enlace independiente. Se pueden utilizar comodines y máscaras de subred para especificar varios nodos. Para especificar varias direcciones, sepárelas con espacios y use comillas alrededor del conjunto completo. Los valores deben proporcionarse en una de las formas aceptables para la directiva "Require" httpd mod_authz_host de Apache. Para obtener más información, consulte https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(El enlace se abre en una ventana nueva).
Todos los demás parámetros, por ejemplo, los puertos predeterminados utilizados por HTTP y el proceso de limpieza, son opcionales y, si se dejan, se les asignarán valores predeterminados. Revise los parámetros y sus valores predeterminados antes de ejecutar el script: Resultado de ayuda para el script initialize-tsig.

Paso 3: Habilite la puerta de enlace independiente en Tableau Server

El último paso para instalar y configurar la puerta de enlace independiente es habilitar la puerta de enlace independiente en Tableau Server. Para hacer esto, use el comando TSM tsm topology external-services gateway enable -c <file> con un archivo JSON que identifica la instancia o las instancias de la puerta de enlace independiente y proporciona a Tableau Server los detalles necesarios para la comunicación entre el servidor y la puerta de enlace independiente.

Tableau Server debe estar detenido para habilitar la puerta de enlace independiente.

El contenido del archivo JSON de la puerta de enlace independiente

El archivo JSON que usa para habilitar las instancias de la puerta de enlace independiente en Tableau Server debe contener lo siguiente:

id:: el valor de id debe coincidir con eltsig_instance_id para la instancia particular. Si no proporcionó esto, el valor predeterminado es el nombre de dominio completo del equipo de la puerta de enlace independiente, en minúsculas. El valor en el archivo json debe coincidir con la salida del comando hostname.
host: el valor del host debe ser un nombre DNS que se pueda resolver para el equipo de la puerta de enlace independiente que puede resolverse por los nodos Tableau Server usando DNS.
puerto: el puerto debe coincidir con el puerto de mantenimiento (tsig_housekeeping_port) especificado en la instancia de la puerta de enlace independiente. Si no proporcionó esto durante la inicialización, el valor predeterminado es "21319".
protocolo: el protocolo debe ser el mismo que el protocolo de limpieza (tsig_housekeeping_port_protocol ) especificado en la instancia de la puerta de enlace independiente. Si no proporcionó esto durante la inicialización, el valor predeterminado es "http".
Secreto de autenticación:: el secreto de autenticación debe coincidir con el secreto creado por el script de inicialización en la instancia de la puerta de enlace independiente.

El secreto de autenticación de la puerta de enlace independiente

El script de inicialización crea un secreto único y compartido en cada equipo de la puerta de enlace independiente. Necesita este secreto para habilitar la puerta de enlace independiente en Tableau Server. Copie el secreto e inclúyalo en su archivo JSON como "authsecret".

El secreto compartido se encuentra en el archivo tsighk-auth.conf de esta ruta:

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

Ejemplo de archivo JSON de puerta de enlace independiente

El archivo JSON debe tener el siguiente formato. Este archivo JSON de ejemplo muestra valores predeterminados donde hay valores predeterminados. Su archivo debería haber utilizado los valores reales que coincidan con su instalación de la puerta de enlace independiente y su organización.

{
 "independentGateways": [
  {
    "id": "<mycomputer.example.com>",
    "host": "<DNS name of Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret01>"
  },
  {
    "id": "<mycomputer2.example.com>",
    "host": "<DNS name of second Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret02>"
  }
 ]
}

Habilitación de la puerta de enlace independiente en Tableau Server

Para completar la instalación de la puerta de enlace independiente, debe habilitarla mediante TSM.

Copie el archivo de configuración JSON en el nodo inicial de Tableau Server.
En el nodo inicial, abra una línea de comandos con una cuenta que sea miembro del grupo tsmadmin.
Ejecute los siguientes comandos para detener Tableau Server, habilite la puerta de enlace independiente usando el archivo de configuración json y reinicie el servidor:
```
tsm stop
tsm topology external-services gateway enable -c tsig.json
tsm start
```

Paso 4: Verifique la puerta de enlace independiente en Tableau Server

Debería poder navegar a la página de inicio de sesión de Tableau Server especificando la dirección de la puerta de enlace independiente en un navegador.

Si hay un firewall entre la puerta de enlace independiente y la implementación backend de Tableau Server, deberá abrir los puertos para los procesos de Tableau Server para la conexión directa. Consulte Conexión directa para obtener más información.

Como alternativa, puede optar por minimizar los requisitos de puerto configurando la puerta de enlace independiente para una conexión de retransmisión. Consulte Conexión de retransmisión para obtener más información.

Volver arriba

¡Gracias por sus comentarios!

Sus comentarios se han enviado correctamente. ¡Gracias!

Ayuda de Tableau Server en Linux