インスタンス内のエージェントのアップグレード

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

    • クラウドに展開されたエージェントなど、アクセスが困難なエージェントを操作する場合は、一括アップグレードの代わりに選択的セルフアップグレードを実行して効率を向上できます。一度に最大 20 のエージェントに対して選択的アップグレードを実行できます。

    始める前に

    注:
    選択的アップグレードは、エージェントのバージョン 2.7.0 以降で使用できます。

    サポートされているオペレーティングシステム：Windows および Linux。

    MID サーバーを再起動してホストデータを収集して、データファイルが最新であることを確認します。ホストデータの収集の詳細については、「 オンデマンドでホストデータの収集を実行する」を参照してください。

    注:
    Linux 環境で作業する場合は、sudo 権限があり、次の構成が設定されていることを確認してください。
    表 : 1. Linux オペレーティングシステム
    OS OS バージョン コマンド エージェントのバージョン
    CentOS、Red Hat 7、8
    • /usr/bin/systemctl start acc
    • /usr/bin/systemctl stop acc
    • <systemctl location> daemon-reload (デフォルトの場所は /usr/bin)
    • /usr/bin/rpm -Uv <cache dir location>/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
    Debian、Ubuntu
    • /usr/bin/systemctl start acc
    • /usr/bin/systemctl stop acc
    • <systemctl location> daemon-reload (デフォルトの場所は /usr/bin)
    • /usr/bin/dpkg --install --refuse-downgrade --skip-same-version <cache dir location>/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 pkg

    このタスクについて

    エージェントクライアントコレクター は、次のオペレーティングシステムで選択的セルフアップグレードをサポートしています。
    • Windows：Windows UAC の制限により、msiexec を介してアップグレードを実行するには、エージェントをローカル SYSTEM アカウントとして実行する必要があります。
    • Linux：RPM および DEB

    手順

    1. 移動先 すべて > エージェントクライアントコレクター > エージェント.
    2. アップグレードするエージェントを選択します。
    3. [関連リンク] セクションで、[エージェントをアップグレード] を選択します。
    4. [確認] ダイアログボックスで [アップグレード] を選択します。
      [エージェントアップグレード履歴] ページが表示され、[ステータス] 列で [成功] または [失敗] のいずれかが表示され、アップグレードの進行状況を監視できます。
    5. [メッセージ] 列でエージェントのアップグレードのログを表示します。
      Linux マシンでアップグレードが失敗した場合は、<キャッシュディレクトリの場所>/upgrade/agent-client-collector-upgrade.rpm ファイルに移動し、上記の Linux オペレーティングシステムのテーブルに基づいて、適切な OS 用の構成が設定されていることを確認します。
      Windows マシンのアップグレードが失敗した場合は、<user folder>\AppData\Local\Temp\ACC_Logs にある関連するログファイルを確認します。
      • ACC ログ：ACC_Upgrade.log
      • MSI ログ：MSI_ACC_Upgrade.log