安装UniAgent（新版）

前提条件

• 明确需要安装 UniAgent的服务器，以及准备各云服务器 root 权限的登录账号和密码。
• 如果是通过中转机安装UniAgent，需确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通。
• 如果在此项目下还设有调用凭证 AccessCode，需要先创建1个AccessCode，详情请参见创建AccessCode。

约束与限制

• 安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见操作系统使用限制。
• 如果您进入的是旧版安装UniAgent页面，需在左侧导航栏选择“设置 > 采集设置 > UniAgent管理”，单击“UniAgent管理”页面右上角“体验新版”进入新版安装UniAgent页面。如需返回旧版安装UniAgent，单击“UniAgent管理”页面右上角“返回旧版”按钮，进入旧版安装页面。控制台手动安装UniAgent（本Region内主机）
• 如果待安装UniAgent的服务器中包含CCE集群托管的云服务器，建议您前往“K8s集群管理”页面安装UniAgent。

安装方式说明

AOM支持对主机安装UniAgent。UniAgent有以下几种安装方式，您可以按照实际场景进行选择。

脚本快速安装UniAgent（本Region内）

1. 登录AOM 2.0控制台。
2. 在左侧导航栏选择“设置 > 全局设置”，在全局设置页面选择“采集设置 > UniAgent管理”并单击页面右上角“体验新版”。
3. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，单击“安装UniAgent”。
4. 选择“安装场景”为“脚本快速安装（推荐）”。（“其他服务器”页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的“安装UniAgent”后，无需选择安装场景，直接进入安装UniAgent页面。）
5. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。
   图1 安装UniAgent
   

   表2 安装参数说明表

   参数	说明	示例
   服务器所在Region	选择待安装UniAgent的云服务器所在区域支持以下两种： 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。	本Region内
   服务器类型	选择云服务器类型支持以下两种： ECS云服务器：ECS云服务器管理下的主机。 其他服务器：其他服务器管理下的主机。	ECS云服务器
   选择安装模式	选择安装模式当前仅支持命令行安装。 控制台会提供安装命令，您需要远程登录机器执行安装命令。	命令行安装
   云服务器操作系统	选择云服务器操作系统，当前支持Linux和Windows。	Linux
   UniAgent版本	选择待安装的UniAgent版本，默认最新版本。	最新版本
   复制并执行安装命令	安装UniAgent的命令，分为Linux和Windows： 云服务器操作系统设置为“Linux”： 单击“复制命令”，复制以下安装命令 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 *********************************** set -o history; 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行安装命令。 当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）： 登录待安装UniAgent的Window操作系统服务器。 下载安装包：uniagentd-x.x.x.x-winxx.zip。 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）： master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx 可单击“复制命令”，直接复制以上配置信息。 管理员身份执行：C:\uniagentd\bin\start.bat 启动程序。	复制并执行安装命令

6. 安装完成后，可在UniAgent列表中查看UniAgent状态。

脚本快速安装UniAgent（本Region外）

1. 登录AOM 2.0控制台。
2. 在左侧导航栏选择“设置 > 全局设置”，在全局设置页面选择“采集设置 > UniAgent管理”并单击页面右上角“体验新版”。
3. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，，单击“安装UniAgent”。
4. 选择“安装场景”为“脚本快速安装（推荐）”。（“其他服务器”页签中的服务器仅支持通过脚本快速安装方式来安装UniAgent，单击该页签的“安装UniAgent”后，无需选择安装场景，直接进入安装UniAgent页面。）
5. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。
   图2 安装UniAgent
   

   表3 安装参数说明表

   参数	说明	示例
   服务器所在Region	选择待安装UniAgent的云服务器所在区域支持以下两种： 本Region内：云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。 本Region外：云服务器所在区域与当前AOM服务端不在同一区域，跨区域的云服务器默认与AOM服务端网络不通，需要根据场景选择合适的网络联通方案。	本Region外
   云服务器操作系统	选择云服务器操作系统，当前支持Linux和Windows。	Linux
   网络连通方式	选择网络连通方式，当前仅支持公网。支持公网的区域为：华北-北京四、华东-上海一、华东-上海二、华南-广州区域。 区域外主机与公网连通后，就可以通过公网将数据上传到服务端。	公网
   复制并执行安装命令	安装UniAgent的命令，分为Linux和Windows： 云服务器操作系统设置为“Linux”： 单击“复制命令”，复制以下安装命令： 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 *********************************** set -o history; 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行安装命令。 当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）： 登录待安装UniAgent的Window操作系统服务器。 下载安装包：uniagentd-x.x.x.x-winxx.zip。 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置： master=https://xxx.xx.xxx.xxx:xxxxx project_id=****************** public_net=xxx 以管理员身份执行：C:\uniagentd\bin\start.bat启动程序。	复制并执行安装命令

6. 安装完成后，可在UniAgent列表中查看UniAgent状态。

控制台手动安装UniAgent（本Region内主机）

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“设置 > 全局设置”，进入全局设置页面。
3. 在全局设置页面左侧导航栏选择“采集设置 > UniAgent管理”，单击右上角“体验新版”。
4. 进入新版UniAgent管理页面后，默认进入“ECS 云服务器”页签，单击“安装UniAgent”。
5. 选择“安装场景”为“控制台手动安装”。（仅“ECS 云服务器”页签中的主机支持通过控制台手动安装UniAgent。）
6. 在安装UniAgent页面中，配置相关参数信息。
   1. 配置基本信息，并选择服务器，单击“下一步”。
      图3 配置基本信息
      

      表4 安装参数说明表

      参数	说明	示例
      服务器所在Region	待安装UniAgent的云服务器所在区域仅支持“本Region内”。 云服务器所在区域与当前AOM服务端在同一区域，默认云服务器与AOM服务端网络互通。	本Region内
      服务器类型	云服务器类型仅支持ECS云服务器。	ECS云服务器
      选择安装模式	安装模式当前支持命令行安装和界面安装。	界面安装
      云服务器操作系统	操作系统支持Linux和Windows。（仅安装模式选择“命令行安装”时，需要设置。）	Linux
      UniAgent版本	选择待安装的UniAgent版本，默认最新版本。	最新版本
      复制并执行安装命令	安装UniAgent的命令，分为Linux和Windows（仅安装模式选择“命令行安装”时，需要执行。）： 云服务器操作系统设置为“Linux”： 单击“复制命令”，复制以下安装命令 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 *********************************** set -o history; 使用远程登录工具，登录待安装UniAgent的Linux操作系统服务器，并以root权限执行安装命令。 当UniAgent和ICAgent都没安装时，执行以上安装命令可同时安装UniAgent和ICAgent；如果安装了UniAgent或ICAgent中的其中一个，则执行以上安装命令可以安装另一个。 云服务器操作系统设置为“Windows”（此种方式只支持安装UniAgent）： 登录待安装UniAgent的Window操作系统服务器。 下载安装包：uniagentd-x.x.x.x-winxx.zip。 解压后，点击uniagentd.msi，指定安装路径为C:\uniagentd。 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置（可选，仅安装1.1.3或以前的版本才需要执行该步骤）： master=https://xxxxxx.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx 可单击“复制命令”，直接复制以上配置信息。 管理员身份执行：C:\uniagentd\bin\start.bat 启动程序。	复制并执行安装命令
      选择服务器	单击“添加服务器”，在弹出框中选择待安装UniAgent的云服务器。（仅安装模式选择“界面安装”时，需要设置。） 在“选择已有服务器”页签候勾选一个或多个已有的云服务器。仅支持选择Linux操作系统的云服务器。 选择完云服务器后，可以执行如下操作： 如果需要去掉所选服务器，可单击“移除”。 通过服务器ID或服务器名称等信息对列表进行过滤。 单击，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。 单击，手工刷新服务器列表。	选择服务器

   2. 检查上一步选择的服务器所属虚拟私有云下，是否已配置了中转机（即检查同一虚拟私有云下，是否有服务器安装了UniAgent，如果是，则自动被筛选出来，作为中转机。），并单击“下一步”。（仅安装模式选择“界面安装”时，需要执行。）
      图4 检查中转机
      

      在“检查中转机”页面您还可以执行如下操作：

      • 如果虚拟私有云下有多台服务器安装了UniAgent，可根据实际需求单击该虚拟私有云的操作列“更换中转机”，在弹出框中选择适合的主机作为中转机。
      • 如果虚拟私有云下没有服务器安装UniAgent，可单击该虚拟私有云的操作列“配置中转机”，复制安装命令，然后在一台服务器上手动执行安装命令去安装UniAgent，将其定义为中转机。
      • 通过“虚拟私有云”或“中转机配置”对列表进行过滤查询。
      • 单击，通过选中/取消选中各展示项前的复选框，自定义列表项的展示/隐藏。
      • 单击，手工刷新中转机列表。
   3. 进行连通性测试.。（仅安装模式选择界面安装时，需要执行。）
      1. 在服务器所在“账号（具备 root 权限）”、“密码”、以及“端口”列分别配置登录该服务器具有root权限的账号和密码，以及端口号。
      2. 单击“操作”列的“测试”。

      如果多个服务器具有相同root权限的账号、密码、以及端口号，可勾选服务器前的复选框，并单击“批量配置登录账号”批量填充root账号、密码、已经端口号，然后单击“批量测试”

   4. 连通性测试成功后，单击“完成安装”。

7. 安装完成后，可在UniAgent列表中查看查看UniAgent状态。。

通过中转机执行脚本安装UniAgent（单机安装）

一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，为另一个服务器远程安装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 install success”时，表示安装成功，UniAgent已安装在了“/usr/local/uniagentd”目录。安装成功后，在AOM控制台左侧导航栏中选择“采集设置 > UniAgent管理”，查看该服务器的UniAgent状态。

通过中转机执行脚本安装UniAgent（批量安装）

一台已成功安装UniAgent的服务器作为中转机，在该中转机上执行脚本，批量为其他服务器远程安装UniAgent。

• 前提条件：
  • 确保中转机（已成功安装UniAgent的服务器）与待安装UniAgent的主机间网络互通，且ssh命令可执行。
  • 已收集需要安装UniAgent的所有服务器IP、root权限用户的密码，并按照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 install success”时，表示安装成功，UniAgent已安装在了“/usr/local/uniagentd”目录。安装成功后，在AOM控制台左侧导航栏中选择“采集设置 > UniAgent管理”，查看该服务器的UniAgent状态。

查看UniAgent状态

在“UniAgent管理”页面查看目标主机的UniAgent状态，详细请参见表4 UniAgent状态说明。

主机成功安装完UniAgent后，UniAgent会在本地启动查询端口“39338”和“39339”，用于查询日志级别，采集任务等。

其他相关操作

您可以对已安装UniAgent的主机执行如下相关操作：

安装时遇到的问题和解决方法

如果您在安装UniAgent时遇到问题，请参考常见问题处理。