あるインスタンスから別のインスタンスへの ACC の変換

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

    • エージェントクライアントコレクター (ACC) インスタンスを監視用に変換して、データ収集、可視化、ツールの互換性を強化したり、特定の監視ニーズを満たしたりします。

    始める前に

    ACC 登録キーがセットアップされ、ACC がインストールされていることを確認します。セットアップとインストールの方法については、以下を参照してください。

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

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

    このタスクについて

    エージェントクライアントコレクター (ACC) がすでに 1 つのインスタンスに接続されている場合は、acc.yml の構成を変更してエージェントを別のインスタンスに変換できます。

    手順

    1. オペレーティングシステムに適した手順で ACC を停止します。
      • Windows の場合は、アドミニストレーターとして Services にアクセスし、エージェントクライアントコレクターサービスを停止します。
      • Mac の場合は、コマンド sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist; を実行します。
    2. acc.yml ファイルを開きます。
    3. 新しいインスタンスへのインスタンス URL を編集します。
    4. <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 アーキテクチャ」を参照してください。

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

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

    6. パラメーター api-key: "encrypted....” をコメントアウトします。
    7. ファイルを保存します。
    8. オペレーティングシステムに基づいてファイルを削除します。
      • Windows の場合、/agent-client-collector/config/cert/cnc に移動し、cnc_chain.crt ファイルと priv_key.pem.go ファイルを削除します。
      • Mac の場合、/Library/Application Support/servicenow/agent-client-collector/cert/cnc にアクセスし、cnc_chain.crt ファイルと priv_key.pem ファイルを削除します。
    9. オペレーティングシステムに基づいて、次のフォルダーを削除します。
      • Windows の場合、/agent-client-collector/cache フォルダーを削除します。
      • Mac の場合：
        • エージェント 3.4.1 以降の場合は、/Library/Application Support/servicenow/agent-client-collector/cache フォルダーを削除します。
        • エージェント 3.4.0 以前の場合は、/Library/Caches/servicenow/agent-client-collector フォルダーを削除します。
    10. オペレーティングシステムに固有の手順に従って、ACC サービスを開始します。
      • Windows の場合は、アドミニストレーターとして Services を開き、エージェントクライアントコレクターサービスを開始します。
      • Mac の場合は、コマンド sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist を使用します。