Upgrade Manager

The upgrade process for Opmanager - installed servers across your network is simplified using the Upgrade Manager. It offers a centralised platform to manage and perform upgrades for OpManager standalone servers, central, probes, their failover servers and APM plug-in. The enhanced smart upgrade feature enables to overcome the bottlenecks faced during the upgrade process.

How to upgrade via the upgrade manager? (for versions 12.8.344 & above)

For 12.8.344 and above, the upgrade manager simplifies the process into three stages:

Note: In the Enterprise Edition, all probe services must be up and actively communicating with the Central server. For failover setups, both the primary and secondary services should be up and running.

1. Upload service packs

  • Go to Settings > General Settings > Upgrade Manager.
  • The upgrade manager page provides comprehensive installation details about the servers.
  • Click the Upgrade option at the top right.
  • Upgrade Manager

  • Download the relevant service pack from the click here option provided below the OpManager Service Pack field, and click Upload.
  • Upgrade Manager

    Note: If the service pack validation fails, you will be prompted to download and import an Integrity Certificate file to retry the validation process and proceed with the upgrade. Click here to download the certificate.

  • Once the service packs are downloaded in central, they will automatically be fetched by the probes. The version number and type of each service pack will be shown for every probe in the Upgrade Manager.
  • Upgrade Manager

  • The service pack's download progress status for individual probes will be displayed under the Current Status column.
  • While downloading the service pack, if slowness or network issues is encountered, you can manually stop the download using the Stop button in the Actions column. In that case, manually copy the service pack to the <OpManagerProbe>\UpgradeManager directory for OpManager service packs, and <OpManagerProbe>\AppManager\UpgradeManager for APM Plugin service packs. Use the Refresh button to fetch the latest status of the respective probe service.

  • If a probe goes offline or loses connection with Central during the service pack download, then the download will automatically resume once communication is restored.

2. Health check

Once the service pack is downloaded, the system automatically verifies the upgrade requisites via a health check.

  • If the check fails, click Details to view the reasons for the failure.
  • After resolving the issues, click Retry to run the health check again.
  • Upgrade Manager

  • With a successful health check for both the central and all probes, the product is now ready for the upgrade.
  • Click on Start Upgrade to proceed with the upgrade.
  • Upgrade Manager

3. Upgrade process

  • The upgrade will start, and the progress will be displayed automatically on the service URL.
  • Upgrade Manager

  • The APM plugin upgrade will automatically start once OpManager has been successfully upgraded on the server.
  • For failover servers, the upgrade will start automatically for both the active and the standby server.
  • All probes will automatically begin upgrading simultaneously once the central upgrade is successfully completed.
  • Upgrade details for individual servers will be automatically updated under the Current Status column in central.

    Upgrade Manager

How to perform the smart upgrade? (for versions below 12.8.344)

  • In the Central, navigate to Settings > Configuration > Probe Details and click on Smart Upgrade.
  • Smart Upgrade

  • Click on Browse and add the PPM file.
    • The PPM file will be validated for compatibility. For example, users may select the PPM file of the existing build or a previous build. To ensure an unhindered upgrade process, the PPM files will be validated.
    • Once the PPM files are validated, the download request will be sent to the Probes.
    • Please note that only when the Auto Download option is enabled will the Probes automatically pull the PPM files from the Central. If the option is disabled, then the user has to manually place the PPM file in the specific folder of the respective Probe's server.
  • Click on Upload. The PPM file will be uploaded, and the connected Probes will begin to download the file from the Central. The download progress will be displayed.
    • OpManager Smart Upgrade - ManageEngine OpManager
    • OpManager Smart Upgrade - ManageEngine OpManager
  • Click on Upgrade. (Note: The Upgrade button appears only after the PPM files have been sent to all the Probes).
  • Smart Upgrade

  • The Central begins to upgrade.
  • Smart Upgrade

  • After the Central upgrades, it will go inactive for a short time. (This is normal as the Central processes the data.) The progress can be viewed in the Central UI.

Watch this video to learn more about the smart upgrade feature for versions below 12.8.344

Thank you for your feedback!

Was this content helpful?

We are sorry. Help us improve this page.

How can we improve this page?
Do you need assistance with this topic?
By clicking "Submit", you agree to processing of personal data according to the Privacy Policy.