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 grows. 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 upgrading 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.
- The easy upgrade option does not apply to the Applications Manager plugin.
Upgrading the Central Server
- A link to download the latest version of the product will be displayed on 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 shut down shortly. Please reconnect this web console after 15 mins." and begins the upgrade.
Note: In a Failover setup, Easy Upgrade will be performed on the secondary server first. Once the secondary server is upgraded to the latest version, the primary server will perform a 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 the Central and Probe servers 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 an 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 compatible 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 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 the logs folder under the '< 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 one year. (If there is no backup, then proceed to the 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 a backup of the Applications Manager database.
