Guia de implantação do Tableau

Este artigo descreve como usar a linha de comando para instalar o Tableau Desktop, Tableau Prep Builder e Tableau Desktop Public Edition e executar outras ações de instalação, como ativação e registro, além de como desinstalar o produto.

Para obter informações mais detalhadas sobre como localizar o instalador e a chave do produto, consulte Onde está o instalador? e Localizar a chave do produto.

Observação: se você estiver atualizando, consulte Atualizar o Tableau Desktop e o Tableau Prep Builder para obter informações sobre como se preparar para uma atualização.

Por padrão, o Tableau habilita determinados recursos, como relatórios de uso ou atualizações automáticas de produtos (somente no Tableau Desktop). Para obter informações sobre como desativar esses recursos e mais, consulte Alterar as configurações de instalação após a instalação(O link abre em nova janela).

Antes de começar

• Compatibilidade com o servidor: os produtos do Tableau nem sempre são lançados ao mesmo tempo. Ao instalar uma nova versão do Tableau Desktop, verifique se ela é compatível com o Tableau Server. Consulte Encontrar e resolver problemas de compatibilidade.
• Instalar o Desktop e o Prep no mesmo computador: o Tableau Prep Builder foi projetado para funcionar com o Tableau Desktop. É recomendável instalar o Tableau Prep Builder no mesmo computador que tenha o Tableau Desktop.
• Não instale o Tableau Prep Builder no mesmo computador que executa o Tableau Server: o Tableau Server Resource Manager (SRM) não consegue distinguir entre o processo do servidor de protocolo do Tableau Server e o processo do servidor de protocolo do Tableau Prep Builder. Se os recursos do computador forem esgotados, o SRM poderá terminar o processo de servidor de protocolo que pertence ao Tableau Prep Builder, que não possui mecanismo de recuperação.
• Requisito do instalador do Windows: se estiver usando uma ferramenta de implantação que requer o instalador do Windows (arquivo .msi) para instalar o Tableau Desktop ou o Tableau Prep Builder, siga as instruções em Extrair e executar o instalador do Windows (MSI) para extrair o arquivo .msi do arquivo .exe do instalador do Tableau.

Clique na guia abaixo do produto que está instalando para exibir as etapas de instalação.

<dict>
	<key>attributeSetting</key>
	<integer>1</integer>
	<key>choiceAttribute</key>
	<string>selected</string>
	<key>choiceIdentifier</key>
	<string>com.tableau.oracle</string>
</dict>

<dict>
	<key>attributeSetting</key>
	<integer>0</integer>
	<key>choiceAttribute</key>
	<string>selected</string>
	<key>choiceIdentifier</key>
	<string>com.tableau.desktopShortcut</string>
</dict>

Extrair e executar o instalador do Windows (MSI)

Se você estiver usando uma ferramenta de implementação que exija o instalador do Windows (arquivo .msi) para instalar o Tableau Desktop ou o Tableau Prep Builder, é possível extrair o arquivo .msi do arquivo .exe do instalador do Tableau. Ao extrair o arquivo .msi, você visualizará o arquivo .msi do instalador mais os arquivos .msi para cada driver de banco de dados incluído no processo de instalação do Tableau Desktop.

Para extrair o arquivo .msi, você pode usar uma ferramente terceirizada como a WiX Toolset.

Isenção de responsabilidade: esta solução contém informações sobre um produto de terceiros. Apesar de fazermos todo o esforço para manter a precisão das referências a conteúdo de terceiros, as opções do WiX Toolset podem ser alteradas sem aviso prévio. Para obter as informações mais atualizadas, consulte a documentação do WiX. Para obter ajuda com os utilitários do WiX, entre em contato com a mala direta de usuários do WiX.

1. No computador onde foi baixado o instalador do Tableau, baixe e instale a última versão do conjunto de ferramentas WiX do site da Web do WiX (http://wixtoolset.org/(O link abre em nova janela)).

2. Abra um prompt de comando como um administrador e navegue para a raiz da pasta em que o WiX Toolset foi instalado.

3. Execute o seguinte comando:

   Dark.exe <path_to_the_Tableau_exe_installer> -x <output_folder>

   Por exemplo, execute o comando a seguir:

   Dark.exe C:\tableau-setup-std-tableau-2021-1.21.0125.1838-x64.exe -x c:\output

A pasta de saída conterá uma pasta chamada AttachedContainer que inclui os arquivos .msi necessários.

Ativar o Tableau Desktop e o Tableau Prep Builder

Após a instalação do Tableau Desktop ou Tableau Prep Builder, você pode ativar usando gerenciamento de licenças baseadas em logon ao entrar em Tableau Cloud ou Tableau Server. Caso contrário, você precisa fornecer uma chave do produto para ativar o produto, enviando uma solicitação de ativação ao Tableau. É possível inserir uma chave do produto na linha de comando durante a instalação (Windows) ou depois (Windows e Mac).

Para automatizar esse processo durante a instalação, adicione uma única linha de comando que inclua a opção do instalador ACTIVATE_KEY "<key>” e insira a chave do produto entre aspas. O instalador aplica a chave do produto como parte do processo de instalação.

Para automatizar o processo, após a instalação, execute o Tableau.exe ou o Tableau Prep Builder.exe com a opção -activate <key>, por exemplo tableau.exe -activate <my_product_key> .

Observação: caso queira ativar o Tableau Server usando scripts automáticos, consulte Automatizar tarefas de licenciamento(O link abre em nova janela) na Ajuda do Tableau Server.

Windows

Execute tableau.exe ou Tableau Prep Builder.exe com a opção -activate e uma chave do produto.

Por exemplo:

Tableau Desktop: "C:\Program Files\Tableau\Tableau <version>\bin\tableau.exe" -activate <product_key>

Tableau Prep Builder: “C:\Program Files\Tableau\Tableau Prep Builder <version>\Tableau Prep Builder.exe" -activate <product_key>

Mac

Inicie o executável do Tableau ou do Tableau Prep Builder com a opção -activate e uma chave do produto no caminho /Applications.

Por exemplo:

Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

Para obter mais informações sobre os códigos de saída que você pode capturar e avaliar em caso de falha do licenciamento, consulte Solucionar problemas de erros de ativação usando os códigos de saída de ativação no artigo de solução de problemas neste guia.

Registrar o Tableau Desktop e o Tableau Prep Builder

Você pode garantir o registro consistente na sua empresa ao automatizar a tarefa de registro de cópias individuais do Tableau. Para automatizar este processo no Windows, adicione uma única linha de comando que inclua a opção REGISTER= “1” do instalador. O instalador executa -register e registra o produto.

Para registrar o Tableau usando a linha de comando, é necessário preencher previamente os valores de registro (Windows) ou .plist (Mac) em cada computador que executará o Tableau Desktop e Tableau Prep Builder. No Windows, é possível acionar este processo durante a instalação. No Windows e no Mac, é possível realizar o processo de instalação e depois usar a opção da linha de comando para efetuar o registro. Quando o Tableau inicia, ele lê as informações de registro e registra o Tableau para aquele usuário.

As informações de registro são armazenadas no computador em que o Tableau está instalado.

• Windows: as informações estão no registro.

• Mac: as informações estão no arquivo da lista de propriedades (.plist).

As informações de registro incluem campos de local que podem ser os mesmos para vários usuários (por exemplo, city, country e zip) e os campos que são normalmente exclusivos de cada usuário (e-mail, first_name, last_name, title).

Para o Tableau Desktop, você deve incluir os campos "opt_in" e"privac_consent" para registrar com sucesso o produto usando a opção de linha de comando.

As informações de registro são salvas em um dos locais a seguir:

• Windows. Registro: HKEY_CURRENT_USER\Software\Tableau\Registration\Data

• Mac. .plist local do arquivo: /Users/<user_name>/Library/Preferences/<.plist_file_name>

A forma mais fácil de preencher previamente os valores de registro ou de lista de propriedades em vários computadores é instalar e registrar manualmente o Tableau em um computador e usar as entradas de registro ou o arquivo de lista de propriedade preenchido pelo processo como um modelo para atualizar o registro em outros computadores.

Windows

Registre o Tableau e crie um modelo

1. Como administrador do computador, faça um backup do arquivo de registro antes de alterá-lo.

2. Instale e registre manualmente o produto em pelo menos um computador com Windows. Você pode usar as informações de registro como um modelo ao instalar o Tableau em outros computadores.

   As informações de registro são salvas no registro do Windows na chave a seguir:

   HKEY_CURRENT_USER\Software\Tableau\Registration\Data

3. Exporte os dados (chave) para um arquivo de texto de registro.

4. Crie um script que faça o seguinte:

   1. Faz uma cópia do arquivo de texto de registro do modelo e atualiza os campos exclusivos para um usuário.

   2. Copia o arquivo de texto de registro atualizado para o computador do usuário.

   3. Atualiza o registro naquele computador.

   Os campos que você atualiza dependerão das informações que deseja enviar com o registro. Para obter informações sobre como automatizar atualizações no registro, consulte a documentação da Microsoft.

   A seguir mostra um exemplo dos valores de registro que você poderá encontrar no arquivo de registro:

   [HKEY_CURRENT_USER\Software\Tableau\Registration\Data]
"campaign_id"=""
"company"=""
"country"=""
"db_title"=""
"department"=""
"elqCustomerGUID"=""
"elqFormName"=""
"email"=""
"first_name"=""
"form_environment"=""
"form_variant"=""
"ga_client_id"=""
"job_role"=""
"last_name"=""
"lead_source"=""
"lead_source_detail"=""
"phone"=""
"product_key"=""
"product_name"=""
"state"=""
"title"=""
"zip"=""
"registration_date"=""
"city"=""
"industry"=""
"opt_in"=""
"privac_consent"=""
   

Use o modelo para registrar o Tableau em outro computador

1. Em outro computador, instale o Tableau Desktop ou Tableau Prep Builder.

2. Execute o tableau.exe ou o Tableau Prep Builder.exe com a opção -register.

   Por exemplo:

   Tableau Desktop: "Program Files\Tableau\Tableau <version>\bin\tableau.exe -register"

   Tableau Prep Builder: "Program Files\Tableau\Tableau Prep Builder<version>\Tableau Prep Builder.exe -register"

   Caso o registro seja bem-sucedido, o arquivo de registro da instalação terá uma entrada:

   Current registration state: complete / not needed

   Se o registro não for bem-sucedido, o Tableau fechará com o código de erro: error 117. Você também pode verificar o arquivo de registro, que tem informações sobre campos inválidos ou ausentes. O arquivo de registro está neste local:

   Documentos >Meu repositório do Tableau ou Meu repositório do Tableau Prep Builder > Logs> log.txt

   Se o registro falhar, o script automatizado que você criou precisa ser atualizado. Para obter dicas de solução de problemas, consulte Solucionar problemas na instalação do Tableau Desktop ou do Tableau Prep Builder.

Mac

Registre o Tableau e crie um modelo

Para registrar o Tableau Desktop ou o Tableau Prep Builder no Mac, é possível usar o Xcode ou o comando defaults para atualizar o arquivo da lista de propriedade a seguir: com.tableau.Registration.plist.

É possível encontrar mais informações sobre como editar os arquivos da lista de propriedade OS X no Suporte da Apple.

1. Instale e registre manualmente o produto em pelo menos um computador Mac. Isso cria o arquivo .plist, que pode ser usado como um modelo para registrar o Tableau Desktop ou o Tableau Prep Builder em outros computadores.

2. Vá para /Users/<user_name>/Library/Preferences e faça um backup do arquivo com.tableau.Registration.plist que você deseja usar como modelo.

3. Copie o arquivo de modelo com.tableau.Registration.plist para a pasta /Users/<user_name</Library/Preferences no Mac em que você deseja instalar o Tableau Desktop.

4. Execute o seguinte comando:

   cd /Users/<user_name>/Library/Preferences

   Por exemplo:

   cd /Users/agarcia/Library/Preferences

5. Para cada chave .plist que deseja atualizar, execute o comando a seguir:

   defaults write com.tableau.Registration.plist <key_value>

   Por exemplo:

   defaults write com.tableau.Registration.plist Data.first_name Ashley

   defaults write com.tableau.Registration.plist Data.last_name Garcia

Use o modelo para registrar o Tableau em outro computador

• Em outro computador, instale o Tableau Desktop ou Tableau Prep Builder.

  Durante a instalação, o assistente de ativação solicita uma chave do produto. Se você sair do programa antes de concluir a ativação ou registro, ou estiver fazendo uma instalação silenciosa, inicie o aplicativo Terminal e, em seguida, execute os comandos a seguir:

  • Para ativar o Tableau Desktop ou o Tableau Prep Builder, use o comando a seguir:

    Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

    Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

  • Para registrar o Tableau Desktop ou o Tableau Prep Builder, use o comando a seguir:

    Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS./Tableau" –register

    Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –register

Desinstalar o Tableau Desktop e o Tableau Prep Builder

Embora não seja necessário desinstalar as versões anteriores do Tableau Desktop e do Tableau Prep Builder ao instalar uma versão mais recente, é possível desinstalar qualquer versão desses aplicativos caso não as queira mais no seu computador.

Windows

Para desinstalar silenciosamente o Tableau Desktop ou o Tableau Prep Builder usando a linha de comando, faça o seguinte:

1. Abra o prompt de comando como um administrador.

2. No local em que o .exe estiver instalado, execute o comando a seguir:

   TableauDesktop-<product_installer_name>.exe /uninstall /quiet

   ou

   TableauPrepBuilder-<product_installer_name>.exe /uninstall /quiet

   Por exemplo:

   Downloads\TableauPrepBuilder-2021-1-4.exe /uninstall /quiet

Para desinstalar várias versões do Tableau Desktop na linha de comando, faça o seguinte:

Observação: essa opção está disponível apenas para o Tableau Prep Builder.

1. Instale a versão mais recente do Tableau Desktop com a opção REMOVEINSTALLEDAPP.

   Por exemplo: tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 REMOVEINSTALLEDAPP=1

2. Confirme se todas as versões mais antigas estão desinstaladas, exceto a versão mais recente.

3. Desinstale a versão anterior. Por exemplo: tableauDesktop-64bit-2021-4-4.exe /uninstall /quiet /norestart

4. Remova todas as pastas não utilizadas de acordo com as etapas em Remover completamente o Tableau Desktop(O link abre em nova janela).

Mac

Para desinstalar o Tableau Desktop no Mac, faça o seguinte:

1. Se for necessária uma desativação ou devolução de uma chave do produto, execute a opção -return no objeto Tableau no caminho /Applications. Para obter mais informações, consulte Mover ou desativar chaves do produto.
2. Arraste o aplicativo e o atalho da área de trabalho (se houver algum) até a pasta da lixeira e, em seguida, esvazie a lixeira.
3. Desinstale os drivers instalados automaticamente.

Outros artigos nesta seção