Atualizar o Tableau Server

Para atualizar o Tableau Server, instale a nova versão enquanto a versão existente estiver em execução e, em seguida, execute um script de atualização para alternar para a nova versão. Isso reduz a quantidade de tempo de inatividade para usuários porque o servidor continua em execução quanto instala a nova versão. Você interrompe o servidor somente para executar o script de atualização.

Importante: atualizar o Tableau Server no Windows da versão 2018.1 ou posterior exige etapas especiais documentadas separadamente. Para obter instruções sobre como atualizar de uma versão anterior à 2018.2, consulte Atualizar do Tableau Server 2018.1 ou versão anterior para o Tableau Server com TSM.

Observações gerais sobre a atualização:

Todas as atualizações:

  • Backup—Criar um backup. Você é responsável pela criação de um backup dos dados existentes do Tableau Server antes da atualização. A partir da versão 2018.2, a atualização não mais solicita a criação de um backup da versão antiga ao instalar a nova. Recomendamos fortemente a criação de um backup antes de atualizar, pois isso fornece uma versão atualizada dos dados que você poderá usar caso precise voltar para a versão anterior do Tableau Server. Para obter mais informações sobre a preparação adequada para uma atualização, consulte Preparar para a atualização.

  • Desinstalarnão desinstale a versão existente antes da atualização. Ao executar uma atualização de TSM para TSM (versão 2018.2.x para uma posterior), você deve deixar a versão existente ativa e funcionando até pouco antes da atualização, usando o script de atualização. Se você desinstalar a versão existente antes de atualizar, não será possível executar a atualização. Para os usuários finais, isso tem o impacto de reduzir o tempo de inatividade, pois a nova versão é instalada enquanto a existente está em execução. O único momento em que o servidor não está em execução é quando o script de atualização realmente está atualizando para a nova versão.

  • Licenças

    • Chaves do produto de avaliação— não é possível atualizar diretamente um servidor que está executando uma chave do produto de avaliação de uma versão principal para outra (por exemplo, da versão 10.5.x para a 2018.x). Para atualizar de uma versão principal para a outra com uma chave do produto de avaliação, instale a nova versão do Tableau Server em outro computador, ative uma chave de avaliação nele e restaure um backup da versão existente. Para obter mais informações, consulte Confirmar requisitos da licença.

    • Manutenção expirada— não é possível atualizar um servidor com uma chave do produto com manutenção expirada ou que expirará em uma data anterior à data de lançamento da versão de atualização. Se tentar atualizar um servidor nesse estado, seu servidor será não licenciado e a atualização poderá falhar. Sua manutenção expirou ou é muito antiga, atualize sua chave do produto antes de executar o script de atualização para atualizar para a nova versão. Se atualizar a chave não atualizar a manutenção para uma data válida, verifique no Portal do cliente do Tableau para uma chave do Tableau Server com manutenção atual. Para obter detalhes sobre como atualizar a chave do produto, consulte Atualizar dados de manutenção para a chave do produto.

  • Localização da instalação— Ao atualizar o Tableau Server no Windows, você não pode alterar a localização da instalação a não ser que remova completamente todos os arquivos e pastas relacionadas à versão instalada anteriormente. Caso faça isso, garanta que você tem um arquivo de backup atual salvo em uma localização segura. Para obter informações sobre como remover completamente o Tableau, consulte Remover o Tableau Server do computador.

  • Instalar durante a execução— Ao atualizar o Tableau Server 2018.2 ou posterior, você instala a nova versão antes de desinstalar a antiga. O processo de atualização deixará a versão antiga intocada. Embora não seja obrigatório, é possível instalar a versão antiga depois da conclusão da atualização para liberar espaço em disco.

  • Várias versões— Após uma atualização, você verá várias versões do Tableau Server no Painel de controle. Ao concluir a atualização, desinstale a versão mais antiga usando o Painel de controle. Desinstalar a versão anterior a partir do Painel de controle não gera nenhuma influência sobre a nova versão em execução. Não use o script de apagamento para desinstalar uma versão antiga. O script é destinado a remover completamente o Tableau e removerá todas as versões do seu computador.

  • Script de atualização: para concluir a atualização e alternar para a nova versão, depois de instalar a nova versão em todos os nós do cluster, execute o script de atualização upgrade-tsm no nó inicial. O script está instalado na pasta \scripts.<version_code>. Execute o script da nova versão que você acabou de instalar.

  • Software antivírus—O software antivírus que verifica os diretórios usados pelo Tableau Server pode interferir na instalação e no uso contínuo do Tableau Server. Em alguns casos, isso pode resultar em falhas de instalação, problemas de inicialização do Tableau Server ou afetar o desempenho. Se você planeja executar um software antivírus no computador que executa o Tableau Server, siga as recomendações na Base de dados de conhecimento.

Atualizações em vários nós:

  • Instalação do nó—Execute o instalador em todos os nós de um cluster. Diferente de algumas atualizações de instalação em versões anteriores à 2018.2, não há a atualização automática de nós adicionais.

  • Instalador único— Use o mesmo instalador em todos os nós e especifique, quando solicitado, se está atualizando o nó inicial ou um nó adicional. Diferente das atualizações de instalação distribuída em versões anteriores à 2018.1, não há programas de instalação separados para os nós adicionais. A partir de 2018.2, você usa o mesmo instalador em todos os nós.

  • Instalar durante a execução— Ao atualizar da versão 2018.2 do Tableau Server no Windows para uma posterior, instale a nova versão do Tableau Server enquanto a existente estiver em execução. A versão existente continuará a ser executada até que você esteja pronto para trocar para a nova versão e concluir a atualização.

As etapas abaixo descrevem o processo geral da atualização da versão 2018.2 ou posterior do Tableau Server no Windows. As atualizações das versões beta do Tableau Server para Windows não são compatíveis.

Como prática recomendada, sempre faça um backup completo antes de atualizar qualquer versão do Tableau Server. Salve este arquivo de backup em um local que não faça parte da instalação do servidor. Criar e salvar um backup preserva seus dados e configurações antes da atualização e permite ter uma opção de reversão caso ocorram problemas durante a atualização. Para obter mais informações, consulte Fazer backup dos dados do Tableau Server.

Ao atualizar do Tableau Server 2018.2 ou posterior, não desinstale a versão anterior. O processo de atualização é projetado para instalar uma nova versão lado a lado com a versão existente e, em seguida, alternar da versão anterior para a posterior. Se desinstalar a versão atual antes de instalar a nova versão não será possível atualizar adequadamente. Depois de instalar a nova versão e atualizar, você poderá desinstalar a versão anterior quando optar por fazê-lo. Você pode deixar a versão mais antiga instalada indefinidamente, embora um dos motivos para a desinstalação seja liberar o espaço em disco usado por arquivos específicos da versão anterior. Para entender a diferença entre desinstalar o Tableau Server e remover todos os aspectos do Tableau Server completamente, consulte Desinstalar o Tableau Server.

A atualização do Tableau Server requer interromper e iniciar o servidor como parte do processo de atualização. Durante essa interrupção/reinicialização, o Tableau Server estará indisponível.

A atualização também aplicará todas as alterações pendentes. Se você tiver alterações pendentes que não deseja aplicar, descarte-as com o comando tsm pending-changes discard. Para ver quais alterações podem estar pendentes, use o comando tsm pending-changes list.

Atualizar uma instalação de nó único do Tableau Server

Siga estas etapas para atualizar uma instalação de nó único do Tableau Server.

  1. Baixe ou copie o novo programa de instalação do Tableau Server no computador que você está atualizando ou em um local acessível do computador que está atualizando.

  2. Acesse a pasta na qual você copiou o programa de configuração do Tableau Server e execute-o.

    Você não será solicitado a fornecer um local de instalação. O programa de instalação determinará onde a versão existente está instalada e instalará a nova versão no mesmo local.

  3. Quando a instalação for concluída, a última página do programa de instalação o informa que a atualização não foi terminada. Será preciso executar um script de atualização para concluir a atualização. Antes que possa executar o script, será necessário interromper o Tableau Server:

    • No TSM, clique em Tableau Server está em execução e Interromper o Tableau Server.:

      Você será solicitado a confirmar que deseja interromper o Tableau Server.

    • Em um prompt de comando:

      1. Abra um prompt de comando como administrador.
      2. Insira este comando:

        tsm stop

  4. Depois de interromper o Tableau Server, execute o script de atualização de uma das seguintes formas.

    • No programa de instalação:

      1. Selecione Iniciar o script de atualização automaticamente e clique em OK.

      2. Uma janela de comando será aberta para o script. Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais e solicitará a sua senha.

    • Na linha de comando:

      1. No nó inicial, abra um prompt de comando como um administrador.

      2. Navegue até a pasta de scripts da nova instalação.

        Como padrão:

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

      3. Quando o Tableau for interrompido, execute o script de atualização:

        upgrade-tsm

        Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais e solicitará a sua senha. É possível especificar um usuário e senha diferentes ao executar o script usando as opções --username e --password.

        Para ver todas as opções para o script upgrade-tsm, use a opção -h.
        upgrade-tsm -h

        Observação: se você executar o script da pasta scripts.<version_code> da versão anterior, a atualização falhará com um erro:

        "Falha na validação de alterações da versão do Tableau Server."
        "Tableau Server <version> já está instalado."

  5. Inicie o Tableau Server. Você pode fazer isso na interface do usuário na Web do TSM ou em um prompt de comando:

    • No TSM, clique em Tableau Server está parado e Iniciar Tableau Server.:

    • Em um prompt de comando:

      1. Abra um prompt de comando como administrador.

      2. Insira este comando:

        tsm start

        Se receber um erro de que o comando não foi reconhecido, feche todas as janelas de comando e abra um prompt de comando como administrador.

Atualizar uma instalação de vários nós do Tableau Server

Siga estas etapas para atualizar uma instalação de vários nós do Tableau Server:

  1. Baixe ou copie o novo programa de instalação do Tableau Server em todos os nós do Tableau Server que você está atualizando ou em um local acessível por todos os nós. Será necessário executar este Programa de instalação em todos os nós.

  2. No nó inicial, acesse a pasta na qual você copiou o programa de configuração do Tableau Server e execute-o. Isso instalará a nova versão do Tableau Server lado a lado da versão existente em execução.

    Você não será solicitado a fornecer um local de instalação. O programa de instalação determinará onde a versão existente está instalada e instalará a nova versão no mesmo local.

    Importante: quando a instalação for concluída, a última página do programa de instalação o informa que a atualização não foi terminada. Não execute o script de atualização até que você tenha instalado a nova versão em todos os nós do cluster. Deixe a janela de instalação aberta no nó inicial e prossiga com a instalação em todos os outros nós.

  3. Em cada nó adicional, acesse a pasta na qual você copiou o programa de instalação do Tableau Server e execute-o. Isso instalará a nova versão do Tableau Server em cada nó, lado a lado com a versão existente em execução.

    Importante: quando a instalação for concluída, a última página do programa de instalação o informa que a atualização não foi terminada. Certifique-se de que a opção "Iniciar o script de atualização automaticamente" não esteja selecionada e feche a janela de instalação.

  4. Após instalar a nova versão em cada nó no cluster, interrompa o Tableau Server.

    Você pode fazer isso na interface do usuário na Web do TSM ou em um prompt de comando:

    • No TSM, clique em Tableau Server está em execução e Interromper o Tableau Server.:

    • Em um prompt de comando no nó inicial:

      1. Abra um prompt de comando como administrador.
      2. Insira este comando:

        tsm stop

  5. Depois de interromper o Tableau Server, execute o script de atualização no nó inicial.

    Se a última tela de instalação ainda estiver aberta, você poderá selecionar Iniciar o script de atualização automaticamente e uma janela de comando será aberta para executar o script. Ou você poderá executar o script diretamente de um prompt de comando.

    • Para executar o script de atualização no programa de configuração:

      1. Selecione Iniciar o script de atualização automaticamente e clique em OK.

      2. Uma janela de comando será aberta para o script. Como você está conectado como um usuário com direitos de administrador local, o script será executado usando suas credenciais e solicitará a sua senha.

    • Para executar o script de atualização no prompt de comando:

      1. Abra um prompt de comando como administrador.
      2. Acesse o diretório de scripts da nova versão que você acabou de instalar.

        Como padrão:

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

      3. Execute o script de atualização.

        upgrade-tsm --username <TSM_admin>

        Você será solicitado a inserir a senha para o usuário administrativo fornecido.

        Para ver todas as opções para o script upgrade-tsm, use a opção -h.

        upgrade-tsm -h

        Observação: se você executar acidentalmente o script da pasta scripts.<version_code> para a versão anterior, ocorrerá uma falha de atualização com um erro:

        "Falha na validação de alterações da versão do Tableau Server."

      Levará um tempo para que o script de atualização seja concluído.

  6. Quando o script de atualização for concluído, inicie o Tableau Server. Você pode fazer isso na interface do usuário na Web do TSM ou em um prompt de comando:

    • No TSM, clique em Tableau Server está parado e Iniciar Tableau Server.:

    • Em um prompt de comando:

      1. Abra um prompt de comando como administrador.
      2. Insira este comando:

        tsm start

Se estiver planejando habilitar o Tableau Prep Conductor no Tableau Server, poderá fazer isso após concluir a atualização do Tableau Server para a versão 2019.1. O Tableau Prep Conductor permite publicar, executar e agendar fluxos no Tableau Server e está disponível para o Tableau Server 2019.1 e posteriores. Para obter mais informações, consulte os tópicos a seguir:

Obrigado pelo feedback! Ocorreu um erro ao enviar seu feedback. Tente novamente ou envie-nos uma mensagem..