agent安装失败应如何处理？-j9九游会登录

如果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解析失败。请参考。
磁盘不足	请检查以下目录，确保磁盘容量充足： 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地址。配置具体操作请参考。
问题现象：/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。具体请参考。
错误提示：hostguard install failed
处理建议：请您在管理控制台的右上角，单击“工单 > 新建工单”，通过工单向技术人员寻求帮助。
错误提示：invoke-command：无法对参数“session”执行参数验证。参数为null或空。请提供一个不为null或空的参数，然后重试该命令。
处理建议：winrm服务默认禁用非加密通讯。请参考如下操作，允许非加密通讯。
1. 以windows系统管理员身份运行powershell。
2. 执行如下命令，查看基于http的winrm是否开启。
  winrm enumerate winrm/config/listener
  
  图6 查看winrm开启情况
  - 如果存在报错信息，则表示winrm服务未开启，请执行3。
  - 如果不存在报错信息，则表示winrm服务已开启，请执行4。
3. 执行如下命令开启winrm，选择y完成设置。
  winrm quickconfig
  
  图7 开启winrm
4. 配置auth。
  1. 执行如下命令，查看auth信息。
    winrm get winrm/config/service/auth
    
    图8 查看auth信息
  2. 执行如下命令修改“basic”的值为“true”。
    当返回值中“basic”的值为“true”时，无需执行该步骤。
    
    winrm set winrm/config/service/auth '@{basic="true"}'
5. 配置加密方式为允许非加密。
  1. 执行如下命令，查看client信息。
    winrm get winrm/config/client
    
    图9 查看client信息
    
    当返回值中“allowunencrypted”为“false”时，请执行5.b。
  2. 执行如下命令，修改“allowunencrypted”为“true”。
    winrm set winrm/config/client '@{allowunencrypted="true"}'

父主题： agent相关

意见反馈

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

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在查看反馈及问题处理状态。

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨