This guide explains how to upgrade the following environments to {virt-product-fullname} 4.3:

  • Standalone manager, local database: Both the Data Warehouse database and the {engine-name} database are installed on the {engine-name}.

  • Standalone manager, remote database: Either the Data Warehouse database or the {engine-name} database, or both, are on a separate machine.

  • Self-hosted engine, local database: Both the Data Warehouse database and the {engine-name} database are installed on the {engine-name}.

To save time when upgrading a {engine-name} with local databases, use the ovirt-fast-forward-upgrade tool.

ovirt-fast-forward-upgrade supports local database environments only.

Alternatively, you can manually upgrade the {engine-name}. For remote database environments, this path is required.

Plan any necessary downtime in advance. 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 VMs as soon as possible to apply the configuration changes.

Select the appropriate instructions for your environment from the following table. If your {engine-name} and host versions differ (if you have previously upgraded the {engine-name} but not the hosts), follow the instructions that match the {engine-name}'s version.

Table 1. Supported Upgrade Paths
Current {engine-name} version Target {engine-name} version Relevant section

4.0

4.3

Local database environment:

Remote database environment: [Remote_Upgrading_from_4-0]

Self-hosted engine, local database environment:

4.1

4.3

Local database environment:

Remote database environment: [Remote_Upgrading_from_4-1]

Self-hosted engine, local database environment:

4.2

4.3

Local database environment:

Remote database environment: [Remote_Upgrading_from_4-2]

Self-hosted engine, local database environment:

4.3.x

4.3.y