Oracle Cloud Infrastructure Documentation

Unregistering an Instance

Unregister an instance from OS Management Hub to no longer have it managed by the service.

What happens to the instance when it's unregistered?

For Oracle Linux instances, unregistering restores the yum or DNF repository files to their state before the instance was registered with the service.

Unregistering OCI instances places an osmh-agent-unregister file on the system to ensure it doesn't automatically re-register with the service using a default profile. You must remove this file if you want to re-register the instance. See Instance was previously unregistered.

Unregistering a non-OCI instance removes the OS Management Hub agent plugin from the instance. You can also optionally remove the Management Agent software from the system.

To unregister an instance:
  1. Open the navigation menu and click Observability & Management. Under OS Management Hub, click Instances.
  2. Under List scope, select the compartment that contains the instance.
  3. Click the name of the instance.
  4. Review the instance's job history and reports. This information is no longer available after you unregister the instance. See the following:
  5. Click Unregister.
  6. (Optional) For on-premises or third-party cloud instances, if you no longer need to use the Management Agent service, remove the mgmt_agent package.
    Oracle Linux 8 or 9
    sudo dnf remove oracle.mgmt_agent
    Oracle Linux 7
    sudo yum remove oracle.mgmt_agent

    To remove the corresponding Management Agent resource from the Management Agent Cloud Service (MACS) in OCI, see Remove Management Agents.