あるインスタンスから別のインスタンスへの ACC の切り替え

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

始める前に

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

• ACC 登録キーの作成。
• Install Agent Client Collector on a Windows machine manuallyまたは Manually install Agent Client Collector on macOS。

必要なロール：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 で、管理者として Services を開き、エージェントクライアントコレクターを開始します。
   • macOSで、sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist コマンドを使用します。