安装uniagent-九游平台

前提条件

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

约束与限制

• 安装uniagent支持的linux操作系统与windows操作系统，详情请参见操作系统使用限制。
• 如果您进入的是新版安装uniagent页面，需在左侧导航栏选择“设置 > 采集设置 > uniagent 安装与配置”，单击“uniagent 安装与配置”页面右上角“返回旧版”返回至旧版安装uniagent页面。如需体验新版安装uniagent功能，单击“uniagent 安装与配置”页面右上角“体验新版”按钮，进入新版安装页面。
• 当前部分区域“设置”菜单名称更名为“全局设置”，“uniagent 安装与配置”菜单名称更名为“uniagent管理”。

安装方式说明

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

手动安装uniagent

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

1. 登录。
2. 在左侧导航栏中选择“设置”，进入全局配置界面。当前部分区域的菜单路径修改为：在左侧导航栏选择“全局设置”，进入全局设置页面。
3. 左侧导航栏中，选择“采集设置 > uniagent 安装与配置”，单击右上角“安装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文件查看。 当前支持通过创建终端节点和aom/lts服务打通网络，进行心跳和指标上报，以及日志上报。目前仅通过原采集管理入口手动安装uniagent时支持创建终端节点。	复制linux安装命令

5. 复制安装命令，在主机中执行该命令进行安装。
   • linux作系统主机：使用putty等远程登录工具，登录待安装uniagent的linux操作系统主机，以root权限执行上一步骤复制的linux安装命令进行安装。
   • windows操作系统主机：登录待安装uniagent的windows操作系统主机，按照上一步骤中windows安装命令的提示，下载安装包，并执行相关步骤进行安装。
6. 安装完成后，在uniagent列表中可查看。

远程安装uniagent

1. 登录。
2. 在左侧导航栏中选择“设置”，进入全局配置界面。当前部分区域的菜单路径修改为：在左侧导航栏选择“全局设置”，进入全局设置页面。
3. 左侧导航栏中，选择“采集设置 > uniagent 安装与配置”，单击右上角“安装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. 登录。
2. 在菜单栏选择“设置”，进入全局配置界面。当前部分区域的菜单路径修改为：在左侧导航栏选择“全局设置”，进入全局设置页面。
3. 左侧导航栏中，选择“采集设置 > uniagent 安装与配置”，单击右上角“安装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时遇到问题，请参考常见问题处理。