Installing an Agent (Linux OS)

Prerequisites

• You have purchased a database audit instance and the Status is Running.
• You have added an agent to your database.
• You have obtained the agent installation package for the Linux OS.
• The Linux OS version of the target node is supported by the agent. For details about the supported Linux versions, see On What Linux OSs Can I Install the Agent?

Scenarios

You can install the agent on the database or application side, depending on your database type and deployment scenario. Common database scenarios are as follows:

• Deploy DBSS for databases built on ECS/BMS. For details, see Figure 1 and Figure 2.
  Figure 1 One application connecting to multiple databases built on ECS/BMS
  
  Figure 2 Multiple applications connecting to one database built on ECS/BMS
  
• Deploy DBSS for RDS databases. For details, see Figure 3 and Figure 4.
  Figure 3 One application connecting to multiple RDS databases
  
  Figure 4 Multiple applications connecting to one RDS database
  

Table 1 describes where to install the agent in the preceding scenarios.

NOTICE:

If your applications and databases (databases built on ECS/BMS) are deployed on the same node, install the agent on the database side.

Installing an Agent

NOTE:

When installing a new agent, you need to customize a password for it.

Install the agent on the node suitable for your service scenario.

1. Upload the downloaded agent installation package xxx.tar.gz to the node (for example, using WinSCP).
2. Log in to the node as user root using SSH through a cross-platform remote access tool (for example, PuTTY).
3. Run the following command to access the directory where the agent installation package xxx.tar.gz is stored:

   cd Directory_containing_agent_installation_package

   

4. Run the following command to decompress the installation package xxx.tar.gz:

   tar -xvf xxx.tar.gz

   

5. Run the following command to switch to the directory containing the decompressed files:

   cd Decompressed_package_directory

   

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

   ll

   • If you do, go to 7.
   • If you do not, perform the following operations:
     1. Run the following command to get the script execution permission:

        chmod +x install.sh

     2. Verify you have the required permissions.

7. Run the following command to install the agent:

   sh install.sh

   

   NOTE:

   • In Ubantu, run the bash install.sh command to install the agent.

   • The agent program is run by common DBSS users. When installing the agent for the first time, you need to create an agent user. After running the sh install.sh command, you need to set a password for the DBSS user.
   If the following information is displayed, the agent has been installed. Otherwise, the installation fails.

   1 2 3 4 5

   start agent starting audit agent audit agent started start success install dbss audit agent done!

   NOTICE:

   If the agent installation failed, ensure the OS version of the target node is supported and try again.

8. Run the following command to view the running status of the agent program:

   service audit_agent status

   If the following information is displayed, the agent is running properly:

   

   audit agent is running.

Helpful Links

• If SSL is enabled for a database, the database cannot be audited. To use database audit, disable SSL first. For details, see How Do I Disable SSL for a Database?

• For details about how to add an agent, see Step 2: Add an Agent.
• For details about how to uninstall an agent, see Uninstalling an Agent.