Upgrade to AppMon 2018 October

Dynatrace AppMon 2018 October (Dynatrace AppMon 2018 October Release Notes) has been released on 10th October 2018. You can request an upgrade of your environonment by opening a support ticket and by indicating their desired maintenance window.

Upgrade process

The migration of the server components on the AWS instance is performed by Dynatrace, if you have any collectors and agents connected on your own infrastructure then these will need to be updated manually by the customer. The division of responsibilities will be as such:

Dynatrace:

  • Check Environment Health before update
  • Download support archive
  • Generate new license
  • Migrate AppMon Server and Performance Warehouse to newest version
  • Update to the latest public update if it is not available in dropdown
  • Apply newly generated license

Customer:

  • Update clients located on customer infrastructure
  • Update collectors located on customer infrastructure
  • Organize restarts of agents and make a final check

Detailed information about the upgrade can be found in the product documentation: Upgrade and Migration Guide

Dynatrace: Check Environment Health and Download support archive

Before starting the upgrade process, Dynatrace will make a quick assessment on the health of your deployment (including automatic analysis of the support archive).

Dynatrace: Generate new license

New license for 2018 October have to be generated with valid agents number and UEM transaction.

Dynatrace: Migrate to AppMon Server to 2018 October

  • Automatic back-up of the SaaS instance will be triggered
  • The AppMon Cloud instance will be upgraded to 2018 October (see Updates & Configuration for more details on the process)
  • The Performance Warehouse will be migrated to 2018 October
  • The whole process will take ~ 60 min, during which time the SaaS instance will be offline

Dynatrace: Update to the latest public update

If latest version is not available in dropdown then latest public fixpack have to be installed with Webstart Client.

The customer will be notified before starting the upgrade and also after the upgrade. In case of issues, the environment can be restored to the previous version within 30 minutes.

Customer: Update AppMon Collectors to 2018 October

Any collectors that you have installed on your own infrastructure will need to be updated to 2018 October manually. These can be pre-installed in parallel with the 2018 October version as long as they are not switched on before the update of the Server to 2018 October.

Once you have received confirmation that your AppMon SaaS instance has been upgraded to 2018 October, you will need to perform the following steps:

  1. Stop the current collectors
    • You are required to stop your current collectors in order to migrate your current collector settings to the new collectors. Ensure the old collectors are not started automatically with a OS reboot.
      Additional Information: [Starting and Stopping Collectors]/support/doc/appmon/shortlink/id_install_collectors#anchor_start-stop-collector)
  2. File Migration
    • Use the migration tool to migrate your on premise collectors.
    • For a full explanation on how to use the migration tool please view the following page: Migration Tool Details
      Example:
      java -jar dynatrace-migration.jar -migration –sourceDTHome "C:\Program Files\dynaTrace\dynaTrace 6.5"  -targetDTHome "C:\Program Files\dynaTrace\dynaTrace 7.2" -migrateInstances defaultCollector
  3. Start the new collectors
    • Once the new collectors have been brought back up, the agents will reconnect automatically and continue sending data to them.
      Additional Information: Starting and Stopping Collectors

If there are problems with upgrading the collector, a separate support ticket needs to be created. Attach any available collector log or command line output while starting the process.

Customer: Update AppMon Client to 2018 October

Any clients that you have installed on your own infrastructure will need to be updated to AppMon 2018 October manually. These can be pre-installed in parallel with the AppMon 2018 October version. Alternatively you can use the webstart client available on your SaaS server at https://<customerID>.dynatracesaas.com:8021/.

If there are problems with upgrading the client, a separate support ticket needs to be created. Attach any available client log file.

Customer: restart agents

Once your agents are connected to the new collectors, organize to have them restarted, this will allow them to bootstrap to the latest version. For further information, including instructions for agents that require manual updating. Please refer to the following documentation: Agent Upgrades

If there are problems with upgrading the agents, a separate support ticket needs to be created. Any agent log file needs to be attached to this new ticket.

Confirm the operation of the new Dynatrace Server & apply the customization not covered by automation: Final Migration Checks