Update Manager

The Update Manager is a tool which is used for installing the service packs (.ppm file) over a product. The service pack may contain certain bug fixes and new feature additions for a particular release version of the product. The service pack can be classified to be either an ordinary without referring to any context of the product (Non - Context based) or it may be context based. This document explains about how to use the Update manager for installation of Software upgrades in ManageEngine products. It can be also used by products developed over these products.

Context based patch implies that the patch will have the consolidated upgrades for all the different components of the same product. For example  WebNMS FE & WebNMS Client are different contexts of the product WebNMS. The same patch can be used for updating any context of the product. The Update manager also provides a feature for having Mandatory context and Optional contexts. The Mandatory context can also be called compulsary context and will not be displayed at the time of installation. An Optional context is some additional upgrades, but is not absolutely necessary for the product to function.

The Update Manager also has some useful validation incorporated. This validation includes compatability checks. If a service pack is not compatable ie., service pack of one product is installed in other product , or service pack of one product version installed in other version , then update manager will not allow the user to install these types of service packs.

To open the Update Manager tool run the "UpdateManager.bat/sh" file present in the <product home>/bin directory.  The Update manager UI lists the different versions of  service pack installed for this product. The details of each of the service packs can be viewed by selecting the corresponding item in the list and clicking the details button.

The Update manager can be operated in two modes ie., UI and non-UI mode. For starting the update manager in command line or non-UI mode, there are two ways.

  1. Run the UpdateManager.bat/sh file with -c as a command line argument.
  2. The user has to edit the script file ie., UpdateManager.bat or UpdateManager.sh depending on the OS. The change required is very simple, just an addition of one more argument -c (%JAVA_HOME%\bin\java -Xmx100m com.adventnet.tools.update.installer.UpdateManager  -u conf -c).

Update Manger UI

The main features of the Update Manager UI are:

To install the service pack.

During the installation of a patch, the corresponding files related to bug fixes are updated inside the product installation directory according to the respective file locations.

The tool will intimate the user on completion of the installation process.

To view Installed Service pack details

The installed service packs are listed in the main window of the Update manager.

To Uninstall a service pack

To uninstall the service pack:

Update Manager in Command line

The main features of the Update Manager command line are:

To install the patch through command line

Now the Update Manager will start the installation process.

To uninstall a service pack using command line

Now the Update Manager will start the Uninstallation process.