Chapter 7. Deploy the Hosted Engine using the Web Console

Procedure

1. Open the Hosted Engine Deployment wizard

   If you continued directly from the end of Configure Red Hat Gluster Storage for Hosted Engine using the Web Console, the wizard is already open.

   Otherwise:

   1. Click Virtualization Hosted Engine.
   2. Click Start underneath Hyperconverged.

   3. Click Use existing configuration.

      Important

      If the previous deployment attempt failed, click Clean up instead of Use existing configuration to discard the previous attempt and start from scratch.

2. Specify virtual machine details

   

   1. Enter the following details and click Validate for FQDN fields.

      Engine VM FQDN

      The fully qualified domain name to be used for the Hosted Engine virtual machine, for example, engine.example.com.

      MAC Address

      The MAC address associated with the Engine VM FQDN.

      Important

      The pre-populated MAC address must be replaced.

      Root password

      The root password to be used for the Hosted Engine virtual machine.

   2. Click Next. Your FQDNs are validated before the next screen appears.

3. Specify virtualization management details

   1. Enter the password to be used by the admin account in the Administration Portal. You can also specify notification behavior here.

      
   2. Click Next.

4. Review virtual machine configuration

   1. Ensure that the details listed on this tab are correct. Click Back to correct any incorrect information.

      
   2. Click Prepare VM.

   3. Wait for virtual machine preparation to complete.

      

      If preparation does not occur successfully, see Viewing Hosted Engine deployment errors.

   4. Click Next.

5. Specify storage for the Hosted Engine virtual machine

   1. Specify the primary host and the location of the engine volume.

   2. Ensure that the Mount Options field is populated correctly.

      • Ensure that backup-volfile-servers=<host2-ip-address>:<host3-ip-address>, with the appropriate IP addresses inserted in place of <host2-ip-address> and <host3-ip-address>.

      • If your environment uses IPv6 addresses, ensure that you add the xlator-option=transport.address-family=inet6 option after the backup-volfile-servers value, like so:

        backup-volfile-servers=<host2-ip-address>:<host3-ip-address>,xlator-option=transport.address-family=inet6

        
   3. Click Next.

6. Finalize Hosted Engine deployment

   1. Review your deployment details and verify that they are correct.

      Note

      The responses you provided during configuration are saved to an answer file to help you reinstall the hosted engine if necessary. The answer file is created at /etc/ovirt-hosted-engine/answers.conf by default. This file should not be modified manually without assistance from Red Hat Support.

      
   2. Click Finish Deployment.

7. Wait for deployment to complete

   This takes up to 30 minutes.

   The window displays the following when complete.

   
   Important

   If deployment does not complete successfully, see Viewing Hosted Engine deployment errors.

   Click Close.

8. Verify hosted engine deployment

   Browse to the Administration Portal (for example, http://engine.example.com/ovirt-engine) and verify that you can log in using the administrative credentials you configured earlier. Click Dashboard and look for your hosts, storage domains, and virtual machines.