Deploy Self-Hosted Engine Offline
You must perform a fresh installation of Oracle Linux 8.8 or later (8.x), or 9.6 or later (9.x) on a host to be configured as a KVM host before deploying a self-hosted engine. You can download the installation Oracle Linux ISO for from the Oracle Software Delivery Cloud at https://edelivery.oracle.com.
Prerequisites
- Create a local mirror for the following repositories, where
n is the major Oracle Linux version (8 or 9):
oln_x86_64_baseos_latestoln_x86_64_appstreamol8_x86_64_kvm_appstreamorol9_x86_64_kvm_utilsoln_x86_64_ovirt45oln_x86_64_ovirt45_extrasoln_x86_64_addons- (Oracle Linux 8
only)
ol8_x86_64_gluster_appstream - (For VDSM)
oln_x86_64_UEKR7, orol9_x86_64_UEKR8(Oracle Linux 9 only)
Note:
Gluster is only available on hosts running Oracle Linux 8.
For information on creating local mirrors of Oracle Linux repositories, see Mirror a Yum Repository on Oracle Linux and Using Software Distribution Mirrors.
- The local repositories can't mimic the original repository names from the
Oracle Yum Public server or ULN. Add a prefix to each repository to identify
it as local. For example, prefix all local repositories with by
local_:local_oln_baseos_latestlocal_oln_appstreamlocal_ol8_kvm_appstreamorol9_kvm_utilslocal_oln_ovirt45local_oln_ovirt45_extraslocal_oln_UEKR7,orlocal_ol9_UEKR8(Oracle Linux 9 only)- (Oracle Linux 8
only)
local_ol8_gluster_appstream
- To configure the Oracle Linux hosts in the network to use the local
repository for updates and package installation, create a file called
/etc/yum.repos.d/local-oln.repothat lists all local repositories.Caution:
The file must be named
local-oln.repoand must reside in the/etc/yum.repos.ddirectory. Ensure that n in the file name matches the Oracle Linux major release. -
Follow the instructions in either Oracle® Linux 8: Installing Oracle Linux or Oracle® Linux 9: Installing Oracle Linux to install Oracle Linux 8.8 or later (8.x), or 9.6 or later (9.x) on the host using the Minimal Install base environment. See the Requirements and Scalability Limits section for an example of the partitioning schema.
Caution:
Do NOT select any other base environment than Minimal Install for the installation or the hosts will have incorrect qemu and libvirt versions, incorrect repositories configured, and no access to virtual machine consoles.
Don't install any extra packages until after you have installed the Manager packages because they might cause dependency issues.
- Reboot the host.
Offline Installation
Before you begin, ensure that you haven't made any changes to the Minimal Install of Oracle Linux.
- List active repositories and disable all active external repositories. For
example, using Oracle Linux
8:
dnf repolistrepo id repo name ol8_UEKR7 Latest Unbreakable Enterprise Kernel Release 7 for Oracle Linux 8 (x86_64) ol8_appstream Oracle Linux 8 Application Stream (x86_64) ol8_baseos_latest Oracle Linux 8 BaseOS Latest (x86_64)Disable the external repositories:
dnf config-manager --disable ol8_UEKR7 ol8_appstream ol8_baseos_latestOr you can use a script, such as:
for REPO in $( dnf repolist | awk '{print $1}' | tail -n +2 | grep -v local_ ); do dnf config-manager --disable ${REPO}; done - Rerun
dnf repolistto confirm no external repositories are active. - So the installation can access the local repository, publish the
local-oln.repofile to/etc/yum.repos.ddirectory. - Enable the local repositories. For example, using Oracle Linux
8:
dnf config-manager --enable local_ol8_UEKR7 local_ol8_appstream local_ol8_baseos_latest local_ol8_gluster_appstream local_ol8_kvm_appstream local_ovirt-4.5 local_ovirt-4.5-extra - Rerun
dnf repolistto confirm that the local repositories are active. - When you install the release packages, some external repositories
(
ol8_gluster_appstream,ovirt-4.5, andovirt-4.5-extra) are enabled. To prevent the installation from failing because it can't access these external repositories, enable thednfskip_if_unavailableoption:dnf config-manager --save --setopt "skip_if_unavailable=True" - Install the Oracle Linux Virtualization Manager Release 4.5 package.
- (Optional) Without internet access, installing the
oracle-ovirt-release-45-elnrpm package takes longer to complete. To speed up the installation, create an entry in the/etc/hostsfile pointingyum.oracle.comtolocalhost, for example:echo '127.0.0.1 yum.oracle.com' >> /etc/hosts - Install the release package:
dnf install oracle-ovirt-release-45-elnNote:
Installing the release package automatically enables/disables the required external repositories. With the
skip_if_unavailableconfiguration, alerts show on the screen that you can ignore.
- (Optional) Without internet access, installing the
- Rerun
dnf repolist. If the installation enabled any external repository, disable them.for REPO in $( dnf repolist | awk '{print $1}' | tail -n +2 | grep -v local_ ); do dnf config-manager --disable ${REPO}; done - If the host runs the Unbreakable Linux Kernel (UEK):
- Install the Extra kernel modules
package.
dnf install kernel-uek-modules-extra - Install available updates for all installed
packages:
dnf update - Reboot the host.
- Install the Extra kernel modules
package.
- Install the
ovirt-hosted-engine-setupandovirt-engine-appliancerpm packages. Installing these packages together speeds up the deployment.dnf -y install ovirt-hosted-engine-setup ovirt-engine-appliance - To instruct the setup process to perform an offline installation and not enable
KeyCloak, create a file called
/root/extra-vars.ymlthat contains the following:--- he_offline_deployment: true he_enable_keycloak: falseCaution:
The file must begin with three en dashes (
---) - Deploy the self-hosted engine using the local repository:
hosted-engine --deploy --4 --ansible-extra-vars="@/root/extra-vars.yml" - Answer the on-screen questions to customize the deployment. Refer to the Engine Configuration Options.
- When the installation completes and the self-hosted engine starts, connect to it using
sshand add the same entry to the/etc/hostsfile pointingyum.oracle.comtolocalhost:echo '127.0.0.1 yum.oracle.com' >> /etc/hosts