Skip to content

Latest commit

 

History

History
159 lines (119 loc) · 9.46 KB

virtuozzo_7_upgrade_guide.asc

File metadata and controls

159 lines (119 loc) · 9.46 KB

Virtuozzo 7 Upgrade Guide

Introduction

This guide describes how to upgrade from Virtuozzo 6 to Virtuozzo 7 in both local storage and Virtuozzo Storage scenarios. In brief, you can

  1. upgrade current Virtuozzo 6 hosts by using temporary spare Virtuozzo 6 hosts or

  2. migrate VMs and containers from current Virtuozzo 6 hosts to new Virtuozzo 7 hosts.

The exact steps to perform differ depending on scenario and are described further in the guide.

Note

Notes:

  1. This guide refers to other Virtuozzo documentation that you will need to complete the upgrade: Virtuozzo 6 User’s Guide, Virtuozzo 6 Upgrade Guide, Virtuozzo 7 Installation Guide.

  2. You can upgrade to Virtuozzo 7 from Virtuozzo 6 only. If your hosts run older virtualization products, you will need to upgrade them to Virtuozzo 6 first. For instructions, see the Virtuozzo 6 Upgrade Guide.

Upgrading Virtuozzo 6 with Local Storage

This chapter describes how to upgrade to Virtuozzo 7 if you have Virtuozzo 6 hosts with local storage. You can upgrade your current Virtuozzo 6 hosts by using spare hosts or migrate VMs and containers to new Virtuozzo 7 hosts. Apply either method to each host in your Virtuozzo 6 infrastructure.

Upgrading with Spare Virtuozzo 6 Hosts

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

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

  2. Back up all VMs and containers on the Virtuozzo 6 host to be upgraded. You can do this with the pbackup tool as described in the Virtuozzo 6 User’s Guide.

  3. Temporarily migrate VMs and containers from the Virtuozzo 6 host to be upgraded to the spare Virtuozzo 6 host. 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 host to be upgraded. For instructions, see the Virtuozzo 7 Installation Guide.

  5. Migrate VMs and containers back to the upgraded host from the spare host. 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 host, move them to a Virtuozzo 7 host as described in [_restoring_virtuozzo_6_backups_to_virtuozzo_7_hosts].

Upgrading by Migrating to New Hosts

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

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

  2. Back up all VMs and containers on the selected Virtuozzo 6 host. You can do this with the pbackup tool.

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

  4. Migrate VMs and containers to it from the selected Virtuozzo 6 host. 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 host, move them to a Virtuozzo 7 host as described in [_restoring_virtuozzo_6_backups_to_virtuozzo_7_hosts].

Upgrading Virtuozzo 6 with Virtuozzo Storage

This chapter describes how to upgrade to Virtuozzo 7 if you have a Virtuozzo Storage cluster based on Virtuozzo 6. You can upgrade by either upgrade the current cluster to Virtuozzo 7 by using spare Virtuozzo 6 hosts or migrate VMs and containers to new a Virtuozzo 7 cluster.

Upgrading with Spare Virtuozzo 6 Hosts

  1. Update all hosts in the cluster based on Virtuozzo 6 to the latest version. You can do this by running yum update on each host.

  2. Choose a host to upgrade in the cluster and migrate VMs and containers from it to other Virtuozzo 6 hosts in the cluster.

  3. Remove chunk servers from the host:

    1. Find out which chunk servers are stored on the host by running pstorage -c <cluster_name> top on any cluster host.

    2. Initiate removal of chunk servers from the host by running pstorage -c <cluster_name> rm-cs --wait <CS_ID> for each chunk server on the host.

  4. Wait until the required chunk servers are removed and Virtuozzo Storage rebuilds. To monitor this process, run pstorage -c <cluster_name> top on any cluster host. The status of the chunk servers being removed will become releasing and the number of replicas on them will start dwindling. When the number of replicas on a CS reaches zero, the CS will be removed both from the host and the pstorage top output. Make sure that no chunk servers are left on the host to be upgraded.

  5. Perform a fresh install of Virtuozzo 7 on the host. During installation, choose to create a new Virtuozzo Storage cluster. For instructions, see the Virtuozzo 7 Installation Guide.

  6. Choose another Virtuozzo 6 host in the old cluster and migrate VMs and containers from it to the new Virtuozzo Storage cluster based on Virtuozzo 7. For details, see [_migrating_vms_and_containers_from_virtuozzo_6_to_virtuozzo_7].

  7. Perform a fresh install of Virtuozzo 7 on the second host. During installation, choose to join the new Virtuozzo Storage cluster based on Virtuozzo 7. For instructions, see the Virtuozzo 7 Installation Guide.

  8. Repeat steps 7 and 8 for the remaining hosts in the old cluster until all Virtuozzo 6 hosts are upgraded to Virtuozzo 7.

  9. If you store VM and container backups on a Virtuozzo 6 host, move them to a Virtuozzo 7 host as described in [_restoring_virtuozzo_6_backups_to_virtuozzo_7_hosts].

Note

Note: Virtuozzo Storage does not support mixed clusters of Virtuozzo 6 and 7 hosts.

Upgrading by Migrating to a New Virtuozzo Storage Cluster

To upgrade by migrating VMs and containers from an old Virtuozzo Storage cluster based on Virtuozzo 6 to a new Virtuozzo Storage cluster based on Virtuozzo 7, do the following:

  1. Update all hosts in the cluster based on Virtuozzo 6 to the latest version. You can do this by running yum update on each host.

  2. On a different set of hosts, create a new Virtuozzo Storage cluster based on Virtuozzo 7. For instructions, see the Virtuozzo 7 Installation Guide.

  3. Migrate VMs and containers from the old cluster to the new cluster. For more details, see [_migrating_vms_and_containers_from_virtuozzo_6_to_virtuozzo_7].

  4. If you store VM and container backups on a Virtuozzo 6 host, move them to a Virtuozzo 7 host as described in [_restoring_virtuozzo_6_backups_to_virtuozzo_7_hosts].

Migrating VMs and Containers from Virtuozzo 6 to Virtuozzo 7

Virtuozzo 7 supports migration of older Virtuozzo 6 VMs and containers to the Virtuozzo 7 format. During migration, VMs and containers are converted for use with Virtuozzo 7. In particular, VM devices are replaced by those supported in Virtuozzo 7. For a list of VM hardware supported in Virtuozzo 7, see the Virtuozzo 7 User’s Guide.

To migrate a VM or container from Virtuozzo 6 to Virtuozzo 7, run the following command on the Virtuozzo 6 host.

# prlctl migrate <VM_or_CT_name> root@<VZ7_host_IP_address>

Migration from Virtuozzo 6 to Virtuozzo 7 implies VM and container downtime that depends on network bandwidth, virtual machine RAM size, and host load. To reduce downtime, it is recommended to at least perform migration when the host load is minimal.

Restoring Virtuozzo 6 Backups to Virtuozzo 7 Hosts

Virtuozzo 7 supports restoring backups of Virtuozzo 6 VMs and containers to Virtuozzo 7 hosts. This section lists steps for possible scenarios. In each scenario, the commands are run on the Virtuozzo 7 host to which the backups will be restored.

To restore a specific backup stored on a Virtuozzo 6 host, do the following:

  1. Find out the backup ID by listing backups stored on the Virtuozzo 6 host:

    # prlctl backup-list root@<VZ6_host_IP_address>

  2. Restore the backup:

    # prlctl restore -t <backup_ID> root@<VZ6_host_IP_address>

To restore a backup of a Virtuozzo 6 VM or container migrated to a Virtuozzo 7 host, run

# prlctl restore <VM_or_CT_name> root@<VZ6_host_IP_address>

To copy a Virtuozzo 6 VM or container backup to a Virtuozzo 7 host and restore it there, do the following:

  1. Find out the backup ID by listing backups stored on the Virtuozzo 6 host:

    # prlctl backup-list root@<VZ6_host_IP_address>

  2. Find out the default backup directory on the Virtuozzo 7 host:

    prlsrvctl info | grep "Backup path"

  3. Copy backup files to the default backup directory on the Virtuozzo 7 host. For example, if backups are stored in the default directory on a Virtuozzo 6 host, run:

    # scp -r root@<VZ6_host_IP_address>:/var/parallels/backups/<backup_ID> \
/vz/vmprivate/backups/

    Or, if you keep backups on network storage, attach said network storage to the default backup directory on the Virtuozzo 7 host. For example, if you store backups on an NFS share, mount this share to /vz/vmprivate/backups/.

  4. Restore the copied backup with either of the previously described methods.