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

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.
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 servidores > Servidor 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

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.

      
      

      

      
      

   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 servidor Web MID.

   4. Selecione Avançar.
      A página Criar conta de usuário local é exibida.

      
      

      

      
      

   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 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 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. 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.

      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.
   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.

      
      

      

      
      

   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.
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:

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

   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
  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
  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.