This page provides a generic description of Agent installation.
An Agent is a shared library that needs to be injected into the application process. For most Agents there is a bootstrap part that takes care of versioning.
The Agents installation packages include most of the Agents, so you don't have to install each Agent separately. See OS-related sections below for more details. The Node.js Agent, however, requires special handling. See Configure Node.js Agent for more information.
Agent installation directory
Documentation typically refers to the AppMon installation directory as
The defaults for
C:\ProgramFiles\Dynatrace\Dynatrace <major.minorVersion>for a full installation.
C:\ProgramFiles\Dynatrace\Dynatrace Agent <major.minorVersion>for an Angent-only installation.
/opt/dynatrace-<major.minorVersion>for a full installation
/opt/dynatrace-agent-<major.minorVersion>for an Agent-only installation
To use these default directories you need to run the
cd /optcommand before installation as recommended below.
With a *NIX shell script or
.tar, you need to create a directory by entering
md then enter
cd to go the desired directory before running/unpacking it.
The actual bootstrap and core Agent parts are installed to
DT_HOME/agent/lib and updates to the core are in
DT_HOME/agent/downloads/<version>. Shared memory and
.ini files are in
DT_HOME/log is common to all components, which is one reason that it is important to keep the
DT_HOME folder structure and permissions.
Download the Agent Windows installation package of choice for your architecture (32 or 64-bit) and run it. You may need to run for a custom installation and manually selected Agents to be installed.
The Windows full install package and Agents-only install package include all the Agents, except for Node.js. For instructions on installation Node.js Agent, see Configure Node.js Agent.
Download the appropriate AppMon installation package (
.tar file) for your architecture (x86, x64, PPC) and instrumentation needs.
If you use SELinux, see SELinux and Dynatrace Product Issues on Redhat.
.jar-based Agents installer requires a JRE 1.8 or later.
Some of the individual Agent installers come as .
tar shell scripts and do not require a JRE, as the .
sh has the Agents embedded. The
.jar file asks for the install directory, but the
.sh does not. Both default to the current directory.
The Agent-only installation package, despite being
.jar-based, works with JRE 1.6 or later.
Full installation package
The *NIX full installation package include all the Agents, except for Node.js Agent. It comes for 64-bit architecture only.
Use the following to install it:
cd /opt sudo java -jar <pathToJar>/dynatrace-full-<version>-linux-x86-64.jar
Agent-only installation package
The Agent-only installation package doesn't have Node.js Agent, Host Monitoring Agent, and Web Server Agents — Web Server Master, NGINX, and PHP Agents. You should download and install them separately. For instructions on installation Node.js Agent, see Configure Node.js Agent.
The Agents installation package comes as
.jar file. Install it as follows:
cd /opt sudo java -jar <pathToJar>/dynatrace-agent-<version>-unix.jar
Web Server Agents installation package
The Web Server Agents package comes as
.tar file, containing
.sh shell script. Use these commands to install it:
cd /opt tar -xvf <pathToTar>/dynatrace-wsagent-<version>-<os>-<architecture>.tar cd /<DT_HOME> ./dynatrace-wsagent-<version>-<os>-<architecture>
Host Agents installation package
The Host Agents package comes as
.tar file, containing all Agent files. You just need to extract it — no additional installation needed:
cd /opt tar -xvf <pathToTar>/dynatrace-hostagent-<version>-<os>-<architecture>.tar
||Allows to override the default file system permissions of Agents.
You will be prompted for a 3 digit permission bit mask that will then be used for Agent installations. Use this parameter if your policy does not allow world writable files/directories.
The parameter is only available for
AppMon 2018 April and later
Read more about Linux PPC-LE support & integration.
With AppMon 2017 May you need to install Classic Agents first, and then switch the agent-platform.
Details on Downloads for automated agent integration.