Automatizar tarefas de licenciamento

Várias opções de linha de comando permitem realizar as tarefas comuns de licenciamento do Tableau Server com scripts automatizados.

Se você desejar executar essas tarefas de licenciamento do Tableau Desktop com scripts automatizados, consulte Implantar o Tableau Desktop(O link abre em nova janela) no Guia de implantação do Desktop.

Opções da ferramenta de linha de comando e uma melhor automação do script

É possível usar um utilitário chamado tabinstallck.exe para criar scripts de ativação, atualização e desativação das chaves do produto do servidor. tabinstallck.exe é instalado no diretório \bin do Tableau Server no nó inicial. Por padrão, ele é:

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

Também é possível usar tsm licenses para executar tarefas de licenciamento, como ativar ou desativar uma chave do produto do Tableau Server on-line ou off-line e obter arquivos relacionados para ativação ou desativação off-line. No entanto, Tableau Server já deve estar implantado e configurado. Automatize essas tarefas de licenciamento usando a API do Gerenciador de serviços do Tableau. Além disso, tabinstallck.exe oferece uma maneira de fazer o script da etapa de licenciamento de uma nova instalação do Tableau Server que não está totalmente configurada.

Para usar tabinstallck.exe, execute os comandos ou crie scripts como um administrador no nó do Tableau Server primário.

Observação: o tabinstallck.exe não é compatível com ativação e desativação off-line. Para saber mais, consulte Ativar o Tableau Server offline.

Operações da chave do produto com servidores proxy de encaminhamento

Se o computador onde estiver executando o Tableau Server tiver sido configurado para se conectar à Internet por meio de um proxy de encaminhamento, siga o procedimento no tópico, Configurar operações da chave do produto com proxy de encaminhamento, antes de tentar ativar, atualizar ou desativar chaves do produto.

Ativar

Ative uma licença do Tableau Server com a opção -activate:

start/wait tabinstallck.exe -activate <product_key>

Atualizar

Atualize uma licença do Tableau Server com a opção -refresh:

start/wait tabinstallck.exe -refresh <product_key>

Desativar

Desative uma licença do Tableau Server com a opção -return:

start/wait tabinstallck.exe -return <product_key>

Exemplo

Veja o exemplo de um script para ativar o Tableau Server:

@echo off
start/wait tabinstallck.exe -activate <product_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

Solução do Erro

Quando você usa tabinstallck.exe para automatizar tarefas de licenciamento do Tableau Server, as informações de status são retornadas como um código de saída na variável de ambiente ERRORLEVEL. Se a ativação tiver êxito, o código de saída será 0 (zero). A tabela abaixo lista os códigos de saída do processo de ativação e os respectivos significados. Você também pode encontrar informações de erros no arquivo tabinstallck.log. Esse arquivo de log está na pasta \logs do Tableau Server, por padrão:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\

A pasta ProgramData fica oculta por padrão.

Este script de exemplo mostra como ativar o Tableau Server 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 tabinstallck.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)
Código de saídaMensagemValor
536871012TABLEAU_ERROR_LICENSING_GENERALOcorreu um erro desconhecido durante a operação de licenciamento.
536871013TABLEAU_ERROR_LICENSING_INTERNALO produto não pode ser iniciado devido a um erro de licenciamento interno.
536871014TABLEAU_ERROR_LICENSING_SETUPO produto não pode ser iniciado devido a um erro de licenciamento interno.
536871015TABLEAU_ERROR_LICENSING_CONNECTErro ao entrar em contato com o servidor de licenças do Tableau.
536871017TABLEAU_ERROR_LICENSING_ACTIVATION_ASRErro ao ativar o ASR.
536871016TABLEAU_ERROR_LICENSING_ACTIVATION_GENERALFalha na ativação, tente novamente.
536871018TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEYChave do produto inválida.
536871019TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINENão é possível concluir a ativação offline.
536871020TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODELUm erro foi retornado do servidor de licenças. Verifique o arquivo de registro do Tableau para obter mais informações.
536871021TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTSFalha ao desativar a licença porque você chegou ao limite de desativações dessa licença.
536871033TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONSFalha ao ativar a licença porque você chegou ao limite de ativações dessa licença.
536871022TABLEAU_ERROR_LICENSING_UNLICENSED_GENERALOcorreu um erro desconhecido durante a operação de desativação do licenciamento. Verifique sua chave de produto ou entre em contato com o suporte.
536871023TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUNDNenhuma licença encontrada.
536871024TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIREDSomente chaves de produto expiradas foram encontradas.
536871025TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIALSua avaliação dessa versão terminou.
536871026TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTIONA chave de produto expirou.
536871027TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCEA manutenção expirou.
536871028TABLEAU_ERROR_LICENSING_RESYNC_GENERALNão foi possível sincronizar suas chaves de produto.
536871029TABLEAU_ERROR_LICENSING_REGISTRATION_GENERALOcorreu um erro durante o registro do produto.
536871030TABLEAU_ERROR_LICENSING_SERVICE_INSTALLOcorreu um erro desconhecido durante as operações de licenciamento.
536871031TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALLOcorreu um erro desconhecido durante as operações de licenciamento.
536871032TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENTO serviço de licenciamento FLEXnet não está presente no sistema.
Agradecemos seu feedback!Seu feedback foi enviado. Obrigado!