---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Instalar manualmente Agent Client Collector em macOS

# Instalar manualmente Agent Client Collector em macOS {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

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

## Antes de Iniciar

* Certifique-se de ter configurado o servidor web Agent Client Collector.
* Verifique se o SO e a versão do servidor correspondem à lista de versões de SO compatíveis, conforme descrito em [Agent Client Collector instalação](https://servicenow-prod.fluidtopics.net/lB2QQoJZb4LlEOMP2M6U0g "Você pode instalar o Agent Client Collector em qualquer máquina host compatível. O Agent Client Collector se conecta a um MID Server usando o protocolo HTTP/S e a conexão permanece ativa após ser estabelecida. Um MID Server pode lidar com vários agentes simultaneamente, enquanto um único agente trabalha com um MID Server de cada vez e alterna para um MID Server diferente quando necessário para fornecer proteção contra failover.").
* Navegar até Agent Client CollectorImplantaçãoDownloads do agente e baixe o .pkg assinado relevante para o seu sistema operacional.
* Armazene o pacote de instalação .pkg em um dos agentes instalados.

{#acc-install-macOS-manual__ul_m15_ygq_nqb}

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 a cadeia de certificados de pkg tenha o certificado do instalador do ID de desenvolvedor ServiceNow.
3. Instale o pacote Agent Client Collector.  

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

4. Copie os arquivos de instalação.
   1. Exemplo de arquivo de configuração:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml
   2. Exemplo de arquivo da lista de permissões:  
      sudo cp -p /Biblioteca/Aplicação\\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json
   {#acc-install-macOS-manual__substeps_lgw_fhq_nqb}
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 parâmetro allow-list no arquivo acc.yml.  
   sudo -H -u _servicenow vi /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml  
   Nota:  
   Esta ação compromete a segurança do seu sistema e é recomendada apenas como uma medida temporária até que você termine de atualizar a 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 [Gerar uma Agent Client Collector lista de permissões](https://servicenow-prod.fluidtopics.net/V200UBSPl42yQMXMVVpSvg "Especifique as verificações a serem incluídas na lista de verificações que podem ser executadas no agente.").
6. Salve o arquivo de configuração.
7. No arquivo de configuração, conecte o agente ao MID Server.
   1. Defina a conexão MID Server.  

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

      A porta do soquete da web foi configurada no MID Server quando foi definida como um Agent Client Collector ouvinte.
   2. Localize o parâmetro api-key e 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 em que o agente é executado.
   {#acc-install-macOS-manual__substeps_sth_nhq_nqb}
8. Para garantir que o arquivo de configuração aponte para um endpoint válido, execute os seguintes comandos 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 a saída, defina a propriedade KeepAlive no arquivo /Library/LaunchDaemons/com.sn.acc.plist como false.