Upgrade the Controller Using the Enterprise Console

You can upgrade a Controller instance using the Enterprise Console. The Enterprise Console simplifies the upgrade process by allowing you to discover and upgrade single Controllers and HA-pairs.

About the Upgrade

Note: If your current Controller version is < 21.x, see Upgrade the Controller Using the Enterprise Console.

  • The Enterprise Console supports standalone and HA-pair Controller upgrades. Use the following table to determine your course of action based on your circumstances:

    If your current Controller version is...Controller version you want to upgrade to...Actions to take...
    >= 21.xController version 21.x or the latest version
    1. Upgrade MYSQL to 5.7 version.
    2. Upgrade to the supported OS version. See Controller Compatibility with Operating Systems and Components.
    3. Access the downloads portal to download the Controller version.
    4. Use the Enterprise Console to upgrade the Controller.

  • You can choose which version you would like to upgrade the Controller to as long as the Enterprise Console is aware of that version. This means that you can upgrade the Controller to any intermediate version or to the latest version as long as the Enterprise Console installer has been run for those versions. However, you cannot upgrade the Controller to an older version.

    Note: From Enterprise Console >=23.11, the Controller uses Jetty Application server instead of GlassFish. Therefore, Enterprise Console >=23.11 allows only the Controller upgrade to >= 23.11.x.
  • If you have a license for the older version, the license should work when upgrading the Controller to a new version. However, if you have a temporary license for the old version and now have a new license, the new license will not work on the old Controller. In this case, you should upgrade the Controller to the latest version before applying the license.
  • An upgrade results in Controller downtime, but it is not necessary to stop agents during the Controller upgrade.

  • The Enterprise Console expects a .passwordfile file 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.

    Warning: If you change the Glassfish Admin Password manually, you also need to update it in the Enterprise Console Controller Settings.