安装UniAgent

前提条件

请确保安装机与待安装UniAgent的主机间网络互通。

约束与限制

• 安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见操作系统使用限制。
• 如果您进入的是新版安装UniAgent页面，需在左侧导航栏选择“设置 > 采集设置 > UniAgent 安装与配置”，单击“UniAgent 安装与配置”页面右上角“返回旧版”返回至旧版安装UniAgent页面。如需体验新版安装UniAgent功能，单击“UniAgent 安装与配置”页面右上角“体验新版”按钮，进入新版安装页面。

安装方式说明

AOM支持对主机安装UniAgent，UniAgent有三种安装方式：Excel导入安装、手动安装和远程安装。您可以按照实际场景进行选择。

手动安装UniAgent

首次安装UniAgent时，必须使用手动安装方式。

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“设置”，进入全局配置界面。
3. 左侧导航栏中，选择“采集设置 > UniAgent 安装与配置”，单击右上角“安装UniAgent”，选择“手动安装”。（首次安装UniAgent时，默认进入“手动安装”页面，无需选择“手动安装”。）
4. 在安装UniAgent页面中，配置相关安装UniAgent参数信息。
   图2 手动安装UniAgent
   

   表2 手动安装参数说明表

   参数	说明	示例
   UniAgent版本	UniAgent的版本，必选项。	1.0.8
   接入方式	接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式安装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-xxxxxx/install_uniagent.sh;bash /tmp/install_uniagent -a xxxxxxxxxx -s xxxxxxxxxx -p xxxxxx -d https://aom-uniagent-xxxxxx -m https://uniagent.master.cnxxxxxx,https://xx.xx.xx.xx:xxxx -v 1.x.x -q false set -o history; WINDOWS 复制界面下载地址到浏览器，即可下载安装包：https://aom-uniagent-{region_name}.obs.{region_name}.{Site domain name suffix}/ +uniagentd-{version}-win32.zip 其中{region_name}和{version}均可在安装界面获取： region_name：指定承载REST服务端点的服务器域名或IP，不同服务不同区域的名称不同。 Site domain name suffix ：站点域名后缀，例如“myhuaweicloud.com”。 version：当前所安装的Uniagent的版本。 解压安装包后，单击uniagentd.msi，指定安装路径为C:\uniagentd。 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置 （以下信息均可在安装界面获取）： master=https://aom-mgr-lb.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx project_id=xxxxxxxxxxxxxx public_net=xxxx 以管理员身份执行：C:\uniagentd\bin\start.bat 启动程序。 如果用户需要校验windows安装包的sha256的值，可以下载https://aom-uniagent-{region_name}.obs.{region_name}.{Site domain name suffix}/uniagentd-{version}-win32.zip.sha256文件查看。	复制LINUX安装命令

5. 复制安装命令，在主机中执行该命令进行安装。
   • Linux作系统主机：使用PuTTY等远程登录工具，登录待安装UniAgent的Linux操作系统主机，以root权限执行上一步骤复制的Linux安装命令进行安装。
   • Windows操作系统主机：登录待安装UniAgent的Windows操作系统主机，按照上一步骤中Windows安装命令的提示，下载安装包，并执行相关步骤进行安装。

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

远程安装UniAgent

1. 登录AOM 2.0控制台。
2. 在左侧导航栏中选择“设置”，进入全局配置界面。
3. 左侧导航栏中，选择“采集设置 > UniAgent 安装与配置”，单击右上角“安装UniAgent”。
4. 在安装UniAgent页面中，单击“远程安装”，配置相关安装UniAgent参数信息。（首次安装UniAgent时，默认进入“手动安装”页面，不能选择“远程安装”，必须有可用的安装机，才可进行远程安装。）
   图3 远程安装UniAgent
   

   表3 UniAgent安装参数说明表

   参数	说明	示例
   UniAgent版本	UniAgent的版本，必选项。	1.0.8
   接入方式	接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式安装UniAgent。 直接接入方式仅支持华北-北京四、华东-上海一、华东-上海二、华南-广州区域区分内网和公网。	直连接入（内网）
   代理区域	代理区域是对代理机的分类管理。当接入方式选择“代理接入”时，需选择代理区域，或单击“新增代理区域”可新增代理区域。 代理区域中必须配置可用的代理机，且代理机必须为一台已经安装了UniAgent的云主机，并将其设置为安装机。	选择代理区域
   安装机	安装机是远程安装方式下命令的执行机，必选项。当前通过远程安装方式安装UniAgent时，安装机暂不支持Windows操作系统。 如果没有配置安装机，按如下步骤进行配置： 单击对应的下拉框，选择“设置安装机”。 图4 设置安装机 在弹出的对话框中，选择待配置为安装机的主机，并填写安装机名称。 完成后单击“确认”。	选择安装机
   需安装UniAgent主机	需安装UniAgent主机的详细信息，必选项。 单击“添加主机信息”，填写如下信息（最多支持添加100个主机）： 主机IP：主机的IP。 操作系统：主机的操作系统，Linux和Windows。 当前通过远程安装方式安装UniAgent时，主机暂不支持Windows操作系统。 登录账号：登录主机的账号。当操作系统为Linux时，建议使用root账号，可保证有足够的读写权限。 登录端口：访问主机的端口。 认证方式：认证方式为密码。 密码：登录主机的密码。 连接测试结果：连接测试的结果，测试安装机和需安装主机间的网络连通性。 主机信息填写完后，可在操作列对填写的主机信息进行删除、复制和连接测试。 连接测试用于测试安装机和待安装UniAgent的主机间的网络连通性。测试结果会展示在“连接测试结果”列。（Windows系统的主机暂不支持连接测试。）	配置需安装UniAgent的主机信息
   安装ICAgent	ICAgent为指标和日志采集插件。默认开启安装ICAgent按钮，可选项。输入AK和SK，安装ICAgent（部分区域不需要输入AK和SK，请根据界面提示进行设置）。	-

5. 单击“立即安装”，安装完成后，在UniAgent列表中可查看UniAgent状态。

Excel导入安装UniAgent

当前通过Excel导入安装方式受限开放，如有需求可以通过提交工单，为您开放此功能。

1. 登录AOM 2.0控制台。
2. 在菜单栏选择“设置”，进入全局配置界面。
3. 左侧导航栏中，选择“采集设置 > UniAgent 安装与配置”，单击右上角“安装UniAgent”。
4. 在安装UniAgent页面中，选择“Excel导入安装”，配置相关安装UniAgent参数信息。（首次安装UniAgent时，默认进入“手动安装”页面，不能选择“Excel导入安装”。）
   图5 Excel导入安装UniAgent
   

   表4 Excel导入安装参数说明表

   参数	说明	示例
   UniAgent版本	UniAgent的版本，必选项。	1.1.0
   安装机	安装机是Excel导入安装方式下命令的执行机，必选项。当前通过Excel导入方式安装UniAgent时，安装机暂不支持Windows操作系统。 如果没有配置安装机，按如下步骤进行配置： 单击对应的下拉框，选择“设置安装机”。 图6 设置安装机 在弹出的对话框中，选择待配置为安装机的主机，并填写安装机名称。 完成后单击“确认”。	选择安装机
   Excel导入安装	只能上传一个Excel表格，最多5000条数据；仅支持.xls和.xlsx两种类型。当前通过Excel导入方式安装UniAgent时，主机暂不支持Windows操作系统。 Excel表格参照如下样例填写主机信息： 图7 配置主机信息 ip：待安装UniAgent的主机IP。 账号：登录主机的账号。建议使用root账号，可保证有足够的读写权限。 端口：访问主机的端口。 账号密码：登录主机的密码。	上传填写主机信息的Excel表格

5. 单击“立即安装”，安装完成后，在UniAgent列表中可查看。

查看UniAgent状态

在“ UniAgent 安装与配置”页面在查看目标主机的UniAgent状态。详细请参见表9 UniAgent状态说明。

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

其他相关操作

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

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

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