2.1. Upgrading Virtuozzo 6 with Local Storage

This section describes how to upgrade your Virtuozzo 6 servers with local storage to Virtuozzo 7. You can do this by using spare servers or in-place or migrate VMs and containers to new Virtuozzo 7 servers. Apply either method to each server in your Virtuozzo 6 infrastructure.

Note

You will need to install a new Virtuozzo 7 license on each upgraded node.

2.1.1. Upgrading with Spare Virtuozzo 6 Servers

To upgrade by using a spare Virtuozzo 6 server, do the following:

  1. Update both the Virtuozzo 6 server to be upgraded and the spare server to the latest version. You can do this by running yum update on each server.

    Note

    The oldest Virtuozzo 6 build eligible for upgrade is 6.0.11-3466.

  2. Back up all VMs and containers on the Virtuozzo 6 server to be upgraded. You can do this with the pbackup tool as described in the Virtuozzo 6 User’s Guide and use both Virtuozzo 6 and 7 hosts as backup servers.

  3. Temporarily migrate VMs and containers from the Virtuozzo 6 server to be upgraded to the spare Virtuozzo 6 server. You can do this with the pmigrate tool as described in the Virtuozzo 6 User’s Guide.

  4. Perform a fresh install of Virtuozzo 7 on the Virtuozzo 6 server to be upgraded. For instructions, see the Virtuozzo 7 Installation Guide.

  5. Migrate VMs and containers back to the upgraded server from the spare server. For more details, see Migrating VMs and Containers from Virtuozzo 6 to Virtuozzo 7.

  6. If you store VM and container backups on a Virtuozzo 6 server, move them to a Virtuozzo 7 server as described in Restoring Virtuozzo 6 Backups to Virtuozzo 7 Servers.

2.1.2. Upgrading by Migrating to New Servers

To upgrade by migrating to a new Virtuozzo 7 server, do the following:

  1. Update the selected Virtuozzo 6 server (from which you will migrate VMs and containers) to the latest version. You can do this by running yum update.

    Note

    The oldest Virtuozzo 6 build eligible for upgrade is 6.0.11-3466.

  2. Back up all VMs and containers on the selected Virtuozzo 6 server. You can do this with the pbackup tool and use both Virtuozzo 6 and 7 hosts as backup servers.

  3. Perform a fresh install of Virtuozzo 7 on a different (new) server. For instructions, see the Virtuozzo 7 Installation Guide.

  4. Migrate VMs and containers to it from the selected Virtuozzo 6 server. For more details, see Migrating VMs and Containers from Virtuozzo 6 to Virtuozzo 7.

  5. If you store VM and container backups on a Virtuozzo 6 server, move them to a Virtuozzo 7 server as described in Restoring Virtuozzo 6 Backups to Virtuozzo 7 Servers.

2.1.3. Upgrading In-Place with Local Storage

Warning

Make sure to backup the data on the hardware node before upgrading. If the upgrade fails, you may have to install Virtuozzo on said hardware node from scratch.

Hardware nodes that host only containers and no virtual machines can be upgraded to Virtuozzo 7 in-place. To be eligible for in-place upgrade, the hardware node must meet the following requirements:

  1. Updated to the latest version of Virtuozzo 6.

    Note

    The oldest Virtuozzo 6 build eligible for upgrade is 6.0.11-3466.

  2. No virtual machines.

  3. No containers that use VZFS.

  4. No templates for guest operating systems unsupported by Virtuozzo 7.

For the upgrade, you will need the following:

  1. Contents of the Virtuozzo 7 distribution, either on a disc mounted to a local directory or available over network via HTTP.
  2. A Virtuozzo 7 license (optional). The existing Virtuozzo 6 license is not transferred during the upgrade. You can install a new Virtuozzo 7 license during the upgrade or skip this step and install one manually after the upgrade with the vzlicload tool.

Note

  1. If any containers on the Virtuozzo 6 node are set to be started automatically on reboot, they will do the same once you boot to Virtuozzo 7 after the upgrade.
  2. In the end of the upgrade, yum update is launched by default to update to the latest Virtuozzo 7 version from the configured repositories. You can skip this step if required.
  3. Upgrade logs can be found in the /var/log/vzupgrade.log and /var/log/redhat*log files.

To perform an in-place upgrade of a Virtuozzo 6 node to Virtuozzo 7, do the following:

  1. Install the vzupgrade package:

    # yum install vzupgrade
    
  2. Check for conditions blocking the upgrade (listed earlier):

    # vzupgrade check --blocker
    

    Note

    The list of upgrade blockers is also displayed by vzupgrade list.

  3. If no blockers exist, run the vzupgrade install command. For example:

    # vzupgrade install --network <ISO_URL> --boot /dev/sda --reboot --license <license_key> --add-repo vz7=http://repo.virtuozzo.com/vz/releases/7.0/x86_64/os/ vzlinux7=http://repo.virtuozzo.com/vzlinux/7/x86_64/os/
    

    Note

    For details on each option, see Virtuozzo Upgrade Tool Reference.

    The installer will run a pre-upgrade check and generate upgrade scripts (if required, you can perform this step manually before upgrading with vzupgrade check).

  4. Having collected the required information, the installer will display a list of things to be aware of. Read the list, and, if you agree to proceed, press Y and Enter.

  5. If --reboot is omitted, reboot the hardware node when asked by the installer. Make sure to boot from the hard drive and choose the system upgrade option in the upgrade bootloader. From this moment, the actual upgrade will start and no further interaction on your part will be required.

Note

Packages downloaded during update will be stored in /var/lib/upgrade_pkgs.

When the upgrade completes, the node will automatically reboot to Virtuozzo 7.

2.1.3.1. Virtuozzo Upgrade Tool Reference

vzupgrade install {--device <mount_point> | --network <ISO_URL>}
                  {--license <key> | --skip-license-upgrade}
                  --add-repo <name>=<repository_URL> [--boot <bootloader_destination>]
                  [--reboot] [--skip-post-update] [--clean-cache] [-h,--help]
Option Description
--device <mount_point> Mutually excludes --network. The mount point of the device with Virtuozzo 7 distribution contents (e.g., a USB flash drive).
--network <ISO_URL> Mutually excludes --device. The path to the Virtuozzo 7 installation ISO image (full or netinstall).
--license <key> Specifies the Virtuozzo 7 license key.
--skip-license-upgrade Skips license installation during upgrade. You can install a Virtuozzo 7 license after the upgrade with the vzlicload tool.
--add-repo <name>=<repository_URL>

Specifies remote Virtuozzo 7 and Virtuozzo Linux 7 repositories (space-separated).

Note

Starting from Virtuozzo 7.0.5 (Update 5), this option is mandatory.

--boot <bootloader_destination>

Specifies destination to install Virtuozzo 7 bootloader to. If omitted, the Virtuozzo 7 bootloader will not be installed and the existing Virtuozzo 6 bootloader will be modified to boot Virtuozzo 7.

Note

Third-party bootloaders need to be updated manually if the Virtuozzo 7 bootloader is not installed.

--reboot Automatically reboots the node to the upgrade bootloader.
--skip-post-update Skips the launch of yum update in the end of the upgrade.
--clean-cache Cleans up packages from /var/lib/upgrade_pkgs on start so they are downloaded anew during installation. If this option is omitted (default), packages already stored in /var/lib/upgrade_pkgs are checked against those in the repository, updated if necessary, and used.
-h,--help Shows usage information.