2.2. Deploying Self-Hosted Engine on Red Hat Virtualization Host

Procedure 2.3. Configuring a RHVH-based Self-Hosted Engine

1. Obtaining the RHV-M Virtual Appliance

   Download the RHV-M Virtual Appliance from the Customer Portal:
   1. Log in to the Customer Portal at https://access.redhat.com.
   2. Click Downloads in the menu bar.
   3. Click Red Hat Virtualization > Download Latest to access the product download page.
   4. Choose the appliance for the correct Red Hat Virtualization version and click Download Now.
   Secure copy the OVA file to the Red Hat Virtualization Host:

   scp rhvm-appliance.ova root@host.example.com:/usr/share

2. Initiating Self-Hosted Engine Deployment

   Log in to the Cockpit user interface at https://HostIPorFQDN:9090 and navigate to Virtualization > Hosted Engine. Click Start.
   
   The text fields in the deployment script are pre-populated with a default answer if one is available; change or enter your answers as necessary.
   

   Note

   In this procedure, the deployment questions are presented in text form. In the UI, click Next when prompted.

   During customization use CTRL-D to abort.
   Continuing will configure this host for serving as hypervisor and create a VM where you have to install the engine afterwards.
   Are you sure you want to continue? (Yes, No)[Yes]:

3. Configuring Storage

   Select the type of storage to use.

   Please specify the storage you would like to use (glusterfs, iscsi, fc, nfs3, nfs4)[nfs3]:

   • For NFS storage types, specify the full address, using either the FQDN or IP address, and path name of the shared storage domain.

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/nfs

   • For iSCSI, specify the iSCSI portal IP address, port, user name and password, and select a target name from the auto-detected list. You can only select one iSCSI target during the deployment.

     Please specify the iSCSI portal IP address:

     Please specify the iSCSI portal port [3260]:

     Please specify the iSCSI portal user:

     Please specify the iSCSI portal password:

     Please specify the target name (auto-detected values) [default]:

   • For Gluster storage, specify the full address, using either the FQDN or IP address, and path name of the shared storage domain.

     Important

     Only replica 3 Gluster storage is supported. Ensure the following configuration has been made:

     • In the /etc/glusterfs/glusterd.vol file on all three Gluster servers, set rpc-auth-allow-insecure to on.

       option rpc-auth-allow-insecure on

     • Configure the volume as follows:

       gluster volume set volume cluster.quorum-type auto
       gluster volume set volume network.ping-timeout 10
       gluster volume set volume auth.allow \*
       gluster volume set volume group virt
       gluster volume set volume storage.owner-uid 36
       gluster volume set volume storage.owner-gid 36
       gluster volume set volume server.allow-insecure on

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/gluster_volume

   • For Fibre Channel, the host bus adapters must be configured and connected, and the hosted-engine script will auto-detect the LUNs available. The LUNs must not contain any existing data.

     The following luns have been found on the requested target:
     [1]     3514f0c5447600351       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
               
     [2]     3514f0c5447600352       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
     
     Please select the destination LUN (1, 2) [1]:

4. Configuring the Network

   The script checks your firewall configuration and offers to modify it for console (SPICE or VNC) access. It then detects possible network interface controllers (NICs) to use as a management bridge for the environment.

   iptables was detected on your computer, do you wish setup to configure it? (Yes, No)[Yes]: Yes

   Please indicate a pingable gateway IP address [X.X.X.X]:

   Please indicate a nic to set ovirtmgmt bridge on: (eth1, eth0) [eth1]:

5. Configuring the Virtual Machine

   Select disk for the boot device type, and then specify the path to the RHV-M Virtual Appliance. If the /var/tmp directory does not have enough space, specify a different directory. The VDSM user and KVM group must have read, write, and execute permissions on the directory.

   Please specify the device to boot the VM from (choose disk for the oVirt engine appliance) (cdrom, disk, pxe) [disk]: disk

   Please specify the console type you would like to use to connect to the VM (vnc, spice) [vnc]: vnc

   Using an oVirt engine appliance could greatly speed-up ovirt hosted-engine deploy.
   You could get oVirt engine appliance installing ovirt-engine-appliance rpm.
   Please specify path to OVF archive you would like to use [None]: /path/to/rhvm-appliance.ova

   Specify Yes if you want cloud-init to take care of the initial configuration of the Manager virtual machine. Specify Generate for cloud-init to take care of tasks like setting the root password, configuring networking, configuring the host name, injecting an answers file for engine-setup to use, and running engine-setup on boot. Optionally, select Existing if you have an existing cloud-init script to take care of more sophisticated functions of cloud-init.

   Note

   For more information on cloud-init, see https://cloudinit.readthedocs.org/en/latest/.

   Would you like to use cloud-init to customize the appliance on the first boot (Yes, No)[Yes]? Yes

   Would you like to generate on-fly a cloud-init ISO image (of no-cloud type) or do you have an existing one (Generate, Existing)[Generate]? Generate

   Please provide the FQDN you would like to use for the engine appliance.
   Note: This will be the FQDN of the engine VM you are now going to launch.
   It should not point to the base host or to any other existing machine.
   Engine VM FQDN: (leave it empty to skip): manager.example.com

   Automatically execute engine-setup on the engine appliance on first boot (Yes, No)[Yes]? Yes

   Automatically restart the engine VM as a monitored service after engine-setup (Yes, No)[Yes]? Yes

   Please provide the domain name you would like to use for the engine appliance.
   Engine VM domain: [localdomain] example.com

   Enter root password that will be used for the engine appliance (leave it empty to skip): p@ssw0rd

   Confirm appliance root password: p@ssw0rd

   The following CPU types are supported by this host:
       - model_SandyBridge: Intel SandyBridge Family
       - model_Westmere: Intel Westmere Family
       - model_Nehalem: Intel Nehalem Family
       - model_Penryn: Intel Penryn Family
       - model_Conroe: Intel Conroe Family
   Please specify the CPU type to be used by the VM [model_SandyBridge]:

   Please specify the number of virtual CPUs for the VM [Defaults to appliance OVF value: [2]:

   You may specify a unicast MAC address for the VM or accept a randomly generated default [00:16:3e:77:b2:a4]:

   Please specify the memory size of the VM in MB (Defaults to maximum available): [12722]:

   How should the engine VM network be configured (DHCP, Static)[DHCP]? Static

   Please enter the IP address to be used for the engine VM: 192.168.x.x

   Please provide a comma-separated list (max 3) of IP addresses of domain name servers for the engine VM
   Engine VM DNS (leave it empty to skip):

   Specify Yes to copy the /etc/hosts file from the host to the Manager virtual machine for host name resolution.

   Add lines for the appliance itself and for this host to /etc/hosts on the engine VM?
   Note: ensuring that this host could resolve the engine VM hostname is still up to you (Yes, No)[No] Yes

6. Configuring the Self-Hosted Engine

   Specify a name for the host to be identified in the Administration Portal, and the password for the admin@internal user to access the Administration Portal. Provide the name and TCP port number of the SMTP server, the email address used to send email notifications, and a comma-separated list of email addresses to receive these notifications.

   Enter engine admin password: p@ssw0rd

   Confirm engine admin password: p@ssw0rd

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]:

   Please provide the name of the SMTP server through which we will send notifications [localhost]:

   Please provide the TCP port number of the SMTP server [25]:

   Please provide the email address from which notifications will be sent [root@localhost]:

   Please provide a comma-separated list of email addresses which will get notifications [root@localhost]:

7. Configuration Preview

   Before proceeding, the hosted-engine script displays the configuration values you have entered, and prompts for confirmation to proceed with these values.

   Please confirm installation settings (Yes, No)[Yes]: Yes

   The script creates the Manager virtual machine, starts the ovirt-engine and high availability services, and connects the host and shared storage domain to the Manager virtual machine.
   When the hosted-engine deployment script completes successfully, the Red Hat Virtualization Manager is configured and running on your host. The Manager has already configured the data center, cluster, host, the Manager virtual machine, and a shared storage domain dedicated to the Manager virtual machine.

   Important

   Log in to the Administration Portal as the admin@internal user to continue configuring the Manager and add further resources. You must create another data domain for the data center to be initialized to host regular virtual machine data, and for the Manager virtual machine to be visible. See Storage in the Administration Guide for different storage options and on how to add a data storage domain.
   Link your Red Hat Virtualization Manager to a directory server so you can add additional users to the environment. Red Hat Virtualization supports many directory server types; for example, Red Hat Directory Server (RHDS), Red Hat Identity Management (IdM), Active Directory, and many other types. Add a directory server to your environment using the ovirt-engine-extension-aaa-ldap-setup interactive setup script. For more information, see Configuring an External LDAP Provider in the Administration Guide.
   The script also saves the answers you gave during configuration to a file, to help with disaster recovery. If a destination is not specified using the --generate-answer=<file> argument, the answer file is generated at /etc/ovirt-hosted-engine/answers.conf.

   Note

   SSH password authentication is not enabled by default on the RHV-M Virtual Appliance. You can enable SSH password authentication by accessing the Red Hat Virtualization Manager virtual machine through the SPICE or VNC console. Verify that the sshd service is running. Edit /etc/ssh/sshd_config and change the following two options to yes:

   • PasswordAuthentication
   • PermitRootLogin

   Restart the sshd service for the changes to take effect.

8. Subscribing to the Required Entitlements

   Subscribe the Manager virtual machine to the required entitlements. See Subscribing to the Required Entitlements in the Installation Guide for more information.