5.2. Upgrading the Manager from 3.6 to 4.0

Procedure

1. On the 3.6 Manager, back up the environment:

   # engine-backup --scope=all --mode=backup --file=backup.bck --log=backuplog.log

   Copy to Clipboard Toggle word wrap
2. Copy the backup file to a suitable device or machine.

3. If the ISO storage domain is hosted on the Manager machine, back up the contents of /var/lib/exports/iso:

   # cd /var/lib/exports/iso
   # tar zcf iso_domain.tar.gz UUID

   Copy to Clipboard Toggle word wrap

   You will restore the ISO storage backup file after the upgrade.

4. Install Red Hat Enterprise Linux 7. See the Red Hat Enterprise Linux Installation Guide.

   If you are installing RHEL 7 on a new machine, you must configure it to have the same fully qualified domain name as the 3.6 Manager machine, and update your DNS so that the FQDN correlates to the IP address of the new machine.

5. Install the Red Hat Virtualization 4.0 packages:

   1. Register your system with the Content Delivery Network, entering your Customer Portal user name and password when prompted:

      # subscription-manager register

      Copy to Clipboard Toggle word wrap

   2. Find the Red Hat Enterprise Linux Server and Red Hat Virtualization subscription pools and record the pool IDs:

      # subscription-manager list --available

      Copy to Clipboard Toggle word wrap

   3. Use the pool IDs to attach the entitlements to the system:

      # subscription-manager attach --pool=pool_id

      Copy to Clipboard Toggle word wrap

   4. Configure the repositories:

      # subscription-manager repos \
          --enable=rhel-7-server-rpms \
          --enable=rhel-7-server-supplementary-rpms \
          --enable=rhel-7-server-rhv-4.0-rpms \
          --enable=jb-eap-7.0-for-rhel-7-server-rpms

      Copy to Clipboard Toggle word wrap

   5. Ensure all packages are up to date:

      # yum update

      Copy to Clipboard Toggle word wrap

   6. Install the rhevm package and dependencies:

      # yum install rhevm

      Copy to Clipboard Toggle word wrap

6. Copy the backup file to the 4.0 Manager machine and restore the backup:

   # engine-backup --mode=restore --file=backup.bck --log=restore.log \
       --provision-db --provision-dwh-db --restore-permissions

   Copy to Clipboard Toggle word wrap
   Note

   If the backup contained grants for extra database users, this command will create the extra users with random passwords. You must change these passwords manually if the extra users require access to the restored system. See https://access.redhat.com/articles/2686731.

   Note

   Use the --provision-dwh-db option if the backup contains Data Warehouse data.

   Red Hat Enterprise Virtualization Reports has been deprecated in Red Hat Virtualization 4.0 and will not be restored. See BZ#1340810 for more information.

7. Install optional extension packages if they were installed on the 3.6 Manager machine:

   # yum install ovirt-engine-extension-aaa-ldap ovirt-engine-extension-aaa-misc ovirt-engine-extension-logger-log4j

   Copy to Clipboard Toggle word wrap
   Note

   The configuration for these package extensions must be manually reapplied because they are not migrated as part of the backup and restore process.

8. Decommission the 3.6 Manager machine if you are using a different machine for the 4.0 Manager.

9. Run engine-setup to configure the Manager:

   # engine-setup

   Copy to Clipboard Toggle word wrap