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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

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

    始める前に

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

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

    エージェントをアップグレードするバージョンを選択します。
    1. 移動先 すべて > システムプロパティ > すべてのプロパティ.
    2. [新規] を選択します。
    3. 次の値を割り当てます。
      • 名前 = sn_agent.agent_upgrade_version
      • タイプ = 文字列
      • 値 = アップグレード先のバージョン番号 (<major_version.minor_version.patch_version> の形式)。例: 4.3.2
    4. [送信] を選択します。
    バージョンを選択しない場合、エージェントは現在の エージェントクライアントコレクターフレームワーク スコープ対象のアプリバージョンに自動的にアップグレードします。
    必要なロール:agent_client_collector_admin
    • Windows環境の場合:ローカルSYSTEMアカウント
    • Linux環境の場合:sudo rpm / dpkg
    • macOS環境の場合:sudo pkg

    このタスクについて

    大量アップグレードは、 Windows 環境または Linux 環境でのみサポートされています。

    大容量アップグレードでは、mTLS を介したMID サーバー通信へのエージェントクライアントコレクターはサポートされていません。

    大量のアップグレードを実行すると、最新バージョンを使用していないすべてのエージェントがアップグレードされます。アップグレードされたバージョンを既に使用しているエージェントには、アップグレードは実行されません。

    アプリケーションスコープ外のエージェントではアップグレードは実行されません。詳細については、「 Application scope」を参照してください。

    エージェントの失敗したアップグレード制限に達すると、エージェントは大量アップグレードから除外されます。失敗したアップグレードの制限は、 sn_agent.auto_upgrade.retry_limit システムプロパティで指定されます。このプロパティのデフォルト値は 3 です。
    • このプロパティは、失敗した大量アップグレードと選択的アップグレードの両方に適用されます。
    • エージェントが失敗したアップグレード制限に達した場合でも、 エージェントクライアントコレクター アドミニストレーターはエージェントで選択的アップグレードを実行できます。
    • 失敗したアップグレード制限を手動でリセットするには、エージェントページで [ 失敗したアップグレード試行をリセット] オプションを選択します (選択 すべて > エージェントクライアントコレクター > エージェント エージェントを選択します)。
    • アップグレードが正常に完了すると、アップグレードされたエージェントは (将来のアップグレード用) 失敗したアップグレードがゼロと見なされます。

    手順

    1. アップグレード先のバージョン番号が利用可能であることを確認します。
      1. 移動先 すべて > システムプロパティ > すべてのプロパティ.
      2. sn_agent.agent_version プロパティを見つけ出します。
        表示されたバージョン番号が、エージェントがアップグレードされるバージョンを表す有効なエージェントバージョンであることを確認します。バージョン番号が有効でない場合、バージョンは sn_agent.agent_version 番号に更新されます。
    2. システムプロパティテーブルのプロパティを有効にします (すべて > システムプロパティ > すべてのプロパティ) をクリックしてアップグレードをアクティブ化します。
      1. sn_agent.auto_upgrade.enabled プロパティを見つけ出します。
      2. このプロパティの値を true に設定します。
        アップグレードは、プロパティを有効にしてから 1 分以内に開始されます。

    タスクの結果

    • MID サーバーに接続されているエージェントの場合:スケジュール済みジョブは、各MID サーバーで 1 時間あたり 50 人のエージェントをアップグレードします。すべての MID サーバー で一度にアップグレードできるエージェントの最大数は 1,000 です。
    • MID なしエージェントの場合:スケジュール済みジョブは、デフォルトで 1 時間あたり最大 1,000 エージェントをアップグレードします。
    • MID サーバーエージェントと MID なしエージェントの両方の場合:一度にアップグレードするエージェントの数を変更するには、sn_agent.auto_upgrade.max_upgrades_per_handler_per_hour プロパティの値を更新します (すべて > システムプロパティ > すべてのプロパティ) を開きます。デフォルト値は 1,000 です。
      注:
      この値を変更すると、システムのパフォーマンスに悪影響を与える可能性があります。

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