인스턴스에서 에이전트 업그레이드

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

    • 클라우드에 배포된 에이전트와 같이 액세스하기 어려운 에이전트로 작업할 때 효율성을 높이기 위해 대량 업그레이드 대신 선택적 자체 업그레이드를 수행합니다. 한 번에 최대 20개의 에이전트에서 선택적 업그레이드를 수행할 수 있습니다.

    시작하기 전에

    주:
    에이전트 버전 2.7.0 이상에서는 선택적 업그레이드를 사용할 수 있습니다.

    지원되는 운영 체제는 Windows 및 Linux입니다.

    호스트 데이터를 다시 시작 MID 서버 하고 수집하여 데이터 파일을 최신 상태로 유지하십시오. 호스트 데이터 수집에 대한 자세한 내용은 다음 문서를 참조하십시오 요청 시 호스트 데이터 수집 실행.

    주:
    Linux 환경에서 작업할 때는 sudo 권한이 있고 다음 구성이 설정되어 있는지 확인합니다.
    표 1. Linux 운영 체제
    OS OS 버전 명령 에이전트 버전
    CentOS,Red Hat 7, 8
    • /usr/bin/systemctl 시작 acc
    • /usr/bin/systemctl 중지 acc
    • <systemctl location> daemon-reload(기본 위치: /usr/bin)
    • /usr/bin/rpm -Uv <캐시 디렉터리 위치>/upgrade/agent-client-collector-upgrade.rpm

    기본 캐시 디렉터리 위치: /var/cache/servicenow/agent-client-collector

    • unzip -o: 서명 파일의 압축을 해제하여 설치를 확인합니다.
    • openssl dgst -sha256 -verify: ServiceNow 설치 파일에서 서명 사용을 검증합니다.
    주:
    --relocate 플래그를 사용하여 에이전트를 Linux 설치한 경우(예: 
    rpm -i --relocate /var/cache=/opt/cache
      agent-client-collector-<version_number>-x86_64.rpm
    )을 사용하려면 다음 명령을 실행할 수 있는 권한이 있어야 합니다.
    • sudo /usr/bin/rpm -q --queryformat '[%{PREFIXES}\\n]' agent-client-collector
    • sudo /usr/bin/rpm -q --queryformat '[%{INSTPREFIXES}\\n]' agent-client-collector
    이러한 명령은 업그레이드 스크립트에서 원래 재배치를 탐지하고 올바른 업그레이드 명령을 생성하는 데 사용됩니다. 재배치 명령을 사용하지 않고 업그레이드하면 설치에 실패할 수 있습니다.
    		 2.7
    데비안, 우분투
    • /usr/bin/systemctl 시작 acc
    • /usr/bin/systemctl 중지 acc
    • <systemctl location> daemon-reload(기본 위치: /usr/bin)
    • /usr/bin/dpkg --install --refuse-downgrade --skip-same-version <캐시 디렉터리 위치>/upgrade/agent-client-collector-upgrade.deb

    기본 캐시 디렉터리 위치: /var/cache/servicenow/agent-client-collector

    • unzip -o: 서명 파일의 압축을 해제하여 설치를 확인합니다.
    • gpg -import &; gpg --verify: ServiceNow 설치 파일에서 서명 사용을 검증합니다.
    		 2.7
    를 통해 MID 서버연결하는 경우 ACC 설치는 다음 URL 중 하나에 액세스해야 합니다.
    • https://<MID-WEBSERVER-URI:PORT>/STATIC/acc_installers/agent-client-collector
    • https://install.service-now.com/
    MID 없는 에이전트를 업그레이드할 때 acc.yml 파일의 속성에 agent-upgrade-url-path 설정된 URL에서 업그레이드가 수행됩니다. 이 속성에 URL이 설정되어 있지 않으면 CDN(콘텐츠 배달 네트워크) URL에서 설치 관리자 스크립트를 다운로드하여 업그레이드를 수행합니다. https://cdn-install.sncapps.service-now.com/glide/distribution/builds/package
    주:
    CDN을 사용하는 경우 보안 강화를 위해 프록시 서버를 통해 다운로드 요청을 보냅니다. 자세한 내용은 CDN(콘텐츠 전송 네트워크)을 사용하여 MID 없는 업그레이드를 수행할 때 프록시 구성 문서를 참조하십시오.
    에이전트를 업그레이드할 버전을 선택합니다.
    1. 다음으로 이동 모두 > 시스템 속성 > 모든 속성.
    2. 새로 만들기를 선택합니다.
    3. 다음 값을 할당합니다.
      • 이름 = sn_agent.agent_upgrade_version
      • 유형 = 문자열
      • 값 = 업그레이드할 버전 번호(<major_version.minor_version.patch_version> 형식) 예: 4.3.2
    4. 제출을 선택합니다.
    버전을 선택하지 않으면 에이전트가 현재 에이전트 클라이언트 수집기 프레임워크 범위가 지정된 앱 버전으로 자동 업그레이드합니다.

    필요한 역할:

    • Windows: 로컬 SYSTEM 계정(에이전트 클라이언트 수집기 다음으로 Local System실행 중인 서비스)
    • Linux: sudo rpm/dpkg
    • macOS: sudo 패키지

    이 태스크 정보

    에이전트 클라이언트 수집기는 다음 운영 체제에서 선택적 자체 업그레이드를 지원합니다.
    • Windows: UAC 제한으로 인해 Windows 에이전트는 로컬 SYSTEM 계정으로 실행하여 업그레이드를 수행 msiexec해야 합니다.
    • Linux: RPM 및 DEB

    프로시저

    1. 다음으로 이동 모두 > 에이전트 클라이언트 수집기 > 에이전트.
    2. 업그레이드할 에이전트를 선택합니다.
    3. 관련 링크 섹션에서 에이전트 업그레이드를 선택합니다.
    4. 확인 대화 상자에서 업그레이드를 선택합니다.
      에이전트 업그레이드 이력 페이지가 나타나면 성공 또는 실패가 표시되는 상태 열에서 업그레이드 진행 상황을 모니터링할 수 있습니다.
    5. 메시지 열에서 에이전트 업그레이드에 대한 로그를 봅니다.
      시스템에서 업그레이드 Linux 에 실패한 경우 <캐시 디렉터리 위치>/upgrade/agent-client-collector-upgrade.rpm 파일로 이동하여 위의 운영 체제 테이블에 따라 Linux 관련 OS에 대한 구성이 설정되어 있는지 확인합니다.
      컴퓨터에서 업그레이드 Windows 에 실패한 경우 <user 폴더>\AppData\Local\Temp\ACC_Logs에 있는 관련 로그 파일을 확인하십시오.
      • ACC 로그: ACC_Upgrade.log
      • MSI 로그: MSI_ACC_Upgrade.log