大量の エージェントクライアントコレクター アップグレードを実行

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：2分

    • すべてのエージェントを一度にアップグレードする場合は、 エージェントクライアントコレクター エージェントの大量アップグレードを実行します。

    始める前に

    エージェントクライアントコレクター の Web サーバーを構成します。詳細については、「MID サーバー での Websocket サーバーの構成」を参照してください。

    MID サーバー、MID Web サーバー、および MID サーバー Websocket サーバーが実行されていることを確認します。

    必要なロール: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 分以内に開始されます。

    タスクの結果

    スケジュール済みジョブは、1 時間あたり MID サーバー 50 エージェントをアップグレードします。
    • エージェントが正常にアップグレードされましたが、[ Agent Client Collectors ] ページに表示されます (すべて > エージェントクライアントコレクター > エージェント)をクリックし、[ バージョン ] 列にターゲットバージョンを表示します。
    • [エージェントクライアントコレクター] ページで選択したエージェントの [ Agent Upgrade Histories ] タブには、次の情報が表示されます。
      • [ 状態 ] 列には、アップグレードの進行状況 (Success または Failed) が表示されます。
      • [ メッセージ ] 列には、特定のエージェントに関連するログが表示されます。
    • 正常にアップグレードされなかったエージェントには、前のバージョン番号が表示されます。これらのエージェントのアップグレードについては、「 障害が発生したエージェントに対して大量のアップグレードを繰り返す」を参照してください。

    一度にアップグレードするエージェントの数を変更するには、 sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour プロパティの値 (すべて > システムプロパティ > すべてのプロパティ) を開きます。すべての MID サーバー について一度に更新できるエージェントの最大数は 1,000 です。

    アップグレードの頻度を変更するには、[ エージェントの増分 アップグレード] スケジュール済みジョブの [繰り返し間隔] の値を更新します (すべて > システム定義 > スケジュール済みジョブ) を開きます。