Chapter 12. Administering the Self-Hosted Engine

12.1. Maintaining the Self-Hosted Engine

Self-hosted Engine Maintenance Modes

The maintenance modes enable you to start, stop, and modify the Manager virtual machine without interference from the high-availability agents, and to restart and modify the self-hosted engine nodes in the environment without interfering with the Manager.

There are three maintenance modes that can be enforced:

  • global - All high-availability agents in the cluster are disabled from monitoring the state of the Manager virtual machine. The global maintenance mode must be applied for any setup or upgrade operations that require the ovirt-engine service to be stopped, such as upgrading to a later version of Red Hat Virtualization.
  • local - The high-availability agent on the node issuing the command is disabled from monitoring the state of the Manager virtual machine. The node is exempt from hosting the Manager virtual machine while in local maintenance mode; if hosting the Manager virtual machine when placed into this mode, the Manager will migrate to another node, provided there is one available. The local maintenance mode is recommended when applying system changes or updates to a self-hosted engine node.
  • none - Disables maintenance mode, ensuring that the high-availability agents are operating.

Setting Local Maintenance

Stop the high-availability agent on a single self-hosted engine node.

Setting the local maintenance mode from the Administration Portal

  1. Put a self-hosted engine node into local maintenance mode:

    1. In the Administration Portal, click ComputeHosts and select a self-hosted engine node.
    2. Click ManagementMaintenance. Local maintenance mode is automatically triggered for that node.
  2. After you have completed any maintenance tasks, disable the maintenance mode:

    1. In the Administration Portal, click ComputeHosts and select the self-hosted engine node.
    2. Click ManagementActivate.

Setting the local maintenance mode from the command line

  1. Log in to a self-hosted engine node and put it into local maintenance mode:

    # hosted-engine --set-maintenance --mode=local
  2. After you have completed any maintenance tasks, disable the maintenance mode:

    # hosted-engine --set-maintenance --mode=none

Setting Global Maintenance

Stop the high-availability agents on all self-hosted engine nodes in the cluster.

Setting the global maintenance mode from the Administration Portal

  1. Put all of the self-hosted engine nodes into global maintenance mode:

    1. In the Administration Portal, click ComputeHosts and select any self-hosted engine node.
    2. Click More Actions ( moreactions ), then click Enable Global HA Maintenance.
  2. After you have completed any maintenance tasks, disable the maintenance mode:

    1. In the Administration Portal, click ComputeHosts and select any self-hosted engine node.
    2. Click More Actions ( moreactions ), then click Disable Global HA Maintenance.

Setting the global maintenance mode from the command line

  1. Log in to any self-hosted engine node and put it into global maintenance mode:

    # hosted-engine --set-maintenance --mode=global
  2. After you have completed any maintenance tasks, disable the maintenance mode:

    # hosted-engine --set-maintenance --mode=none