Install Agents
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 DT_HOME
(or <DT_HOME>
).
The defaults for DT_HOME
are:
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 thecd /opt
command 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[64]
and updates to the core are in DT_HOME/agent/downloads/<version>
. Shared memory and .ini
files are in DT_HOME/agent/conf
. 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.
Install Agents
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 (.jar
or .tar
file) for your architecture (x86, x64, PPC) and instrumentation needs.
If you use SELinux, see SELinux and Dynatrace Product Issues on Redhat.
JRE version
The .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
Installation parameters
Parameter | Description |
---|---|
-p |
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
.jar installers.
|
AppMon 2018 April and later
Read more about Linux PPC-LE support & integration.
AppMon Agent
With AppMon 2017 May you need to install Classic Agents first, and then switch the agent-platform.
Automation Downloads
Details on Downloads for automated agent integration.
Automatic installation
You can automate the installation with Ansible, Chef, or Puppet. Click the link below for more detailed information.