Help Center/ Database Security Service/ User Guide/ Database Audit/ Managing the Audit System/ Managing Agents
Updated on 2026-09-24 GMT+08:00
View PDF
Share

Managing Agents

After installing an agent on a database or application node, you can view the agent information and enable, disable, or delete the agent. If you no longer need to audit a database, you can uninstall the agent from the node where the agent is installed.

Prerequisites

You have installed the agent on a node. For details, see Downloading and Installing the agent.

Managing Agents

  1. Log in to the DBSS console.
  2. Click in the upper left corner on the displayed page and select a region.
  3. In the navigation tree on the left, choose Databases.
  4. In the Instance drop-down list, select an instance.

Viewing an Agent

Click View Agent in the Agent column of a database. The agent details are displayed in the lower part of the page. For details, see Table 1.
Table 1 Parameters of an agent

Parameter

Description

Agent ID

Agent ID, which is automatically generated

Installing Node Type

Type of the node to be installed. The options are as follows:

  • Database
  • Application

Installing node IP address

IP address of the node where an agent is installed

OS

Agent OS

  • LINUX64_X86
  • LINUX64_ARM
  • WINDOWS64

Audited NIC Name

Name of the NIC to be audited on the node where an agent is installed.

Enter a maximum of 64 characters. Only letters, digits, hyphens (-), spaces, periods (.), and colons (:) are allowed. The value cannot start or end with a space.

CPU Threshold (%)

CPU threshold of the installing node. The default value is 80.

Enter a value from 0 to 100.

NOTE:

The agent on a node will stop working if the CPU usage of the node exceeds this threshold. You can scale up CPU resources to avoid this problem.

Memory Threshold (%)

Memory threshold of the installing node. The default value is 80.

Enter a value from 0 to 100.

NOTE:

The agent on a node will stop working if the memory usage of the node exceeds this threshold. You can scale up memory resources to avoid this problem.

General

Whether an agent is a general-purpose agent.

  • Yes
  • No

Status

Status of the agent on the installing node.

  • Hibernating
  • Running

SHA256Sum

Verification value of the agent installation package.

Operation

Operations that can be performed on an agent you added.

  • Download Agent: After an agent is added, download its package and install it on the database or application based on the agent adding method you selected. For details, see Downloading an Agent.
  • Enable: Enable the agent. For details, see Enabling an Agent.
  • Disable: Disable the agent. For details, see Disabling an Agent.
  • Delete: Delete the agent. For details, see Deleting an Agent.

Enabling an Agent

Enabling the agent automatically starts security audit for its connected database.

  1. In the Operation of an agent, click Enable.

    If no Enable button is displayed in the Operation column, the agent has been enabled.

Disabling an Agent

Disabling the agent automatically stops security audit for its connected database.

  1. In the Operation column of an agent, click Disable.
  2. In the displayed dialog box, click OK.

    If no Disable button is displayed in the Operation column, the agent has been disabled.

Deleting an Agent

If you delete an agent, you will need to deploy a new one only if you want to resume auditing the database.

  1. In the Operation column of an agent, click Delete.
  2. In the displayed dialog box, enter DELETE and click OK.

    If the target agent is no longer displayed in the agent list, it has been deleted.

Uninstalling an Agent

This topic describes how to uninstall the agent on a node running a Linux OS and Windows OS.

  1. Log in to the node where the agent is installed as user root using SSH through a cross-platform remote access tool (such as PuTTY).
  2. Run the following command to access the directory where the decompressed xxx.tar.gz agent installation package is stored: 

    cd Directory_containing_decompressed_agent_installation_package

  3. Run the following command to check whether you have the permission for executing the uninstall.sh script: 

    ll
    • If you do, go to 4.
    • If you do not, perform the following operations:
      1. Run the following command to get the script execution permission: 
        chmod +x uninstall.sh
      2. Verify you have the required permissions.

  4. Run the following command to uninstall the agent: 

    sh uninstall.sh

    If the following information is displayed, the agent has been uninstalled successfully:

    1
2
3
4
5
6
7
    		 
    uninstall audit agent...
exist os-release file
stopping audit agent
audit agent stopped
stop audit_agent success
service audit_agent does not support chkconfig
uninstall audit agent completed!

  1. Enter the directory where the agent installation file is stored.
  2. Double-click the uninstall.bat file to uninstall the agent.
  3. Verify that the agent has been uninstalled.

    1. Open the Task Manager and verify that the dbss_audit_agent process is stopped.
    2. Verify that the entire agent installation directory has been deleted.

References

Parent Topic: Managing the Audit System