Showing results for 
Show  only  | Search instead for 
Did you mean: 

Upgrading Private Synthetics Environment ActiveGate


We are trying to figure out the best method to update our environment activegates that are set up to run private synthetics. In the documentation around updating activegates, it says you can just install the new version over the old one, but when we do that with the '--enable-synthetic' and '--enable-browser-monitors' options, we get the error below:

ERROR: Parameters --install-modules, --enable-synthetic, --enable-browser-monitors and --enable-zremote are not valid for an update and are mutually exclusive, with the exception of --enable-synthetic and --enable-browser-monitors, which can be specified together. To proceed, perform the following actions as user 'root': first uninstall Dynatrace ActiveGate and then perform an installation, specifying appropriate parameter(s), depending on your requirement, e.g.:


Installation failed.

My question is are we going to have to uninstall and reinstall on these particular activegates every time a new version is available, or is there a method to updating these without completely uninstalling/reinstalling?


DynaMight Leader
DynaMight Leader

I’m curious if upgrading AG without parameter wouldn’t be best option. In general upgrade process does not touch configuration, so this should not break anything.


Look here, synthetic is only property in config file, so upgrading without extra arguments should work for you.


DynaMight Guru
DynaMight Guru

As far as I remember, the correct method is to just run the ActiveGate installer without any parameters. The installation will honour the existing configuration.

The parameters are just for installing a new ActiveGate.

TEMPEST a.s., Slovakia, Dynatrace Master Partner


I just ran the install in my test environment without any parameters and it basically changed the activegate into one used for routing traffic and monitoring cloud environments, so now my synthetics are dead.

DynaMight Champion
DynaMight Champion

Hi guys

You should use to preserve all changes made in the AG file.

For more information check documentation


dynatrace certificated professional - dynatrace primer partner - Matrix Soft Ware Division - Israel


So for a synthetics enabled activegate, what should the upgrade process be? What would I need to add into the file? I'd like to get this process down, as we have a few of these to update, and manually uninstalling and reinstalling every time a new version is available really isn't feasible.

Hi @Ryan W.

In you should add

Section: [synthetic]


This will take care of the changing, after upgrade, the Out Of the Box that the upgrade will create.


dynatrace certificated professional - dynatrace primer partner - Matrix Soft Ware Division - Israel

Ok, I am going to update the file on one of my other AGs and give it a try. I'll report back with my findings.


You can just run the install on the gateway without any perimeters and it will retain current settings and just update the version. I've done this without error on my internal, external and custom metrics/Plugins Activegates without any problems, WE typically do a snapshot of the host that is being upgraded just before in the event that something does go sour we can just jump right back. Never had to uninstall and install to be on the latest version.

Hey Chad, thanks for the reply. I have also been able to upgrade the other activegates without using any parameters, but this seems to occur strictly on the synthetics enabled AGs. Have you done the upgrade on any of those?

Hey Ryan, Yes We have done this for CMC activegates that handle oneagent traffic, Mobile app alerts, internal synthetics, external synthetics, and custom plugins. I have attached a screen shot with the settings we use when we download the linux install/updated version.

You could select that second radio button and it will pass the perams for synthetics but i dont believe thats needed since synthetics are already running - the install file just updates

Everything we have tried has worked as expected in regards to upgrades, except for the second option in your screenshot. When we run the install with the parameters it mentions, the install fails telling us that parameters are not needed. Then when we run it with no parameters, it blows away synthetics and turns the activegate into the first option (route traffic, monitor cloud environments). I am going to try it with the option Yos mentioned above with the modification to the file, and I'll report back.

I am looking forward to your results! Fingers crossed!!