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

ワークロードセキュリティエージェントのインストール

10/14/2025 共同作成者

Workload Security (旧称Cloud Secure) は、1 つ以上のエージェントを使用してユーザーアクティビティデータを収集します。エージェントはテナント上のデバイスに接続し、分析のために Workload Security SaaS レイヤーに送信されるデータを収集します。見る"エージェントの要件"エージェント VM を構成します。

開始前の準備

インストール、スクリプトの実行、アンインストールには sudo 権限が必要です。
エージェントのインストール中に、ローカルユーザー cssys とローカルグループ cssys がマシン上に作成されます。権限設定によりローカルユーザーの作成が許可されず、代わりに Active Directory が必要な場合は、ユーザー名が cssys のユーザーを Active Directory サーバーに作成する必要があります。
Data Infrastructure Insightsのセキュリティについて読むことができます"ここをクリックしてください。"。

グローバルな変更はONTAPシステムに影響を及ぼす可能性があります。多数のデータコレクターに影響する変更は、オフピーク時間帯に行うことを強くお勧めします。

エージェントのインストール手順

Workload Security 環境に管理者またはアカウント所有者としてログインします。
*コレクター > エージェント > +エージェント*を選択

エージェントの追加ページが表示されます。
エージェントサーバーが最小システム要件を満たしていることを確認します。
エージェントサーバーがサポートされているバージョンの Linux を実行していることを確認するには、[サポートされているバージョン (i)] をクリックします。
ネットワークでプロキシサーバーを使用している場合は、「プロキシ」セクションの指示に従ってプロキシサーバーの詳細を設定してください。
インストールコマンドをコピーするには、[クリップボードにコピー] アイコンをクリックします。
ターミナルウィンドウでインストールコマンドを実行します。
インストールが正常に完了すると、次のメッセージが表示されます。

完了後

設定する必要があります"ユーザーディレクトリコレクター"。
1 つ以上のデータコレクターを構成する必要があります。

ネットワーク構成

Workload Security で使用されるポートを開くには、ローカルシステムで次のコマンドを実行します。ポート範囲に関してセキュリティ上の懸念がある場合は、35000:35100 などのより狭いポート範囲を使用できます。各 SVM は 2 つのポートを使用します。

手順

sudo firewall-cmd --permanent --zone=public --add-port=35000-55000/tcp
sudo firewall-cmd --reload

プラットフォームに応じて次の手順に従ってください。

CentOS 7.x / RHEL 7.x:

sudo iptables-save | grep 35000

出力例：

 -A IN_public_allow -p tcp -m tcp --dport 35000:55000 -m conntrack -ctstate NEW,UNTRACKED -j ACCEPT
*CentOS 8.x / RHEL 8.x*:

sudo firewall-cmd --zone=public --list-ports | grep 35000（CentOS 8の場合）

出力例：

35000-55000/tcp

エージェントを現在のバージョンに「固定」する

デフォルトでは、 Data Infrastructure Insights Workload Security はエージェントを自動的に更新します。自動更新を一時停止して、次のいずれかが発生するまでエージェントを現在のバージョンのままにすることを希望する顧客もいます。

顧客はエージェントの自動更新を再開します。
30日が経過しました。 30 日間は、エージェントが一時停止された日ではなく、最新のエージェント更新の日から始まることに注意してください。

いずれの場合も、エージェントは次回の Workload Security 更新時に更新されます。

自動エージェント更新を一時停止または再開するには、cloudsecure_config.agents API を使用します。

エージェントをピン留めおよびピン留め解除するための cloudsecure エージェント API

一時停止または再開アクションが有効になるまでに最大 5 分かかる場合があることに注意してください。

現在のエージェントのバージョンは、Workload Security > Collectors ページの Agents タブで確認できます。

エージェントテーブルに表示される WS エージェントのバージョン

エージェントエラーのトラブルシューティング

既知の問題とその解決策を次の表に示します。

問題：解決：

問題：	解決：
エージェントのインストールで /opt/netapp/cloudsecure/agent/logs/agent.log フォルダの作成に失敗し、install.log ファイルには関連情報が提供されません。	このエラーはエージェントのブートストラップ中に発生します。エラーはロガーが初期化される前に発生するため、ログファイルに記録されません。エラーは標準出力にリダイレクトされ、サービスログで次のように表示されます。 `journalctl -u cloudsecure-agent.service`指示。このコマンドは、問題をさらにトラブルシューティングするために使用できます。
エージェントのインストールが「この Linux ディストリビューションはサポートされていません」というメッセージで失敗します。インストールを終了します。	このエラーは、サポートされていないシステムにエージェントをインストールしようとしたときに表示されます。見る"エージェントの要件" 。
エージェントのインストールが次のエラーで失敗しました: "-bash: unzip: コマンドが見つかりません"	unzip をインストールしてから、インストールコマンドを再度実行します。マシンに Yum がインストールされている場合は、「yum install unzip」を実行して unzip ソフトウェアをインストールしてください。その後、エージェントのインストール UI からコマンドを再度コピーし、CLI に貼り付けてインストールを再度実行します。
エージェントがインストールされ、実行されていました。しかし、エージェントは突然停止しました。	エージェントマシンに SSH で接続します。エージェントサービスのステータスを確認するには、 `sudo systemctl status cloudsecure-agent.service` 。1.ログに「Workload Security デーモンサービスを開始できませんでした」というメッセージが表示されているかどうかを確認します。2.エージェントマシンに cssys ユーザーが存在するかどうかを確認します。次のコマンドをルート権限で 1 つずつ実行し、cssys ユーザーとグループが存在するかどうかを確認します。 `sudo id cssys` sudo groups cssys`3.存在しない場合は、集中監視ポリシーによって cssys ユーザーが削除されている可能性があります。4.次のコマンドを実行して、cssys ユーザーとグループを手動で作成します。 `sudo useradd cssys sudo groupadd cssys`5.その後、次のコマンドを実行してエージェントサービスを再起動します。 `sudo systemctl restart cloudsecure-agent.service 6.それでも実行されない場合は、他のトラブルシューティングオプションを確認してください。
エージェントに 50 個を超えるデータコレクターを追加することはできません。	エージェントに追加できるデータコレクターは 50 個のみです。これは、Active Directory、SVM、その他のコレクターなど、すべてのコレクタータイプの組み合わせになります。
UI には、エージェントが NOT_CONNECTED 状態にあることが示されます。	エージェントを再起動する手順。1.エージェントマシンに SSH で接続します。2.その後、次のコマンドを実行してエージェントサービスを再起動します。 `sudo systemctl restart cloudsecure-agent.service` 3.エージェントサービスのステータスを確認するには、 `sudo systemctl status cloudsecure-agent.service` 。4.エージェントは CONNECTED 状態に移行する必要があります。
エージェント VM は Zscaler プロキシの背後にあり、エージェントのインストールが失敗します。 Zscaler プロキシの SSL 検査により、Workload Security 証明書は Zscaler CA によって署名された状態で提示されるため、エージェントは通信を信頼していません。	*.cloudinsights.netapp.com URL の Zscaler プロキシで SSL 検査を無効にします。 Zscaler が SSL 検査を実行して証明書を置き換えると、Workload Security は機能しなくなります。
エージェントのインストール中に、解凍後にインストールがハングします。	「chmod 755 -Rf」コマンドが失敗しています。エージェントインストールコマンドが非 root sudo ユーザーによって実行され、作業ディレクトリに別のユーザーに属するファイルがあり、それらのファイルの権限を変更できない場合、コマンドは失敗します。 chmod コマンドが失敗したため、インストールの残りの部分は実行されません。1. 「cloudsecure」という名前の新しいディレクトリを作成します。2.そのディレクトリに移動します。3.完全な「token=…… … ./cloudsecure-agent-install.sh」インストールコマンドをコピーして貼り付け、Enter キーを押します。4.インストールを続行できるはずです。
それでもエージェントが Saas に接続できない場合は、 NetAppサポートにケースを開いてください。ケースを開くには、 Data Infrastructure Insights のシリアル番号を提供し、記載されているとおりにログをケースに添付します。	ログをケースに取り付けるには: 1.次のスクリプトをルート権限で実行し、出力ファイル (cloudsecure-agent-symptoms.zip) を共有します。a. /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh 2.ルート権限で次のコマンドを1つずつ実行し、出力を共有します。a. id cssys b. groups cssys c. cat /etc/os-release
cloudsecure-agent-symptom-collector.sh スクリプトが次のエラーで失敗します。 [root@machine tmp]# /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh サービスログを収集していますアプリケーションログを収集していますエージェント構成を収集していますサービスステータスのスナップショットを取得していますエージェントディレクトリ構造のスナップショットを取得しています …………………. ……………………。 /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh: 行 52: zip: コマンドが見つかりませんエラー: /tmp/cloudsecure-agent-symptoms.zip の作成に失敗しました	Zip ツールがインストールされていません。「yum install zip」コマンドを実行して、zip ツールをインストールします。次に、cloudsecure-agent-symptom-collector.sh を再度実行します。
エージェントのインストールが useradd で失敗します: ディレクトリ /home/cssys を作成できません	このエラーは、権限不足のためにユーザーのログインディレクトリを /home の下に作成できない場合に発生する可能性があります。回避策としては、cssys ユーザーを作成し、次のコマンドを使用してそのログインディレクトリを手動で追加します: sudo useradd user_name -m -d HOME_DIR -m : ユーザーのホームディレクトリが存在しない場合は作成します。 -d : ユーザーのログインディレクトリの値として HOME_DIR を使用して新しいユーザーが作成されます。たとえば、sudo useradd cssys -m -d /cssys は、ユーザー cssys を追加し、ルートの下にそのログインディレクトリを作成します。
インストール後にエージェントが実行されていません。 Systemctl status cloudsecure-agent.service は次のように表示します: [root@demo ~]# systemctl status cloudsecure-agent.service agent.service – Workload Security Agent Daemon Service Loaded: loaded (/usr/lib/systemd/system/cloudsecure-agent.service; enabled; vendor preset: disabled) Active: activating (auto-restart) (Result: exit-code) since Tue 2021-08-03 21:12:26 PDT; 2 秒前プロセス: 25889 ExecStart=/bin/bash /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent (コード = 終了、ステータス = 126) メイン PID: 25889 (コード = 終了、ステータス = 126)、8 月 03 日 21:12:26 demo systemd[1]: cloudsecure-agent.service: メインプロセスが終了しました。コード = 終了、ステータス = 126/n/a 8 月 03 日 21:12:26 demo systemd[1]: ユニット cloudsecure-agent.service が失敗状態になりました。 8月3日 21:12:26 デモ systemd[1]: cloudsecure-agent.service が失敗しました。	cssys ユーザーにインストール権限がない可能性があるため、失敗する可能性があります。 /opt/netapp が NFS マウントであり、cssys ユーザーがこのフォルダーにアクセスできない場合、インストールは失敗します。 cssys は、Workload Security インストーラによって作成されたローカルユーザーであり、マウントされた共有にアクセスする権限がない可能性があります。これを確認するには、cssys ユーザーを使用して /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent にアクセスしてみてください。「Permission denied」が返された場合、インストール権限が存在しません。マウントされたフォルダーの代わりに、マシンのローカルディレクトリにインストールします。
エージェントは最初にプロキシサーバー経由で接続され、プロキシはエージェントのインストール中に設定されました。プロキシサーバーが変更されました。エージェントのプロキシ構成を変更するにはどうすればよいですか?	agent.properties を編集してプロキシの詳細を追加できます。次の手順に従ってください: 1.プロパティファイルが含まれているフォルダーに変更します: cd /opt/netapp/cloudsecure/conf 2.お気に入りのテキストエディターを使用して、agent.properties ファイルを開いて編集します。3.次の行を追加または変更します: AGENT_PROXY_HOST=scspa1950329001.vm.netapp.com AGENT_PROXY_PORT=80 AGENT_PROXY_USER=pxuser AGENT_PROXY_PASSWORD=pass1234 4.ファイルを保存します。5.エージェントを再起動します: sudo systemctl restart cloudsecure-agent.service

エージェントのインストールで /opt/netapp/cloudsecure/agent/logs/agent.log フォルダの作成に失敗し、install.log ファイルには関連情報が提供されません。

このエラーはエージェントのブートストラップ中に発生します。エラーはロガーが初期化される前に発生するため、ログファイルに記録されません。エラーは標準出力にリダイレクトされ、サービスログで次のように表示されます。 `journalctl -u cloudsecure-agent.service`指示。このコマンドは、問題をさらにトラブルシューティングするために使用できます。

エージェントのインストールが「この Linux ディストリビューションはサポートされていません」というメッセージで失敗します。インストールを終了します。

このエラーは、サポートされていないシステムにエージェントをインストールしようとしたときに表示されます。見る"エージェントの要件" 。

エージェントのインストールが次のエラーで失敗しました: "-bash: unzip: コマンドが見つかりません"

unzip をインストールしてから、インストールコマンドを再度実行します。マシンに Yum がインストールされている場合は、「yum install unzip」を実行して unzip ソフトウェアをインストールしてください。その後、エージェントのインストール UI からコマンドを再度コピーし、CLI に貼り付けてインストールを再度実行します。

エージェントがインストールされ、実行されていました。しかし、エージェントは突然停止しました。

エージェントマシンに SSH で接続します。エージェントサービスのステータスを確認するには、 sudo systemctl status cloudsecure-agent.service 。1.ログに「Workload Security デーモンサービスを開始できませんでした」というメッセージが表示されているかどうかを確認します。2.エージェントマシンに cssys ユーザーが存在するかどうかを確認します。次のコマンドをルート権限で 1 つずつ実行し、cssys ユーザーとグループが存在するかどうかを確認します。
sudo id cssys
sudo groups cssys`3.存在しない場合は、集中監視ポリシーによって cssys ユーザーが削除されている可能性があります。4.次のコマンドを実行して、cssys ユーザーとグループを手動で作成します。 `sudo useradd cssys
sudo groupadd cssys`5.その後、次のコマンドを実行してエージェントサービスを再起動します。 `sudo systemctl restart cloudsecure-agent.service 6.それでも実行されない場合は、他のトラブルシューティングオプションを確認してください。

エージェントに 50 個を超えるデータコレクターを追加することはできません。

エージェントに追加できるデータコレクターは 50 個のみです。これは、Active Directory、SVM、その他のコレクターなど、すべてのコレクタータイプの組み合わせになります。

UI には、エージェントが NOT_CONNECTED 状態にあることが示されます。

エージェントを再起動する手順。1.エージェントマシンに SSH で接続します。2.その後、次のコマンドを実行してエージェントサービスを再起動します。
sudo systemctl restart cloudsecure-agent.service 3.エージェントサービスのステータスを確認するには、 sudo systemctl status cloudsecure-agent.service 。4.エージェントは CONNECTED 状態に移行する必要があります。

エージェント VM は Zscaler プロキシの背後にあり、エージェントのインストールが失敗します。 Zscaler プロキシの SSL 検査により、Workload Security 証明書は Zscaler CA によって署名された状態で提示されるため、エージェントは通信を信頼していません。

*.cloudinsights.netapp.com URL の Zscaler プロキシで SSL 検査を無効にします。 Zscaler が SSL 検査を実行して証明書を置き換えると、Workload Security は機能しなくなります。

エージェントのインストール中に、解凍後にインストールがハングします。

「chmod 755 -Rf」コマンドが失敗しています。エージェントインストールコマンドが非 root sudo ユーザーによって実行され、作業ディレクトリに別のユーザーに属するファイルがあり、それらのファイルの権限を変更できない場合、コマンドは失敗します。 chmod コマンドが失敗したため、インストールの残りの部分は実行されません。1. 「cloudsecure」という名前の新しいディレクトリを作成します。2.そのディレクトリに移動します。3.完全な「token=…… … ./cloudsecure-agent-install.sh」インストールコマンドをコピーして貼り付け、Enter キーを押します。4.インストールを続行できるはずです。

それでもエージェントが Saas に接続できない場合は、 NetAppサポートにケースを開いてください。ケースを開くには、 Data Infrastructure Insights のシリアル番号を提供し、記載されているとおりにログをケースに添付します。

ログをケースに取り付けるには: 1.次のスクリプトをルート権限で実行し、出力ファイル (cloudsecure-agent-symptoms.zip) を共有します。a. /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh 2.ルート権限で次のコマンドを1つずつ実行し、出力を共有します。a. id cssys b. groups cssys c. cat /etc/os-release

cloudsecure-agent-symptom-collector.sh スクリプトが次のエラーで失敗します。 [root@machine tmp]# /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh サービスログを収集していますアプリケーションログを収集していますエージェント構成を収集していますサービスステータスのスナップショットを取得していますエージェントディレクトリ構造のスナップショットを取得しています …………………. ……………………。 /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent-symptom-collector.sh: 行 52: zip: コマンドが見つかりませんエラー: /tmp/cloudsecure-agent-symptoms.zip の作成に失敗しました

Zip ツールがインストールされていません。「yum install zip」コマンドを実行して、zip ツールをインストールします。次に、cloudsecure-agent-symptom-collector.sh を再度実行します。

エージェントのインストールが useradd で失敗します: ディレクトリ /home/cssys を作成できません

このエラーは、権限不足のためにユーザーのログインディレクトリを /home の下に作成できない場合に発生する可能性があります。回避策としては、cssys ユーザーを作成し、次のコマンドを使用してそのログインディレクトリを手動で追加します: sudo useradd user_name -m -d HOME_DIR -m : ユーザーのホームディレクトリが存在しない場合は作成します。 -d : ユーザーのログインディレクトリの値として HOME_DIR を使用して新しいユーザーが作成されます。たとえば、sudo useradd cssys -m -d /cssys は、ユーザー cssys を追加し、ルートの下にそのログインディレクトリを作成します。

インストール後にエージェントが実行されていません。 Systemctl status cloudsecure-agent.service は次のように表示します: [root@demo ~]# systemctl status cloudsecure-agent.service agent.service – Workload Security Agent Daemon Service Loaded: loaded (/usr/lib/systemd/system/cloudsecure-agent.service; enabled; vendor preset: disabled) Active: activating (auto-restart) (Result: exit-code) since Tue 2021-08-03 21:12:26 PDT; 2 秒前プロセス: 25889 ExecStart=/bin/bash /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent (コード = 終了、ステータス = 126) メイン PID: 25889 (コード = 終了、ステータス = 126)、8 月 03 日 21:12:26 demo systemd[1]: cloudsecure-agent.service: メインプロセスが終了しました。コード = 終了、ステータス = 126/n/a 8 月 03 日 21:12:26 demo systemd[1]: ユニット cloudsecure-agent.service が失敗状態になりました。 8月3日 21:12:26 デモ systemd[1]: cloudsecure-agent.service が失敗しました。

cssys ユーザーにインストール権限がない可能性があるため、失敗する可能性があります。 /opt/netapp が NFS マウントであり、cssys ユーザーがこのフォルダーにアクセスできない場合、インストールは失敗します。 cssys は、Workload Security インストーラによって作成されたローカルユーザーであり、マウントされた共有にアクセスする権限がない可能性があります。これを確認するには、cssys ユーザーを使用して /opt/netapp/cloudsecure/agent/bin/cloudsecure-agent にアクセスしてみてください。「Permission denied」が返された場合、インストール権限が存在しません。マウントされたフォルダーの代わりに、マシンのローカルディレクトリにインストールします。

エージェントは最初にプロキシサーバー経由で接続され、プロキシはエージェントのインストール中に設定されました。プロキシサーバーが変更されました。エージェントのプロキシ構成を変更するにはどうすればよいですか?

agent.properties を編集してプロキシの詳細を追加できます。次の手順に従ってください: 1.プロパティファイルが含まれているフォルダーに変更します: cd /opt/netapp/cloudsecure/conf 2.お気に入りのテキストエディターを使用して、agent.properties ファイルを開いて編集します。3.次の行を追加または変更します: AGENT_PROXY_HOST=scspa1950329001.vm.netapp.com AGENT_PROXY_PORT=80 AGENT_PROXY_USER=pxuser AGENT_PROXY_PASSWORD=pass1234 4.ファイルを保存します。5.エージェントを再起動します: sudo systemctl restart cloudsecure-agent.service