Converter ACC de uma instância para outra instância

Converta instâncias de Agent Client Collector (ACC) para monitoramento para aprimorar a coleta de dados, a visibilidade, a compatibilidade da ferramenta ou suprir necessidades específicas de monitoramento.

Antes de Iniciar

Certifique-se de configurar a chave de registro ACC e instalaro ACC. Para obter informações sobre como configurar e instalar, consulte:

• Criar chave de registro 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 Agent Client Collector (ACC) já estiver conectado a uma instância, o agente poderá ser convertido em 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 do Agent Client Collector.
   • Em dispositivos Mac, execute o comando: sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist;
2. Abra o arquivo acc.yml.
3. Edite o URL da instância para a nova instância.
4. 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.

5. Adicione os seguintes novos 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 chave de registro ACC.

6. Comente o parâmetro: api-key: "encrypted....”
7. Salve o arquivo.
8. 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.
   • Em dispositivos Mac, acesse /Library/Application Support/servicenow/agent-client-collector/cert/cnc e exclua os arquivos: cnc_chain.crt e priv_key.pem.
9. Exclua as pastas a seguir com base no seu sistema operacional.
   • No Windows, exclua a pasta: /agent-client-collector/cache.
   • Em dispositivos Mac:
     • 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.
10. Inicie o serviço ACC seguindo as etapas específicas do seu sistema operacional.
    • No Windows, acesse os Serviços como Administrador e inicie o Serviço Agent Client Collector.
    • Em dispositivos Mac, execute o comando: sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist.