2.1. Upgrading Virtuozzo 6 with Local Storage

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

Note

You will need to install a new Virtuozzo Hybrid Server 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 Hybrid Server 7 on the Virtuozzo 6 server to be upgraded. For instructions, see the Virtuozzo Hybrid Server 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 Hybrid Server 7.

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

2.1.2. Upgrading by Migrating to New Servers

To upgrade by migrating to a new server running Virtuozzo Hybrid Server 7, 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 Hybrid Server 7 on a different (new) server. For instructions, see the Virtuozzo Hybrid Server 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 Hybrid Server 7.

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

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 Hybrid Server on said hardware node from scratch.

Hardware nodes that host only containers and no virtual machines can be upgraded to Virtuozzo Hybrid Server 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 Hybrid Server 7.

For the upgrade, you will need the following:

  1. Contents of the Virtuozzo Hybrid Server 7 distribution, either on a disc mounted to a local directory or available over network via HTTP.

  2. A Virtuozzo Hybrid Server 7 license (optional). The existing Virtuozzo 6 license is not transferred during the upgrade. You can install a new Virtuozzo Hybrid Server 7 license during the upgrade or skip this step and install one manually after the upgrade with the vzlicload tool.

Note the following:

  • 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 Hybrid Server 7 after the upgrade.

  • In the end of the upgrade, yum update is launched by default to update to the latest Virtuozzo Hybrid Server 7 version from the configured repositories. You can skip this step if required.

  • 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 Hybrid Server 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 --boot /dev/sda --license <license_key> --reboot
    

    Note

    For details on each option, see 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 Hybrid Server.

2.1.3.1. Upgrade Tool Reference

vzupgrade install {--license <key> | --skip-license-upgrade}
                  [--device <mount_point> | --network <distrib_URL>]
                  [--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 Hybrid Server distribution contents (e.g., a USB flash drive).

--network <distrib_URL>

Mutually excludes --device. The path to the Virtuozzo Hybrid Server installation ISO image or its contents (full or netinstall).

--license <key>

Specifies the Virtuozzo Hybrid Server license key.

--skip-license-upgrade

Skips license installation during upgrade. You can install a Virtuozzo Hybrid Server license after the upgrade with the vzlicload tool.

--add-repo <name>=<repository_URL>

Specifies remote Virtuozzo Hybrid Server and VzLinux repositories (space-separated).

--boot <bootloader_destination>

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

Note

Third-party bootloaders need to be updated manually if the Virtuozzo Hybrid Server 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.

If the options --device, --network, and --add-repo, are omitted, the default repositories are used:

http://repo.virtuozzo.com/vz/releases/7.0/x86_64/os/
http://repo.virtuozzo.com/vzlinux/7/x86_64/os/