---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Instalar o Agent Client Collector em uma máquina Windows manualmente

# Instalar o Agent Client Collector em uma máquina Windows manualmente {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Instale o Agent Client Collector em uma máquina Windows manualmente quando quiser testar o agente em um único sistema.

## Antes de Iniciar

1. Verifique se você configurou o servidor web Agent Client Collector. Para obter detalhes, consulte [Configure o servidor websocket no MID Server](https://servicenow-prod.fluidtopics.net/txrGilxuk~MkVH~0LdeueQ "Configure o servidor websocket em MID Servers para habilitar conexões de agentes para o MID Server. Você pode configurar apenas um servidor websocket por MID Server.").
2. Verifique o SO e a versão do servidor.
3. Ao usar o Microsoft Internet Explorer, faça o seguinte para preparar o arquivo de instalação Agent Client Collector :
   1. Navegar até Gerenciador de servidoresServidor local.
   2. Desative a Configuração de Segurança Reforçada do IE.
   3. Baixe o arquivo de instalação.
   4. Mude a extensão do arquivo de instalação de .man para .msi
   {#acc-install-windows__ol_o3l_jxy_j4b}
{#acc-install-windows__ol_nc5_dwy_ylb}

Função necessária: agent_client_collector_admin

## Procedimento

1. Navegar até Agent Client CollectorDownloads do agente.
2. Para executar a instalação usando o assistente:
   1. Baixe o arquivo .msi que pode ser acessado no link na IU.  
      O Assistente de instalação é aberto.
   2. Selecione Avançar até chegar à página Configurações de conexão do MID Web Server.  

      <br />

   3. Insira os parâmetros relevantes nos campos da caixa de diálogo:  
      {#acc-install-windows__table_b4p_fxy_ylb__entry__2}

      | Nome do campo | Descrição |
      |-|-|
      | Nome/IP do Servidor Web MID | Endereço IP do MID Web Server. |
      | Porta do MID Web Server | Número da porta do MID Web Server. Use um número entre 1024 e 49151. |
      | Chave de API de servidor Web MID | Chave de API para acessar o servidor Web MID. |
      [Tabela 1. Campos de configurações de conexão do MID Web Server]

      {#acc-install-windows__table_b4p_fxy_ylb}
   4. Selecione Avançar.  
      A página Criar conta de usuário local é exibida.  

      <br />

   5. Selecione a opção relevante na caixa de diálogo.  
      {#acc-install-windows__table_hdl_d1z_hkb__entry__2}

      | Opção | Descrição |
      |-|-|
      | Usar usuário padrão (servicenow) | Usuário padrão com o qual o Agent Client Collector será executado em uma máquina Windows. A seleção desta opção cria um usuário local chamado ServiceNow como parte da instalação. A senha do usuário da ServiceNow é gerada aleatoriamente e não é armazenada no sistema. Um evento de segurança é criado na máquina host que, se repetido, requer a abertura de um caso de suporte. Para obter detalhes, consulte o artigo [KB1649116](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1649116) na Base de conhecimento HI. |
      | Selecionar usuário existente | Ao selecionar esta opção, configure os seguintes subcampos: * Nome de usuário: nome de usuário para fazer login no ambiente Windows. * Senha: senha do usuário selecionado. {#acc-install-windows__ul_l5p_szx_4lb} O usuário pode ser um dos seguintes: * Usuário local (criado pelo proprietário da máquina virtual; fornece resiliência adicional). * Usuário do domínio (criado pela equipe de TI). * Conta de serviço gerenciado: insira o nome da conta de serviço gerenciado no campo Nome de usuário e deixe o campo Senha em branco. * Conta de serviço local: insira LOCALSERVICE no campo Nome de usuário e deixe o campo Senha em branco. * Conta do sistema local: insira SYSTEM no campo Nome de usuário e deixe o campo Senha em branco. {#acc-install-windows__ul_rbh_hyt_jyb} |
      [Tabela 2. Caixa de diálogo Criar conta de usuário local]

      {#acc-install-windows__table_hdl_d1z_hkb}  
      Nota:  
      O uso de uma conta do Sistema local cria o grupo local ServiceNow Userse adiciona o usuário criado ao grupo. O grupo Usuários da ServiceNow tem acesso aos diretórios Agent Client Collector e tem os seguintes privilégios:
      * Monitor de desempenho: vem com o sistema de base; permite a exibição de todos os contadores de desempenho no sistema.
      * Fazer logon como um serviço: permite iniciar serviços de rede e serviços que são executados continuamente, mesmo quando ninguém está conectado ao console.
      {#acc-install-windows__ul_sn4_yyl_flb}
   6. Selecione Criar usuário.  
      O sistema cria um usuário do Windows com as credenciais especificadas e a página de configuração Agent Client Collector é exibida.
   7. Para habilitar a lista de permissões que contém as verificações habilitadas para ser executada após a configuração, marque a caixa de seleção Habilitar lista de permissões de comando de execução na página resultante.  

      <br />

   8. Selecione Avançar para abrir a página de instalação.  
      Quando a instalação for concluída, clique em Avançar para concluir e sair do assistente.

      Depois de uma instalação bem-sucedida, o serviço é iniciado automaticamente e gera o seguinte:
      * Usuário: padrão = servicenow (um usuário existente também pode ser configurado para gerenciar o serviço). O usuário da ServiceNow pertence ao grupo de usuários locais Usuários da ServiceNow.
      * Serviço: AgentClientCollector
      * Local do arquivo:
        * Padrão para instalação = C:\\Arquivos de Programas\\ServiceNow\\agent-client-collector
        * Padrão para arquivos de serviço = C:\\Program Data\\ServiceNow\\agent-client-collector, que contém as pastas de cache, confige log.
        {#acc-install-windows__ul_vtn_v1z_1mb}
      {#acc-install-windows__ul_x52_4pr_1mb}
   {#acc-install-windows__substeps_lvc_rbz_ylb}
3. Para executar a instalação silenciosa para desabilitar relatórios de instalação, execute a linha de comando que aparece na seção Instalação silenciosa do procedimento, da seguinte forma:  
   `msiexec /i<msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID=wss://<mid_ip> :<websocket_port> /ws/events ACC_ALLOW_LIST=Falso`

   Para habilitar a lista de permissões de verificações especificadas ao executar a instalação silenciosa, defina o parâmetro ACC_ALLOW_LIST como verdadeiro.
4. Para configurar vários MID Servers com instalação silenciosa, execute a linha de comando que aparece na seção Instalação silenciosa do procedimento com valores separados por vírgulas, da seguinte forma:  
   `msiexec /i<msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID="wss://<mid1_ip> :<websocket1_port> /ws/events,wss://<mid2_ip> :<websocket2_port> /ws/eventos"`

   Insira os seguintes valores de parâmetro no comando:
   {#acc-install-windows__table_al4_f4s_wlb__entry__2}

   | Parâmetro | Valor |
   |-|-|
   | ACC_API_KEY | A chave de API usada para acessar o MID Server websocket. |
   | ACC_MID | O URL do MID Server websocket. |
   | NEGAR_LOCAL_LOGON | Quando definido como True, impede que qualquer usuário que não seja o usuário padrão da ServiceNow faça login no serviço. Valor padrão: falso |
   | SENHA_NUNCA_EXPIRES | Quando definida como True, a senha do usuário padrão da ServiceNow nunca expira. Valor padrão: falso |
   | INICIAR_SERVIÇO | Quando definido como True, o serviço Agent Client Collector é iniciado automaticamente após a instalação. Valor padrão: Verdadeiro |
   | LOCALUSERNAME | Conta que executa o Agent Client Collector como um serviço Windows. Valores possíveis: * SISTEMA * SERVIÇOLOCAL * DOMÍNIO\\gMSA$ * cadeia de caracteres (nome de usuário local) {#acc-install-windows__ul_j2k_ywt_hxb} Padrão = `servicenow` Ao usar as contas SYSTEM, LOCALSERVICE ou DOMAIN\\gMSA$, você não precisa configurar uma senha. |
   | LOCALPASSWORD | Senha do usuário especificado no parâmetro LOCALUSERNAME. |
   [Tabela 3. Parâmetros de comando]

   {#acc-install-windows__table_al4_f4s_wlb}

   Os valores MID Server configurados são adicionados automaticamente ao arquivo acc.yml. O agente se conecta ao primeiro disponível MID Server na lista.

   Para configurar um MID Server secundário, insira a seguinte sintaxe na seção back-end-url do arquivo acc.yml, de acordo com o padrão .yml : - "wss:// \<MID IP\> :\<Web socket port\> /ws/events" (com aspas).
* **[Fazer upgrade de Agent Client Collector manualmente em um sistema Windows](https://servicenow-prod.fluidtopics.net/Ma5Dm17Uet5katXPQSt8JA)**   
  Execute um upgrade manual da versão Agent Client Collector existente em um sistema que executa um sistema operacional Windows.
* **[Desinstalar Agent Client Collector manualmente de uma máquina Windows](https://servicenow-prod.fluidtopics.net/CaV5XnyojSzOCupJlqABKw)**   
  Desinstale o Agent Client Collector de uma máquina Windows manualmente em vez de usar o procedimento de linha única. Use o procedimento manual se o script de comando não estiver disponível porque o agente específico não está conectado à instância.