Agent安装失败应如何处理？

如果Agent安装失败，请参考本文排查处理。

通过HSS控制台界面安装Agent失败

如果您通过“界面安装”安装模式安装Agent失败，您可根据HSS管理控制台的提示信息，参考表安装Agent失败处理建议提供的建议处理问题。

表1 安装Agent失败处理建议
管理控制台提示信息	处理建议
网络不通，访问超时	Linux 请检查网络配置，保证服务器可正常访问网络。 Windows 以Windows系统管理员身份运行PowerShell。执行以下命令，查看Service信息。 winrm get winrm/config/service 如果AllowUnencrypted的值为“true”，请检查网络配置，保证服务器可正常访问网络。如果AllowUnencrypted的值为“false”，执行以下命令，修改AllowUnencrypted的值为“true”。 winrm set winrm/config/service '@{AllowUnencrypted="true"}' 重试通过HSS控制台界面为Windows主机安装Agent。 Agent安装成功后，请执行以下命令，修改AllowUnencrypted的值为“false”。 winrm set winrm/config/service '@{AllowUnencrypted="false"}'
认证错误，口令不正确	密码错误，请检查您填写的密码信息。
内存空间不足	安装Agent时，需要保障至少50 MB内存空间可用。请检查并清理内存空间。
metadata检查失败	metadata获取失败，请参考Linux操作系统云服务器无法获取元数据怎么办？解决问题。
expect安装失败	请检查网络是否存在波动，待网络恢复正常后重试安装Agent。如果网络正常仍然安装失败，请您在华为云管理控制台的右上角，单击“工单 > 新建工单”，通过工单向技术人员寻求帮助。
打通VPC网络失败	您未将VPCOperatePolicy权限授予HSS，HSS无法打通不同VPC之间的网络。建议参考以下操作完成授权：登录主机安全服务控制台。在单击管理控制台左上角的，选择区域和项目。在左侧导航栏，选择“安装与配置 > 授权管理”，进入授权管理页面。单击授权列表左上方“新增授权”，将VPCOperatePolicy权限授予HSS。关于VPCOperatePolicy权限的含义和作用，请参见授权关联云服务权限。
绑定的DEW密钥状态异常	请检查并将您的DEW密钥对恢复为“正常”状态。
VPCEP打通失败	您未将VPCEPOperatePolicy权限授予HSS，HSS无法创建终端节点，终端节点用于Agent与HSS服务端进行通信。建议参考以下操作完成授权：登录主机安全服务控制台。在单击管理控制台左上角的，选择区域和项目。在左侧导航栏，选择“安装与配置 > 授权管理”，进入授权管理页面。单击授权列表左上方“新增授权”，将VPCEPOperatePolicy权限授予HSS。关于VPCEPOperatePolicy权限的含义和作用，请参见授权关联云服务权限。
密钥登录失败	密钥错误，请检查您填写的密钥信息。
安装命令无权限执行	可能原因：/tmp目录不允许执行脚本，或bash没有执行权限等。处理建议：建议您检查上述目录或文件是否具有相应权限。如果具备相应权限仍然安装失败，请您在华为云管理控制台的右上角，单击“工单 > 新建工单”，通过工单向技术人员寻求帮助。
下载安装文件失败	仅Linux主机会出现此类报错，建议参考以下操作排查安全组、DNS配置。检查安全组登录服务器，执行以下命令，确认服务器安全组出方向是否放通100.125.0.0/16网段的10180端口。 curl -kv https://hss-agent.区域代码.myhuaweicloud.com:10180 命令中的区域代码，每个区域不同，各区域代码请参见地区和终端节点。以“华北-北京一”为例，完整命令示例：curl -kv https://hss-agent.cn-north-1.myhuaweicloud.com:10180 已放通：ping命令执行正常，表示已放通100.125.0.0/16网段的10180端口。未放通：ping命令执行后，界面卡住不动，表示未放通100.125.0.0/16网段的10180端口，请参见添加安全组规则放通该端口。检查DNS配置登录服务器，执行以下命令，确认服务器DNS能否正常解析下载Agent的域名。 ping -c 1 hss-agent.区域代码.myhuaweicloud.com 命令中的区域代码，每个区域不同，各区域代码请参见地区和终端节点。以“华北-北京一”为例，完整命令示例：ping -c 1 hss-agent.cn-north-1.myhuaweicloud.com 解析成功：界面回显解析出的IP，表示DNS解析正常。解析失败：界面回显“name or service not known”或未解析出IP，表示DNS解析失败。请参考修改DNS。
磁盘不足	请检查以下目录，确保磁盘容量充足： Linux /usr/local：Agent默认安装路径，须确保磁盘可用容量大于300 MB。 /temp：Agent安装包下载路径，须确保磁盘可用容量大于100 MB Windows C:\Users\xxx\Downloads：Agent安装包下载路径，须确保磁盘可用容量大于100 MB。 C:\Program Files\HostGuard：Agent默认安装路径，须确保磁盘可用容量大于300 MB。
DEW未找到托管的私钥	请检查并确保您的DEW密钥对已托管。
安装异常	请参考以下操作解决问题：登录主机安全服务控制台。在单击管理控制台左上角的，选择区域和项目。在左侧导航栏，选择“安装与配置 > 授权管理”，进入授权管理页面。查看授权列表中是否有VPCEPOperatePolicy、VPCOperatePolicy权限。是：请您在管理控制台的右上角，单击“工单 > 新建工单”，通过工单向技术人员寻求帮助。否：请您单击授权列表左上方“新增授权”，将VPCEPOperatePolicy、VPCOperatePolicy权限授予HSS后，重试安装Agent。关于上述权限的含义和作用，请参见授权关联云服务权限。
网卡路由冲突不支持打通VPC网络	您服务器的网卡和执行Agent安装的服务器已挂载的弹性网卡存在路由冲突，不支持打通VPC网络，建议通过命令行方式安装Agent。

通过命令行安装Agent失败

如果您通过“命令行”安装模式（即登录服务器执行命令）安装Agent失败，可参考本节根据执行命令后的界面回显处理问题。

Linux安装失败

问题现象：网络不通，访问超时
图1 网络不通，访问超时

处理建议：请检查网络配置，保证服务器可正常访问网络。
问题现象：没有权限
图2 没有权限

处理建议：执行命令的用户非root用户，请使用root用户登录服务器后，再执行安装命令。
问题现象：域名无法解析
图3 域名无法解析

处理建议：服务器无法访问Agent下载地址，需要配置华为云内网DNS地址。配置具体操作请参考修改DNS。
问题现象：/tmp磁盘不足100 MB
图4 /tmp磁盘不足100 MB

处理建议：/tmp目录是Agent安装包的下载路径，须确保磁盘可用容量大于100 MB。
问题现象：/usr/local磁盘不足300 MB
图5 /usr/local磁盘不足300 MB

处理建议：/usr/local目录是Agent默认安装路径，须确保磁盘可用容量大于300 MB。
问题现象：TLS协议不兼容 curl: (35) SSL connect error
处理建议：安装HSS agent，要求TLS为1.2及以上版本。如果TLS版本不满足，请手动将安装命令中的“curl -k -O”替换为“curl --tlsv1.2 -k -O”，重试安装Agent。

以下是命令修改示例，请不要直接使用。
- 修改前的安装命令
   curl -k -O 'https://hss-agent.xxx.myhuaweicloud.com:10180/package/agent/linux/install/agent_Install.sh' && echo 'MASTER_IP=hss-agent.xxx.myhuaweicloud.com:10180' > hostguard_setup_config.conf && echo 'SLAVE_IP=hss-agent-slave.xxx.myhuaweicloud.com:10180' >> hostguard_setup_config.conf && echo 'ORG_ID=' >> hostguard_setup_config.conf && bash agent_Install.sh && rm -f agent_Install.sh
- 修改后的安装命令
   curl --tlsv1.2 -k -O 'https://hss-agent.xxx.myhuaweicloud.com:10180/package/agent/linux/install/agent_Install.sh' && echo 'MASTER_IP=hss-agent.xxx.myhuaweicloud.com:10180' > hostguard_setup_config.conf && echo 'SLAVE_IP=hss-agent-slave.xxx.myhuaweicloud.com:10180' >> hostguard_setup_config.conf && echo 'ORG_ID=' >> hostguard_setup_config.conf && bash agent_Install.sh && rm -f agent_Install.sh

Windows安装失败

使用PowerShell运行脚本后，出现错误提示，请参考以下建议解决问题。

错误提示：username and password cannot be empty
处理建议：批量安装Agent时，准备的“windows-host-list.xlsx”文件中填写的服务器账号或密码信息不正确，请重新核对并进行修改。
错误提示：remote connect failed
处理建议：批量安装Agent时，除了执行脚本的服务器，其他服务器需要设置安全组入方向允许执行脚本的服务器IP访问5985端口。请检查是否有服务器安全组入方向未放通5985端口。添加安全组规则请参见添加安全组规则。
错误提示：download package failed
处理建议：下载安装包失败，服务器无法访问Agent下载地址。请检查安全组、DNS配置。
- 检查安全组：请检查服务器安全组出方向是否放通100.125.0.0/16网段的10180端口。具体请参考修改安全组。
- 检查DNS配置：请检查服务器DNS地址是否为华为云内网DNS。具体请参考修改DNS。
错误提示：hostguard install failed
处理建议：请您在管理控制台的右上角，单击“工单 > 新建工单”，通过工单向技术人员寻求帮助。
错误提示：Invoke-Command：无法对参数“session”执行参数验证。参数为Null或空。请提供一个不为Null或空的参数，然后重试该命令。
处理建议：WinRM服务默认禁用非加密通讯。请参考如下操作，允许非加密通讯。
1. 以Windows系统管理员身份运行PowerShell。
2. 执行如下命令，查看基于HTTP的WinRM是否开启。
  winrm enumerate winrm/config/listener
  - 如果存在报错信息，则表示WinRM服务未开启，请执行3。
  - 如果不存在报错信息，则表示WinRM服务已开启，请执行4。
3. 执行如下命令开启WinRM，选择y完成设置。
  winrm quickconfig
4. 配置Auth。
  1. 执行如下命令，查看Auth信息。
    winrm get winrm/config/service/auth
    
    图6 查看Auth信息
  2. 执行如下命令修改“Basic”的值为“true”。
    当返回值中“Basic”的值为“true”时，无需执行该步骤。
    
    winrm set winrm/config/service/auth '@{Basic="true"}'
5. 配置加密方式为允许非加密。
  1. 执行如下命令，查看client信息。
    winrm get winrm/config/client
    
    图7 查看client信息
    
    当返回值中“AllowUnencrypted”为“false”时，请执行5.b。
  2. 执行如下命令，修改“AllowUnencrypted”为“true”。
    winrm set winrm/config/client '@{AllowUnencrypted="true"}'

父主题： Agent相关

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消