DIT Domain - Useful Links

DIT Domain - Shared Drive Paths

DIT Domain - Handy Commands

Check AD Objects

Description PS Command
Search AD Groups (New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=user)(CN=$("user.name")))")).findOne().GetDirectoryEntry().memberOf
Display a AD User Properties (New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=user)(CN=$("user.name")))")).findOne().Properties
Search a AD Group Members (New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=group)(CN=$("AD_GROUP_NAME")))")).findOne().GetDirectoryEntry().member
Count a AD Group Member (New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=group)(CN=$("AD_GROUP_NAME")))")).findOne().GetDirectoryEntry().member | Measure-Object
Display a AD Group Properties (New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=group)(CN=$("AD_GROUP_NAME")))")).findOne().Properties

Agent Communication

Command Windows Linux Notes
Production
CAG Endpoint (vip)
Test-NetConnection -ComputerName 10.0.3.61 -Port 9999 curl -I https://10.0.3.61:9999/communication Inbound agent communication.
Production
DMO Endpiont (vip)
Test-NetConnection -ComputerName 10.0.3.62 -Port 443 curl -I https://10.0.3.61:443/communication Inbound agent communication.
Pre-Production
CAG Endpoint (vip)
Test-NetConnection -ComputerName 10.3.3.61 -Port 9999 curl -I https://10.3.3.61:9999/communication Inbound agent communication.
Pre-Production
DMO Endpiont (vip)
Test-NetConnection -ComputerName 10.3.3.62 -Port 443 curl -I https://10.3.3.62:443/communication Inbound agent communication.
EAG Endpoint Test-NetConnection -ComputerName [IP Address of EAG] -Port 9999 curl -I https://[IP-Address-of-EAG]:9999/communication Inbound agent communication.
Other Notes Use CAG vip for Inbound agent communication. These commands check if a target monitoring host can reach on Dynatrace endpoints on a specific port.
By default, CAG and EAG uses port 9999, and DMO uses port 443.
Outbound communication from DMO & CAG are via host IP not VIP.
Use the -k flag with the curl for HTTP connections. If Netcat is available use: nc -zv [IP Address] [Port]

OneAgent Command Line Interface

Command Windows Linux Notes
OneAgentCTL & 'C:\Program Files\dynatrace\oneagent\agent\tools\oneagentctl.exe' --set-server=https://[prod or preprod cag ip]:9999/communication --set-tenant=[ provide the tenant id] --set-tenant-token=[ get the tenant token ] --set-host-group=[ host group ] --restart-service sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --set-server=https://[prod or preprod cag ip]:9999/communication --set-tenant=[ provide the tenant id] --set-tenant-token=[ get the tenant token ] --set-host-group=[ host group ] --restart-service See Dynatrace Docs
Other configuration stttings --set-network-zone=[network zone name] --set-host-id-source=ip-addresses --set-infra-only=true --set-app-log-content-access=true --set-watchdog-portrange=50000:50100
Set a new port range is deprecated starting with OneAgent version 1.301 Dynatrace Docs

Custom metadata Dynatrace Docs

OneAgent Operations

Command Windows Linux Notes
OneAgent Service net start "Dynatrace OneAgent"
net stop "Dynatrace OneAgent"
net restart "Dynatrace OneAgent"
sudo systemctl start oneagent
sudo systemctl stop oneagent
sudo systemctl restart oneagent
See OneAgent on Windows Dynatrace Docs
See OneAgent on Linux Dynatrace Docs
OneAgent Configuration Files %ProgramData%\dynatrace\oneagent\agent\config /var/lib/dynatrace/oneagent/agent/config/ See OneAgent Directories on Windows Dynatrace Docs
See OneAgent Directories on Linux Dynatrace Docs
OneAgent Log Files %ProgramData%\dynatrace\oneagent\log /var/log/dynatrace/oneagent/ See OneAgent Directories on Windows Dynatrace Docs
See OneAgent Directories on Linux Dynatrace Docs
OneAgent Binaries C:\Program Files\dynatrace\oneagent\agent\lib64
C:\Program Files\dynatrace\oneagent\agent\bin\*
/opt/dynatrace/oneagent/agent/lib64/
/opt/dynatrace/oneagent/agent/bin/*
See OneAgent Directories on Windows Dynatrace Docs
See OneAgent Directories on Linux Dynatrace Docs
OneAgent Uninstall $app = Get-WmiObject win32_product -filter "Name like 'Dynatrace OneAgent'"
msiexec /x $app.IdentifyingNumber /quiet /l*vx uninstall.log
sudo /opt/dynatrace/oneagent/agent/uninstall.sh See Uninstall on Windows Dynatrace Docs
See Uninstall on Linux Dynatrace Docs

ActiveGate

Command Windows Linux Notes
ActiveGate Gateway Service net stop "Dynatrace Gateway"
net start "Dynatrace Gateway"
net restart "Dynatrace Gateway"
sudo systemctl stop dynatracegateway
sudo systemctl start dynatracegateway
sudo systemctl restart dynatracegateway
See ActiveGate on Windows Dynatrace Docs
See ActiveGate on Linux Dynatrace Docs
ActiveGate Synthetic Service net stop "Dynatrace Synthetic"
net start "Dynatrace Synthetic"
net restart "Dynatrace Synthetic"
sudo systemctl stop vuc
sudo systemctl start vuc
sudo systemctl restart vuc
See ActiveGate on Windows Dynatrace Docs
See ActiveGate on Linux Dynatrace Docs
ActiveGate Extension Service net stop "Dynatrace Extensions Controller"
net start "Dynatrace Extensions Controller"
net restart "Dynatrace Extensions Controller"
sudo systemctl stop extensionsmodule
sudo systemctl start extensionsmodule
sudo systemctl restart extensionsmodule
See ActiveGate on Windows Dynatrace Docs
See ActiveGate on Linux Dynatrace Docs
ActiveGate Logs %PROGRAMDATA%\dynatrace\gateway\log
%PROGRAMDATA%\dynatrace\synthetic\log
%PROGRAMDATA%\dynatrace\remotepluginmodule
/var/log/dynatrace/gateway
/var/log/dynatrace/synthetic
/var/lib/dynatrace/remotepluginmodule
See ActiveGate Directories on Windows Dynatrace Docs
See ActiveGate Directories on Linux Dynatrace Docs
ActiveGate Configuration Files %PROGRAMDATA%\dynatrace\gateway\config /var/lib/dynatrace/gateway/config See ActiveGate Directories on Windows Dynatrace Docs
See ActiveGate Directories on Linux Dynatrace Docs
ActiveGate Binaries %PROGRAMFILES%\dynatrace\gateway
%PROGRAMFILES%\dynatrace\synthetic
%PROGRAMFILES%\dynatrace\remotepluginmodule
/opt/dynatrace/gateway
/opt/dynatrace/synthetic
/opt/dynatrace/remotepluginmodule
See ActiveGate Directories on Windows Dynatrace Docs
See ActiveGate Directories on Linux Dynatrace Docs
ActiveGate Uninstall $app = Get-WmiObject win32_product -filter "Name like 'Dynatrace Gateway'"
msiexec /x $app.IdentifyingNumber /quiet /l*vx uninstall.log
sudo /opt/dynatrace/gateway/uninstall.sh See Dynatrace Docs
ActiveGate Install .\Dynatrace-ActiveGate-Windows.exe
.\Dynatrace-ActiveGate-Windows-x86-1.309.26.exe ENABLE_SYNTHETIC=true
sudo /bin/bash Dynatrace-ActiveGate-Linux.sh
sudo /bin/bash Dynatrace-ActiveGate-Linux-x86-1.309.26.sh --enable-synthetic
Environment ActiveGate on
Windows Dynatrace Docs
Linux Dynatrace Docs
Other Installation Parameters .\Dynatrace-ActiveGate-Windows.exe ENABLE_SYNTHETIC=true ADDITIONAL_CONFIGURATION="--set-property=synthetic=private_location_id=SYNTHETIC_LOCATION-B2AC4DHDBTMINDN" --set-network-zone=[NetWorkZone] --set-group=[GROUP]
sudo /bin/bash Dynatrace-ActiveGate-Linux.sh --enable-synthetic --set-property=synthetic=private_location_id=SYNTHETIC_LOCATION-B2AC4DF31D8G6J89" --set-network-zone=[NetWorkZone] --set-group=[GROUP]
See Dynatrace Docs

Download Installers

Command Windows Linux
OneAgent Latest Version https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/rest/deployment/installer/agent/windows/default/latest?arch=x86&Api-Token=[PASS-TOKEN] https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/rest/deployment/installer/agent/unix/default/latest?arch=x86&Api-Token=[PASS-TOKEN]
OneAgent Specific Version https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/agent/windows/default/version/1.297.63.20240905-133818?arch=x86&Api-Token=[PASS-TOKEN] https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/agent/unix/default/version/1.297.63.20240905-133818?arch=x86&Api-Token=[PASS-TOKEN]
ActiveGate Latest Version https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/windows/latest?arch=x86&Api-Token=[PASS-TOKEN] https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/unix/latest?arch=x86&Api-Token=[PASS-TOKEN]
ActiveGate Specific Version https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/windows/version/1.291.48.20240613-123408?arch=x86&Api-Token=[PASS-TOKEN] https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/unix/version/1.291.48.20240613-123408?arch=x86&Api-Token=[PASS-TOKEN]
Cluster ActiveGate https://tct770.dynatrace-managed.com/psgwinstaller/windows/latest/[TOKEN:Service Provider API] https://tct770.dynatrace-managed.com/psgwinstaller/unix/latest/[TOKEN:Service Provider API]

Download Installer Using Command Line

Command PowerShell Bash
OneAgent Download $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/agent/windows/default/latest?arch=x86' -Headers @{ 'Authorization' = 'Api-Token [Place Token]' } -OutFile 'Dynatrace-OneAgent-Windows.exe' wget -O Dynatrace-OneAgent-Linux.sh "https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/agent/unix/default/latest?arch=x86" --header="Authorization: Api-Token [Place Token]"
curl -O -J -L "https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/agent/unix/default/latest?arch=x86&Api-Token=[Place Token]"
Environment ActiveGate Download $ProgressPreference = 'SilentlyContinue'; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri 'https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/windows/latest?arch=x86' -Headers @{ 'Authorization' = 'Api-Token [Place Token]' } -OutFile 'Dynatrace-ActiveGate-Windows.exe' wget -O Dynatrace-ActiveGate-Linux-x86-1.309.26.sh "https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/unix/latest?arch=x86" --header="Authorization: Api-Token [Place Token]"
curl -O -J -L "https://tct770.dynatrace-managed.com/e/7b31cea0-d5e7-4244-a6da-e681cb69e75a/api/v1/deployment/installer/gateway/unix/latest?arch=x86&Api-Token=[Place Token]"
Cluster ActiveGate Download $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri 'https://tct770.dynatrace-managed.com/psgwinstaller/windows/latest/[TOKEN:Service Provider API]' -OutFile 'Dynatrace-ActiveGate-Windows.exe' wget --secure-protocol=TLSv1_2 -O Dynatrace-ActiveGate-Linux.sh "https://tct770.dynatrace-managed.com/psgwinstaller/unix/latest/[TOKEN:Service Provider API]"
curl -O -J -L "https://tct770.dynatrace-managed.com/psgwinstaller/unix/latest/[TOKEN:Service Provider API]"
Notes Use --secure-protocol=TLSv1 Or, --no-check-certificate with wget in case of ssl error.

Other Commands

Command Windows Linux Notes
McAfee Solidcore Status & 'C:\Program Files\McAfee\Solidcore\sadmin.exe' status /opt/mcafee/solidcore/bin/sadmin status Not tested. May require admin right.
Installed MSI File Location Get-WmiObject win32_product -filter "Name like 'Dynatrace OneAgent'" | Format-Table LocalPackage
Extract/Unpack MSI PS Command
C:\Downloads\Dynatrace-OneAgent-Windows.exe --unpack-msi "C:\installers"