Red Hat Virtualization-4.4-Installing Red Hat Virtualization As A Standalone Manager With Remote Databases-En-Us
Red Hat Virtualization-4.4-Installing Red Hat Virtualization As A Standalone Manager With Remote Databases-En-Us
Red Hat Virtualization-4.4-Installing Red Hat Virtualization As A Standalone Manager With Remote Databases-En-Us
Installing the Red Hat Virtualization Manager on one server, and its databases on a
second server
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons
Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is
available at
http://creativecommons.org/licenses/by-sa/3.0/
. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must
provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert,
Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift,
Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States
and other countries.
Linux ® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS ® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States
and/or other countries.
MySQL ® is a registered trademark of MySQL AB in the United States, the European Union and
other countries.
Node.js ® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the
official Joyent Node.js open source or commercial project.
The OpenStack ® Word Mark and OpenStack logo are either registered trademarks/service marks
or trademarks/service marks of the OpenStack Foundation, in the United States and other
countries and are used with the OpenStack Foundation's permission. We are not affiliated with,
endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
Abstract
This document describes how to install a standalone Manager environment – where the Red Hat
Virtualization Manager is installed on either a physical server or a virtual machine hosted in another
environment – with the Manager database and the Data Warehouse service and database hosted
on a remote server. Although you can choose to host one database locally and the other remotely,
this document assumes that both databases will be hosted remotely. If this is not the configuration
you want to use, see the other Installation Options in the Product Guide.
Table of Contents
Table of Contents
.PREFACE
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4. . . . . . . . . . . . .
RED HAT VIRTUALIZATION KEY COMPONENTS 4
STANDALONE MANAGER ARCHITECTURE 4
. . . . . . . . . . . 1.. .INSTALLATION
CHAPTER . . . . . . . . . . . . . . . . OVERVIEW
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. . . . . . . . . . . . .
.CHAPTER
. . . . . . . . . . 2.
. . REQUIREMENTS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7. . . . . . . . . . . . .
2.1. RED HAT VIRTUALIZATION MANAGER REQUIREMENTS 7
2.1.1. Hardware Requirements 7
2.1.2. Browser Requirements 7
2.1.3. Client Requirements 8
2.1.4. Operating System Requirements 8
2.2. HOST REQUIREMENTS 9
2.2.1. CPU Requirements 9
2.2.1.1. Checking if a Processor Supports the Required Flags 10
2.2.2. Memory Requirements 10
2.2.3. Storage Requirements 10
2.2.4. PCI Device Requirements 11
2.2.5. Device Assignment Requirements 11
2.2.6. vGPU Requirements 12
2.3. NETWORKING REQUIREMENTS 12
2.3.1. General requirements 12
2.3.2. Firewall Requirements for DNS, NTP, and IPMI Fencing 12
2.3.3. Red Hat Virtualization Manager Firewall Requirements 13
2.3.4. Host Firewall Requirements 17
2.3.5. Database Server Firewall Requirements 22
2.3.6. Maximum Transmission Unit Requirements 22
.CHAPTER
. . . . . . . . . . 3.
. . INSTALLING
. . . . . . . . . . . . . .THE
. . . . .RED
. . . . .HAT
. . . . .VIRTUALIZATION
. . . . . . . . . . . . . . . . . .MANAGER
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
..............
3.1. INSTALLING THE RED HAT VIRTUALIZATION MANAGER MACHINE AND THE REMOTE SERVER 23
3.2. ENABLING THE RED HAT VIRTUALIZATION MANAGER REPOSITORIES 23
3.3. PREPARING A REMOTE POSTGRESQL DATABASE 25
Enabling the Red Hat Virtualization Manager Repositories 25
Initializing the PostgreSQL Database 26
3.4. INSTALLING AND CONFIGURING THE RED HAT VIRTUALIZATION MANAGER 28
3.5. INSTALLING AND CONFIGURING DATA WAREHOUSE ON A SEPARATE MACHINE 33
Enabling the Red Hat Virtualization Manager Repositories 33
Installing Data Warehouse on a Separate Machine 35
3.6. CONNECTING TO THE ADMINISTRATION PORTAL 37
.CHAPTER
. . . . . . . . . . 4.
. . .INSTALLING
. . . . . . . . . . . . .HOSTS
. . . . . . . .FOR
. . . . .RED
. . . . .HAT
. . . . .VIRTUALIZATION
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
..............
4.1. RED HAT VIRTUALIZATION HOSTS 39
4.1.1. Installing Red Hat Virtualization Hosts 39
4.1.2. Enabling the Red Hat Virtualization Host Repository 41
4.1.3. Advanced Installation 42
4.1.3.1. Custom Partitioning 42
4.1.3.2. Installing a DUD driver on a host without installer support 43
4.1.3.3. Automating Red Hat Virtualization Host deployment 46
4.1.3.3.1. Preparing the installation environment 47
4.1.3.3.2. Configuring the PXE server and the boot loader 47
4.1.3.3.3. Creating and running a Kickstart file 48
4.2. RED HAT ENTERPRISE LINUX HOSTS 50
1
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
.CHAPTER
. . . . . . . . . . 5.
. . PREPARING
. . . . . . . . . . . . . STORAGE
. . . . . . . . . . . FOR
. . . . . RED
. . . . . HAT
. . . . . VIRTUALIZATION
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
..............
5.1. PREPARING NFS STORAGE 56
5.2. PREPARING ISCSI STORAGE 58
5.3. PREPARING FCP STORAGE 58
5.4. PREPARING POSIX-COMPLIANT FILE SYSTEM STORAGE 59
5.5. PREPARING LOCAL STORAGE 60
5.6. PREPARING RED HAT GLUSTER STORAGE 60
5.7. CUSTOMIZING MULTIPATH CONFIGURATIONS FOR SAN VENDORS 61
5.8. RECOMMENDED SETTINGS FOR MULTIPATH.CONF 62
. . . . . . . . . . . 6.
CHAPTER . . .ADDING
. . . . . . . . .STORAGE
. . . . . . . . . . .FOR
. . . . .RED
. . . . HAT
. . . . . VIRTUALIZATION
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
..............
6.1. ADDING NFS STORAGE 64
6.2. ADDING ISCSI STORAGE 65
6.3. ADDING FCP STORAGE 67
6.4. ADDING POSIX-COMPLIANT FILE SYSTEM STORAGE 68
6.5. ADDING A LOCAL STORAGE DOMAIN 69
6.6. ADDING RED HAT GLUSTER STORAGE 69
APPENDIX A. CONFIGURING A LOCAL REPOSITORY FOR OFFLINE RED HAT VIRTUALIZATION MANAGER
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
INSTALLATION ..............
Enabling the Red Hat Virtualization Manager Repositories 71
Configuring the Offline Repository 73
. . . . . . . . . . . .B.
APPENDIX . . CONFIGURING
................A
. . HOST
. . . . . . .FOR
. . . . .PCI
. . . .PASSTHROUGH
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
..............
. . . . . . . . . . . .C.
APPENDIX . . .REMOVING
. . . . . . . . . . . .THE
. . . . .STANDALONE
. . . . . . . . . . . . . . . RED
. . . . .HAT
. . . . .VIRTUALIZATION
. . . . . . . . . . . . . . . . . . MANAGER
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
..............
. . . . . . . . . . . .D.
APPENDIX . . .PREVENTING
. . . . . . . . . . . . . .KERNEL
. . . . . . . . . MODULES
. . . . . . . . . . . FROM
. . . . . . . LOADING
. . . . . . . . . . .AUTOMATICALLY
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
..............
D.1. REMOVING A MODULE TEMPORARILY 79
.APPENDIX
. . . . . . . . . . .E.
. . SECURING
. . . . . . . . . . . .RED
. . . . .HAT
. . . . .VIRTUALIZATION
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
..............
E.1. APPLYING THE DISA STIG PROFILE IN RHEL BASED HOSTS AND THE STANDALONE MANAGER 81
E.1.1. Enabling DISA STIG in a self-hosted engine 81
E.2. APPLYING THE PCI-DSS PROFILE IN RHV HOSTS AND THE STANDALONE MANAGER 82
E.2.1. Enabling PCI-DSS in a self-hosted engine 82
. . . . . . . . . . . .F.
APPENDIX . . LEGAL
. . . . . . . .NOTICE
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
..............
2
Table of Contents
3
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
PREFACE
Standalone Manager installation is manual and customizable. You must install a Red Hat Enterprise
Linux machine, then run the configuration script (engine-setup) and provide information about how you
want to configure the Red Hat Virtualization Manager. Add hosts and storage after the Manager is
running. At least two hosts are required for virtual machine high availability.
To install the Manager with a remote Manager database, manually create the database on the remote
machine before running engine-setup. To install the Data Warehouse database on a remote machine,
run the Data Warehouse configuration script (ovirt-engine-dwh-setup) on the remote machine. This
script installs the Data Warehouse service and can create the Data Warehouse database automatically.
See the Planning and Prerequisites Guide for information on environment options and recommended
configuration.
Red Hat Virtualization Manager A service that provides a graphical user interface and
a REST API to manage the resources in the
environment. The Manager is installed on a physical
or virtual machine running Red Hat Enterprise Linux.
One Red Hat Virtualization Manager machine. The Manager is typically deployed on a physical
server. However, it can also be deployed on a virtual machine, as long as that virtual machine is
hosted in a separate environment. The Manager must run on Red Hat Enterprise Linux 8.
A minimum of two hosts for virtual machine high availability. You can use Red Hat Enterprise
Linux hosts or Red Hat Virtualization Hosts (RHVH). VDSM (the host agent) runs on all hosts to
facilitate communication with the Red Hat Virtualization Manager.
One storage service, which can be hosted locally or on a remote server, depending on the
4
PREFACE
One storage service, which can be hosted locally or on a remote server, depending on the
storage type used. The storage service must be accessible to all hosts.
5
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
a. Install two Red Hat Enterprise Linux machines: one for the Manager, and one for the
databases. The second machine will be referred to as the remote server.
b. Register the Manager machine with the Content Delivery Network and enable the Red Hat
Virtualization Manager repositories.
c. Manually configure the Manager database on the remote server. You can also use this
procedure to manually configure the Data Warehouse database if you do not want the Data
Warehouse setup script to configure it automatically.
e. Install the Data Warehouse service and database on the remote server.
3. Prepare storage to use for storage domains. You can use one of the following storage types:
NFS
iSCSI
Local storage
IMPORTANT
Keep the environment up to date. See How do I update my Red Hat Virtualization
system? for more information. Since bug fixes for known issues are frequently released,
use scheduled tasks to update the hosts and the Manager.
6
CHAPTER 2. REQUIREMENTS
CHAPTER 2. REQUIREMENTS
Hardware certification for Red Hat Virtualization is covered by the hardware certification for Red Hat
Enterprise Linux. For more information, see Does Red Hat Virtualization also have hardware
certification?. To confirm whether specific hardware items are certified for use with Red Hat Enterprise
Linux, see Red Hat certified hardware .
Network Interface 1 Network Interface Card (NIC) 1 Network Interface Card (NIC)
with bandwidth of at least 1 Gbps. with bandwidth of at least 1 Gbps.
Tier 1: Browser and operating system combinations that are fully tested and fully supported. Red
Hat Engineering is committed to fixing issues with browsers on this tier.
Tier 2: Browser and operating system combinations that are partially tested, and are likely to
work. Limited support is provided for this tier. Red Hat Engineering will attempt to fix issues with
browsers on this tier.
Tier 3: Browser and operating system combinations that are not tested, but may work. Minimal
7
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Tier 3: Browser and operating system combinations that are not tested, but may work. Minimal
support is provided for this tier. Red Hat Engineering will attempt to fix only minor issues with
browsers on this tier.
Tier 2
You can access virtual machine consoles using the SPICE, VNC, or RDP (Windows only) protocols. You
can install the QXLDOD graphical driver in the guest operating system to improve the functionality of
SPICE. SPICE currently supports a maximum resolution of 2560x1600 pixels.
NOTE
SPICE may work with Windows 8 or 8.1 using QXLDOD drivers, but it is neither certified
nor tested.
Do not install any additional packages after the base installation, as they may cause dependency issues
when attempting to install the packages required by the Manager.
Do not enable additional repositories other than those required for the Manager installation.
8
CHAPTER 2. REQUIREMENTS
For more information on the requirements and limitations that apply to guests see Red Hat Enterprise
Linux Technology Capabilities and Limits and Supported Limits for Red Hat Virtualization .
AMD
Opteron G4
Opteron G5
EPYC
Intel
Nehalem
Westmere
SandyBridge
IvyBridge
Haswell
Broadwell
Skylake Client
Skylake Server
Cascadelake Server
IBM
POWER8
POWER9
For each CPU model with security updates, the CPU Type lists a basic type and a secure type. For
example:
9
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
The Secure CPU type contains the latest updates. For details, see BZ#1731395
You must enable virtualization in the BIOS. Power off and reboot the host after this change to ensure
that the change is applied.
Procedure
1. At the Red Hat Enterprise Linux or Red Hat Virtualization Host boot screen, press any key and
select the Boot or Boot with serial console entry from the list.
2. Press Tab to edit the kernel parameters for the selected option.
3. Ensure there is a space after the last kernel parameter listed, and append the parameter
rescue.
5. At the prompt, determine that your processor has the required extensions and that they are
enabled by running this command:
If any output is shown, the processor is hardware virtualization capable. If no output is shown, your
processor may still support hardware virtualization; in some circumstances manufacturers disable the
virtualization extensions in the BIOS. If you believe this to be the case, consult the system’s BIOS and
the motherboard manual provided by the manufacturer.
However, the amount of RAM required varies depending on guest operating system requirements, guest
application requirements, and guest memory activity and usage. KVM can also overcommit physical RAM
for virtualized guests, allowing you to provision guests with RAM requirements greater than what is
physically present, on the assumption that the guests are not all working concurrently at peak load. KVM
does this by only allocating RAM for guests as required and shifting underutilized guests into swap.
The minimum storage requirements of RHVH are documented in this section. The storage requirements
for Red Hat Enterprise Linux hosts vary based on the amount of disk space used by their existing
configuration but are expected to be greater than those of RHVH.
The minimum storage requirements for host installation are listed below. However, use the default
10
CHAPTER 2. REQUIREMENTS
The minimum storage requirements for host installation are listed below. However, use the default
allocations, which use more storage space.
/ (root) - 6 GB
/home - 1 GB
/tmp - 1 GB
/boot - 1 GB
/var - 5 GB
/var/crash - 10 GB
/var/log - 8 GB
/var/log/audit - 2 GB
/var/tmp - 10 GB
swap - 1 GB. See What is the recommended swap size for Red Hat platforms? for details.
Anaconda reserves 20% of the thin pool size within the volume group for future metadata
expansion. This is to prevent an out-of-the-box configuration from running out of space under
normal usage conditions. Overprovisioning of thin pools during installation is also not supported.
If you are also installing the RHV-M Appliance for self-hosted engine installation, /var/tmp must be at
least 10 GB.
If you plan to use memory overcommitment, add enough swap space to provide virtual memory for all of
virtual machines. See Memory Optimization .
For information about how to use PCI Express and conventional PCI devices with Intel Q35-based
virtual machines, see Using PCI Express and Conventional PCI Devices with the Q35 Virtual Machine .
CPU must support IOMMU (for example, VT-d or AMD-Vi). IBM POWER8 supports IOMMU by
default.
All PCIe switches and bridges between the PCIe device and the root port should support ACS.
For example, if a switch does not support ACS, all devices behind that switch share the same
IOMMU group, and can only be assigned to the same virtual machine.
For GPU support, Red Hat Enterprise Linux 8 supports PCI device assignment of PCIe-based
NVIDIA K-Series Quadro (model 2000 series or higher), GRID, and Tesla as non-VGA graphics
devices. Currently up to two GPUs may be attached to a virtual machine in addition to one of
the standard, emulated VGA interfaces. The emulated VGA is used for pre-boot and installation
and the NVIDIA GPU takes over when the NVIDIA graphics drivers are loaded. Note that the
NVIDIA Quadro 2000 is not supported, nor is the Quadro K420 card.
Check vendor specification and datasheets to confirm that your hardware meets these requirements.
The lspci -v command can be used to print information for PCI devices already installed on a system.
vGPU-compatible GPU
Select a vGPU type and the number of instances that you would like to use with this virtual
machine using the Manage vGPU dialog in the Administration Portal Host Devices tab of the
virtual machine.
By default, Red Hat Enterprise Linux allows outbound traffic to DNS and NTP on any destination
address. If you disable outgoing traffic, define exceptions for requests that are sent to DNS and NTP
servers.
IMPORTANT
12
CHAPTER 2. REQUIREMENTS
IMPORTANT
The Red Hat Virtualization Manager and all hosts (Red Hat Virtualization Host
and Red Hat Enterprise Linux host) must have a fully qualified domain name and
full, perfectly-aligned forward and reverse name resolution.
Use DNS instead of the /etc/hosts file for name resolution. Using a hosts file
typically requires more work and has a greater chance for errors.
By default, Red Hat Enterprise Linux allows outbound IPMI traffic to ports on any destination address. If
you disable outgoing traffic, make exceptions for requests being sent to your IPMI or fencing servers.
Each Red Hat Virtualization Host and Red Hat Enterprise Linux host in the cluster must be able to
connect to the fencing devices of all other hosts in the cluster. If the cluster hosts are experiencing an
error (network error, storage error…) and cannot function as hosts, they must be able to connect to
other hosts in the data center.
The specific port number depends on the type of the fence agent you are using and how it is configured.
The firewall requirement tables in the following sections do not represent this option.
NOTE
13
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
REST API
clients
14
CHAPTER 2. REQUIREMENTS
15
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
A port for the OVN northbound database (6641) is not listed because, in the
default configuration, the only client for the OVN northbound database (6641) is
ovirt-provider-ovn. Because they both run on the same host, their
communication is not visible to the network.
By default, Red Hat Enterprise Linux allows outbound traffic to DNS and NTP on
any destination address. If you disable outgoing traffic, make exceptions for the
Manager to send requests to DNS and NTP servers. Other nodes may also
require DNS and NTP. In that case, consult the requirements for those nodes and
configure the firewall accordingly.
16
CHAPTER 2. REQUIREMENTS
To disable automatic firewall configuration when adding a new host, clear the Automatically configure
host firewall check box under Advanced Parameters.
To customize the host firewall rules, see RHV: How to customize the Host’s firewall rules? .
NOTE
17
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Optional.
18
CHAPTER 2. REQUIREMENTS
Optional.
19
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
H11 54322 TCP Red Hat Red Hat Required for Yes
Virtualizatio Virtualizatio communicat
n Manager n Hosts ion with the
ovirt- ovirt-
imageio Red Hat imageo
service Enterprise service.
Linux hosts
20
CHAPTER 2. REQUIREMENTS
H15 4500 TCP, UDP Red Hat Red Hat Internet Yes
Virtualizatio Virtualizatio Security
n Hosts n Hosts Protocol
(IPSec)
NOTE
By default, Red Hat Enterprise Linux allows outbound traffic to DNS and NTP on any
destination address. If you disable outgoing traffic, make exceptions for the Red Hat
Virtualization Hosts
Red Hat Enterprise Linux hosts to send requests to DNS and NTP servers. Other nodes
may also require DNS and NTP. In that case, consult the requirements for those nodes
and configure the firewall accordingly.
21
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Similarly, if you plan to access a local or remote Data Warehouse database from an external system, the
database must allow connections from that system.
IMPORTANT
NOTE
D1 5432 TCP, Red Hat Manager (engine) Default port for No, but
UDP Virtualization database server PostgreSQL can be
Manager database enabled.
Data Warehouse connections.
Data Warehouse (ovirt-engine-
service history ) database
server
D2 5432 TCP, External systems Data Warehouse Default port for Disabled
UDP (ovirt-engine- PostgreSQL by default.
history ) database database No, but
server connections. can be
enabled.
22
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
2. Install a second Red Hat Enterprise Linux machine to use for the databases. This machine will be
referred to as the remote server.
To install the Red Hat Virtualization Manager on a system that does not have access to the Content
Delivery Network, see Configuring an Offline Repository for Installation before configuring the Manager.
Procedure
1. Register your system with the Content Delivery Network, entering your Customer Portal user
name and password when prompted:
# subscription-manager register
NOTE
If you are using an IPv6 network, use an IPv6 transition mechanism to access the
Content Delivery Network and subscription manager.
2. Find the Red Hat Virtualization Manager subscription pool and record the pool ID:
NOTE
23
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
# dnf repolist
# subscription-manager repos \
--disable='*' \
--enable=rhel-8-for-x86_64-baseos-eus-rpms \
--enable=rhel-8-for-x86_64-appstream-eus-rpms \
--enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
--enable=fast-datapath-for-rhel-8-x86_64-rpms \
--enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
--enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
--enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
Additional resources
For information on modules and module streams, see the following sections in Installing, managing, and
removing user-space components
Module streams
24
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
Before configuring the Red Hat Virtualization Manager, you must manually configure the Manager
database on the remote server. You can also use this procedure to manually configure the Data
Warehouse database if you do not want the Data Warehouse setup script to configure it automatically.
NOTE
IMPORTANT
The database name must contain only numbers, underscores, and lowercase letters.
Procedure
1. Register your system with the Content Delivery Network, entering your Customer Portal user
name and password when prompted:
# subscription-manager register
NOTE
If you are using an IPv6 network, use an IPv6 transition mechanism to access the
Content Delivery Network and subscription manager.
2. Find the Red Hat Virtualization Manager subscription pool and record the pool ID:
NOTE
25
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
# dnf repolist
# subscription-manager repos \
--disable='*' \
--enable=rhel-8-for-x86_64-baseos-eus-rpms \
--enable=rhel-8-for-x86_64-appstream-eus-rpms \
--enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
--enable=fast-datapath-for-rhel-8-x86_64-rpms \
--enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
--enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
--enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
Additional resources
For information on modules and module streams, see the following sections in Installing, managing, and
removing user-space components
Module streams
26
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
# postgresql-setup --initdb
3. Enable the postgresql service and configure it to start when the machine boots:
# su - postgres -c psql
postgres=# \c database_name
database_name=# \q
11. Edit the /var/lib/pgsql/data/pg_hba.conf file to enable md5 client authentication, so that the
engine can access the database remotely. Add the following line immediately below the line
that starts with local at the bottom of the file. Replace X.X.X.X with the IP address of the
Manager or Data Warehouse machine, and replace 0-32 or 0-128 with the CIDR mask length:
For example:
27
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
12. Allow TCP/IP connections to the database. Edit the /var/lib/pgsql/data/postgresql.conf file
and add the following line:
listen_addresses='*'
This example configures the postgresql service to listen for connections on all interfaces. You
can specify an interface by giving its IP address.
autovacuum_vacuum_scale_factor=0.01
autovacuum_analyze_scale_factor=0.075
autovacuum_max_workers=6
maintenance_work_mem=65536
max_connections=150
work_mem=8192
14. Open the default port used for PostgreSQL database connections, and save the updated
firewall rules:
IMPORTANT
The engine-setup command guides you through several distinct configuration stages,
each comprising several steps that require user input. Suggested configuration defaults
are provided in square brackets; if the suggested value is acceptable for a given step,
press Enter to accept that value.
You can run engine-setup --accept-defaults to automatically accept all questions that
have default answers. This option should be used with caution and only if you are familiar
with engine-setup.
28
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
Procedure
NOTE
3. Run the engine-setup command to begin configuring the Red Hat Virtualization Manager:
# engine-setup
4. Optional: Type Yes and press Enter to set up Cinderlib integration on this machine:
IMPORTANT
6. Optional: Install Open Virtual Network (OVN). Selecting Yes installs an OVN server on the
Manager machine and adds it to Red Hat Virtualization as an external network provider. This
action also configures the Default cluster to use OVN as its default network provider.
IMPORTANT
Also see the "Next steps" in Adding Open Virtual Network (OVN) as an External
Network Provider in the Administration Guide.
Configuring ovirt-provider-ovn also sets the Default cluster’s default network provider to ovirt-
provider-ovn.
Non-Default clusters may be configured with an OVN after installation.
29
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
For more information on using OVN networks in Red Hat Virtualization, see Adding Open Virtual
Network (OVN) as an External Network Provider in the Administration Guide.
7. Optional: Allow engine-setup to configure a WebSocket Proxy server for allowing users to
connect to virtual machines through the noVNC console:
IMPORTANT
The WebSocket Proxy and noVNC are Technology Preview features only.
Technology Preview features are not supported with Red Hat production service-
level agreements (SLAs) and might not be functionally complete, and Red Hat
does not recommend using them for production. These features provide early
access to upcoming product features, enabling customers to test functionality
and provide feedback during the development process. For more information see
Red Hat Technology Preview Features Support Scope .
8. To configure Data Warehouse on a remote server, answer No and see Installing and Configuring
Data Warehouse on a Separate Machine after completing the Manager configuration.
Please note: Data Warehouse is required for the engine. If you choose to not configure it on
this host, you have to configure it on a remote host, and then configure the engine on this
host so that it can access the database of the remote Data Warehouse host.
Configure Data Warehouse on this host (Yes, No) [Yes]:
IMPORTANT
Red Hat only supports installing the Data Warehouse database, the Data
Warehouse service, and Grafana all on the same machine as each other.
9. To configure Grafana on the same machine as the Data Warehouse service, enter No:
10. Optional: Allow access to a virtual machine’s serial console from the command line.
Additional configuration is required on the client machine to use this feature. See Opening a
Serial Console to a Virtual Machine in the Virtual Machine Management Guide .
11. Press Enter to accept the automatically detected host name, or enter an alternative host name
and press Enter. Note that the automatically detected host name may be incorrect if you are
using virtual hosts.
Host fully qualified DNS name of this server [autodetected host name]:
12. The engine-setup command checks your firewall configuration and offers to open the ports
used by the Manager for external communication, such as ports 80 and 443. If you do not allow
30
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
engine-setup to modify your firewall configuration, you must manually open the ports used by
the Manager. firewalld is configured as the firewall manager.
If you choose to automatically configure the firewall, and no firewall managers are active, you
are prompted to select your chosen firewall manager from a list of supported options. Type the
name of the firewall manager and press Enter. This applies even in cases where only one option
is listed.
13. Specify whether to configure the Manager database on this machine, or on another machine:
NOTE
If you select Remote, input the following values for the preconfigured remote database server.
Replace localhost with the ip address or FQDN of the remote database server:
14. Set a password for the automatically created administrative user of the Red Hat Virtualization
Manager:
Gluster - only allows you to manage GlusterFS from the Administration Portal.
NOTE
16. If you installed the OVN provider, you can choose to use the default credentials, or specify an
31
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
16. If you installed the OVN provider, you can choose to use the default credentials, or specify an
alternative.
17. Set the default value for the wipe_after_delete flag, which wipes the blocks of a virtual disk
when the disk is deleted.
18. The Manager uses certificates to communicate securely with its hosts. This certificate can also
optionally be used to secure HTTPS communications with the Manager. Provide the
organization name for the certificate:
19. Optionally allow engine-setup to make the landing page of the Manager the default page
presented by the Apache web server:
Setup can configure the default page of the web server to present the application home
page. This may conflict with existing applications.
Do you wish to set the application as the default web page of the server? (Yes, No) [Yes]:
20. By default, external SSL (HTTPS) communication with the Manager is secured with the self-
signed certificate created earlier in the configuration to securely communicate with hosts.
Alternatively, choose another certificate for external HTTPS connections; this does not affect
how the Manager communicates with hosts:
Setup can configure apache to use SSL using a certificate issued from the internal CA.
Do you wish Setup to configure that, or prefer to perform that manually? (Automatic, Manual)
[Automatic]:
21. You can specify a unique password for the Grafana admin user, or use same one as the
Manager admin password:
Use Engine admin password as initial Grafana admin password (Yes, No) [Yes]:
22. Review the installation settings, and press Enter to accept the values and proceed with the
installation:
When your environment has been configured, engine-setup displays details about how to access your
environment.
Next steps
If you chose to manually configure the firewall, engine-setup provides a custom list of ports that need
to be opened, based on the options selected during setup. engine-setup also saves your answers to a
file that can be used to reconfigure the Manager using the same values, and outputs the location of the
log file for the Red Hat Virtualization Manager configuration process.
32
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
If you intend to link your Red Hat Virtualization environment with a directory server, configure
the date and time to synchronize with the system clock used by the directory server to avoid
unexpected account expiry issues. See Synchronizing the System Clock with a Remote Server in
the Red Hat Enterprise Linux System Administrator’s Guide for more information.
Install the certificate authority according to the instructions provided by your browser. You can
get the certificate authority’s certificate by navigating to http://<manager-fqdn>/ovirt-
engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA, replacing
<manager-fqdn> with the FQDN that you provided during the installation.
Install the Data Warehouse service and database on the remote server:
NOTE
Red Hat only supports installing the Data Warehouse database, the Data Warehouse
service and Grafana all on the same machine as each other, even though you can install
each of these components on separate machines from each other.
Prerequisites
Procedure
1. Register your system with the Content Delivery Network, entering your Customer Portal user
name and password when prompted:
# subscription-manager register
NOTE
If you are using an IPv6 network, use an IPv6 transition mechanism to access the
Content Delivery Network and subscription manager.
2. Find the Red Hat Virtualization Manager subscription pool and record the pool ID:
33
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
# dnf repolist
# subscription-manager repos \
--disable='*' \
--enable=rhel-8-for-x86_64-baseos-eus-rpms \
--enable=rhel-8-for-x86_64-appstream-eus-rpms \
--enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
--enable=fast-datapath-for-rhel-8-x86_64-rpms \
--enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
--enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
--enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
Additional resources
For information on modules and module streams, see the following sections in Installing, managing, and
removing user-space components
Module streams
34
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
Procedure
# engine-setup
7. Press Enter to accept the automatically-detected host name, or enter an alternative host name
and press Enter:
8. Press Enter to automatically configure the firewall, or type No and press Enter to maintain
existing settings:
If you choose to automatically configure the firewall, and no firewall managers are active, you
are prompted to select your chosen firewall manager from a list of supported options. Type the
name of the firewall manager and press Enter. This applies even in cases where only one option
is listed.
9. Enter the fully qualified domain name of the Manager machine, and then press Enter:
35
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
10. Press Enter to allow setup to sign the certificate on the Manager via SSH:
Setup will need to do some actions on the remote engine server. Either automatically, using
ssh as root to access it, or you will be prompted to manually perform each such action.
Please choose one of the following:
1 - Access remote engine server using ssh as root
2 - Perform each action manually, use files to copy content around
(1, 2) [1]:
11. Press Enter to accept the default SSH port, or enter an alternative port number and then press
Enter:
13. Specify whether to host the Data Warehouse database on this machine (Local), or on another
machine (Remote).:
NOTE
Red Hat only supports installing the Data Warehouse database, the Data
Warehouse service and Grafana all on the same machine as each other, even
though you can install each of these components on separate machines from
each other.
If you select Local, the engine-setup script can configure your database automatically
(including adding a user and a database), or it can connect to a preconfigured local
database:
Setup can configure the local postgresql server automatically for the DWH to run. This
may conflict with existing applications.
Would you like Setup to automatically configure postgresql and create DWH database, or
prefer to perform that manually? (Automatic, Manual) [Automatic]:
If you select Manual, input the following values for the manually-configured local
database:
If you select Remote, you are prompted to provide details about the remote database host.
Input the following values for the preconfigured remote database host:
36
CHAPTER 3. INSTALLING THE RED HAT VIRTUALIZATION MANAGER
If you select Remote, you are prompted to enter the username and password for the
Grafana database user:
14. Enter the fully qualified domain name and password for the Manager database machine. If you
are installing the Data Warehouse database on the same machine where the Manager database
is installed, use the same FQDN. Press Enter to accept the default values in each other field:
15. Choose how long Data Warehouse will retain collected data:
Full uses the default values for the data storage settings listed in Application Settings for the
Data Warehouse service in ovirt-engine-dwhd.conf (recommended when Data Warehouse is
installed on a remote host).
17. After the Data Warehouse configuration is complete, on the Red Hat Virtualization Manager,
restart the ovirt-engine service:
Log in to the Administration Portal, where you can add hosts and storage to the environment:
37
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
You can access the Administration Portal using alternate host names or IP
addresses. To do so, you need to add a configuration file under /etc/ovirt-
engine/engine.conf.d/. For example:
# vi /etc/ovirt-engine/engine.conf.d/99-custom-sso-setup.conf
SSO_ALTERNATE_ENGINE_FQDNS="alias1.example.com
alias2.example.com"
The list of alternate host names needs to be separated by spaces. You can also
add the IP address of the Manager to the list, but using IP addresses instead of
DNS-resolvable host names is not recommended.
2. Click Administration Portal. An SSO login page displays. SSO login enables you to log in to the
Administration and VM Portal at the same time.
3. Enter your User Name and Password. If you are logging in for the first time, use the user name
admin along with the password that you specified during installation.
4. Select the Domain to authenticate against. If you are logging in using the internal admin user
name, select the internal domain.
6. You can view the Administration Portal in multiple languages. The default selection is chosen
based on the locale settings of your web browser. If you want to view the Administration Portal in
a language other than the default, select your preferred language from the drop-down list on
the welcome page.
To log out of the Red Hat Virtualization Administration Portal, click your user name in the header bar
and click Sign Out. You are logged out of all portals and the Manager welcome screen displays.
38
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
See Recommended practices for configuring host networks for networking information.
IMPORTANT
SELinux is in enforcing mode upon installation. To verify, run getenforce. SELinux must
be in enforcing mode on all hosts and Managers for your Red Hat Virtualization
environment to be supported.
Red Hat Virtualization Host RHVH, thin host This is a minimal operating system
based on Red Hat Enterprise
Linux. It is distributed as an ISO
file from the Customer Portal and
contains only the packages
required for the machine to act as
a host.
Red Hat Enterprise Linux host RHEL host, thick host Red Hat Enterprise Linux systems
with the appropriate subscriptions
attached can be used as hosts.
Host Compatibility
When you create a new data center, you can set the compatibility version. Select the compatibility
version that suits all the hosts in the data center. Once set, version regression is not allowed. For a fresh
Red Hat Virtualization installation, the latest compatibility version is set in the default data center and
default cluster; to use an earlier compatibility version, you must create additional data centers and
clusters. For more information about compatibility versions see Red Hat Virtualization Manager
Compatibility in Red Hat Virtualization Life Cycle .
RHVH supports NIST 800-53 partitioning requirements to improve security. RHVH uses a NIST 800-53
partition layout by default.
39
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
WARNING
When installing or reinstalling the host’s operating system, Red Hat strongly
recommends that you first detach any existing non-OS storage that is attached to
the host to avoid accidental initialization of these disks, and with that, potential data
loss.
Procedure
1. Go to the Get Started with Red Hat Virtualization on the Red Hat Customer Portal and log in.
3. Choose the appropriate Hypervisor Image for RHV from the list and click Download Now.
4. Start the machine on which you are installing RHVH, booting from the prepared installation
media.
5. From the boot menu, select Install RHVH 4.4 and press Enter.
NOTE
You can also press the Tab key to edit the kernel parameters. Kernel parameters
must be separated by a space, and you can boot the system using the specified
kernel parameters by pressing the Enter key. Press the Esc key to clear any
changes to the kernel parameters and return to the boot menu.
7. Select a keyboard layout from the Keyboard Layout screen and click Done.
8. Select the device on which to install RHVH from the Installation Destination screen. Optionally,
enable encryption. Click Done.
IMPORTANT
9. Select a time zone from the Time & Date screen and click Done.
10. Select a network from the Network & Host Name screen and click Configure… to configure the
connection details.
NOTE
40
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
NOTE
To use the connection every time the system boots, select the Connect
automatically with priority check box. For more information, see Configuring
network and host name options in the Red Hat Enterprise Linux 8 Installation
Guide.
Enter a host name in the Host Name field, and click Done.
11. Optional: Configure Security Policy and Kdump. See Customizing your RHEL installation using
the GUI in Performing a standard RHEL installation for Red Hat Enterprise Linux 8 for more
information on each of the sections in the Installation Summary screen.
13. Set a root password and, optionally, create an additional user while RHVH installs.
WARNING
NOTE
When RHVH restarts, nodectl check performs a health check on the host and
displays the result when you log in on the command line. The message node
status: OK or node status: DEGRADED indicates the health status. Run
nodectl check to get more information.
NOTE
1. Enable the Red Hat Virtualization Host 8 repository to allow later updates to the Red Hat
Virtualization Host:
41
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
2. Click Terminal.
NOTE
You can also configure virtual machine subscriptions in Red Hat Satellite using virt-who.
See Using virt-who to manage host-based subscriptions .
Custom partitioning on Red Hat Virtualization Host (RHVH) is not recommended. Use the
Automatically configure partitioning option in the Installation Destination window.
If your installation requires custom partitioning, select the I will configure partitioning option during
the installation, and note that the following restrictions apply:
Ensure the default LVM Thin Provisioning option is selected in the Manual Partitioning
window.
The following directories are required and must be on thin provisioned logical volumes:
root (/)
/home
/tmp
/var
/var/crash
/var/log
/var/log/audit
IMPORTANT
Do not create a separate partition for /usr. Doing so will cause the installation
to fail.
/usr must be on a logical volume that is able to change versions along with
RHVH, and therefore should be left on root (/).
42
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
For information about the required storage sizes for each partition, see Storage
Requirements.
The following example demonstrates how to configure manual partitioning in a Kickstart file.
clearpart --all
part /boot --fstype xfs --size=1000 --ondisk=sda
part pv.01 --size=42000 --grow
volgroup HostVG pv.01 --reserved-percent=20
logvol swap --vgname=HostVG --name=swap --fstype=swap --recommended
logvol none --vgname=HostVG --name=HostPool --thinpool --size=40000 --grow
logvol / --vgname=HostVG --name=root --thin --fstype=ext4 --poolname=HostPool --
fsoptions="defaults,discard" --size=6000 --grow
logvol /var --vgname=HostVG --name=var --thin --fstype=ext4 --poolname=HostPool
--fsoptions="defaults,discard" --size=15000
logvol /var/crash --vgname=HostVG --name=var_crash --thin --fstype=ext4 --poolname=HostPool --
fsoptions="defaults,discard" --size=10000
logvol /var/log --vgname=HostVG --name=var_log --thin --fstype=ext4 --poolname=HostPool --
fsoptions="defaults,discard" --size=8000
logvol /var/log/audit --vgname=HostVG --name=var_audit --thin --fstype=ext4 --poolname=HostPool -
-fsoptions="defaults,discard" --size=2000
logvol /home --vgname=HostVG --name=home --thin --fstype=ext4 --poolname=HostPool --
fsoptions="defaults,discard" --size=1000
logvol /tmp --vgname=HostVG --name=tmp --thin --fstype=ext4 --poolname=HostPool --
fsoptions="defaults,discard" --size=1000
NOTE
If you use logvol --thinpool --grow, you must also include volgroup --reserved-space or
volgroup --reserved-percent to reserve space in the volume group for the thin pool to
grow.
There are times when installing Red Hat Virtualization Host (RHVH) requires a Driver Update Disk
(DUD), such as when using a hardware RAID device that is not supported by the default configuration of
RHVH. In contrast with Red Hat Enterprise Linux hosts, RHVH does not fully support using a DUD.
Subsequently the host fails to boot normally after installation because it does not see RAID. Instead it
boots into emergency mode.
Example output:
In such a case you can manually add the drivers before finishing the installation.
43
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Prerequisites
A DUD.
If you are using a USB drive for the DUD and RHVH, you must have at least two available USB
ports.
Procedure
2. Install RHVH. See Installing Red Hat Virtualization Hosts in Installing Red Hat Virtualization as a
self-hosted engine using the command line.
IMPORTANT
TIP
<kernel_command_line> inst.sshd
3. Enter the console mode, by pressing Ctrl + Alt + F3. Alternatively you can connect to it using
SSH.
# mkdir /mnt/dud
# mount -r /dev/<dud_device> /mnt/dud
5. Copy the RPM file inside the DUD to the target machine’s disk:
# cp /mnt/dud/rpms/<path>/<rpm_file>.rpm /mnt/sysroot/root/
For example:
# cp /mnt/dud/rpms/x86_64/kmod-3w-9xxx-2.26.02.014-5.el8_3.elrepo.x86_64.rpm
/mnt/sysroot/root/
# chroot /mnt/sysroot
44
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
# cp -p /boot/initramfs-4.18.0-240.15.1.el8_3.x86_64.img /boot/initramfs-4.18.0-
240.15.1.el8_3.x86_64.img.bck1
# cp -p /boot/rhvh-4.4.5.1-0.20210323.0+1/initramfs-4.18.0-240.15.1.el8_3.x86_64.img
/boot/rhvh-4.4.5.1-0.20210323.0+1/initramfs-4.18.0-240.15.1.el8_3.x86_64.img.bck1
8. Install the RPM file for the driver from the copy you made earlier.
For example:
NOTE
This package is not visible on the system after you reboot into the installed
environment, so if you need it, for example, to rebuild the initramfs, you need to
install that package once again, after which the package remains.
If you update the host using dnf, the driver update persists, so you do not need to
repeat this process.
TIP
If you do not have an internet connection, use the rpm command instead of dnf:
For example:
10. Check the results. The new image should be larger, and include the driver. For example,
compare the sizes of the original, backed-up image file and the new image file.
In this example, the new image file is 88739013 bytes, larger than the original 88717417 bytes:
# ls -ltr /boot/initramfs-4.18.0-240.15.1.el8_3.x86_64.img*
-rw-------. 1 root root 88717417 Jun 2 14:29 /boot/initramfs-4.18.0-
240.15.1.el8_3.x86_64.img.bck1
-rw-------. 1 root root 88739013 Jun 2 17:47 /boot/initramfs-4.18.0-
240.15.1.el8_3.x86_64.img
The new drivers should be part of the image file. For example, the 3w-9xxx module should be
included:
45
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
240.el8.x86_64/extra/3w-9xxx/3w-9xxx.ko
drwxr-xr-x 2 root root 0 Feb 22 15:57 usr/lib/modules/4.18.0-
240.el8.x86_64/extra/3w-9xxx
-rw-r--r-- 1 root root 80121 Nov 10 2020 usr/lib/modules/4.18.0-
240.el8.x86_64/extra/3w-9xxx/3w-9xxx.ko
11. Copy the image to the the directory under /boot that contains the kernel to be used in the layer
being installed, for example:
# cp -p /boot/initramfs-4.18.0-240.15.1.el8_3.x86_64.img /boot/rhvh-4.4.5.1-
0.20210323.0+1/initramfs-4.18.0-240.15.1.el8_3.x86_64.img
14. If you used Ctrl + Alt + F3 to access a virtual terminal, then move back to the installer by
pressing Ctrl + Alt + F_<n>_, usually F1 or F5
Verification
The machine should reboot successfully.
You can install Red Hat Virtualization Host (RHVH) without a physical media device by booting from a
PXE server over the network with a Kickstart file that contains the answers to the installation questions.
WARNING
When installing or reinstalling the host’s operating system, Red Hat strongly
recommends that you first detach any existing non-OS storage that is attached to
the host to avoid accidental initialization of these disks, and with that, potential data
loss.
General instructions for installing from a PXE server with a Kickstart file are available in the Red Hat
Enterprise Linux Installation Guide, as RHVH is installed in much the same way as Red Hat Enterprise
Linux. RHVH-specific instructions, with examples for deploying RHVH with Red Hat Satellite, are
described below.
46
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
1. Go to the Get Started with Red Hat Virtualization on the Red Hat Customer Portal and log in.
3. Choose the appropriate Hypervisor Image for RHV from the list and click Download Now.
4. Make the RHVH ISO image available over the network. See Installation Source on a Network in
the Red Hat Enterprise Linux Installation Guide .
5. Extract the squashfs.img hypervisor image file from the RHVH ISO:
NOTE
1. Configure the PXE server. See Preparing for a Network Installation in the Red Hat Enterprise
Linux Installation Guide.
# cp mnt/rhvh/images/pxeboot/{vmlinuz,initrd.img} /var/lib/tftpboot/pxelinux/
3. Create a rhvh label specifying the RHVH boot images in the boot loader configuration:
LABEL rhvh
MENU LABEL Install Red Hat Virtualization Host
KERNEL /var/lib/tftpboot/pxelinux/vmlinuz
APPEND initrd=/var/lib/tftpboot/pxelinux/initrd.img inst.stage2=URL/to/RHVH-ISO
<%#
kind: PXELinux
name: RHVH PXELinux
%>
# Created for booting new hosts
#
47
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
DEFAULT rhvh
LABEL rhvh
KERNEL <%= @kernel %>
APPEND initrd=<%= @initrd %> inst.ks=<%= foreman_url("provision") %> inst.stage2=<%=
@host.params["rhvh_image"] %> intel_iommu=on console=tty0 console=ttyS1,115200n8
ssh_pwauth=1 local_boot_trigger=<%= foreman_url("built") %>
IPAPPEND 2
4. Make the content of the RHVH ISO locally available and export it to the network, for example,
using an HTTPD server:
# cp -a /mnt/rhvh/ /var/www/html/rhvh-install
# curl URL/to/RHVH-ISO/rhvh-install
1. Create a Kickstart file and make it available over the network. See Kickstart Installations in the
Red Hat Enterprise Linux Installation Guide .
2. Ensure that the Kickstart file meets the following RHV-specific requirements:
The %packages section is not required for RHVH. Instead, use the liveimg option and
specify the redhat-virtualization-host-version_number_version.squashfs.img file from
the RHVH ISO image:
liveimg --url=example.com/tmp/usr/share/redhat-virtualization-host/image/redhat-
virtualization-host-version_number_version.squashfs.img
Autopartitioning is highly recommended, but use caution: ensure that the local disk is
detected first, include the ignoredisk command, and specify the local disk to ignore, such
as sda. To ensure that a particular drive is used, Red Hat recommends using ignoredisk --
only-use=/dev/disk/<path> or ignoredisk --only-use=/dev/disk/<ID>:
autopart --type=thinp
ignoredisk --only-use=sda
ignoredisk --only-use=/dev/disk/<path>
ignoredisk --only-use=/dev/disk/<ID>
NOTE
The --no-home option does not work in RHVH because /home is a required
directory.
If your installation requires manual partitioning, see Custom Partitioning for a list of
limitations that apply to partitions and an example of manual partitioning in a Kickstart file.
%post
nodectl init
%end
48
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
NOTE
Ensure that the nodectl init command is at the very end of the %post
section but before the reboot code, if any.
WARNING
This example assumes that all disks are empty and can be initialized. If
you have attached disks with data, either remove them or add them to
the ignoredisks property.
liveimg --url=http://FQDN/tmp/usr/share/redhat-virtualization-host/image/redhat-
virtualization-host-version_number_version.squashfs.img
clearpart --all
autopart --type=thinp
rootpw --plaintext ovirt
timezone --utc America/Phoenix
zerombr
text
reboot
%post --erroronfail
nodectl init
%end
WARNING
This example assumes that all disks are empty and can be initialized. If
you have attached disks with data, either remove them or add them to
the ignoredisks property.
49
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
<%#
kind: provision
name: RHVH Kickstart default
oses:
- RHVH
%>
install
liveimg --url=<%= @host.params['rhvh_image'] %>squashfs.img
zerombr
clearpart --all
autopart --type=thinp
# installation answers
lang en_US.UTF-8
timezone <%= @host.params['time-zone'] || 'UTC' %>
keyboard us
firewall --service=ssh
services --enabled=sshd
text
reboot
sync
systemctl reboot
%end
3. Add the Kickstart file location to the boot loader configuration file on the PXE server:
4. Install RHVH following the instructions in Booting from the Network Using PXE in the Red Hat
Enterprise Linux Installation Guide.
A Red Hat Enterprise Linux host is based on a standard basic installation of Red Hat Enterprise Linux 8
50
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
A Red Hat Enterprise Linux host is based on a standard basic installation of Red Hat Enterprise Linux 8
on a physical server, with the Red Hat Enterprise Linux Server and Red Hat Virtualization
subscriptions attached.
For detailed installation instructions, see the Performing a standard RHEL installation .
WARNING
When installing or reinstalling the host’s operating system, Red Hat strongly
recommends that you first detach any existing non-OS storage that is attached to
the host to avoid accidental initialization of these disks, and with that, potential data
loss.
IMPORTANT
Virtualization must be enabled in your host’s BIOS settings. For information on changing
your host’s BIOS settings, refer to your host’s hardware documentation.
IMPORTANT
Do not install third-party watchdogs on Red Hat Enterprise Linux hosts. They can
interfere with the watchdog daemon provided by VDSM.
Procedure
1. Register your system with the Content Delivery Network, entering your Customer Portal user
name and password when prompted:
# subscription-manager register
2. Find the Red Hat Enterprise Linux Server and Red Hat Virtualization subscription pools and
record the pool IDs:
NOTE
51
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
# dnf repolist
# subscription-manager repos \
--disable='*' \
--enable=rhel-8-for-x86_64-baseos-eus-rpms \
--enable=rhel-8-for-x86_64-appstream-eus-rpms \
--enable=rhv-4-mgmt-agent-for-rhel-8-x86_64-rpms \
--enable=fast-datapath-for-rhel-8-x86_64-rpms \
--enable=advanced-virt-for-rhel-8-x86_64-rpms \
--enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
--enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
For Red Hat Enterprise Linux 8 hosts, little endian, on IBM POWER8 or IBM POWER9 hardware:
# subscription-manager repos \
--disable='*' \
--enable=rhv-4-mgmt-agent-for-rhel-8-ppc64le-rpms \
--enable=rhv-4-tools-for-rhel-8-ppc64le-rpms \
--enable=advanced-virt-for-rhel-8-ppc64le-rpms \
--enable=rhel-8-for-ppc64le-appstream-rpms \
--enable=rhel-8-for-ppc64le-baseos-rpms \
--enable=fast-datapath-for-rhel-8-ppc64le-rpms \
NOTE
Procedure
52
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
# firewall-cmd --list-services
You should see cockpit listed. If it is not, enter the following with root permissions to add
cockpit as a service to your firewall:
The --permanent option keeps the cockpit service active after rebooting.
IMPORTANT
Always use the RHV Manager to modify the network configuration of hosts in your
clusters. Otherwise, you might create an unsupported configuration. For details, see
Network Manager Stateful Configuration (nmstate) .
If your network environment is complex, you may need to configure a host network manually before
adding the host to the Red Hat Virtualization Manager.
Configure the network with Cockpit. Alternatively, you can use nmtui or nmcli.
If a network is not required for a self-hosted engine deployment or for adding a host to the
Manager, configure the network in the Administration Portal after adding the host to the
Manager. See Creating a New Logical Network in a Data Center or Cluster .
Use network bonding. Network teaming is not supported in Red Hat Virtualization and will cause
53
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Use network bonding. Network teaming is not supported in Red Hat Virtualization and will cause
errors if the host is used to deploy a self-hosted engine or added to the Manager.
If the ovirtmgmt network is not used by virtual machines, the network may use any
supported bonding mode.
If the ovirtmgmt network is used by virtual machines, see Which bonding modes work when
used with a bridge that virtual machine guests or containers connect to?.
Red Hat Virtualization’s default bonding mode is (Mode 4) Dynamic Link Aggregation. If
your switch does not support Link Aggregation Control Protocol (LACP), use (Mode 1)
Active-Backup. See Bonding Modes for details.
Configure a VLAN on a physical NIC as in the following example (although nmcli is used, you
can use any tool):
# nmcli connection add type vlan con-name vlan50 ifname eth0.50 dev eth0 id 50
# nmcli con mod vlan50 +ipv4.dns 8.8.8.8 +ipv4.addresses 123.123.0.1/24 +ipv4.gateway
123.123.0.254
Configure a VLAN on a bond as in the following example (although nmcli is used, you can use
any tool):
# nmcli connection add type bond con-name bond0 ifname bond0 bond.options
"mode=active-backup,miimon=100" ipv4.method disabled ipv6.method ignore
# nmcli connection add type ethernet con-name eth0 ifname eth0 master bond0 slave-type
bond
# nmcli connection add type ethernet con-name eth1 ifname eth1 master bond0 slave-type
bond
# nmcli connection add type vlan con-name vlan50 ifname bond0.50 dev bond0 id 50
# nmcli con mod vlan50 +ipv4.dns 8.8.8.8 +ipv4.addresses 123.123.0.1/24 +ipv4.gateway
123.123.0.254
Customize the firewall rules in the Administration Portal after adding the host to the Manager.
See Configuring Host Firewall Rules .
IMPORTANT
Always use the RHV Manager to modify the network configuration of hosts in your
clusters. Otherwise, you might create an unsupported configuration. For details, see
Network Manager Stateful Configuration (nmstate) .
Adding a host to your Red Hat Virtualization environment can take some time, as the following steps are
completed by the platform: virtualization checks, installation of packages, and creation of a bridge.
Procedure
54
CHAPTER 4. INSTALLING HOSTS FOR RED HAT VIRTUALIZATION
2. Click New.
3. Use the drop-down list to select the Data Center and Host Cluster for the new host.
4. Enter the Name and the Address of the new host. The standard SSH port, port 22, is auto-filled
in the SSH Port field.
5. Select an authentication method to use for the Manager to access the host.
6. Optionally, click the Advanced Parameters button to change the following advanced host
settings:
Add a host SSH fingerprint to increase security. You can add it manually, or fetch it
automatically.
7. Optionally configure power management, where the host has a supported power management
card. For information on power management configuration, see Host Power Management
Settings Explained in the Administration Guide.
8. Click OK.
The new host displays in the list of hosts with a status of Installing, and you can view the progress of the
installation in the Events section of the Notification Drawer ( ). After a brief delay the host status
changes to Up.
55
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
WARNING
When installing or reinstalling the host’s operating system, Red Hat strongly
recommends that you first detach any existing non-OS storage that is attached to
the host to avoid accidental initialization of these disks, and with that, potential data
loss.
A data domain holds the virtual hard disks and OVF files of all the virtual machines and templates in a
data center, and cannot be shared across data centers while active (but can be migrated between data
centers). Data domains of multiple storage types can be added to the same data center, provided they
are all shared, rather than local, domains.
NFS
iSCSI
Local storage
For information on setting up, configuring, mounting and exporting NFS, see Managing file systems for
Red Hat Enterprise Linux 8.
Specific system user accounts and system user groups are required by Red Hat Virtualization so the
Manager can store data in the storage domains represented by the exported directories. The following
procedure sets the permissions for one directory. You must repeat the chown and chmod steps for all
of the directories you intend to use as storage domains in Red Hat Virtualization.
Prerequisites
56
CHAPTER 5. PREPARING STORAGE FOR RED HAT VIRTUALIZATION
# cat /proc/fs/nfsd/versions
Procedure
# groupadd kvm -g 36
# mkdir /storage
# chmod 0755 /storage
# chown 36:36 /storage/
# vi /etc/exports
# cat /etc/exports
/storage *(rw)
# exportfs
/nfs_server/srv
10.46.11.3/24
/nfs_server <world>
NOTE
57
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
If changes in /etc/exports have been made after starting the services, the exportfs -ra
command can be used to reload the changes. After performing all the above stages, the
exports directory should be ready and can be tested on a different host to check that it is
usable.
For information on setting up and configuring iSCSI storage, see Configuring an iSCSI target in
Managing storage devices for Red Hat Enterprise Linux 8.
IMPORTANT
If you are using block storage and intend to deploy virtual machines on raw devices or
direct LUNs and manage them with the Logical Volume Manager (LVM), you must create
a filter to hide guest logical volumes. This will prevent guest logical volumes from being
activated when the host is booted, a situation that could lead to stale logical volumes and
cause data corruption. Use the vdsm-tool config-lvm-filter command to create filters
for the LVM. See Creating an LVM filter
IMPORTANT
Red Hat Virtualization currently does not support block storage with a block size of 4K.
You must configure block storage in legacy (512b block) mode.
IMPORTANT
If your host is booting from SAN storage and loses connectivity to the storage, the
storage file systems become read-only and remain in this state after connectivity is
restored.
To prevent this situation, add a drop-in multipath configuration file on the root file
system of the SAN for the boot LUN to ensure that it is queued when there is a
connection:
# cat /etc/multipath/conf.d/host.conf
multipaths {
multipath {
wwid boot_LUN_wwid
no_path_retry queue
}
Red Hat Virtualization system administrators need a working knowledge of Storage Area Networks
58
CHAPTER 5. PREPARING STORAGE FOR RED HAT VIRTUALIZATION
Red Hat Virtualization system administrators need a working knowledge of Storage Area Networks
(SAN) concepts. SAN usually uses Fibre Channel Protocol (FCP) for traffic between hosts and shared
external storage. For this reason, SAN may occasionally be referred to as FCP storage.
For information on setting up and configuring FCP or multipathing on Red Hat Enterprise Linux, see the
Storage Administration Guide and DM Multipath Guide.
IMPORTANT
If you are using block storage and intend to deploy virtual machines on raw devices or
direct LUNs and manage them with the Logical Volume Manager (LVM), you must create
a filter to hide guest logical volumes. This will prevent guest logical volumes from being
activated when the host is booted, a situation that could lead to stale logical volumes and
cause data corruption. Use the vdsm-tool config-lvm-filter command to create filters
for the LVM. See Creating an LVM filter
IMPORTANT
Red Hat Virtualization currently does not support block storage with a block size of 4K.
You must configure block storage in legacy (512b block) mode.
IMPORTANT
If your host is booting from SAN storage and loses connectivity to the storage, the
storage file systems become read-only and remain in this state after connectivity is
restored.
To prevent this situation, add a drop-in multipath configuration file on the root file
system of the SAN for the boot LUN to ensure that it is queued when there is a
connection:
# cat /etc/multipath/conf.d/host.conf
multipaths {
multipath {
wwid boot_LUN_wwid
no_path_retry queue
}
}
Any POSIX-compliant file system used as a storage domain in Red Hat Virtualization must be a clustered
file system, such as Global File System 2 (GFS2), and must support sparse files and direct I/O. The
Common Internet File System (CIFS), for example, does not support direct I/O, making it incompatible
with Red Hat Virtualization.
For information on setting up and configuring POSIX-compliant file system storage, see Red Hat
Enterprise Linux Global File System 2.
IMPORTANT
59
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
IMPORTANT
Do not mount NFS storage by creating a POSIX-compliant file system storage domain.
Always create an NFS storage domain instead.
1. On the host, create the directory to be used for the local storage:
# mkdir -p /data/images
2. Ensure that the directory has permissions allowing read/write access to the vdsm user (UID 36)
and kvm group (GID 36):
# mkdir /data
# lvcreate -L $SIZE rhvh -n data
# mkfs.ext4 /dev/mapper/rhvh-data
# echo "/dev/mapper/rhvh-data /data ext4 defaults,discard 1 2" >> /etc/fstab
# mount /data
# mount -a
3. Ensure that the directory has permissions allowing read/write access to the vdsm user (UID 36)
and kvm group (GID 36):
For the Red Hat Gluster Storage versions that are supported with Red Hat Virtualization, see Red Hat
Gluster Storage Version Compatibility and Support.
60
CHAPTER 5. PREPARING STORAGE FOR RED HAT VIRTUALIZATION
To override the multipath settings, do not customize /etc/multipath.conf. Because VDSM owns
/etc/multipath.conf, installing or upgrading VDSM or Red Hat Virtualization can overwrite this file
including any customizations it contains. This overwriting can cause severe storage failures.
Instead, you create a file in the /etc/multipath/conf.d directory that contains the settings you want to
customize or override.
VDSM executes the files in /etc/multipath/conf.d in alphabetical order. So, to control the order of
execution, you begin the filename with a number that makes it come last. For example,
/etc/multipath/conf.d/90-myfile.conf.
Do not modify /etc/multipath.conf. If the file contains user modifications, and the file is
overwritten, it can cause unexpected storage problems.
Do not override the user_friendly_names and find_multipaths settings. For details, see
Recommended Settings for Multipath.conf.
Avoid overriding the no_path_retry and polling_interval settings unless a storage vendor
specifically requires you to do so. For details, see Recommended Settings for Multipath.conf.
WARNING
Prerequisites
Procedure
2. Copy the individual setting you want to override from /etc/multipath.conf to the new
configuration file in /etc/multipath/conf.d/<my_device>.conf. Remove any comment marks,
edit the setting values, and save your changes.
61
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
Do not restart the multipathd service. Doing so generates errors in the VDSM
logs.
Verification steps
1. Test that the new configuration performs as expected on a non-production cluster in a variety
of failure scenarios. For example, disable all of the storage connections.
2. Enable one connection at a time and verify that doing so makes the storage domain reachable.
Additional resources
user_friendly_names no
Device names must be consistent across all hypervisors. For example, /dev/mapper/{WWID}. The
default value of this setting, no, prevents the assignment of arbitrary and inconsistent device names
such as /dev/mapper/mpath{N} on various hypervisors, which can lead to unpredictable system
behavior.
WARNING
find_multipaths no
This setting controls whether RHVH tries to access devices through multipath only if more than one
path is available. The current value, no, allows RHV to access devices through multipath even if only
one path is available.
62
CHAPTER 5. PREPARING STORAGE FOR RED HAT VIRTUALIZATION
WARNING
Avoid overriding the following settings unless required by the storage system vendor:
no_path_retry 4
This setting controls the number of polling attempts to retry when no paths are available. Before RHV
version 4.2, the value of no_path_retry was fail because QEMU had trouble with the I/O queuing
when no paths were available. The fail value made it fail quickly and paused the virtual machine. RHV
version 4.2 changed this value to 4 so when multipathd detects the last path has failed, it checks all of
the paths four more times. Assuming the default 5-second polling interval, checking the paths takes
20 seconds. If no path is up, multipathd tells the kernel to stop queuing and fails all outstanding and
future I/O until a path is restored. When a path is restored, the 20-second delay is reset for the next
time all paths fail. For more details, see the commit that changed this setting .
polling_interval 5
This setting determines the number of seconds between polling attempts to detect whether a path is
open or has failed. Unless the vendor provides a clear reason for increasing the value, keep the
VDSM-generated default so the system responds to path failures sooner.
63
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NFS
iSCSI
Local storage
If you require an ISO or export domain, use this procedure, but select ISO or Export from the Domain
Function list.
Procedure
4. Accept the default values for the Data Center, Domain Function, Storage Type, Format, and
Host lists.
5. Enter the Export Path to be used for the storage domain. The export path should be in the
format of 123.123.0.10:/data (for IPv4), [2001:0:0:0:0:0:0:5db1]:/data (for IPv6), or
domain.example.com:/data.
b. Enter a percentage value into the Warning Low Space Indicator field. If the free space
available on the storage domain is below this percentage, warning messages are displayed
to the user and logged.
c. Enter a GB value into the Critical Space Action Blocker field. If the free space available on
the storage domain is below this value, error messages are displayed to the user and logged,
and any new action that consumes space, even temporarily, will be blocked.
d. Select the Wipe After Delete check box to enable the wipe after delete option. This option
64
CHAPTER 6. ADDING STORAGE FOR RED HAT VIRTUALIZATION
d. Select the Wipe After Delete check box to enable the wipe after delete option. This option
can be edited after the domain is created, but doing so will not change the wipe after delete
property of disks that already exist.
7. Click OK.
The new NFS data domain has a status of Locked until the disk is prepared. The data domain is then
automatically attached to the data center.
Procedure
5. Select Data as the Domain Function and iSCSI as the Storage Type.
IMPORTANT
Communication to the storage domain is from the selected host and not directly
from the Manager. Therefore, all hosts must have access to the storage device
before the storage domain can be configured.
7. The Manager can map iSCSI targets to LUNs or LUNs to iSCSI targets. The New Domain
window automatically displays known targets with unused LUNs when the iSCSI storage type is
selected. If the target that you are using to add storage does not appear, you can use target
discovery to find it; otherwise proceed to the next step.
a. Click Discover Targets to enable target discovery options. When targets have been
discovered and logged in to, the New Domain window automatically displays targets with
LUNs unused by the environment.
NOTE
You can use the Discover Targets options to add LUNs on many targets or multiple paths
to the same LUNs.
IMPORTANT
65
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
IMPORTANT
If you use the REST API method discoveriscsi to discover the iscsi targets,
you can use an FQDN or an IP address, but you must use the iscsi details
from the discovered targets results to log in using the REST API method
iscsilogin. See discoveriscsi in the REST API Guide for more information.
b. Enter the FQDN or IP address of the iSCSI host in the Address field.
c. Enter the port with which to connect to the host when browsing for targets in the Port field.
The default is 3260.
d. If CHAP is used to secure the storage, select the User Authentication check box. Enter the
CHAP user name and CHAP password.
NOTE
You can define credentials for an iSCSI target for a specific host with the
REST API. See StorageServerConnectionExtensions: add in the REST API
Guide for more information.
e. Click Discover.
f. Select one or more targets from the discovery results and click Login for one target or
Login All for multiple targets.
IMPORTANT
If more than one path access is required, you must discover and log in to the
target through all the required paths. Modifying a storage domain to add
additional paths is currently not supported.
IMPORTANT
When using the REST API iscsilogin method to log in, you must use the iscsi
details from the discovered targets results in the discoveriscsi method. See
iscsilogin in the REST API Guide for more information.
8. Click the + button next to the desired target. This expands the entry and displays all unused
LUNs attached to the target.
9. Select the check box for each LUN that you are using to create the storage domain.
b. Enter a percentage value into the Warning Low Space Indicator field. If the free space
available on the storage domain is below this percentage, warning messages are displayed
to the user and logged.
c. Enter a GB value into the Critical Space Action Blocker field. If the free space available on
the storage domain is below this value, error messages are displayed to the user and logged,
and any new action that consumes space, even temporarily, will be blocked.
66
CHAPTER 6. ADDING STORAGE FOR RED HAT VIRTUALIZATION
d. Select the Wipe After Delete check box to enable the wipe after delete option. This option
can be edited after the domain is created, but doing so will not change the wipe after delete
property of disks that already exist.
e. Select the Discard After Delete check box to enable the discard after delete option. This
option can be edited after the domain is created. This option is only available to block
storage domains.
If you have configured multiple storage connection paths to the same target, follow the procedure in
Configuring iSCSI Multipathing to complete iSCSI bonding.
If you want to migrate your current storage network to an iSCSI bond, see Migrating a Logical Network
to an iSCSI Bond.
Procedure
5. Select the Domain Function and the Storage Type from the drop-down lists. The storage
domain types that are not compatible with the chosen data center are not available.
6. Select an active host in the Host field. If this is not the first data domain in a data center, you
must select the data center’s SPM host.
IMPORTANT
All communication to the storage domain is through the selected host and not
directly from the Red Hat Virtualization Manager. At least one active host must
exist in the system and be attached to the chosen data center. All hosts must
have access to the storage device before the storage domain can be configured.
7. The New Domain window automatically displays known targets with unused LUNs when Fibre
Channel is selected as the storage type. Select the LUN ID check box to select all of the
available LUNs.
b. Enter a percentage value into the Warning Low Space Indicator field. If the free space
67
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
b. Enter a percentage value into the Warning Low Space Indicator field. If the free space
available on the storage domain is below this percentage, warning messages are displayed
to the user and logged.
c. Enter a GB value into the Critical Space Action Blocker field. If the free space available on
the storage domain is below this value, error messages are displayed to the user and logged,
and any new action that consumes space, even temporarily, will be blocked.
d. Select the Wipe After Delete check box to enable the wipe after delete option. This option
can be edited after the domain is created, but doing so will not change the wipe after delete
property of disks that already exist.
e. Select the Discard After Delete check box to enable the discard after delete option. This
option can be edited after the domain is created. This option is only available to block
storage domains.
9. Click OK.
The new FCP data domain remains in a Locked status while it is being prepared for use. When ready, it is
automatically attached to the data center.
Procedure
4. Select the Data Center to be associated with the storage domain. The data center selected
must be of type POSIX (POSIX compliant FS). Alternatively, select (none).
5. Select Data from the Domain Function drop-down list, and POSIX compliant FS from the
Storage Type drop-down list.
If applicable, select the Format from the drop-down menu.
7. Enter the Path to the POSIX file system, as you would normally provide it to the mount
command.
8. Enter the VFS Type, as you would normally provide it to the mount command using the -t
argument. See man mount for a list of valid VFS types.
9. Enter additional Mount Options, as you would normally provide them to the mount command
using the -o argument. The mount options should be provided in a comma-separated list. See
man mount for a list of valid mount options.
b. Enter a percentage value in the Warning Low Space Indicator field. If the free space
68
CHAPTER 6. ADDING STORAGE FOR RED HAT VIRTUALIZATION
b. Enter a percentage value in the Warning Low Space Indicator field. If the free space
available on the storage domain is below this percentage, warning messages are displayed
to the user and logged.
c. Enter a GB value in the Critical Space Action Blocker field. If the free space available on
the storage domain is below this value, error messages are displayed to the user and logged,
and any new action that consumes space, even temporarily, will be blocked.
d. Select the Wipe After Delete check box to enable the wipe after delete option. This option
can be edited after the domain is created, but doing so will not change the wipe after delete
property of disks that already exist.
Procedure
2. Click Management → Maintenance and OK. The host’s status changes to Maintenance.
4. Click the Edit buttons next to the Data Center, Cluster, and Storage fields to configure and
name the local storage domain.
5. Set the path to your local storage in the text entry field.
6. If applicable, click the Optimization tab to configure the memory optimization policy for the
new local storage cluster.
7. Click OK.
The Manager sets up the local data center with a local cluster, local storage domain. It also changes the
host’s status to Up.
Verification
The domain’s status should be Active ( ), and the value in the Storage Type column should be Local
on Host.
You can now upload a disk image in the new local storage domain.
69
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
For the Red Hat Gluster Storage versions that are supported with Red Hat Virtualization, see Red Hat
Gluster Storage Version Compatibility and Support.
70
APPENDIX A. CONFIGURING A LOCAL REPOSITORY FOR OFFLINE RED HAT VIRTUALIZATION MANAGER INSTALLATION
Prerequisites
A Red Hat Enterprise Linux 8 Server installed on a system that has access to the Content
Delivery Network. This system downloads all the required packages, and distributes them to
your offline systems.
A large amount of free disk space available. This procedure downloads a large number of
packages, and requires up to 50GB of free disk space.
Begin by enabling the Red Hat Virtualization Manager repositories on the online system:
Procedure
1. Register your system with the Content Delivery Network, entering your Customer Portal user
name and password when prompted:
# subscription-manager register
NOTE
If you are using an IPv6 network, use an IPv6 transition mechanism to access the
Content Delivery Network and subscription manager.
2. Find the Red Hat Virtualization Manager subscription pool and record the pool ID:
NOTE
71
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
NOTE
# dnf repolist
# subscription-manager repos \
--disable='*' \
--enable=rhel-8-for-x86_64-baseos-eus-rpms \
--enable=rhel-8-for-x86_64-appstream-eus-rpms \
--enable=rhv-4.4-manager-for-rhel-8-x86_64-rpms \
--enable=fast-datapath-for-rhel-8-x86_64-rpms \
--enable=jb-eap-7.4-for-rhel-8-x86_64-rpms \
--enable=openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms \
--enable=rhceph-4-tools-for-rhel-8-x86_64-rpms
Additional resources
For information on modules and module streams, see the following sections in Installing, managing, and
removing user-space components
Module streams
72
APPENDIX A. CONFIGURING A LOCAL REPOSITORY FOR OFFLINE RED HAT VIRTUALIZATION MANAGER INSTALLATION
b. Enable ftp access for an anonymous user to have access to rpm files from the intended
Manager machine, and to keep it secure, disable write on ftp server. Edit the
/etc/vsftpd/vsftpd.conf file and change the values for anonymous_enable and
write_enable as follows:
anonymous_enable=YES
write_enable=NO
c. Start the vsftpd service, and ensure the service starts on boot:
d. Create a firewall rule to allow FTP service and reload the firewalld service to apply changes:
e. Red Hat Enterprise Linux 8 enforces SELinux by default, so configure SELinux to allow FTP
access:
# setsebool -P allow_ftpd_full_access=1
f. Create a sub-directory inside the /var/ftp/pub/ directory, where the downloaded packages
are made available:
# mkdir /var/ftp/pub/rhvrepo
2. Download packages from all configured software repositories to the rhvrepo directory. This
includes repositories for all Content Delivery Network subscription pools attached to the
system, and any locally configured repositories:
This command downloads a large number of packages and their metadata, and takes a long time
to complete.
3. Create a repository file, and copy it to the /etc/yum.repos.d/ directory on the intended Manager
machine.
You can create the configuration file manually or with a script. Run the script below on the
machine hosting the repository, replacing ADDRESS in the baseurl with the IP address or
FQDN of the machine hosting the repository:
73
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
#!/bin/sh
REPOFILE="/etc/yum.repos.d/rhev.repo"
echo -e " " > $REPOFILE
Return to Configuring the Manager. Packages are installed from the local repository, instead of from the
Content Delivery Network.
Troubleshooting
74
APPENDIX B. CONFIGURING A HOST FOR PCI PASSTHROUGH
NOTE
This is one in a series of topics that show how to set up and configure SR-IOV on Red Hat
Virtualization. For more information, see Setting Up and Configuring SR-IOV
Enabling PCI passthrough allows a virtual machine to use a host device as if the device were directly
attached to the virtual machine. To enable the PCI passthrough function, you must enable virtualization
extensions and the IOMMU function. The following procedure requires you to reboot the host. If the
host is attached to the Manager already, ensure you place the host into maintenance mode first.
Prerequisites
Ensure that the host hardware meets the requirements for PCI device passthrough and
assignment. See PCI Device Requirements for more information.
1. Enable the virtualization extension and IOMMU extension in the BIOS. See Enabling Intel VT-x
and AMD-V virtualization hardware extensions in BIOS in the Red Hat Enterprise Linux
Virtualization Deployment and Administration Guide for more information.
2. Enable the IOMMU flag in the kernel by selecting the Hostdev Passthrough & SR-IOV check
box when adding the host to the Manager or by editing the grub configuration file manually.
To enable the IOMMU flag from the Administration Portal, see Adding Standard Hosts to
the Red Hat Virtualization Manager and Kernel Settings Explained.
To edit the grub configuration file manually, see Enabling IOMMU Manually.
3. For GPU passthrough, you need to run additional configuration steps on both the host and the
guest system. See GPU device passthrough: Assigning a host GPU to a single virtual machine in
Setting up an NVIDIA GPU for a virtual machine in Red Hat Virtualization for more information.
NOTE
If you are using IBM POWER8 hardware, skip this step as IOMMU is enabled by
default.
For Intel, boot the machine, and append intel_iommu=on to the end of the
GRUB_CMDLINE_LINUX line in the grub configuration file.
# vi /etc/default/grub
...
GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 ... intel_iommu=on
...
75
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
For AMD, boot the machine, and append amd_iommu=on to the end of the
GRUB_CMDLINE_LINUX line in the grub configuration file.
# vi /etc/default/grub
…
GRUB_CMDLINE_LINUX="nofb splash=quiet console=tty0 … amd_iommu=on
…
NOTE
If the passthrough fails because the hardware does not support interrupt
remapping, you can consider enabling the allow_unsafe_interrupts option if
the virtual machines are trusted. The allow_unsafe_interrupts is not
enabled by default because enabling it potentially exposes the host to MSI
attacks from virtual machines. To enable the option:
# vi /etc/modprobe.d
options vfio_iommu_type1 allow_unsafe_interrupts=1
2. Refresh the grub.cfg file and reboot the host for these changes to take effect:
# grub2-mkconfig -o /boot/grub2/grub.cfg
# reboot
76
APPENDIX C. REMOVING THE STANDALONE RED HAT VIRTUALIZATION MANAGER
WARNING
You should use this procedure only on a standalone installation of the Red Hat
Virtualization Manager.
Procedure
# engine-cleanup
2. The Manager service must be stopped before proceeding. You are prompted to confirm. Enter
OK to proceed:
3. You are prompted to confirm that you want to remove all Manager components. Enter OK to
remove all components, or Cancel to exit engine-cleanup:
All the installed ovirt components are about to be removed, data will be lost (OK, Cancel)
[Cancel]: OK
engine-cleanup details the components that are removed, and the location of backup files.
77
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Procedure
1. The module name must be added to a configuration file for the modprobe utility. This file must
reside in the configuration directory /etc/modprobe.d.
For more information on this configuration directory, see the man page modprobe.d.
2. Ensure the module is not configured to get loaded in any of the following:
/etc/modprobe.conf
/etc/modprobe.d/*
/etc/rc.modules
/etc/sysconfig/modules/*
3. If the module appears in the output, ensure it is ignored and not loaded:
# modprobe -r <_module_name_>
5. Prevent the module from being loaded directly by adding the blacklist line to a configuration
file specific to the system - for example /etc/modprobe.d/local-dontload.conf:
NOTE
This step does not prevent a module from loading if it is a required or an optional
dependency of another module.
IMPORTANT
If the excluded module is required for other hardware, excluding it might cause
unexpected side effects.
78
APPENDIX D. PREVENTING KERNEL MODULES FROM LOADING AUTOMATICALLY
8. If the kernel module is part of the initramfs, rebuild your initial ramdisk image, omitting the
module:
For example:
13. Restart the kdump service to pick up the changes to the kdump initrd:
# kdumpctl restart
79
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
Procedure
2. If the module cannot be unloaded, a process or another module might still be using the module.
If so, terminate the process and run the modpole command written above another time to
unload the module.
80
APPENDIX E. SECURING RED HAT VIRTUALIZATION
Authentication
Authorization
Accounting
Prerequisites
You should be proficient in your organization’s security standards and practices. If possible,
consult with your organization’s Security Officer.
Consult the Red Hat Enterprise Linux Security hardening before deploying RHEL hosts.
E.1. APPLYING THE DISA STIG PROFILE IN RHEL BASED HOSTS AND
THE STANDALONE MANAGER
When installing RHV, you can select the DISA STIG profile with the UI installer, which is the profile
provided by RHEL 8.
IMPORTANT
The DISA STIG profile is not supported for Red Hat Virtualization Host (RHVH).
Procedure
2. In the Security Policy screen, set the Apply security policy to On.
4. Click Select profile. This action adds a green checkmark next to the profile and adds packages
to the list of Changes that were done or need to be done. Follow the onscreen instructions if
they direct you to make any changes.
5. Click Done.
6. On the Installation Summary screen, verify that the status of Security Policy is Everything
okay.
81
Red Hat Virtualization 4.4 Installing Red Hat Virtualization as a standalone Manager with remote databases
You can enable DISA STIG in a self-hosted engine during deployment when using the command-line.
Procedure
1. Start the self-hosted engine deployment script. See Installing Red Hat Virtualization as a self-
hosted engine using the command line.
2. When the deployment script prompts Do you want to apply an OpenSCAP security profile?,
enter Yes.
3. When the deployment script prompts Please provide the security profile you would like to
use?, enter stig.
Procedure
2. In the Security Policy screen, set the Apply security policy to On.
3. Select PCI-DSS v3.2.1 Control Baseline for Red Hat Enterprise Linux 8.
4. Click Select profile. This action adds a green checkmark next to the profile and adds packages
to the list of Changes that were done or need to be done. Follow the onscreen instructions if
they direct you to make any changes.
5. Click Done.
6. In the Installation Summary screen, verify that the status of Security Policy is Everything
okay.
Procedure
1. Start the self-hosted engine deployment script. See Installing Red Hat Virtualization as a self-
hosted engine using the command line.
2. When the deployment script prompts Do you want to apply an OpenSCAP security profile?,
enter Yes.
3. When the deployment script prompts Please provide the security profile you would like to
use?, enter pci-dss.
82
APPENDIX F. LEGAL NOTICE
Licensed under the (Creative Commons Attribution–ShareAlike 4.0 International License). Derived from
documentation for the (oVirt Project). If you distribute this document or an adaptation of it, you must
provide the URL for the original version.
Red Hat, Red Hat Enterprise Linux, the Red Hat logo, the Shadowman logo, JBoss, OpenShift, Fedora,
the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other
countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or
other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other
countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or
endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or
trademarks/service marks of the OpenStack Foundation, in the United States and other countries and
are used with the OpenStack Foundation’s permission. We are not affiliated with, endorsed or sponsored
by the OpenStack Foundation, or the OpenStack community.
83