Description of problem: Currently the man page for "hosted-engine" provides the following information about maintenance: --set-maintenance --mode=<mode> Set maintenance status to the specified mode (global/local/none). Similar situation on the --help page: # hosted-engine --set-maintenance --help Usage: /sbin/hosted-engine set-maintenance --mode=<mode> Set maintenance status to the specified mode. Valid values are: 'global', 'local', and 'none'. Available only after deployment has completed. There is however no description of what each mode does and when it should be used. Version-Release number of selected component (if applicable): ovirt-hosted-engine-setup-1.3.3.4-1.el7ev.noarch.rpm Ways to improve: Describe each of the three modes in the man page so that users know which one to use.
Verified on version: 4.0.2.6-0.1.el7ev ovirt-hosted-engine-setup-2.0.1.4-1.el7ev.noarch man page: --set-maintenance --mode=<mode> Set maintenance status to the specified mode: global - Allow the administrator to start/stop/modify the engine VM without any worry of interference from the HA agents. local - Allow the administrator to maintain this host. Note that if you have only 2 nodes and one is in maintenance, there is only one host available to run the engine VM. none - Resume HA functionality. --help page: # hosted-engine --set-maintenance --help Usage: /usr/sbin/hosted-engine --set-maintenance --mode=<mode> Set maintenance status to the specified mode. Valid values are: 'global', 'local', and 'none'. Available only after deployment has completed.