Easy Upgrade


Applications Manager's Easy Upgrade feature ensures users have access to the latest Applications Manager versions and can automatically upgrade to the latest service packs easily. The complexity of upgrading managed servers with the latest software upgrades can also become tedious as the number of managed servers in your system grow. The Easy Upgrade option helps you upgrade your managed servers from a centralized dashboard. Easy Upgrade is available only in Enterprise Edition.


Before upgrade to the latest service pack, please make sure to take a complete backup of the '<Applications Manager Home>' folder and the Applications Manager database.

To use Easy Upgrade features in your Applications Manager setup, you need to first enable the option in the Settings tab, under Global Settings.

Easy Upgrade in the Enterprise Edition

In the Enterprise Edition, users can upgrade their managed servers once the admin server is upgraded. You can see the running version of each of your Managed Servers from the Admin Server.

Note : While performing upgrades in the Enterprise Edition, remember to upgrade all instances at once.

Upgrading the Admin Server

  • A link to download the latest version of the product will be displayed in the About page along with the latest compatible version.
  • Click Download and the latest Applications Manager PPM will be downloaded into your machine.
  • Once the download is completed, an Upgrade now link appears in the About page near the latest compatible version.
  • Click Upgrade now to upgrade your setup. Applications Manager displays the message "Software Patch Upgrade is initiated. Service will be shutdown shortly. Please reconnect this web console after 15 mins." and begins upgrade.
  • Note: In a Failover setup, Easy Upgrade will be performed on secondary server first. Once the secondary server is upgraded to the latest version, the primary server will perform self-upgrade to the latest version.

Upgrading your Managed Servers

You can initiate upgrade action for all managed servers in bulk from the Admin Server, once the admin server is upgraded.

  • Click on Managed Servers link. This will take you to the Managed Server page from where you can configure the Managed Servers. The Managed Servers table displays running version of each of the managed servers. The table also displays the syncing , download and upgrade status of the managed servers.
  • If the latest complatible version has not been downloaded, you can select the managed server and click Download Now to download the latest compatible version.
  • Note : If the required version patch is already downloaded, then the Upgrade Link will appear. If not, go to <Applications Manager Home>/working/patches/ folder where you can find a folder with the latest build number inside which you can find the latest PPM.

Once the download is completed, Select the checkboxes of the managed servers that you wish to upgrade and an click the Upgrade Now link. This upgrades the selected managed servers to their latest version. The icons used to display the download and upgrade statuses are as follows:

- Download / Upgrade Completed

- Download completed and ready for Upgrade.

- Download / Upgrade in Progress.

How to take backup before upgrade?

  1. Stop the ManageEngine Applications Manager service from Start → Run → services.msc (For Linux servers execute sh shutdownApplicationsManager.sh command from '<Applications Manager Home>' location).
  2. Via command prompt, execute the shutdownApplicationsManager.bat -force command from the '<Applications Manager Home>' folder. (For Linux servers execute sh shutdownApplicationsManager.sh -force command from '<Applications Manager Home>' location).
  3. Go to the '<Applications Manager Home>/working/support' folder and delete all old support files (files with extension as .gz or .zip).
  4. Go to the '<Applications Manager Home>/working/webclient' and delete the 'temp' directory.
  5. Go to the '<Applications Manager Home>' and delete the old logs folders (Example: logs_old or logs_date or logs.zip). Also delete logs folder under '<Applications Manager Home>/working' location. (Do not delete the 'logs' folder as it may be useful if any issues occur post upgrade, delete only old logs folders if present)
  6. Go to the '<Applications Manager Home>/working and delete hs_err_pid<xxxx>.log files & java_pid<xxxx>.hprof files if present (where xxxx can be any process ID).
  7. Go to the '<Applications Manager Home>/working/heapdump' and delete the contents in that directory.
  8. Go to the '<Applications Manager Home>/working/backup' and delete the backups which are older than last one year. (If there is no backup then proceed to next step).
  9. Take a complete backup of '<Applications Manager Home>' folder. After that close all the explorer & command prompt windows.
  10. If you are using Microsoft SQL server backend, then connect to the corresponding SQL server & take the backup of Applications Manager database.