Ajuda do Tableau Server no Windows

Os registros de instalação são gravados no diretório \Temp da conta de usuário que executa a Configuração. Na maioria dos casos, está localizado em C:\Users\<user>\AppData\Local\Temp.

Para determinar onde o diretório \Temp encontra-se para o usuário conectado, execute o comando a seguir no Prompt de comando do Windows: ECHO %Temp%.

O programa de instalação não solicita o local onde instalar

Ao instalar o Tableau Server pela primeira vez, será solicitada a localização na qual deseja instalá-lo. Caso não veja esse prompt, pode haver arquivos ou diretórios restantes de uma instalação anterior, mesmo se tiver desinstalado o Tableau. Para remover completamente todos os vestígios do Tableau versão 2018.2 ou posteriores, execute o script tableau-server-obliterate.cmd, reinicie o computador e tente instalar novamente. Se a instalação anterior foi uma versão anterior a 2018.2, exclua manualmente todas as pasta relacionadas ao Tableau antes de executar o programa de instalação novamente.

Importante: caso tenha criado um backup do Tableau (<file>.tsbak) que deseja manter (por exemplo, para restaurar para a nova instalação), copie esse arquivo em um local seguro em outro computador para garantir que não seja removido ao limpar o computador com o Tableau.

O programa de instalação não reinicia o Windows

Ao instalar o Tableau Server, o programa de Instalação pode solicitar que reinicie o Windows ao final da instalação. Em certos casos, clicar em Reiniciar não reinicia o computador. Isso pode acontecer quando um instalador de componentes de terceiros está solicitando uma reinicialização do Windows.

Se clicar em Reiniciar não reiniciar o Windows, conclua a instalação reiniciando o Windows manualmente.

Falha na instalação do TSM com o erro "initialization failed"

Se tentar instalar o Tableau Server e houver falha na instalação com este erro:

Tableau server initialization failed
See install log at C:\ProgramData\Tableau\Tableau Server\logs

Isso pode estar relacionado a um problema de permissões em seu computador. O usuário será logado no Windows e a instalação do Tableau deverá ter permissões de administrador no drive C, nas pastas C:\Windows e C:\Windows\System32 e no arquivo cmd.exe. Isso é válido mesmo se não estiver instalando o Tableau no drive C.

Para obter mais informações, consulte Base de dados de conhecimento do Tableau(O link abre em nova janela).

A tela de inicialização do TSM não é exibida

Ao instalar ou atualizar o Tableau Server, se o navegador for aberto mas não exibir nada, pode ser necessário adicionar o nome de host à lista de sites confiáveis. Como alternativa, limpe o cache do navegador ou utilize um navegador diferente. Para obter mais informações, consulte Base de dados de conhecimento do Tableau.(O link abre em nova janela).

Falha em várias tentativas de instalação

Se tentar instalar o Tableau Server e houver falha, todas as tentativas de instalação subsequentes também poderão falhar, a menos que execute o script tableau-server-obliterate.cmd para limpar o Tableau do computador.

Importante: você deve executar o script tableau-server-obliterate.cmd a partir de um prompt de comando de 64 bits. Por exemplo, execute cmd.exe na pasta C:\Windows\System32. Se você executar o script a partir de um prompt de comando de 32 bits, o script não removerá completamente o Tableau e poderá ocorrer falha nas instalações subsequentes. Para determinar se você está executando um prompt de comando de 64 bits, digite echo %processor_architecture% na janela de comando. Se o resultado inclui "64" (AMD64, por exemplo), o prompt de comando é um prompt de 64 bits. Se o resultado inclui "x86", você está executando um prompt de 32 bits. Para obter mais informações, consulte a documentação apropriada da Microsoft para as suas versões do Windows.

Uma tentativa de instalação falha pode deixar o computador em um estado que fará com que todas as tentativas subsequentes também falhem com erros que não parecem diretamente relacionados a uma tentativa de instalação anterior.

Para corrigir esse problema, execute o script tableau-server-obliterate.cmd para limpar quaisquer vestígios restantes da tentativa de instalação anterior e reinicie o computador. Para obter mais informações, consulte Executar o script tableau-server-obliterate.

Importante: caso tenha criado um backup do Tableau (<file>.tsbak) que deseja manter (por exemplo, para restaurar para a nova instalação), copie esse arquivo em um local seguro em outro computador para garantir que não seja removido ao limpar o computador com o Tableau.

O script obliterate gera o erro: "refresh-environment-variables.cmd' is not recognized as an internal or external command

Se você usar o Painel de controle para desinstalar o Tableau Server e, em seguida, executar o script tableau-server-obliterate.cmd para remover completamente o Tableau Server do computador, o script pode gerar um erro sobre o refresh-environment-variables. Isso ocorre porque um segundo script chamado pelo script obliterate não foi movido para o diretório temp. Você pode ignorar esse erro.

Falha na instalação devido a requisitos de hardware

Não será possível instalar o Tableau Server se o computador no qual estiver instalando não atender aos requisitos mínimos de hardware. Os requisitos se aplicam a todos os computadores nos quais o Tableau Server está sendo instalado. Para obter detalhes sobre os requisitos mínimos de hardware, consulte Requisitos mínimos de hardware e recomendações para o Tableau Server.

Falha na instalação ou atualização devido a requisitos de CPU

Começando na versão 2020.4, o Tableau Server exige CPUs compatíveis com conjuntos de instruções SSE4.2 e POPCNT. Você não pode instalar ou atualizar o Tableau Server 2020.4.0 ou posterior em computadores com CPUs não compatíveis com esses conjuntos de instruções.

Você pode ver esta mensagem de erro ao fazer uma nova instalação ou em preparação para atualizar uma instalação existente: 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

Os conjuntos de instruções SSE4.2 e POPCNT são comuns há mais de 10 anos, e a maioria das CPUs mais novas os aceita, mas se você tiver um erro relacionado aos requisitos mínimos do processador ao tentar instalar ou atualizar o Tableau Server em uma máquina virtual (VM), o modo de compatibilidade do processador pode ser ativado na VM. Para instalar ou atualizar com sucesso o Tableau em uma VM, certifique-se de que o modo de compatibilidade do processador esteja desligado.

Local dos registros de atualização

Por padrão, o registro de atualização app-upgrade.log é gravado no C:\ProgramData\Tableau\Tableau Server\logs.

Erro: falha ao estabelecer uma conexão com o Active Directory

A partir do Tableau versão 2021.2, o Tableau Server não permite mais conexões inseguras com o Active Directory. Se a instância atual do Tableau Server estiver se comunicando com o Active Directory por meio de um canal não criptografado, a atualização falhará.

Para resolver este problema, siga as etapas abaixo:

• Investigue e resolva a conexão segura com falha. Consulte o tópico da Microsoft, Problemas de conexão LDAP por SSL(O link abre em nova janela) .

• Execute os seguintes comandos para permitir uma conexão insegura em sua versão atual do Tableau Server antes de atualizar:

  tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys

  tsm pending-changes apply

  Após a conclusão da atualização, recomendamos proteger o canal e, em seguida, definir esta opção parafalse .

  Observação: por padrão (quando wgserver.domain.allow_insecure_connection está definido como false ), a sincronização do grupo do Active Directory falhará se o canal de comunicação com o Active Directory não estiver criptografado.

Os mapas não são exibidos ou são exibidos de forma incompleta após a atualização

Começando pela versão do Tableau 2019.2, os requisitos de acesso à Internet mudaram para mapas. Se você estiver atualizando da versão 2019.1.x ou anterior para a versão 2019.2.x ou posterior, e os mapas não estiverem sendo exibidos como esperado, confirme se seu ambiente está configurado para permitir o acesso na porta 443 para mapsconfig.tableau.com e api.mapbox.com.

Na versão 2019.1.x ou anterior, o acesso foi necessário para maps.tableausoftware.com.

Para obter mais detalhes sobre os requisitos de acesso à Internet, consulte Como se comunicar com a Internet.

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

Ao atualizar, se você executar o upgrade-tsm script do diretório scripts.<version_code> para a versão anterior, ocorrerá uma falha de atualização com um erro:

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

Se você tiver esse erro, mude para o diretório para a versão que scripts.<version_code> acabou de instalar e execute o script a partir daí.

Atualizar vários nós, falha na inicialização do nó adicional com o erro "Insira suas credenciais novamente"

Se tentar inicializar um nó adicional ao atualizar o Tableau Server e encontrar este erro:

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

pode ser uma indicação de que o nó não consegue se conectar a ou se comunicar com o nó inicial. Isso pode acontecer por diversos motivos:

• As credenciais inseridas não são válidas ou foram digitadas incorretamente. As credenciais devem ser de um usuário com permissões de administração no computador onde o Tableau Server foi instalado pela primeira vez. Não é necessário usar as credenciais do usuário que criou o arquivo bootstrap, mas fazendo isso você garante que está usando credenciais válidas.

• O firewall local do computador onde que está tentando adicionar não está permitindo a comunicação com o nó inicial. Para obter mais informações, consulte Configuração do firewall local.

A atualização falhou devido à falta de espaço em disco

Se não houver espaço em disco suficiente disponível para que o programa de Configuração do Tableau Server seja executado e faça a atualização, a instalação irá falhar. A quantidade necessária de espaço em disco dependerá do tamanho do banco de dados do seu repositório e do número e do tamanho das suas extrações.

Observação: ao atualizar de uma versão pré-TSM do Tableau Server (uma versão anterior a 2018.2.0), a desinstalação do Tableau criará um arquivo de backup do servidor no diretório de dados. Esse arquivo de backup tem uma extensão .tsbak, necessária para a atualização. Depois de atualizar com sucesso, você poderá excluir este arquivo com segurança para liberar espaço (faça uma cópia em um computador que não seja da instalação do Tableau Server, caso precise do arquivo por qualquer motivo). Não exclua este arquivo até que tenha concluído a atualização e saiba que ela está funcionando.

Para liberar espaço em disco:

1. Crie um instantâneo do arquivo de registro usando o comando tsm maintenance ziplogs.

   Após criar o arquivo de ziplogs, salve-o em um local seguro que não seja parte da sua instalação do Tableau Server.

2. Limpe os arquivos desnecessários usando o comando tsm maintenance cleanup. Para obter mais informações, consulte Remover arquivos desnecessários.

Upgrade falha no trabalho RebuildSearchIndex

Começando pela versão 2020.1.x, a etapa final em uma atualização é reconstruir o índice de pesquisa. Neste ponto, todos os serviços foram atualizados, portanto, se este trabalho falhar, você pode redefinir manualmente o servidor de pesquisa executando o comando tsm maintenance reset-searchserver. Você não precisa executar obliterate e começar de novo.

O erro será:

An error occurred while rebuilding search index.

Para redefinir o servidor de pesquisa:

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

   Esta deve ser um novo prompt de comando porque o script de upgrade atualiza o ambiente do sistema para a nova versão.

2. Reconstrua o índice de pesquisa usando o comando tsm maintenance reset-searchserver

A atualização falha na versão 2022.1 e posterior

Após atualizar o Tableau Server 2022.1 (ou posterior), restaurar um backup do Tableau Server como parte do processo de atualização pode causar o seguinte erro:

“O backup não pode ser restaurado porque o Tableau Server usa as novas tabelas de serviço de identidade por padrão.”

Esse problema ocorre porque o Tableau Server 2022.1 (e posterior) usa um esquema de identidade diferente do esquema de identidade usado pelo backup. Para resolver esse problema, consulte Solucionar problemas com migração de identidade.

A atualização falha em 2020.4.0 ou posterior

Começando com a versão 2020.4.0, o recurso Upgrade do Checkpoint permite que você tente novamente uma atualização com falha. Em geral, isso é mais útil para administradores de servidores experientes e profissionais de TI que estão confortáveis com arquivos de registro do Tableau Server e estão dispostos a pesquisá-los. Mas o recurso pode ajudar em todos os upgrades com falha, porque permite que você execute de novo o script upgrade-tsm a partir da última etapa de sucesso, economizando tempo. Para os experientes, pode ser possível identificar problemas como problemas de espaço em disco ou problemas de permissões, corrigi-los e refazer o upgrade.

Se você estiver atualizando para a versão 2020.4.0 ou posterior e o upgrade falhar, as seguintes etapas podem ajudá-lo na conclusão:

• Reexecute o script upgrade-tsm. As falhas de upgrade às vezes são resultado de intervalos durante o processo de upgrade, e a nova executação do script pode permitir que o upgrade supere os problemas de tempo intermitentes ou ocasionais. Também é uma etapa segura e fácil de realizar. Uma nova execução do script não fará mal, e na pior das hipóteses, o upgrade falhará novamente no mesmo ponto, mas sem precisar passar por quaisquer etapas anteriores.

  O script está instalado no diretório \scripts.

  Por padrão,

  C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\upgrade-tsm.cmd

  Se o upgrade do Tableau Server não for bem-sucedido quando você executar novamente o script upgrade-tsm e estiver confortável com os registros do Tableau Server, pode realizar essas etapas adicionais de solução de problemas:

• Veja a saída do script na janela de comando (execute novamente o script se você não tiver mais a janela de comando aberta). Você precisa executar o script em uma janela de comando com acesso de administrador. Mensagens de erro úteis podem ajudá-lo a identificar a causa da falha de upgrade e dar-lhe algumas ideias de como corrigir o problema.

• Olhe no arquivo app-upgrade.log. Quaisquer erros são exibidos na linha de comando também aparecerão no arquivo app-upgrade.log, muitas vezes com mais detalhes.

• Olhe no arquivo tabadmincontroller.log. Problemas de upgrade que não são facilmente identificáveis nas duas instâncias acima são provavelmente o resultado de um problema em um trabalho. O arquivo tabadmincontroller.logpode ter mais informações que ajudam você a diagnosticar o problema.

  Observação: para obter informações sobre locais de registro, consulte Locais de arquivo de registro e registros do Tableau Server.

A atualização falha devido a problemas de permissão com o local do arquivo de backup/restauração

Com versões do Tableau Server anteriores a 2022.1.0, se o local do arquivo de backup/restauração não tiver as permissões corretas, o script de atualização falhará com um erro sobre não conseguir ler o arquivo de backup ou restaurar o repositório.

A partir da versão 2022.1, o script de atualização confirma as permissões do local do arquivo para o arquivo de backup/restauração antes de iniciar a atualização para que o arquivo possa ser gravado e lido do local durante a atualização para a nova versão do Tableau Server.

Os erros serão semelhantes a estes:

The runas user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

O local usado pelo TSM para backup e restauração é definido pela chave de configuração basefilepath.backuprestore e tem um padrão que o programa de instalação configura com as permissões corretas, mas isso pode ser afetado pelas regras de TI da organização ou se você alterar o local para um que você mesmo criou. Um novo comando disponível a partir de 2022.1 permite verificar as permissões no local do arquivo de backup/restauração imediatamente após criá-lo, para evitar problemas relacionados a permissões. Para obter detalhes sobre esse comando, consulte tsm maintenance validate-backup-basefilepath.

Para obter detalhes sobre o caminho do arquivo de backup/restauração, consulte tsm File Paths.

A atualização foi bem-sucedida, mas as fontes de dados publicadas não podem ser acessadas

Em cenários específicos e limitados, após atualizar o Tableau Server da versão 2021.3 para versões anteriores de 2023.1 ou 2023.3, as tentativas de conexão ou atualização de fontes de dados publicadas existentes falham com este erro:

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

Isso pode acontecer se:

1. Você atualiza uma instalação do Tableau Server que era da versão 2021.3.x a qualquer momento (você pode estar executando a versão 2021.3 ou ter atualizado da versão 2021.3 para uma versão 2022.x)
   
   e

2. Você atualiza essa instalação para as primeiras versões de 2023.1 ou 2023.3

Nenhum impacto

Não há problemas nas seguintes situações:

• Em todos os outros caminhos de atualização de 2021.3

• Em todos os outros caminhos de atualização para 2023.1 ou 2023.3

• Em todas as novas instalações de 2023.1 e 2023.3

Mais informações

Em 16 de setembro de 2024, todas as versões problemáticas foram removidas do site de download. Se você precisar atualizar para a versão 2023.1.x ou 2023.3.x, atualize para as versões de manutenção 2023.1.16 ou superior, ou 2023.3.9 ou superior.

Para obter mais informações sobre o este problema, consulte Problema conhecido(O link abre em nova janela).

Problemas de importação de configurações comuns

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

Não é possível se conectar ao TSM

Caso consiga conectar-se ao TSM a partir do computador em que o Tableau foi instalado (usando https://localhost:8850, por exemplo), mas não conseguir conectar-se de outro computador (usando https://<server-name>:8850), pode ser necessário configurar o firewall local no computador do Tableau Server.

A partir da versão 2018.2 será necessário configurar o firewall manualmente. Para obter mais informações, consulte Configuração do firewall local.

Confirme que pode acessar o servidor de licenciamento

O serviço de licenciamento do Tableau foi transferido para um novo data center em 6 de outubro de 2018. Isso significa que os ambientes que exigem configuração especial (lista segura de IP estático, por exemplo) para acessar o licensing.tableau.com ou o licensing.tableau.com precisarão ser atualizados antes que possa ativar, atualizar ou desativar uma chaves do produto.do Tableau.

Para testar o acesso, digite a URL e a porta do servidor de licenciamento em um navegador:

https://licensing.tableau.com:443

e:

https://atr.licensing.tableau.com/_status/healthz

Se puder acessar o servidor, a mensagem “Teste realizado com sucesso” será exibida para o primeiro servidor, e a mensagem “OK” será exibida para o segundo.

O Tableau Server precisa fazer uma conexão com os seguintes locais na Internet para fins de licenciamento:

• atr.licensing.tableau.com:443

• licensing.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

As solicitações para os domínios acima podem ser feitas na porta 80 ou 443. A porta 80 é utilizada para validação de certificados (revogação, cadeia de certificados etc). A porta 443 é usada para conexões SSL.

Solicitações aos domínios ocsp.*.amazontrust.com e crl.*.amazontrust.com são gerenciados pela Amazon para obter informações de revogação de certificados. Consulte Características de certificados ACM(O link abre em nova janela) para obter maiores informações. Recomendamos que você instale os certificados raiz da Amazon no armazenamento confiável de certificados no computador que executa o Tableau. Para baixar e instalar os certificados raiz da Amazon, consulte Autoridades Certificadoras(O link abre em nova janela) no site da Amazon Trust Services.

Verificar data e hora

Verifique se a data e a hora no computador do Tableau Server inicial estão corretas. Se o relógio estiver definido com a hora e a data anteriores à data atual, o Tableau Server não poderá ser ativado.

Verificar se o serviço de licenciamento FlexNet foi iniciado

Se a data e a hora no computador do Tableau Server estiverem corretas, verifique se o serviço de licenciamento FlexNet está em execução no computador inicial do Tableau Server.

1. No computador inicial, no menu Iniciar do Windows, abra services.msc.

2. Na caixa de diálogo Serviços, verifique se o status do Serviço de licenciamento FlexNet 64 (64 bits) ou Serviço de licenciamento FlexNet (32 bits) está Iniciado.

   Se o FLEXnet não estiver listado como Iniciado, clique com o botão direito do mouse no Serviço de licenciamento FlexNet e selecione Iniciar.

   Se a opção Iniciar estiver esmaecida, talvez o serviço esteja definido como Desabilitado. Para habilitar o serviço:

   1. Clique com o botão direito do mouse em Serviço de licenciamento FlexNet e selecione Propriedades.

   2. Na lista suspensa Tipo de inicialização, selecione Automática.

   3. Clique no botão Iniciar e clique em OK.

Forçar uma nova leitura da chave do produto

1. No computador inicial do Tableau Server, faça logon como administrador e abra um prompt de comando.

2. Altere para o diretório bin do Tableau Server. Por padrão, ele é:

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

3. Digite os seguintes comandos:

   tsm stop
   lmreread
   
   tsm start

Enviar o conteúdo do armazenamento confiável para o suporte do Tableau

Se os serviços de licenciamento FlexNet estiver instalado e em execução, mas você ainda estiver vendo um erro, poderá haver um problema com as informações de chave de produto do Tableau. Para solucionar isso, conclua as etapas a seguir para criar um arquivo das informações importantes no armazenamento confiável.

1. No computador inicial do Tableau Server, faça logon como administrador e abra um prompt de comando.

2. Digite o seguinte comando:

   serveractutil -view > <machine_name>-LicResults.txt

   Isso cria o arquivo <machine_name>-LicResults.txt no diretório atual. Se não tiver permissões de gravação para esse local e visualizar um erro, altere para um local onde tenha permissão para criar um arquivo e execute o comando novamente.

3. Entre em contato com o Suporte do Tableau (http://www.tableau.com/pt-br/support/request(O link abre em nova janela)) e inclua o arquivo <machine_name>-LicResults.txt criado.

Instalação de tabcmd separadamente

O tabcmd é instalado automaticamente no nó inicial do Tableau Server quando você instala o Tableau Server, mas se quiser executá-lo em outro computador, precisa baixar e instalar tabcmd separadamente. Para obter detalhes, consulte Instalar tabcmd.

Problemas na instalação do tabcmd no Linux

O tabcmd requer que o Java 11 seja executado corretamente. Em sistemas semelhantes ao RHEL, ele será instalado como uma dependência ao instalar o tabcmd. Em sistemas semelhantes ao Debian, você precisa instalar o Java 11 separadamente, se ele ainda não estiver instalado.

A partir de julho de 2022, as distribuições Debian não são mais aceitas. Para obter mais informações, consulte a postagem da Comunidade do Tableau(O link abre em nova janela).

O Java não está instalado

Se você receber erros semelhantes a este ao instalar tabcmd, confirme se o Java 11 está instalado no seu computador Linux:

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

Versão incorreta do Java instalada

Se você receber erros semelhantes a estes, confirme se o Java 11 está instalado:

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

ou.

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.