Solucionar problemas na instalação do Tableau Desktop ou do Tableau Prep Builder

Ao instalar o Tableau Desktop ou o Tableau Prep Builder, a instalação nem sempre pode ocorrer conforme planejado. Neste artigo, você pode encontrar informações sobre como solucionar problemas que possa encontrar e sugestões sobre como resolvê-los.

Pesquisar a Base de dados de conhecimento de suporte

Para ajudar você a encontrar a resposta para suas perguntas rapidamente, você pode pesquisar na Base de dados de conhecimento do Tableau. A Base de dados de conhecimento contém técnicas de solução de problemas que você pode usar para corrigir problemas, descreve problemas conhecidos que foram resolvidos e fornece respostas para perguntas frequentes.

1. Para pesquisar artigos de solução de problemas, acesse a Base de dados de conhecimento.
2. Digite uma descrição.
3. Na página Suporte, escolha Base de dados de conhecimento na guia Origem.

Reparar uma instalação (somente Windows)

Um reparo de uma instalação é o processo de instalação de uma nova compilação da mesma versão sobre a instalação existente. Reparar uma instalação mantém o software em estado de funcionamento substituindo os arquivos alterados e reinstalando os arquivos ausentes.

Para executar um reparo de uma instalação:

1. Vá para Painel de controle > Programas > Programas e recursos.
2. Selecione o programa Tableau na lista.
3. Clique com o botão direito do mouse em Desinstalar/Alterar.
4. Na janela Modificar configuração exibida, clique em Reparar e permita que o processo de reparo seja concluído.

Criar um log de instalação

Se você estiver trabalhando com o Suporte do Tableau, eles poderão solicitar arquivos de registro da sua instalação. O Tableau Desktop ou o Tableau Prep Builder pode manter um registro do processo de instalação. O registro está ativado por padrão para o instalador do Tableau para Windows e Mac. Por padrão, os arquivos de registro são armazenados na pasta temporária do usuário (a localização especificada na variável de ambiente %temp%) do Windows e em /private/var/log no Mac. É uma boa ideia manter os arquivos de registro para o processo de instalação, a fim de ajudá-lo a solucionar problemas caso algo saia errado. Se houver erros, você pode revisar o arquivo de registro e procurar entradas que incluam Error ou Fail para ajudar a identificar o problema.

Observação: ao fazer login noDEBUG nível, as informações completas do ambiente são coletadas quando o Tableau é iniciado. Isso significa que, se você tiver informações confidenciais em uma variável de ambiente, elas poderão ser incluídas em um registro. Registrar no nível INFO padrão apenas reúne informações de ambiente seguro.

Caso queira alterar o local ou o nome dos arquivos de registro ou não tenha certeza se o registro está ativado, conclua as etapas a seguir. Ative o registro antes de iniciar a instalação.

1. Baixe o instalador (arquivo .exe).

2. Abra uma janela de comando como administrador.

3. Navegue até o diretório onde você baixou o arquivo do instalador.

4. Execute o seguinte comando:

   <installer> /log "<log_file_path_and_name>"

   Substitua installer pelo nome do arquivo do instalador do Tableau e substitua log_file_path_and_name pelo caminho e nome do arquivo em que deseja que o arquivo de registro de instalação seja salvo.

   Por exemplo:

   tableauDesktop-64bit-2021-3-1.exe /log "C:\Users\henryw\Desktop\install.txt".

Solucionar erros de licenciamento FLEXnet ao ativar ou abrir o Tableau Desktop ou o Tableau Prep Builder

Se o serviço de licenciamento do Tableau não puder ler ou acessar a chave do produto, ocorrerá um dos seguintes erros:

• Nenhuma licença encontrada para 'TableauDesktop'

• Não é possível adicionar a licença

• Function flxActCommonLicSpcPopulateFromTS retornou o erro 50030, 71521, 0

Para solucionar o erro, tente as etapas nesta seção, na ordem mostrada.

1. Verifique a data e a hora do sistema

Verifique se a data e a hora no seu computador estão definidas para data atual. Se o relógio no seu computador estiver definido para uma data anterior à data atual, o Tableau não poderá ser ativado.

2. Verifique se o serviço de licenciamento FlexNet está instalado

Quando você instala o Tableau Desktop, o serviço de licenciamento FlexNet é automaticamente instalado. O Tableau precisa deste serviço para ser executado. Quando você instala o Tableau Desktop no Mac, pode ser solicitado a inserir a sua senha para conceder ao instalador a permissão de instalar o FlexNet. Para o Windows, a permissão de instalar o FlexNet está embutida nas configurações da conta de usuário.

Para verificar se o serviço de licenciamento está corretamente instalado no seu computador, conclua as etapas a seguir:

Windows

1. Navegue para a pasta a seguir:

   C:\Program Files\Common Files\Macrovision Shared\FlexNet Publisher

2. Verifique se o aplicativo FNPLicensingService está na pasta.

   Se o serviço de licenciamento do FlexNet não estiver instalado, tente reinstalar o Tableau Desktop ou verifique as configurações de permissão de conta de usuário.

Mac

1. Inicie o aplicativo Terminal.

2. Digite o comando a seguir para listar o conteúdo do diretório FlexNet:

   ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

   Se o comando não retornar algo, ou se retornar a mensagem No such file or directory, o serviço de licenciamento não está instalado. Para obter informações sobre como instalar manualmente o serviço de licenciamento FlexNet, consulte Erro: "o serviço de licenciamento FLEXNet não está presente no sistema"de ativação no Mac(O link abre em nova janela) na Base de dados de conhecimento do Tableau.

3. Verifique se o serviço de licenciamento FlexNet está sendo executado

Se você verificou que o serviço de licenciamento FlexNet está instalado, confirme se ele está sendo executado. Se não estiver, talvez seja necessário iniciá-lo manualmente. Para isso, conclua as etapas abaixo de acordo com o seu sistema operacional e, em seguida, reinicie o Tableau Desktop.

Windows

1. 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 está Iniciado.

   Se a opção Iniciar estiver esmaecida, clique com o botão direito no serviço de licenciamento FlexNet na lista e selecione Propriedades. Na guia Geral, clique em Iniciar e, em seguida, em OK para fechar a caixa de diálogo.

Mac

1. Inicie o aplicativo Terminal.

2. Navegue até o diretório FlexNet:

   '/Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/'custactutil -view

   Por exemplo, '/Applications/Tableau Desktop 2021.3.app/Contents/Frameworks/FlexNet/'custactutil -view

3. Verifique se o serviço de licenciamento FlexNet está sendo executado. Você verá Trust Flags = FULLY TRUSTED e Status = ENABLED.

   

4. Em seguida, use este comando para salvar a saída em um arquivo na sua área de trabalho:

   /Applications/Tableau\ Desktop\ <Tableau version.app>/Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

4. Conserte o armazenamento confiável

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 consertar as informações da chave localizadas e salvas no armazenamento confiável.

Observação: você precisará de acesso ao Utilitário de ativação do cliente localizado na pasta bin para realizar essas etapas.

Windows

1. Abra uma janela de comando e acesse o diretório onde está o Utilitário de ativação do cliente. Por exemplo:

   cd "C:\Program Files\Tableau\Tableau <version>\bin"

   onde <version> é a versão de produto do Tableau que você instalou.

2. Digite o seguinte comando:

   custactutil –localrepair

3. Inicie o Tableau.

   Se o reparo não for bem-sucedido, digite o comando a seguir para criar um arquivo LicResults.txt:

   custactutil -view >LicResults.txt

   Entre em contato com o Suporte técnico(O link abre em nova janela) e inclua o arquivo LicResults.txt que você criou.

Mac

1. Inicie o aplicativo Terminal.

2. Navegue até o diretório FlexNet:

   cd /Applications/Tableau Desktop <version>.app>/Contents/Frameworks/Flexnet

3. Insira o seguinte comando:

   ./custactutil -localrepair

4. Inicie o Tableau.

Se o reparo não for bem-sucedido, digite o comando a seguir para criar um arquivo LicResults.txt:

./custactutil -view > /users/<username>/licresults.txt

Entre em contato com o Suporte técnico(O link abre em nova janela) e inclua o arquivo LicResults.txt que você criou.

Solucionar problemas de erros de ativação usando os códigos de saída de ativação

Quando você inicia o Tableau e inclui a opção -activate, o processo de ativação retorna as informações de status ao definir a variável de ambiente ERRORLEVEL para um código de saída. Se a ativação tiver êxito, o código de saída do aplicativo Tableau é 0 (zero). A tabela abaixo lista os códigos de saída do processo de ativação e os respectivos significados.

Se ativação falhar, você também poderá localizar as informações de erro no arquivo de log do Tableau. Os arquivos de registro localizados na pasta Logs na pasta My Tableau Repository dentro da pasta Documents do usuário atual. Por exemplo:

/Users/<user>/Documents/My Tableau Repository/Logs

O script de exemplo a seguir mostra como ativar o Tableau Desktop para Windows e verificar se há erros específicos, como uma chave de produto inválida (536871018) e problemas de licenciamento gerais (536871012).

@echo off
start/wait tableau.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

Solucionar problemas de erros de Internet

O Tableau Desktop e o Tableau Prep Builder requer determinadas configurações de firewall e proxy para carregar visualizações de mapa, carregar páginas da Web e processar solicitações de licença. Se você encontrar um dos erros a seguir, o administrador da rede da empresa precisa alterar as configurações de proxy e firewall da Web da rede.

• O processo de licenciamento solicita uma ativação offline.

• As visualizações de mapa aparecem em branco no Tableau Desktop.

• Há falha no carregamento das páginas da Web nos painéis.

• O mapa online não pôde ser carregado.

Para obter informações sobre como configurar o acesso à Internet para o Tableau Desktop, consulte Endereços, proxies e portas solicitados

Solucionar problemas de acesso ao 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 precisarão ser atualizados para que você possa ativar, atualizar ou desativar uma chave do produto do Tableau.

Para verificar se esse é o problema:

1. Em um navegador da Web, navegue até os seguintes endereços:

   • https://licensing.tableau.com

   • https://licensing.tableau.com

     Você deve ver uma página de "Teste realizado com sucesso".

2. Caso não veja a página de resultado, talvez seja necessário atualizar o ambiente local para acessar os serviços de licenciamento. Para obter mais detalhes, consulte a Comunidade do Tableau(O link abre em nova janela).

Solucionar problemas de relatório de licença (somente Tableau Desktop)

Quando instâncias do Tableau Server e do Tableau Desktop estão configuradas corretamente, as informações de utilização de licença do Tableau Desktop ficam disponíveis em duas exibições administrativas, Utilização de licença do Desktop(O link abre em nova janela) e Expiração de licença do Desktop(O link abre em nova janela). Se você não conseguir ver essas exibições, ou se elas não tiverem dados, pode haver um problema com a geração de relatórios de licenciamento. As seções abaixo podem ajudar a você solucionar a causa.

Para obter informações sobre como configurar os relatórios do Tableau Desktop consulte Gerenciar o uso da licença do Tableau Desktop.

As exibições administrativas não estão disponíveis

As exibições administrativas Relatório de licenciamento do Desktop estão disponíveis apenas para administradores do Tableau Server. Caso não veja links para as exibições Utilização de licença do Desktop e Expiração de licença do Desktop na página Status do servidor (selecione Gerenciar todos os sites no menu Sites), verifique o seguinte:

• Você está conectado como um administrador do Tableau Server.

• Se estiver executando uma versão do Tableau Server 10.0 ou posterior e os usuários estiverem executando o Tableau Desktop versão 10.0 ou posterior. O Relatórios de licenciamento do Tableau Desktop está disponível a partir da versão 10.0 do Tableau Server e do Tableau Desktop.

• O Relatório de licenciamento está habilitado no Tableau Server. (O recurso está desabilitado por padrão.) Para obter mais informações, consulte o procedimento para habilitar essa ferramenta no Tableau Server no artigo Gerenciar o uso da licença do Tableau Desktop neste guia.

As exibições administrativas não incluem o conteúdo esperado

Caso você não esteja vendo os dados esperados, isso ocorre devido a uma das razões listadas aqui.

O Tableau Desktop foi configurado há menos de oito horas

Por padrão, o Tableau Desktop faz o relatório dos dados de licenciamento em intervalos de oito horas. Não é possível visualizar os dados de utilização nas exibições administrativas se menos de oito horas tiverem passado desde que as instâncias do Tableau Desktop tiverem sido configuradas para relatório. Durante seu funcionamento, o Tableau Desktop gera relatórios a cada oito horas e a contagem começa quando você inicia uma instância devidamente configurada do Tableau Desktop.

Se o Tableau Desktop não estiver em execução ao final das oito horas, o relatório é enviado na próxima vez que o Tableau Desktop é iniciado. Aguarde um mínimo de oito horas depois que as instâncias do Tableau Desktop são configuradas antes de procurar essas licenças nas exibições do Relatório de licença do Desktop.

Os eventos a seguir forçam o relatório imediato de um Tableau Desktop configurado corretamente no Tableau Server:

• Ativar o Tableau Desktop versão 10.0 ou posterior.

• Desativar o Tableau Desktop versão 10.0 ou posterior.

• Renovar a manutenção em uma licença da versão 10.0 ou posteriores do Tableau Desktop.

O Tableau Desktop não foi reiniciado desde que o Relatórios de licenciamento foi configurado

Se o Tableau Desktop já estiver em execução quando o Relatórios de licenciamento foi configurado com um endereço de servidor ao qual se reportar, o Tableau Desktop precisa ser reiniciado.

O Tableau Desktop não foi aberto desde que foi configurado para o Relatórios de licenciamento

Se o Tableau Desktop não tiver sido aberto desde a configuração para geração de relatórios, os dados de utilização poderão não ser mostrados nas exibições administrativas. As informações de licença são relatadas somente quando o Tableau Desktop estiver executando.

O Tableau Desktop está configurado incorretamente para o Relatórios de licenciamento

Verifique se as instâncias do Tableau Desktop estão configuradas corretamente com o endereço do Tableau Server ao qual se reportar.

Use arquivos de registro no computador com Tableau Desktop para ajudar a determinar se a instância está configurada corretamente. Localize o arquivo %Documents%\My Tableau Repository\Logs\log.txt. Procure "licUsageReport" para encontrar entradas que abordem o Relatórios de licenciamento.

Mensagens de erro do Relatórios de licenciamento

A tabela a seguir lista mensagens de log que podem ajudar a identificar problemas com o Relatórios de licenciamento.

Alterar o intervalo de relatório padrão

Como padrão, quando configurado para relatório de licenciamento do Desktop, o Tableau Desktop envia o relatório a cada oito horas para o servidor ou servidores configurados. Você pode modificar o registro ou o arquivo .plist nos computadores do Tableau Desktop para alterar este intervalo. Isso é especialmente útil para solução de problemas.

Windows

Para alterar a frequência de relatório do Tableau Desktop para o servidor de um computador com Windows, edite o registro para adicionar um valor de cadeia de caracteres à chave ReportingServer:

• Caminho: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

• Nome: adicione um valor de cadeia de caracteres chamado scheduleReportInterval.

• Dados: a quantidade de tempo, em segundos, entre os relatórios enviados pelo Tableau Desktop ao servidor. Por padrão, é 8 horas e, se não houver especificação, esse padrão é usado. Se necessário, aumente esse valor para solução de problemas, mas lembre-se de que quanto mais frequente o intervalo, mais tráfego de rede será gerado.

  Por exemplo, a imagem a seguir mostra um registro configurado de modo que o Tableau Desktop envie um relatório aos Tableau Servers a cada hora (3.600 segundos):

  

Mac

Para alterar a frequência de envio de relatório do Tableau Desktop do servidor para o Mac, edite o arquivo com.tableau.ReportingServer.plist em /Library/Preferences e adicione uma chave scheduleReportInterval. Defina este comprimento de tempo, em segundos, entre os relatórios do Tableau Desktop para o Tableau Server configurado. O exemplo a seguir mostra o conteúdo de um arquivo .plist configurado para enviar informações a cada hora (3.600 segundos) para dois servidores, https://mytableau02:8010 e http://mytableau.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
    <dict>
      <key>Server</key>
      <string>https://mytableau02:8010,http://mytableau</string> 
      <key>scheduleReportInterval</key>
      <string>3600</string>
    </dict>
</plist>

Resolver erros de memória

Se o Tableau ficar sem memória no computador, ele exibe um erro de falta de memória. Os fatores a seguir podem afetar a memória ao usar o Tableau Desktop ou o Tableau Prep Builder.

• A versão do Tableau Desktop.

  • Se você instalar o Tableau Desktop de 64 bits em um sistema operacional Windows de 64 bits, o Tableau pode acessar até 8 TB de memória do sistema.

• O tamanho e o tipo de dados que você está analisando. Por exemplo, uma tabela de referência cruzada grande com muitas colunas e milhões de linhas de valores, ou uma exibição que mostra várias marcas pode acabar rapidamente com a memória.

• Outros aplicativos sendo executados no computador.

• O sistema operacional no computador.

Possíveis resoluções

Para resolver problemas de falta de memória, considere atualizar o seu sistema operacional ou a versão do Tableau para um computador de 64 bits. Isso permite que o Tableau acesse uma quantidade maior de memória do sistema.

Você também pode revisar os dados nas suas pastas de trabalho e como são agregados quando são mostrados nas exibições. Em vez de exibir muitas linhas de valores, o que pode exigir muita rolagem para analisar os dados, leve em consideração a exibição de dados resumidos. O Tableau Desktop é mais efetivo e usa menos memória quando os dados na exibição apresentam a ideia “geral” e permite que você e outras pessoas detalhem áreas específicas.

Para obter mais informações sobre como otimizar o desempenho da pasta de trabalho, consulte Otimizar o desempenho da pasta de trabalho(O link abre em nova janela) na Ajuda do Tableau.

Solucionar problemas ao abrir ou salvar arquivos em um computador Dell (somente Tableau Desktop)

Caso tenha instalado o Tableau Desktop em um computador Dell com uma versão mais antiga do aplicativo Dell Backup and Recovery (DBAR) instalada, é possível que o Tableau seja encerrado de maneira inesperada ao tentar abrir ou salvar uma pasta de trabalho ou ao tentar acessar uma fonte de dados. Isso acontece porque o software do Dell Backup and Recovery interfere nas operações de abrir e salvar da versão de 64 bits do Tableau Desktop. Para obter informações sobre como resolver esse problema, consulte o artigo Erro "o Tableau parou de funcionar" Abrir ou salvar arquivos em um computador Dell(O link abre em nova janela) na Base de dados de conhecimento do Tableau.

Solucionar problemas de atualizações de manutenção (somente Tableau Desktop)

O Tableau fornece atualizações de manutenção em intervalos regulares para todas as versões aceitas do Tableau Desktop. A tabela a seguir lista os motivos pelos quais as atualizações de manutenção podem não ser instaladas em uma versão específica do Tableau Desktop.