Instale o. Agent Client Collector em um Windows máquina manualmente

  • Versão de lançamento: Zurich
  • Atualizado 17 de ago. de 2025
  • 5 min. de leitura
  • Instale o. Agent Client Collector em um Windows máquina manualmente quando você deseja testar o agente em um único sistema.

    Antes de Iniciar

    1. Certifique-se de ter configurado o. Agent Client Collector servidor web. Para obter detalhes, consulte Configure o servidor websocket no MID Server.
    2. Verifique o SO e a versão do servidor.
    3. Ao usar Microsoft Internet Explorer, faça o seguinte para preparar o. Agent Client Collector arquivo de instalação:
      1. Navegar até Gerenciador de servidores > Servidor local.
      2. Desativar Configuração de segurança aprimorada do IE .
      3. Baixe o arquivo de instalação.
      4. Altere a extensão do arquivo de instalação de .man . .msi

    Para solução de problemas, consulte KB2200094 artigo na Base de conhecimento HI.

    Função necessária: agent_client_collector_admin

    Procedimento

    1. Navegar até Agent Client Collector > Downloads 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 Próximo até chegar ao Configurações de conexão do MID Web Server página.

        Página Configurações de conexão DO MID

      3. Insira os parâmetros relevantes nos campos da caixa de diálogo:
        Tabela 1. Campos Configurações de conexão do MID Web Server
        Nome do campo Descrição
        Nome/IP do MID Web Server 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 MID Web Server.
      4. Selecione Avançar.
        . Criar conta de usuário local a página é exibida.

        Página Criar conta de usuário local

      5. Selecione a opção relevante na caixa de diálogo.
        Tabela 2. Caixa de diálogo Criar conta de usuário local
        Opção Descrição
        Usar usuário padrão (serviceNow) Usuário padrão com o qual executar o. Agent Client Collector Em uma máquina Windows.

        Selecionar esta 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 KB1649116 artigo na Base de conhecimento HI.

        Selecione o 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.
        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 do grupo (gMSA): Insira o nome da conta de serviço gerenciado do grupo em Nome de usuário e sair do Senha campo vazio.
        • Conta de serviço local: Insira LOCALSERVICEem Nome de usuário e sair do Senha campo vazio.
        • Conta do sistema local: Insira SYSTEMem Nome de usuário e sair do Senha campo vazio.

          Devido a. Windows Restrições do UAC, executar o agente como uma conta DO SISTEMA local é necessário para executar um upgrade via msiexec.

        Nota:
        Usar 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 a. Agent Client Collector e tem os seguintes privilégios:
        • Monitor de desempenho : Vem com o sistema de base; habilita a exibição de todos os contadores de desempenho no sistema.
        • Faça logon como um serviço : Habilita a inicialização de serviços de rede e serviços que são executados continuamente, mesmo quando ninguém está conectado ao console.
        • Depurar programas : Habilita processos de depuração e leitura de detalhes do processo para usuários fora do ServiceNow grupo de usuários.
      6. Selecione Criar usuário .
        O sistema cria um usuário do Windows com as credenciais especificadas e Agent Client Collector A página de configuração é exibida.
      7. Para habilitar o. Lista de permissões que contém as verificações habilitadas para execução após a configuração, selecione Habilitar a execução da lista de permissões do comando caixa de seleção na página resultante.

        Caixa de seleção Lista de permissões

      8. Selecione Próximo para abrir a página de instalação.

        Quando a instalação for concluída, clique em Próximo para concluir e sair do assistente.

        Após uma instalação bem-sucedida, o serviço é iniciado automaticamente e gera o seguinte:

        • 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 local Usuários da ServiceNow .
        • Serviço: AgentClientCollector
        • Local do arquivo:
          • Padrão para instalação Arquivos de programas/ServiceNow/agent-client-collector
          • Padrão para arquivos de serviço C: ProgramData/ServiceNow/agent-client-collector , que contém cache , configuração e log pastas.
    3. Para executar a instalação silenciosa e desabilitar os relatórios de instalação, execute a linha de comando que aparece no Instalação silenciosa da seguinte forma:
      Msiexec /i <msi_file_path> /quiet /qn /norestart acc_api_KEY <key_value>://wss://<mid_ip>:<websocket_port>/ws/events acc_ALLOW_LIST

      Para habilitar a lista de permissões de verificações especificadas ao executar a instalação silenciosa, defina ACC_ALLOW_LISTparâmetro para Verdadeiro .

    4. Para configurar vários MID Servers Com a instalação silenciosa, execute a linha de comando que aparece no Instalação silenciosa seção do procedimento com valores separados por vírgulas, da seguinte forma:
      Msiexec /i <msi_file_path> /quiet /qn /norestart acc_api_KEY_KEY_wss://wss:<websocket1_port>/ws/events,wss://<key_value> <mid2_ip>:<mid1_ip> <websocket2_port>/ws/events"

      Insira os seguintes valores de parâmetro no comando:

      Tabela 3. Parâmetros de comando
      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.
      DENY_LOCAL_LOGON Quando definido como Trueimpede que qualquer usuário que não seja o usuário da servicenow padrão faça login no serviço.

      Valor padrão: falso

      PASSWORD_NEVER_EXPIRES Quando definido como True, a senha do usuário da servicenow padrão nunca expira.

      Valor padrão: falso

      START_SERVICE Quando definido como True. Agent Client Collector o serviço é iniciado automaticamente após a instalação.

      Valor padrão: Verdadeiro

      LOCALUSERNAME Conta que executa o. Agent Client Collector. Windows serviço. Valores possíveis:
      • SISTEMA
      • LOCALSERVICE
      • DOMÍNIO/gMSA
      • cadeia de caracteres (nome de usuário local)

      Padrão servicenow

      Ao usar as contas DO SISTEMA, LOCALSERVICE ou DOMÍNIO, você não precisa configurar uma senha.

      LOCALPASSORD Senha do usuário especificada no parâmetro LOCALUSERNAME.

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

      Para configurar um MID Server secundário, insira a seguinte sintaxe em url de back-end . acc.yml arquivo, de acordo com .yml padrão: - "wss://<MID IP>: Porta de soquete web>/ws/events" (com as aspas).