Alternar ACC de uma instância para outra

  • Versão de lançamento: Yokohama
  • Atualizado 9 de jan. de 2026
  • 2 min. de leitura

    • Alterne para uma instância Agent Client Collector (ACC) diferente.

    Antes de Iniciar

    Confirme se você instalou o Agent Client Collector (ACC) e configurou a chave de registro ACC. Para obter informações sobre como configurar e instalar, consulte:

    Função necessária: agent_admin e agent_client_collector_admin

    Para obter mais informações sobre funções, consulte Agent Client Collector user roles.

    Por Que e Quando Desempenhar Esta Tarefa

    Se o ACC já estiver conectado a uma instância, você poderá alternar o agente para outra instância alterando a configuração em acc.yml.

    Procedimento

    1. Interrompa o ACC com as etapas apropriadas para o seu sistema operacional.
      • Para Windows, acesse Serviços como administrador e interrompa o serviço Agent Client Collector.
      • Para macOS, execute o comando: sudo launchctlload -w /Library/LaunchDaemons/com.sn.acc.plist;
    2. Abra o arquivo acc.yml.
      • Windows: C:\ProgramData\ServiceNow\agent-client-collector\config
      • macOS: /Biblioteca/aplicação\ Support/servicenow/agent-client-collector/
    3. Edite o parâmetro backend-url para apontar para <ITOM Cloud Services Gateway> .
      Use qualquer um dos seguintes gateways com base no local da instância:
      • AMER: itomcnc-prod-gateway-amer.sncapps.service-now.com:443
      • EMEA: itomcnc-prod-gateway-emea.sncapps.service-now.com:443
      • APAC: itomcnc-prod-gateway-apac.sncapps.service-now.com:443

      Para obter mais informações sobre como o Agente usa o Gateway de Serviços em Nuvem do ITOM, consulte DEX Arquitetura.

    4. Atualize os seguintes parâmetros:
      • connect-without-mid: true
      • instance-url: <full_instance_url>, por exemplo: https://dex.servicenow.com
      • registration-key: <valor da chave de registro>

        Para obter mais informações sobre como criar uma chave de registro, consulte Criar uma chave de registro ACC.

    5. Salve o arquivo.
    6. Exclua arquivos com base no seu sistema operacional.
      • Em Windows, navegue até /agent-client-collector/config/cert/cnc e remova os seguintes arquivos: cnc_chain.crt e priv_key.pem.go.
      • Em macOS, acesse /Library/Application Support/servicenow/agent-client-collector/cert/cnc e exclua os arquivos: cnc_chain.crt e priv_key.pem.
    7. Exclua as pastas a seguir com base no seu sistema operacional.
      • Em Windows, exclua a pasta: /agent-client-collector/cache.
      • Em macOS:
        • Para o Agent 3.4.1 ou versões mais recentes, exclua a pasta: /Library/Application Support/servicenow/agent-client-collector/cache.
        • Para o Agent 3.4.0 ou versões mais antigas, exclua a pasta: /Library/Caches/servicenow/agent-client-collector.
    8. Opcional: Se você já conectou este ACC a outra instância antes, faça o seguinte:
      1. Copie o número de série do dispositivo.
      2. Na tabela Agent Client Collectors (sn_agent_cmdb_ci_agent), pesquise usando o número de série do dispositivo.
        Nota:
        Adicione a coluna ID do agente à exibição de lista se ela não estiver disponível.
      3. Se você encontrar um registro, copie o ID do agente do registro.
      4. Na tabela Registros de agentes (sn_agent_agent_registration), pesquise usando o ID do agente de registro.
      5. Exclua todos os registros resultantes da pesquisa.
    9. Inicie o serviço ACC seguindo as etapas específicas do seu sistema operacional.
      • Em Windows, abra Serviços como administrador e inicie Agent Client Collector.
      • Em macOS, use o comando: sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.