Instale o. Agent Client Collectorem a. Windowsmáquina manualmente

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Instale o. Agent Client Collectorem a. Windowsmáquina manualmente quando você deseja testar o agente em um único sistema.

    Antes de Iniciar

    1. Certifique-se de ter configurado o. Agent Client Collectorservidor 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 MicrosoftInternet Explorer, faça o seguinte para preparar o. Agent Client Collectorarquivo 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 para .msi

    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 a. 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 CollectorEm 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 do grupo (gMSA): Insira o nome da conta de serviço gerenciado do 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 saia do Senha campo vazio.
        Nota:
        O uso de uma conta do sistema local cria o grupo local ServiceNow Userse adiciona o usuário criado ao grupo. O grupo de usuários da ServiceNow tem acesso a. Agent Client Collectore tem os seguintes privilégios:
        • Monitor de desempenho : Vem com o sistema base; permite 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 ServiceNowgrupo de usuários.
      6. Selecione Criar usuário .
        O sistema cria um usuário do Windows com as credenciais especificadas e o. Agent Client CollectorA 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 C: 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 para 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 <key_value> /quiet /qn /norestart acc_api_KEY://<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 ServersCom 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 Serverwebsocket.
      ACC_MID O URL do MID Serverwebsocket.
      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

      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 Collectoro serviço é iniciado automaticamente após a instalação.

      Valor padrão: Verdadeiro

      NOME DO LOCALUSERNAME Conta que executa o. Agent Client Collector. Windowsserviç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 Serveros valores são adicionados automaticamente ao acc.yml arquivo. O agente se conecta ao primeiro disponível MID Serverna 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).