minimum required version of AG and OneAgent for the Oracle Extension

[mn_24]

Hi community,

when I download a yaml file just wanted to clarify if this is true:

what is the difference between minDynatraceVersion and minEECVersion

name: com.dynatrace.extension.sql-oracle
version: 3.4.2
# name: custom:sql-oracle
# version: 100.2.1
minDynatraceVersion: 1.310.0    <----- this is the minimum version of the ActiveGate?
minEECVersion: 1.301.0               <----- this is the minimum version of the OneAgent on the Database server?

@TomásSeroteRoos 

[sia_h]

EEC is short for Extension Execution Controller and runs on both OneAgent and ActiveGates. Its version should correspond with the respective component it runs on.

minDynatraceVersion refers to the minimum required version of the Managed or SaaS Cluster, while minEECVersion specifies the minimum required version for OneAgent or ActiveGate.

[mn_24]

Hi,

I still can not understand - why it should be so complicated and is not simplified somehow by using the same keywords for example.

When I want to update the Oracle Extension I have to check first what is the minimum required version of the ActiveGate, right? Should I worry about the OneAgent version on the Database server as well because we rely on the Log Monitoring from it or on Mountpoint/Filesystem Usage metric.

So when I check from here:

I see that currently our ActiveGate version is 1.305.73. But what does this "Extensions" mean here? And which one to check from the yaml file where we don't see "minimum ActiveGate version required" or "minimum Extensions version required" but instead "minDynatraceVersion" and "minEECVersion" ? 

On my oppinion it is NOT clear what must be checked prior updating the Oracle Extension.

[sia_h · Accepted solution]

---

@mn_24 wrote:

Should I worry about the OneAgent version on the Database server as well because we rely on the Log Monitoring from it or on Mountpoint/Filesystem Usage metric.

---

No, this pertains solely to the Extension and the component (in your case ActiveGate) it runs on.

---

@mn_24 wrote:

I see that currently our ActiveGate version is 1.305.73. But what does this "Extensions" mean here? And which one to check from the yaml file where we don't see "minimum ActiveGate version required" or "minimum Extensions version required" but instead "minDynatraceVersion" and "minEECVersion" ? 

---

The version of the ActiveGate and the version of the Extension (Execution Controller).

minDynatraceVersion refers to the minimum required version of the Managed or SaaS Cluster. If you're using SaaS, you're automatically on the latest version and don't need to worry about compatibility. If you're on Managed, you might be one (or more) version(s) behind and may need to upgrade your Cluster before using the Extension. For example, if the Extension requires minDynatraceVersion 1.310 and your Cluster is on 1.308, you'll need to upgrade the Managed Cluster to 1.310 first.

minEECVersion specifies the minimum required version for OneAgent or ActiveGate where your Extension runs on. This refers to either the OneAgent version (if the extension runs on OneAgent, which it doesn't) or the ActiveGate Extension (Execution Controller) component version (shown in the screenshot you provided).

I concur that the documentation needs improvement, and I’ll inform the documentations team.

[Peter_Youssef]

Hello @mn_24 

As simple as that for the EEC "Extension execution controller" is a mandatory feature to be activated while working with the Dynatrace extensions that are deployed through the Activegates whether Windows or Linux.

Ref:

• https://docs.dynatrace.com/docs/ingest-from/extensions20/eec-custom-configuration
• https://docs.dynatrace.com/docs/ingest-from/extensions20/extensions-concepts

For related AG versions, feel free to read more about release versions:

• https://docs.dynatrace.com/managed/whats-new/activegate/sprint-311

As a conclusion:

• There is an extension version which in turns refers to the developed or updated extension version by Dynatrace that's available generally through the Hub.
• There are minimum AG / SaaS / Managed version that should be in place to ensure the compatibility factor while deploying the Extension to pull the metrics data points from the external intended destinations (Technology).
• When you inspect full technical details presented under Manage  > Deployment Status > ActiveGates, will get the full picture about the current deployed AG && Extension versions.

BR,

Peter.

[mn_24]

Hi,

thank you @sia_h  and @Peter_Youssef for your prompt replies!

My confusion was coming from the different Keywords used in the yaml file(from the downloaded release) and the actual places in the UI where you could find the versions you need to check prior installing/updating the Extension.

At the end I understood that:

minDynatraceVersion refers to the minimum required version of the Managed or SaaS Cluster.
It could be checked from here:

minEECVersion specifies the minimum required version for OneAgent or ActiveGate where your Extension runs on. 
It could be checked from the UI in the tenant here:
Go to Deployment status --> ActiveGates --> 

and if you expand:

OK, so far so good. But still can not map in my head what the "Extensions" version means from the above screenshot 🙂 🙂