Easy Upgrade

Overview

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 Probe servers with the latest software upgrades can also become tedious as the number of Probe servers in your system grow. The Easy Upgrade option helps you upgrade your Probe servers from a centralized dashboard. Easy Upgrade is available in Professional and Enterprise Editions.

Note:

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 Probe servers once the Central Server is upgraded. You can see the running version of each of your Probe Servers from the Central Server.

Note :

While performing upgrades in the Enterprise Edition, remember to upgrade all instances at once.
Easy upgrade option is not applicable for the Applications Manager plugin.

Upgrading the Central 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.

Manual Upgrade for Central Server (Offline)

Alternatively, you can also manually upgrade the Central Server to the latest version of your choice by downloading and upgrading the required service pack (.ppm) file using the Update Manager tool. Learn more

Note:

From v15550, both Central and Probe server should have internet connectivity to use the easy upgrade feature.
From v170900 onwards, the Probe Server no longer requires internet connectivity to use the Easy Upgrade feature. However, the Central Server must still have an active internet connection.

Upgrading your Probe Servers

You can initiate upgrade action for all Probe servers in bulk from the Central Server, once the Central Server is upgraded.

Click on Probe Servers link. This will take you to the Probe Server page from where you can configure the Probe Servers. The Probe Servers table displays running version of each of the Probe servers. The table also displays the syncing , download and upgrade status of the Probe servers.
If the latest complatible version has not been downloaded, you can select the Probe 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 Probe servers that you wish to upgrade and an click the Upgrade Now link. This upgrades the selected Probe 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?

Stop the ManageEngine Applications Manager service from Start → Run → services.msc (For Linux servers execute sh shutdownApplicationsManager.sh command from '<Applications Manager Home>' location).
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).
Go to the '<Applications Manager Home>/working/support' folder and delete all old support files (files with extension as .gz or .zip).
Go to the '<Applications Manager Home>/working/webclient' and delete the 'temp' directory.
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)
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).
Go to the '<Applications Manager Home>/working/heapdump' and delete the contents in that directory.
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).
Take a complete backup of '<Applications Manager Home>' folder. After that close all the explorer & command prompt windows.
If you are using Microsoft SQL server backend, then connect to the corresponding SQL server & take the backup of Applications Manager database.

Was this content helpful?