How do I get started with upgrading EUM servers, agents, and SDKs?

[Nina.Wolinsky]

To make sure you complete all the tasks necessary for upgrading your Dynamic Language Agents after a release, we recommend following the instructions below.

NOTE: The information in this article is not release-specific. You can reference it for any release

Table of Contents

• Prepare to upgrade your EUM servers, agents and SDKs
• Planning your EUM Server, Agent, and SDK upgrades 
  
  • Plan your on-premises EUM server upgrade
  • Plan your EUM agents and SDK upgrades
• How to upgrade your EUM Server, Agent, and SDK
  • How do I upgrade my on-premises EUM Server?  
  • How do I upgrade EUM Agents and SDKs? 
• Additional Resources

Prepare to upgrade your EUM servers, agents and SDKs

1. Review the Product Announcements and Alerts page for details on any intermediate versions between the current version of your instance and the version you are targeting.
   
   

2. Review the compatibility matrix in our Community and documentation for various components of the AppDynamics environment.
   
   
3. Review our EUM component compatibility article for details specific to EUM.
   
   
4. Review the Mobile Agent Version and Deployment Support Matrix to determine the minimum versions of the Controller and EUM Server required for supporting the latest features of the Mobile Agents.
   
   
5. For platforms where the Controller, EUM Server, and Events Service are being upgraded at the same time, the Controller version should be less than or equal to (<=) the Events Service version and you should perform the upgrades in a specific order.
   
   See the Upgrade Platform Components documentation for details on the upgrade order. For example, the Events Service should be upgraded before the EUM server. This documentation also instructions for upgrading the Events Service.

Planning your upgrades

Considerations for upgrading an on-premises EUM Server and EUM Agent and SDK are different. See each below.

Plan your on-premises EUM Server upgrade

• The EUM Server version should be less than or equal to (<=) the Events Service version
  
  
• Ensure the key matches between the Events Service, EUM Server, and Controller:
  analytics.accountAccessKey == ad.accountmanager.key.eum ==appdynamics.es.eum.key

  
  For instructions on configuring EUM connection settings, see: Connect to the Events Service
  
  

• See Upgrade the Production EUM Server for step-by-step instructions. In addition to upgrading your server, you will need to follow the instructions on migrating your EUM data.
  
  For the v4.5 production EUM Server, the EUM MySQL database has been moved from the Controller host machine to the EUM Server host machine.
  

• After upgrading your EUM Server, you can upgrade your Controller following the steps outlined in Upgrade the Controller using the Enterprise Console.

Plan your EUM agent and SDK upgrades

• Before upgrading EUM Servers, Agents and SDKs, review the following:
  • Product Announcements and Alerts page for details on any intermediate versions between the current version of your instance and the version you are targeting.
    
    
  • for various components of the AppDynamics environment, review the compatibility matrix in the Knowledge Base article How does EUM component compatibility work?, as well as the About Agent and Controller Compatibility section in the  Agent and Controller documentation.
    
    
  • Review our EUM component compatibility article for details specific to EUM.
    
    
  • Review the Mobile Agent Version and Deployment Support Matrix to determine the minimum versions of the Controller and EUM Server required for supporting the latest features of the Mobile Agents for various components of the AppDynamics environment.

• For platforms where the Controller, EUM Server, and Events Service are being upgraded at the same time, the Controller version should be lesser than or equal to (<=) the Events Service version.
  
  
• You must perform the upgrades in a specific order. For example, be sure to upgrade the Events Service before the EUM Server.  See Upgrade Platform Components for details on the upgrade order. 
  

How to upgrade your EUM Server, Agent, and SDK

See below for the considerations for upgrading your on-premises EUM Server, EUM Agent and SDK.

How do I upgrade my on-premises EUM Server?

• The EUM Server version should be less than or equal to (<=) the Events Service version
  
  
• Ensure the key matches between the Events Service, EUM Server, and Controller:
  analytics.accountAccessKey == ad.accountmanager.key.eum ==appdynamics.es.eum.key
  
  For instructions on configuring EUM connection settings, see: Connect to the Events Service
  
  
• See Upgrade the Production EUM Server for step-by-step instructions. In addition to upgrading your server, you will need to follow the instructions on migrating your EUM data.
  
  For the 4.5 production EUM Server, the EUM MySQL database has been moved from the Controller host machine to the EUM Server host machine.
  

• After upgrading your EUM Server, you can upgrade your Controller following the steps outlined in Upgrade the Controller using the Enterprise Console.

How do I upgrade EUM Agents and SDKs?

1. Upgrade the JavaScript Agent

Note: If you are a 4.4 SaaS customer and have an EUM license, we recommend upgrading to the latest JavaScript Agent. See Upgrade the JavaScript Agent.

2. Upgrade the Mobile Agents
• See Upgrade iOS SDK for step-by-step instructions on upgrading manually or using CocoaPods.
• See Upgrade the Android Mobile Agent for step-by-step instructions on upgrading the Android SDK in your app.
• See Upgrade the Xamarin Agent for step-by-step instructions on upgrading the Xamarin Agent package in your app.
  
  
3. Upgrade the IoT SDKs
• See Upgrade the IoT C++ SDK for step-by-step instructions.
• See Upgrade the IoT Java SDK for step-by-step instructions.

Additional Resources

Instructions for upgrading other AppDynamics components are available in our general article, How do I get started with upgrading my AppDynamics components?