MID ベースの ACC から MID なし ACC への変換

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

    • acc.yml の構成を調整することで MID ベースのエージェントクライアントコレクター (ACC) を MID なし ACC に変換し、特定の MID から切り離すことで、柔軟性と適応性を向上させます。

    始める前に

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

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

    詳細については、「Agent Client Collector user roles」を参照してください。

    手順

    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。

      • insecure-skip-tls-verify：false
      • registration-key：<registration key value>

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

    6. API キーパラメーターをコメントアウトします。
      api-key: "encrypted....”
    7. ファイルを保存します。
    8. オペレーティングシステムに基づいてファイルを削除します。
      • 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 ファイルを削除します。
    9. オペレーティングシステムに基づいて、次のフォルダーを削除します。
      • 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 フォルダーを削除します。
    10. オペレーティングシステムに基づいて ACC サービスを開始します。
      • Windows の場合は、アドミニストレーターとして Services を開き、エージェントクライアントコレクターサービスを開始します。
      • macOS の場合は、コマンド sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist を使用します。