Summary: This article describes how to address scenarios where OneAgent network protection blocks a port. It outlines configuration changes and exemptions that allow the application to use the required port safely.
OneAgent consists of multiple processes that communicate with a watchdog via a TCP port. At startup, OneAgent watchdog attempts to open the first available port between ports 50000 and 50100. In some cases, you may need this port for your own applications that are started after OneAgent. In such cases, you can change the port range that the OneAgent watchdog uses by calling the OneAgent command-line interface.
You can change the watchdog listening port by using
set-watchdog-portrange
via oneagentctl command-line tool:
- For example, to change port range to 50005:50105, go to the oneagentctl directory and run the following command:
-
On Linux or AIX:
./oneagentctl --set-watchdog-portrange 50005:50105 -
On Windows:
.\oneagentctl.exe --set-watchdog-portrange 50005:50105Restart OneAgent service to apply changes.
-
See Which network ports does Dynatrace Server use? for information on the ports used by Dynatrace.
OneAgent version 1.183 and earlier
Change the port range that the OneAgent watchdog uses by modifying the file watchdoguserconfig.conf.
- The file watchdoguserconfig.conf is located in /var/lib/dynatrace/oneagent/agent/config on Linux AIX and %PROGRAMDATA%\dynatrace\oneagent\agent\config on Windows.
- You can change the watchdog listening port by modifying the following line in the file:
-
From, for example:
<span>-portrange=50000:50100<br></span>To:
<span>-portrange=50005:50105</span> -
Restart OneAgent service to apply changes.
-