How Do I Install the Agent (in 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?

Linux OS

Before installing the agent, prepare a password.

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). If you are auditing an RDS database, install the agent on the application server if host access to RDS instances is not available.
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

   

   

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

   • The agent is run by common DBSS users. When installing the agent for the first time, a DBSS user will be created. After running the sh install.sh command, you can use the prepared password set up 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!

   

   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.