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

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 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.
    2. Verifique o SO e a versão do seu 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 servidores > Servidor local.
      2. Desative a Configuração de Segurança Aprimorada do IE.
      3. Baixe o arquivo de instalação.
      4. Mudar 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 Avançar até chegar à página Configurações de conexão do MID Web Server.

        Página de 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 servidor Web MID.
        Porta do Servidor Web MID 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.
      4. Selecione Avançar.
        A página Criar conta de usuário local é 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 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 adicionada).
        • 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.
        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:
        • Performance Monitor: vem com o sistema básico; 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.
      6. Selecione Criar usuário.
        O sistema cria um usuário do Windows com as credenciais especificadas e a página Configuração Agent Client Collector é exibida.
      7. Para habilitar a lista de permissões que contém as verificações habilitadas para execução 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.

        Caixa de seleção Permitir lista

      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.

        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 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.
    3. Para executar a instalação silenciosa para desabilitar relatórios de instalação, execute a linha de comando que aparece na seção de 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 das 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 de instalação silenciosa do procedimento com valores separados por vírgula, da seguinte forma:
      msiexec /i<msi_file_path> /quiet /qn /norestart ACC_API_KEY=<key_value> ACC_MID="wss://<mid1_ip> :<websocket1_port> /ws/eventos,wss://<mid2_ip> :<websocket2_port> /ws/eventos"

      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 websocket MID Server.
      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
      START_SERVICE Quando definido como True, o serviço Agent Client Collector inicia automaticamente após a instalação.

      Valor padrão: Verdadeiro
      LOCALUSERNAME Nome de usuário da conta com a qual o serviço Agent Client Collector é instalado e executado.
      LOCALPASSWORD Senha para o usuário especificado no parâmetro LOCALUSERNAME.

      Os valores configurados MID Server 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 backend-url do arquivo acc.yml, de acordo com o padrão .yml : - "wss:// <MID IP> :<Web socket port> /ws/events" (com aspas).