Install the agent

Installation location

Installation methods

Prerequisites

• You have purchased a Database Audit D100 instance. For more information, see Purchase a Database Audit instance (New Purchases Stopped).

• You have completed the VPC configuration for the D100 instance. For more information, see Log on to the Database Audit system.

  When you configure the VPC, you must specify the VPC and vSwitch where the ECS instance on which you want to install an agent is deployed.

Install using Cloud Assistant (Recommended)

1. Log on to the Database Audit. For more information, see Log on to the Database Audit.

2. In the left-side navigation pane, choose System configuration > agent management, and then click the Agent installation tab.

3. In the Install by using Cloud Assistant section, click Start installation.

4. In the Install agent by using Cloud Assistant dialog box, find the ECS instance where you want to install the agent and click Install in the Actions column.

   To install the agent on multiple instances, select them and click Batch installation below the ECS instance list.

   After the installation is complete, the agent status changes to Connected, running.

5. If your ECS instance runs a Linux operating system and both the application and database are deployed on that instance, follow these steps:

   1. In the left-side navigation pane, choose System configuration > agent management.

   2. On the Agent connection management tab, find the target server and click Configure in the Actions column.

   3. In the Configure panel, set local loopback capture to Yes and click Save.

Manual agent installation

On a Linux server

1. Log on to Database Audit. For more information, see Log on to Database Audit.

2. In the navigation pane, go to System Configuration > Agent Management and click the Agent Installation tab.

3. In the Download Agent for Manual Installation section, click Linux Version.

   After the download is complete, the agent installation package is saved to your browser's default download directory.

4. Log on to your Linux server as the root user.

5. Upload the downloaded agent installation package to a directory on the Linux server. Run the following command to decompress the package.

   tar -zxvf rmagent-530**.tar.gz  #Replace rmagent-530**.tar.gz with the actual package filename.

6. Modify the server_host parameter in the rmagent.ini configuration file:

   1. Log on to the Database Audit console. In the navigation pane, click D100 instance, and then select the instance's region from the top menu bar.

   2. In the D100 instance section, click Configure.

   3. In the Configuration (VPC) pane, copy the Domain Name.

   4. Return to the server where the Agent is installed, run the vi rmagent.ini command, press i, and change the value of server_host to the domain name that you copied in Step 6.c.

   5. If your application and database are deployed on the same server, change the value of loopback to 1.

   6. Press Esc, and then enter :wq to save the file and exit.

   7. Run the ./install.sh command to install and enable the agent.

7. Authorize the agent.

   1. Return to the Database Audit system. On the System Management > Agent Management > Agent Installation tab, in the Download Agent for Manual Installation area, click Authorization Token to download the authorization token file.

      The authorization token file is used to verify the identity of an agent that attempts to connect to Database Audit. Only agents that pass this verification can connect.

      Important

      The authorization token is valid for one hour and is refreshed at the top of each hour. To prevent verification failure, use the token within its one-hour validity period and avoid downloading it near the top of the hour.

      After the download is complete, the authorization token file is saved to your browser's default download directory.

   2. Upload the authorization token file to the agent installation directory and run the ./start_rmagent.sh command to start the agent.

8. In Database Audit, on the System Management > Agent Management page, view the agent's connection status.

   If the agent status is Normal, the installation is successful.

On a Windows server

1. Log on to Database Audit. For more information, see Log on to Database Audit.

2. In the navigation pane, go to System Configuration > Agent Management and click the Agent Installation tab.

3. In the Download Agent for Manual Installation section, click Windows Version.

   After the download is complete, the agent installation package is saved to your browser's default download directory.

4. Upload the agent installation package to the server and decompress it.

5. Modify the rmagent.ini file:

   1. Log on to the Database Audit console. In the navigation pane, click D100 instance, and then select the instance's region from the top menu bar.

   2. In the D100 instance section, click Configure.

   3. In the Configuration (VPC) pane, copy the Domain Name.

   4. Return to the server where you need to install the Agent, open the rmagent.ini file, change the value of the server_host parameter to the domain name copied in step 5.c, and save the file.

6. In the decompressed agent installation package, double-click the Rmagent_Setup.exe file and follow the installation wizard. Select components based on your scenario:

   • The application and database are on different servers

     Keep the default selection: WinPcap Silence. Accept the defaults for the remaining options to complete the installation.

   • The application and database are on the same server

     Select the npcap component. In the Installation Options dialog box, select Install Npcap in WinPcap API-compatible Mode. Accept the defaults for the remaining options to complete the installation.

7. Authorize the agent.

   1. In Database Audit, go to the Agent Management page. On the Agent Installation tab, in the Download Agent for Manual Installation section, click Authorization Token to download the authorization token file.

      After the download is complete, the authorization token file is saved to your browser's default download directory.

   2. Copy the downloaded authorization token file to the agent installation directory.

8. Press Win+R. In the Run dialog box, enter services.msc and click OK. Check that the Rmagent Service status is Running.

   • If the service status is Running, the Rmagent Service is installed and running correctly.

   • If the service status is not Running, start the service manually.

9. In Database Audit, on the System Management > Agent Management page, view the agent's connection status.

   If the agent status is Normal, the installation is successful.

Uninstall the agent

Uninstall an agent installed using Cloud Assistant

On the Agent Management page, on the Install Agent tab, in the Install by Using Cloud Assistant section, click Start Installation. In the Install Agent by Using Cloud Assistant dialog box, find the instance and click Uninstall in the Actions column.

Uninstall a manually installed agent

• Linux server

  1. Log on to the Linux server as the root user.

  2. Navigate to the agent installation directory.

  3. Run ./stop_rmagent.sh to stop the agent service and delete all files in the agent installation directory.

• Windows server

  Press Win+R. In the Run dialog box, enter appwiz.cpl and click OK. In the Uninstall or change a program dialog box, find and uninstall the rmagent program and the WinPcap or Npcap program.