Set up a Memory Analysis Server

This page describes how to set up a Memory Analysis server.

Overview

The AppMon Memory Analysis Server is used solely for post-processing memory snapshots. It should not be confused with the AppMon Frontend Server, which serves other analysis data to the AppMon Client.

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.

...
-Xmx2048M
-Xms128M
-XX:MaxPermSize=128M
-XX:PermSize=128M
...

The -XX:+UseCompressedOops option is automatically appended when you use the 64-bit installer.

Configure the port

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.

Start and stop the Memory Analysis Server

Windows service

On Windows, you can start the Memory Analysis Server service from the Start menu, the command line, or the Services control panel. The registered service name is *Dynatrace Memory Analysis Server* <version>. The service runs with restricted permissions as Local Service.

Note

If you change any output directories (such as the session directory), make sure the AppMon Server service has sufficient privileges in the new directory.

To start the Memory Analysis Server from the command line, change to the DT_HOME and execute:

dtanalysisserver.exe -service start

To list all the available options, execute dtanalysisserver.exe -?, which displays the following:

Dynatrace Memory Analysis Server
Version: 7.0.0.2469 - built 2017-05-30 13:45:26 +0200
Copyright (C) 2004-2017, Dynatrace

Usage: dtanalysisserver [options]

Available options:
   -?, -h, --help Print this help message
   -v             Display version information
   -loglevel [0..8]
                  Set loglevel, valid values are: [0..8] or
                  [finest|finer|fine|config|info|warning|severe|debug|none]
                  Default setting: 4 (info)
   -listen [<ip>:]<port>
                  Listen for dynaTrace Server instances on [<ip>:]<port>
   -service [install | uninstall | start | stop | list(all)]
                  Install/uninstall Windows Service
                  (uninstall might require you to log off)
   -basedir <dir> Set working directory for application
   -logdir <dir>  Override default log directory (command line argument only)
   -ini <config>  ini file to use, default is dtanalysisserver.ini
                  A value of 'ignore' skips reading the .ini file.
   -timeout <sec> Timeout value for watchdog feature, 0 turns the watchdog off.
                  Default value: 180, valid value range [30..86400] sec
   -watchdogaddress 127.0.0.1
                  IP address to be used for watchdog feature
   -portrange <n>[:<m>]
                  Port range to be used by watchdog feature
                  By default a port within range 50000:65535 is used
   -vm <javaVM>   The Java VM to be used for launching the application
   -startup <startup.jar>
                  The startup jar to execute. The default is to find the
                  plugins/org.eclipse.equinox.launcher jar with the highest
                  version number.
   -ea[:<package>"..."|:<class>]
                  Enable assertions (assertions are disabled by default).
                  A <package> or <class> name can be specified (cf. Java docs)
   -Dosgi.*=<value>
                  Set arbitrary OSGI configuration parameters
   -D*=<value>    Set properties for Java application
   -X*=<value>    Set (non standard) options for Java VM

Linux Daemon

The syntax for the Memory Analysis Server is:

<DT_HOME>/init.d/dynaTraceAnalysis start | stop | version | status

Note

Do not log-rotate the Memory Analysis Server's log files. This is automatically done by the Server.