安装UniAgent

安装前提

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

安装UniAgent的限制说明

安装UniAgent支持的Linux操作系统与Windows操作系统，详情请参见操作系统使用限制。

手动安装

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

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

远程安装

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

   表3 UniAgent安装参数说明表

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

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

Excel导入安装

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

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

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

   参数	说明	示例
   UniAgent版本	UniAgent的版本，必选项。	1.1.0
   安装机	安装机是Excel导入安装方式下命令的执行机，必选项。 如果没有配置安装机，按如下步骤进行配置： 单击对应的下拉框，选择“设置安装机”。 图5 设置安装机 在弹出的对话框中，选择待配置为安装机的主机，并填写安装机名称。 完成后单击“确认”。	-
   Excel导入安装	只能上传一个表格，最多5000条数据；仅支持.xls和.xlsx两种类型。 说明： 当前通过Excel导入方式安装UniAgent时，主机暂不支持Windows操作系统。	-

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

UniAgent状态

UniAgent状态有运行中、异常、安装中、安装失败和未安装。

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

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

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