On this page:

Your Rating:
4 rates
The following notes describe 4.5.x updates to the AppDynamics on-premises platform, including the Controller, Events Service, and EUM Server components.

If an artifact has been updated, the version number of the updated artifact and its availability date are listed below. The version number corresponds to that shown on the download portal (http://download.appdynamics.com).

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

4.5.6 Updates

Version – February 11, 2019


Resolved Issues
METADATA-5548Fix class cast exception and break the migration servlet issues
PLATCPS-8508Incorrect license exception message: Not licensed for account
PLATCPS-8848Nullpointer from snapshot when embedded flag is set to false

Enterprise Console

  • 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 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
ECONSOLE-3597Add Hosts should not overwrite remote platform JRE
ECONSOLE-3803Controller upgrade fails with customized keystore passwords
ECONSOLE-3804Controller upgrade fails with customized reporting service keystore password
ECONSOLE-3993Enterprise Console Events Service master count is incorrect
ECONSOLE-4005Upgrading a HA pair fails with incorrect error message when MySQL Controller user password is incorrect
ECONSOLE-4006Free RAM checks fail on Windows

4.5.5 HF4 Updates

Version– January 24, 2019

Resolved Issues

SIM Server health rule in APM app does not evaluate correctly

PLATCPS-9823Security provider type incorrectly updated to INTERNAL for anyone who used token to login to Controller
PLATCPS-9942Support-user login via auth token broke after fixing reporting service


4.5.5 HF3 Updates

Version – January 17, 2019

Resolved Issues

Error Entity lookup service slowness causes AJAX thread saturation


4.5.5 HF2 Updates

Version – January 9, 2019

Resolved Issues
APMPLAT-10490Optimize get getFlowItemIdentifier: BtService provide api-getFlowItemIdentifier(APersistentObject dto)
METADATA-5576ADD::doToDto in Metric browser causes slowness and thread pool saturation
PLATCPS-9298Remove max limit and expiry of security provider cache


4.5.5 HF1 Updates

Version – January 3, 2019

Resolved Issues
PLATCPS-8976Unable to decrypt the Encrypted SAML Response


4.5.4 HF3 Updates

Version – January 3, 2019

Resolved Issues
METADATA-5554ADD::doToDto in Metric browser causes slowness and thread pool saturation
PLATCPS-8976Unable to decrypt the Encrypted SAML Response


4.5.5 Updates

Version – December 21, 2018

Resolved Issues
ECONSOLE-3488Unix socket conflict for Controller when there is a stale /tmp/mysql.sock owned by non-appd user
ECONSOLE-3825Capture correct error message when the Enterprise Console does not find an alias in the keystore
METADATA-5306ADDMetricHierarchyBuilder::getADDForMetricNode needs to be optimized
PLATCPS-7723Database health rules not evaluating with external user who has roles Account Owner(default) and Administrator (default)
PLATCPS-8652Optimize the canViewUser call

4.5.4 HF1 Updates

Version– December 7, 2018

Resolved Issues
ANALYTICS-10049Concurrent upsert requests modify input map
APMPLAT-9773Replace Correlation Analysis in Business Transaction table in the Applications view
MQS-398Avoid swallowing InterruptedException and high contention on Wildcard Match Cache


4.5.4 Updates

Version – November 19, 2018



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
DBMON-4221(4.5.4) Broken compatibility between DB Agent pre-4.3.4 and the Controller post-4.5.2
BRUM-4329Upgrade the MySQL database for the on-prem EUM Server to fix security vulnerability
MQS-348When checking data points limits for a request, rollupDataPoints weren't taking into account
MQS-331Flow Map error caused by a null point exception
PLATCPS-7216LicenseEnforcerResourceImpl.leaseInternal() returns exception message for RuntimeException
PLATCPS-7805Error generating Signed SAML requests

Enterprise Console 

  • 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 – 11/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 HF3 Updates

Version– November 12, 2018

Resolved Issues
APMPLAT-9772Add a Pearson Coefficient to the Business Transactions table in the Applications view
DBMON-4222Compatibility between DB Agent pre-4.3.4 and Controller post-4.5.2 is broken
ECONSOLE-39694.5.2.next mds_license.enterprise_license is missing in passive Controller


4.5.2 HF2 Updates

Version– November 9, 2018

Resolved Issues
ECONSOLE3890Controller entry is left out in the controller service page if the controller install failed in between.
ECONSOLE-39014.5.2.next properties with multiple entries in db.cnf are not preserved during upgrade
ANALYTICS93224.5.2 Data Collector: Error message while editing HTTP Data Collectors


4.5.2 HF1 Updates

Version– October 19, 2018

Resolved Issues
ECONSOLE-3848Error PA's upgrade_schema task during controller upgrade on a split pair
PLATCPS-5863Expired PRO trial does not get downgraded to LITE


4.5.2 Updates

Version – October 15, 2018


Resolved Issues
APMPLAT-8883Not able to create applications and register new nodes after upgrade to 4.5.1 at On-Premise Controller
METADATA‑4921RBAC not working on Upgrade 4.2 to 4.5

Enterprise Console

Resolved Issues
ECONSOLE‑3195Adding modifying listeners with SSL parameters fails
ECONSOLE-3215Customizations in services-config.xml are not retained after upgrade
ECONSOLE-3325Modifying Controller app server config with services stopped launches app server, but not database
ECONSOLE-3419Enterprise Console is not in sync with Controller HA states
ECONSOLE-3467Enterprise Console UI does not show replication status when both controllers are active/primary
ECONSOLE-3475Final replication stops mysql on primary before it checks if all files to be replicated are owned by AppDynamics user
ECONSOLE-3516Installing Enterprise Console fails when HTTPS is enable on CentOS 6.7
ECONSOLE-3520Events Service installation dialog does not pre-populate port or path fields
ECONSOLE-3554"mysql_upgrade" job does not check for the presence of libnuma before running
ECONSOLE-3578Enterprise Console upgrade discards db/.rootpw.obf
ECONSOLE-3581Enterprise Console corrupts MySQL during upgrade if mysql.user has single user user='root' row
ECONSOLE-3624Enterprise Console HA manual failover does not wait for MySQL replication logs to be applied on secondary
ECONSOLE-3644Enterprise Console key sync job does not run post Events Service discovery
ECONSOLE-3660Stopping and Starting an HA Controller creates passive running Appserver
ECONSOLE-3664Fix for NUMA configurations issues with the Enterprise Console
ECONSOLE-3698Enterprise Console is unable to query the state of process running state when symlinks are created

Version – October 15, 2018

EUM Server

Resolved Issues
MRUM-3514Error updating crash group name because the name is too long for an SQL column

4.5.1 HF8 Updates

Version– October 9, 2018

Resolved Issues
ANALYTICS9205Leader election is broken for on-prem, causing rollover, compaction to never run
ECONSOLE-3773Include new pruner code from legacy HA toolkit replicate.sh in Enterprise Console


4.5.1 HF7 Updates

Version– October 8, 2018

Resolved Issues
APMPLAT-8764Not able to create applications, register nodes after upgrade to 4.5.1


4.5.1 HF6 Updates

Version– September 26, 2018

Resolved Issues
MQS-206Performance improvements for memory pressure concerning MetricConfigMapStore


4.5.1 HF5 Updates

Version – September 20, 2018

Resolved Issues
ECONSOLE-3565Enterprise Console fails to safely handle a failover triggered while the active host is offline
ECONSOLE-3731Replication status is incorrect under the UI
ECONSOLE-3732Stopping and starting a Controller in HA creates a passive running Appserver
ECONSOLE-3741Enterprise Console HA manual failover does not wait for MySQL replication logs to be fully applied on secondary
ECONSOLE-3744Enterprise Console is unable to query the state of process running state when symlinks are created

4.5.1 HF4 Updates

Version – September 19, 2018

Resolved Issues
METADATA-5161Metric Data Caching infrastructure support for full MySQL Singed Integer entity ID
PLATCPS-7122DIS Controller Cache Publish improvements

4.5.1 HF3 Updates

Version – September 18, 2018

Resolved Issues
APMPLAT-8391root@System user is not able to enable transaction config 2.0
DASH-2953Shared dashboard link redirects to broken login page after upgrading to 4.5.1
EUMIOT-993Query improvement for IoT Error Event UI page
EUMIOT-994Query improvement for IoT Network Request page
EUMUI-1883Query improvement for Mobile Network Requests, Crashes, and Code Issues

4.5.0 HF7 Updates

Version – September 12, 2018

Resolved Issues
ECONSOLE-3654Upgrade failure to 4.5.0: Enterprise Console created a temp directory on its host without write permissions

4.5.1 HF2 Updates

Version – September 11, 2018

Resolved Issues
BRUM-4229EUM Client used to download EUM metrics is not using the proxy settings

4.5.1 HF1 Updates

Version – September 11, 2018

Resolved Issues
METADATA-5038Dashboard reports do not work after upgrade due to OAuth changes

4.5.1 Updates

Version – September 5, 2018 

Enterprise Console / Events Service

  • 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.


Resolved Issues
METADATA‑4194User with Configure Transaction Detection permission is unable to update or delete a Scope
METADATA-4666Slow permission check when filtering dashboards when calls initiated from DashboardManagerBean.getAllDashboardSummaries
METADATA-4808Controller upgrade failure due to lack of permission to execute create_default_roles
METADATA-4907Unable to create API Client due to failed permission check on create of Entity
METRICSVC‑2045Modify baseline calculation based on passed timezone instead of UTC
PLATCPS-5766SAML requests are getting encoded

Enterprise Console

Resolved Issues
ECONSOLE‑1993Discover/upgrade fails when http port (8090) is disabled on Controller
ECONSOLE-3073Events Service install fails with exit code 127 through Enterprise Console
ECONSOLE-3097Enterprise Console takes longer than HA Auto Failover Interval to trigger a failover
ECONSOLE-3140HA failure job keeps triggering after upgrading the Enterprise Console from 4.4.x to 4.4.3 HF build
ECONSOLE-3196Enterprise Console UI fails - Retry button for Job or Discover Controller screen is inoperable
ECONSOLE-3205'platform-admin.sh update-certificate -h' help output fails to define acceptable input file formats
ECONSOLE-3213Enterprise Console Events Service Installer doesn't respect windows directory structure (backslashes)
ECONSOLE-3220Secondary MySQL does not start due to space ID collisions
ECONSOLE-3265Enterprise Console upgrade from 4.4.2 to 4.4.3 for Windows Controller failed
ECONSOLE-3270Enterprise Console is unable to remove stanzas from a domain network listener configuration
ECONSOLE-3274Controller stop operation fails when service is in STOP_PENDING
ECONSOLE-3279Enterprise Console should validate all Controller passwords before upgrading
ECONSOLE-3313controller.sh does not work with long Controller home path prefixes
ECONSOLE-3326Enterprise Console upgrade fails when correct passwords are provided on the second time
ECONSOLE-3357bin/controller.sh stop-events-service does not work
ECONSOLE-3372Add secondary fails when primary Controller was previously part of an HA pair
ECONSOLE-3465Fix to prevent HA pair upgrade if both Controllers are in a primary state prior to the upgrade
ECONSOLE-3470Incremental replicate susceptible to space ID collisions when running on older Linuxes
ECONSOLE-3473Controller Upgrade from 4.4.3 to 4.5.1 fails for new versions of Ubuntu due to undocumented dependency on tzdata package
ECONSOLE-3350Adding secondary controller fails if the External URL is same as the Controller URL
ECONSOLE-3508Controller upgrade to 4.5 requires massive amounts of free disk

4.5.0 HF6 Updates

Version – August 30, 2018

Resolved Issues
METADATA-5071Missing upgrade logic for AccountEntity in mds_configuration.entity_relationship

4.5.0 HF4 Updates

Version – August 20, 2018

Resolved Issues
ANALYTICS‑8575Add template parameters back into events-service-api-store.properties.j2
ECONSOLE-3601Free disk space improvements when upgrading a Controller to 4.5

4.5.0 HF3 Updates

Version – August 16, 2018

Resolved Issues
PLATCPS‑6378Migrate SAM licenses to default license rule on Controller upgrade in order to access SAM monitoring
PLATUI-1209Query Parameter is included in the URL for SAML

4.5.0 HF2 Updates

Version – August 8, 2018

Resolved Issues
BRUM-4085Controller is unable to download metrics using proxy

4.5.0 HF1 Updates

Version – July 19, 2018

Resolved Issues
DBMON-33714.5 Controller installation fails without Internet access 
ECONSOLE-3417"add_secondary" job fails when primary controller was previously part of a High Availability pair 
ECONSOLE‑3486High Availability – Incremental Replication is still susceptible to space ID collisions when running on older Linux platforms 
METADATA-4827Controller installation/upgrade fails at MDS schema upgrade 
PLATCPS‑4555Agent availability status constantly changes due to metric cache
SYNTH-3558Synthetic functionality is unavailable due to license-check error on accounts with EUM enabled 

4.5.0 Updates

July 11, 2018


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 '', 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.

The tzdata package is also required by the MySQL connector.

Resolved Issues

ECONSOLE-1529Windows Controller installation fails when special characters are used in controller admin password
ECONSOLE-1923Enterprise Console UI does not show where to upgrade an existing Controller
ECONSOLE-1924Enterprise Console upgrade procedure shows Install instead of Upgrade at the bottom
ECONSOLE-1951Service name is not displayed in the error message when the Windows service registration fails
ECONSOLE-1978Enterprise Console startup script should unset CDPATH
ECONSOLE-1992Enterprise Console does not back up configuration files when any configuration is updated
ECONSOLE-2068Internal app agent does not report to internal monitoring Controller automatically after Controller installation on Windows
ECONSOLE-2087Enterprise Console should check available disk space before taking controller backup
ECONSOLE-2563Verify SSH connection fails due to incorrect SSH setup
ECONSOLE-2608Upgrading MySQL task does not update the database version correctly if the job fails halfway
ECONSOLE-2656Enterprise Console fails on SuSE

Enable edit of platform path within Enterprise Console UI

ECONSOLE-2712orcha-modules.log contains no dates
ECONSOLE-2796Misleading Enterprise Console error message in platform-admin-server.log - attempted to reach unknown host
ECONSOLE‑2806db/lib backup does not cope well with Linux symbolic links
ECONSOLE-2851Add current Linux effective user name to rsync/ssh UI error messages
ECONSOLE-2936Intermittent HA primary Glassfish availability leads to two active controllers running
ECONSOLE-2938Glassfish server.log file size reduced by 60%
ECONSOLE-3220Secondary MySQL does not start due to space ID collisions
ECONSOLE-3238Failover Job does not trigger

Controller stop operation fails when service is in STOP_PENDING

METADATA-1843User login exception when using old password format
METADATA-2198Description of audit.log.file.size property in admin.jsp does not mention units
METADATA‑3606Controller startup failure due to login audit failure in 4.4.1
METADATA-4242Upgrade fails if dropping mds database fails in execute setup.xml ant tasks

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.