Ajuda do Tableau Server no Linux

A instalação do IG consiste nestas etapas:

• Execute o instalador específico da plataforma.

• Execute o script de pós-instalação.

• Habilite a instância do Independent Gateway usando o TSM.

Instale o Tableau Server Independent Gateway com o seu gerenciador de pacotes de distribuição, depois execute um script para iniciar o Independent Gateway. O script está incluído no pacote instalado.

O Independent Gateway está instalado no diretório /opt.

1. Faça logon com um usuário que tenha acesso sudo ao computador em que deseja instalar o Independent Gateway.

   Observação: para evitar possíveis complicações, recomendamos uma conta de usuário que não inclua caracteres especiais (por exemplo, não ASCII, "+", "-"). Isso pode causar problemas, incluindo falha na instalação completa do Independent Gateway, dependendo de como seu ambiente está configurado.

2. Baixe o pacote do instalador .rpm ou .deb da página Downloads and notas de versão do Tableau Server.

3. Navegue até o diretório onde você copiou o pacote .rpm ou .deb.

4. Use o gerenciador de pacotes para instalar o pacote do Independent Gateway.

   Não instale em um local usando um link simbólico ou para um diretório em um volume de Sistema de arquivos de rede (NFS). Execute os seguintes comandos para instalar o Independent Gateway, onde <version>  é formatado como manutenção major-minor-maintenance (example: 2022-1-0):

   • Em distribuições semelhante a RHEL, incluindo CentOS:

     sudo yum update

     sudo yum install tableau-tsig-<version>.x86_64.rpm

   • Em Ubuntu:

     sudo apt-get update
     sudo apt-get upgrade
     sudo apt-get -y install gdebi-core
     sudo gdebi -n tableau-tsig-<version>_amd64.deb
     

Inicialize o Tableau Server Independent Gateway

O próximo passo é executar o script initialize-tsig.

1. Navegue até o diretório scripts:

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

2. Execute o seguinte script para inicializar e iniciar o Independent Gateway:

   sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>

   Os únicos parâmetros exigidos para o script são initialize-tsig --accepteula e -c.

   • --accepteula - Inclua esse parâmetro para aceitar o Contrato de licença de usuário final (EULA) do Tableau. O link para o EULA está disponível no local a seguir:

     /opt/tableau/tableau_tsig/packages/docs.<version_code>/

   • -c - Você deve incluir este parâmetro para especificar a localização de rede de todos os nós no cluster do Tableau Server. Esses nós podem estar enviando solicitações de "manutenção" para o Independent Gateway. Curingas e máscaras de sub-rede podem ser usados para especificar vários nós. Para especificar vários endereços, separe os endereços por espaços e use aspas no conjunto completo. Os valores devem ser fornecidos em uma das formas aceitáveis para a diretiva "Obrigatória” httpd mod_authz_host do Apache. Para obter mais informações, consulte https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(O link abre em nova janela).

   Todos os outros parâmetros, por exemplo, portas padrão usadas por HTTP e o processo de manutenção, são opcionais e, se deixados de fora, receberão valores padrão. Revise os parâmetros e seus valores padrão antes de executar o script: Saída de ajuda para script initialize-tsig .

O conteúdo do arquivo JSON do Independent Gateway

O arquivo JSON que você usa para habilitar as instâncias do Independent Gateway no Tableau Server precisa conter o seguinte:

• id — O valor do id deve corresponder aotsig_instance_id para a instância específica. Se você não forneceu isso, o padrão é o nome de domínio totalmente qualificado do computador do Independent Gateway, em letras minúsculas. O valor no arquivo json deve corresponder à saída do comando hostname.
• host — O valor do host deve ser um nome que possa ser resolvido por DNS para o computador de gateway independente que possa ser resolvido pelos nós do Tableau Server usando DNS.
• port — A porta deve corresponder à porta de manutenção (tsig_housekeeping_port ) especificada na instância do Independent Gateway. Se você não forneceu isso durante a inicialização, o padrão é "21319".
• protocol — O protocolo deve ser o mesmo que o protocolo de manutenção (tsig_housekeeping_port_protocol ) especificado na instância do Independent Gateway. Se você não forneceu isso durante a inicialização, o padrão é "http".
• authsecret — O authsecret deve corresponder ao segredo criado pelo script de inicialização na instância do Independent Gateway.

O segredo de autenticação do Independent Gateway

O script de inicialização cria um segredo exclusivo e compartilhado em cada computador do Independent Gateway. Você precisa desse segredo para habilitar o Independent Gateway no Tableau Server. Copie o segredo e inclua-o em seu arquivo JSON como "authsecret".

O segredo compartilhado está localizado no arquivo tsighk-auth.conf aqui:

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

Habilitando o Independent Gateway no Tableau Server

Para concluir a instalação do Independent Gateway, você precisa habilitá-lo usando o TSM.

1. Copie o arquivo de configuração JSON para o nó inicial do Tableau Server.
2. No nó inicial, abra um prompt de comando com uma conta que seja membro do grupo tsmadmin.

3. Execute os seguintes comandos para interromper o Tableau Server, habilite o Independent Gateway usando o arquivo de configuração json e reinicie o servidor:

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