RH318 - ch02s03

After completing this section, you should be able to describe how to install Red Hat Virtualization Manager (RHV-M) as a self-hosted engine on an existing Red Hat Virtualization host.

Red Hat Virtualization Manager

Red Hat Virtualization Manager (RHV-M) provides a central management platform for the physical and logical resources of a Red Hat Virtualization (RHV) environment. RHV Manager is built upon Red Hat Enterprise Linux and Red Hat JBoss Enterprise Application Platform (EAP). It uses PostgreSQL databases to store information and provides several management interfaces, including a REST API.

RHV-M Hardware Requirements: At minimum, a dual core CPU, but a quad core CPU or multiple dual core CPUs are recommended. 16 GB or more of system RAM is recommended, but RHV-M can function with 4 GB of available system RAM if the data warehouse is not installed and if memory is not being consumed by existing processes.
RHV-M Storage Requirements: At least 25 GB of locally accessible, writable disk space is required, but 50 GB or more is recommended.
RHV-M Network Requirements: A single Network Interface Card (NIC) with a bandwidth of at least 1 Gbps.

Installation and Configuration Process

The process of installing and configuring a Red Hat Virtualization self-hosted engine can be broken down into three steps:

Install a Red Hat Virtualization Host.
Subscribe the host to the entitlements for Red Hat Virtualization and enable the appropriate software repositories. Confirm that forward and reverse DNS queries succeed for this host.
Initiate the RHV-M installation from the RHV-H node.
RH-M can be installed using either the graphical web console, or from the command-line using the hosted-engine --deploy command. Red Hat recommends the web console RHV-M installation.
Configure the initial data domain.
Specify storage for use by the Red Hat Virtualization engine hosts. The back end storage for the requested storage type, such as NFS or iSCSI, can be previously configured and made accessible. The storage becomes the initial data domain for the Default data center and contains the system image for the Red Hat Virtualization Manager virtual machine.

Install a Red Hat Virtualization Host

In this course, you have already learned how to install a Red Hat Virtualization Host. Since the self-hosted engine installation runs on a Red Hat Virtualization host, at least one host must be installed first. Additional Red Hat Virtualization hosts can be added later.

Initiate the RHV-M Installation From the RHV-H Node

To perform the installation using the web console, open a browser from another system and connect to port 9090 on the your RHV-H node, using the node's fully qualified domain name in the URL, such as https://hosta.lab.example.com:9090.

Select V in the menu to access virtualization information for the host.

Figure 2.4: Red Hat Virtualization Hosted Engine Setup

The self-hosted engine can either be installed using external storage that has already been provisioned or it can be installed in a hyper-converged environment where Red Hat Gluster Storage is configured into the guest nodes as steps in the installation. This section describes a self-hosted engine installation using external storage that has already been provisioned.

The Start button begins an installation process. The Hosted Engine Deployment wizard prompts for configuration information. Alternatively, run the hosted-engine --deploy command from a RHV-H command-line, which will also prompt for the needed configuration information.

Figure 2.5: Hosted Engine Deployment Configuration

Most configuration fields are self-explanatory. DNS must be able to resolve the fully qualified domain name of the engine virtual machine. The wizard provides a Validate button to check for DNS resolution. In many environments, DHCP is configured with MAC address reservations to ensure that infrastructure nodes retain a consistent IP address. The RHV-M virtual machine's IP address (either by DHCP or manually entered) must match the DNS-resolved IP address.

During the installation process, the following actions will occur:

The RHV-M appliance will be downloaded and started as a virtual machine on the host. The RHV-M appliance can be installed in advance before starting the installation:
```
[root@rhvh ~]# yum install rhvm-appliance
```
The RHV-M virtual machine will run the engine-setup command using the configuration information you provided.
The installer will add and activate the RHV-H node (where the installer is running) as the first host in the RHV environment. If successful, the installation wizard prompts for the storage configuration.

Configure the Initial Data Domain

A data domain must be created to complete the self-hosted engine installation. The data domain allow the Default data center to be activated and for RHV-M to run as a virtual machine. Connect to storage which has already been provisioned for use by the RHV deployment. This classroom environment uses NFS for the initial data domain. When storage is attached, the self-hosted installation completes. You can access the RHV Manager using the Administration Portal.

Figure 2.6: Storage Configuration

Accessing the Administration Portal

The RHV Manager has multiple interfaces, including web-based programming and RESTful APIs, that manage the RHV environment. The Administration Portal is a primary interface, available as a link on the RHV Manager's landing page. This cross-platform interface is accessible using any supported web browser.

Browser Support

A web browsers is used to access RHV Manager's Administration Portal and other resources. Red Hat browser support for RHV-M has three support tiers:

Tier 1: Mozilla Firefox Extended Support Release (ESR) version on RHEL.: Browser and operating system combinations that are fully tested and supported. Red Hat Engineering is committed to fixing issues.
Tier 2: Most recent version of Google Chrome, Mozilla Firefox, or Microsoft Edge on any OS.: Browser and operating system combinations that are partially tested and are likely to work. Red Hat Engineering will attempt to fix issues.
Tier 3: Older versions of Google Chrome, Mozilla Firefox, or other browsers on any OS.: Browser and operating system combinations that are not tested but may work. Minimal support is provided. Red Hat Engineering will attempt to fix only minor issues.

Reaching the Administration Portal

To access the Administration Portal, open a web browser and enter the landing page URL: https://your-rhvm-server-fqdn. In the Portals section, click on the Administration Portal link. Alternatively, open the Administration Portal directly by going to the URL https://your-rhvm-server-fqdn/ovirt-engine/webadmin/.

If you cannot see the Administration Portal link, you may need to increase your display resolution or you may need to use your web browser's zoom out feature.

Figure 2.7: Red Hat Virtualization Manager Landing Page

Configuring RHV-M Certificate Security

When you attempt to access the Red Hat Virtualization landing page, your web browser may complain because it does not recognize the certificate authority (CA) that signed the TLS certificate for RHV Manager's web server. There are three choices of methods to correct this:

Download and install the local CA certificate in your web browser. The CA certificate is available at http://your-rhvm-server-fqdn/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA When installing this certificate in your browser, enable the option to Trust this CA to identify websites.
Alternately, replace the TLS certificate used by RHV-M with one that is signed by a CA already trusted by your web browser. Currently, instructions for this method are found in Appendix D, "Red Hat Virtualization and Encrypted Communication", of the Red Hat Virtualization 4.3 Administration Guide.
The simplest but least secure method is to add a security exception in your web browser so that it accepts the self-signed certificate as valid. The procedure from the Firefox error page is:
1. Click the Advanced button.
2. Click the Add Exception button.
3. Click the Confirm Security Exception button in the Add Security Exception dialog.

Logging in to the Administration Portal

For your first login, authenticate using the admin user and the password set during the self-hosted engine installation. The Profile field should be set to internal to use the internal authentication domain.

Figure 2.8: Administration Portal Login Screen

Upon successful login, you reach the Administration Portal dashboard.

Figure 2.9: Administration Portal Dashboard

References

Further information is available in the following documents:

The Red Hat Virtualization 4.3 Installing Red Hat Virtualization as a self-hosted engine using the Cockpit web interface Guide, especially the chapter "Installing the Red Hat Virtualization Manager". https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/installing_red_hat_virtualization_as_a_self-hosted_engine_using_the_cockpit_web_interface/index
The Red Hat Virtualization 4.3 Planning and Prerequisites Guide. https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/planning_and_prerequisites_guide/index
The Red Hat Virtualization 4.3 Administration Guide, especially the discussion in the appendices on replacing the TLS certificate for Red Hat Virtualization Manager's web server. https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.3/html-single/administration_guide/index

Discuss Red Hat Virtualization

Go to community

Welcome to the Red Hat Virtualization (RH318) group in the Red Hat Learning Community!

cschunke

26 wrz 2023

We are excited to launch a space dedicated to the Red Hat Training course Red Hat Virtualization! To gain the most value from this group - click the "Join Group" button in the upper right hand corner of the group home page.We encourage group members to collaborate in this group to discuss topics, ask questions, share best practices and tips, provide course feedback, and share their accomplishments as it relates to RH318.Read more about Red Hat Virtualization here.

284

Revision: rh318-4.3-c05018e