Parallels Virtuozzo Containers 4.7 for Linux Upgrade Guide September 23, 2011 Copyright © 1999-2011 Parallels Holdings, Ltd. and its affiliates. All rights reserved.
Parallels Holdings, Ltd. c/o Parallels International GMbH. Parallels International GmbH Vordergasse 49 CH8200 Schaffhausen Switzerland Tel: + 41 526320 411 Fax: + 41 52672 2010 www.parallels.com Copyright © 1999-2011 Parallels Holdings, Ltd. and its affiliates. All rights reserved. This product is protected by United States and international copyright laws. The product’s underlying technology, patents, and trademarks are listed at http://www.parallels.com/trademarks.
Contents About This Document................................................................................................ 4 Upgrade Scenarios .................................................................................................... 5 Preparing for the Upgrade ........................................................................................ 7 Upgrading from Parallels Virtuozzo Containers 4.0 and 4.6 .................................... 8 Upgrading to Parallels Virtuozzo Containers 4.7 ..
CHAPTER 1 About This Document This document familiarizes you with the way to upgrade the following products to Parallels Virtuozzo Containers 4.7 for Linux: • Parallels Virtuozzo Containers 4.0 and 4.6 • SWsoft Virtuozzo 3.0 Service Pack 1 • OpenVZ Note: Upgrading from the Beta version of Parallels Virtuozzo Containers 4.7 is not supported.
CHAPTER 2 Upgrade Scenarios Before beginning the upgrade process, it is important to choose the proper upgrade scenario. Doing so will help you avoid difficulties you may otherwise encounter and will also ensure you can successfully solve any problems that may still occur. You can use one of the following scenarios to upgrade your system: First Scenario Typically, you perform an in-place upgrade of an existing system. This upgrade scenario is supported for servers running Parallels Virtuozzo Containers 4.
Upgrade Scenarios 5 Reinstall the operating system on the Hardware Node. 6 Install Parallels Virtuozzo Containers 4.7 on the Hardware Node. 7 Migrate the Containers back from the spare server to the Hardware Node, if necessary. Consult the Parallels Virtuozzo Containers 4.7 User's Guide and Parallels Virtuozzo Containers 4.7 Installation Guide for detailed information on how to migrate Containers between Hardware Nodes and to perform a clean installation of Parallels Virtuozzo Containers 4.
CHAPTER 3 Preparing for the Upgrade It is recommended that you do the following before starting the upgrade: • Install all Parallels updates available for your system. • Back up all Containers and virtual machines on the server. • Perform a full backup of the entire server using a third-party software. For example, you can make use of the Acronis Backup & Recovery 10 Advanced Server (a free trial version is available at http://www.acronis.
CHAPTER 4 Upgrading from Parallels Virtuozzo Containers 4.0 and 4.6 Parallels Virtuozzo Containers 4.7 officially supports an in-place upgrade on Hardware Nodes that run Parallels Virtuozzo Containers 4.0 or 4.6 and one of the following Linux distributions (both x86 and x64 versions): • Red Hat Enterprise Linux 5 • CentOS 5 It is recommended that you install the latest Parallels Virtuozzo Containers update on the Hardware Node before starting the upgrade procedure.
Upgrading from Parallels Virtuozzo Containers 4.0 and 4.6 Upgrading to Parallels Virtuozzo Containers 4.7 To upgrade your system to Parallels Virtuozzo Containers 4.7, do the following: 1 Download the vzinstall-linux-i386.bin or vzinstall-linux-x86_64.bin utility (for the x86 or x86-64 version of Parallels Virtuozzo Containers 4.7, respectively) from the Parallels web site. The process of downloading and installing Parallels Virtuozzo Containers 4.7 with the vzinstall-linux-i386.
Upgrading from Parallels Virtuozzo Containers 4.0 and 4.6 Verifying the Upgrade Follow these steps to verify that your system has been successfully upgraded to Parallels Virtuozzo Containers 4.7: • Check that you can log in to the Hardware Node using Parallels tools: Parallels Virtual Automation (former Parallels Infrastructure Manager and Virtuozzo Control Center) and Parallels Management Console (former Virtuozzo Management Console).
CHAPTER 5 Upgrading Host Operating Systems with Parallels Virtuozzo Containers Along with upgrading the Parallels Virtuozzo Containers software, you may also wish to upgrade the Host operating system (Host OS) installed on your server. The following table lists the types of Host OS+Parallels Virtuozzo Containers (both Virtuozzo 3.0 Service Pack 1 and Parallels Virtuozzo Containers 4.0 or 4.6) upgrades officially supported in Parallels Virtuozzo Containers 4.
Upgrading Host Operating Systems with Parallels Virtuozzo Containers Upgrading a Host OS with Virtuozzo 3.0 To upgrade a server that runs one of the supported Host OSs and Virtuozzo 3.0 Service Pack 1, do the following: 1 Back up all Virtuozzo and Container configuration files. These are the following files: • /etc/sysconfig/vz-scripts/*.conf • /etc/sysconfig/vz-scripts/*.mount • /etc/sysconfig/vz-scripts/*.umount • /etc/vz/* • /etc/sysconfig/vz • /etc/cron.d/venetclean • /etc/cron.
Upgrading Host Operating Systems with Parallels Virtuozzo Containers # for i in $(ls /vz/root) ; do vzquota drop “${i}” ; done # service vz restart 13
Upgrading Host Operating Systems with Parallels Virtuozzo Containers Upgrading a Host OS with Parallels Virtuozzo Containers 4.0 or 4.6 To upgrade a server that runs one of the supported Host OSs and Parallels Virtuozzo Containers 4.0 or 4.6, do the following: 1 Back up all Virtuozzo and Container configuration files. These are the following files: • /etc/sysconfig/vz-scripts/*.conf • /etc/sysconfig/vz • /etc/vz/* • /etc/cron.d/venetclean • /etc/cron.d/vereboot You can back up these files to any location.
CHAPTER 6 Upgrading Nodes in Clusters This chapter describes how to upgrade nodes running Parallels Virtuozzo Containers 4.0, Parallels Virtuozzo Containers 4.6, or SWsoft Virtuozzo 3.0 with Service Pack 1 and participating in two types of clusters: • failover clusters • data sharing clusters Note: Due to discontinued support in Red Hat Enterprise Linux 6, Parallels Virtuozzo Containers 4.7 no longer supports keeping /vz partitions on GFS1 volumes.
Upgrading Nodes in Clusters Upgrading Nodes in a Failover Cluster The process of upgrading nodes in a failover cluster includes the following steps: 1 Upgrading active nodes in the cluster. 2 Upgrading passive nodes in the cluster. Important! Upgrade one cluster node at a time. Upgrading more than one node simultaneously is not supported and may damage your systems. Checking Clustered Services Each active node must be upgraded together with the clustered service running on it.
Upgrading Nodes in Clusters ... In this example, the vz-1 clustered service is associated with the device UUID UUID=39028daf-0337-4403-9567-84507ac7cb50. c Add the /vz entry to /etc/fstab.
Upgrading Nodes in Clusters a If you used the Parallels Infrastructure Manager application for administering your cluster nodes, you also need to upgrade this application. First of all, update Parallels Infrastructure Manager to its latest version. When installing Parallels Virtuozzo Containers 4.7, specify the --pva-agent option, for example: # ./vzinstall-linux-x86_64.bin install --vzinstall-opts "--clustermode --pva-agent" or # .
Upgrading Nodes in Clusters Upgrading Nodes in a Data Sharing Cluster Like it is the case with a failover cluster, the process of upgrading nodes in a data sharing cluster also includes two steps: 1 Upgrading active nodes in the cluster. 2 Upgrading passive nodes in the cluster. However, each of these steps contains additional operations that you need to perform to upgrade cluster nodes. Important! 1. Upgrade one cluster node at a time.
Upgrading Nodes in Clusters 2 Disable the startup of the rgmanager clustering service, and enable the startup of the vz service: # chkconfig rgmanager off # chkconfig vz on If you are upgrading a node running SUSE Linux Enterprise Server, you need to additionally disable the openais service: # chkconfig openais off 3 Install Parallels Virtuozzo Containers 4.7 on the node. For detailed information on installing Parallels Virtuozzo Containers 4.7, see the Parallels Virtuozzo Containers 4.
Upgrading Nodes in Clusters a If you used the Parallels Infrastructure Manager application (renamed to Parallels Virtual Automation in Parallels Virtuozzo Containers 4.7) for administering your cluster nodes, you also need to upgrade this application. First of all, update Parallels Infrastructure Manager to its latest version. When installing Parallels Virtuozzo Containers 4.7, specify the --pvaagent option, for example: # ./vzinstall-linux-x86_64.
CHAPTER 7 Upgrading from OpenVZ Parallels Virtuozzo Containers 4.7 allows you to upgrade servers running OpenVZ (www.openvz.org) to Parallels Virtuozzo Containers 4.7. To do this: 1 Update OpenVZ to its latest version. You can download the latest versions of OpenVZ packages from http://download.openvz.org. 2 Back up all OpenVZ and Container configuration files. These are the following files: • /etc/sysconfig/vz-scripts/*.conf • /etc/sysconfig/vz-scripts/*.mount • /etc/sysconfig/vz-scripts/*.
Upgrading from OpenVZ • Restore the files /etc/sysconfig/vz-scripts/*.conf, /etc/sysconfig/vzscripts/*.mount, and /etc/sysconfig/vz-scripts/*.umount to the /etc/sysconfig/vz-scripts directory. • Restore the contents of the /etc/vz/* directory to the /etc/vz directory. • Restore the files /etc/cron.d/venetclean and /etc/cron.d/vereboot to the /etc/cron.d directory.
Upgrading from OpenVZ Performing Post-Upgrade Operations Use the guidelines below to configure your system once the upgrade is complete. Installing Templates During the upgrade, the SimFS filesystem used by OpenVZ Containers is converted to VZFS used by Containers in Parallels Virtuozzo Containers 4.7. As a result, you cannot use old OS templates on upgraded Nodes to create new Containers. To be able to create new Containers, you need first to install OS templates used in Parallels Virtuozzo Containers 4.
Upgrading from OpenVZ 1 Roll back all changes you made when configuring bridge interfaces and virtual Ethernet adapters on the server with OpenVZ. If you do not remember exactly what settings you changed, consult the manual at http://wiki.openvz.org/VEs_and_HNs_in_same_subnets. 2 Configure the networking on the upgraded server. This includes the following steps: a Creating one or more Virtual Networks on the server (a counterpart of bridge interfaces in OpenVZ).
CHAPTER 8 Rolling Back to a Previous Version This section describes how to roll back an unsuccessful upgrade from Parallels Virtuozzo Containers 4.7 to Parallels Virtuozzo Containers 4.6, Parallels Virtuozzo Containers 4.0, or Virtuozzo 3.0 Service Pack 1.
CHAPTER 9 Getting Technical Support If you experience any problems related to upgrading your software to Parallels Virtuozzo Containers 4.7, do the following: • If you have a Customer Relationship manager or a dedicated support engineer assigned to your company, please feel free to contact them for any questions related to the Parallels Virtuozzo Containers 4.7 upgrade.
