Parallels PLESK PANEL 10.1 DEPLOYMENT GUIDE

Parallels® Plesk Panel
Copyright Notice
Parallels Holdings, Ltd.
c/o Parallels International GMbH
Vordergasse 49
CH8200 Schaffhausen
Switzerland
Phone: +41 526320 411
Fax: +41 52672 2010
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.
Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are registered
trademarks of Microsoft Corporation.
Linux is a registered trademark of Linus Torvalds.
Mac is a registered trademark of Apple, Inc.
All other marks and names mentioned herein may be trademarks of their respective owners.
Contents
Preface 4
Typographical Conventions ........................................................................................................... 4
Feedback ....................................................................................................................................... 5
About This Document 6
Installation and Upgrade Requirements 7
Installation and Upgrade on Linux ................................................................................................. 7
Installation and Upgrade on Windows ........................................................................................... 8
Installing the Panel 9
Installation from the Web Interface .............................................................................................. 10
Installation from the Command Line............................................................................................ 12
Installation Using One-Click Installer........................................................................................... 14
Initializing the Panel..................................................................................................................... 15
Upgrading the Panel 16
Upgrade from the Web Interface ................................................................................................. 17
Upgrade from the Command Line ............................................................................................... 19
Upgrading Standalone Parallels Plesk Billing to the Panel 21
Installing and Upgrading License Keys 23
Installing License Keys ................................................................................................................ 23
Upgrading a Trial License Key .................................................................................................... 24
Configuring the Panel for Linux to Access Vendor Updates 25
Enabling Support for SecureLVE 26
Troubleshooting the Installation and Upgrade Process 27
You are unable to deselect the SiteBuilder component when installing the Panel ..................... 28
The system does not recognize that IIS is installed during the Panel installation ...................... 28
You are unable to install the Kaspersky component on Windows 2008 ..................................... 29
4 Preface
In this section:
Typographical Conventions ............................................................................... 4
Feedback .......................................................................................................... 5
Formatting convention
Type of Information
Example
Special Bold
Items you must select, such as menu options, command buttons, or items in a list.
Go to the QoS tab. Titles of chapters, sections, and subsections.
Read the Basic Administration chapter.
Italics
Used to emphasize the importance of a point, to introduce a term or to designate a command line placeholder, which is to be replaced with a real name or value.
The system supports the so called wildcard character search.
Monospace
The names of style sheet selectors, files and directories, and CSS fragments.
The license file is called license.key.

Preface

Typographical Conventions

The following kinds of formatting in the text identify special information.
Preface 5
Preformatted Bold
What you type, contrasted with on-screen computer output.
Unix/Linux:
# cd /root/rpms/php
Windows:
>cd %myfolder%
Preformatted
On-screen computer output in your command-line sessions; source code in XML, C++, or other programming languages.
Unix/Linux:
# ls –al /files
total 14470
Windows:
>ping localhost
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128

Feedback

If you have found an error in this guide, or if you have suggestions or ideas on how to improve this guide, please send your feedback using the online form at
http://www.parallels.com/en/support/usersdoc/. Please include in your report the guides title,
chapter and section titles, and the fragment of text in which you have found an error.
Purpose
C H A P T E R 1

About This Document

The purpose of this document is to provide information sufficient to install and upgrade Parallels Plesk Panel (hereinafter referred to as the Panel) on a physical or virtual server. This document is addressed to hosters who wish to turn their servers into a complete hosting solution and offer hosting services to their customers. The recommendations within the document are what we believe to be the best practice ­fully tested and guaranteed - when installing and configuring the Panel.
Scope
The Panel customers are divided into two major groups - hosters and hosting service providers. A typical hoster owns one or several physical or virtual servers and offers the hosting services directly to their customers. A hosting service provider generally has more complex infrastructure and they resell the Panel to hosters.
This document is devoted to the first group - hosters. It explains how to install or upgrade the Panel onto their environment.
To facilitate the needs of service providers, we offer a separate document called Parallels Plesk Panel 10.1 Deployment Guide. This document explains how to the automate the Panel deployment, and how to deploy the Panel inside Parallels Virtuozzo Containers.
Overview
Chapter Installation and Upgrade Requirements” as the name suggests discusses the requirements you should meet before starting the installation or upgrade.
Chapter Installing the Panel” covers the installation of the Panel both under Linux and Windows.
Chapter Upgrade the Panel” addresses the upgrade of previous Panel versions to the latest one both under Linux and Windows. It includes the upgrade of Panels bundled with Parallels Plesk Billing.
Chapter Installing and Upgrading License Keys” explains how to install or upgrade the Panel license key.
Chapter Configuring the Panel for Linux to Access Vendor Updates” guides you on how to keep your servers operating system up-to-date.
Chapter Enabling Support for SecureLVE” describes how to turn on the Secure Lightweight Virtual Environment (SecureLVE) extension on a server running Cloud Linux.
Chapter Troubleshooting the Installation and Upgrade Process” describes how to troubleshoot difficulties that may occur when you try to install or upgrade the Panel.
Before you install the Panel on your server, make sure you meet the requirements
In this chapter:
Installation and Upgrade on Linux ..................................................................... 7
Installation and Upgrade on Windows ............................................................... 8
C H A P T E R 2

Installation and Upgrade Requirements

stated in the following sections.

Installation and Upgrade on Linux

Before installing or upgrading Parallels Plesk Panel for Linux, make sure that the following requirements are met:
A static IP address is preliminarily configured. If you wish to install the Customer &
Business Manager component, you also should have a host name that resolves to this IP address.
PHP 5 is required for the brand new SiteBuilder component.
The disk space allocated to the /tmp directory exceeds 3 GB.
A user who runs the installer is able to execute files in the /tmp directory. This
makes it possible to install the system packages required for the Panel. When the installation is completed, we recommend you to mount /tmp with the noexec option. For details on how to do it, see http://kb.parallels.com/en/1410 (http://kb.parallels.com/en/1410).
If you run Debian, CloudLinux, or Ubuntu, add updates and security repositories to
your apt (package manager) configuration.
Your hard drive must be properly partitioned. For instructions, see the article at
http://kb.parallels.com/article_17_819_en.html on partitioning tips.
Additionally, we recommend you to install the Panel on a clean operating system.
8 Installation and Upgrade Requirements

Installation and Upgrade on Windows

Before installing or upgrading Parallels Plesk Panel for Windows, make sure that the following requirements are met:
Before starting the installation process we strongly recommend that you create a
full system backup of the entire server.
Internet Information Services (IIS) should be installed with World Wide Web
(WWW) Service and File Transfer Protocol (FTP) Service support.
A static IP address should be configured in the OS prior to the Panel installation.
The installation path of the Panel must contain only ASCII symbols.
The Panel can be installed only on NTFS partition.
If you plan to use Microsoft SQL Server support in the Panel, the SQL Server
should be installed and configured to use standard or mixed security mode. If the SQL Server is not installed, you can select it to be installed with the Panel and configured with administrator name sa and a random password.
Note: To install Microsoft SQL Server 2008 as a part of Plesk installation, preliminarily install Microsoft Installer 4.5 and .NET Framework 2.0 SP 2. If you are running Windows 2003 server install the Service Pack 2 for Windows 2003 before installing the Panel.
To install the Panel on Linux- or Windows-based servers, use the Parallels Installer
In this chapter:
Installation from the Web Interface .................................................................... 10
Installation from the Command Line .................................................................. 12
Installation Using One-Click Installer ................................................................. 14
Initializing the Panel .......................................................................................... 15
C H A P T E R 3

Installing the Panel

utility. The utility connects to the Parallels Updates server where the Panel packages are stored, retrieves required packages and installs them.
The Parallels Installer utility is available for downloading from
http://www.parallels.com/products/plesk/download/. There are several distributions of
Parallels Installer created for different operating systems and platforms, so be sure to obtain the Parallels Installer that matches your host operating systems. Normally, Parallels Installer binaries are distributed under names in the following format:
parallels_installer_v<installer version>_os_<operating system version>_<platform>. Parallels Installer works in either via a Web graphical user
interface or command line.
If you run Linux and wish to quickly install the latest version of the Panel in the typical configuration, we recommend that you use our separate utility One-Click Installer. Learn more about this tool in a corresponding section of this chapter.
After the installation, perform the initial configuration of the Panel. Until the Panel is initialized, any other operations are prohibited. Initialization sets the Panel administrator password, e-mail, and contact information.
10 Installing the Panel

Installation from the Web Interface

To install Parallels Plesk Panel from the web interface, follow the instructions provided below in this section.
If you wish to include the Customer & Business Manager (C&BM) component during the installation, the Panel host name must be resolvable to an IP address. This limitation is caused by the fact that the Panel uses Single Sign-on (SSO) to interact with C&BM, and the SSO service is unable to work with unresolved host names or directly with IP addresses.
To install the Panel using the Web interface:
1. Download the Parallels Installer utility that suits your operating system from http://www.parallels.com/products/plesk/download/ and save it on your server‟s hard drive.
2. (Only for Linux) Set the execution permission for Parallels Installer:
chmod +x parallels_products_installer_file_name
3. Run the Parallels Installer.
On a Linux/Unix server:
./parallels_products_installer_file_nameweb-interface
On a Windows server:
parallels_products_installer_file_name
(Only for Linux) Open your browser and enter https://host-name:8447/ or https://IP-
address:8447/ in the address bar. The Parallels Installer Web interface opens.
(Only for Windows) Parallels Installer wizard opens in a new browser window. When the installer starts, an additional console window opens. This window displays the operations performed by the utility. It is closed upon the successful installation, or after 30 minutes of inactivity.
4. (Only for Windows) Select the language for the installation wizard.
5. Log in to the web interface.
If you are running Windows, type the administrators username (Administrator),
administrators password, and click Log In.
If you are running Linux, type the system root user and password, and click Log
In.
6. (Optional) Click Update source and installation settings and specify the source of Parallels Plesk Panel distribution package:
Installing the Panel 11
By default, the Official Parallels Updates server is selected. Specify the location
where the installation files will be stored.
If you select a Mirror server, specify the products.inf3 file location in the URL
to the directory with .inf3 file field. Specify the location where the installation files
will be stored.
If you select a Local media, specify the products.inf3 file location in the
Absolute path to the .inf3 file field.
7. If you use a proxy server, select the Connect using a proxy checkbox and specify the following settings:
Specify proxy host name and port number in the Proxy address and port fields.
If this proxy server requires authentication, select the Require authentication
checkbox and specify username and password.
8. (Only for Linux) Select the installation language and click Save to save the installation preferences and proceed to installation.
9. Click Install or Upgrade Product. You are taken to the products list.
10. Select the checkbox corresponding to Parallels Plesk Panel and the
version that you want to install. By default, the latest products versions are selected.
11. Select the installation type:
By default, Typical installation is selected. It includes a minimal number of
packages required for the Panel to work.
To install all components of the Panel, select Full installation.
To install only selected components, select Custom installation.
12. If you wish to specify the components you want to install, select the
Preview components selection checkbox and click Continue.
13. (Only for Windows) To start the installation, change the product
installation paths as required, specify the new administrator password, and click Continue.
Note: You are able to separate the Panel data and user accounts data by storing it in two different directories. By default, these paths are set to the same directory, but we recommend to keep the user accounts data on a separate hard drive to achieve better performance and stability.
Once the installation is finished, initialize the Panel (on page 15). This is an arbitrary step when you set the Panel administrator password, e-mail and contact information. The Panel will not let you perform any actions until you initialize it.
12 Installing the Panel
After the Panel is initialized, obtain and install a free trial license key, or purchase and install a new production license. See the chapter Installing and Upgrading License Keys (on page 23) to learn how to obtain and install the Panel license keys.
If the server is protected by a firewall, be sure to configure the firewall as described in the Panel Administrators Guide, chapter Configuring and Maintaining Your Server, section
Configuring the Panel to Run Behind a Router with Firewall.

Installation from the Command Line

To install Parallels Plesk Panel from the command line, follow the instructions provided below in this section.
If you wish to include the Customer & Business Manager (C&BM) component during the installation, the Panel host name must be resolvable to an IP address. This limitation is caused by the fact that the Panel uses Single Sign-on (SSO) to interact with C&BM, and the SSO service is unable to work with unresolved host names or directly with IP addresses.
To install the Panel from the command line:
1. Download the Parallels Installer utility that suits your operating system from http://www.parallels.com/products/plesk/download/ and save it on your server‟s hard drive.
2. (Only for Linux) Set the execution permission for Parallels Installer:
chmod +x parallels_products_installer_file_name
3. Run the Parallels Installer.
On a Linux/Unix server:
./parallels_products_installer_file_name
On a Windows server:
parallels_products_installer_file_nameconsole
4. Read installation notes displayed on the screen and type n to proceed to the next screen. Press ENTER.
5. Specify the source of Parallels Plesk Panel distribution package.
You can choose to install from a local file system, the official Parallels Updates server, or another site. By default, the official server is selected.
If you wish to retrieve installation files from a local file system or network storage:
a Type s and press ENTER.
b To choose a local file system, type 1. To choose a network storage device, type
3. Press ENTER.
Installing the Panel 13
c If you chose a local file system, specify the location of products.inf3
configuration file. If you chose a network storage, specify the address. For example, http://example.com, http://192.168.10.10, ftp://192.168.10.10.
Note:If you are running Windows, it is possible to use local system paths when specifying the source. Network shares cannot be used directly, only if you preliminarily map a network drive to a local drive.
d When finished selecting the source, type n to proceed to the next step and
press ENTER.
6. If you use a proxy server, specify the following settings:
a Proxy host name and port number. To specify them, type s, type the host name,
type the port number, press ENTER to continue.
b User name and password. If this proxy server requires authentication, type a,
press ENTER, type username and press ENTER, type password and press ENTER.
c When finished with specifying proxy settings, type n and press ENTER to
continue with installation.
7. Select the product versions that you want to install: type the number corresponding to the product version you need and press ENTER, then type n and press ENTER to continue.
8. Select the components that you wish to install, type n and press ENTER to continue.
When prompted, specify the required parameters for the selected components.
To install a minimum number of packages required for Parallels Plesk Panel to
work, leave Typical and press ENTER.
To install all components of the Panel, select Full: type the corresponding
number and press ENTER.
To install only selected components, select Custom: type the corresponding
number and press ENTER.
To review the components that will be installed, type L and then press ENTER.
Tip: The selected packages are marked with [*] symbols. The packages that are already installed and do not require updating are marked with [=] symbols. The component groups that contain selected components are marked with [.]. To select or deselect a package, type the corresponding number and press ENTER..
9. (Only for Windows) Specify the directory where you want to install the Panel, and provide the administrators (admin) password. Type n and press ENTER to continue.
10. Confirm the installation: type n and press ENTER again.
The packages will be downloaded and installed. When the installation is finished, the Panel will start automatically.
14 Installing the Panel
Once the installation is finished, initialize the Panel (on page 15). This is an arbitrary step when you set the Panel administrator password, e-mail and contact information. The Panel will not let you perform any actions until you initialize it.
After the Panel is initialized, obtain and install a free trial license key, or purchase and install a new production license. See the chapter Installing and Upgrading License Keys (on page 23) to learn how to obtain and install the Panel license keys.
If the server is protected by a firewall, be sure to configure the firewall as described in the Panel Administrators Guide, chapter Configuring and Maintaining Your Server, section
Configuring the Panel to Run Behind a Router with Firewall.

Installation Using One-Click Installer

Use the One-Click Installer utility to perform a clean installation of the Panel in one step. The utility automatically determines your operating system and installs the latest version of an appropriate distributive in the typical configuration. One-Click Installer works only on Linux OSes.
To install the Panel, run one of the following commands on behalf of the superuser.
If you have the wget utility, run
wget -O - http://autoinstall.plesk.com/one-click-installer | sh
If you have the curl utility, run
curl http://autoinstall.plesk.com/one-click-installer | sh
If you have the fetch utility, run
fetch -o - http://autoinstall.plesk.com/one-click-installer | sh
Installing the Panel 15

Initializing the Panel

The Panel initialization - also known as initial configuration - is the first thing done to the Panel after it has been installed. Until the Panel is initialized, any other operations are prohibited. Initialization sets the Panel administrator password, e-mail, and contact information.
When Parallels Plesk Panel is installed, a random password is generated for the user admin, which replaces the old scheme when the same default password was used on all installations. This change was done to protect servers with freshly installed Panel from hacking by bots that use the default password.
After the installation is finished, you can set the admins password being authenticated in the Panel with credentials of the server system power user, that is root on Linux systems, and Administrator on Windows systems.
To initialize the Panel:
1. Log in to the Panel at https://<host-name-or-IP>:8443 using the server power user credentials.
2. Specify e-mail, new password, contact info and click OK.
This chapter discusses the upgrade earlier versions of the Panel to the latest one on
In this chapter:
Upgrade from the Web Interface ....................................................................... 17
Upgrade from the Command Line ..................................................................... 19
C H A P T E R 4

Upgrading the Panel

servers, be it Linux/Unix- or Windows-based.
To upgrade the Panel, use the Parallels Installer utility. The utility connects to the Parallels Updates server where the Panel packages are stored, retrieves required packages and upgrades them.
Important: Make sure you upgrade all installed components when upgrading to a newer version of Parallels Plesk Panel. This is required to avoid conflicts caused by outdated components.
The Parallels Installer utility is available for downloading from
http://www.parallels.com/products/plesk/download/. There are several distributions of
Parallels Installer created for different operating systems and platforms, so be sure to obtain the Parallels Installer that matches your host operating systems. Normally, Parallels Installer binaries are distributed under names in the following format:
parallels_installer_v<installer version>_<build date>_os_<operating system name>_<operating system version>_<platform>.
Parallels Installer works in either via a Web graphical user interface or command line.
Important: Parallels Plesk Panel 10 employs a new business model. The essential business objects are converted automatically during upgrade, and you will have to do several steps yourself to complete switching to the Panel 10 model. For detailed information, refer to the document titled Switching to Panel 10.
Upgrading the Panel 17

Upgrade from the Web Interface

To upgrade 8.x, 9.x, and 9.5 versions of Parallels Plesk Panel to the latest version via the Web interface, follow the instructions given below.
If you wish to include the Customer & Business Manager (C&BM) component during the upgrade, the Panel host name must be resolvable to an IP address. This limitation is caused by the fact that the Panel uses Single Sign-on (SSO) to interact with C&BM, and the SSO service is unable to work with unresolved host names or directly with IP addresses.
Important: Parallels Plesk Sitebuilder 4.5 is not upgraded. Alternatively, the new version of Sitebuilder installs beside the previous one. Hence, you have the opportunity to manage existing sites in Sitebuilder 4.5 and create new sites either in Sitebuilder 5.0 or in 4.5. The upgrade of existing sites to the new format is performed manually.
Important: If you have bundled Parallels Plesk Billing, add the Customer & Business Manager component to the list of components to upgrade.
To upgrade the Panel from the Web interface:
1. Download the Parallels Installer utility that suits your operating system from http://www.parallels.com/products/plesk/download/.
2. (Only for Linux) Set the execution permission for Parallels Installer.
chmod +x parallels_products_installer_file_name
3. Run the Parallels Installer.
On a Linux/Unix server:
./parallels_products_installer_file_nameweb-interface
On a Windows server:
parallels_products_installer_file_name
(Only for Linux) Open your browser and enter https://your-host-name-or-IP-
address:8447/ in the address bar. The Parallels Installer Web interface opens.
(Only for Windows) Parallels Installer wizard opens in a new browser window. When the installer starts, an additional console window opens. This window displays the operations performed by the utility. It is closed upon the successful installation, or after 30 minutes of inactivity.
4. (Only for Windows) Select the language for the installation wizard.
5. Log in to the web interface.
If you are running Windows, type the administrators username (Administrator),
administrators password, and click Log In.
18 Upgrading the Panel
If you are running Linux, type the system root user and password, and click Log
In.
6. Click Updates source and installation settings and specify the source of Parallels Plesk Panel distribution package:
By default, the Official Parallels Updates server is selected. Specify the location
where the installation files will be stored.
If you select a Mirror server, specify the .inf3 file location in the URL to the directory
with .inf3 file field. Specify the location where the installation files will be stored.
If you select a Local media, specify the .inf3 file location in the Absolute path to the
.inf3 file field.
7. If you use a proxy server, select the Connect using a proxy checkbox and specify the following settings:
Specify proxy host name and port number in the Proxy address and port fields.
If this proxy server requires authentication, select the Require authentication
checkbox and specify username and password.
8. (Only for Linux) Select the installation language and click Save to save the installation preferences and proceed to installation.
9. Click Install or Upgrade Product. You are taken to the products list.
10. Select the checkbox corresponding to Parallels Plesk Panel and the
Parallels Plesk Panel product versions that you want to upgrade to . By default, the latest products versions are selected.
11. To review the components that will be installed, select the Preview components selection checkbox and click Continue. You can see the list of
available components. To select or deselect a component , select or clear the corresponding checkbox. To select or deselect all the components, click Select all or None respectively.
12. To start the upgrade, click Continue.
The packages will be downloaded and installed. When the upgrade is finished, you will see a notification saying All products and components have been successfully installed and upgraded. Click OK.
Upgrading the Panel 19

Upgrade from the Command Line

To upgrade 8.x, 9.x, and 9.5 versions of Parallels Plesk Panel to the latest version via the command line, follow the instructions given below.
If you wish to include the Customer & Business Manager (C&BM) component during the upgrade, the Panel host name must be resolvable to an IP address. This limitation is caused by the fact that the Panel uses Single Sign-on (SSO) to interact with C&BM, and the SSO service is unable to work with unresolved host names or directly with IP addresses.
Important: Parallels Plesk Sitebuilder 4.5 is not upgraded. Alternatively, the new version of Sitebuilder installs beside the previous one. Hence, you have the opportunity to manage existing sites in Sitebuilder 4.5 and create new sites either in Sitebuilder 5.0 or in 4.5. The upgrade of existing sites to the new format is performed manually.
Important: If you have bundled Parallels Plesk Billing, add the Customer & Business Manager component to the list of components to upgrade.
To update or upgrade your Panel through the command line:
1. Download the Parallels Installer utility that suits your operating system from http://www.parallels.com/products/plesk/download/ and save it on your server‟s hard drive.
2. (Only for Linux) Set the execution permission for Parallels Installer:
chmod +x parallels_products_installer_file_name
3. Run the Parallels Installer.
On a Linux/Unix server:
./parallels_products_installer_file_name
On a Windows server:
parallels_products_installer_file_nameconsole
4. To confirm upgrade, type y and press ENTER.
5. Specify the source of Parallels Plesk Panel distribution package.
You can choose to upgrade from a local medium, the official Parallels Updates server, or another site. By default, the official server is selected. If you wish to retrieve installation files from a local medium or network storage:
a Type s and press ENTER.
b To choose a local medium, type 1. To choose a network storage device, type 3.
Press ENTER.
20 Upgrading the Panel
c If you chose a local medium, specify the location of psa.inf configuration file. If
you chose a network storage, specify the address. For example,
http://example.com, http://192.168.10.10, ftp://192.168.10.10.
Note:If you are running Windows, it is possible to use local system paths when specifying the source. Network shares cannot be used directly, only if you preliminarily map a network drive to a local drive.
6. If you use a proxy server, specify the following settings:
a Proxy host name and port number. To specify them, type s, type the host name,
type the port number, and press ENTER to continue.
b User name and password. If this proxy server requires authentication, type a,
press ENTER, specify username and press ENTER, type password and press ENTER.
c When finished with specifying proxy settings, type n and press ENTER to
continue.
7. Select the product version that you wish to upgrade to: type the number corresponding to the product version you need and press ENTER, then type n and press ENTER to continue.
8. Select the components that you wish to install or upgrade.
Tip: The selected packages are marked with [*] symbols. The packages that are
already installed and do not require updating are marked with [=] symbols. The component groups that contain selected components are marked with [.]. To select or deselect a package, type the corresponding number and press ENTER..
9. To continue with the upgrade, type n and press ENTER. When prompted, confirm upgrading: type n and press ENTER again.
The packages will be downloaded and installed.
Parallels Plesk Billing is a billing solution that either bundles with earlier Panel versions
C H A P T E R 5

Upgrading Standalone Parallels Plesk Billing to the Panel

or ships as a standalone product. The difference between the bundled and standalone versions is that in the first case - bundled installation - the application utilizes the Panel license. In the second case, the application uses its own license.
If you have a standalone Plesk Billing, you can migrate it to Customer and Business Manager - the Panel 10 component. For this, run a migration script that converts data in the existing database to a new format and switches the Panel to use the updated database.
To migrate from Plesk Billing to the Panel:
1. Install the latest version of the Panel 10 with Customer and Business Manager. For instructions on how to do it, see the Installing the Panel chapter (on page 9).
Note: We recommend that you turn off connections to your existing database to avoid concurrent access to it from Plesk Billing and the Panel. To turn off the connections, disable virtual hosts that serve Plesk Billing.
2. Run the migration script in your command line with the Plesk Billing database specified.
Note: In case you migrate to a different host, make sure that the existing and newly created databases have different names. If the names are equal, the migration script will fail to run. To resolve this naming problem, preliminarily dump your existing database, create a new database, and deploy the dump to it.
To migrate under Linux, run the following script:
/usr/share/plesk-billing/migrate-dbuser=<username> -­name=<dbname> --password=<password> [ --host=<hostname> (localhost by default)]
To migrate under Windows, run the following script:
%plesk_bin%\php.exe -dauto_prepend_file=‖‖ %plesk_dir%billing\scripts\ migrate-db.phpuser=<username> -
-name=<dbname> --password=<password> [ --host=<hostname> (localhost by default)]
Note: The migration script creates a database dump in the current directory.
3. Locate the Panel (https://<your-host-name>:8443/), perform the initial
configuration, and open Business Manager at https://<your-host-
name>:8443/plesk-billing/admin.
22 Upgrading Standalone Parallels Plesk Billing to the Panel
Plesk Billing is now successfully migrated to Business Manager. You may now remove your standalone Plesk Billing.
In this chapter:
Installing License Keys ...................................................................................... 23
Upgrading a Trial License Key .......................................................................... 24
C H A P T E R 6

Installing and Upgrading License Keys

Installing License Keys

To install a license key through the Panel graphical user interface:
1. On your Home page, click Tools & Utilities > License Management.
2. Click the Upload Key icon.
3. Specify the path to the license key file location: enter the path into the
input box provided, or click Browse to browse for the desired location.
4. Select the Replace the currently installed license key with the selected one checkbox.
5. Click OK to submit.
The license key file will be upload to the Panel.
If you wish to upload keys for additional product features, select the Additional License Keys tab and upload the keys.
To install a license key through the command line interface:
To install a Panel license key using the Panel CLI, you should first upload it to the machine with the Panel, and then install it with the license utility:
license <--install|-i> <path-to-key-file>
For example,
1. On Linux/Unix:
./license -i /tmp/pp10key.xml
2. On Windows:
license.exe -i D:\keys\pp10key.xml
24 Installing and Upgrading License Keys

Upgrading a Trial License Key

To upgrade the trial license key through the Panel interface:
1. Log in to Panel as administrator.
2. On your Home page, click Tools & Utilities > License Management > Order New
Key.
3. The online store will open in a separate browser window. In this window, select the items and features you want to include into your license and click Submit. In the next steps, indicate the currency, number of license keys, provide contact details, billing address, and payment method, and submit the form. The new key will be sent to the specified e-mail address.
4. Save the new key to the hard drive on your local machine.
5. Open again the License Management screen in Parallels Plesk Panel (Home
> Tools & Utilities > License Management) and click Upload Key.
6. Enter the path to the key file that you saved on your local machine or click Browse to locate it.
7. Select the Replace the currently installed license key with the selected one checkbox to confirm that you really want to replace the current license key with the new one.
If this checkbox is not selected, the new license key will not be installed and installation will be aborted.
8. If your new license key allows hosting fewer sites than you already host on the server, the Panel will stop working. However, to prevent the Panel from comparing the amount of the resources used and those covered by the new key, select the Do not check the resource usage limits defined by the key checkbox.
This might be helpful if you want to temporarily install a license key that covers less resources and then upgrade it through the Panel interface.
9. Click OK to install the new key to the Panel.
If you experience any problems, please contact sales@parallels.com.
To keep your servers operating system up-to-date, you may want to configure the
C H A P T E R 7

Configuring the Panel for Linux to Access Vendor Updates

Parallels Installer so as to notify you of new update packages available from your vendor. Note that the Parallels Installer will not install any packages without your confirmation, it will only notify you.
Note: This option is available only for RPM-based operating systems. For DEB-based systems, vendor updates repository is added to the sources list of the APT package manager.
To have the Parallels Installer check vendor sites for updates:
1. Create a text file with name .autoinstallerrc in the /root/ directory on the server, or, if you previously created this file, modify it. Add the following line to the file:
ADDITIONAL_SOURCE=<type>, <priority>, <url>, <username>, <password>
where you should replace <type> with repomd value, <priority> with a number from 1 to 999 (999 is the highest priority), and <url> with a URL of the vendor updates source. The values <username> and <password> are required only if your vendors site requires authentication.
2. Save the file and exit from the text editor.
If you want to deploy the Secure Lightweight Virtual Environment (SecureLVE)
C H A P T E R 8

Enabling Support for SecureLVE

extension on a server running Cloud Linux, install the SecureLVE packages by following the instructions at http://www.cloudlinux.com/docs/securelve.php.
You can install SecureLVE before or after installing Parallels Plesk Panel 10.
To make sure that SecureLVE functions properly, you need to install the following package versions:
liblve-0.7.3-2.el5.cloudlinux
securelve-0.6-3.el5.cloudlinux
vixie-cron-4.1-77.2.el5.cloudlinux
lve-0.7.3-2.el5.cloudlinux
After installing SecureLVE, you must initialize it by issuing the following command in the console:
securelve_init
Important: If you install or upgrade Parallels Plesk Panel after installing SecureLVE, you need to run the securelve_init command again. After upgrading, also use the command securelve_user <username> to enable SecureLVE shell for each system user account that used it.
After SecureLVE initialization, to update the list of shells available in the system, issue the following command in the console:
/usr/local/psa/admin/sbin/packagemng
Now you can set up access to the server over SSH for your customers by modifying service plans.
To allow the customers to log in to the SecureLVE shell:
1. Log in to the Server Administration Panel.
2. Go to Service Plans > plan name > Hosting Parameters tab.
3. Select the checkbox SSH access to the server shell under the subscriptions
system user, and select the securelve_sh option from the menu.
4. Click OK to save the plan properties.
This chapter describes how to troubleshoot difficulties that may occur when you try to
In this chapter:
You are unable to deselect the SiteBuilder component when installing the Panel 28 The system does not recognize that IIS is installed during the Panel installation 28
You are unable to install the Kaspersky component on Windows 2008 ............. 29
C H A P T E R 9

Troubleshooting the Installation and Upgrade Process

install or upgrade the Panel. If you experience the problem that is not resolved in this chapter, visit the Parallels support (http://www.parallels.com/support/).
28 Troubleshooting the Installation and Upgrade Process

You are unable to deselect the SiteBuilder component when installing the Panel

Diagnosis
It is not possible to deselect the SiteBuilder component when installing the Panel.
Resolution
The SiteBuilder is one of the core components and it is required for the proper Panel installation.

The system does not recognize that IIS is installed during the Panel installation

Diagnosis
If the installer fails to find IIS during the Panel installation, it displays the following message:Error: You should install the Microsoft Internet Information Server (IIS) with WWW service prior to installing Plesk. Please click the Start button, then select Settings->ControlPanel->Add/Remove programs, choose Add\\Remove windows components and install IIS with FTP and WWW services. Refer to Windows Help for details. After you install the required services and continue the wizard, the error remains.
Resolution
Retry the ISS recognition by restarting the wizard in your browser by opening the page
http://<your-host-name-or-ip>:8447 and repeating the installation steps from the
beginning.
Troubleshooting the Installation and Upgrade Process 29

You are unable to install the Kaspersky component on Windows 2008

Diagnosis
If you select the Kaspersky component when installing the Panel for Windows 2008, the following error is displayed: A dependency problem is found: Windows 2008 or higher is not supported by Kaspersky anti-virus.
Resolution
The component is not supported for this operating system. Go to the Select Components page, deselect the component, and continue the installation.
Loading...