환경에 수동으로 MID 없는 에이전트 클라이언트 수집기 설치 Linux

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 9분

    • 클라우드에 에이전트에서 인스턴스로 데이터를 전송할 수 있도록 머신에 Linux MID 에이전트 클라이언트 수집기 를 수동으로 설치합니다. 클라우드 MID 서버 를 통해 정보를 보내면 더 많은 영구 리소스에 사용할 수 있습니다.

    시작하기 전에

    • ITOM Cloud Services Core(sn_itom_cloud_svc) 플러그인을 설치합니다.
    • 클라우드 서비스를 사용하려면 ITOM 인스턴스를 온보딩합니다. 자세한 내용은 고객 지원에 문의하십시오.
    • 에이전트 등록 키를 구성합니다. 자세한 내용은 에이전트 등록 키 구성 문서를 참조하십시오.
    • 필요한 역할: agent_client_collector_admin

    이 태스크 정보

    MID 없는 배포에서 클라우드를 통해 데이터를 보내는 방법에 대한 자세한 내용은 문서를 참조하십시오 DEX Architecture.

    프로시저

    1. 관련 설치 패키지를 다운로드합니다.
      1. 다음으로 이동 > 에이전트 클라이언트 수집기 > 배포 > 에이전트 다운로드.
      2. 관련 .rpm 또는 .deb 설치 파일을 다운로드합니다.
      3. 관련 서명 파일을 다운로드하여 설치 파일을 확인합니다.
    2. 옵션: 패키지 서명을 확인합니다.
      1. 다음 명령을 실행하여 설치 파일을 추출합니다(압축된 경우).
        unzip agent_client-collector-<version_number>-x86_64-rpm-rpm.zip
      2. 표시된 명령을 실행하여 설치 파일 서명을 확인합니다.
        • RPM 기반 시스템에서:
          openssl dgst -sha256 -verify {<ServiceNow DGST pem key>} -signature {<signature file>} agent-client-collector-<version number>-x86_64.rpm

          여기서 <ServiceNow DGST pem 키>는 .zip 파일에서 추출한 .pem 파일이고 <서명 파일>은 .zip 파일에서 추출한 .bin 파일입니다.

          예: 
          $ 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
          주:
          각 명령이 한 줄에 나타나야 합니다.
        • Debian 기반 시스템에서:

          gpg --import ServiceNow_Digicert_Public.gpg

          sudo gpg --verify agent-client-collector-<version number>-<distro>_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
$ 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
          주:
          각 명령이 한 줄에 나타나야 합니다.
    3. 배포와 에이전트 클라이언트 수집기Linux 관련된 패키지 관리자를 사용하여 패키지를 설치합니다.
      OS 명령
      RHEL 기반 yum / dnf 로컬 설치
      SLES zypper 설치
      Debian 기반 apt-get install

      또는 이러한 명령이 올바르게 구성되지 않은 경우 패키지 관리자 명령으로 실행하도록 구성된 핵심 명령을 사용할 수 있습니다.

      • RPM 기반 시스템: # rpm -vi agent-client-collector-<version number>-x86_64.rpm
      • Debian 기반 시스템: # dpkg -i agent-client-collector-<version number>-<distro>_amd64.deb

      시스템 관리자를 통해 패키지 명령이 올바르게 구성되었는지 확인합니다.

      주:
      일부 파일 시스템에는 제한이 있을 수 있습니다. 예를 들어 /var/은 noexec 플래그와 함께 탑재될 수 있습니다. 에이전트는 일반적으로 /var/cache 디렉터리에 저장되는 플러그인을 실행 에이전트 클라이언트 수집기 해야 하므로 옵션을 .rpm 매개변수로 사용하여 --relocate 설치 경로를 사용자 지정하고 애플리케이션을 특정 폴더에 배포해야 합니다.

      예: rpm -i --relocate /var/cache=/opt/cache agent-client-collector-<version_number>-x86_64.rpm

      다음 경로를 재배치할 수 있습니다.
      경로 메모
      /기타 업데이트할 때 acc.yml 파일의 매개변수도 allow-list 새 경로로 업데이트해야 합니다.
      /usr/공유 해당 사항 없음
      /var/캐시 /var 디렉터리를 업데이트하면 새 디렉터리 아래에 중첩된 모든 /var 하위 디렉터리가 유지됩니다.
      /var/log
      /var/실행
      /var
      /usr/lib/systemd/system/acc.service의 경로를 검토하여 예상대로 표시되는지 확인합니다.
    4. 머신과 함께 실행되는 CPU에 따라 관련 package upgrade 명령을 실행합니다.
      • 인텔 CPU: 
        sudo installer -pkg agent-client-collector-<version number>-macos_x64.pkg -target /
      • Apple 실리콘 CPU:
        sudo installer -pkg agent-client-collector-<version number>-macos_arm64.pkg -target /

      또한 이 명령은 업그레이드하기 전에 agent-id 및 구성 파일을 백업 및 복원합니다.

    5. acc.yml 구성 파일에서 다음을 수행합니다.
      1. 다음 매개변수를 설정합니다.
        매개변수 값
        backend-url "<게이트웨이 URL>"
        MID 없이 연결 예
        인스턴스-URL "<인스턴스 URL>"
        등록 키 "<등록 키>"
        insecure-skip-tls-verify 아니오
      2. 매개변수를 주석으로 api-key 처리합니다.
    6. 구성 파일을 저장합니다.
    7. sudoer를 구성합니다.

      구성은 일반적으로 시스템 관리자에 의해 자동화됩니다 Linux . 수동으로 구성하려면 전체 구성 전에 정확성을 보장하려면 다음을 실행합니다.

      # visudo -f /etc/sudoers.d/01_servicenow
User_Alias ACC_USERS = servicenow
Cmnd_Alias ACC_CMD = /usr/sbin/dmidecode -s baseboard-serial-number,/usr/sbin/dmidecode -s chassis-serial-number,/usr/sbin/dmidecode -s system-serial-number,/usr/sbin/dmidecode -s system-uuid,/usr/sbin/ss -tanp
ACC_USERS ALL = (root) NOPASSWD:ACC_CMD
Defaults:ACC_USERS !requiretty
    8. 서비스로 실행될 에이전트를 구성합니다.
      1. 표시된 값을 /usr/lib/systemd/system/acc.service 파일에 추가하여 리소스 소비를 방지합니다.
        • CPU 공유=128
        • CPUQuota=10%
        • 메모리 제한=192M
        • 블록IOWeight=10
        • 한도니스=15

        예:

        # 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. acc 서비스를 활성화한 후 서비스 파일을 수정한 경우 디먼을 다시 로드하는 명령을 실행합니다.

        # systemctl daemon-reload

      3. 다음 명령을 실행하여 서비스를 활성화하고 시작합니다.

        # systemctl ACC 사용

        # systemctl 시작 계정