ActiveGate default installation settings for Linux

  • Latest Dynatrace
  • 1-min read
  • Published Jun 21, 2021

If you do not specify any parameters during ActiveGate installation to customize settings, the following default settings will be applied. To modify defaults settings during installation, see Customize ActiveGate installation on Linux.

Directories

Purpose of directoryDefault pathPath relative to installation parameterDisk space requirements
(if size is not given, assume less than 1 MB)

ActiveGate executable files, libraries, and related files

/opt/dynatrace/gateway

<INSTALL>/gateway

300 MB

ActiveGate configuration

/var/lib/dynatrace/gateway/config

<CONFIG>/gateway/config

ActiveGate SSL folder

/var/lib/dynatrace/gateway/ssl

<CONFIG>/gateway/ssl

ActiveGate temporary files

/var/tmp/dynatrace/gateway

<TEMP>/gateway

4 GB (including 3 GB for cached OneAgent installers and container images)

ActiveGate logs

/var/log/dynatrace/gateway

<LOG>/gateway

500 MB

Dump files uploaded to ActiveGate by OneAgent

/var/lib/dynatrace/gateway/dump

<CONFIG>/gateway/dump

Functionality off by default. When activated, can take configurable maximum size: default 100 GB.

ActiveGate packages directory for auto-update installer downloads

/var/lib/dynatrace/packages

<PACKAGES_DIR>

500 MB.

ActiveGate extensions executable files, libraries, and related files1

/opt/dynatrace/remotepluginmodule

<INSTALL>/remotepluginmodule

350 MB

ActiveGate extensions configuration, logs, cache, run-time work area

/var/lib/dynatrace/remotepluginmodule

<CONFIG>/remotepluginmodule

2 GB (for logs and crash dumps)

ActiveGate extensions upload directory

/opt/dynatrace/remotepluginmodule/plugin_deployment/

<INSTALL>/remotepluginmodule/plugin_deployment/

Depending on uploaded extensions

zRemote executable files, libraries, and related files

/opt/dynatrace/zremote

<INSTALL>/zremote

50 MB

zRemote user-modifiable persistent configuration,
zRemote runtime work area, crash reports

/var/lib/dynatrace/zremote/agent

<CONFIG>/zremote/agent

50 MB

zRemote logs

/var/log/dynatrace/zremote

<LOG>/zremote

200 MB

Private Synthetic executable files, libraries, and related files

/opt/dynatrace/synthetic

<INSTALL>/synthetic

270 MB

Private synthetic logs

/var/log/dynatrace/synthetic

<LOG>/synthetic/log

1 GB

Private Synthetic temporary files

/var/tmp/dynatrace/synthetic

<TEMP>/synthetic

20 GB, including 1 GB for the /var/tmp/dynatrace/synthetic/cache and 1 GB for /var/tmp/dynatrace/synthetic/screenshots

You can use TEMP to customize this location; however, for Synthetic-enabled ActiveGate installed on Ubuntu 20.04 LTS and 22.04 LTS earlier than 1.331, the path must begin with /var/tmp, for example, TEMP=/var/tmp/syn. Dynatrace requires write access to /var/tmp for the installation of Chromium snap packages.

Autoupdater

/opt/dynatrace/autoupdater

<INSTALL>/autoupdater

Included in estimate for ActiveGate executable files

Autoupdater logs

/var/log/dynatrace/autoupdater

<LOG>/autoupdater

200 MB

1

To ensure that extensions run correctly, the filesystem flag must be set to exec and not noexec. This configuration is crucial because it allows the execution of binaries and scripts within the specified filesystem. Without this setting, the extension will not be able to execute properly, leading to potential errors and failures.

Access ActiveGate config directory

The config directory has specific permissions set for the dtuserag user. Access to this directory requires root privileges, as direct login to the dtuserag account is not allowed.

Services

Component name

Service name

Description

ActiveGate

dynatracegateway

The main ActiveGate service. Present for all ActiveGate purposes and functional modules.

ActiveGate auto-updater

dynatraceautoupdater

An auto-updater service. Present for all ActiveGate purposes and functional modules.

Extensions

extensionsmodule

Service for the Extensions functional module. Present on ActiveGates installed for the routing-monitoring purpose. This service will be active or inactive, depending on configuration—for default setting, refer to the module description.

zRemote

zremote

Service for the zRemote functional module. Present on ActiveGates installed for the purpose of routing z/OS traffic to Dynatrace.

Synthetic

vuc

Service for the Synthetic functional module. Present on ActiveGates installed for the purpose of running Synthetic monitors from a private location.

Service account

All ActiveGate services are by default running as dedicated unprivileged user dtuserag. The only exception is dynatraceautoupdater which requires root privileges.

If the user dtuserag does not already exist in the system, the installer will create it.

Port usage

By default, ActiveGate:

  • receives connections from OneAgents or other ActiveGates on port 9999
  • receives Dynatrace API on port 9999
  • connects to Dynatrace SaaS or Managed cluster on port 443

For more information about possible ActiveGate connectivity schemes, see Supported connectivity schemes for ActiveGates.