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

Managing Agents

You can uninstall an agent from the database or application if you do not need to audit the database.

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

Installing Node Type

  • 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

NIC name of an installing node

CPU Threshold (%)

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

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.

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

Running status of 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.

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.

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.

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 the agent has been uninstalled.

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

FAQ

Parent Topic: Managing the Audit System