5.2. Removing a Host from a Self-Hosted Engine Environment


To remove a self-hosted engine node from your environment, place the node into maintenance mode, undeploy the node, and optionally remove it. The node can be managed as a regular host after the HA services have been stopped, and the self-hosted engine configuration files have been removed.

Procedure 5.3. Removing a Host from a Self-Hosted Engine Environment

  1. In the Administration Portal, click the Hosts tab. Select the self-hosted engine node and click Maintenance to set it to the local maintenance mode.
  2. Click Edit.
  3. Click the Hosted Engine sub-tab and select the Undeploy radio button. This action stops the ovirt-ha-agent and ovirt-ha-broker services and removes the self-hosted engine configuration file.

    Note

    The host will be visible, but shown as unavailable when running hosted-engine --vm-status. This is because the metadata is not removed when a host is undeployed. The removed host will disappear in approximately a week when the metadata is not refreshed. To force the removal of the host's metadata follow the procedure in How to clean the metadata of redeployed Hosts in a Hosted Engine setup.
  4. Optionally, click Remove to open the Remove Host(s) confirmation window, and click OK.
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top