hosted-engine (8) Linux Manual Page
hosted-engine – Tools for handling hosted engine
Synopsis
hosted-engine [–help] <command> [<command-args>]
Description
The hosted-engine command deploys a virtual machine that you can install oVirt Open Virtualization Manager on to. The Manager installation on your hosted-engine virtual machine can manage the host it is running on. The hosted-engine command can also be used to start, stop and access the hosted-engine virtual machine.
Options
–help- Show the help message and exit.
- The following commands are available:
–deploy [options]- Run the ovirt-hosted-engine-setup command to deploy the hosted-engine virtual machine.
–vm-start [–vm-conf=<file>]- Start VM on this host. –vm-conf=<file> can be optionally used to load an alternative vm.conf file as a recovery action.
–vm-start-paused- Start VM on this host with qemu paused.
–vm-shutdown- Gracefully shutdown the VM on this host.
–vm-poweroff- Forcefully poweroff the VM on this host.
–vm-status [–json]- Show the VM status, in machine-readable format if –json is given.
–add-console-password [–password=<password>]- Create a temporary password for VNC/SPICE connections to the hosted-engine virtual machine.
–console- Open the configured console using virsh on localhost.
–check-deployed- Checks whether the hosted engine has been deployed.
–check-liveliness- Checks liveliness page of engine.
–connect-storage- Manually connect the storage domain to the local VDSM instance.
–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.
–clean_metadata [–force-cleanup] [–host-id=<id>]- Remove host’s metadata from the global status database.
–reinitialize-lockspace [–force]- Reinitialize the sanlock lockspace file. This WIPES all locks.
–upgrade-appliance- Upgrade the engine appliance.
–rollback-upgrade- Rollback using a backup saved in a previous upgrade attempt.
- For additional information about a specific command try:
- hosted-engine <command> –help