Self-Hosted Engine(HE) Guide does not contain any information on how HE should be operated. It contains the installation, upgrade and migration sections, but missing the important section explaining how to operate this deployment. The new section should contain an explanation about how Hosted Engine is organized, what is the VM used by hosted engine and what are its possible states, etc. For example, reading the guides, you can figure out that you should use hosted-engine command to operate the environment, but it is nowhere clearly stated. Next, reading hosted-engine quick help, it is very confusing about which VM it is talking about - the manager VM or any VM: --vm-start start VM on this host Also, the relationship between ovirt-ha-broker and ovirt-ha-agent, and when each of the services is required to be running, should be explained. Bottom line, HE guide is missing "How to" section.
This updated content is now available from the following locations: https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Self-Hosted_Engine_Guide/index.html#Administering_the_Manager_Virtual_Machine_RHELSHE https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.6/html-single/Self-Hosted_Engine_Guide/index.html#Maintaining_the_Self-Hosted_Engine