Install OneAgent on Windows

This page describes how to download and install Dynatrace OneAgent on Windows.

Then continue with the installation steps below.

Requirements and prerequisites

  • You need administrator rights for the servers where OneAgent will be installed as well as for changing firewall settings (necessary only if your internal routing policy may prevent Dynatrace software from reaching the Internet).
  • You need permissions and credentials for restarting all your application services.
  • You need to check also the disk space requirements.
  • The host on which you install OneAgent needs at least 200 MB RAM.
  • OneAgent installation isn't supported on networked storage mount points that are managed by standards such as NFS or iSCSI.
  • All hosts that are to be monitored need to be able to send data to the Dynatrace cluster. Depending on whether your Dynatrace deployment is on SaaS, or on Managed environment, and on your network layout and security settings, you may choose to either provide a direct access to Dynatrace cluster, or to set up an ActiveGate.
  • We recommend that you uninstall any existing WinPcap driver to allow Npcap installation—do this on all Windows versions, except for Windows Server 2019 build 1809 without hotfix KB4571748.

Uninstall WinPcap driver to allow Npcap installation

If you have the WinPcap driver installed, we recommend that you remove it prior to OneAgent installation and let the OneAgent installer install the appropriate packet capture driver, as packaged with the OneAgent installer: Npcap is the recommended packet capture driver for OneAgent, except for one special case—see note about Windows Server 2019 below. You need to manually remove WinPcap, since OneAgent installer—with default options—will not automatically replace it with Npcap.

To install the recommended packet capture driver, use the default packet capture driver option, when installing OneAgent (auto), or do not specify any packet capture driver options: With these settings, OneAgent installer will install Npcap (or WinPcap if appropriate), unless Npcap or WinPcap is already installed on the system.

OneAgent can also work with existing Npcap installations.

Npcap is the successor of WinPcap and it is best suited for Dynatrace network analysis. The Npcap driver provided with the OneAgent installer is packaged in such a way that its DLLs library files are seamlessly integrated with Dynatrace software, enabling unattended updates.

Windows Server 2019:
OneAgent installer will, by default, install Npcap, except for Windows Server 2019 build 1809 without hotfix KB4571748, where, for compatibility reasons, WinPcap will be installed.

Re-installation or repair of installation

OneAgent installer for Windows doesn't support the modify and repair operations. You can't reinstall OneAgent using the same installer version as was used to install the currently installed OneAgent. To reinstall OneAgent, uninstall it first or simply install a newer version.

Installation

In the Dynatrace menu, select Deploy Dynatrace.

Click the Start installation button and select Windows.

Provide a PaaS token. The token is required to download OneAgent installer from your environment. If you don't have a PaaS token, you can generate one right in the UI. The token is automatically appended to the download command you'll use later.

Download the installer. There are two options:

  • Select Download OneAgent installer to download the installer for Windows (EXE file) for single-server installation.
  • Download via Windows Command Prompt. Copy and run the command. Note: this command will only work with PowerShell 3.0 and TLS 1.2 (or .later)

optional Customize your installation
At this point, the Dynatrace UI allows you to customize your OneAgent installation: You can specify a number of customizations interactively on-screen. Based on your entries, an installation command will be generated and displayed, for use in the next step of installation (see below).
You can:

  • Set a network zone for this host.
  • Organize your hosts into host groups, if your environment is segmented (for example, into development and production).
  • Override automatically detected host name. This is useful in large and dynamic environments, where defined host names can be unintuitive or can change frequently.
  • Apply tags to the host to organize your monitored environments in a meaningful way.
  • Enable Infrastructure Monitoring in place of Full-Stack Monitoring.
  • Disable Log Monitoring.

If further customizations are required, you can specify additional options on the command line.

If you have not specified any custom options, simply run the executable file and follow the instructions as displayed. If you have specified custom options above, use the generated command, and run it from the download directory. The command will contain all the installation parameters reflecting the custom settings you have specified.

Restart all processes that you want to monitor. You’ll be prompted with a list of the processes that need to be restarted. Note that you can restart your processes at any time, even during your organization’s next planned maintenance period. Though until all processes have been restarted, you’ll only see a limited set of metrics, for example CPU or memory consumption.

You've arrived!

Great, setup is complete! You can now take a look around your new monitoring environment. If you are a SaaS customer, you can access your monitoring environment anytime by going to Dynatrace website and clicking the Login button in the upper-right corner. If you are a Dynatrace Managed customer, you can access your monitoring environment through the Cluster Management Console.

Arrived

One last thing: to monitor your processes, you need to restart them. At any time, you can check which processes aren't monitored and need to be restarted. Just select Deployment status from the navigation menu, click the All hosts or Recently connected hosts tab, and expand the host you are interested in.