How to Deploy the Database Agent via Smart Agent (Using OpenJDK 17)
Step-by-Step Guide:
1. Download the Smart Agent
Go to AppDynamics Downloads.
Download the Smart Agent ZIP file.
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.
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.
Install or attach the DB Agent using the UI on the same machine where the Smart Agent is running.
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 ).
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
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.
... View more