Install Memory Analysis Server

This page describes how to optionally install a Memory Analysis Server if it is part of your deployment.

The AppMon Memory Analysis Server (formerly Analysis Server) is used solely for post-processing memory snapshots. The name of this component has been changed to accurately reflect its purpose and prevent confusion. It should not be confused with the AppMon Frontend Server, which serves other analysis data to the AppMon Client.

What to know before Memory Analysis Server installation

  • The Memory Analysis Server can be installed with all the other components through the full installation Windows .msi file, or separately with a custom installation on Windows or the dynatrace-analysisserver-<version><platform>.jar installers for the Memory Analysis Server on Linux and Unix. See the Deployment Guide for recommendations for the type of installation you should use.
  • One Memory Analysis Server can be shared by multiple AppMon Server instances. If the Servers are installed on different machines, a high-speed network connection between the Memory Analysis Server and AppMon Server is required.

The *NIX AppMon installer requires an Oracle / Sun or IBM JVM 1.6 or later on the target machine to run the installer process. On Linux (and Windows) AppMon components use a private JVM 1.7 at runtime.

The Linux Memory Analysis Server installation file is named dynatrace-analysisserver-<version>-linux-x86.jar, implying 32-bit on the x86 platform if you look at the other namings, but contains both bitnesses.

  • Because memory snapshot analysis can require a considerable amount of memory, it should be done using this component. The Memory Analysis Server is automatically used for post-processing if it is running. If you are not using a production installation and the Memory Analysis Server is not running, the snapshot is post-processed by the AppMon Server. For production installations, a Memory Analysis Server is mandatory.

The default configuration expects the Memory Analysis Server to run on the same machine as the AppMon Server. If another machine is used, you must configure the location in the Services pane of the AppMon Server Settings dialog box. If you do not post-process memory snapshots regularly, you can start the AppMon Memory Analysis Server on demand.

Memory Analysis Server installation directory

By default, the Memory Analysis Server installs into the dynaTrace <version> directory on Windows or dynatrace-<version> on Linux or Unix. This directory is referred to as DT_HOME. The following table shows the location of relevant files.

Relative path Description
DT_HOME The executables and the main configuration file dtanalysisserver.ini.
DT_HOME\log\analysisserver Log files.

Install the Memory Analysis Server

The amount of memory required for post-processing leak analysis memory snapshots mainly depends on the number of objects on the heap. For fully cached post-processing, required memory equals the heap size of the application for which the snapshot was taken. Although post-processing with less memory is possible, running with less than full-cache memory is not recommended.

If the Memory Analysis Server is not already installed, download the full installation package and run a custom installation.

The default location is %ProgramFiles%\dynatrace\dynaTrace <version>. The installer creates Windows Start menu entries and registers a Windows service for the Memory Analysis Server process.

Configure memory

Before starting the AppMon Memory Analysis Server, adjust the memory settings in the main configuration file dtanalysisserver.ini. Set the option -Xmx to the maximum heap size of applications + 25% to analyze.

The following is an example of the code to add to dtanalysisserver.ini.


The -XX:+UseCompressedOops automatically appends when you use the 64-bit installer.

Set up Memory Analysis Server communication

The Memory Analysis Server listens on a specified port for incoming connections from the AppMon Server. To change the default port number, add -Dcom.dynatrace.diagnostics.listen=[<ip>]:<port> to the dtanalysisserver.ini file.

Automatic installation

You can automate the installation with Ansible, Chef, or Puppet. Click the link below for more detailed information.

Parallel startup of Server and Analysis Server

If you have the AppMon Server and Memory Analysis Server installed on the same machine (sharing the same core executables), it is not possible to start both servers at the same time, for example using a Linux shell script.

In this case, there are these possible solutions:

  • Install the Memory Analysis Server standalone on the machine.
  • In your shell script, first start the Memory Analysis Server, wait a short time (10 seconds usually suffices), and then start the AppMon Server.