Alterne o ACC de uma instância para outra

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:

• Criação de chave de registro do ACC.
• Install the Agent Client Collector on a Windows machine manually ou Manually install Agent Client Collector on macOS.

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á mudar 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.
   • No Windows, acesse os serviços como administrador e interrompa o serviço Agent Client Collector.
   • No macOS, execute o comando: sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
2. Abra o arquivo acc.yml.
   • Windows: C:\ProgramData\ServiceNow\agent-client-collector\config
   • macOS: /Library/Application\ 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 Criação de chave de registro do ACC.

5. Salve o arquivo.
6. Exclua arquivos com base no seu sistema operacional.
   • No Windows, navegue até /agent-client-collector/config/cert/cnc e remova os seguintes arquivos: cnc_chain.crt e priv_key.pem.go.
   • No 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.
   • No Windows, exclua a pasta: /agent-client-collector/cache.
   • No 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 do 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 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.
   • No Windows, abra Serviços como administrador e inicie o Agent Client Collector.
   • No macOS, execute o comando: sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.