インスタンス間での ACC の切り替え

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

    • エージェントクライアントコレクター (ACC) を別のインスタンスに切り替えます。

    始める前に

    エージェントクライアントコレクター (ACC) がインストールされており、ACC 登録キーがセットアップされていることを確認します。セットアップとインストールの手順については、以下を参照してください。

    必要なロール：agent_admin および agent_client_collector_admin

    ロールに関する詳細については、「Agent Client Collector user roles」を参照してください。

    このタスクについて

    ACC が既に 1 つのインスタンスに接続されている場合は、acc.yml の構成を変更してエージェントを別のインスタンスに切り替えることができます。

    手順

    1. オペレーティングシステムに適した手順で ACC を停止します。
      • Windows の場合は、アドミニストレーターとしてサービスにアクセスし、エージェントクライアントコレクターサービスを停止します。
      • macOS の場合は、コマンド sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist; を実行します。
    2. acc.yml ファイルを開きます。
      • Windows：C:\ProgramData\ServiceNow\agent-client-collector\config
      • macOS：/Library/Application\ Support/servicenow/agent-client-collector/
    3. <ITOM Cloud Services Gateway> を指すように backend-url パラメーターを編集します。
      インスタンスの場所に基づいて、次のいずれかのゲートウェイを使用します。
      • AMER: itomcnc-prod-gateway-amer.sncapps.service-now.com:443
      • EMEA: itomcnc-prod-gateway-emea.sncapps.service-now.com:443
      • APAC: itomcnc-prod-gateway-apac.sncapps.service-now.com:443

      エージェントが ITOM Cloud Services Gateway を使用する方法の詳細については、「DEX アーキテクチャ」を参照してください。

    4. 次のパラメーターを更新します。
      • connect-without-mid：true
      • instance-url: <full_instance_url> (例：https://dex.servicenow.com)
      • registration-key: <registration key value>

        登録キーの作成方法の詳細については、「ACC 登録キーの作成」を参照してください。

    5. ファイルを保存します。
    6. オペレーティングシステムに基づいてファイルを削除します。
      • Windows の場合、/agent-client-collector/config/cert/cnc に移動し、cnc_chain.crt ファイルと priv_key.pem.go ファイルを削除します。
      • macOS の場合、/Library/Application Support/servicenow/agent-client-collector/cert/cnc にアクセスし、cnc_chain.crt ファイルと priv_key.pem ファイルを削除します。
    7. オペレーティングシステムに基づいて、次のフォルダーを削除します。
      • Windows の場合は、/agent-client-collector/cache フォルダーを削除します。
      • macOS の場合：
        • エージェント 3.4.1 以降の場合は、/Library/Application Support/servicenow/agent-client-collector/cache フォルダーを削除します。
        • エージェント 3.4.0 以前の場合は、/Library/Caches/servicenow/agent-client-collector フォルダーを削除します。
    8. オプション: この ACC を別のインスタンスに接続したことがある場合は、次の手順を実行します。
      1. デバイスシリアル番号をコピーします。
      2. エージェントクライアントコレクターテーブル (sn_agent_cmdb_ci_agent) で、デバイスのシリアル番号を使用して検索します。
        注:
        [エージェント ID] 列が利用できない場合は、この列をリストビューに追加します。
      3. レコードが見つかった場合は、レコードのエージェント ID をコピーします。
      4. エージェント登録テーブル (sn_agent_agent_registration) で、レコードのエージェント ID を使用して検索します。
      5. 検索で検出されたレコードをすべて削除します。
    9. オペレーティングシステムに固有の手順に従って、ACC サービスを開始します。
      • Windows の場合は、アドミニストレーターとしてサービスを開き、エージェントクライアントコレクターを開始します。
      • macOS の場合は、コマンド sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist を使用します。