简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

安装工作负载安全代理

提供者

工作负载安全性(以前称为Cloud Secure)使用一个或多个代理收集用户活动数据。代理连接到环境中的设备并收集发送到工作负载安全SaaS层进行分析的数据。请参见 "代理要求" 配置代理虚拟机。

注 Cloud Insights 联邦版不提供工作负载安全性。

开始之前

  • 安装，运行脚本和卸载需要 sudo 权限。

  • 安装代理时、会在计算机上创建一个本地用户_cssys_和一个本地组_cssys_。如果权限设置不允许创建本地用户、而需要Active Directory、则必须在Active Directory服务器中创建用户名为_cssys_的用户。

安装代理的步骤

  1. 以管理员或帐户所有者身份登录到工作负载安全环境。

  2. 在*安全性*菜单下、选择*管理>数据收集器>代理>+Agent*

    系统将显示 "Add an Agent" 页面：

    添加代理 1

  3. 验证代理服务器是否满足最低系统要求。

  4. 要验证代理服务器是否正在运行受支持的 Linux 版本，请单击 _versions supported （ i ） _ 。

  5. 如果您的网络使用代理服务器，请按照代理部分中的说明设置代理服务器详细信息。

    代理安装与代理注意事项

  6. 单击复制到剪贴板图标以复制安装命令。

  7. 在终端窗口中运行安装命令。

  8. 安装成功完成后，系统将显示以下消息：

    新代理检测
完成后

  1. 您需要配置 "用户目录收集器"。

  2. 您需要配置一个或多个数据收集器。

网络配置：

在本地系统上运行以下命令、以打开将由工作负载安全性使用的端口。如果对端口范围存在安全问题，可以使用较小的端口范围，例如 35000 ： 35100 。每个 SVM 使用两个端口。

步骤

  1. sudo firewall-cmd -perf持久 -zone=public -add-port=35000-55000/tcp

  2. sudo firewall-cmd -reload

根据您的平台执行以下步骤：

  • CentOS 7.x / RHEL 7.x * ：

    1. 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 * ：

  1. sUdo firewall-cmd -zone=public -list-ports | grep 35000 （适用于 CentOS 8 ）

示例输出：

35000-55000/tcp

对代理错误进行故障排除

下表介绍了已知问题及其解决方法。

问题： 解决方法：

代理安装无法创建 /opt/netapp/cloudsecurity/agent/logs/agent.log 文件夹，并且 install.log 文件不提供任何相关信息。

在启动代理期间发生此错误。此错误不会记录在日志文件中，因为它会在日志程序初始化之前发生。此错误将重定向到标准输出，并可使用 jlogalctl -u cloudsecure-agent.service 命令在服务日志中看到。此命令可用于进一步对问题描述进行故障排除。

代理安装失败，并显示 ‘不支持此 Linux 版本。正在退出安装。

如果您尝试在不受支持的系统上安装代理、则会出现此错误。请参见 "代理要求"。

代理安装失败，并显示错误： "-bash ： unzip ： command not found"

安装 unzip ，然后再次运行安装命令。如果计算机上安装了 Yum ，请尝试 " yum install unzip " 以安装解压缩软件。然后，从代理安装 UI 中重新复制此命令并将其粘贴到命令行界面中以重新执行安装。

代理已安装并正在运行。但是，代理已突然停止。

通过 SSH 连接到代理计算机。通过检查代理服务的状态 sudo systemctl status cloudsecure-agent.service。1.检查日志是否显示消息"无法启动工作负载安全守护进程服务"。2. 检查 Agent 计算机中是否存在 cssys 用户。使用 root 权限逐个执行以下命令，并检查 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 显示 Agent 处于 not_connected 状态。

重新启动代理的步骤。1. 通过 SSH 连接到代理计算机。2. 执行以下命令重新启动代理服务： sudo systemctl restart cloudsecure-agent.service 3.通过 sUdo systemctl status cloudsecure-agent.service 检查代理服务的状态。4. 代理应处于已连接状态。

代理 VM 位于 Zscaler 代理之后，代理安装失败。由于Zscaler代理的SSL检查、工作负载安全证书会在Zscaler CA签名时显示出来、因此代理不会信任通信。

在 Zscaler 代理中禁用 * 。 .cloudinsights.netapp.com URL 的 SSL 检查。如果Zscaleer执行SSL检查并替换证书、则工作负载安全性将不起作用。

安装代理时，安装将在解压缩后挂起。

"chmod 755 -rf " 命令失败。如果代理安装命令由非 root sudo 用户运行，而该用户的文件位于工作目录中，属于另一个用户，并且无法更改这些文件的权限，则此命令将失败。由于 chmod 命令失败，其余安装不会执行。1. 创建一个名为 cloudsecure 的新目录。2. 转到该目录。3. 复制并粘贴完整的 "token=…… … ./cloudsure-agent-install.sh" 安装命令并按 Enter 键。4. 安装应能继续进行。

如果工程师仍无法连接到 SaaS ，请向 NetApp 支持部门创建案例。提供 Cloud Insights 序列号以创建案例，并按照说明将日志附加到案例。

将日志附加到案例： 1.使用 root 权限执行以下脚本并共享输出文件（ cloudsure-agent-symps.zip ）。答/opt/netapp/cloudsecurity/agent/bin/cloudsecure-agent-symptom-collector.sh 2.在 root 权限下逐个执行以下命令，并共享输出。答ID cssys b.组 cssys c.cat /etc/os-release

cloudsecure-agent-symptom-collector.sh脚本失败、并显示以下错误。根@计算机tmp]#/opt/netapp/cloudsecurity/agent/bin/cloudsecure-agent-symptom-collector.sh收集服务日志收集应用程序日志收集代理配置获取服务状态快照获取代理目录结构快照………………… 。………………… 。/opt/netapp/cloudsecurity/agent/bin/cloudsure-agent-smp-collector.sh：行52：zip：command not found error：failed to create /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_并在root下创建其登录目录。

安装后代理未运行。_systemctl status cloudsecure-agent.service_显示以下内容：[root@demo ~]# systemctl status cloudsecure-agent.service agent.service—工作负载安全代理守护进程服务已加载：已加载(/usr/lib/systemd/system/cloudsecure-agent.service;已启用；供应商预设：已禁用) Active：激活(自动重新启动)(结果：退出代码)自Cloudue 2021-08-03 21：12：26 PDT起；退出前代理进程：dbash /dbash /netapp=25bash /bash /bash：/dcc=bash： 25889 (code=exited、status=126)、Aug 03 21：12：26 demo systemd1]：cloudsecure-agent.service: main process exited、code=exited、status=126/n/a Aug 03 21：12：26 demo systemd1]：unit cloudsecure-agent.service entered.Aug 03 21：12：26 demo systemd1]：cloudsecure-agent.service失败。

此操作可能会失败、因为_cssys_用户可能没有安装权限。如果/opt/netapp是NFS挂载、而_cssys_用户无权访问此文件夹、则安装将失败。_cssys_是工作负载安全安装程序创建的本地用户、该用户可能无权访问挂载的共享。要检查此问题、您可以尝试使用_cssys_用户访问/opt/netapp/cloudsecurity/agent/bin/cloudsure-agent。如果返回"permission denies"、则安装权限不存在。安装在计算机本地的目录上、而不是挂载的文件夹。

代理最初是通过代理服务器连接的、代理是在安装期间设置的。现在、代理服务器已更改。如何更改代理的代理配置？

您可以编辑agent.properties以添加代理详细信息。请按照以下步骤操作：1.更改为包含属性文件的文件夹：cd /opt/netapp/cloudsecurity/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