ActiveGate release notes version 1.215

With this release, the oldest supported ActiveGate versions are:

Dynatrace ONE	Dynatrace ONE Premium
1.197	1.191

How long are versions supported following rollout?

Update of Dynatrace communication endpoints

The domain used for internal communication by OneAgents and ActiveGates that send data to Dynatrace SaaS will be switched from *.live.ruxit.com to *.live.dynatrace.com beginning June 30, 2021.

This change will only affect Dynatrace SaaS customers, and only if you:

Use domain allowlisting on your outbound proxy, or
Use AWS PrivateLink to connect your OneAgents to Dynatrace

Current Dynatrace ActiveGate operating systems support changes

The following operating systems will no longer be supported starting 01 July 2021

Linux: CentOS 6.x
- x86-64
- Vendor announcement
- Last compatible version: 1.215
Linux: openSUSE 13.x
- x86-64
- Vendor announcement
- Last compatible version: 1.215
Windows: Windows Server 2008, 2008 R2
- x86-64
- Vendor announcement
- Last compatible version: 1.215
Windows: Windows 7, 8
- x86-64
- Vendor announcement
- Last compatible version: 1.215

Future Dynatrace ActiveGate operating systems support changes

The following operating systems will no longer be supported starting 01 July 2023

Linux: SUSE Enterprise Linux 15.1
- Vendor announcement

The following operating systems will no longer be supported starting 01 September 2023

Windows: Windows 8.1
- x86-64
- Vendor announcement

Past Dynatrace ActiveGate operating systems support changes

The following operating systems are no longer supported since 01 July 2022

Linux: Amazon Linux AMI 2014.03, 2017.09
- x86-64
- Vendor announcement
Linux: CentOS 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 8.0, 8.1, 8.2, 8.3, 8.4
- x86-64
- Vendor announcement
Linux: Red Hat Enterprise Linux 6.x, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 8.0, 8.1, 8.3
- Vendor announcement

The following operating systems are no longer supported since 01 November 2022

Linux: Red Hat Enterprise Linux 8.2
- Vendor announcement

Prometheus service annotations

Starting with ActiveGate version 1.215, you can annotate Kubernetes services, and there are three new optional annotations with a special format for client authentication. See Prometheus metrics for details.

Chromium support for private synthetic monitors

Chromium 89 is now the latest supported version for synthetic-enabled ActiveGates installed on Ubuntu 16.04, 18.04, 20.04, Red Hat, and CentOS 7 and 8, and bundled with the Windows ActiveGate installer. For more information, see Requirements for private synthetic locations.

Known issues

Custom settings in `launcheruserconfig.conf` file prohibit automatic ActiveGate start after update. (APM-304805)

This affects ActiveGates for which continuous update began before version 1.165.

If your launcheruserconfig.conf file contains the following parameters:

-memorylimit.percentage=80 for ActiveGates versions earlier than 1.205
-java.xmx.relative_part=80 for ActiveGate version 1.205+

your ActiveGate will not automatically start after the update to version 1.213 and your DynatracegatewayLauncher_<timestamp>.log file will contain the following log events:

plaintext
2021-05-19 17:21:25.011 UTC [273cc8f5] severe  java: [child stderr]: OpenJDK 64-Bit Server VM warning: Option UseConcMarkSweepGC was deprecated in version 9.0 and will likely be removed in a future release.
2021-05-19 17:21:25.011 UTC [273cc8f5] severe  java: [child stderr]: Unrecognized option: -java.xmx.relative_part=80
2021-05-19 17:21:25.011 UTC [273cc8f5] severe  java: [child stderr]: Error: Could not create the Java Virtual Machine.
2021-05-19 17:21:25.011 UTC [273cc8f5] severe  java: [child stderr]: Error: A fatal exception has occurred. Program will exit.

This typically occurs if you have customized the launcheruserconfig.conf file and the automatically added parameter is appended to the end of the parameter block.

ActiveGate versions earlier than 1.205 ActiveGate version 1.205+

ActiveGate versions earlier than 1.205	ActiveGate version 1.205+
plaintext `-vmargs -Dhttps.proxyHost=<host> -Dhttps.proxyPort=<port> -Dhttps.proxyUser=<user> -Dhttps.proxyPassword=<password> -memorylimit.percentage=80`	plaintext `-arguments_section.jvm -Dhttps.proxyHost=<host> -Dhttps.proxyPort=<port> -Dhttps.proxyUser=<user> -Dhttps.proxyPassword=<password> -java.xmx.relative_part=80`

plaintext
-vmargs
-Dhttps.proxyHost=<host>
-Dhttps.proxyPort=<port>
-Dhttps.proxyUser=<user>
-Dhttps.proxyPassword=<password>
-memorylimit.percentage=80

plaintext
-arguments_section.jvm
-Dhttps.proxyHost=<host>
-Dhttps.proxyPort=<port>
-Dhttps.proxyUser=<user>
-Dhttps.proxyPassword=<password>
-java.xmx.relative_part=80

Use the workaround to clear the problem.

Workaround

Edit the launcheruserconfig.conf file.
Find the following automatically added parameter:
- -memorylimit.percentage=80 for ActiveGate versions earlier than 1.205
- -java.xmx.relative_part=80 for ActiveGate version 1.205+
Delete the parameter or move it to the first line of the launcheruserconfig.conf file.

For example:

ActiveGate versions earlier than 1.205 ActiveGate version 1.205+

ActiveGate versions earlier than 1.205	ActiveGate version 1.205+
plaintext `-memorylimit.percentage=80 -vmargs -Dhttps.proxyHost=<host> -Dhttps.proxyPort=<port> -Dhttps.proxyUser=<user> -Dhttps.proxyPassword=<password>`	plaintext `-java.xmx.relative_part=80 -arguments_section.jvm -Dhttps.proxyHost=<host> -Dhttps.proxyPort=<port> -Dhttps.proxyUser=<user> -Dhttps.proxyPassword=<password>`

plaintext
-memorylimit.percentage=80
-vmargs
-Dhttps.proxyHost=<host>
-Dhttps.proxyPort=<port>
-Dhttps.proxyUser=<user>
-Dhttps.proxyPassword=<password>

plaintext
-java.xmx.relative_part=80
-arguments_section.jvm
-Dhttps.proxyHost=<host>
-Dhttps.proxyPort=<port>
-Dhttps.proxyUser=<user>
-Dhttps.proxyPassword=<password>

Resolved issues

General Availability (Build 1.215)

General Availability (Build 1.215)

The 1.215 GA release contains 3 resolved issues.

Component	Resolved issues
ActiveGate	2
Synthetic	1

ActiveGate

Improved handling of socket connection issues for Oracle database insights module. (APM-291772)
Fixed issue that executing REST requests (PUT and POST) on environment ActiveGates failed with a 3xx HTTP response. (APM-294829)

Synthetic

Since version 211 of Synthetic module, change of proxy parameters requires manual restart of VUC service. With this fix VUC restart will happen automatically after detecting change in proxy-related properties. (APM-298239)