Unregistering (removing) agent from OEM Grid Control

When you want to permanently remove an agent from you OEM GC environment, you will have the GUI method and the manual method. The reason for writing this post is that I was able to remove all targets from within the GUI except the agent itself, at least at screen I was expecting to offer this functionality.

The GUI method

  • Shutdown the agent that you want to remove
  • In OEM GC: goto the link “setup”
  • In OEM GC – setup: goto the link “Agents”
  • Look for your agent and click it. The next screen will show the monitored targets for the agent.
  • One-by-one select the targets and click the “Remove” button, until there are no targets left.
  • Now goto the tab “Targets” and select “All Targets”
  • Search for the name of your agent, select it and click the “Remove” button
  • The agent should now be unregistered (removed) from your OMS. The last step is to deinstall the agent software from the server.

The agent should now be unregistered (removed) from your OMS. The last step is to deinstall the agent software from the server.

The manual method

  • Shutdown the agent that you want to remove
  • Use SQL*Plus to connect to your OMS repository database as SYSMAN
  • Enter the following statement:
    EXEC MGMT_ADMIN.CLEANUP_AGENT(‘<server_to_remove>:<agent port>’);

The agent should now be unregistered (removed) from your OMS. The last step is to deinstall the agent software from the server.