Executar uma instalação de linha única Agent Client Collector em macOS

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Use um script de comando de linha única eficiente para instalar Agent Client Collector em uma máquina que usa o sistema operacional macOS. Use o procedimento de instalação manual se o agente não estiver conectado à instância ou se você quiser 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.
    • Certifique-se de ter os pacotes pkgutil disponíveis para serem usados pelo script de instalação.
    • Certifique-se de que os agentes de destino tenham conectividade com o seguinte:
      • ServiceNow servidor de instalação [install.service-now.com]
      • Instância da ServiceNow
      • O MID Server ao qual o agente se conectará

    Função necessária: agent_client_collector_admin

    Procedimento

    1. Recupere os parâmetros de URL do websocket MID Server.
      1. Navegar até Agent Client Collector > Endpoint do websocket.
      2. Selecione o endpoint relevante do websocket.
      3. Copie o valor do campo URL do endpoint a ser usado no comando de instalação.
    2. Recupere a chave de API.
      1. Navegar até Agent Client Collector > Implantação > Chave de API de servidor Web MID.
      2. Copie o valor da chave de API a ser usada no comando de instalação.
    3. Execute o seguinte comando no servidor em que o Agent Client Collector está sendo instalado. 
      ACC_API_KEY=<api_key> ACC_MID=wss://<mid_ip>:<websocket_port>/ws/events bash -c "$(curl -L https://<instance URL>/api/sn_agent/agents/install_agent)"

      Insira os seguintes valores na linha de comando:

      Tabela 1. Parâmetros de linha de comando
      Parâmetro Valor
      ACC_API_KEY Substitua a cadeia de caracteres <api_key> pela chave de API usada para acessar o websocket MID Server. Se nenhum valor for especificado, você será solicitado a inserir o valor da chave de API durante a execução do script.
      ACC_MID Substitua a cadeia de caracteres <mid_ip> pelo URL do websocket MID Server. Ao especificar vários MID Servers, insira uma cadeia de caracteres separada por vírgulas para cada MID Server.
      ACC_ALLOW_LIST (Opcional) Adicione a cadeia de caracteres ACC_ALLOW_LIST=0 para desabilitar a lista de permissões. Por padrão, a lista de permissões está habilitada.
      Nota:
      Desabilitar a lista de permissões compromete a segurança do sistema e é recomendado apenas como uma medida temporária até que você termine de atualizar a lista de permissões. Depois de concluir a atualização, reative a lista de permissões removendo ACC_ALLOW_LIST=0 da cadeia de caracteres de comando de linha única.
      ACC_VALIDATE_SIG (Opcional) Adicione a cadeia de caracteres ACC_VALIDATE_SIG=0 para desabilitar a verificação da validação do certificado do instalador. Por padrão, a validação está habilitada.

      Padrão: a validação está habilitada.

      Nota:
      Desabilite a validação de certificação somente ao usar ferramentas de validação de assinatura não padrão.