Before you begin
What you need
Ensure that your network and firewall configuration makes the required Dynatrace Server ports available.
Before proceeding with the installation you need to set up the user account that will be used to run Dynatrace Managed processes.
The user should execute both of the following scripts with administrative privileges:
The installer calls
dtrun without arguments to validate that the user has admin privileges, but for normal operation Dynatrace calls
dtrun with arguments to actually run commands.
Following these steps you can install Dynatrace Managed by specifying the user and the command that replaces
sudo, for example:
/bin/sh dynatrace-managed-installer.sh --system-user dynatrace:dynatrace --sudo-cmd "/usr/bin/pbrun \$CMD"
Additionally, for maintenance purposes, please consider adding scripts from the locations below:
You might, for example, want to stop all Dynatrace Managed processes running on a node.
pbrun /opt/dynatrace-managed/launcher/dynatrace.sh stop
To install Dynatrace Server, follow the steps described below.
The libraries that are installed with Dynatrace Managed are locale-aware. For correct display of text and symbols, be sure to set your environment's system locale to an English language option (for example,
Step 1: Download the installer
- Open the Dynatrace Managed license activation email to display installation instructions.
- Log in to your Linux machine where you want to install Dynatrace Server.
- Copy the
wgetcommand line from the activation email and paste it into your terminal window. Wait for the download to complete and then begin the installation.
Step 2: Verify the Dynatrace Managed installer signature
The Dynatrace Managed installer file is digitally signed. The signature file is distributed along with the Dynatrace Managed installer. In conjunction with OpenSSL and the Dynatrace root certificate, the signature file can be used to verify the authenticity of the installer. The signature file has the same name as the installer, with a
To verify the installer file
- Download the Dynatrace root certificate file.
- Run the following OpenSSL command:
openssl cms -verify -binary -inform PEM -CAfile dt-root.cert.pem -content dynatrace-managed.sh -in dynatrace-managed.sg.sig > /dev/null
Step 3: Run the installer
To view a list of all available installation parameters, run the installer with the parameter
You need root rights to install Dynatrace Managed Server. You can use
sudo to run the installation script. To do this, type one of the following commands into the directory where you downloaded the installation script.
sudo /bin/sh dynatrace-managed-installer.sh
su -c '/bin/sh dynatrace-managed-installer.sh'
Follow the onscreen prompts to proceed. The Dynatrace Managed installer works in interactive mode. It displays prompts for values like the installation path and user account. You can accept the default values by pressing
Enter. To override the settings, type your choices in the terminal and press
Note: Please have your Dynatrace Managed license key available. You can't complete installation without a license key.
- Installation path (binaries):
- Dynatrace Server data files:
- The system user who runs Dynatrace processes:
- The system group who runs Dynatrace processes:
To bypass all questions and install with default settings, run the installer with the
--install-silent parameter. Be sure to provide your Dynatrace Managed license key as the
--license parameter value.
Dynatrace Managed Cluster is a set of specialized components that have been configured to host your monitoring environment, process monitoring data, and to scale up for flawless operation.
The installer sets up the following components in the installation directory (by default,
- Pre-configured Java Runtime Environment (your operating system settings aren't affected by this). Not visible in your
- Cassandra-based Hypercube storage
- Elasticsearch-based search engine
- Dynatrace Server
- Security Gateway
The installer also optimizes operating system settings:
- Swap is turned off (with
PREROUTING" rules are enhanced to enable forwarding of communication to Dynatrace Server (via HTTPS on port 8021). To see the exact rules, type
iptables -L -vt natinto your terminal.
readaheadpage cache is set to 512.
- Limits for users are changed globally (unlimited locked-in-memory address space, unlimited address space, increased limit for number of processes and open files). See
The following system files and directories may be modified during installation of Dynatrace Managed:
Copy the environment URL that's provided at the end of the installation process. Paste the address into your browser to complete the remainder of the installation. Setup is now complete.
You can find the Dynatrace Server installation log file in the
/opt/dynatrace-managed/installer/ directory. To easily identify the right log file, look for the installation date in the file name. For example, the log file of a successful installation performed on September 30th would be
Step 4: Configure an admin user and an environment name
Type a name for your new monitoring environment.
Select a name that will allow you to easily identify the environment. This setting can be changed later once you access your Dynatrace Server dashboard.
You need to set up an administrative user for the Dynatrace Managed Server. You'll need this user account to manage other user accounts and your monitoring environment.
Once you're done with this part of the setup you'll automatically be logged into your Dynatrace Managed Server. Your first monitoring environment is now ready!
Dynatrace Managed Server requires fixed IP assignment.
After you've installed your Dynatrace Managed Server you can: