Instalar manualmente Agent Client Collector ativado macOS

Instalar Agent Client Collector manualmente em uma máquina que usa macOS quando o agente não está conectado à instância ou você deseja opções de personalização aprimoradas.

Antes de Iniciar

• Certifique-se de ter configurado o. Agent Client Collector servidor web.
• Verifique se o SO e a versão do servidor correspondem à lista de versões do SO compatíveis, conforme descrito em Agent Client Collector instalação.
• Navegar até Agent Client Collector > Implantação > Downloads do agente e baixe o assinado .pkg Relevante para o seu SO.
• Armazene o. .pkg pacote de instalação em um de seus agentes instalados.

Função necessária: agent_client_collector_admin

Procedimento

1. Baixe os arquivos de instalação para sua máquina local.

   curl -L <download link from the Agent Downloads page on the instance>

2. Valide a assinatura do arquivo de instalação.

   pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg

   Nota:

   Certifique-se de que pacote a cadeia de certificação tem ServiceNow Certificado do instalador do ID do desenvolvedor.
3. Instale o. Agent Client Collector pacote.

   sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. Copie os arquivos de instalação.
   1. Arquivo de configuração de amostra:
      Sudo cp -p /Library/Application/ServiceNow/agent-client-collector/acc.yml.Exemplo /Library/Application/ServiceNow/agent-client-collector/acc.yml
   2. Arquivo de lista de permissões de amostra:
      Sudo cp -p /Library/Application Support/ServiceNow/agent-client-collector/check-allow-list.json.default /Library/Application Support/ServiceNow/agent-client-collector/check-allow-list.json
5. Opcional: Para criar novas definições de verificação a serem incluídas na lista de permissões, primeiro desabilite a lista de permissões comentando o. allow-listparâmetro no acc.yml arquivo.

   Sudo -H -u _ServiceNow vi /Library/Application/ServiceNow/agent-client-collector/acc.yml

   Nota:

   Esta ação compromete a segurança do seu sistema e é recomendada somente como uma medida temporária até que você conclua a atualização da lista de permissões. Depois de concluir a atualização, remova o comentário do parâmetro da lista de permissões no arquivo de configuração para reativar a lista de permissões.

   Para obter detalhes sobre como adicionar verificações personalizadas a uma lista de permissões, consulte Gere um Agent Client Collector lista de permissões.

6. Salve o arquivo de configuração.
7. No arquivo de configuração, conecte o agente ao MID Server.
   1. Defina MID Server conexão.

      "wss://<MID Server IP>:<Web Socket Port>/ws/events"

      A porta do soquete da web foi configurada no MID Server quando foi definido como um Agent Client Collector ouvinte.

   2. Localize api-keyE especifique o valor da chave de API entre aspas duplas, da seguinte forma:
      api-key:"111111111"
      A chave de API especificada é criptografada na primeira vez que o agente é executado.
8. Para garantir que o arquivo de configuração aponte para um endpoint válido, execute os comandos a seguir para reiniciar o. Agent Client Collector:

   sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
   sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist

   Nota:

   Por padrão, sair do programa de instalação faz com que o programa seja reiniciado imediatamente. Para garantir que o programa permaneça interrompido após sair, defina a propriedade KeepAlive no /Library/LaunchDemons/com.sn.acc.plist arquivo para falso .