Free trial

Update OneAgent on Windows

To update DESK OneAgent on windows, follow the instructions below.

For Windows and Linux, we've built an auto-update mechanism into DESK OneAgent so you don't have to worry about manually updating the OneAgents running in your environment.

Automatic updates are turned on by default. You can disable auto-updates either globally for all DESK OneAgent installations or for individual hosts only. With this later option, we won't notify you when instances of DESK OneAgent are outdated. With automatic updates enabled, each time a new version is released, DESK OneAgent automatically downloads all necessary binaries and libraries and installs them for you. No manual configuration is required.

Following DESK OneAgent auto-updates, you must restart all server processes, as some components of DESK OneAgent keep running in processes that are monitored by DESK (for example, Java, .NET, Apache, and IIS). These processes will continue to be monitored with the previous version of DESK OneAgent until they are restarted. Following restart, these processes will be monitored with the latest version of DESK OneAgent.

Auto-update security

OneAgent auto-update mechanism is secure.

  • OneAgent communication is encrypted.
  • OneAgent installers are signed and the signature is verified for each downloaded installer package. If the verification fails, the auto-update attempt is aborted.

Global auto-update across all hosts

To enable DESK OneAgent automatic updates for all your hosts:

  1. Go to Settings > Preferences > OneAgent updates.
  2. Switch on Automatically update all OneAgent instances.

Going forward, whenever a new version of DESK OneAgent becomes available, all your installed instances of DESK OneAgent will automatically download the update and upgrade their binaries and configuration files.

Installation of a specific version of DESK OneAgent on all new hosts

To control which version of DESK OneAgent is automatically installed on all new hosts:

  1. Go to Settings > Preferences > OneAgent updates.
  2. Disable automatic OneAgent updates by setting the Automatically update all OneAgent instances switch to the Off position.
  3. From the drop-down list, select the version of DESK OneAgent that is to be installed on all new hosts.

Note:
The selected DESK OneAgent version is also used for PaaS integrations.

Auto-update for individual hosts

You can override global DESK OneAgent updates for specific hosts via individual host settings.

To control auto-updates for specific hosts:

  1. Go to Settings > Monitoring > Monitoring overview.
  2. Click the Edit button (the pencil icon) of the host you are interested in.
  3. On the Host settings page, click OneAgent updates from the menu on the left. Then you will be able to see the current version of OneAgent running on the specific host.
  4. Switch off Apply Global updates settings for OneAgent updates.
  5. Switch on Update DESK OneAgent on this host automatically.

Note:
Individual host settings override the global auto-update setting.

Manual updates on individual hosts

When a new version of DESK OneAgent becomes available you'll receive an alert on your home dashboard. In addition, warning symbols are displayed on the Monitoring overview page beside each host that contains an outdated version of DESK OneAgent.

To manually update OneAgent running on an individual host:

  1. Go to Settings > Monitoring > Monitoring overview.
  2. Click the Hosts tab.
  3. To update OneAgent or download the latest version, click the Update button next to the name of the host you're interested in.
    Note: The Update button appears only if the installed version of OneAgent on a specific host is outdated and if it is a full-stack OneAgent—this button doesn't appear with PaaS and standalone OneAgents.
  4. Click Update now.
    Note: you need to have permissions to download the installer, otherwise the Update now button is disabled.

Alternatively, you can download the latest version of the OneAgent installer, copy it manually to the target host, and perform installation directly on the target host.

Note:
OneAgent won't automatically update when it's first installed. By default, we wait 1440 minutes (24 hours) before allowing updates on EC2 hosts and 120 minutes on non-EC2 hosts.

How to check the currently installed version of OneAgent

To check which version of OneAgent you have installed

  1. Select Hosts from the navigation menu.
  2. Click the host you are interested in.
  3. Expand Properties under the host's name. The installed version of OneAgent is included in the listed properties.

Alternatively

  1. Select Deployment status from the navigation menu.
  2. Click the All hosts or Recently connected hosts tab.
  3. Expand the host entry you are interested in. The installed version of OneAgent is included in the information that shows up.