In-Place Panel Upgrading

In-place upgrade is a process of updating Panel components on a server. After an upgrade, Panel increases its major or minor version, for example, from 10.3 to 10.4 or from 10.4 to 11.0.

There are three main scenarios of in-place upgrade: Manual, automated, and upgrade in Parallels Virtuozzo Containers. In this chapter, you will learn which of them to choose depending on your environment and how to perform in-place upgrades.

 

Manual Upgrade

This is a typical scenario if you want to upgrade a single Panel installation. Manual means that user input is required during the upgrade. The wizard prompts you to enter various upgrade settings such as the Panel version, select the components to be upgraded, and so on. If you use Panel 10 and later, you can start an upgrade directly from Panel. Users of earlier Panel versions should use the Parallels Installer utility. You can download it from the official Parallels website and run it either in the GUI or in the command-line mode. The table below shows the possible ways of upgrading a particular Panel version to the latest one.

Panel Version

Upgrade Through...

8.x, 9.x

Parallels Installer

10.x, 11.x

Panel GUI (Tools & Settings > Updates and Upgrades), Parallels Installer

Note: Since 10.4, you can set up Panel to apply upgrades automatically once they become available. Learn more in the Administrator's Guide, section Panel Updates and Upgrades.

Learn how to manually upgrade Panel in the section Manual Upgrade.

Important: If you upgrade from earlier Panel versions (7.x, 8.x, or 9.x), you should perform additional Panel configuration steps once data transfer is finished. These steps are required for successful switching of all your Panel objects to the new business model. Learn more in the chapter Completing Upgrade from Panel 9 and Earlier Versions.  

Automated Upgrade

If you maintain a large number of Panel installations, we recommend two main ways of keeping them up-to-date:

 

Upgrade in Parallels Virtuozzo Containers

Parallels Virtuozzo Containers is a virtualization solution employed by a large number of service providers. Virtuozzo Containers support apps installation via PVC templates. A PVC app template is a package containing everything that an app needs to be installed to a server. You install an app template to your server just once and then install the app from the template to a number of containers simultaneously. This is true for upgrades as well. Apps can be upgraded simultaneously in a number of containers by using Virtuozzo commands. If Panel was installed to a container via a PVC template, we strongly recommend that you perform all further Panel upgrades via templates. If you have a number of Panel containers, this will allow you to keep all Panel installations consistent within your hardware node. Learn more in the section (Advanced) Upgrade in Parallels Virtuozzo Containers.

 

In-Place Upgrade Steps

Before upgrading a Panel installation, you should perform a number of preliminary steps. Basically, this procedure includes checking upgrade requirements and choosing a particular Panel version for upgrade. Users of Panel 8.x and 9.x who want to upgrade to the latest Panel version should also check their systems with a special utility. Learn more in the section Before Upgrading Panel.

Note that after an upgrade is completed, you may be asked to provide a new license key. The license key can be installed either manually through the Panel GUI or in unattended manner via the Panel API commands. Learn more in the section Installing a License Key.

In this chapter:

Before Upgrading Panel

Manual Upgrade

(Advanced) Automated Upgrade

(Advanced) Upgrade in Parallels Virtuozzo Containers

Post-Upgrade Setup