How do I install Dynatrace Server?

This topic applies to Dynatrace Managed installations only.

Before you begin

What you need

  • Dynatrace Managed license key
  • Administrator credentials for the servers where Dynatrace Managed is to be installed
  • An up-to-date Linux distribution that is supported by Dynatrace Managed

Make sure your network and firewall configuration will make the Dynatrace Server ports available. For more information, see What network ports does Dynatrace Server use?

What if my company uses a privilege management system other than Sudo?

Before proceeding with the installation you need to set up the user account that will be used to run Dynatrace Managed processes. The user must be able to execute the /opt/dtrun/dtrun script with administrative privileges.

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:

  • /opt/dynatrace-managed/uninstall-dynatrace.sh
  • /opt/dynatrace-managed/launcher/*
  • /opt/dynatrace-managed/utils/*

You might, for example, want to stop all Dynatrace Managed processes running on a node.

pbrun /opt/dynatrace-managed/launcher/dynatrace.sh stop

Download the installer

  1. Open the Dynatrace Managed license activation email to display installation instructions.
  2. Log in to your Linux machine where you want to install Dynatrace Server.
  3. Copy the wget command line from the activation email and paste it into your terminal window. Wait for the download to complete and then begin the installation.

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 .sig extension.

To verify the installer file

To verify the installer file

  1. Download the Dynatrace root certificate file.
  2. 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

Run the installer

Where can I install Dynatrace Server?

Hardware sizing

Scale1 (nodes) Max. hosts monitored User actions/s Events/s CPU + RAM (single node) Disk IOPS (across all nodes) 1 day code-level visibility (all nodes) Long-term (per node)
Trial (1 node) 100 50 8,000 4 cores 16GB RAM R: 3W: 5 100GB 150GB
Small (1 node) 1,000 300 50,000 8 cores 32GB RAM R: 15W: 30 300GB 800GB
Small (3 nodes) 3,000 1,000 150,000 8 cores 32GB RAM R: 50W: 100 1TB 2.5TB
Large (1 node) 3,000 1,000 150,000 32 cores 64GB RAM R: 50W: 100 1TB 2.5TB
Large (3 nodes) 10,000 3,000 500,000 32 cores 64GB RAM R: 150W: 300 3TB 8TB
XXL (6 nodes) 50,000 10,000 1,500,000 64 cores 160GB RAM R: 500W: 1000 10TB 20TB
  1. No failover for single-node installations. For guidance on extra large environments, please contact us at Dynatrace Answers.

Multi-node installations

For Dynatrace Managed installations with more than one node, all nodes must:

  • Use the same Linux distribution
  • Have the same hardware configuration
  • Be synchronized with NTP
  • Be in the same timezone

You need root rights to install Dynatrace Managed Server.
You can use su or sudo to run the installation script. To do this, type one of the following commands into the directory where you downloaded the installation script.

If you’re on an Ubuntu Server, use the following command:

sudo /bin/sh dynatrace-managed-installer.sh

If you’re using Red Hat Enterprise Linux:

su -c '/bin/sh dynatrace-managed-installer.sh'

If you start a root session:

/bin/sh dynatrace-managed-installer.sh

Accept Dynatrace Managed Terms of Use.
Type Accept if you agree to our Terms of use. Installation won’t continue until you complete this step.
To quit installation press Ctrl+C .

Follow the onscreen prompts to proceed.
Dynatrace Managed installer works in interactive mode. It displays prompts for values like 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 Enter .
Note : In one of the steps you need to enter license key. Installation won’t continue without this.

What are the default settings?
  • Installation path (binaries): /opt/dynatrace-managed
  • Dynatrace Server data files: /var/opt/dynatrace-managed
  • The system user who runs Dynatrace processes: dynatrace
  • The system group who runs Dynatrace processes: dynatrace
Can I bypass the interactive mode?

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.

What happens during installation?

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, /opt/dynatrace-managed ):

  • Pre-configured Java Runtime Environment No operating system settings are affected. Not visible in your alternatives options.
  • Cassandra-based Hypercube storage
  • Elasticsearch-based search engine
  • Dynatrace Server
  • Security Gateway

The installer also optimizes operating system settings:

  • Swap is turned off (with swapoff).
  • iptablesPREROUTING “ rules are enhanced to enable forwarding communication to Dynatrace Server (HTTPS to port 8021). To see the exact rules, type iptables -L -vt nat in your terminal.
  • readahead page 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 /etc/security/limits.conf for details.
  • max_map_count is modified.

Copy the address that’s displayed at the end of the installer messages and paste the address into your browser to complete the remainder of the installation. Setup on the machine is now complete.

Where can I find installation logs?

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 20160930-173309-success-install-of-managed-installer.log

Configure an admin user and initial environment

Type the name of your first 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.

Next steps

After you’ve installed your Dynatrace Managed Server you can: