AppDynamics Knowledge Base

How to Deploy Database Agent Via Smart Agent with the **Latest OpenJDK Version**

How to Deploy Database Agent Via Smart Agent with the **Latest OpenJDK Version**

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.

image.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.

image.png

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

image.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).

image.png

image.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

image.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.

Labels (2)
Version history
Last update:
‎02-18-2025 10:43 AM
Updated by: