4.5.x AppDynamics On-premises Platform Notes

This page lists updates to the AppDynamics on-premises platform in the 4.5.x release, including the Controller, Events Service, and EUM Server components. 

When artifacts are updated, the version number and availability date are listed below. Version numbers are also shown in the AppDynamics Downloads Portal.

The most recent releases appear at the top of the page.

4.5.17 Updates 

Version 4.5.17.21652 – January 29, 2020

Enhancements 

Enterprise Console and Controller

• The latest AppDynamics release now bundles MySQL version 5.7.28 with the Controller.
• Using the Enterprise Console UI or the CLI, you can now upgrade the HA Modules without having to upgrade the Controller.
• The Controller and Enterprise Console package has been upgraded to include the JRE 1.8.0_231 version.
• The HA Module now supports MySQL5.7 parallel replication. You can enable database parallel replication from the Enterprise Console UI or from the CLI.
• To provide parallelization with the UI to set the number of parallel rsync threads, a new optional argument, numberThreadForRsync, has been added to the --job incremental-replication and --job finalize-replication CLI commands.
• For customers who are on an older Controller version earlier than version 4.3.8, to upgrade to version 4.5.17, you must first upgrade your Controller(s) to version 4.3.8, then from version 4.3.8 to version 4.4.3, and then subsequently upgrade to version 4.5.17.

4.5.15 Updates 

Version 4.5.2.20560 – November 1, 2019

Enhancements 

Enterprise Console

• The Enterprise Console includes an updated version of the init scripts that are part of the High Availability (HA) Module to automatically restart the Controller and MySQL services when the machine reboots. 
• Enterprise Console provides a new Controller HA Upgrade wizard for upgrading your HA Controller pair (primary and secondary Controllers). The wizard isolates the secondary Controller that serves as a backup and provides a quick reversion path in the event you encounter issues during the upgrade. This requires that you migrate both your primary and secondary Controllers into the Enterprise Console. In past versions, you were only able to upgrade HA Controller pairs from the command line.

4.5.14 Updates

Version 4.5.14.20848 – October 11, 2019

Enterprise Console

Enhancements

This version of Enterprise Console (EConsole) provides significant enhancements to the High Availability (HA) management functionality previously available. In this version of EConsole, the HA Toolkit has been integrated into EConsole via the HA Module that EConsole installs onto the HA Controller cluster. The HA Module manages high availability functionality such as replication and failover even if EConsole is not running or is otherwise unavailable. For more information, see Migrate to the New HA Module Using Enterprise Console.

4.5.13 Updates

Version 4.5.13.1289 – September 6, 2019

Synthetic Private Agent

Enhancements

You can change the administration port for Synthetic Private Agent through the adminConnectors field in the appdynamics/synthetic-agent/synthetic-driver/conf/synthetic-driver.yml file. This enables you to avoid port collision with the default port 8081.

Resolved Issues

Version 4.5.13.29096 – August 26, 2019

Synthetic Server

Enhancements

The AppDynamics Platform now supports Synthetic Hosted Agents with the Synthetic Server for dispatching synthetic jobs, collecting the measurement results, and reporting those results to the EUM Server. To deploy the Synthetic Hosted Agents and Server, you need to deploy the EUM Server. See Synthetic Server Deployment for more information.

Resolved Issues

4.5.12 Updates

Version 4.5.12.20340 – July 31, 2019

Enhancements

• As an AppDynamics administrator, you can now customize the permissions for various roles to include permission to cross-launch a connection issue in Cisco APIC Controller. See Set Custom Permission to Cross-Launch Cisco APIC Controller for more information.

4.5.11 Updates 

Version 4.5.11.20318 – July 08, 2019

Enterprise Console

Enhancements

• When upgrading the Controller on AWS, you no longer have to specify the domain name of the Aurora database when running the job discover_upgrade or upgrade. The job will use the domain host to the Aurora Database specified in domain.xml.

• To prevent failed Controller upgrades because of customized keystore passwords for the reporting-instance artifact used by the Reporting Service, the Enterprise Console no longer allows you to change the password for the reporting-service.pfx file. 

Known Issues

The upgrade to Controller 4.5.11 will fail if the MySQL root user password for your Controller contains either a single quote ('), a double-quote ("), or the "@" symbol. If the MySQL root user password contains one of these special characters, you can upgrade the Controller to 4.5.11 by first resetting the root user password and then upgrading. 

Resolved Issues

Version 4.5.11.28578 – July 08, 2019

EUM Server

Resolved Issues

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

4.5.11 (Synthetic Agent) Updates

Version 4.5.11.28455 – June 19, 2019

Enhancements

• Firefox was upgraded from version 61 to version 66.
• You can now install the Synthetic Private Agent in any directory.
• ChromeDriver was upgraded from version 2.35 to version 2.37.

4.5.10 Updates 

Version 4.5.10.28177 – June 21, 2019

EUM Server

Resolved Issues

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

4.5.9 Updates

Version 4.5.9.19152 – April 22, 2019

Controller

Resolved Issues

Events Service

Resolved Issues

EUM Server

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

4.5.8 Updates

Version 4.5.8 – March 28, 2019

Controller

Resolved Issues

EUM Server

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

4.5.7 Updates

Version 4.5.7.17784 – February 25, 2019

Controller

Resolved Issues

Enterprise Console

Resolved Issues

EUM Server

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

4.5.6 Updates

Version 4.5.6.17299 – February 11, 2019

Controller

Resolved Issues

EUM Server

Resolved Issues

Known Issues

If you are using SSL with the EUM Server, you should downgrade the version of the JRE bundled with the EUM Server to 1.8.0_152 to avoid performance issues.

Enterprise Console

Enhancements

• The new phased upgrade feature allows you to retain the HA roles of the Controllers, so that the primary and secondary roles do not switch after an upgrade. After first upgrading the primary, you can verify the upgrade before proceeding with the secondary upgrade. This allows you to quickly restore the older deployment version and service from the preserved secondary in the case of any issues. See Upgrade an HA Pair for more information.

Resolved Issues

4.5.5 Updates

Version 4.5.5.16412 – December 21, 2018

Resolved Issues

4.5.4 Updates

Version 4.5.4.15417 – November 19, 2018

Controller

Enhancements

Your Controller MySQL 5.7 will be upgraded to the latest minor version to avoid MySQL DoS Vulnerability CVEs. If you are on MySQL 5.5, it is recommended that you upgrade to version 5.7.

Resolved Issues

Enterprise Console 

Enhancements

• You can configure the SSL protocol channel. To do so, select "Enable mixed SSL channel" on Enterprise Console Appserver Configurations UI. See Configure SSL Termination at the Reverse Proxy for more information.
  
• After a fresh installation or upgrade, the DB Controller password is now hidden in domain.xml as an alias.

Known Issues

• For Enterprise Console version 4.5.3, you are not able to update the Controller user DB password for HA pairs using either the UI or CLI. The job will fail while updating the alias in Glassfish for the secondary Controller.
• You may run into UI issues, such as unavailable components after you upgrade the Enterprise Console due to the browser caching older UI assets. This is due to unversioned Enterprise Console UI artifacts and their JavaScript files. To workaround this issue:
  1. Delete the following browser data:
     • Cached images and files
     • Hosted app data
  2. Install the Enterprise Console 4.4.3.x.
  3. Add a Controller host.
  4. Install the Controller.
  5. Remove the Controller.
  6. Upgrade Enterprise Console to the latest 4.5.x version.
  7. Attempt to install the Controller.
     The Controller installation dialog will only contain Cancel and Submit buttons.
  8. Delete the following browser data:
     • Cached images and files
     • Hosted app data
  9. Attempt again to install the Controller.
     The Controller installation dialog will contain all of the expected fields, drop-down menus, and buttons.

Version 4.5.4.25740 – November 2, 2018

On-Premises Synthetic Server

The on-premises AppDynamics Platform now offers the on-premises Synthetic Server for dispatching synthetic jobs, collecting the measurement results, and reporting those results to the EUM Server. To deploy the on-premises Synthetic Server, you need to deploy the on-premises EUM Server and install the Synthetic Private Agent Deployment. See Synthetic Server Deployment for more information.

4.5.2 Updates

Version 4.5.2.14478 – October 15, 2018

Controller

Resolved Issues

Enterprise Console

Resolved Issues

Version 4.5.2.25039 – October 15, 2018

EUM Server

Resolved Issues

4.5.1 Updates

Version 4.5.1.12922 – September 5, 2018 

Enterprise Console / Events Service

Enhancements

• When using the Enterprise Console to install the Events Service on a Windows host, you can specify an Events Service directory path that includes use either forward slashes (/) or backslashes (\). You can also choose to not specify a path.
• The controller.sh start-events-service and stop-events-service commands are no longer valid. You must use the Enterprise Console commands platform-admin.sh start-events-service and stop-events-service instead.

Known Issues

• Upgrading the Controller may fail when using customized keystore and truststore passwords. Customized passwords and CA-signed certificates are not retained after a failed upgrade.

Controller

Resolved Issues

Enterprise Console

4.5.0 Updates

Version 4.5.0.17318 – July 11, 2018

Enhancements

Controller / Events Service

• The JRE of the Controller and Events Service has been upgraded to version 8u162.

Enterprise Console

• There is support for major-version upgrades for the Enterprise Console application. This means you can install, upgrade, and manage multiple versions of Controllers and Event Services.
  You can choose which version you would like to install/upgrade the Controller/Events Service to as long as the Enterprise Console is aware of that version. This means that you can upgrade the components to any intermediate version or to the latest version as long as the Enterprise Console installer has been run for those versions.

• Starting in 4.5, during a Controller discover and upgrade scenario, the Enterprise Console expects a .passwordfile to be present in the Controller home directory. The Enterprise Console reads this password and validates it against the Controller. Once the upgrade is complete, the Enterprise Console removes the file, and stores the password in its encrypted database.
  Note: If you change the Glassfish Admin Password manually, you also need to update it in the Enterprise Console Controller Settings.

• The Enterprise Console installer now uses version 6 of i4j. This resolves issues with warnings seen when installing in console mode.

• When adding the Enterprise Console host machine, you should stop using the alias, 'platformadmin', and instead start using the following:

  • On the CLI, you should use 'localhost', the loopback address '127.0.0.1', or the machine's actual hostname.
  • From the UI, you should use the Add Enterprise Console Host button, which will automatically populate the text field with the hostname of the Enterprise Console machine.
• You can edit credentials from Custom Installation.
• You can manage your Controller SSL certificate on the Enterprise Console UI under Configurations.
• The Enterprise Console CLI commands now consistently use hyphens (-) instead of underscores (_). For example, the job discover_upgrade is now discover-upgrade.
• The Enterprise Console supports up to 20 platforms at a time by default.

Upgrade Notes

Ubuntu version 16 and higher requires the tzdata package in order to install the 4.5 Enterprise Console and Controller.

Resolved Issues

Known Issues

Controller audit reports do not work immediately after upgrading the controller to 4.5. Audit table migration messages are logged in the server.log file when audit reports are run before completing the audit database table migration process. Try running the audit reports again at least an hour after the upgrade.