Looking for something? Try here..

Tuesday, November 7, 2023

Oracle Enterprise Manager - undeploy deprecated plug-ins

 In my previous post, I explain on how to upgrade Oracle Enterprise Manager (OEM) from 13.4 to 13.5. In my lab environment, I have not installed any additional plug-ins. But this not the case when we did the same in live production environment. We had one plug-in which required to be migrated instead of upgraded as below. 


This is clearly indicated when we use GUI to perform the upgrade. If you are using command line to upgrade the OEM, then these prechecks are written to a file which gets buried in the huge number of lines as we tend to check only for any errors or warnings. This plug-in migration doesn't pop out as a warning or an error in the logs. 

The first attempt to upgrade resulted in OMS not starting up with incompatible plug-in version from OMS. The error matches with the symptoms indicated in support note EM 13c: Upgrade Fails At OMS startup With Error 'Plugin's Repository version is not compatible with Plugin's OMS version' (Doc ID 2491277.1)

Solution to the issue was to restore the old environment (gives you the reason why backing up the old home is very important), undeploy the deprecated plug-in on all agents and OMS and then perform the upgrade again. 

So where do we find which plug-ins are deprecated and how to undeploy them? 

You hit the following 2 support notes 

The check list note 13.5: Checklist for Upgrading Enterprise Manager Cloud Control from Version 13.3/13.4 to 13.5 (Doc ID 2761728.1) which talks about the obsolete plugins of 13.5 

The following plug-ins are obsolete and support for these plug-ins is discontinued. These plug-ins must be undeployed from the Oracle Management Agents and Oracle Management Services before proceeding with the upgrade.

  • Cloud Services Management (oracle.sysman.csm)
  • Microsoft .NET Framework (oracle.em.smdn)
  • Microsoft Active Directory (oracle.em.smad)

This note doesn't talk regarding the plug-in which was indicated in our prechecks or review page. 

The second note Oracle announces deprecation of Enterprise Manager 13c ORAchk Healthchecks Plug-in (Doc ID 2935520.1) gives exactly what we are searching for. 

So, we have the dedicated note for ORAchk Healthchecks plugin is deprecated in version 13.5. 

How do we check what other plugins are installed and whether we are good to proceed with the upgrade? 

Click on Setup => Plug-ins


This will list out all available plug-ins. 

Click on View => Only Deployed

This shows us all the deployed plug-ins in our environment. 


How to undeploy the plug-in? 

Click on the plug-in we need to undeploy => Undeploy From => Management servers... 


Since this plug-in is not installed in the Management Agents, the option is grayed out and only Management Servers is available to select. 


Input Sys Password and click Continue


Check the backup question and click Undeploy

If you haven't backed up the configuration, it can be done as below


Once we click on Undeploy, the plug-in will be undeloyed from Management server and we get the confirmation.


Progress can be seen by issuing emctl status oms -detail command


 Once completed click Close

Confirm the Deployed plug-ins 

We have successfully undeployed the deprecated plug-in and upgrade can be done without any issues. 

References: 

EM 13c: Upgrade Fails At OMS startup With Error 'Plugin's Repository version is not compatible with Plugin's OMS version' (Doc ID 2491277.1)
Undeploying Plug-Ins (oracle.com)

Happy Undeploying...!!! 

No comments:

Post a Comment