一括展開のためのカスタムベースイメージへの エージェントクライアントコレクター の組み込み

マシンのベースイメージを使用した一括展開で、仮想マシンに エージェントクライアントコレクター を展開します。一括展開ではサイレントインストールが使用されるので、インストールステータスは非表示になります。

始める前に

KB 記事「サービスとしてログオン (Log on as a service) 機能で Windows サービスアカウントを作成する」の説明に従い、Microsoft SCCM を使用してデバイスの展開とセキュリティを管理します。

必要なロール：agent_client_collector_admin

手順

1. 移動先 すべて > エージェントクライアントコレクター > エージェントのダウンロード.
2. 該当する OS のインストールファイルをダウンロードします。
3. 該当する OS の指示に従ってエージェントをインストールします。
4. 次のコマンドを実行して、エージェントサービスを停止します。
   • Windows 環境の場合：sc stop AgentClientCollector コマンドを実行します。
   • Linux 環境の場合：sudo systemctl stop acc コマンドを実行します。
5. acc.yml ファイルに暗号化された API キーが含まれていないことを確認します。
   例：api-key: "<insert plain text API key here>"
6. エージェントのキャッシュディレクトリの内容を削除し、ディレクトリ構造をそのまま維持します。
   • Windows 環境の場合：C:\ProgramData\ServiceNow\agent-client-collector\cache
   • Linux 環境の場合：/var/cache/servicenow/agent-client-collector
7. Windows マシンにインストールする場合は、次のいずれかを実行して、インストールが正常に完了したことを確認します。
   • サイレントインストールのログ記録を有効にし、ログファイルの末尾に「Windows Installer installed the product」の文字列があることを確認します。
   • AgentClientCollector サービスのステータスが Running になっていることを確認します。
8. Linux マシンにインストールする場合は、エージェントがインストールされているマシンにアクセスし、次のいずれかの方法で /usr/share/servicenow/agent-client-collector/serial_number.txt ファイルを変更します。
   • 次のコマンドを実行して、ホストのシリアル番号を使用してファイルの内容を変更します：sudo -n dmidecode -s system-serial-number
   • servicenow ユーザーに sudo 権限を割り当てて、次の osqueryi コマンドを実行できるようにします：sudo -E env "PATH=$PATH" osqueryi --logger_min_status=3 --line "select hardware_serial from system_info"

   注:

   ホストの CI の破損を避けるために、展開後に仮想マシンのホスト名を一意の値に変更する必要があります。
9. 展開後の手順として、エージェントサービスを再起動します。
   • Windows 環境の場合：sc start AgentClientCollector コマンドを実行します。
   • Linux 環境の場合：sudo systemctl start acc コマンドを実行します。