---
title: Agent管理
description: "Web服务器（即安装鲲鹏DevKit的服务器）默认已安装，如果待分析的服务器与安装工具的服务器是同一个，请跳过该章节。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevkithistory/devkit_24_rc1/Plugins_UserGuide/devkit-hypertuner-011.html
sourcePath: /source/zh/kunpengdevkithistory/devkit_24_rc1/Plugins_UserGuide/devkit-hypertuner-011.html
indexId: f4d5623ceabab92cdc79a6fd470f71175d2af194386030fda0d9a95474575f0190
---
# Agent管理

Web服务器（即安装鲲鹏DevKit的服务器）默认已安装，如果待分析的服务器与安装工具的服务器是同一个，请跳过该章节。

- 最多可添加101个节点，包括在Web服务器上默认安装的根节点。
- 以端口映射模式创建的Docker容器不能作为Agent添加，以Host模式创建的Docker容器作为Agent添加。
- 安装鲲鹏DevKit的节点和Agent之间的网络需联通，否则会导致Agent添加失败。
- 普通用户可添加、修改、删除和查询节点；不同用户创建的节点，其他用户可进行修改、删除和查询操作。
- 如果节点添加失败，可在Web服务器上查看“/opt/DevKit/logs/agent_logs/”目录下以IP地址命名的日志文件，出现如下提示信息表示需要在节点服务器上手动  关闭SELinux
。

```
"The SELinux enforcing mode is enabled on the server, which will cause a tool installation failure".
```


#### 操作步骤

1. 在页面右上方选择“ > 通用设置 > Agent管理”，进入Agent管理界面。
2. 单击“添加节点”。
  以root用户登录为例，如图1所示，参数描述如表1所示。

  若使用普通用户添加或删除节点时，需将普通用户添加至wheel组（命令：usermod -G wheel userName）。

  图1 添加节点

**表1 添加节点参数说明**

| 参数 | 说明 |
| --- | --- |
| 节点名称（可选） | 输入节点名称。默认为Node1，依次递增。名称需要满足如下要求： 只能由字母、数字、特殊字符（@\#$%^&\*()[]<>.\_\-!~+空格）组成。 长度为1~32个字符。 |
| 安装路径（可选） | 输入安装节点的绝对路径，默认为“/opt”。 说明： 输入的路径不能为“/home”，并且： 如果输入的路径属于root用户组，普通用户对各级路径应有可读（r）可执行（x）权限。 如果输入的路径属于devkitwork1用户组，devkitwork1用户对各级路径应有可读（r）可执行（x）权限。 |
| SSH传输须知 | 证书管理使用服务器默认的SSH传输通道，为了保护数据的安全完整，建议使用安全的SSH服务，如使用安全的SSH版本，配置使用安全的加密算法等。 |
| 服务器选择 | 可选“已有服务器”和“新增服务器”。 说明： 当前仅使用鲲鹏DevKit插件时可选。 |
| 节点IP | 输入待安装节点的服务器IP地址。 |
| 端口 | 输入节点服务器SSH端口，默认为“22”。取值范围1~65535。 |
| 用户名 | 输入登录节点服务器的用户名，默认为“root”。 说明： 为保证SSH通道安全，建议您使用普通用户进行节点的安装部署。 |
| 认证方式 | 选择认证方式。可选择： 密码认证 密钥 认证 说明： 选择“密钥认证”时需要在安装系统性能分析工具的服务器上设置SSH认证信息。详情请参见设置节点服务器SSH认证信息。 |
| 密码 | 输入登录节点服务器的用户密码。认证方式选择“密码认证”时需配置。 说明： 使用root用户安装的节点需要输入root口令，使用普通用户安装的节点需要输入用户口令和root口令。 仅插件端可使用记住密码功能。 |
| 私钥 文件 | 输入用于登录节点服务器的SSH私钥文件的绝对路径，例如：“/home/devkit/id\_rsa” 认证方式选择“密钥认证”时显示该参数。 |
| 密码短语（可选） | 输入登录节点服务器的SSH私钥文件的口令。如果未配置SSH私钥口令可省略该参数。 认证方式选择“密钥认证”时显示该参数。 |


3. 根据表1配置节点参数后，单击“确认”完成节点的添加。已添加的节点支持如下操作：

  - 修改：修改节点名称。
  - 查看安装日志：查看系统缺少的组件及对应处理意见，日志内容支持拷贝和下载。
    仅添加多节点的环境可以查看安装日志。

  - 删除：删除节点。
    Web服务器上默认安装的节点不可删除。 删除节点后新建的分析任务将不再分析此节点，但仍可查看此节点历史分析报告。 使用root用户安装的节点，在删除时需要输入root用户口令。使用普通用户安装的节点，在删除时需要输入用户口令和root用户口令。

  - 运行目录/日志目录容量监测：显示节点磁盘空间容量的告警和恢复信息。
    当“磁盘空间剩余容量”小于“最大使用空间”的10%，或者“工具使用空间”达到90%，或者Sever端磁盘剩余空间小于5G时，后台会停止正在该节点上运行的任务。如果任务不包含该节点，或任务包含了该节点但任务已处于分析期间，不停止该任务。新建的任务如果包括该节点则创建失败。 当“磁盘空间剩余容量”小于“最大使用空间”的20%，或者“工具使用空间”达到“最大使用空间”的80%，将产生告警。 当“磁盘空间剩余容量”恢复到大于“最大使用空间”的25%，并且“工具使用空间”小于“最大使用空间”的75%，告警将恢复，界面显示告警恢复。

4. 节点的批量导入。
  单击“批量导入”按钮，再单击模板表格进行模板下载。

  图2 批量导入节点

  图3 模板表格

  按照模板表格填写完成需要批量导入的节点信息，在图2中上传表格进行节点添加。

  请严格按照模板表格进行填写后再上传，不可上传空表格、错误表格、不规范表格。

5. 节点的批量删除。
  单击“批量删除”按钮，选择需要删除节点或单击“模板文件删除”进行模板下载。

  图4 批量删除节点

  图5 模板表格

  按照模板表格填写完成需要删除的节点后，在图4界面上传表格进行删除。