You can install the Database Agent on a machine by using the UI only if Smart Agent is installed on the same machine.

  • The high availability of Database Agent is not supported through agent management. 
  • You cannot run Database Agent as a service.

Perform the following to install the Database Agent:

  1. Click Home > Agent Management > Manage Agents.
  2. Click Install Agent in the right pane.
  3. Select Database, and then click Next.
  4. Select one of the following to specify the location for deploying the agent, then click Next.
    • Select from List: You can select the host on which Smart Agent is installed from the list, then click the left arrow to list it under selected table. You can select multiple hosts.
    • Import from CSV file: You can upload a CSV file with required columns such as HostName, SmartAgentID, and Installation Directory.
  5. Select Custom Prefix if you want a prefix to be added to the agent name, else proceed with specifying the application details.
  6. Configure the agent attributes on the Set Agent Attributes page, then click Install.
    1. You can select the download source. The source can be the Splunk AppDynamics download portal (Using Splunk AppDynamics Portal), your local directory (Using Local Directory), or your custom HTTP server (Custom HTTP URL).
      If you select Custom HTTP URL and if your HTTP server requires authentication, configure smart agent to use basic authentication. See Configure Authentication for Custom Artifact Location.
    2. You can select Additional Configuration to add more configuration details. Use the Database Agent custom configurations to specify in Custom Configuration. See Custom Configuration. 

  7. Check the install status in Tasks in Progress.
    You can search for the specific host and check the log file. After the task is completed, the task is added to the History tab.

    The log file is generated after the task is complete.

Custom Configuration (Optional)

You can add additional custom configurations under Additional Configuration > Custom Configuration to apply those for the Database Agent installation.

For example, you can enable the following Database Agent flags:

  • dbagent.telemetry.enabled
  • dbagent.event.trigger.enabled

Do not specify the dbagent.name flag. This flag gets ignored if you specify it.

JVM Arguments (Optional)

You can add Java Virtual Machine (JVM) arguments when you install the Database Agent through Agent Management. Perform the following steps after the Database Agent is installed:

  1. Open the db-agent package and locate the dbagent-jvm-args.txt file.
  2. Specify the JVM parameters in the dbagent-jvm-args.txt file.
  3. Restart the Database Agent by using the Restart button on Home > Agent Management > Manage Agents >Agents > Database Agents.