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.

Windows

  1. Como administrador, execute o arquivo .exe do instalador na linha de comando do computador.
    Caso precise extrair os arquivos .msi, siga as instruções na seção Extrair e executar o instalador do Windows (MSI) deste artigo.

    A sintaxe para execução do instalador do Tableau na linha de comando é:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe: esse é o instalador do Tableau para o produto e a versão que você está instalando.

    • Opções: as opções usadas especificam como o processo de instalação deve ser executado. Por exemplo, se deve exibir a saída durante a instalação ou se deve criar arquivos de log. Consulte as Opções do instalador para obter a lista de opções disponíveis.

    • Propriedades: essas definições especificam as configurações que o instalador deve fazer durante o processo de instalação. Consulte as Propriedades do instalador para obter a lista de propriedades disponíveis.
  2. Execute o comando do diretório onde o arquivo .exe está localizado ou especifique o caminho completo para o local do arquivo .exe no computador. Não execute o programa de instalação em um diretório compartilhado na sua rede. Em vez disso, baixe o arquivo .exe em um diretório no computador onde a instalação está em execução.

    Exemplo

    O exemplo a seguir mostra um comando do instalador com algumas opções e configurações de propriedade.

    tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 AUTOUPDATESERVER="assets.intranet.lan" REPORTINGSERVER="http://mytableau"

    O comando no exemplo faz o seguinte:

    • Instala a versão de 64 bits do Tableau Desktop 2021.4.4

    • Executa o instalador em modo silencioso, o que significa que o processo de instalação não exibe prompts, IU ou a caixa de diálogo da licença.

    • Define a instalação para concluir sem reiniciar.

    • Aceita o Contrato de licença do usuário final (EULA).

    • Configura um servidor de atualização do produto não padrão.

    • Configura o produto para enviar relatórios de licenciamento a um Tableau Server interno.

Mac

Importante: instale apenas o Tableau na unidade raiz para que o FlexNet e os drivers de dispositivo instalem no local correto.

  1. Faça upload de uma cópia do arquivo DMG do Tableau Desktop para um compartilhamento de rede e diga aos usuários para baixá-lo nos seus computadores Mac desse local. Você pode seguir as instruções para concluir a instalação.

    Você pode criar um script .sh que monta o arquivo DMG e copia o Tableau para os computadores do seu usuário. Os exemplos a seguir mostram um script que realiza esta tarefa para diferentes versões do Tableau Desktop.

    Exemplo: Tableau Desktop versão 10.2 e posterior

    #!/usr/bin/env bash
    # mount the DMG and copy Tableau.app to a folder
    output=`yes | hdiutil attach "<DMG_name>.dmg"`
    sleep 10
    volName=`echo "$output" | tail -n 1 |sed 's;^.*\(/Volumes.*$\);\1;'`
    open "/Volumes/Tableau/Tableau Desktop.pkg"
    # dismount the Tableau DMG volume
    hdiutil detach """${volName}""" -force
  2. (opcional) Execute o aplicativo do instalador para realizar uma instalação silenciosa. Em um prompt do terminal digite o seguinte:

    sudo installer -pkg <path and name of .pkg file> -target /

    Será solicitada uma senha de administrador e, em seguida, será realizada uma instalação silenciosa. Você verá essas três linhas: .

    • installer: Package name is Tableau Desktop

    • installer: Upgrading at base path /
    • installer: The upgrade was successful.

Selecionar os drivers para instalar automaticamente

Por padrão, diversos drivers de fonte de dados são instalados automaticamente no Tableau Desktop. Para uma lista completa, consulte Antes da instalação.

Observação: a partir da versão 2019.4, somente o driver PostgreSQL é instalado automaticamente no Mac.

Para evitar que um ou todos os drivers sejam instalados automaticamente, execute o aplicativo do instalador do Mac no arquivo Desktop.pkg com ‑showChoiceChangesXML para gerar um arquivo plist que contém todas as personalizações possíveis. A sintaxe é:

installer -showChoiceChangesXML -pkg <path and name of .pkg file> –target / > <name of plist>

Exemplo:

installer -showChoiceChangesXML -pkg Install\ Tableau\ Desktop.pkg –target / > InstallTableauDesktopChoices.xml

Para o driver da Oracle, a seção no arquivo plist resultante é semelhante ao seguinte:

                            

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

Para impedir que um driver seja instalado, faça o seguinte:

  1. No arquivo .plist, altere o valor de <integer> de 1 para 0 para os drivers que não deseja instalar automaticamente.

  2. Salve o arquivo e mova-o para o instalador, adicionando-o à linha de comando usando o comando a seguir:

    -applyChoiceChangesXML <pathToXMLFile>

Após a criação do arquivo plist com as modificações desejadas, a linha de comando se parecerá com isso:

sudo installer -pkg Install\ Tableau\ Desktop.pkg -applyChoiceChangesXML InstallTableauDesktopChoices.xml -pkg -target /

Para obter a documentação da aplicação do Instalador do Mac, consulte a documentação do Desenvolvedor da Apple(O link abre em nova janela).

Desabilitar o atalho da área de trabalho

Para impedir que o instalador do Tableau crie um atalho do Tableau Desktop, gere o arquivo XML seguindo os passos da seção anterior e altere o valor do inteiro de 0 para 1 na seção a seguir.

                            

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

Observação: esta opção está disponível apenas para o Windows.

  1. Como administrador, execute o arquivo .exe do instalador na linha de comando do computador.

    A sintaxe para execução do instalador do Tableau na linha de comando é:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe: esse é o instalador do Tableau para o produto e a versão que você está instalando.

    • Opções: as opções usadas especificam como o processo de instalação deve ser executado. Por exemplo, se deve exibir a saída durante a instalação ou se deve criar arquivos de log. Consulte as Opções do instalador para obter a lista de opções disponíveis.

    • Propriedades: essas definições especificam as configurações que o instalador deve fazer durante o processo de instalação. Consulte as Propriedades do instalador para obter a lista de propriedades disponíveis.
  2. Execute o comando do diretório onde o arquivo .exe está localizado ou especifique o caminho completo para o local do arquivo .exe no computador. Não execute o programa de instalação em um diretório compartilhado na sua rede. Em vez disso, baixe o arquivo .exe em um diretório no computador onde a instalação está em execução.

    Exemplo

    O exemplo a seguir mostra um comando do instalador com algumas opções e configurações de propriedade.

    tableauPrepBuilder-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

    O comando no exemplo faz o seguinte:

    • Instala o Tableau Prep Builder 2021.4.4.

    • Executa o instalador em modo silencioso, o que significa que o processo de instalação não exibe prompts, IU ou a caixa de diálogo da licença.

    • Define a instalação para concluir sem reiniciar.

    • Aceita o Contrato de licença do usuário final (EULA).

    • Define o relatório de erros como desativado.

    • Define o relatório de uso como desativado

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.
Agradecemos seu feedback!