5.3. Upgrading a RHEL-Based Self-Hosted Engine Environment
- Place the high-availability agents that manage the Manager virtual machine into the global maintenance mode.
- Enable the required repositories on the host and update the ovirt-hosted-engine-setup and rhevm-appliance packages.
hosted-engine --upgrade-applianceto upgrade the Manager virtual machine. During the upgrade you will be asked to create a backup of the 3.6 Manager and copy it to the host machine where the upgrade is being performed.
- Update the hosts.
- After the Manager virtual machine and all hosts in the cluster have been updated, change the cluster compatibility version to 4.0.
/var/tmpdirectory must have at least 5 GB of free space to extract the appliance files. If it does not, you can specify a different directory or mount alternate storage that does have the required space. The VDSM user and KVM group must have read, write, and execute permissions on the directory.
- The self-hosted engine storage domain must have additional free space for the new appliance being deployed (50 GB by default). To increase the storage on iSCSI or Fibre Channel storage, you must manually extend the LUN size on the storage and then extend the storage domain using the Manager. See Increasing iSCSI or FCP Storage in the Administration Guide for more information about resizing a LUN.
Procedure 5.4. Upgrading the Self-Hosted Engine
- Disable the high-availability agents on all the self-hosted engine nodes. To do this run the following command on any host in the cluster.
# hosted-engine --set-maintenance --mode=global
hosted-engine --vm-statusto confirm that the environment is in maintenance mode.
- On the host that is currently set as SPM and contains the Manager virtual machine, enable the required repository.
# subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
- Migrate all virtual machines except the Manager virtual machine to alternate hosts.
- On the host, update the Manager virtual machine packages.
# yum update ovirt-hosted-engine-setup rhevm-applianceIf the rhevm-appliance package is missing, install it manually before updating ovirt-hosted-engine-setup.
# yum install rhevm-appliance
# yum update ovirt-hosted-engine-setup
- Run the upgrade utility to upgrade the Manager virtual machine. If not already installed, install the screen package, which is available in the standard Red Hat Enterprise Linux repository.
# yum install screen
# hosted-engine --upgrade-appliance
NoteYou will be prompted to select the appliance if more than one is detected, and to create a backup of the Manager database and provide its full location.
- After the upgrade is complete, disable global maintenance:
# hosted-engine --set-maintenance --mode=none
hosted-engine --vm-poweroffcommand, then rollback the upgrade by running