Try it free

Install a Managed Cluster

  • How-to guide
  • 7-min read

To set up a Managed Cluster and install the first node, follow the steps below.

Step 1

Review requirements

Step 2

Download and verify installer

Step 3 optional

Retrieve software bill of materials

Step 4

Run installer

Step 5

Finalize

Step 1 Review requirements

Ensure that your system meets the specified hardware requirements and system requirements.

Don't install Dynatrace Managed data stores on network or remote disks, because this can cause performance and stability issues.

The installer also changes the host. The installer turns off swap, forwards port 443 to port 8022 with iptables, and raises user limits and kernel settings globally. The installer can also modify system files such as /etc/sudoers and /etc/sysctl.conf. Before you install, review What the Managed installer changes on the host.

Step 2 Download and verify installer

Download the installer and its signature file, and then verify the signature. The Dynatrace Managed installer file is digitally signed. In conjunction with OpenSSL and the Dynatrace root certificate, the signature file verifies the authenticity of the installer. The signature file has the same name as the installer, with a .sig extension.

  1. Sign in to the Linux machine and go to the directory where you want to install Dynatrace Managed.

  2. Copy the wget command line for the installer from the activation email you've received.

  3. Paste the wget command line for the installer into your terminal window. Wait for the download to complete.

  4. Copy the wget command line for the installer file signature from the activation email.

  5. Paste the wget command line for the installer file signature into your terminal window. Wait for the download to complete.

  6. Verify the installer file signature using this command:

    openssl cms -inform PEM -binary -verify -CAfile dt-root.cert.pem -in dynatrace-managed-<version>.sh.sig -content dynatrace-managed-<version>.sh > /dev/null

    Replace <version> with your Dynatrace Managed version.

  7. Check the response. A successful verification returns Verification successful. A failed verification returns Verification failure followed by details.

Step 3 optional Retrieve software bill of materials

The Dynatrace Managed Software Bill of Materials (SBOM) includes a detailed inventory of software components and dependencies. You can retrieve the SBOM in CycloneDX format from the installer archive file.

  1. To extract the installer archive, run one of the following commands from the directory where you downloaded the installation script. The extraction needs root rights, so use su or sudo.

    Replace <version> with your Dynatrace Managed version.

    • Ubuntu Server

      sudo /bin/sh dynatrace-managed-<version>.sh --extract ARCH

    • Red Hat Enterprise Linux

      su -c '/bin/sh dynatrace-managed-<version>.sh --extract ARCH'

    • Other Linux distributions with root session

      /bin/sh dynatrace-managed-<version>.sh --extract ARCH

  2. Unpack the archive file dynatrace-managed-<version>.tar.gz that the extraction creates.

    tar -xzvf dynatrace-managed-<version>.tar.gz

  3. List the files in the dynatrace-managed-<version> folder that the tar command creates.

    ls -l dynatrace-managed-<version>

    The folder contains the SBOM in CycloneDX format as dynatrace-managed-sbom.cdx.json.

Step 4 Run installer

  1. Run one of the following commands from the directory where you downloaded the installation script. Installing a Managed Cluster needs root rights, so use su or sudo.

    Replace <version> with your Dynatrace Managed version.

    • Ubuntu Server

      sudo /bin/sh dynatrace-managed-<version>.sh

    • Red Hat Enterprise Linux

      su -c '/bin/sh dynatrace-managed-<version>.sh'

    • Other Linux distributions with root session

      /bin/sh dynatrace-managed-<version>.sh

    To view a list of all available installation parameters, run the installer with the parameter --help. To skip all prompts and install with the default settings, run the installer with the --install-silent parameter, and provide your Dynatrace Managed license key as the --license parameter value.

  2. Enter Accept to agree to the Dynatrace Managed Terms of use. Installation won't continue until you complete this step. To quit, press Ctrl+C.

  3. Follow the installer prompts. The installer works in interactive mode and asks for values such as the installation path and user account. To accept a default value, press Enter. To override it, enter your choice in the terminal and press Enter.

    Have your Dynatrace Managed license key available. You can't complete installation without it.

    The default values are:

    • Installation path (binaries): /opt/dynatrace-managed
    • Dynatrace Server data files: /var/opt/dynatrace-managed
    • The system user that runs Dynatrace processes: dynatrace
    • The system group that runs Dynatrace processes: dynatrace

    The installer writes its log file to the /opt/dynatrace-managed/installer/ directory. To identify the right log file, look for the installation date in the filename. For example, the log file of a successful installation performed on September 30, 2016 is 20160930-173309-success-install-of-managed-installer.log.

Step 5 Finalize

  1. Copy the environment address displayed at the end of the installation process. Paste it into your browser to complete the installation.

  2. Give your first monitoring environment a name and set up an administrator account. Then select Next. You're signed in and redirected to the Cluster Management Console. A default domain is generated, which you should use instead of the IP address for a secure HTTPS connection.

  3. Go to Environments to view your newly created environment. Select your environment and then Go to environment to access the UI of the monitoring environment. You can later create additional monitoring environments.

Frequently asked questions

Can you use a privilege management system other than sudo?

Yes, you can use pbrun, but you must grant the Dynatrace user permission to run /opt/dtrun/dtrun *. Specify the user who installs Dynatrace Managed and the command that replaces sudo. <version> is the Dynatrace Managed version number.

/bin/sh dynatrace-managed-<version>.sh --system-user dynatrace:dynatrace --sudo-cmd  "/usr/bin/pbrun \$CMD"

For maintenance purposes, add the following script paths to your privilege management configuration:

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

Run this command to stop all Dynatrace Managed processes on a node:

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

Don't remove or overwrite dtrun, as it's required by installation and update procedures. The installer calls dtrun without arguments to validate that the user has administrative privileges; during normal operation, Dynatrace calls dtrun with arguments to run commands.