Parallels Upgrading to Parallels Virtuozzo Containers 4.6 Copyright © 1999-2010 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: + 49 (6151) 42996 - 0 Fax: + 49 (6151) 42996 - 255 www.parallels.com Copyright © 1999-2010 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 Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 7 Preparing for the Upgrade ............................................................................................................................ 8 Upgrading Licenses Manually ..................................................................................................................... 9 Upgrading Virtuozzo Software .....................................................................
About This Document This document familiarizes you with the way to upgrade the following products to Parallels Virtuozzo Containers 4.6 for Linux: Parallels Virtuozzo Containers 4.0 SWsoft Virtuozzo 3.0 Service Pack 1 OpenVZ Note: Upgrading from the Beta version of Parallels Virtuozzo Containers 4.6 is not supported.
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 a straightforward upgrade of an existing system.
Upgrade Scenarios 6 6 Install Parallels Virtuozzo Containers 4.6 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.6 User's Guide and Parallels Virtuozzo Containers 4.6 Installation Guide for detailed information on how to migrate Containers between Hardware Nodes and to perform a clean installation of Parallels Virtuozzo Containers 4.6, respectively.
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 Parallels Virtuozzo Containers 4.6 officially supports upgrading Hardware Nodes that run SWsoft Virtuozzo 3.0 Service Pack 1 and one of the following Linux distributions (both x86 and x64 versions): Red Hat Enterprise Linux 4 CentOS 4 It is recommended that you install the latest Parallels Virtuozzo Containers update on the Hardware Node before starting the upgrade procedure.
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 8 Preparing for the Upgrade Follow the below steps to prepare for the upgrade procedure: 1 Carefully read the information given in the Known Issues and Restrictions section (p. 12). This will help you avoid possible problems related to the upgrade and successfully solve any problems that may appear. 2 Check if the license installed on the Hardware Node can be upgraded to support Parallels Virtuozzo Containers 4.6. Parallels Virtuozzo Containers 4.
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 9 Upgrading Licenses Manually Generally, your license is automatically upgraded to support Parallels Virtuozzo Containers 4.6 during the installation if you have a valid SUS (Software Update Service) or Maintenance contract with Parallels (formerly SWsoft). If you do not have such a contract, contact your sales representative for further information.
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 10 Upgrading Virtuozzo Software To upgrade your system to Parallels Virtuozzo Containers 4.6, do the following: 1 Download the vzinstall-linux-i386.bin or vzinstall-linuxx86_64.bin utility (for the x86 or x86-64 version of Parallels Virtuozzo Containers 4.6, respectively) from the Parallels web site. The process of downloading and installing Parallels Virtuozzo Containers 4.6 with the vzinstall-linux-i386.bin and vzinstall-linux-x86_64.
Verifying the Upgrade Follow these steps to verify that your system has been successfully upgraded to Parallels Virtuozzo Containers 4.6: 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).
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 12 Known Issues and Restrictions When upgrading to Parallels Virtuozzo Containers 4.6, take into account the following: Parallels Virtuozzo Containers 4.6 uses a new license format. Make sure that your current license is upgradeable or that you have a new license before starting the upgrade procedure. New vzabackup/vzarestore utilities are used in Parallels Virtuozzo Containers 4.6 for managing Container backups.
Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 13 The "Virtuozzo Control Center Users Self-Registration" functionality present in previous versions of the Virtuozzo software and used by new users to self-register in Virtuozzo Control Center and request Containers is no longer supported in Parallels Virtuozzo Containers 4.6.
Upgrading from Parallels Virtuozzo Containers 4.0 Parallels Virtuozzo Containers 4.6 officially supports upgrading Hardware Nodes that run Parallels Virtuozzo Containers 4.
Upgrading from Parallels Virtuozzo Containers 4.0 15 Upgrading to Parallels Virtuozzo Containers 4.6 To upgrade your system to Parallels Virtuozzo Containers 4.6, do the following: 1 Download the vzinstall-linux-i386.bin or vzinstall-linuxx86_64.bin utility (for the x86 or x86-64 version of Parallels Virtuozzo Containers 4.6, respectively) from the Parallels web site. The process of downloading and installing Parallels Virtuozzo Containers 4.6 with the vzinstall-linux-i386.bin and vzinstall-linux-x86_64.
Verifying the Upgrade Follow these steps to verify that your system has been successfully upgraded to Parallels Virtuozzo Containers 4.6: 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).
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) upgrades officially supported in Parallels Virtuozzo Containers 4.
Upgrading Host Operating Systems with Parallels Virtuozzo Containers 18 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 19 Note: During the Parallels Virtuozzo Containers 4.6 installation, new configuration files corresponding to those you restored in Step 4 are put to the same directory under the name configuration_file_name.rpmnew. For example, for the vz global Virtuozzo file, a new configuration file with the name vz.rpmnew will be created in the /etc/sysconfig directory.
Upgrading Host Operating Systems with Parallels Virtuozzo Containers 20 Upgrading a Host OS with Parallels Virtuozzo Containers 4.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 /etc/vz/* /etc/cron.d/venetclean /etc/cron.d/vereboot You can back up these files to any location.
Upgrading Host Operating Systems with Parallels Virtuozzo Containers 6 Restart the Virtuozzo service: # service vz restart 21
Upgrading Nodes in Clusters This chapter describes how to upgrade nodes running Parallels Virtuozzo Containers 4.0 or SWsoft Virtuozzo 3.0 with Service Pack 1 and participating in two types of clusters: failover clusters data sharing 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 Nodes in Clusters 23 2 Open the /etc/fstab file on the node for editing, and add the /vz entry to it. Make sure you add the right /vz entry to the file: a Run the clustat utility to find out the name of the clustered service running on the active node. b Search the cluster configuration file (/etc/cluster/cluster.conf) for the UUID of the device associated with the clustered service, for example: # cat /etc/cluster/cluster.conf ...
Upgrading Nodes in Clusters 24 # ./vzinstall-linux-x86_64.bin install --vzinstall-opts "--clustermode" If you use the install utility, run this command: # ./install --clustermode 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.6, specify the --pva-agent option, for example: # .
Upgrading Nodes in Clusters 25 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! Upgrade one cluster node at a time.
Upgrading Nodes in Clusters 26 3 Install Parallels Virtuozzo Containers 4.6 on the node. For detailed information on installing Parallels Virtuozzo Containers 4.6, see the Parallels Virtuozzo Containers 4.6 Installation Guide; for upgrade details, see the Upgrading from SWsoft Virtuozzo 3.0 Service Pack 1 (p. 7) and Upgrading from Parallels Virtuozzo Containers 4.0 (p. 14) chapters.
Upgrading Nodes in Clusters 27 # ./install --clustermode --pva-agent 5 Once the installation is complete, restart the node. If you chose to upgrade Parallels Virtual Automation, wait for it to get upgraded. 6 Make sure that the /vz directory does not contain any files or folders. 7 Uncomment the /vz entry to the /etc/fstab file.
Upgrading from OpenVZ Parallels Virtuozzo Containers 4.6 allows you to upgrade servers running OpenVZ (www.openvz.org) to Parallels Virtuozzo Containers 4.6. 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 the physical server and all Containers on this server. For example, you can use the Acronis® True Image Echo™ Enterprise Server (a free trial version is available at http://www.acronis.
Upgrading from OpenVZ 29 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.6. As a result, you cannot use old OS templates on upgraded Nodes to create new Containers.
Upgrading from OpenVZ 30 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). b Making virtual network adapters for Containers. c Adding Containers to the created Virtual Networks. For detailed information on each of these steps, see the Managing Parallels Virtuozzo Containers Network chapter in the Parallels Virtuozzo Containers 4.6 User's Guide.
Rolling Back to a Previous Version This section describes how to roll back an unsuccessful upgrade from Parallels Virtuozzo Containers 4.6 to Parallels Virtuozzo Containers 4.0 or Virtuozzo 3.0 Service Pack 1.
Getting Technical Support If you experience any problems related to upgrading your software to Parallels Virtuozzo Containers 4.6, 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.6 upgrade.
