Atualizar o Tableau Server Independent Gateway

Este tópico orienta você no processo de atualização do Tableau Server Independent Gateway. O processo descrito neste tópico é o mesmo para todas as atualizações de versão. Isso significa que você pode usar esse processo para atualizações da versão principal (por exemplo, 2022.1 a 2023.1) e da versão de manutenção (2022.1.1 a 2023.1.1).

Você deve usar um instalador para o Tableau Server Independent Gateway com uma versão com uma versão principal que corresponda à versão do Tableau Server. Recomendamos à correspondência com as versões de manutenção (2022.1.1 ou 2022.1.2 por exemplo), mas não é um requisito. Se a alteração de "ativos estáticos" entre as versões e as versões não corresponderem, você poderá ver algum impacto inesperado na imagem. Por exemplo, os mapas podem não estar atualizados se o Independent Gateway for uma versão anterior ao Tableau Server.

Visão geral

O processo de atualização do Independent Gateway é, na verdade, um processo de desinstalação e reinstalação do software. No entanto, você pode minimizar a configuração e o tempo de inatividade geral seguindo o processo conforme descrito neste tópico.

O processo descrito neste tópico pressupõe que você tenha uma implantação funcional do Tableau Server e do Independent Gateway do Tableau Server em execução. Se você estiver atualizando a implantação de back-end do Tableau Server como parte de sua atualização, recomendamos primeiro atualizar o(s) servidor(es) de Independent Gateway, validar a conectividade básica com um cliente do Tableau e, em seguida, prosseguir com a atualização do Tableau Server.

As etapas detalhadas neste tópico estão resumidas aqui:

  1. Copie alguns arquivos existentes para uso durante a atualização.
  2. Execute o script obliterate para remover o Independent Gateway.
  3. Instale a nova versão do Independent Gateway.
  4. Opcional: substitua o arquivo tsighk-auth pela cópia original.
  5. Atualize as configurações de TLS.
  6. Opcional: atualize o Tableau Server de back-end
  7. Reinicie o serviço do Independent Gateway.

Etapa 1: copie os arquivos para referência

Pode ser necessário fazer referência às definições de configuração armazenadas nos arquivos a seguir. Copie esses arquivos para um local seguro e acessível (os caminhos dos arquivos são o local padrão):

  • /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf
  • /var/opt/tableau/tableau_tsig/config/httpd.conf.stub
  • /etc/opt/tableau/tableau_tsig/environment.bash

Etapa 2: oblitere o Independent Gateway

Para remover o Independent Gateway do(s) servidor(es), execute o script tableau-tsig-obliterate:

  1. No nó inicial, abra uma sessão do terminal.

  2. Execute o script tableau-tsig-obliterate:

    sudo /opt/tableau/tableau_tsig/packages/scripts.<version_code>/tableau-tsig-obliterate -y -y -y

  3. Reinicie o computador.

Etapa 2: instale o Independent Gateway

Baixe a versão do Independent Gateway para a qual deseja atualizar e siga o mesmo procedimento de instalação conforme descrito no tópico Instalar o Tableau Server com Independent Gateway .

Assim como na instalação original, você precisará especificar as configurações de inicialização como parte da configuração. Para usar os mesmos valores, consulte o arquivo enviornment.bash que você copiou na etapa 1. Não substitua o novo arquivo bash pelo original.

Etapa 4: (opcional) substitua o arquivo tsighk-auth pela cópia original

O arquivo tsighk-auth é um arquivo de configuração que armazena uma cadeia de caracteres exclusiva chamada authsecret. O authsecret é usado para verificar se o Tableau Server de back-end está se comunicando com uma instância confiável do Independent Gateway. Ao configurar a instância original do Independent Gateway, você precisava atualizar um arquivo de configuração no back-end do Tableau Server com o authsecret.

Se a política de segurança permitir, você poderá continuar usando o authsecret original no Independent Gateway. Isso evita o processo de atualização e reinicialização do Tableau Server de back-end com um novo authsecret.

Para manter o authsecret original, sobrescreva o arquivo tsighk-auth.conf (localizado em /var/opt/tableau/tableau_tsig/config/tsighk-auth.conf) pela cópia que você salvou na etapa 1.

Se a política de segurança exigir que você atualize o authsecret, anote o novo authsecret que foi gerado pelo processo de instalação. Você atualizará o Tableau Server de back-end com o novo authsecret posteriormente no processo.

Etapa 5: atualize as configurações de TLS de limpeza

Se você não configurou o TLS para comunicação de manutenção (HK) entre instâncias de gateway independente e a implantação do Tableau Server de back-end, você pode pular esta etapa.

Se você configurou o HK TLS, deverá copiar manualmente a configuração do arquivo httpd.conf.stub original no arquivo localizado em /var/opt/tableau/tableau_tsig/config/httpd.conf.stub). Não substitua o novo arquivo pelo arquivo original, pois o arquivo mais recente pode incluir outras configurações.

  1. Atualize as definições de configuração TLS relevantes no seguinte bloco:

    <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 obter mais informações sobre essas configurações, consulte Configurar TLS no Independent Gateway.

  2. Quando você terminar de atualizar httpd.conf.stub, salve-o.

  3. Copie httpd.conf.stub e, em seguida, salve para substituir httpd.conf no mesmo diretório.

Etapa 6: (opcional) atualize a implantação do Tableau Server de back-end

Se você copiou o arquivo authsecret original (tsighk-auth.conf) para a nova instância do Independent Gateway conforme descrito na etapa 4, então pode pular esta etapa.

Se você estiver atualizando o authsecret na implantação do Tableau Server de back-end, deverá atualizar o arquivo tsig.json no nó inicial com o novo authsecret. Consulte Instalar o Tableau Server com Independent Gateway. Ao concluir, execute os seguintes comandos TSM:

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

Etapa 7: reinicie o serviço tsig-httpd

Quando você terminar com a configuração, reinicie o serviço tsig-httpd.

sudo su - tableau-tsig
systemctl --user restart tsig-httpd
exit