Alterne o ACC de uma instância para outra

  • Versão de lançamento: Zurich
  • Atualizado 24 de jun. de 2026
  • 2 min. de leitura

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

    Antes de Iniciar

    Confirme que você instalou o. Agent Client Collector(ACC) e configure 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 Agent Client Collector serviço.
      • Para macOS execute o comando: Sudo launchctl unload -w /Library/LaunchDemons/com.sn.acc.plist;
    2. Abra o arquivo acc.yml.
      • Windows: C: ProgramData/ServiceNow/agent-client-collector/config
      • macOS: 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 Crie uma chave de registro ACC.

    5. Salve o arquivo.
    6. Exclua arquivos com base no seu sistema operacional.
      • Ativado Windows, navegue até /agent-client-collector/config/cert/cnc e remova os seguintes arquivos: cnc_cadeia.crt e. priv_key.pem.go .
      • Ativado macOS, acesso /Library/Application Support/ServiceNow/agent-client-collector/cert/cnc e exclua os arquivos: cnc_cadeia.crt e. priv_key.pem .
    7. Exclua as pastas a seguir com base no seu sistema operacional.
      • Ativado Windows exclua a pasta: /agent-client-collector/cache .
      • Ativado 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ê conectou este ACC a outra instância antes, faça o seguinte:
      1. Copie o número de série do seu dispositivo.
      2. Na tabela Agent Client Collectors (sn_agent_cmdb_ci_agent), pesquise usando o número de série do seu dispositivo.
        Nota:
        Adicione ID do agente para a exibição de lista, se não estiver disponível.
      3. Se você encontrar um registro, copie o ID do agente do registro.
      4. Na tabela Registros do agente (sn_agent_agent_registration), pesquise usando o ID do agente do registro.
      5. Exclua todos os registros resultantes da pesquisa.
    9. Inicie o serviço ACC seguindo as etapas específicas do seu sistema operacional.
      • Ativado Windows Abra Serviços como Administrador e inicie Agent Client Collector.
      • Ativado macOS, use o comando: Sudo launchctl load -w /Library/LaunchDemons/com.sn.acc.plist .