安装Agent

Agent程序的安装位置

Agent安装方式说明

在执行安装Agent操作前，请根据实际情况选择合适的安装方式。

Agent安装的注意事项

• Linux系统必须以root用户安装Agent。Windows系统必须以最高管理员身份安装Agent。

• 在Windows系统安装Agent前，需要检查Agent所在服务器是否有安全防护软件在运行。如果有，需要先卸载掉。

• 对于在Windows系统中的自建数据库，如果本地是127.0.0.1环口的流量，Agent流量转发工具需要安装npcap。

  如果已安装Agent，需要先卸载Agent和已安装的winpcap，然后先安装npcap再安装Agent，完成替换。

通过云助手安装

通过云助手可以一键在云服务器ECS上安装Agent。如果您需要安装Agent的ECS已经安装了云助手，并且该ECS和数据库审计实例在同一专有网络中，推荐您使用该安装方式。以下介绍通过云助手安装Agent的具体操作。

1. 登录数据库审计系统。具体操作，请参见登录数据库审计系统。

2. 在左侧导航栏，选择系统管理 > Agent管理。

3. 在Agent管理页面，单击Agent安装页签。

4. 在通过云助手安装区域，单击开始安装。

5. 在通过云助手安装Agent到目录对话框中，选中需要安装Agent的ECS实例并单击实例列表上方的安装。

   您也可以单击指定ECS实例操作列下的安装，只为该ECS实例安装Agent。

   安装成功后，对应ECS实例Agent状态将变更为运行中，已连接。

手动安装Agent

您可以通过下载Agent安装包手动安装的方式，在任一需要安装Agent的服务器上安装Agent。以下步骤介绍在Linux、Windows和AIX服务器中如何手动安装Agent。

1. 登录数据库审计系统。具体操作请参见登录数据库审计系统。

2. 在左侧导航栏，选择系统管理 > Agent管理。

3. 在Agent管理页面，单击Agent安装页签。

4. 在手动安装Agent区域，根据您的操作系统选择相应版本的Agent安装包并手动安装Agent。

   Linux系统

   1. 在Linux系统区域，根据您服务器架构的单击X86-64位或ARM-64位。

   2. 等待Agent安装包打包成功后，在下载对话框中，单击下载。

      下载完成后，Agent安装包文件将保存在您浏览器默认的下载路径中。

   3. 登录您的Linux服务器。

   4. 将已下载的Agent安装包上传到Linux服务器的指定目录下。

      您可以自定义Agent安装包在Linux服务器上的存放目录。

   5. 进入Agent安装包所在目录，执行以下命令，解压Agent安装包。

      • X86架构的服务器

        tar -zxvf dbagent_linux_V2.30.tar.gz

      • ARM架构的服务器

        tar -zxvf dbagent_arm_V2.30.tar.gz

      重要

      每次更换运行或解压目录时，需要重新运行安装脚本。

   6. 执行以下命令，安装并启用Agent。

      cd dbagent2.30
      sh install.sh

      重要

      • 禁止直接运行二进制文件。

      • 必须以root账号运行Agent安装脚本，且指定解释器为bash（或不指定解释器）。

   Windows系统

   1. 在Windows区域，单击64位。

   2. 等待Agent安装包打包成功后，在下载对话框中，单击下载。

      下载完成后，Agent安装包文件将保存在您浏览器默认的下载路径中。

   3. 登录您的Windows服务器。

   4. 将已下载的Agent安装包上传到Windows服务器中。

   5. 将Agent安装包解压缩到指定的运行目录。

      重要

      • 解压目录中不能出现特殊字符，具体包括：<space>、()、[]、{}、^、=、;、!、'、+、,、`、~、&。如果一定要在含特殊字符的目录中运行脚本，请以管理员权限进入DOS命令行运行脚本。

      • 每次更换运行或解压目录时，需要重新运行安装脚本。

   6. 进入解压后的Agent安装目录，单击dbAgent-setup.exe应用程序，并右键选择以管理员身份运行。

   7. 在安装向导对话框，单击下一步。

   8. 选中Install npcap，单击下一步。

      

   9. 根据安装向导完成安装。

   AIX系统

   1. 在AIX系统区域，根据AIX服务器操作系统版本单击对应的版本。

      支持的版本包括：5.3、6.1、7.1。

   2. 等待Agent安装包打包成功后，在下载对话框中，单击下载。

      下载完成后，Agent安装包文件将保存在您浏览器默认的下载路径中。

   3. 登录您的AIX服务器。

   4. 将已下载的Agent安装包上传到AIX服务器的指定目录下。

      您可以自定义Agent安装包在AIX服务器上的存放目录。

   5. 进入Agent安装包所在目录，执行以下命令。

      gunzip dbagent_aix5.3_V2.257.tar.gz
      tar -xvf dbagent_aix5.3_V2.257.tar

   6. 进入解压后的安装目录，执行以下命令，即可安装Agent程序t。

      ./install.sh

   Agent安装完成后，会自动启用。

   安装过程中遇到问题时，建议您尝试以下方法：等待一段时间后重新安装、卸载Agent并重新安装、重新启动电脑。如果问题仍未解决，请加入钉群（钉群号：44518739），联系产品技术专家进行咨询。

5. Agent安装成功后，在Agent管理页面，查看Agent连接状态。

   Agent的状态为正常运行，表示Agent已成功安装并且运行正常。

启用、停用或卸载Agent

常见问题

安装Agent相关的常见问题，请参见：

• ECS通过云助手安装的Agent，Agent安装目录是什么？

• ECS通过云助手安装的Agent，Agent的日志目录是什么？

• 安装Agent时，系统提示丢失wpcap.dll，该怎么办？

• 是否支持在Docker运行的环境中安装Agent？

• 如何卸载Agent程序？