If you want to install a version where major and minor version do not match, for example 2018 October (7.2) on top of 2018 April (7.1), you cannot use the update mechanism. Refer to the Upgrade and migration guide.
The following requirements must be met to successfully install an update:
- Disable virus scanning software the AppMon Server and Client machines.
- Your AppMon user account has certain permissions. See the Required permissions section below.
- You must be able to restart all Servers and Collectors immediately after installing the update.
- A pending restart must not be not currently logged against the Server or any connected Collector. Check Warnings in the Start Center to determine if a pending restart is required.
- You have verified that the update is of a higher version than any previously installed update.
- If you have a private update installed, you must check with support that the update to install contains the fixes of your previously installed private updates. If the update you want to install overwrites the fixes of the active update, the warning message appears, listing the fixes you may lose.
- To successfully install an update on an Agent when performing a controlled update rollout, the Agent must be a supported bootstrap Agent. If an Agent does not meet either of these conditions, the new update does not install and the Agent remains at its current version.
When installing an update on a Server or Collector instance, only the instance updates. The update is not installed on any other Server or Collector instances. If installing an update on an AppMon Server or Collector that is not run as an instance, then any Server/ Collector instances that run on the same system do not update.
The following diagram shows the necessary steps for installing an update.
Your AppMon user account must have the following permissions enabled to install, roll back, or remove an update: Manage Updates, Shutdown or Restart, and Shutdown or Restart Collector. See User Permissions and Authentication for more information.
Download the update from the AppMon product download site. You can also download updates using the Community Portal link on the Updates pane. Extract the contents to local temp folder on the Client machine.
In the AppMon Client click Tools > Manage Updates. The Dynatrace Server Settings dialog box appears and displays the Updates pane.
The AppMon Client must be connected to an AppMon Server to enable the Manage Updates menu command. For the standalone Client, you must first select the AppMon Server on which the update should be installed. For the Webstart Client, the Server from which you started the Webstart Client is the only Server available.
Click Select File and navigate to the
update*.dtf you want to install. Select the file and click Open to add the update file to the Server. Click Next.
You can also open Windows file explorer separately to navigate to and double-click the desired
update*.dtf file to open the wizard with the file already selected.
The Wizard prompts you to verify installing the update. Click OK. The wizard uploads the file for installation and shows the upload progress.
An error message displays if the update is currently is use. If this happens, you must deactivate and re-install the update. See Online license activation and deactivation for more information.
Click Next when the upload completes. The Configure Rollout Action page appears.
Click Complete Install and optionally enter a comment for the install, then click Next. The Rollout Overview page appears.
The update file is automatically added to the server and the rollout action is configured for a complete install. You must apply the change to the AppMon components.
Click Next to apply the changes.
Click Next to synchronize and restart collectors. On the Synchronize and Restart Collections step, click the appropriate button to either Synchronize and restart all Collectors automatically or Select Collectors that should be synchronized and restarted.
If opting to select collectors, the Select Collectors for Restart page appears. Click appropriate check boxes to select the collectors to restart.
Click Next. You can see the progress. Once the collector synchronization process completes,
Click Next at the Restart Server step, then click the appropriate button to either to restart the server now or start it later manually.
If restarting now, the server restart may take several minutes. Remember to restart the server yourself after the install if choosing a manual restart.
Click Next. The bootstrapped Agents to restart display on the Restart Agent tiers page. To update bootstrapped Agents, you must restart the tier that is monitored by the Agent. It may take a few minutes until the first Agents appear in the restart overview. The overview updates every 15 seconds.
Click Finish and Yes when prompted to restart the Client and complete the update installation process.
To selectively install the update on specified Agents, click Controlled Install. For more details, see Controlled Install.
Apply the changes to deploy the update to the Collectors. This step may take a while (especially for large environments).
For the remaining steps in the wizard, choose when to restart the Collectors and Server. If an AppMon Collector is part of a Collector group, you have to restart the whole group, which makes the single Collector unselectable.