计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
云手机服务器 CPH
Huawei Cloud EulerOS
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
VPC终端节点 VPCEP
云连接 CC
企业路由器 ER
企业交换机 ESW
全球加速 GA
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
边缘安全 EdgeSec
威胁检测服务 MTD
CDN与智能边缘
内容分发网络 CDN
CloudPond云服务
智能边缘云 IEC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
云搜索服务 CSS
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
数据可视化 DLV
数据湖工厂 DLF
湖仓构建 LakeFormation
企业应用
云桌面 Workspace
应用与数据集成平台 ROMA Connect
云解析服务 DNS
专属云
专属计算集群 DCC
IoT物联网
IoT物联网
设备接入 IoTDA
智能边缘平台 IEF
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
ICP备案
我的凭证
支持计划
客户运营能力
合作伙伴支持计划
专业服务
区块链
区块链服务 BCS
Web3节点引擎服务 NES
解决方案
SAP
高性能计算 HPC
视频
视频直播 Live
视频点播 VOD
媒体处理 MPC
实时音视频 SparkRTC
数字内容生产线 MetaStudio
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
存储容灾服务 SDRS
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属分布式存储服务 DSS
容器
云容器引擎 CCE
容器镜像服务 SWR
应用服务网格 ASM
华为云UCS
云容器实例 CCI
管理与监管
云监控服务 CES
统一身份认证服务 IAM
资源编排服务 RFS
云审计服务 CTS
标签管理服务 TMS
云日志服务 LTS
配置审计 Config
资源访问管理 RAM
消息通知服务 SMN
应用运维管理 AOM
应用性能管理 APM
组织 Organizations
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
应用身份管理服务 OneAccess
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库 GeminiDB
云数据库 GaussDB
分布式数据库中间件 DDM
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
人脸识别服务 FRS
图引擎服务 GES
图像识别 Image
内容审核 Moderation
文字识别 OCR
AI开发平台ModelArts
图像搜索 ImageSearch
对话机器人服务 CBS
华为HiLens
视频智能分析服务 VIAS
语音交互服务 SIS
应用中间件
分布式缓存服务 DCS
API网关 APIG
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
多活高可用服务 MAS
事件网格 EG
企业协同
华为云会议 Meeting
云通信
消息&短信 MSGSMS
云生态
合作伙伴中心
云商店
开发者工具
SDK开发指南
API签名指南
Terraform
华为云命令行工具服务 KooCLI
其他
产品价格详情
系统权限
管理控制台
客户关联华为云合作伙伴须知
消息中心
公共问题
开发与运维
应用管理与运维平台 ServiceStage
软件开发生产线 CodeArts
需求管理 CodeArts Req
部署 CodeArts Deploy
性能测试 CodeArts PerfTest
编译构建 CodeArts Build
流水线 CodeArts Pipeline
制品仓库 CodeArts Artifact
测试计划 CodeArts TestPlan
代码检查 CodeArts Check
代码托管 CodeArts Repo
云应用引擎 CAE
开天aPaaS
云消息服务 KooMessage
云手机服务 KooPhone
云空间服务 KooDrive
文档首页/ 企业主机安全 HSS/ 常见问题/ Agent相关/ Agent安装失败应如何处理?

Agent安装失败应如何处理?

更新时间:2025-01-21 GMT+08:00

如果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进行托管。

如果密钥对已完成托管,安装Agent时HSS仍然提示您未找到托管的私钥,可能是您当前的账号为IAM子账号或委托账号,缺少数据加密服务(DEW)中密钥对管理服务(KPS)相关权限。您可以前往IAM控制台,选择以下两种方式之一进行授权:

  • 授权方式1:为安装Agent的账号授予DEW KeypairFullAccess权限(密钥对管理服务的所有权限)。
  • 授权方式2:如果您不希望安装Agent的账号具有删除密钥对等高危权限,您可以创建如下自定义策略,并将该策略授权给安装Agent的账号。具体创建步骤请参见:创建自定义策略
    授权用户查询、导出密钥对
    {
        "Version": "1.1",
        "Statement": [
            {
                "Action": [
                    "kps:domainKeypairs:exportpk",
                    "kps:domainKeypairs:list",
                    "kps:domainKeypairs:get"
                ],
                "Effect": "Allow"
            }
        ]
    }

安装异常

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

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

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

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

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

通过命令行安装Agent失败

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

我们使用cookie来确保您的高速浏览体验。继续浏览本站,即表示您同意我们使用cookie。 详情

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容