cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Rachana.Agarwal
AppDynamics Team

How to Deploy the Database Agent via Smart Agent (Using OpenJDK 17)

Step-by-Step Guide:

1. Download the Smart Agent

2. Extract & Install the Smart Agent

  • Unzip the downloaded file into C:\appdynamics\appdsmartagent (or your preferred directory).
  • Open an Administrator command prompt and run:
    appdsmartagent-service.bat​
  • This creates and starts the AppDynamics SmartAgent service on Windows.

3. Confirm the Service is Running

  • Open services.msc and verify the AppDynamics SmartAgent service is running.

4. Configure the Smart Agent

  • In C:\appdynamics\appdsmartagent, edit the config.ini file with your Controller details, such as:
    ControllerURL = https://ces-controller.saas.appdynamics.com
    FMServicePort = 443
    AgentType = <agent_type>
    AccountAccessKey = <your_access_key>
    AccountName = <your_account_name>
    EnableSSL = true​

5. Restart the Smart Agent service for changes to take effect.  

6. Validate Smart Agent in the Controller

  • In the Controller UI, go to Agents → Manage Agents → Smart Agents and look for your host name.
  • Once it appears, you can install a Database Agent on the same machine directly from the UI.

RachanaAgarwal_0-1739901530287.png

7. Attach a Database Agent to the Smart Agent

  • If the Database Agent isn’t associated with a Smart Agent, you won’t see a Smart Agent ID in the UI.

RachanaAgarwal_1-1739901557047.png

  • Install or attach the DB Agent using the UI on the same machine where the Smart Agent is running.

RachanaAgarwal_3-1739901631552.png

8. Using the Latest OpenJDK (Example: JDK 17)

  • If you need OpenJDK 17 on your Linux machine, for example, run as below:
    sudo apt update
    sudo apt install -y openjdk-17-jdk​

The Database Agent works fine with JDK 17 (tested on local machine IP address ip-172-31-9-203).

RachanaAgarwal_2-1739901580514.png

RachanaAgarwal_4-1739901687387.png

9. Upgrade or Downgrade the Database Agent

  • If your Database Agent is attached to a Smart Agent, you can easily upgrade or downgrade it from the Controller UI.

10.  Successfully Created MySQL Collector with the latest JDK 17 and Latest Database Agent version 25.1.0

RachanaAgarwal_5-1739901719579.png

Troubleshooting & Tips

  • Smart Agent Not Found?
    Ensure the Smart Agent is installed and running before installing a Database Agent via the UI.

  • Verifying Smart Agent ID
    Check Agent Management → Smart Agents in the Controller to see if the ID is displayed. If it’s missing, the Database Agent won’t be able to attach it.

  • JDK Compatibility
    If you’re running on Windows, Linux, or another OS, ensure you have OpenJDK 17 (or your desired version) installed. The Database Agent is compatible with modern JDK versions but always verify in AppDynamics’ compatibility matrix.

 

Version history
Last update:
‎02-18-2025 10:43 AM
Updated by:
Ask the Experts Session: Hybrid Application Monitoring Deployment

Join us on Feb 26 to explore Splunk AppDynamics deployment strategies, SaaS models, agent rollout plans, and expert best practices.


Register Now

Observe and Explore
Dive into our Community Blog for the Latest Insights and Updates!


Read the blog here