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 supported 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.
      • Specify Java Virtual Machine (JVM) arguments in JVM Args. See JVM Arguments.
      • 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.

JVM Arguments (Optional) 

You can specify JVM arguments by using one of the following ways. However, JVM arguments specified via UI supersedes arguments specified in the Text File.

When you install multiple Database Agents, JVM arguments apply to all the agents.

When you restart the Database Agent:

  • If the JVM arguments were specified both via UI and the dbagent-jvm-args.txt  file, then the arguments specified via UI are retained and the text file is ignored.
  • If the JVM arguments were specified only in the dbagent-jvm-args.txt  file, then the text file arguments are retained.

When you rollback the Database Agent, JVM arguments specified in the rolled-back version are retained.

UI 

Specify the JVM arguments in JVM Args. Each argument must be separated by a space.

Text File 

JVM arguments specified via UI will supersede arguments specified in the text file.

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.

Custom Configuration (Optional)

You can add additional custom configurations under Additional Configuration > Custom Configuration to apply those for the Database Agent installation. Specify each custom configuration as a key-value pair in a new line.

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.
  • Once a flag is enabled, you cannot disable it.