Instalar o Agente usando a linha de comando

Aplica-se a: Tableau Advanced Management

O Agente é um processo leve que consome recursos mínimos do servidor e envia dados ao Resource Monitoring Tool Server (RMT Server). Instale o Agente do Resource Monitoring Tool em cada um dos nós do Tableau Server. Para instalar e registrar um Agente, baixe o arquivo de configuração bootstrap do agente e salve-o em um local acessível a partir dos nós do agente Resource Monitoring Tool.

Este tópico descreve as etapas que você pode usar para instalar o Agente do Resource Monitoring Tool usando a linha de comando. A instalação da linha de comando é aceita em sistemas operacionais Windows e Linux.

Em um esforço para nos alinhar com os valores de Igualdade de nossa empresa, mudamos a terminologia não inclusiva sempre que possível. Como a alteração dos termos em determinados locais pode causar uma alteração significativa, mantemos a terminologia existente, Portanto, você pode continuar a ver os termos em comandos e opções da CLI, pastas de instalação e arquivos de configuração e outras instâncias. Para obter mais informações, consulte Sobre o Tableau help(O link abre em nova janela).

Antes da instalação

  • Faça download do arquivo de inicialização e salve-o em um local acessível aos nós nos quais você instalará o Agente RMT. Os arquivos de bootstrap são válidos apenas por 24 horas após o download. Você precisará gerar novamente o arquivo de bootstrap se aquele que você está usando tiver mais de 24 horas.
  • A partir da versão 2021.3, o registro do Agente precisará se comunicar por meio de um ponto de extremidade https e RabbitMQ para concluir o registro do Agente. Certifique-se de que ambas as portas 443 e 5672 estejam abertas para essas comunicações.

Para instalar e configurar o Agente:

  1. Baixe o arquivo bootstrap e salve-o em um local que pode ser acessado no Tableau Server.

    rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

  2. Execute o programa de instalação do Agente:

    1. Baixe o instalador do Agente e salve-o em um local que você pode acessar nas máquinas do Tableau Server.

    2. Abra o prompt de comando como um administrador.

    3. Navegue até a localização do instalador do Agente e execute o arquivo exe usando o seguinte comando

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      A partir de 2021.4, você deve especificar uma conta de usuário Run As para o agente. Essa conta é usada para acessar o Tableau Server para coletar informações de monitoramento.

      Para a conta de usuário Run As, especifique a mesma conta que você usa atualmente para a conta de usuário do Tableau Server. Se as informações da conta que você fornecer não forem iguais às do Tableau Server, o Agente não poderá coletar os dados de monitoramento nesse nó.

      • Use RUN_AS_NETWORK_SERVICE=1 se o seu Tableau Server estiver configurado para usar a conta do serviço de rede como o usuário Run As.
      • Use RUN_AS_USER_CUSTOM=1 se o Tableau Server estiver configurado para usar um usuário personalizado. Use as mesmas credenciais de conta especificadas para o Tableau Server.

      A pasta de instalação padrão é normalmente parecida com C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent. Para fornecer um local de instalação diferente, execute o seguinte comando:

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

      Observação: use o switch /silent ou /quiet para executar a configuração sem vigilância e sem exibir qualquer interface do usuário ou prompts.

  3. Registre o Agente:

    1. Execute o seguinte comando para registrar o Agente:

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      A tabela a seguir lista as opções de configuração usadas para registrar o Agente:

      OpçãoObrigatório?

      Padrão

      		Descrição
      --bootstrap fileSim<nenhum>A localização do arquivo bootstrap.
      --usernameSim<nenhum>Normalmente, é o usuário administrador que você criou durante a instalação do RMT Server.
      --passwordSim<nenhum>Esta é a senha da conta do usuário
      --password-file

      Não

      A senha pode ser fornecida na linha de comando ou em um arquivo que contenha a senha. Se nenhuma for fornecida, você será solicitado a fornecer uma senha.

      		<nenhum>Caminho incluindo o nome do arquivo onde a senha está armazenada.
      --server-nameNãoNome do host da máquinaNome do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo será padrão para o nome host da máquina.
      --server-descriptionNão<nenhum>Descrição do computador que tem o Agente instalado. Se nenhuma opção for fornecida, este campo permanecerá em branco.

      O Windows instala propriedades e switches

      Switches:

      SwitchDescriçãoComentários
      /passiveExecute a Instalação com interface do usuário mínima e sem prompts. 
      /quiet | /silentExecutar a instalação em modo totalmente silencioso e não supervisionado. Nenhuma interface da Web ou prompts são exibidos.Use /quiet ou /silent, não ambos.

      Propriedades:

      PropriedadeDescriçãoComentários
      InstallFolder=<path\to\installation\directory>Instalar no local de instalação não padrão especificado.

      Especifica a localização para instalar o RMT. Se não for usado, o RMT é instalado C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master.

      Exemplo: <Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"

      ACCEPTEULA=1|0Aceita o Contrato de licença do usuário final (EULA). Exigido para instalação quieta, silenciosa e passiva nos nós inicial e adicional. 1 = true, aceita o EULA, 0 = false, não aceita o EULA.Se não estiver incluído quando /passive, /silent ou /quiet forem utilizados, a configuração falhará de modo silencioso. Se incluído, mas definido como 0, a instalação falha.

       

Instalação do agente em vários nós do Tableau Server

Execute as etapas descritas acima em cada um dos nós do Tableau Server. Na interface da Web do RMT Server você deve ser capaz de ver todos os nós onde o Agente está instalado.

Quem pode fazer isso

Para instalar o Resource Monitoring Tool, você deve ter o seguinte:

Windows:

  • Permissões de administrador na máquina que você está instalando o Resource Monitoring Tool.
  • Função de site Administrador no Tableau Server.

Linux:

  • Acesso do sudo completo para a conta de usuário que é usada para instalar o Agente.

Próxima etapa

Configurar Resource Monitoring Tool do Tableau

Voltar para o topo