
# 安装UniAgent（新版）
AOM通过统一数据采集Agent（简称UniAgent）实现统一插件生命周期管理，并支持通过UniAgent下发和执行脚本指令。UniAgent本身不提供指标数据采集能力，运维数据由不同的插件分工采集，可在接入中心安装对应的插件，并创建采集任务，来进行指标数据采集。
AOM支持对本Region内或本Region外的ECS云服务器或其他服务器主机安装UniAgent。
- 本Region内：给区域内主机安装UniAgent，即给用户登录[AOM服务控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)所在region区主机安装UniAgent。
- 本Region外：给区域外主机安装UniAgent，即给用户登录[AOM服务控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)所在region区外的其他区域主机或非华为云主机安装UniAgent。例如自建IDC（Internet Data Center，互联网数据中心）、第三方云厂商或华为云跨Region主机等。
 
#### 前提条件
- 明确需要安装UniAgent的服务器，以及准备各云服务器root权限的登录账号和密码。
- 如果是通过中转机安装UniAgent，需确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通。
- 如果在此项目下还没有调用凭证Access Code，需要先创建1个Access Code，详情请参见[创建Access Code](https://support.huaweicloud.com/usermanual-aom2/mon_01_0057.html#mon_01_0057__section1136022272714)。
 
#### 约束与限制
- 安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见[操作系统使用限制](https://support.huaweicloud.com/productdesc-aom2/aom_01_0013.html#section3)。
- 如果您进入的是旧版虚机接入页面，需在左侧导航栏选择"设置 \> 采集设置 \> UniAgent管理"，单击"UniAgent管理"页面右上角"体验新版"进入新版安装UniAgent页面。如需返回旧版安装UniAgent，单击"UniAgent管理"页面右上角"返回旧版"按钮，进入[旧版安装](https://support.huaweicloud.com/usermanual-aom2/agent_01_0005.html)页面。
- 如果待安装UniAgent的服务器中包含CCE集群托管的云服务器，建议您前往"[K8s集群管理](https://support.huaweicloud.com/usermanual-aom2/agent_01_0013.html)"页面安装UniAgent。
- 在使用"脚本快速安装（推荐）"和"控制台手动安装"的安装方式场景中，当"服务器类型"为"ECS云服务器"时，且当前Region支持VPCEP时，需提前购买VPCEP客户端并将其绑定至AOM的VPCEP服务，详情请参考[如何在VPCEP控制台为AOM/LTS创建终端节点？](https://support.huaweicloud.com/faq-aom2/aom_06_0060.html)。当前版本该功能受限开放，如有需求可以通过[提交工单](https://support.huaweicloud.com/usermanual-ticket/zh-cn_topic_0127038618.html)，为您开放此功能。
- 使用"脚本快速安装（推荐）"和"控制台手动安装"的安装方式时，默认会把安装脚本install_uniagent下载到服务器的/tmp路径。如果因服务器的/tmp路径权限限制等原因，无法将安装脚本install_uniagent下载到/tmp路径时，可将安装命令中的/tmp/install_uniagent改为其他指定的目录/{path}/install_uniagent，并在末尾增加-f /{path}，然后再在服务器上执行安装命令，将安装脚本下载至其他指定路径。
  例如指定下载目录为/root，安装命令修改如下：
  ```
  set +o history; 
  curl ********** -o /root/install_uniagent *****;bash /root/install_uniagent ****** -y {Access_Code_ID}-{Access_Code} -f /root
  set -o history;
  ```
  
 
#### 安装方式说明
AOM支持对主机安装UniAgent。UniAgent有以下几种安装方式，您可以按照实际场景进行选择。
表1安装方式 
| 方式         | 适用场景                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 脚本快速安装（推荐） | 适用于首次安装、单机安装UniAgent场景。使用远程登录工具，登录待安装UniAgent的服务器，手动执行安装命令去安装UniAgent，详情请参见： - [脚本快速安装UniAgent（本Region内）]  - [脚本快速安装UniAgent（本Region外）]                     |
| 控制台手动安装    | 适用于在AOM控制台批量安装UniAgent场景。同一虚拟私有云中，在AOM控制台中通过中转机（一台已安装UniAgent的服务器）批量为其他ECS云服务器安装UniAgent。详情请参见：[控制台手动安装UniAgent（本Region内）]。 **该场景必须有一台已经装了UniAgent的服务器，如果是首次安装UniAgent，需要通过脚本快速安装方式进行安装。**                                                                                                                                                                                                                                                                                                                                      |
| 中转机脚本安装    | 适用于通过在中转机上执行脚本安装UniAgent场景。使用远程登录工具，登录中转机（一台已成功安装UniAgent的服务器），然后在该中转机上执行脚本，为一个或多个服务器安装UniAgent： - [通过中转机执行脚本安装UniAgent（单机安装）]  - [通过中转机执行脚本安装UniAgent（批量安装）]   **该场景必须有一台已经装了UniAgent的服务器，如果是首次安装UniAgent，需要通过脚本快速安装方式进行安装。** |
   
- [脚本快速安装UniAgent（本Region内）]
  
  1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
  
  2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。
  
  3. 在全局设置页面选择"采集设置 \> UniAgent管理"，并单击页面右上角"体验新版"。
  
  4. 进入新版UniAgent管理页面后，默认进入"ECS 云服务器"页签，单击"安装UniAgent"。
  
  5. 选择"安装场景"为"脚本快速安装（推荐）"。（"其他服务器"页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的"安装UniAgent"后，无需选择安装场景，直接进入[安装UniAgent页面]。）
  
  6. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。
     
     表2安装参数说明表 
     | 参数          | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 示例        |
     |:---|:---|:---|
     | 服务器所在Region | 选择待安装UniAgent的云服务器所在区域： - 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。  - 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 本Region内  |
     | 服务器类型       | 选择云服务器类型支持以下两种： - ECS云服务器：ECS云服务器管理下的主机。  - 其他服务器：其他服务器管理下的主机。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | ECS云服务器   |
     | 选择安装模式      | 选择安装模式当前仅支持命令行安装。 控制台会提供安装命令，您需要远程登录机器执行安装命令。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 命令行安装     |
     | 云服务器操作系统    | 选择云服务器操作系统，当前支持Linux和Windows。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Linux     |
     | UniAgent版本  | 选择待安装的UniAgent版本，默认最新版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 最新版本      |
     | 复制并执行安装命令   | 安装UniAgent的命令，分为Linux和Windows： - 云服务器操作系统设置为"Linux"： 1. 单击"复制命令"，复制安装命令。可在[认证管理](https://support.huaweicloud.com/usermanual-aom2/mon_01_0057.html)页面获取Access Code的ID和值，然后通过手工替换安装命令中的Access Code的ID和值，也可以单击右侧的"复制命令"登录主机执行命令，根据提示输入Access Code的ID和值。 ``` set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-***************.com/install_uniagent.sh;bash /tmp/install_uniagent -p ************************* -v 1.x.x -e xxxx -y {Access_Code_ID}-{Access_Code};set -o history; ```   2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。   当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。   - 云服务器操作系统设置为"Windows"（此种方式只支持安装UniAgent）： 1. 登录待安装UniAgent的Window操作系统服务器。  2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。 如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-*{region_name}* .obs.*{region_name}* .*{Site domain name suffix}* /uniagentd-*{version}*-win32.zip.sha256文件查看。   3. 解压后，点击uniagentd.msi，指定安装路径为C:\\uniagentd。  4. 修改C:\\uniagentd\\conf\\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）： master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx 可单击"复制命令"，直接复制以上配置信息。   5. 管理员身份执行：C:\\uniagentd\\bin\\start.bat启动程序。     | 复制并执行安装命令 |
        
     
     
  
  7. 安装完成后，可在UniAgent列表中[查看UniAgent状态]。
   
- [脚本快速安装UniAgent（本Region外）]
  
  1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
  
  2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。
  
  3. 在全局设置页面选择"采集设置 \> UniAgent管理"，并单击页面右上角"体验新版"。
  
  4. 进入新版UniAgent管理页面后，默认进入"ECS 云服务器"页签，单击"安装UniAgent"。
  
  5. 选择"安装场景"为"脚本快速安装（推荐）"。（"其他服务器"页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的"安装UniAgent"后，无需选择安装场景，直接进入[安装UniAgent页面]。）
  
  6. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。
     
     图1安装UniAgent   
     ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002202886416.png "点击放大")
     表3安装参数说明表 
     | 参数          | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 示例        |
     |:---|:---|:---|
     | 服务器所在Region | 选择待安装UniAgent的云服务器所在区域： - 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。  - 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 本Region外  |
     | 云服务器操作系统    | 选择云服务器操作系统，当前支持Linux和Windows。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Linux     |
     | 网络连通方式      | 选择网络连通方式，当前仅支持公网。 区域外主机与公网连通后，就可以通过公网将数据上传到服务端。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 公网        |
     | 复制并执行安装命令   | 安装UniAgent的命令，分为Linux和Windows： - 云服务器操作系统设置为"Linux"： 1. 单击"复制命令"，复制以下安装命令。可先在[认证管理](https://support.huaweicloud.com/usermanual-aom2/mon_01_0057.html)页面获取Access Code的ID和值，然后通过手工替换安装命令中的Access Code的ID和值，也可以单击右侧的"复制命令"登录主机执行命令，根据提示输入Access Code的ID和值。 ``` set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-***************.com/install_uniagent.sh;bash /tmp/install_uniagent -o public -p ************************* -e ******** -y {Access_Code_ID}-{Access_Code};set -o history; ```   2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。   当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。   - 云服务器操作系统设置为"Windows"（此种方式只支持安装UniAgent）： 1. 登录待安装UniAgent的Window操作系统服务器。  2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。 如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-*{region_name}* .obs.*{region_name}* .*{Site domain name suffix}* /uniagentd-*{version}*-win32.zip.sha256文件查看。   3. 解压后，点击uniagentd.msi，指定安装路径为C:\\uniagentd。  4. 修改C:\\uniagentd\\conf\\uniagentd.conf文件，填入以下的配置（以下信息均可在安装界面获取）： master=https://xxx.xx.xxx.xxx:xxxxx project_id=\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* public_net=xxx   5. 以管理员身份执行：C:\\uniagentd\\bin\\start.bat启动程序。     | 复制并执行安装命令 |
        
     
     
  
  7. 安装完成后，可在UniAgent列表中[查看UniAgent状态]。
   
- [控制台手动安装UniAgent（本Region内）]
  
  1. 登录[AOM 2.0控制台](https://console.huaweicloud.com/aom2#/aom2/betaTest)。
  
  2. 在左侧导航栏选择"设置 \> 全局设置"，进入全局设置页面。
  
  3. 在全局设置页面选择"采集设置 \> UniAgent管理"，并单击页面右上角"体验新版"。
  
  4. 进入新版UniAgent管理页面后，默认进入"ECS 云服务器"页签，单击"安装UniAgent"。
  
  5. 选择"安装场景"为"控制台手动安装"。（仅"ECS 云服务器"页签中的主机支持通过控制台手动安装UniAgent。）
  
  6. 在安装UniAgent页面中，配置相关参数信息。 
     1. 配置基本信息，并选择服务器，单击"下一步"。
        表4安装参数说明表 
        | 参数          | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 示例        |
        |:---|:---|:---|
        | 服务器所在Region | 待安装UniAgent的云服务器所在区域仅支持"本Region内"。 云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 本Region内  |
        | 服务器类型       | 云服务器类型仅支持ECS云服务器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | ECS云服务器   |
        | 选择安装模式      | 安装模式当前支持命令行安装和界面安装。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 命令行安装     |
        | 云服务器操作系统    | 操作系统支持Linux。 仅安装模式选择"命令行安装"时，需要设置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Linux     |
        | UniAgent版本  | 选择待安装的UniAgent版本，默认最新版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 最新版本      |
        | 复制并执行安装命令   | 安装UniAgent的命令，分为Linux和Windows（仅安装模式选择"命令行安装"时，需要执行。）： - 云服务器操作系统设置为"Linux"： 1. 单击"复制命令"，复制安装命令。可在[认证管理](https://support.huaweicloud.com/usermanual-aom2/mon_01_0057.html)页面获取Access Code的ID和值，然后通过手工替换安装命令中的Access Code的ID和值，也可以单击右侧的"复制命令"登录主机执行命令，根据提示输入Access Code的ID和值。 ``` set +o history; curl -k -X GET -m 20 --retry 1 --retry-delay 10 -o /tmp/install_uniagent https://aom-uniagent-***************.com/install_uniagent.sh;bash /tmp/install_uniagent -p ************************* -v 1.x.x -e xxxx -y {Access_Code_ID}-{Access_Code};set -o history; ```   2. 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行复制的安装命令。   当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。   - 云服务器操作系统设置为"Windows"（此种方式只支持安装UniAgent）： 1. 登录待安装UniAgent的Window操作系统服务器。  2. 下载安装包：uniagentd-x.x.x.x-winxx.zip。 如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-*{region_name}* .obs.*{region_name}* .*{Site domain name suffix}* /uniagentd-*{version}*-win32.zip.sha256文件查看。   3. 解压后，点击uniagentd.msi，指定安装路径为C:\\uniagentd。  4. 修改C:\\uniagentd\\conf\\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）： master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx 可单击"复制命令"，直接复制以上配置信息。   5. 管理员身份执行：C:\\uniagentd\\bin\\start.bat启动程序。     | 复制并执行安装命令 |
        | 选择服务器       | 单击"添加服务器"，在弹出框中选择待安装UniAgent的云服务器。（仅安装模式选择"界面安装"时，需要设置。） - 在"添加服务器"页面勾选一个或多个已有的云服务器。当前支持选择Linux操作系统的云服务器。  - 选择完云服务器后，可以执行如下操作： - 如果需要去掉所选服务器，可单击"移除"。  - 通过服务器ID或服务器名称等信息对列表进行过滤。  - 单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237853805.png)，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。  - 单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002202893434.png)，手工刷新服务器列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 选择服务器     |
           
        
     
     2. 检查上一步选择的服务器所属虚拟私有云下，是否已配置了中转机（即检查同一虚拟私有云下，是否有服务器安装了UniAgent，如果是，则自动被筛选出来，作为中转机。），并单击"下一步"。（仅安装模式选择"界面安装"时，需要执行。）
        图2检查中转机   
        ![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002202733626.png "点击放大")
        在"检查中转机"页面您还可以执行如下操作：
        - 如果虚拟私有云下有多台服务器安装了UniAgent，可根据实际需求单击该虚拟私有云的操作列"更换中转机"，在弹出框中选择适合的主机作为中转机。
        
        - 如果虚拟私有云下没有服务器安装UniAgent，可单击该虚拟私有云的操作列"配置中转机"，复制安装命令，然后在一台服务器上手动执行安装命令去安装UniAgent，将其定义为中转机。
        
        - 通过"虚拟私有云"或"中转机配置"对列表进行过滤查询。
        
        - 单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237813669.png)，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。
        
        - 单击![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002237853809.png)，手工刷新中转机列表。
         
     
     3. 进行连通性测试。（仅安装模式选择界面安装时，需要执行。）
        1. 在服务器所在"账号（具备root权限）（Linux操作系统账号需具备root权限）"、"密码"以及"端口"列分别配置登录的账号、密码以及端口号。
        
        2. 单击"操作"列的"测试"。
        
        
        如果多个服务器具有相同root权限的账号、密码以及端口号，可勾选服务器前的复选框，并单击"批量配置登录账号和密码"批量填充root账号、密码以及端口号，然后单击"批量测试"。
        
     
     4. 连通性测试成功后，单击"完成安装"。
     
     
     
     
  
  7. 安装完成后，可在UniAgent列表中[查看UniAgent状态]。
   
- [通过中转机执行脚本安装UniAgent（单机安装）]
  
  一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，为另一个服务器远程安装UniAgent。（只适用于为Linux操作系统的服务器安装UniAgent。）
  - **前提条件：**确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的服务器主机间网络互通，且ssh命令可执行。
  
  - **操作步骤** ：
    1. 使用远程登录工具，以root权限用户登录中转机（一台已成功安装UniAgent的服务器作为中转机），执行以下命令：
       ```
       bash /usr/local/uniagentd/bin/remote_cmd.sh -ip x.x.x.x -command "安装命令"
       ```
       - x.x.x.x：表示待安装UniAgent的服务器IP地址。
       
       - 安装命令：表示安装UniAgent的安装命令，可从AOM控制台的安装界面[复制安装命令]，然后替换以上命令行中的安装命令。（**复制安装命令时不要包含"set +o history;"和"set -o history;** **"**。）
        
    
    2. 根据提示输入待安装UniAgent的服务器root权限用户的密码。 当UniAgent安装成功后，UniAgent会安装在"/usr/local/uniagentd"目录。可在AOM控制台左侧导航栏中选择"采集设置 \> UniAgent管理"，查看该服务器的[UniAgent状态]。
       
     
   
- [通过中转机执行脚本安装UniAgent（批量安装）]
  
  一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，批量为其他服务器远程安装UniAgent。（只适用于为Linux操作系统的服务器批量安装UniAgent。）
  - **前提条件：**
    - 确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通，且ssh命令可执行。
    
    - 已收集需要安装UniAgent的所有服务器IP、root权限用户的密码（**当前仅支持通过密码方式批量安装** **UniAgent** ），并按照iplist.cfg格式整理好，上传到中转机的/usr/local/uniagentd目录下（该目录可自定义，但需确保与下方[安装操作步骤]中执行安装命令的目录一致）。iplist.cfg格式示例如下所示（IP与密码之间只能用一个空格隔开，其他位置不能包含空格）：
      ```
      192.168.0.109 密码（请根据实际填写）
      192.168.0.39 密码（请根据实际填写）
      ```
      **iplist.cfg中包含您的敏感信息，建议您使用后清理。**
      
     
  
  - **操作步骤** ：
    1. 使用远程登录工具，以root权限用户登录中转机（一台已成功安装UniAgent的服务器）。
    
    2. 执行以下命令：
       ```
       bash /usr/local/uniagentd/bin/remote_cmd.sh -batchModeConfig /usr/local/uniagentd/iplist.cfg -command "安装命令"
       ```
       安装命令：表示安装UniAgent的安装命令，可从AOM控制台的安装界面[复制安装命令]，然后替换以上命令行中的安装命令。（**复制安装命令时不要包含"set +o history;"和"set -o history;** **"**。）
       当UniAgent安装成功后，UniAgent会安装在"/usr/local/uniagentd"目录。可在AOM控制台左侧导航栏中选择"采集设置 \> UniAgent管理"，查看该服务器的[UniAgent状态](https://support.huaweicloud.com/usermanual-aom2/agent_02_0005.html#agent_02_0005__zh-cn_topic_0000001944840874_zh-cn_topic_0000001860836318_section1516722610394)。
       
     
   
 #### 查看UniAgent状态
在"UniAgent管理"页面查看目标主机的UniAgent状态，详细请参见[表5]。
- 当处于"运行中"状态的UniAgent有新版时，"UniAgent管理"页面的"UniAgent版本"列会提示"可升级"，您可根据需要升级UniAgent的版本，详情请参考[升级UniAgent](https://support.huaweicloud.com/usermanual-aom2/agent_01_0006.html#agent_01_0006__section869763991319)。（如果CCE集群中的主机安装的UniAgent有新版时，可升级提示信息仅在"K8s集群管理"页面展示，您可以根据需要在"K8s集群管理"页面升级UniAgent的版本，详情请参考[管理K8s集群的UniAgent和ICAgent插件](https://support.huaweicloud.com/usermanual-aom2/agent_01_0013.html)。）
- 主机成功安装完UniAgent后，UniAgent会在本地启动查询端口，用于查询日志级别，采集任务等。**UniAgent版本号是1.1.5之前的（含1.1.5版本）端口号是"39338"和"39339"，1.1.5版本之后的端口号是"29338"和"29339"。**
 表5UniAgent状态 
| 状态   | 说明                                            |
|:---|:---|
| 运行中  | 表示服务器安装的UniAgent运行正常。                         |
| 离线   | 表示服务器安装的UniAgent功能异常。                         |
| 安装中  | 表示该服务器正在安装UniAgent。安装UniAgent预计需要1分钟左右，请耐心等待。 |
| 安装失败 | 表示服务器安装UniAgent失败，请卸载UniAgent后，并重新安装。         |
| 未安装  | 表示服务器未安装UniAgent。                             |
   
#### UniAgent版本说明
在"UniAgent管理"页面查看目标主机的UniAgent版本，建议您尽快[升级到最新版本](https://support.huaweicloud.com/usermanual-aom2/agent_01_0006.html)。UniAgent版本详细请参见[表6]。
 表6UniAgent版本 
| 版本号   | 说明                                                                                                                                                                                                                                                                                                                                                                    | 发布时间       |
|:---|:---|:---|
| 1.2.0 | 支持自建k8s集群安装UniAgent。                                                                                                                                                                                                                                                                                                                                                  | 2025-11-13 |
| 1.1.9 | 支持对Windows操作系统的主机远程安装UniAgent。                                                                                                                                                                                                                                                                                                                                        | 2025-06-18 |
| 1.1.8 | - 支持CCE集群安装UniAgent。  - 支持对Windows操作系统的主机进行插件管理。   | 2025-02-25 |
| 1.1.6 | 支持Linux操作系统免密登录。（当前仅COC云服务支持该功能）                                                                                                                                                                                                                                                                                                                                      | 2024-11-30 |
| 1.1.5 | Python脚本执行标准输出缓存问题优化。                                                                                                                                                                                                                                                                                                                                                 | 2024-09-18 |
| 1.1.4 | 解决带环境变量场景，执行脚本退出码问题。                                                                                                                                                                                                                                                                                                                                                  | 2024-08-30 |
   
#### 其他相关操作
您可以对已安装UniAgent的主机执行如下相关操作：
表7相关操作 
| 操作      | 说明                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|
| 搜索主机    | 在主机列表上方的搜索框，可以通过服务器ID，服务器名称，运行状态，IP地址来搜索对应主机。                                                                                                                                                                                                                                                                                                                                                  |
| 刷新主机列表  | 单击主机列表右上角的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002111387822.png)按钮，可刷新主机列表信息。                                                                                                                                                                                                                                                                                   |
| 设置主机展示列 | 单击主机列表右上角的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002146866585.png)按钮，可对已接入的主机展示列进行设置。                                                                                                                                                                                                                                                                             |
| 切换排序    | 在主机列表的表头，单击各列的![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002146946981.png)可切换主机排序。![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002111228054.png)为默认排序，![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002111387830.png)为按正序排序，![](https://support.huaweicloud.com/usermanual-aom2/zh-cn_image_0000002146866593.png)为按倒序排序。 |
   
#### 安装时遇到的问题和解决方法
如果您在安装UniAgent时遇到问题，请参考[常见问题](https://support.huaweicloud.com/faq-aom2/aom_06_0022.html)处理。
