Help Center/ Database Security Service/ FAQs/ Agent/ How Do I Install the Agent (in Windows OS)?
Updated on 2026-08-04 GMT+08:00

How Do I Install the Agent (in Windows OS)?

After you add a security group rule, download and install the agent on a database or application, depending on the add mode you chose. Database audit can be enabled only if the audited object is connected to the database audit instance.

To install the agent on a Windows OS, perform the following operations.

Prerequisites

  • You have added an agent to your database.
  • You have obtained the agent installation package for the Windows OS.
  • The Windows OS version of the target node is supported by the agent.

Windows OS

  1. Install Npcap on Windows OS.

    • If Npcap has been installed on the Windows OS, go to 3.
    • If Npcap has not been installed on the Windows OS, perform the following steps:
      1. Download Npcap to obtain the latest installation package.
        Figure 1 Downloading Npcap
      2. Upload the npcap-xxxx.exe software installation package to the VM where the agent is to be installed.
      3. Double-click the Npcap installation package.
      4. In the displayed dialog box, click I Agree, as shown in Figure 2.
        Figure 2 Agreeing to install Npcap
      5. In the displayed dialog box, leave all the check boxes unselected and click Install, as shown in Figure 3.
        Figure 3 Installing Npcap
      6. In the displayed dialog box, click Next.

      7. Click Finish.

  2. Obtain the Agent installation package for Windows by referring to Downloading an Agent.
  3. Log in to the node as the Administrator user and copy the downloaded agent installation package xxx.zip to any directory on the host.

    Figure 4 Agent installation package

  4. Decompress the package.
  5. Double-click the install.bat file in the package directory.

    Figure 5 Double-clicking install.bat

  6. Press any key to complete installation after the output shown in Figure 6 is displayed.

    Figure 6 Installation completed

  7. Check the installation result. If the dbss_audit_agent process can be found in the Windows Task Manager, the installation succeeded, as shown in Figure 7.

    Figure 7 Checking the dbss_audit_agent process

    If it is not found, the installation failed. Install the agent again.