---
sourceDocument: 호주 IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/it-operations-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# 대용량 ACC 업그레이드 수행

# 대용량 에이전트 클라이언트 수집기 업그레이드 수행 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

모든 에이전트를 한 번에 업그레이드하려는 경우 에이전트의 에이전트 클라이언트 수집기 대량 업그레이드를 수행합니다.

## 시작하기 전에

에이전트 클라이언트 수집기 웹 서버를 구성합니다. 자세한 내용은 [MID 서버에서 웹소켓 서버 구성](https://servicenow-prod.fluidtopics.net/bQWDwR0yis1Bd04~G2cYzA "에이전트MID 서버에서 로 연결할 수 있도록 웹소켓 서버를 MID 서버 구성합니다. 당 MID 서버하나의 웹소켓 서버만 구성할 수 있습니다.") 문서를 참조하십시오.

, MID 웹 서버및 MID 서버 웹소켓 서버가 실행 중인지 MID 서버확인하십시오.  
에이전트를 업그레이드할 버전을 선택합니다.

1. 다음으로 이동 모두시스템 속성모든 속성.
2. 새로 만들기를 선택합니다.
3. 다음 값을 할당합니다.
   * 이름 = sn_agent.agent_upgrade_version
   * 유형 = 문자열
   * 값 = 업그레이드할 버전 번호(\<major_version.minor_version.patch_version\> 형식) 예: 4.3.2
   {#acc-high-volume-upgrade__ul_slp_wwp_chc}
4. 제출을 선택합니다.

{#acc-high-volume-upgrade__ol_oyg_qvp_chc}버전을 선택하지 않으면 에이전트가 현재 에이전트 클라이언트 수집기 프레임워크 범위가 지정된 앱 버전으로 자동 업그레이드합니다.  
필요한 역할: agent_client_collector_admin

* Windows 환경에서: 로컬 SYSTEM 계정
* Linux 환경에서: sudo rpm/dpkg
* macOS 환경에서: sudo pkg
{#acc-high-volume-upgrade__ul_pbl_5w3_y2c}

## 이 태스크 정보

대용량 업그레이드는 OR Linux 환경에서만 Windows 지원됩니다.

대용량 업그레이드는 mTLS를 MID 서버 통한 통신을 지원하지 에이전트 클라이언트 수집기 않습니다.

대용량 업그레이드를 수행할 때 최신 버전을 사용하지 않는 모든 에이전트가 업그레이드됩니다. 업그레이드된 버전을 이미 사용 중인 에이전트에서는 업그레이드가 수행되지 않습니다.

애플리케이션 범위를 벗어난 에이전트에서는 업그레이드가 수행되지 않습니다. 자세한 내용은 [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=australia&pubname=australia-application-development&ft:locale=en-US) 문서를 참조하십시오.  
에이전트의 업그레이드 실패 제한에 도달하면 에이전트는 대용량 업그레이드에서 제외됩니다. 실패한 업그레이드 제한은 시스템 속성에 sn_agent.auto_upgrade.retry_limit 지정되어 있습니다. 이 속성의 기본값은 3입니다.

* 이 속성은 실패한 대용량 업그레이드와 선택적 업그레이드 모두에 적용됩니다.
* 에이전트가 업그레이드 실패 제한에 도달해도 에이전트 클라이언트 수집기 관리자는 에이전트에서 선택적 업그레이드를 계속 실행할 수 있습니다.
* 에이전트 페이지에서 실패한 업그레이드 시도 재설정 옵션을 선택하여 실패한 업그레이드 제한을 수동으로 재설정할 수 있습니다( 모두에이전트 클라이언트 수집기에이전트 을 클릭하고 에이전트 선택).
* 업그레이드에 성공한 후 업그레이드된 에이전트는 업그레이드 실패가 0건(향후 업그레이드의 경우)이 없는 것으로 간주됩니다.
{#acc-high-volume-upgrade__ul_ejj_3qp_chc}

## 프로시저

1. 업그레이드할 버전 번호를 사용할 수 있는지 확인합니다.
   1. 다음으로 이동 모두시스템 속성모든 속성.
   2. 속성을 찾습니다 sn_agent.agent_version .  
      표시된 버전 번호가 에이전트가 업그레이드될 버전을 나타내는 유효한 에이전트 버전인지 확인합니다. 버전 번호가 잘못되면 버전이 해당 번호로 업데이트됩니다 sn_agent.agent_version .
   {#acc-high-volume-upgrade__substeps_pw3_dzj_y2c}
2. 시스템 속성 테이블에서 속성을 활성화합니다(모두시스템 속성모든 속성)을 클릭하여 업그레이드를 활성화합니다.
   1. 속성을 찾습니다 sn_agent.auto_upgrade.enabled .
   2. 속성 값을 true로 설정합니다.  
      속성을 활성화한 후 1분 이내에 업그레이드가 시작됩니다.
   {#acc-high-volume-upgrade__substeps_jxy_zbk_y2c}

## 결과

* 에 연결된 MID 서버에이전트의 경우: 예약된 작업은 시간당 각각 MID 서버 50개의 에이전트를 업그레이드합니다. 모든 MID 서버 에이전트에 대해 한 번에 업그레이드할 수 있는 최대 에이전트 수는 1,000개입니다.
* MID 없는 에이전트의 경우: 예약된 작업은 기본적으로 시간당 최대 1,000명의 에이전트를 업그레이드합니다.
* 에이전트 및 MID가 없는 에이전트 모두 MID 서버 의 경우: 한 번에 업그레이드되는 에이전트 수를 수정하려면 속성 값 sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour (모두시스템 속성모든 속성). 기본값은 1,000입니다.  
  주:  
  이 값을 수정하면 시스템 성능에 부정적인 영향을 줄 수 있습니다.
{#acc-high-volume-upgrade__ul_e4p_dqk_fhc}

업그레이드 빈도를 수정하려면 업그레이드 에이전트 증분 예약 작업(모두시스템 정의예약된 작업).