Skip to content

Commit

Permalink
oVirt 4.5.0 Release
Browse files Browse the repository at this point in the history
Signed-off-by: Sandro Bonazzola <[email protected]>
  • Loading branch information
sandrobonazzola committed Apr 15, 2022
1 parent 940e533 commit 4dc4d3f
Show file tree
Hide file tree
Showing 26 changed files with 890 additions and 328 deletions.
2 changes: 1 addition & 1 deletion htmlproofer_test.rb
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
allow_hash_href: true,
check_opengraph: true,
only_4xx: true,
http_status_ignore: [429,403],
http_status_ignore: [429,403,401],
url_ignore: [ "https://github.com/oVirt/.*/edit/.*" ],
parallel: { in_processes: 8 },
cache: { timeframe: '6w' },
Expand Down
2 changes: 1 addition & 1 deletion source/community/get-involved/repository-mirrors.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Then when the mirror is in sync you can add it to the mirrorlist (*resources.ovi
| [Studenten Net Twente (SNT)](http://www.snt.utwente.nl/) | The Netherlands | [http](http://ftp.snt.utwente.nl/pub/software/ovirt/) | [ftp](ftp://ftp.snt.utwente.nl/pub/software/ovirt/) | | ftpcom at snt.utwente.nl | |
| [Georgia Tech Software Library (GTlib)](http://www.gtlib.gatech.edu/) | United States (Georgia) | [http](http://www.gtlib.gatech.edu/pub/oVirt/pub/) | [ftp](ftp://www.gtlib.gatech.edu/pub/oVirt/pub/) | [rsync](rsync://rsync.gtlib.gatech.edu/oVirt/) | gtlib_at_gtlib.gatech.edu | |
| [ibiblio](http://www.ibiblio.org/) | United States (North Carolina) | [http](http://mirrors.ibiblio.org/ovirt/) | | | cmpalmer_at_ibiblio.org | |
| [Rochester Institute of Technology](http://www.rit.edu) | United States (New York) | [http](http://mirrors.rit.edu/ovirt/pub/) | [ftp](ftp://mirrors.rit.edu/ovirt/) | | pfmeec_at_rit.edu | |
| [Rochester Institute of Technology](http://www.rit.edu) | United States (New York) | [http](http://mirrors.rit.edu/ovirt/) | [ftp](ftp://mirrors.rit.edu/ovirt/) | | pfmeec_at_rit.edu | |
| [Duke University](http://duke.edu) | United States (North Carolina) | [http](http://mirror.linux.duke.edu/ovirt/pub/) | | | drew.stinnett_at_duke.edu | |
| [Plus.line AG](http://www.plusline.net/en/) | Germany (Frankfurt) | [http](http://ftp.plusline.net/ovirt/) | [ftp](ftp://ftp.plusline.net/pub/ovirt/) | [rsync](rsync://ftp.plusline.net/ovirt/) | ftp-admin_at_plusline.net | |
| [Silesian University in Opava](http://www.slu.cz) | Czech Republic (Opava) | [http](http://mirror.slu.cz/ovirt/) | [ftp](ftp://mirror.slu.cz/ovirt/) | | jiri_slezka_at_slu_cz | 1Gbps, IPv6 ready |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,12 +96,6 @@ endif::rhv-doc[]
ifdef::ovirt-doc[]

Ensure the correct repositories are enabled.
For oVirt 4.4:

[source,terminal,subs="normal"]
----
# dnf install https://resources.ovirt.org/pub/yum-repo/ovirt-release44.rpm
----

For oVirt 4.5:
If you are going to install on RHEL 8.6 Beta please follow link:/download/install_on_rhel.html[Installing on RHEL] first.
Expand All @@ -111,15 +105,15 @@ If you are going to install on RHEL 8.6 Beta please follow link:/download/instal
# dnf install -y centos-release-ovirt45
----

After that, for oVirt 4.5 pre-release testing you'll need to execute:
For oVirt 4.4:

[source,terminal,subs="normal"]
----
# dnf install -y python3-dnf-plugins-core
# dnf config-manager --set-enabled centos-ovirt45-testing
# dnf config-manager --set-enabled ovirt-45-upstream-testing
# dnf install https://resources.ovirt.org/pub/yum-repo/ovirt-release44.rpm
----

Common procedure valid for both 4.4 and 4.5:

You can check which repositories are currently enabled by running `dnf repolist`.

. Enable the `javapackages-tools` module.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ ifdef::ovirt-doc[]
. Write the {hypervisor-fullname} Installation ISO disk image to a USB, CD, or DVD.
endif::[]
. Start the machine on which you are installing {hypervisor-shortname}, booting from the prepared installation media.
. From the boot menu, select *Install {hypervisor-shortname} 4.4* and press `Enter`.
. From the boot menu, select *Install {hypervisor-shortname} {vername_rhv}* and press `Enter`.
+
[NOTE]
====
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,11 @@ If you need a package that is not included in the oVirt provided repository, you
# imgbased: set-enabled
[custom-sssd-ldap]
name = Provides sssd-ldap
mirrorlist = http://mirrorlist.centos.org/?release=$releasever&arch=$basearch&repo=BaseOS&infra=$infra
gpgcheck = 1
enabled = 1
gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial
mirrorlist=http://mirrorlist.centos.org/?release=$stream&arch=$basearch&repo=BaseOS&infra=$infra
#baseurl=http://mirror.centos.org/$contentdir/$stream/BaseOS/$basearch/os/
gpgcheck=1
enabled=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-centosofficial
includepkgs = sssd-ldap
----

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,7 @@
----
# dnf module enable virt:av
----
ifdef::rhv-doc[]
* For {virt-product-shortname} 4.4 SP1 and later:
endif::rhv-doc[]
ifdef::ovirt-doc[]
* For {virt-product-shortname} 4.5 and later:
endif::ovirt-doc[]
* For {virt-product-shortname} {vername_rhv} and later:
+
[options="nowrap" subs="normal"]
+
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,12 @@
[id='Preparing_Red_Hat_Gluster_Storage_{context}']
= Preparing {gluster-storage-fullname}

For information on setting up and configuring {gluster-storage-fullname}, see the link:{URL_gluster_docs}3.5/html/installation_guide/[_{gluster-storage-fullname} Installation Guide_].
ifdef::ovirt-doc[]
For information on setting up and configuring {gluster-storage-fullname}, see the link:https://docs.gluster.org/en/latest/Install-Guide/Overview/[_{gluster-storage-fullname} Installation Guide_].
endif::[]

ifdef::rhv-doc[]
For information on setting up and configuring {gluster-storage-fullname}, see the link:{URL_gluster_docs}3.5/html/installation_guide/[_{gluster-storage-fullname} Installation Guide_].

For the {gluster-storage-fullname} versions that are supported with {virt-product-fullname}, see link:https://access.redhat.com/articles/2356261[].
endif::[]
Original file line number Diff line number Diff line change
Expand Up @@ -38,20 +38,30 @@ ifdef::rhv-doc[]
----
endif::[]
ifdef::ovirt-doc[]
* For {hypervisor-fullname}s, the `ovirt-release44` RPM package enabling the correct repositories is already installed. Ensure it is updated to the latest version:
Upgrading from an older 4.5 to latest 4.5:
* For {hypervisor-fullname}s, the `centos-release-ovirt45` RPM package enabling the correct repositories is already installed.
* For {enterprise-linux-host-fullname}s:
* If you are going to install on RHEL 8.6 Beta please follow link:/download/install_on_rhel.html[Installing on RHEL] first.
+
[source,terminal,subs="normal"]
----
# dnf update -y ovirt-release44
# dnf update -y centos-release-ovirt45
----
* For {enterprise-linux-host-fullname}s:
Upgrading from an older 4.4 to latest 4.4:

* For {hypervisor-fullname}s, the `ovirt-release44` RPM package enabling the correct repositories is already installed.
* For {enterprise-linux-host-fullname}s ensure `ovirt-release44` RPM package is updated to the latest version:
+
[source,terminal,subs="normal"]
----
# dnf install https://resources.ovirt.org/pub/yum-repo/ovirt-release44.rpm
# dnf update -y ovirt-release44
----
Common procedure valid for both 4.4 and 4.5:

endif::[]

. In the Administration Portal, click menu:Compute[Hosts] and select the host to be updated.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,18 +42,14 @@ ifdef::rhv-doc[]
----
endif::[]
ifdef::ovirt-doc[]
* For {hypervisor-fullname}s, the `ovirt-release44` RPM package enabling the correct repositories is already installed. Ensure it is updated to the latest version:
+
[source,terminal,subs="normal"]
----
# dnf update -y ovirt-release44
----
* For {hypervisor-fullname}s the `centos-release-ovirt45`` RPM package enabling the correct repositories is already installed.
* For {enterprise-linux-host-fullname}s:
* If you are going to install on RHEL 8.6 Beta please follow link:/download/install_on_rhel.html[Installing on RHEL] first.
+
[source,terminal,subs="normal"]
----
# dnf install https://resources.ovirt.org/pub/yum-repo/ovirt-release44.rpm
# dnf update -y centos-release-ovirt45
----
endif::[]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,11 @@ endif::migrating_to_SHE[]
ifdef::upgrade[]
.Prerequisites
ifdef::ovirt-doc[]
* The RPM package link:https://resources.ovirt.org/pub/yum-repo/ovirt-release44.rpm[ovirt-release44.rpm] is installed and updated to the latest version. This package includes the necessary repositories.

ifdef::minor_updates[]
* The centos-release-ovirt45 RPM package is installed and updated to the latest version. This package includes the necessary repositories.
endif::minor_updates[]

endif::ovirt-doc[]

ifdef::rhv-doc[]
Expand Down Expand Up @@ -64,7 +68,7 @@ endif::[]
ifdef::ovirt-doc[]
[source,terminal,subs="normal"]
----
# yum update ovirt\\*setup\*
# dnf update ovirt\\*setup\*
----
endif::[]

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
// Module included in the following assemblies:
//
// Upgrading from 4.4 to {virt-product-fullname} 4.5
//
:_content-type: PROCEDURE
[id="Upgrading_hosts_to_4-5_{context}"]

= Migrating hosts {virt-product-shortname} 4.4 to 4.5

.Prerequisites

* Hosts for {virt-product-shortname} 4.5 require {enterprise-linux} 8.6 or later.
* {virt-product-fullname} {engine-name} 4.5 is installed and running.
* The compatibility level of the data center and cluster to which the hosts belong is set to 4.3 or higher.
* All data centers and clusters in the environment must have the cluster compatibility level set to version 4.3 higher before you start the procedure.

[IMPORTANT]
====
If you are going to install on RHEL 8.6 Beta please follow link:/download/install_on_rhel.html[Installing on RHEL] first.
====


.Procedure for {enterprise-linux-host-fullname}s

. Enable oVirt 4.5 repositories
[source,terminal,subs="normal"]
----
# dnf install -y centos-release-ovirt45
----

.Procedure for {enterprise-linux-host-fullname}s {hypervisor-fullname}s:

. Enable oVirt 4.5 repositories
[source,terminal,subs="normal"]
----
# dnf install centos-release-ovirt45 --enablerepo=extras
----

.Common procedure

. Follow the procedure for updates between minor releases.

. Follow the procedure for updating the cluster compatibility version.

[IMPORTANT]
====
If you are using GlusterFS Storage please note that oVirt 4.5 updates Gluster to version 10.
Please refer to link:https://docs.gluster.org/en/latest/Upgrade-Guide/upgrade-to-10/[Upgrade procedure to Gluster 10, from Gluster 9.x, 8.x and 7.x]
for more details.
====
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
:_content-type: PROCEDURE
[id="Upgrading_the_Manager_to_4-5_{context}"]
= Upgrading the {virt-product-fullname} {engine-name} from 4.4 to 4.5

// Included in:
// Upgrade Guide

ifndef::SHE_upgrade[]
{virt-product-fullname} {engine-name} 4.5 is only supported on {enterprise-linux} 8.6 or later.
endif::SHE_upgrade[]

.Prerequisites

* All data centers and clusters in the environment must have the cluster compatibility level set to version 4.3 or higher.
* All virtual machines in the environment must have the cluster compatibility level set to version 4.3 or higher.
[NOTE]
====
Connected hosts and virtual machines can continue to work while the {engine-name} is being upgraded.
====

[IMPORTANT]
====
If you are going to install on RHEL 8.6 Beta please follow link:/download/install_on_rhel.html[Installing on RHEL] first.
====


.Procedure

. Enable oVirt 4.5 repositories
+
[source,terminal,subs="normal"]
----
# dnf install -y centos-release-ovirt45
----
+
. Enable version 2.3 of the `mod_auth_openidc` module.
+
[source,terminal,subs="normal"]
----
# dnf module -y enable mod_auth_openidc:2.3
----

Then follow the procedure for updates between minor releases.
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,10 @@ endif::upgrade[]
* Plan for any necessary virtual machine downtime. After you update the clusters' compatibility versions during the upgrade, a new hardware configuration is automatically applied to each virtual machine once it reboots. You must reboot any running or suspended virtual machines as soon as possible to apply the configuration changes.

// This link must always be the latest version.
* Ensure your environment meets the requirements for {virt-product-fullname} {vernum_rhv}. For a complete list of prerequisites, see the link:{URL_downstream_virt_product_docs}planning_and_prerequisites_guide/index#RHV_requirements[__Planning and Prerequisites Guide__].
* Ensure your environment meets the requirements for {virt-product-fullname} {vername_rhv}.
ifdef::rhv-doc[]
For a complete list of prerequisites, see the link:{URL_downstream_virt_product_docs}planning_and_prerequisites_guide/index#RHV_requirements[__Planning and Prerequisites Guide__].
endif::rhv-doc[]

* When upgrading {virt-product-fullname} {engine-name}, it is recommended that you use one of the existing hosts. If you decide to use a new host, you must assign a unique name to the new host and then add it to the existing cluster before you begin the upgrade procedure.

Expand Down
7 changes: 2 additions & 5 deletions source/documentation/index.haml
Original file line number Diff line number Diff line change
Expand Up @@ -49,12 +49,9 @@ hide_metadata: true
:markdown
### Release Notes

#### Pre-Release Notes
- [oVirt 4.5.0](/release/4.5.0/)

#### Latest Release Notes
- [oVirt 4.4.10](/release/4.4.10/)
- [oVirt 4.5.0](/release/4.5.0/)

#### Previous Release Notes
- [oVirt 4.4.9](/release/4.4.9/)
- [oVirt 4.4.10](/release/4.4.10/)
- [All Releases](/release/)
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
:_content-type: ASSEMBLY
[id="Remote_Upgrading_from_4-4"]
= Upgrading a Remote Database Environment from {virt-product-fullname} 4.4 to 4.5

:context: 4-4_remote_db
:4-4_remote_db:

Upgrading your environment from 4.4 to 4.5 involves the following steps:

. xref:Upgrade_Prerequisites_4-4_remote_db[Make sure you meet the prerequisites, including enabling the correct repositories.]

. xref:Updating_the_Red_Hat_Virtualization_Manager_4-4_remote_db[Update the 4.4 {engine-name} to the latest version of 4.4.]

. xref:Upgrading_the_Manager_to_4-5_4-4_remote_db[Upgrade the {engine-name} from 4.4 to 4.5.]

. xref:proc_upgrading-the-remote-data-warehouse-service-and-database_4-4_remote_db[Upgrade the remote Data Warehouse service and database.]

. xref:Upgrading_hosts_to_4-5_4-4_remote_db[Migrate hosts and virtual machines while reducing virtual machine downtime.]

. xref:Changing_the_Cluster_Compatibility_Version_4-4_remote_db[Update the compatibility version of the clusters.]
. xref:Changing_Virtual_Machine_Cluster_Compatibility_4-4_remote_db[Reboot any running or suspended virtual machines to update their configuration.]
. xref:Changing_the_Data_Center_Compatibility_Version_4-4_remote_db[Update the compatibility version of the data centers.]

// Prerequisites
include::common/upgrade/snip-RHV_upgrade_prerequisites.adoc[leveloffset=+1]

You can now update the {engine-name} to the latest version of 4.4.

include::common/upgrade/proc-Updating_the_Red_Hat_Virtualization_Manager.adoc[leveloffset=+1]

You can now upgrade the {engine-name} to 4.5.

include::common/upgrade/proc-Upgrading_the_Manager_to_4-5.adoc[leveloffset=+1]


// Add new {engine-name} upgrade versions here

You can now update the hosts.

include::common/upgrade/proc-Upgrading_hosts_to_4-5.adoc[leveloffset=+1]


// include::common/upgrade/proc-Updating_all_hosts_in_a_cluster.adoc[leveloffset=+1]

You can now update the cluster compatibility version.

include::common/upgrade/proc-Changing_the_Cluster_Compatibility_Version.adoc[leveloffset=+1]

You can now update the cluster compatibility version for virtual machines in the cluster.

include::common/upgrade/proc-Changing_Virtual_Machine_Cluster_Compatibility.adoc[leveloffset=+1]

You can now update the data center compatibility version.

include::common/upgrade/proc-Changing_the_Data_Center_Compatibility_Version.adoc[leveloffset=+1]

:4-4_remote_db!:
Loading

0 comments on commit 4dc4d3f

Please sign in to comment.