12.6. Booting the Manager Virtual Machine in Rescue Mode

This topic describes how to boot the Manager virtual machine into rescue mode when it does not start. For more information, see Booting to Rescue Mode in the Red Hat Enterprise Linux System Administrator’s Guide.

  1. Connect to one of the hosted-engine nodes:

    $ ssh root@host_address
  2. Put the self-hosted engine in global maintenance mode:

    # hosted-engine --set-maintenance --mode=global
  3. Check if there is already a running instance of the Manager virtual machine:

    # hosted-engine --vm-status

    If a Manager virtual machine instance is running, connect to its host:

    # ssh root@host_address
  4. Shut down the virtual machine:

    # hosted-engine --vm-shutdown
    Note

    If the virtual machine does not shut down, execute the following command:

    # hosted-engine --vm-poweroff
  5. Start the Manager virtual machine in pause mode:

    hosted-engine --vm-start-paused
  6. Set a temporary VNC password:

    hosted-engine --add-console-password

    The command outputs the necessary information you need to log in to the Manger virtual machine with VNC.

  7. Log in to the Manager virtual machine with VNC. The Manager virtual machine is still paused, so it appears to be frozen.
  8. Resume the Manager virtual machine with the following command on its host:

    Warning

    After running the following command, the boot loader menu appears. You need to enter into rescue mode before the boot loader proceeds with the normal boot process. Read the next step about entering into rescue mode before proceeding with this command.

    # /usr/bin/virsh -c qemu:///system?authfile=/etc/ovirt-hosted-engine/virsh_auth.conf resume HostedEngine
  9. Boot the Manager virtual machine in rescue mode.
  10. Disable global maintenance mode

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

You can now run rescue tasks on the Manager virtual machine.