This page details installing the AppMon Server and covers critical information needed before installation. It also covers starting and stopping AppMon Server services and daemons, and notes additional considerations for installing the AppMon Server.
What to know before installing
- Before installing AppMon Server (backend and frontend processes/Windows services/*NIX daemons), see the Deployment Guide to calculate the size of your AppMon deployment and for detailed hardware recommendations specific to your load.
- You must have a valid AppMon license to start the AppMon Client and begin using AppMon.
- You must have access to a database of adequate size for the AppMon Performance Warehouse. You can only connect to the Performance Warehouse with a valid license.
- Installation requires Java Runtime Environment (JRE) 1.8 or later.
init.dshell scripts allow the Server (and Collectors) to start as non-root under the desired user account. If your Linux uses
systemdfor startup, use the attached systemd script samples, which are the wrappers for
- Some Unix and Linux versions set the limit for file handles/sockets as low as 1024. The AppMon Server checks that the OS allows at least for 2048. However, you can quickly outgrow this, with several active System Profiles. As there is no reservation overhead involved, increase the limit generously by adding
50*3*2*System Profiles. The ground of the formula is:
- 50 files per session
- maximum 3 writer threads
- 2 for Backend Server and Frontend Server
- number of active System Profiles.
Check the hard and soft limits with
ulimit -Hn and
ulimit -n respectively before making any settings, and increase them if needed. For example,
ulimit -n <numberOfFileDescriptors> raises the soft limit of the current user. Add entries for other users/groups to
/etc/security/limits.conf. See Number of open files limit on Linux for more information.
Documentation typically refers to the AppMon installation directory as
The defaults for
To use this default directory you need to run the
cd /opt command before installation as recommended below. Otherwise the server is installed in the current folder.
DT_HOME directory structure includes these subdirectories.
||Executables and the main configuration (
||Configuration files for client and web dashboards, System Profiles and plugins.|
||Session storage directories for stored or recorded sessions.
You may want to change that path in any non-testing scenario due to it's potential large size.
Installation directory as an environmental variable
You can optionally set the installation directory in an environment variable with the following command:
setx DT_HOME "C:\Program Files\Dynatrace\Dynatrace 7.0".
Reference the variable with
export DT_HOME=/opt/dynatrace-7.0 in
~/.bashrc, depending on your Unix/Linux version.
Reference the variable with
Download and install the server
Download the Windows full installation 64-bit package and execute it. You may go for a custom installation, to install the server only.
The installation creates Start menu entries and registers the AppMon Server to automatically start the Windows service. To get information for debugging a Windows installer problem, run the installer with the following command:
dynatrace-full-188.8.131.529-x86-64.msi /lx c:\debug_log.txt
Use a designated account and run the installation in that account. You can define
DT_RUNASUSER in an install script to prevent running the AppMon Server as root.
Download the Linux/Unix installation package (
Install the package with these commands:
sudo java -jar <pathToJar>/dynatrace-full-<version>-linux-x86-64.jar
user:groupby entering the following:
sudo chown -R <DT_RUNASUSER>:<DT_USER'SGROUP> /opt/dynatrace-7.0
dynaTraceServershell script to
DT_RUNASUSERand, if necessary, other variables like
DT_FE_OPTARGSin the script.
Add this script to the system boot by using
chkconfig --add dynaTraceServeror the appropriate command for your distribution. For example, on Debian, use
sudo update-rc.d dynaTraceServerNonRoot defaults.Note
DT_RUNASUSERand registering the script and restarting, the Server starts as root. Locations such as
tempthen belong to root. To correct this, rerun the
dtserverruns, and under what user with the list launcher command:
ps -eo pid,fname,user|grep dtserver
If this doesn't work on your Linux flavor, try
ps aux|grep dtserver.
- The first, short output is for the launcher
- The second, long one is for the Server.
- The third one is for the Frontend Server, as some libs contain
dtserverand the fourth one is for
- The user the Server runs under is at the very beginning, before the PID.
Sizing and memory
You can set deployment sizing and the associated memory using the AppMon Client at startup. After activating a license, you can choose from a list of predefined deployment sizes.
You can change the selected deployment size at any time later by selecting Settings > Dynatrace Server > Settings > Sizing in the Client, or directly under
DT_HOME/dtserver.ini. See Sizing Configuration for more information.