5.4. Upgrading a RHEV-H-Based Self-Hosted Engine Environment
- Place the high-availability agents that manage the Manager virtual machine into the global maintenance mode.
- Add a new RHVH 4.0 host to your environment.
- Migrate the Manager virtual machine to the new host and set as SPM.
- Run the upgrade utility to upgrade the Manager. During the upgrade procedure 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 has 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.5. Upgrading the Self-Hosted Engine
- Install a new RHVH 4.0 host. See the Installation Guide for instructions to install RHVH.
- Add the new host to your environment. Run the deployment script on the new host:
# hosted-engine --deploySpecify the existing shared storage domain when prompted; the script then detects that this is an additional host setup. See Installing Additional Hosts to a Self-Hosted Environment in the Red Hat Enterprise Virtualization 3.6 Self-Hosted Engine Guide for more details about the questions asked by the script during an additional host deployment.
- 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.
- Download the RHV-M Virtual Appliance from the Customer Portal and copy it to the new host:
Secure copy the OVA file to the Red Hat Virtualization Host:
- Log in to the Customer Portal at https://access.redhat.com.
- Click Downloads in the menu bar.
- Click Red Hat Virtualization > to access the product download page.
- Choose the appliance for Red Hat Virtualization 4.0 and click.
scp rhvm-appliance.ova email@example.com:/usr/share
- Migrate the Manager virtual machine to the RHVH 4.0 host and set the host as the Storage Pool Manager (SPM).
- Run the upgrade script to upgrade the Manager virtual machine. If not already installed, install the screen package.
# yum install screen
# hosted-engine --upgrade-appliance
NoteThe script will ask for the location of the RHV-M Virtual Appliance you copied to the host. It will also prompt you 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