Use these command line parameters to override the default settings of a Managed Cluster installation.
By default, no parameters are required, because the Managed installer runs in interactive mode and prompts you to confirm or override default settings. Values entered interactively always take precedence over command line parameter values.
When you run the installer in interactive mode with command line parameters, the parameter values are presented as prompts instead of defaults. Any values entered at that point take precedence.
To install a Managed Cluster in non-interactive mode with default settings, use --install-silent together with --license to provide the license key.
/opt/dynatrace-managed/var/opt/dynatrace-manageddynatracedynatraceTo list all available command line options, run the installer with --help as root:
[root@localhost]# ./dynatrace-managed-installer.sh --help
Use these parameters for initial server configuration. When specified, the installer generates an authentication token for the public REST API after successful installation and Managed Cluster registration.
| Parameter | Description |
|---|---|
| Name of the first monitoring environment |
| Administrator's first name |
| Administrator's last name |
| Administrator's email address |
| Administrator's password |
| Parameter | Description |
|---|---|
| Standard interactive installation |
| Installs with default settings in non-interactive mode. Use other command line parameters to override specific defaults. Useful for automating installation |
| Premium High Availability only. Installs in a new data center in non-interactive mode. Use other command line parameters to override specific defaults |
| Starts the update process from the command line |
| Checks whether the machine and operating system meet the requirements of the new version |
| Restores a Dynatrace Managed installation from the backup file specified by |
| Reconfigures an existing installation using setup parameters |
| Uninstalls Dynatrace Managed |
| Verifies that the installer file isn't corrupt |
| Full path to the backup file containing configuration and data. Used with |
| Extends timeouts for specified components. Use when:
|
| Dynatrace uses the |
Configure the outermost reverse proxy from which clients access Dynatrace Managed as follows:
X-Forwarded-For headers from all requests that target Dynatrace Managed.X-Forwarded-For headers, as the related features require them.
/bf/mbeacon/communicationThe NGINX proxy installed with Dynatrace Managed follows these rules by default. However, you can turn off this behavior during installation if NGINX isn't the outermost proxy from which clients access Dynatrace Managed. In this case, configure the outermost proxy manually.
The following components can be configured with --timeouts:
| Component | Description |
|---|---|
| Base timeout in seconds. This value is added to the component-specific timeouts listed below for Nodekeeper, Cassandra, Elasticsearch, Server, ActiveGate, and NGINX |
| Nodekeeper startup process timeout seconds = |
| Cassandra startup process timeout seconds = |
| Elasticsearch startup process timeout seconds = |
| Server startup process timeout seconds = |
| ActiveGate startup process timeout seconds = |
| NGINX startup process timeout seconds = |
| Firewall startup process timeout seconds = |
You can change the installation path and other settings using the following parameters:
| Parameter | Description |
|---|---|
| Full path to the Dynatrace binaries directory. Using this parameter with SELinux enabled requires the |
| Parameter | Description |
|---|---|
| License key obtained from Dynatrace |
| Dynatrace license file, used when a license key isn't provided |
If you have SELinux enabled, the following parameters require the semanage utility to be available on your system.
| Parameter | Description |
|---|---|
| Full path to the Dynatrace installation directory. Use a dedicated drive or partition for this directory. Only Dynatrace data not configured in other stores is kept here. If no specific paths are configured for other data stores, all Dynatrace data is stored here. Default: |
| Full path to Dynatrace Session Replay store. Default: |
| Full path to the Dynatrace metrics repository directory. If you specify this location, Dynatrace stores metrics data here instead of in the main data location. Default: |
| Full path to Dynatrace Elasticsearch store directory. Default: |
| Full path to Dynatrace raw transaction store directory. If you specify this location, Dynatrace stores raw transaction data here instead of in the main data location. Default: |
The default path /var/opt/dynatrace-managed/server/replayData cannot be a mounting point.
To make the configuration as secure as possible, Dynatrace creates a unique Linux system user for Dynatrace Managed services.
The system user:
read, write, and execute permissions needed for required filesnologin shellThese measures limit what an attacker can do if system security is compromised. If you use a default user account, set it up with the same principles.
The following parameters specify a system user who is authorized to run Dynatrace processes.
| Parameter | Description |
|---|---|
| Username and group name of the system user authorized to run Dynatrace processes. Default: |
| User ID and group ID of the system user authorized to run Dynatrace processes. Default: |
You can specify one or both parameters.
| Parameter | Description |
|---|---|
| If your machine uses a network proxy to connect to the internet, put the address here in the following format: |
| If your machine uses an HTTPS network proxy with a self-signed certificate, extend the trusted certificate store. Provide the full path to a public SSL certificate file in PEM format |
| Token used for registration in Mission Control (optional for regular installation) |
| Parameter | Description |
|---|---|
| If your machine has more than one network interface, decide which network interface to use for Managed Cluster traffic and enter its IPv4 address here |
| You can specify the node ID with the IP address. Use this when you restore a Managed Cluster and you must attach a replacement node that has a different IP address than the original |
| IPv4 address of the seed node in the Managed Cluster |
| Authentication token for connection to the seed node. You'll find this token after you sign in to the seed node, on the Download node installer page. This token is valid for three hours |
| For rack-aware deployments, provide the data center that contains the rack where you want to add the node. Always use it together with |
| For rack-aware deployments, provide the name of the rack where you want to add the node. Accepts only letters, digits, and hyphens, up to 80 characters, with no leading hyphen. Defaults to |
| Parameter | Description |
|---|---|
| Turn on or turn off installation of the self-monitoring OneAgent. Default: |
| Name:group of the system user who should run the self-monitoring OneAgent. Use only if the default user for OneAgent cannot be used |
| Allows installation of self-monitoring OneAgent to a different directory. For example, on Linux: With |
Command line parameters can also help you install or update SSL/TLS certificates on Dynatrace Managed. For more information on installing fully qualified digital certificates, see Configure SSL certificate for Managed Cluster.
| Parameter | Description |
|---|---|
| Space-separated list of protocols accepted by SSL connections. Replaces the default list |
| Definition of ciphers accepted by SSL connections. Replaces the default definition. This definition must first be validated with an |
| Turn on or turn off cipher autoupdate, which sets default values for protocols and ciphers accepted by SSL connections on each upgrade or reconfiguration. Default for new nodes: |
| Parameter | Description |
|---|---|
| Turn on or turn off altering of the |
| Dynatrace Managed version 1.346+ Turn on or turn off IPv6 endpoints for webhook problem notifications. Set |
| Command that should be used for executing system commands with superuser privileges. Should contain the variable
|
| Upgrade only. Use this parameter when you don't want Dynatrace Managed to start immediately following an upgrade |
| Use this parameter when uninstalling a Managed Cluster to unregister the Managed Cluster and release the license from Mission Control |
| Print version information |
| Full path to the directory for installer temp files |