Upgrade guide for OpManager v 12.7 and APM Plugin

Upgrade guide for OpManager v 12.7 and APM Plugin

After downloading the service pack for OpManager and the compatible service pack for Applications Manager Plugin (APM Plugin) to OpManager installed server, start the upgrade process for OpManager and APM Plugin by following the steps below:


Note: 

  1. If you are using OPM Connector in APM Plugin, pause the OPM Connector integration in APM Plugin GUI before proceeding to upgrade. Enable OPM Connector only when complete upgrade of OpManager and APM Plugin are completed.
  2. During the upgrade process, you might be prompted to import the ManageEngine public key certificate file. Please download the ppmsigner_publickey.crt file and keep it ready. If Update Manager prompts you to import the public certificate, select the ppmsigner_publickey.crt file. (This is a one-time process used to verify the integrity of Service Pack .PPM file)

Upgrading OpManager

Browse through the following topics to upgrade OpManager based on respective editions:
Applying Multiple Update Packs Guide:
If you're applying multiple OpManager update packs or intermediate updates, follow OpManager upgrade step for each pack. Furthermore, before progressing to the subsequent OpManager version upgrade, remember to update the APM plugin to the corresponding compatible version for each OPM intermediate update. This sequential approach ensures a seamless and successful upgrade process.

For example, if your current OpManager version is build 126329 and you want to move to build 127141 and APM Plugin is build version is 16424 and you want to upgrade to 16515, please follow these steps:
  1. Upgrade to intermediate Build 1270xx:
    1. Begin by upgrading your OpManager Edition to reach build 1270xx (for instance, 127006).
    2. After the upgrade, start OpManager and ensure the OpManager UI is accessible.
    3. Wait for the report data migration to finish before stopping OpManager.
    4. In case of OPM Enterprise Edition, upgrade the central to 1270xx, upgrade all the OPM probes to 1270xx.
  2. Upgrade Applications Manager Plugin to 1651x and Plugin Data Migration:
    1. Upgrade the Applications Manager plugin to the compatible version 16515.
    2. Start OpManager and navigate to the Applications tab (APM Plugin tab).
    3. Once you've upgraded the plugin, monitor the APM plugin data migration process (from APM Plugin tab). Ensure that all necessary data is successfully migrated, and the plugin UI is accessible and functions as expected before stopping OpManager.
    4. In the case of APM Plugin Enterprise Edition, perform the necessary steps to upgrade the APM Admin and all related APM Managed Servers to the required version. Ensure that plugin data migration is completed successfully for all relevant APM plugins before proceeding.
  3. Upgrade OpManager to Final Build 127141:
    1. Upgrade OpManager from build 1270xx to 127141 by repeating the upgrade steps
    2. Follow the instructions provided for your OpManager Edition.
Note: The APM Plugin Data Migration is only applicable to setups that are utilizing the bundled PGSQL Database.

i. Standard/Professional Edition

To upgrade OpManager for Standard/Professional Edition, follow the steps given below:

Step 1: Shutdown OpManager
  1. Windows: If OpManager is running as a Windows service, stop it from Control Panel > Services. Alternatively, you can open Command Prompt as an administrator, navigate to OpManager installation directory, and execute the ShutDownOpManager.bat script.
  2. Linux: Open a command terminal as root user and navigate to the OpManager installation directory. Then, execute the command sh ShutDownOpManager.sh
Step 2: OpManager backup
  1. To back up OpManager, take a VM snapshot of the product in the OpManager server if it is installed on a virtual machine. Otherwise, take a backup of the entire OpManager installation directory.
  2. Perform a complete backup of the backend database:
      1. If OpManager is using a Microsoft SQL backend database, you can use SQL Server Management Studio to take a backup of the OpManager database and all the dependent plug-in databases.
      1. To backup the OpManager database on Windows, open a command prompt with administrative privileges and navigate to the bin\backup folder under the OpManager installation directory. Then, execute the BackupDB.bat script to initiate backup.
      1. To backup the OpManager database on Linux, open a command prompt with root privileges and navigate to the bin/backup folder under the OpManager installation directory. Then, execute the BackupDB.sh script to initiate backup.
Step 3: Upgrade process
  • Start the command terminal as an administrator/root and launch Launch the Update Manager tool by executing the updateManager.bat script (updateManager.sh -c for Linux) located under the <OpManager Home>/bin directory.
  • Click the Browse button to select the upgrade pack file (the .ppm file that you downloaded) and choose Install.
  • Follow the on-screen instructions to apply the service pack.
Once the upgrade is complete, start the OpManager service for the changes to take effect. Next, we need to proceed to upgrading APM plugin. 

ii. Enterprise Edition

To upgrade OpManager for Enterprise Edition, follow the steps given below:

Step 1: Shutdown OpManager Central and all OpManager probes
Shut down individual instances of OpManager, following these steps:
  1. Windows: Stop OpManager from the Windows Services Manager or terminate the OpManager-related processes in Task Manager. 
  2. Linux: Open a command terminal and navigate to the OpManager installation directory. Then, execute the command sh ShutDownOpManager.sh
Step 2: OpManager Database Backup
  1. To back up OpManager, take a VM snapshot of the product in the OpManager server if it is installed on a virtual machine. Otherwise, take a backup of the entire OpManager installation directory.
  2. Perform a complete backup of the Central and Probe backend databases:
      1. If OpManager is using a Microsoft SQL backend database, you can use SQL Server Management Studio to take a backup of the OpManager database and all the dependent plug-in databases.
      1. To backup the OpManager database on Windows, open a command prompt with administrative privileges and navigate to the bin\backup folder under the OpManager installation directory. Then, execute the BackupDB.bat script to initiate backup.
      1. To backup the OpManager database on Linux, open a command prompt with root privileges and navigate to the bin/backup folder under the OpManager installation directory. Then, execute the BackupDB.sh script to initiate backup.

Step 3: Updating the Central Server
  • Start all Probe services for Smart Update to take effect.
  • In OpManager Central, start the command terminal as an administrator and launch the Update Manager tool by executing the updateManager.bat command (updateManager.sh -c for Linux) located under the <OpManager Home>/bin directory.
  • Click the Browse button to select the upgrade pack file (the .ppm file that you downloaded) and choose Install.
  • Follow the on-screen instructions to apply the service pack.
Once the upgrade is complete, start the OpManager Central service for the changes to take effect.

Step 4: Smart Update (Automatic update of Probe servers)
  • The Probe servers will automatically contact the Central server
  • Once the Probe server detects a build number mismatch with the Central server, all the Probe services will be stopped.
  • The Probe server downloads the Update Pack from the Central server and starts upgrading.
  • Once the update process is complete, restart all Probe services.
Once the update process is complete, restart all the Probe services. Next, we need to proceed to upgrading APM plugin.

Upgrading APM Plugin

Once the OpManager upgrade is completed, the next step is to upgrade the Applications Manager (APM) Plugin setup. To upgrade APM Plugin, follow the steps given below:

Step 1 - Shutdown Applications Manager Plugin
  1. Shutdown the OpManager service. This will shutdown APM Plugin setup as well.
Step 2 - Backup Applications Manager database
  1. If OpManager is using PostgreSQL backend, perform a complete backup of the plugin database since APM Plugin makes use of different database (amdb) in the OpManager PostgreSQL database instance.
Note: If OpManager is using a Microsoft SQL backend database and you have already performed a complete backup of APM Plugin database, you can ignore this step.

Step 3 - Upgrade Process
  • Start the command terminal as an administrator/root and run the Update Manager tool by executing the updateManager.bat script (updateManager.sh -c for Linux) located under the <OpManager Home>/AppManager/bin directory.
  • Select the downloaded APM Plugin Service pack file (.ppm) in the Update Manager tool.
  • Click Install. This opens a new panel where the installation process is displayed. On completion, a message "Service Pack installed successfully" is displayed and the service pack is listed in the Installed Patches section.
  • Once the installation is successful, click Finish to complete the installation.
  • Now start the OpManager service.
Note:
  • APM Plugin may not be available immediately after the OpManager build is started. Wait a few minutes before accessing the APM Plugin GUI.
  • After installing a service pack file, restart the OpManager service and access the APM Plugin GUI. Then shut down the service each time before proceeding to install the next Service Pack (.ppm) file.
  • In an Enterprise edition setup, upgrade the APM Plugin in all instances. Upgrade the Admin APM plugin server first before upgrading the Managed servers.
        New to M365 Manager Plus?
        New to M365 Manager Plus?
          New to RecoveryManager Plus?
          New to RecoveryManager Plus?
            New to Exchange Reporter Plus?
            New to Exchange Reporter Plus?
              New to SharePoint Manager Plus?
              New to SharePoint Manager Plus?
                  See all integrations
                  New to ADManager Plus?

                    New to ADSelfService Plus?

                    Start your free trial

                        Related Products