대용량 에이전트 클라이언트 수집기 업그레이드 수행

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 2분
  • 모든 에이전트를 한 번에 업그레이드하려는 경우 에이전트의 에이전트 클라이언트 수집기 대량 업그레이드를 수행합니다.

    시작하기 전에

    에이전트 클라이언트 수집기 웹 서버를 구성합니다. 자세한 내용은 MID 서버에서 웹소켓 서버 구성 문서를 참조하십시오.

    , MID 웹 서버MID 서버 웹소켓 서버가 실행 중인지 MID 서버확인하십시오.

    필요한 역할: agent_client_collector_admin
    • Windows 환경에서: 로컬 SYSTEM 계정
    • Linux 환경에서: sudo rpm/dpkg
    • macOS 환경에서: sudo pkg

    이 태스크 정보

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

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

    프로시저

    1. 업그레이드할 버전 번호를 사용할 수 있는지 확인합니다.
      1. 다음으로 이동 모두 > 시스템 속성 > 모든 속성.
      2. 속성을 찾습니다 sn_agent.agent_version .
        열에 표시되는 숫자는 업그레이드할 수 있는 버전 번호입니다.
    2. 시스템 속성 테이블에서 속성을 활성화합니다(모두 > 시스템 속성 > 모든 속성)을 클릭하여 업그레이드를 활성화합니다.
      1. 속성을 찾습니다 sn_agent.auto_upgrade_enabled .
      2. 속성 값을 true로 설정합니다.
        속성을 활성화한 후 1분 이내에 업그레이드가 시작됩니다.

    결과

    예약된 작업은 시간당 각각 50개의 에이전트를 MID 서버 업그레이드합니다.
    • 성공적으로 업그레이드된 에이전트가 페이지에 표시됩니다 Agent Client Collectors (모두 > 에이전트 클라이언트 수집기 > 에이전트)을 클릭하면 버전 열에 대상 버전이 표시됩니다.
    • Agent Upgrade Histories Agent Client Collector 페이지에서 선택한 에이전트의 탭은 다음 정보를 제공합니다.
      • 상태 열은 업그레이드 진행률(Success 또는 Failed)을 나타냅니다.
      • 메시지 열에는 특정 에이전트와 관련된 로그가 표시됩니다.
    • 성공적으로 업그레이드되지 않은 에이전트에는 이전 버전 번호가 표시됩니다. 이러한 에이전트 업그레이드에 대한 자세한 내용은 다음 문서를 참조하십시오 실패한 에이전트에 대해 대용량 업그레이드 반복.

    한 번에 업그레이드되는 에이전트 수를 수정하려면 속성 값 sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour (모두 > 시스템 속성 > 모든 속성). 전체 MID 서버 에이전트에 대해 한 번에 업데이트할 수 있는 최대 에이전트 수는 1,000개입니다.

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