23.7 Undeploying Plug-Ins

This section explains the following:

23.7.1 Undeploying Plug-Ins from Oracle Management Service

To undeploy plug-ins from the OMS, follow the steps:

  1. First, undeploy all plug-ins from all Management Agents. To do so, follow the steps mentioned in Undeploying Plug-Ins from Oracle Management Agent.
  2. From the Setup menu, select Extensibility, then select Plug-ins.
  3. On the Plug-ins page, select the plug-in you want to undeploy, and from the Actions menu, select Undeploy From, then select Management Servers.
  4. In the Undeploy Plug-in From Management Server dialog, enter the Management Repository SYS password, and click Continue. Then click Undeploy.
  5. On the Confirmation dialog, click Close.

    To monitor the undeployment operation, click Show Status.

To undeploy a plug-in in EM CLI, use the following command:

$emcli undeploy_plugin_from_server

-plugin="plug-inId"

[-sys_password="sys_password"]

Note:

When a metadata plug-in is undeployed/redeployed, it is recomended that you run the following command. The command should be run in each OMS environment instance.

$emcli metric_control -command=flush_metadata_cache

If you want to undeploy only the plug-ins from the OMS, and not the entire Enterprise Manager system, then use the Plug-ins page within the Enterprise Manager Cloud Control Console. Do NOT use runInstaller to undeploy only the plug-ins.

23.7.2 Undeploying Plug-Ins from Oracle Management Agent

To undeploy plug-ins from the Management Agent, follow the steps below:

Note:

  • These steps are applicable for obsolete and deprecated plug-ins as well.

  • Undeploying a plug-in from Management Agent removes all the targets that were monitored by the plug-in.

  • Undeployment of a plug-in from the Management Agent restarts the Management Agent. The Management Agent does not monitor any target during downtime.

  1. From the Setup menu, select Extensibility, then select Plug-ins.
  2. On the Plug-ins page, select the plug-in you want to undeploy, and from the Actions menu, select Undeploy From, then select Management Agent.
  3. In the Undeploy Plug-in From Management Agent dialog, click Add and add the Management Agents from which you want to undeploy the plug-in. Click Continue. Then click Undeploy.
  4. On the Confirmation dialog, click Close.

    To monitor the undeployment operation, click Show Status.

Note:

Undeploying a plug-in from Management Agent removes all the targets that were monitored by the plug-in.

Undeployment of a plug-in from the Management Agent restarts the Management Agent. The Management Agent does not monitor any target during downtime.

To undeploy a plug-in using EM CLI, use the following command:

$emcli undeploy_plugin_from_agent

-plugin="pluginId"

{-agent_names="agent1[;agent2...]" | -all_discovery_only_agents}

To undeploy all versions of oracle.sysman.db2 plug-ins from all Management Agents where only Discovery Plug-ins are deployed, use the following command:

$emcli undeploy_plugin_from_agent -plugin=oracle.sysman.db2 -all_discovery_only_agents