文档首页/ 应用运维管理 AOM/ 用户指南（2.0）/ 设置/ 采集设置/ UniAgent 安装与配置/ 安装UniAgent
更新时间：2024-10-17 GMT+08:00
查看PDF
分享

安装UniAgent

对主机安装UniAgent，UniAgent有三种安装方式：Excel导入安装、手动安装和远程安装。

您可以按照您的实际场景进行选择。

表1 安装方式

方式

适用场景

手动安装

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

远程安装

必须有可用的安装机，才可进行远程安装。

说明：

安装机是远程安装方式下命令的执行机。

Excel导入安装

必须有可用的安装机与拥有数据的Excel表格。

说明：

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

如需体验新版安装UniAgent，在左侧导航栏选择“设置 > 采集设置 > UniAgent 安装与配置”，单击右上角“体验新版”按钮，进入新版安装页面。新版安装UniAgent功能在邀测中，支持华北-北京四、华东-上海一局点，仅针对用户内测使用。此种方式受限开放，如有需求可以通过提交工单，为您开放此功能。

安装前提

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

安装UniAgent的限制说明

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

手动安装

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

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

    当前仅华北-北京四、华东-上海一区域菜单路径为：“采集设置 > UniAgent 安装与配置”；其他区域菜单路径为：“采集设置 > 虚机接入”。

  4. 在安装UniAgent页面中，配置相关参数信息。

    图1 手动安装UniAgent
    表2 手动安装参数说明表

    参数

    说明

    示例

    UniAgent版本

    UniAgent的版本，必选项。

    1.0.8

    接入方式

    接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。

    • 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。
    • 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。
    • 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式远程安装UniAgent。如果选择了“代理接入”，还需选择代理区域。代理区域中的代理机必须为一台已经安装了UniAgent的云主机，并将其设置为安装机。
    说明：

    直接接入方式仅支持华北-北京四、华东-上海一、华东-上海二、华南-广州区域区分内网和公网。

    直连接入（内网）

    安装命令

    安装UniAgent的命令，分为LINUX和WINDOWS。

    说明：

    当前支持通过创建终端节点和AOM/LTS服务打通网络，进行心跳和指标上报，以及日志上报。目前此功能仅支持西南-贵阳一局点，其他局点暂不支持。

    LINUX

    1. 单击复制安装命令。
    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
    1. 下载安装包：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的版本。
    2. 解压后，单击uniagentd.msi，指定安装路径为C:\uniagentd
    3. 修改C:\uniagentd\conf\uniagentd.conf文件，填入以下的配置 ：

      ak=xxxxxxxxxxxxxx sk=xxxxxxxxxxxxx

      master=https://aom-mgr-lb.xxxxxxxxxxx,https://xx.xx.xx.xx:xxxxx

      public_net=xxxx

    4. 管理员身份执行：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”。

    当前仅华北-北京四、华东-上海一区域菜单路径为：“采集设置 > UniAgent 安装与配置”；其他区域菜单路径为：“采集设置 > 虚机接入”。

  4. 在安装UniAgent页面中，单击“远程安装”，配置相关参数信息。（首次安装UniAgent时，默认进入“手动安装”页面，不能选择“远程安装”，必须有可用的安装机，才可进行远程安装。）

    图2 远程安装UniAgent
    表3 UniAgent安装参数说明表

    参数

    说明

    示例

    UniAgent版本

    UniAgent的版本，必选项。

    1.0.8

    接入方式

    接入方式有三种：直连接入（内网）、直连接入（公网）和代理接入。

    • 直连接入（内网）：华为云主机，使用直连接入（内网）的方式。
    • 直连接入（公网）：非华为云主机，使用直连接入（公网）的方式。
    • 代理接入：通过选择已配置代理机的代理区域，使用代理接入的方式远程安装UniAgent。
    说明：

    直接接入方式仅支持华北-北京四、华东-上海一、华东-上海二、华南-广州区域区分内网和公网。

    直连接入（内网）

    代理区域

    当接入方式选择代理接入时，需选择代理区域，或单击“新增代理区域”可新增代理区域。

    代理区域是对代理机的分类管理；代理机是指在华为云购买和配置一台华为云ECS弹性云服务器，为解决多云之间网络互通，且已经安装了UniAgent，并将其设置为安装机。

    -

    安装机

    安装机是远程安装方式下命令的执行机，必选项。

    如果没有配置安装机，按如下步骤进行配置：

    1. 单击对应的下拉框，选择“设置安装机”。
      图3 设置安装机
    2. 在弹出的对话框中，选择待配置为安装机的主机，并填写安装机名称。
    3. 完成后单击“确认”。

    -

    需安装UniAgent主机

    需安装UniAgent主机的详细信息，必选项。

    单击“添加主机信息”，填写如下信息：

    主机IP：主机的IP。

    操作系统：主机的操作系统，Linux和Windows。

    说明：

    当前通过远程安装方式安装UniAgent时，主机暂不支持Windows操作系统。

    登录账号：登录主机的账号。当操作系统为LINUX时，建议使用root账号，可保证有足够的读写权限。

    登录端口：访问主机的端口。

    认证方式：认证方式为密码。

    密码：登录主机的密码。

    连接测试结果：连接测试的结果，测试安装机和需安装主机间的网络连通性。

    操作：删除、复制和连接测试。

    说明：
    • 单击“添加主机信息”可添加多个主机，最多支持添加100个主机。
    • windows系统暂不支持连接测试。

    -

    安装ICAgent

    ICAgent为指标和日志采集插件。默认开启安装ICAgent按钮，可选项。输入AK和SK，安装ICAgent。

    -

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

Excel导入安装

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

  1. 在菜单栏选择“设置”，进入全局配置界面。
  2. 左侧导航栏中，选择“采集设置 > 虚机接入”，单击右上角“安装UniAgent”。

    当前仅华北-北京四、华东-上海一区域菜单路径为：“采集设置 > UniAgent 安装与配置”；其他区域菜单路径为：“采集设置 > 虚机接入”。

  3. 在安装UniAgent页面中，选择“Excel导入安装”，配置相关参数信息。（首次安装UniAgent时，默认进入“手动安装”页面，不能选择“Excel导入安装”。）

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

    参数

    说明

    示例

    UniAgent版本

    UniAgent的版本，必选项。

    1.1.0

    安装机

    安装机是Excel导入安装方式下命令的执行机，必选项。

    如果没有配置安装机，按如下步骤进行配置：

    1. 单击对应的下拉框，选择“设置安装机”。
      图5 设置安装机
    2. 在弹出的对话框中，选择待配置为安装机的主机，并填写安装机名称。
    3. 完成后单击“确认”。

    -

    Excel导入安装

    只能上传一个表格，最多5000条数据；仅支持.xls和.xlsx两种类型。

    说明：

    当前通过Excel导入方式安装UniAgent时，主机暂不支持Windows操作系统。

    -

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

UniAgent状态

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

表5 UniAgent状态

状态

说明

运行中

表示主机安装的UniAgent运行正常。

异常

表示主机安装的UniAgent功能异常，请联系技术支持。

安装中

表示该主机正在安装UniAgent。

说明：

安装UniAgent预计需要1分钟左右，请耐心等待。

安装失败

表示主机安装UniAgent失败，请重新安装。

未安装

表示主机未安装UniAgent。安装UniAgent，详细操作请参见安装UniAgent。

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

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

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

相关文档