Instale sem MID Agent Client Collector manualmente em um Linux ambiente

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Instale sem MID Agent Client Collector manualmente em um Linux máquina para habilitar o envio de dados do agente para a instância por meio da nuvem. O envio de informações por meio da nuvem permite MID Server para ser usado para recursos mais persistentes.

    Antes de Iniciar

    • Instale o. ITOM Plug-in Cloud Services Core (sn_itom_cloud_svc).
    • Integre sua instância para usar ITOM Serviços em nuvem. Para obter detalhes, entre em contato com o Suporte ao cliente.
    • Configure uma chave de registro de agente. Para obter detalhes, consulte Configure uma chave de registro de agente.
    • Função necessária: agent_client_collector_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter detalhes sobre como enviar dados por meio da nuvem em uma implantação sem MID, consulte DEX Architecture.

    Procedimento

    1. Baixe o pacote de instalação relevante.
      1. Navegar até > Agent Client Collector > Implantação > Downloads do agente.
      2. Baixe o arquivo de instalação .rpm ou .deb relevante.
      3. Baixe os arquivos de assinatura relevantes para validar os arquivos de instalação.
    2. Opcional: Verifique a assinatura do pacote.
      1. Extraia o arquivo de instalação (se estiver compactado) executando o seguinte comando:
        descompacte agent_client-collector-<version_number>-x86_64-rpm-rpm.zip
      2. Valide a assinatura do arquivo de instalação executando os comandos indicados.
        • Em um sistema baseado em RPM:
          openssl dgst -sha256 -verify {<ServiceNow DGST pem key>} -signature {<signature file>} agent-client-collector-<version number>-x86_64.rpm

          Onde ServiceNow DGST pem key> . .pem arquivo extraído do .zip arquivo, e. <signature file> . .bin arquivo extraído do .zip arquivo.

          Por exemplo: 
          $ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-x86_64.rpm
$ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
$ unzip agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
Archive: agent-client-collector-3.0.0-x86_64-rpm-rpm.zip
inflating: ServiceNow_Digicert_DGST.pem
extracting: agent-client-collector-3.0.0-x86_64.bin
$ openssl dgst -sha256 -verify ServiceNow_Digicert_DGST.pem -signature agent-client-collector-3.0.0-x86_64.bin agent-client-collector-3.0.0-x86_64.rpm
Verified OK
          Nota:
          Cada comando deve aparecer em uma única linha.
        • Em um sistema baseado em Debian:

          gpg --import ServiceNow_Digicert_Public.gpg

          sudo gpg --verify agent-client-collector-<version number>-<distro>_amd64.deb

          Por exemplo:
          $ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-debian-9_amd64.deb
$ curl -sLO https://install.service-now.com/glide/distribution/builds/package/app-signed/agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
$ unzip agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
Archive: agent-client-collector-3.0.0-debian-9_amd64-deb-deb.zip
extracting: ServiceNow_Digicert_Public.gpg
$ gpg --import ServiceNow_Digicert_Public.gpg
gpg: /home/admin/.gnupg/trustdb.gpg: trustdb created
gpg: key 985DD52C6A0ABB45: public key "ServiceNow, Inc. (Signing) <seceng@servicenow.com>"
imported
gpg: Total number processed: 1
gpg: imported: 1
$ dpkg-sig --verify agent-client-collector-3.0.0-debian-9_amd64.deb
Processing agent-client-collector-3.0.0-debian-9_amd64.deb...
GOODSIG _gpgbuilder 9B928FB49771DF6C047430DD985DD52C6A0ABB45 1665054068
          Nota:
          Cada comando deve aparecer em uma única linha.
    3. Instale o. Agent Client Collector pacote usando o gerenciador de pacotes associado a. Linux distribuição.
      SO Comando
      Baseado em RHEL yum / dnf localinstall
      SLES instalação do zypper
      Baseado em Debian instalação do apt-get

      Como alternativa, se esses comandos não estiverem configurados corretamente, você poderá usar os comandos principais que estão configurados para serem executados com os comandos do gerenciador de pacotes.

      • Sistema baseado EM RPM: agent-client-collector-<version number>-x86_64.rpm
      • Sistema baseado em Debian: agent-client-collector-<version number>-<distro>_amd64.deb

      Verifique se os comandos de pacote estão configurados corretamente com o administrador do sistema.

      Nota:
      Alguns sistemas de arquivos podem ter restrições habilitadas; por exemplo, /var/ pode ser montado com um noexecsinalizador. Porque o agente deve executar Agent Client Collector plug-ins que normalmente são armazenados no /var/cache , você deve implantar a aplicação em pastas específicas personalizando os caminhos de instalação usando --relocateopção como um .rpm parâmetro.

      Por exemplo: --relocate /var/cache/opt/cache agent-client-collector-<version_number>-x86_64.rpm

      Os seguintes caminhos podem ser realocados:
      Caminho Anotações
      /etc Ao atualizar, você também deve atualizar o. allow-listparâmetro no acc.yml arquivo com o novo caminho.
      /usr/share N/D
      /var/cache Atualizando o. /var o diretório retém tudo /var subdiretórios, aninhados no novo diretório.
      /var/log
      /var/run
      /var
      Revise os caminhos em /usr/lib/systemd/system/acc.service para garantir que eles apareçam conforme o esperado.
    4. Execute o comando de upgrade de pacote relevante, com base na cpu com a qual sua máquina é executada:
      • cpu Intel: 
        sudo installer -pkg agent-client-collector-<version number>-macos_x64.pkg -target /
      • Apple cpu de silício:
        sudo installer -pkg agent-client-collector-<version number>-macos_arm64.pkg -target /

      Este comando também faz backup e restaura o ID do agente e os arquivos de configuração antes do upgrade.

    5. Em acc.yml arquivo de configuração:
      1. Defina os seguintes parâmetros:
        Parâmetro Valor
        url de back-end "<gateway URL>"
        connect-sem mid verdadeiro
        instance-url "<instance URL>"
        registration-key "<regsitration-key>"
        unsure-skip-tls-verify falso
      2. Comente o. api-keyparâmetro.
    6. Salve o arquivo de configuração.
    7. Configure o agente para ser executado como um serviço.
      1. Proteja o consumo de recursos adicionando os valores indicados ao /usr/lib/systemd/system/acc.service arquivo.
        • CPUScompartilhamentos: 128
        • CPUQuota: 10%
        • 192m
        • BlockIOWeight: 10
        • LimitNICE: 15

        Por exemplo:

        # vi /usr/lib/systemd/system/acc.service
[Unit]
Description=Agent-Now acc
After=network-online.target
[Service]
Environment=AGENT_ROOT=/usr/share
Environment=AGENT_CACHE_ROOT=/var/cache
Environment=AGENT_CONFIG_ROOT=/etc
Environment=AGENT_LOG_ROOT=/var/log
Environment=AGENT_RUN_ROOT=/var/run
Environment=RUBYOPT=-Eutf-8
User=servicenow
Group=servicenow
ExecStart=/usr/share/servicenow/agent-client-collector/bin/acc-service start acc
KillMode=process
Restart=on-failure
RestartSec=1min
CPUShares=128
CPUQuota=10%
MemoryLimit=192M
BlockIOWeight=10
LimitNICE=+15
[Install]
WantedBy=network-online.target
      2. Execute o comando reload daemon se você modificou o arquivo de serviço depois de habilitar o serviço acc.

        systemctl daemon-reload

      3. Habilite e inicie o serviço executando os seguintes comandos.

        habilitar acc

        início do acesso do systemctl