MID なしエージェントクライアントコレクターmacOS環境に手動でインストールする

MID なし エージェントクライアントコレクター を macOS マシンに手動でインストールして、クラウドを介してエージェントからインスタンスにデータを送信できるようにします。クラウドを介して情報を送信すると、 MID サーバー をより永続的なリソースに使用できます。

始める前に

• ITOM Cloud Services Core (sn_itom_cloud_svc) プラグインをインストールします。
• ITOM Cloud Services を使用するようにインスタンスをオンボーディングします。詳細については、カスタマーサポートにお問い合わせください。
• エージェント登録キーを構成します。詳細については、「エージェント登録キーを構成する」を参照してください。
• 必要なロール：agent_client_collector_admin

このタスクについて

MID なし展開でクラウド経由でデータを送信する方法の詳細については、「 DEX Architecture」を参照してください。

手順

1. インストールファイルをローカルマシンにダウンロードします。

   curl -L <download link from the Agent Downloads page on the instance>

2. インストールファイルの署名を検証します。

   pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg

   注:

   pkg 証明書チェーンに ServiceNow 開発者 ID インストーラー証明書があることを確認します。
3. エージェントクライアントコレクター パッケージをインストールします。

   sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. インストールファイルをコピーします。
   1. 構成ファイルの例：
      sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\ Support/servicenow/agent-client-collector/acc.yml
   2. 許可リストファイルの例：
      sudo cp -p /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json
5. オプション: 許可リストに含める新しいチェック定義を作成するには、最初に acc.yml ファイルの allow-list パラメーターをコメントアウトして、許可リストを無効にします。

   sudo -H -u _servicenow vi /Library/Application\ Support/servicenow/agent-client-collector/acc.yml

   注:

   このアクションはシステムのセキュリティ侵害になるので、許可リストの更新が完了するまでの一時的な手段として限定的に使用することをお勧めします。更新が完了したら、構成ファイルの許可リストパラメーターをコメント解除し、許可リストを再度有効化します。

   カスタムチェックを許可リストに追加する方法の詳細については、「エージェントクライアントコレクター 許可リストの生成」を参照してください。

6. acc.yml構成ファイルで、次の操作を行います。
   1. 次のパラメーターを設定します。

      パラメーター	値
      backend-url	「<ゲートウェイ URL>」
      connect-without-mid	true
      instance-url	「<インスタンス URL>」
      registration-key	"<regsitration-key>"
      insecure-skip-tls-verify	false

   2. api-keyパラメーターをコメントアウトします。
7. 構成ファイルを保存します。
8. 構成ファイルが有効なエンドポイントを指すようにするには、次のコマンドを実行して、エージェントクライアントコレクターを再起動します。

   sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
   sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist

   注:

   デフォルトでは、インストールプログラムを終了するとすぐに再起動します。終了後もプログラムが停止したままになるようにするには、/Library/LaunchDaemons/com.sn.acc.plist ファイルの KeepAlive プロパティを false に設定します。