# 为主机安装UniAgent UniAgent（全称：统一数据采集Agent）是云服务运维系统的核心底座组件，核心能力包括中间件指标采集、自定义指标采集及脚本下发执行通道三大模块，为云资源自动化运维提供底层支撑。 本章将详细介绍在云运维平台进行UniAgent的[安装]、[重装]、[升级]、[卸载]及[状态同步]等关键操作流程，帮助您完成组件部署与生命周期管理。安装完成后，您可通过UniAgent实现对目标资源的自动化运维操作（如指标监控、脚本批量执行等）。 #### 约束与限制 - 当前只有弹性云服务器ECS实例和裸金属服务器BMS实例支持在COC上执行UniAgent的相关操作。 - 支持批量安装UniAgent，最大支持批量安装100台。 - 操作系统使用限制：目前只支持Linux系统，Windows系统需手动安装，具体操作请参考[为ECS安装UniAgent](https://support.huaweicloud.com/usermanual-ecs/ecs_03_2505.html)。 - 对于Linux x86_64服务器，支持[表1]中所有的操作系统及版本。 - 对于Linux ARM服务器，当前CentOS操作系统支持7.4/7.5/7.6版本，EulerOS操作系统支持2.0版本，Ubuntu操作系统支持18.04版本。 表1UniAgent支持的Linux操作系统及版本 | **操作系统** | **版本** |||||||| |:---|:---|---|---|---|---|---|---|---| | EulerOS | 1.1 64bit | 2.0 64bit ||||||| | CentOS | 7.1 64bit | 7.2 64bit | 7.3 64bit | 7.4 64bit | 7.5 64bit |||| | CentOS | 7.6 64bit | 7.7 64bit | 7.8 64bit | 7.9 64bit | 8.0 64bit |||| | Ubuntu | 16.04 server 64bit | 18.04 server 64bit | 20.04 server 64bit | 22.04 server 64bit ||||| #### 安装UniAgent 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 在"资源管理"页面，勾选目标实例，选择"UniAgent \> 安装"或单击UniAgent状态列的"立即安装"。 同一个VPC下首次安装UniAgent时，需要手动安装UniAgent，并把安装成功后的主机设置成安装机，相关操作请参考：[首次安装UniAgent](https://support.huaweicloud.com/coc_faq/coc_faq_02_001.html)。 图1安装UniAgent ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002751387130.png "点击放大") 4. 在安装UniAgent页面，设置安装UniAgent的基本信息。 表2安装UniAgent参数说明 | **参数** | **说明** | |:---|:---| | UniAgent版本 | 在下拉列表选择UniAgent的版本。 | | 接入方式 | 接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。 - 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。 - 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。 - 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式远程安装UniAgent。 | | 代理区域 | 当"接入方式"选择"代理接入"时，需选择代理区域。 代理区域是对代理机的分类管理；代理机是指在华为云购买和配置一台华为云弹性云服务器ECS，为解决多云之间网络互通。 | | 安装机 | 在下拉列表选择安装机。 选择一台已经安装了UniAgent的主机作为安装机，安装机通过代理的方式作为中间桥梁安装UniAgent到同一个VPC下的其他主机。 | | 待安装主机 | 填写需安装UniAgent主机的详细信息。 - 主机名称：主机名称。 - 主机IP：主机的IP。 - 操作系统：主机的操作系统，目前仅支持Linux。 - 登录账号：登录主机的账号。当操作系统为Linux时，建议使用root账号，可保证有足够的读写权限。 - 登录端口：访问主机的端口。 - 认证方式：认证方式为密码。 - 密码：登录主机的密码。 - 运维测试结果：连接测试的结果，测试安装机和需安装主机间的网络连通性。 - 操作： - 连接测试。 - 删除。 | 5. （可选）支持批量操作。 - 批量连接测试：选择多个待安装的主机，单击批量连接测试，可批量对勾选的主机执行运维连接测试。 - 批量填充数据 - 手动输入批量回填：支持登录账号、登录端口及密码进行批量回填。 图2手动输入 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866239.png "点击放大") - Excel批量导入：可单击"下载模板"，根据模板手动填入相关数据，再通过Excel表批量导入填充数据。 图3批量导入 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866223.png "点击放大") - 批量导出：批量导出全量待安装的主机数据。 6. 单击"确定"，等待安装完成。 UniAgent的安装及状态同步大约需要几分钟，您可以耐心等待并[同步UniAgent状态]。安装成功后，资源列表中UniAgent状态显示"运行中"，即可进行后续运维操作。 #### 重装UniAgent 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 勾选UniAgent状态为"异常"、"已卸载"或"安装失败"的实例，单击"UniAgent \> 重装"或单击UniAgent状态列的"重新安装"。 图4重装UniAgent ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866237.png "点击放大") 4. 参数信息与安装UniAgent中参数基本一致，请参考[表3 安装UniAgent参数说明]。 表3安装UniAgent参数说明 | **参数** | **说明** | |:---|:---| | UniAgent版本 | 在下拉列表选择UniAgent的版本。 | | 接入方式 | 接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。 - 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。 - 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。 - 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式远程安装UniAgent。 | | 代理区域 | 当"接入方式"选择"代理接入"时，需选择代理区域。 代理区域是对代理机的分类管理；代理机是指在华为云购买和配置一台华为云弹性云服务器ECS，为解决多云之间网络互通。 | | 安装机 | 在下拉列表选择安装机。 选择一台已经安装了UniAgent的主机作为安装机，安装机通过代理的方式作为中间桥梁安装UniAgent到同一个VPC下的其他主机。 | | 待安装主机 | 填写需安装UniAgent主机的详细信息。 - 主机名称：主机名称。 - 主机IP：主机的IP。 - 操作系统：主机的操作系统，目前仅支持Linux系统。 - 登录账号：登录主机的账号。当操作系统为Linux时，建议使用root账号，可保证有足够的读写权限。 - 登录端口：访问主机的端口。 - 认证方式：认证方式为密码。 - 密码：登录主机的密码。 - 运维测试结果：连接测试的结果，测试安装机和需安装主机间的网络连通性。 - 操作： - 连接测试。 - 删除。 | 5. 设置完成后，单击"确定"，等待重装完成。 #### 升级UniAgent 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 勾选已经安装UniAgent的实例，单击"UniAgent \> 升级"，将弹出升级UniAgent页面。 图5升级UniAgent ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780946093.png "点击放大") 4. 升级UniAgent页面，选择需要升级的版本。 图6选择升级版本 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780946107.png "点击放大") 5. 单击"确定"后，在确认弹框中确认升级版本并单击"确定"，等待升级完成。 升级成功后，在查看详情页面将展示UniAgent升级后的版本。 图7查看升级后版本 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002751387118.png "点击放大") #### 卸载UniAgent 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 勾选已经安装UniAgent的实例，选择"UniAgent \> 卸载"。 图8卸载UniAgent ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866245.png "点击放大") 4. 单击"确定"，等待卸载完成。 #### 同步UniAgent状态 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 勾选已经安装UniAgent的实例，单击"UniAgent \> 状态同步"。 页面提示"状态同步成功"，表示同步完成。 图9状态同步 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002751227226.png "点击放大") #### 查看UniAgent操作日志 1. 登录[云运维中心](https://console.huaweicloud.com/coc/?#/console/home)。 2. 在左侧导航栏选择"资源管理 \> 应用资源管理"，进入应用资源管理页面。 3. 单击"UniAgent操作日志"，可查看UniAgent操作的历史记录。 图10状态同步 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002780866233.png "点击放大") 4. 单击"UniAgent常见问题"，可查看UniAgent操作中常见问题及解决方案。 图11状态同步 ![](https://support.huaweicloud.com/usermanual-coc/zh-cn_image_0000002751227222.png "点击放大")