3.6. Maintaining the Self-Hosted Engine
The maintenance modes enable you to start, stop, and modify the engine virtual machine without interference from the high-availability agents, and to restart and modify the hosts in the environment without interfering with the engine.
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 engine virtual machine. Theglobalmaintenance mode must be applied for any setup or upgrade operations that require the engine to be stopped. Examples of this include upgrading to a later version of Red Hat Enterprise Virtualization, and installation of the rhevm-dwh and rhevm-reports packages necessary for the Reports Portal.local- The high-availability agent on the host issuing the command is disabled from monitoring the state of the engine virtual machine. The host is exempt from hosting the engine virtual machine while inlocalmaintenance mode; if hosting the engine virtual machine when placed into this mode, the engine will be migrated to another host, provided there is a suitable contender. Thelocalmaintenance mode is recommended when applying system changes or updates to the host.none- Disables maintenance mode, ensuring that the high-availability agents are operating.
The syntax for maintenance mode is:
# hosted-engine --set-maintenance --mode=mode
This command is to be conducted as the
root user.