You can use command line parameters to override some default settings or to upgrade Dynatrace Server.
By default you don't need to use any parameters to install Dynatrace Managed. The installer works in interactive mode. This means that you need to enter or confirm installation details like license, data and binaries directory, and user name.
To install the server in non-interactive mode with default settings, use the
--install-silent parameter. Remember to use
--license to provide the license key that we sent you.
- Installation path (binaries):
- Dynatrace Server data files:
- The system user who runs Dynatrace processes:
- The system group who runs Dynatrace processes:
Initial configuration parameters
The following environment and admin-user attribute parameters should be used for initial server configuration. When specified, the installer will generate an authentication token for the public REST API following successful installation and cluster registration.
--initial-environment <name> — Use this parameter to specify the name of the environment.
--initial-first-name <name> — Use this parameter to specify the administrator's first name.
--initial-last-name <name> — Use this parameter to specify the administrator's last name.
--initial-email <email> — Use this parameter to specify the administrator's email.
--initial-pass <pass> — Use this parameter to specify the administrator's password.
You can run the Dynatrace Managed installer in any of the following modes:
--install — This is standard, interactive installation.
--install-silent — Use this parameter to install with default settings. You can use this parameter to automate Dynatrace Server installation (no prompts). You can use other command line parameters to bypass some of the default settings.
--upgrade — Starts the upgrade process. Use this parameter if you want to start Dynatrace Server upgrade from the command line.
--uninstall — Safely uninstalls Dynatrace Server.
--restore — Restores Dynatrace Managed installation from the backup file referenced by the
--backup-file parameter. Backup is performed by Dynatrace Server on a daily basis once you've enabled and configured backup on Dynatrace Server.
--system-check — Use this parameter to check if the machine and operating system fulfills the requirements of the new version.
--self-check — Use this parameter to verify that the installer file isn't corrupt.
You can change the installation path and other settings using the following parameters:
--license <license-key> — Use this parameter to provide the license key you obtained from the Dynatrace team.
--license-file <path> — Dynatrace license file, used when license key is not provided.
--binaries-dir <path> — Full path to the Dynatrace binaries directory.
--datastore-dir <path> — Full path to the Dynatrace installation space directory. All Dynatrace data is kept here. It's recommended that you use a dedicated drive or partition for this directory.
--cas-datastore-dir <path> — Full path to the Dynatrace metrics repository directory. If you specify this location, metrics data will be kept here instead of in the main data location.
--els-datastore-dir <path> — Full path to Dynatrace Elasticsearch store directory.
--svr-datastore-dir <path> — Full path to Dynatrace raw transaction store directory. If you specify this location, raw transaction data will be kept here instead of in the main data location.
--system-user <user:group> — name:group of system user who is authorized to run Dynatrace processes.
--network-proxy — If your machine uses a network proxy to connect to the Internet, put the address here in the following format:
protocol://[user:password@]server-address:port. The default value is
--cluster-ip — If your machine has more than one network interface you need to decide which network interface will be used for Dynatrace Cluster traffic and put its IP4 address here.
--registration-token — Token used for registration in Mission Control: optional for regular installation.
--install-agent <on|off> — Enable/disable installation of self-monitoring agent. The default value is
--hosts <on|off> — Enable/disable altering of /etc/hosts file. The default is
--generate-domain <on|off> — Generate domain name and corresponding certificates. The default value is
--no-start — Use this parameter when you don't want Dynatrace Server to start immediately following installation or upgrade.
--unregister — Use this parameter when uninstalling a cluster to unregister the cluster and release license from Mission Control.
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
If you want to use the installation file to install a secondary Dynatrace Server node in a cluster, use the following parameters:
--seed-ip <ip> — IPv4 address of the master server in the cluster.
--seed-auth <auth-token> — Authentication token for connection to seed node. You'll find this after logging into the seed node, on the Download node installer page.
Command line parameters can also help you install or update SSL certificates on Dynatrace Server. For more information on installing fully-qualified digital certificates, see Can I use my own SSL certificate?
--update-cert — If you want to replace the self-signed certificate generated during Dynatrace Server installation, use this parameter with the installation script and install a CA issued certificate. You need to use this parameter together with
--ssl-keystore <path> — Use this parameter to provide the installation script with a path to the KeyStore file containing your CA issued certificates.
--version — Print version information.
--tmp-dir <path> — Full path to the directory for installer temp files
List available options
You can always use the
help parameter to list all available command line options of the Dynatrace Server installer. As root, type:
How the installer takes instructions
By default Dynatrace Managed installer runs in interactive mode. It asks you either to confirm the default settings or provide your own values. The values you enter during installation always take precedence. They override command line parameter values as well as default values.
When you run the installer in interactive mode with command line parameters, the parameter values are presented as prompts (instead of defaults). If you enter any values at this point, they will take precedence.