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

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 5 min. de leitura
  • Instale o. Agent Client Collector em a. 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 seu 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. Desat 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
    Certifique-se de que o .NET Framework 4.6.2 ou posterior esteja instalado na máquina de destino.
    Nota:
    Se o .NET Framework não estiver sendo executado de forma eficaz, use o instalador legado do VBSript executando o seguinte comando na máquina de destino: <key_value>://:<msi_file_path>/ws/events acc_ALLOW_LIST://<mid_ip>:<websocket_port>/ws/events acc_ALLOW_LIST 1 False

    Ative o modo de imagem dourada para clonar agentes adicionais definindo a propriedade msi GOLDEN_IMAGE=true.

    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 de Configurações de conexão do MID Web Server
        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 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 de 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 de grupo (gMSA): Insira o nome da conta de serviço gerenciado de grupo no Nome de usuário e saia do Senha campo vazio.
        • Conta de serviço local: Insira LOCALSERVICEem Nome de usuário e saia 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 de usuários 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 o. 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 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:

        • Usuário: Padrão: ServiceNow (um usuário existente também pode ser configurado para gerenciar o serviço). O usuário ServiceNow pertence ao grupo de usuários local Usuários da ServiceNow .
        • Serviço: AgentClientCollector
        • Local do arquivo:
          • Padrão para instalação Arquivo de programas/ServiceNow/agent-client-collector
          • Padrão para arquivos de serviço C:/ProgramData/ServiceNow/agent-client-collector , que contém o. 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:
      <msi_file_path> /i quiet /qn /norestart acc_api_KEY <key_value>://<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:
      ://:<msi_file_path> <websocket1_port>/ws/events,wss://<key_value>:<mid1_ip>/ws/events,wss://<mid2_ip>:<websocket2_port>/ws/events"

      Insira os seguintes valores de parâmetro no comando:

      Tabela 3. Parâmetros de comando
      Parâmetro Valor
      API_ACC_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 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

      HTTPS_PROXY Um URL totalmente qualificado para um servidor proxy.

      Por exemplo: https://proxy.url.net

      PAC_FILE Um caminho de arquivo legível no sistema.

      Por exemplo: /path/to/servicenow/readable/file

      PASSWORD_NEVER_EXPIRES Quando definido como True, a senha do usuário padrão da servicenow 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

      NOME DO LOCALUSERNAME Conta que executa o. Agent Client Collector como um 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 especificado no parâmetro LOCALUSERNAME.

      O 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 no 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).