日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Workload Security エージェントとコレクターの手動インストール

10/14/2025 共同作成者

デフォルトでは、Workload Security エージェントまたはコレクターの新しいバージョンが利用可能になると、アップグレード前の通知が送信され、テナント上でエージェントとコレクターが自動的に更新されます。ただし、セキュリティで保護された制御された環境では、自動アップグレードは望ましくない場合があります。このような場合、Workload Security を設定してエージェントとコレクターを手動でインストール/アップグレードすることで、システムにインストールされているソフトウェアをより細かく制御できるようになります。

開始前の準備

Swagger で、「cloudsecure_installers.agent」および「cloudsecure_installers.collector」という名前の API カテゴリが使用可能であることを確認します。そうでない場合、エージェントの手動インストールのサポートは有効になりません。この機能を有効にするには、 NetAppサポートにお問い合わせください。
このドキュメントに記載されているすべてのコマンドを「root」ユーザーとして実行するか、別のユーザーで実行する場合は「sudo」を使用してコマンドを実行します。

新しいエージェントのインストール

新しい Workload Security API アクセストークンを作成します。
1. 管理 > API アクセス に移動します。「ワークロードセキュリティトークン」タブを選択し、「+ API アクセストークン」をクリックします。
  1. 識別しやすい名前と説明を設定します。
  2. 「このトークンはどのタイプの API を呼び出すために使用されますか?」ドロップダウンで、Collector Management と Agent & Collector Installation を選択します。
  3. 希望する有効期限を選択します。
2. [保存]をクリックします。

生成された API アクセストークンをコピーします。ウィンドウを閉じるとトークンを取得できなくなることに注意してください。その場合、新しいトークンを生成する必要があります。
1. 管理 > API アクセス > API ドキュメント (ページの右上) に移動し、Workload Security アイコンを選択します。これにより、Workload Security API の Swagger ドキュメントが開きます。
2. Workload Security API へのアクセスを承認します。
ページの右上にある [承認] ボタンをクリックします。
_Customer ApiKey (apiKey)_テキストフィールドに、先ほどコピーしたAPIトークンを貼り付けます。ステップ1c 。
「承認」をクリックしてウィンドウを閉じます。
1. エージェントのインストーラーをダウンロードします。
Swagger で、cloudsecure_installers.agent > /v1/cloudsecure/agents/installers/{platform}/latest (GET) API を選択します。「試してみる」をクリックします。
platform フィールドに「linux」と入力します。 _実行_をクリックします。
「ファイルのダウンロード」をクリックしてインストーラーをダウンロードします。
インストーラファイルが、エージェントがインストールされるシステムとは別のマシンに外部的にダウンロードされた場合は、インストーラファイルをそのシステムにコピーします。

あるいは、curl コマンドをコピーして、エージェントをインストールするシステムで直接実行することもできます。

インストーラーファイルを任意の名前で保存するには、curl コマンドに「-o {{file_name}}」引数を追加します。インストーラーファイルの実際の名前は、Swagger 応答ヘッダーセクションにあります。その名前も使用される可能性があります。

ファイルは任意の場所にダウンロードできますが、インストーラー .zip を抽出できる空のフォルダーにダウンロードすることをお勧めします。

新しいフォルダーを作成し (推奨)、インストーラーファイルをこのフォルダーにコピーして解凍します。

[root@demo-agent /]# mkdir agent_installers
[root@demo-agent /]# cd agent_installers/
[root@demo-agent agent_installers]# pwd
/agent_installers
[root@demo-agent agent_installers]# ll
total 0
[root@demo-agent agent_installers]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/agents/installers/linux/latest" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cloudsecure-linux-agent-installer-1.617.0.zip
[root@demo-agent agent_installers]# ll
total 76012
-rw------- 1 root root 77834705 Apr 26 14:34 cloudsecure-linux-agent-installer-1.617.0.zip

[root@demo-agent agent_installers]# unzip cloudsecure-linux-agent-installer-1.617.0.zip
Archive:  cloudsecure-linux-agent-installer-1.617.0.zip
  inflating: cloudsecure-agent-image.zip
  inflating: cloudsecure-agent-install.sh
  inflating: cloudsecure-agent-upgrade.sh

「cloudsecure-agent-install.sh」ファイルに execute 権限を設定します。

[root@demo-agent agent_installers]# chmod +x cloudsecure-agent-install.sh
[root@demo-agent agent_installers]# ll
total 153344
-rw------- 1 root root 79154250 Apr 26 06:37 cloudsecure-agent-image.zip
-rwx------ 1 root root    16574 Apr 26 06:25 cloudsecure-agent-install.sh
-rw------- 1 root root     8586 Apr 26 06:25 cloudsecure-agent-upgrade.sh
-rw------- 1 root root 77834705 Apr 26 14:34 cloudsecure-linux-agent-installer-1.617.0.zip

新しいエージェントのインストール用にワンタイムトークンを生成します。

注: この手順で生成されるワンタイムトークンは、ステップ1c 。

Swagger で、cloudsecure_installers.agent > /v1/cloudsecure/agent/oneTimeToken API を実行し、応答からトークンをコピーします。
1. ワンタイムトークンを環境変数としてエクスポートします。
  [root@demo-agent ~]# export TOKEN=<<one time token generated in step 7>>
2. プロキシサーバーを使用する場合は、以下の形式で https_proxy を環境変数としてエクスポートします。
  [root@demo-agent ~]# export HTTPS_PROXY='USER:PASSWORD@PROXY_SERVER:PORT'
3. オプション: デフォルトでは、エージェントとコレクターはパス「/opt/netapp」にインストールされます。別のパスにインストールするには、次の環境変数を設定します。
  [root@demo-agent ~]# export AGENT_INSTALL_PATH=/test_user/apps
  注: カスタムパスにインストールした場合、データコレクターとエージェントログなどのその他のすべてのアーティファクトは、カスタムパス内にのみ作成されます。インストールログは、/var/log/netapp/cloudsecure/install に残ります。
4. エージェントインストーラーをダウンロードしたディレクトリに戻り、「cloudsecure-agent-install.sh」を実行します。
  [root@demo-agent agent_installers]# ./ cloudsecure-agent-install.sh
  注意: ユーザーが「bash」シェルで実行していない場合、エクスポートコマンドは機能しない可能性があります。その場合、手順 8 から 11 を組み合わせて以下のように実行できます。 HTTPS_PROXY と AGENT_INSTALL_PATH はオプションであり、必要ない場合は無視できます。
```
sudo /bin/bash -c "TOKEN=<<one time token generated in step 7>> HTTPS_PROXY=<<proxy details in the format mentioned in step 9>> AGENT_INSTALL_PATH=<<custom_path_to_install_agent>> ./cloudsecure-agent-install.sh"
```
+
この時点で、エージェントは正常にインストールされるはずです。
1. エージェントのインストールの健全性チェック:

「systemctl status cloudsecure-agent.service」を実行し、エージェントサービスが running 状態であることを確認します。

[root@demo-agent ~]# systemctl status cloudsecure-agent.service
 cloudsecure-agent.service - Cloud Secure Agent Daemon Service
   Loaded: loaded (/usr/lib/systemd/system/cloudsecure-agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Fri 2024-04-26 02:50:37 EDT; 12h ago
 Main PID: 15887 (java)
    Tasks: 72
   CGroup: /system.slice/cloudsecure-agent.service
           ├─15887 java -Dconfig.file=/test_user/apps/cloudsecure/agent/conf/application.conf -Dagent.proxy.host= -Dagent.proxy.port= -Dagent.proxy.user= -Dagent.proxy.password= -Dagent.env=prod -Dagent.base.path=/test_user/apps/cloudsecure/agent -...

エージェントは「エージェント」ページに表示され、「接続済み」状態になっている必要があります。
1. インストール後のクリーンアップ。
エージェントのインストールが成功した場合は、ダウンロードしたエージェントインストーラーファイルを削除できます。

新しいデータコレクターをインストールしています。

注: このドキュメントには、「ONTAP SVM データコレクター」のインストール手順が記載されています。「Cloud Volumes ONTAPデータコレクター」と「Amazon FSx for NetApp ONTAPデータコレクター」にも同じ手順が適用されます。

コレクターをインストールする必要があるシステムに移動し、agent installation path ディレクトリの下に ./tmp/collectors という名前のディレクトリを作成します。

注: エージェントが /opt/netapp にインストールされている場合は、/opt/netapp/cloudsecure に移動します。
```
[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors
```

tmp ディレクトリの所有権を cssys:cssys に再帰的に変更します (cssys ユーザーとグループはエージェントのインストール中に作成されます)。

[root@demo-agent /]# chown -R cssys:cssys tmp/
[root@demo-agent /]# cd ./tmp
[root@demo-agent tmp]# ll | grep collectors
drwx------ 2 cssys         cssys 4096 Apr 26 15:56 collectors

ここで、コレクターのバージョンとコレクターの UUID を取得する必要があります。「cloudsecure_config.collector-types」API に移動します。
Swagger の「cloudsecure_config.collector-types > /v1/cloudsecure/collector-types」(GET) API に移動します。「collectorCategory」ドロップダウンで、コレクタータイプとして「DATA」を選択します。すべてのコレクタータイプの詳細を取得するには、「すべて」を選択します。
必要なコレクタータイプの UUID をコピーします。
コレクターインストーラーをダウンロードします。
1. 「cloudsecure_installers.collector > /v1/cloudsecure/collector-types/installers/{collectorTypeUUID}」(GET) API に移動します。前の手順でコピーした UUID を入力し、インストーラーファイルをダウンロードします。
2. インストーラファイルを別のマシンに外部的にダウンロードした場合は、エージェントが実行されているシステムにインストーラファイルをコピーし、ディレクトリ /{agent-install-path}/cloudsecure/tmp/collectors に配置します。
3. あるいは、同じ API から curl コマンドをコピーし、コレクターをインストールするシステムで直接実行することもできます。
  
  ファイル名は、ダウンロードコレクター API の応答ヘッダーにあるものと同じである必要があります。下のスクリーンショットを参照してください。
  
  注: エージェントが /opt/netapp にインストールされている場合は、/opt/netapp/cloudsecure/tmp/collectors に移動します。
```
[root@demo-agent collectors]# cd {agent-install-path}/cloudsecure/tmp/collectors
[root@demo-agent collectors]# pwd
/opt/netapp/cloudsecure/tmp/collectors

[root@demo-agent collectors]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/collector-types/installers/1829df8a-c16d-45b1-b72a-ed5707129870" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cs-ontap-dsc_1.286.0.zip
```

コレクターインストーラー zip ファイルの所有権を cssys:cssys に変更します。

-rw------- 1 root root 50906252 Apr 26 16:11 cs-ontap-dsc_1.286.0.zip
[root@demo-agent collectors]# chown cssys:cssys cs-ontap-dsc_1.286.0.zip
[root@demo-agent collectors]# ll
total 49716
-rw------- 1 cssys cssys 50906252 Apr 26 16:11 cs-ontap-dsc_1.286.0.zip

Workload Security > Collectors に移動し、+Collector を選択します。 ONTAP SVM コレクターを選択します。
コレクターの詳細を設定し、コレクターを保存します。
[保存] をクリックすると、エージェントプロセスは /{agent-install-path}/cloudsecure/tmp/collectors/ ディレクトリからコレクターインストーラーを検索し、コレクターをインストールします。
代替オプションとして、UI 経由でコレクターを追加する代わりに、API 経由でも追加できます。
1. 「cloudsecure_config.collectors」>「/v1/cloudsecure/collectors」(POST) API に移動します。
2. 例のドロップダウンで、「ONTAP SVM データコレクター json サンプル」を選択し、コレクター構成の詳細を更新して実行します。
コレクターは「データコレクター」セクションの下に表示されるようになります。
インストール後のクリーンアップ。
1. コレクターのインストールが成功した場合は、ディレクトリ /{agent-install-path}/cloudsecure/tmp/collectors 内のすべてのファイルを削除できます。

新しいユーザーディレクトリコレクターのインストール

注: このドキュメントでは、LDAP コレクターをインストールする手順について説明しました。 AD コレクターのインストールにも同じ手順が適用されます。

1.コレクターをインストールする必要があるシステムに移動し、agent installation path ディレクトリの下に ./tmp/collectors という名前のディレクトリを作成します。

注: エージェントが /opt/netapp にインストールされている場合は、/opt/netapp/cloudsecure に移動します。
```
[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors
```
1. collectors ディレクトリの所有権を cssys:cssys に変更します。
  [root@demo-agent /]# chown -R cssys:cssys tmp/ [root@demo-agent /]# cd ./tmp [root@demo-agent tmp]# ll | grep collectors drwx------ 2 cssys cssys 4096 Apr 26 15:56 collectors
ここで、コレクターのバージョンと UUID を取得する必要があります。「cloudsecure_config.collector-types」API に移動します。コレクターカテゴリドロップダウンで、コレクタータイプとして「ユーザー」を選択します。 1 回のリクエストですべてのコレクタータイプの詳細を取得するには、「すべて」を選択します。
LDAP コレクターの UUID をコピーします。
コレクターインストーラーをダウンロードします。
1. 「cloudsecure_installers.collector」>「/v1/cloudsecure/collector-types/installers/{collectorTypeUUID}」(GET) API に移動します。前の手順でコピーした UUID を入力し、インストーラーファイルをダウンロードします。
2. インストーラファイルを別のマシンの外部にダウンロードした場合は、エージェントが実行されているシステムのディレクトリ /{agent-installation-path}/cloudsecure/tmp/collectors にインストーラファイルをコピーします。
3. あるいは、同じ API から curl コマンドをコピーし、コレクターをインストールするシステムで直接実行することもできます。
  
  ファイル名は、ダウンロードコレクター API の応答ヘッダーにあるものと同じである必要があります。下のスクリーンショットを参照してください。
  
  また、エージェントが /opt/netapp にインストールされている場合は、/opt/netapp/cloudsecure/tmp/collectors に移動することにも注意してください。
```
[root@demo-agent collectors]# cd {agent-install-path}/cloudsecure/tmp/collectors
[root@demo-agent collectors]# pwd
/opt/netapp/cloudsecure/tmp/collectors

[root@demo-agent collectors]# curl -X GET "https://netapp-demo.dev.cloudsecure.netapp.com/rest/v1/cloudsecure/collector-types/installers/37fb37bd-6078-4c75-a64f-2b14cb1a1eb1" -H "accept: application/octet-stream" -H "X-CloudInsights-ApiKey: <<API Access Token>>" -o cs-ldap-dsc_1.322.0.zip
```

コレクターインストーラー zip ファイルの所有権を cssys:cssys に変更します。

[root@demo-agent collectors]# ll
total 37156
-rw------- 1 root root 38045966 Apr 29 10:02 cs-ldap-dsc_1.322.0.zip
[root@demo-agent collectors]# chown cssys:cssys cs-ldap-dsc_1.322.0.zip
[root@demo-agent collectors]# ll
total 37156
-rw------- 1 cssys cssys 38045966 Apr 29 10:02 cs-ldap-dsc_1.322.0.zip

「ユーザーディレクトリコレクター」ページに移動し、「+ ユーザーディレクトリコレクター」をクリックします。
「LDAP ディレクトリサーバー」を選択します。
LDAPディレクトリサーバーの詳細を入力し、「保存」をクリックします。
[Save] をクリックすると、エージェントサービスは /{agent-install-path}/cloudsecure/tmp/collectors/ ディレクトリからコレクターインストーラーを検索し、コレクターをインストールします。
代替オプションとして、UI 経由でコレクターを追加する代わりに、API 経由でも追加できます。
1. 「cloudsecure_config.collectors」>「/v1/cloudsecure/collectors」(POST) API に移動します。
2. 例のドロップダウンで、「LDAP ディレクトリサーバーユーザーコレクター json サンプル」を選択し、コレクター構成の詳細を更新して、「実行」をクリックします。
コレクターは、「ユーザーディレクトリコレクター」セクションの下に表示されるようになります。
インストール後のクリーンアップ。
1. コレクターのインストールが成功した場合は、ディレクトリ /{agent-install-path}/cloudsecure/tmp/collectors 内のすべてのファイルを削除できます。

エージェントのアップグレード

エージェント/コレクターの新しいバージョンが利用可能になると、電子メール通知が送信されます。

最新のエージェントインストーラーをダウンロードしてください。
1. 最新のインストーラーをダウンロードする手順は、「新しいエージェントのインストール」の手順と同様です。 Swagger で、「cloudsecure_installers.agent」>「/v1/cloudsecure/agents/installers/{platform}/latest」API を選択し、プラットフォームに「linux」と入力して、インストーラーの zip ファイルをダウンロードします。代わりに、curl コマンドを使用することもできます。インストーラーファイルを解凍します。

「cloudsecure-agent-upgrade.sh」ファイルの実行権限を設定します。

[root@demo-agent agent_installers]# unzip cloudsecure-linux-agent-installer-1.618.0.zip
Archive:  cloudsecure-linux-agent-installer-1.618.0.zip
  inflating: cloudsecure-agent-image.zip
  inflating: cloudsecure-agent-install.sh
  inflating: cloudsecure-agent-upgrade.sh
[root@demo-agent agent_installers]# ll
total 153344
-rw------- 1 root root 79154230 Apr 26  2024 cloudsecure-agent-image.zip
-rw------- 1 root root    16574 Apr 26  2024 cloudsecure-agent-install.sh
-rw------- 1 root root     8586 Apr 26  2024 cloudsecure-agent-upgrade.sh
-rw------- 1 root root 77834660 Apr 26 17:35 cloudsecure-linux-agent-installer-1.618.0.zip
[root@demo-agent agent_installers]# chmod +x cloudsecure-agent-upgrade.sh
[root@demo-agent agent_installers]# ll
total 153344
-rw------- 1 root root 79154230 Apr 26  2024 cloudsecure-agent-image.zip
-rw------- 1 root root    16574 Apr 26  2024 cloudsecure-agent-install.sh
-rwx------ 1 root root     8586 Apr 26  2024 cloudsecure-agent-upgrade.sh
-rw------- 1 root root 77834660 Apr 26 17:35 cloudsecure-linux-agent-installer-1.618.0.zip

「cloudsecure-agent-upgrade.sh」スクリプトを実行します。スクリプトが正常に実行された場合、出力に「Cloudsecure エージェントが正常にアップグレードされました。」というメッセージが表示されます。
次のコマンド「systemctl daemon-reload」を実行します。
```
[root@demo-agent ~]# systemctl daemon-reload
```
エージェントサービスを再起動します。
```
[root@demo-agent ~]# systemctl restart cloudsecure-agent.service
```
この時点で、エージェントは正常にアップグレードされるはずです。

エージェントのアップグレード後の健全性チェック。

エージェントがインストールされているパス (例: "/opt/netapp/cloudsecure/") に移動します。シンボリックリンク「agent」は、エージェントの新しいバージョンを指す必要があります。

[root@demo-agent cloudsecure]# pwd
/opt/netapp/cloudsecure
[root@demo-agent cloudsecure]# ll
total 40
lrwxrwxrwx  1 cssys cssys  114 Apr 26 17:38 agent -> /test_user/apps/cloudsecure/cloudsecure-agent-1.618.0
drwxr-xr-x  4 cssys cssys 4096 Apr 25 10:45 agent-certs
drwx------  2 cssys cssys 4096 Apr 25 16:18 agent-logs
drwx------ 11 cssys cssys 4096 Apr 26 02:50 cloudsecure-agent-1.617.0
drwx------ 11 cssys cssys 4096 Apr 26 17:42 cloudsecure-agent-1.618.0
drwxr-xr-x  3 cssys cssys 4096 Apr 26 02:45 collector-image
drwx------  2 cssys cssys 4096 Apr 25 10:45 conf
drwx------  3 cssys cssys 4096 Apr 26 16:39 data-collectors
-rw-r--r--  1 root  root    66 Apr 25 10:45 sysctl.conf.bkp
drwx------  2 root  root  4096 Apr 26 17:38 tmp

エージェントは「エージェント」ページに表示され、「接続済み」状態になっている必要があります。

インストール後のクリーンアップ。
1. エージェントのインストールが成功した場合は、ダウンロードしたエージェントインストーラーファイルを削除できます。

コレクターのアップグレード

注: アップグレード手順は、すべてのタイプのコレクターで同じです。このドキュメントでは、「ONTAP SVM」コレクターのアップグレードについて説明します。

コレクターをアップグレードする必要があるシステムに移動し、agent installation path ディレクトリの下に ./tmp/collectors ディレクトリがまだ存在しない場合は作成します。

注: エージェントが /opt/netapp にインストールされている場合は、/opt/netapp/cloudsecure ディレクトリに移動します。
```
[root@demo-agent ~]# cd {agent-install-path}/cloudsecure
[root@demo-agent ~]# mkdir -p ./tmp/collectors
```

ディレクトリ「collectors」が cssys:cssys によって所有されていることを確認してください。

[root@demo-agent /]# chown -R cssys:cssys tmp/
[root@demo-agent /]# cd ./tmp
[root@demo-agent tmp]# ll | grep collectors
drwx------ 2 cssys         cssys 4096 Apr 26 15:56 collectors

Swagger で、「cloudsecure_config.collector-types」GET API に移動します。「collectorCategory」ドロップダウンで、「DATA」を選択します（ユーザーディレクトリコレクターの場合は「USER」、そうでない場合は「ALL」を選択します）。

レスポンス本文から UUID とバージョンをコピーします。
最新のコレクターインストーラーファイルをダウンロードします。
1. cloudsecure_installers.collector > /v1/cloudsecure/collector-types/installers/{collectorTypeUUID} API に移動します。前の手順でコピーした collectorTypeUUID を入力します。インストーラーを /{agent-install-path}/cloudsecure/tmp/collectors ディレクトリにダウンロードします。
2. あるいは、同じ API の curl コマンドも使用できます。
注: ファイル名は、ダウンロードコレクター API の応答ヘッダーにあるものと同じである必要があります。