文档首页/ 企业主机安全 HSS/ 常见问题/ Agent相关/ Agent安装失败应如何处理?
更新时间:2024-11-15 GMT+08:00

Agent安装失败应如何处理?

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

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

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

表1 安装Agent失败处理建议

管理控制台提示信息

处理建议

网络不通,访问超时

  • Linux

    请检查网络配置,保证服务器可正常访问网络。

  • Windows
  1. 以Windows系统管理员身份运行PowerShell。
  2. 执行以下命令,查看Service信息。

    winrm get winrm/config/service

    • 如果AllowUnencrypted的值为“true”,请检查网络配置,保证服务器可正常访问网络。
    • 如果AllowUnencrypted的值为“false”,执行以下命令,修改AllowUnencrypted的值为“true”。

      winrm set winrm/config/service '@{AllowUnencrypted="true"}'

  3. 重试通过HSS控制台界面为Windows主机安装Agent。
  4. Agent安装成功后,请执行以下命令,修改AllowUnencrypted的值为“false”。

    winrm set winrm/config/service '@{AllowUnencrypted="false"}'

认证错误,口令不正确

密码错误,请检查您填写的密码信息。

内存空间不足

安装Agent时,需要保障至少50MB内存空间可用。请检查并清理内存空间。

metadata检查失败

metadata获取失败,请参考Linux操作系统云服务器无法获取元数据怎么办?解决问题。

expect安装失败

请检查网络是否存在波动,待网络恢复正常后重试安装Agent。

如果网络正常仍然安装失败,请您在华为云管理控制台的右上角,单击“工单 > 新建工单”,通过工单向技术人员寻求帮助。

打通VPC网络失败

您未将VPCOperatePolicy权限授予HSS,HSS无法打通不同VPC之间的网络。建议参考以下操作完成授权:

  1. 登录企业主机安全控制台。
  2. 在单击管理控制台左上角的,选择区域和项目。
  3. 在左侧导航栏,选择安装与配置 > 授权管理,进入授权管理页面。
  4. 单击授权列表左上方“新增授权”,将VPCOperatePolicy权限授予HSS。

关于VPCOperatePolicy权限的含义和作用,请参见授权管理

绑定的DEW密钥状态异常

请检查并将您的DEW密钥对恢复为“正常”状态。

VPCEP打通失败

您未将VPCEPOperatePolicy权限授予HSS,HSS无法创建终端节点,终端节点用于Agent与HSS服务端进行通信。建议参考以下操作完成授权:

  1. 登录企业主机安全控制台。
  2. 在单击管理控制台左上角的,选择区域和项目。
  3. 在左侧导航栏,选择安装与配置 > 授权管理,进入授权管理页面。
  4. 单击授权列表左上方“新增授权”,将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默认安装路径,须确保磁盘可用容量大于300MB。
    • /temp:Agent安装包下载路径,须确保磁盘可用容量大于100MB
  • Windows
    • C:\Users\xxx\Downloads:Agent安装包下载路径,须确保磁盘可用容量大于100MB。
    • C:\Program Files\HostGuard:Agent默认安装路径,须确保磁盘可用容量大于300MB。

DEW未找到托管的私钥

请检查并确保您的DEW密钥对已托管。

安装异常

请参考以下操作解决问题:

  1. 登录企业主机安全控制台。
  2. 在单击管理控制台左上角的,选择区域和项目。
  3. 在左侧导航栏,选择安装与配置 > 授权管理,进入授权管理页面。
  4. 查看授权列表中是否有VPCEPOperatePolicy、VPCOperatePolicy权限。
    • 是:请您在管理控制台的右上角,单击“工单 > 新建工单”,通过工单向技术人员寻求帮助。
    • 否:请您单击授权列表左上方“新增授权”,将VPCEPOperatePolicy、VPCOperatePolicy权限授予HSS后,重试安装Agent。

      关于上述权限的含义和作用,请参见授权管理

网卡路由冲突不支持打通VPC网络

您服务器的网卡和执行Agent安装的服务器已挂载的弹性网卡存在路由冲突,不支持打通VPC网络,建议通过命令行方式安装Agent。

通过命令行安装Agent失败

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