Upgrading Parallels Plesk Panel on Linux and FreeBSD

You can upgrade Parallels Plesk Panel in any of the following ways:

• Using the Parallels Plesk Panel's Web interface. You log in to your Parallels Plesk Panel as the administrator, go to the Home > Updates section of the Parallels Plesk Panel, choose the product version and the components to install, and simply wait until the installation is completed. This is recommended for most users.
• Using the Parallels Products Installer console utility. You can find it in your Parallels Plesk Panel distribution or download from the Parallels download site. After you run it, you are taken through the upgrade procedure step by step. This will take more time as you will be prompted to choose the options and packages to install at each step.
• Using the Parallels Products Installer utility's Web interface.

Note: If you use Qmail mail server with Parallels Plesk Panel and want to use Postfix mail server instead, you can easily switch to Postfix while upgrading to Parallels Plesk Panel 9.0. To do this, during Parallels Plesk Panel upgrade, select Postfix in the list of components to be installed. Please note, that when Parallels Plesk Panel is switched from using Qmail mail server to using Postfix mail server, the max_letter_size parameter is changed to the default value for this mail server.

To update or upgrade your Parallels Plesk Panel software from the control panel:

1. Log in to Parallels Plesk Panel as administrator, on the Home page, click Updates.

   Parallels Plesk Panel connects to the Parallels Plesk Panel Update server, retrieves information on the available releases, then analyses the components installed in your system, and displays the lists of available releases and component updates. For each Parallels Plesk Panel version released a brief description of available operations is displayed.

   Note: If you want to update/upgrade from a locally stored Parallels Plesk Panel distribution or Parallels Plesk Panel update server mirror inside your network, click Preferences, select the Parallels Plesk Panel Update Source tab, select the Network storage source type, specify the URL and click OK.

2. Select the Parallels Plesk Panel version that you want to update, or upgrade to. A list of available components appears.
3. Select the check boxes corresponding to the components you want to install and click Install.
4. Specify your e-mail address. You will be sent a notice by e-mail once update is completed.
5. To confirm installation of the selected components, select the check box and click OK. The components or updates you selected will be downloaded and automatically installed in the background mode.

To update or upgrade your Parallels Plesk Panel software using the command line of the Parallels Products Installer utility:

1. Run the parallels_installer binary file, which is located in the directory /usr/local/psa/admin/bin/ on RPM-based Linux, FreeBSD and Mac OS systems, and /opt/psa/admin/bin/ on deb-based Linux systems.
2. Read the installation instructions displayed on the screen, and then type 'n' and press ENTER to continue. The Parallels Products Installer will detect your existing installation of Parallels Plesk Panel and ask if you want to upgrade it.
3. To confirm upgrade, type 'y' and press ENTER.
4. Specify the source of Parallels Plesk Panel distribution package.

   You can choose to upgrade from a local medium, the official Parallels Plesk Panel update server, or another site. By default, the official Parallels Plesk Panel update server is selected. If you wish to retrieve installation files from a local medium or network storage:

   1. Type 's' and press ENTER.
   2. To choose a local medium, type 1. To choose a network storage device, type 3. Press ENTER.
   3. 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.
5. If you use a proxy server, specify the following settings:
   1. Proxy host name and port number. To specify them, type 's', type the host name, type the port number, and press ENTER to continue.
   2. User name and password. If this proxy server requires authentication, type 'a', press ENTER, type user name and press ENTER, type password and press ENTER.
   3. When finished with specifying proxy settings, type 'n' and press ENTER to continue with installation.
6. 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.
7. On a FreeBSD system, specify FreeBSD Ports Collection tarball URL, distfiles master site URL and Ports updating source, if required. It is recommended that you use the default settings. Press ENTER to continue.
8. Select the components that you wish to install or upgrade. Specify the required parameters for the selected components, when prompted.

   Type 'L' and press ENTER. The selected packages are marked with [*] symbols. The packages that are already installed and do not require updating are marked with [=] symbols. To select or deselect a package, type the respective 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.

To upgrade Parallels Plesk Panel software on your server through Parallels Products Installer's Web interface (available starting from Parallels Products Installer 3.4.0):

1. Run the parallels_installer binary file with the --web-interface option. The parallels_installer file is located in the directory /usr/local/psa/admin/bin/ on RPM-based Linux, FreeBSD and Mac OS systems, and /opt/psa/admin/bin/ on deb-based Linux systems.
2. Open your browser and enter https://machine.domain.name:8447/ or https://IP-address:8447/ in the address bar. The Parallels Product Installer Web interface opens. Log in as root.
3. 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. By default, the installation files are stored in the /root/parallels directory.
   • 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. By default, the installation files are stored in the /root/parallels directory.
   • If you select a Local media, specify the .inf3 file location in the Absolute path to the .inf3 file field.
4. If you use a proxy server, select the Connect using a proxy check box 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 check box and specify user name and password.
5. Select the installation language and click Save to save the installation preferences and proceed to installation.
6. Click Install or Upgrade Product. You are taken to the products list.
7. Select the check box 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. You can also select Sitebuilder Web site creation and management system, Single Sign-on support, and Parallels Workstation components to be installed with Parallels Plesk Panel.
8. To review the components that will be installed, select the Preview components selection check box and click Continue. You can see the list of available components. To select or deselect a component, select or clear the corresponding check box. To select or deselect all the components, click Select all or None respectively.
9. To start installation, click Continue.

   The packages will be downloaded and installed. When the installation is finished, you will see a notification saying "All products and components have been successfully installed and upgraded." Click OK.

To add components to the installed Parallels Plesk Panel through Parallels Products Installer's Web interface (available starting from Parallels Products Installer 3.4.0):

1. Run the parallels_installer binary file, which is located in the directory /usr/local/psa/admin/bin/ on RPM-based Linux, FreeBSD and Mac OS systems, and /opt/psa/admin/bin/ on deb-based Linux systems, with the --web-interface option.
2. Open your browser and enter https://machine.domain.name:8447/ or https://IP-address:8447/ in the address bar. The Parallels Product Installer's Web interface opens. Log in as root.
3. 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. By default, the installation files are stored in the /root/parallels directory.
   • 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. By default, the installation files are stored in the /root/parallels directory.
   • If you select a Local media, specify the .inf3 file location in the Absolute path to the .inf3 file field.
4. If you use a proxy server, select the Connect using a proxy check box 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 check box and specify user name and password.
5. Select the installation language and click Save to save the installation preferences and proceed to installation.
6. Click Add Components. You are taken to the list of Parallels Plesk Panel components, installed and available for installation.
7. Select the components that you want to install. To select or deselect a component, select or clear the corresponding check box. To view only not installed components, select the Show only not installed components check box.
8. To start the components update, click Continue.

   The packages will be downloaded and installed. When the installation is finished, you will see a notification saying "All products and components have been successfully installed and upgraded." Click OK.

To update installed Parallels Plesk Panel components for which updates are available through Parallels Products Installer's Web interface (available starting from Parallels Products Installer 3.4.0):

1. Run the parallels_installer binary file, which is located in the directory /usr/local/psa/admin/bin/ on RPM-based Linux, FreeBSD and Mac OS systems, and /opt/psa/admin/bin/ on deb-based Linux systems, with the --web-interface option.
2. Open your browser and enter https://machine.domain.name:8447/ or https://IP-address:8447/ in the address bar. The Parallels Product Installer's Web interface opens. Log in as root.
3. 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. By default, the installation files are stored in the /root/parallels directory.
   • 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. By default, the installation files are stored in the /root/parallels directory.
   • If you select a Local media, specify the .inf3 file location in the Absolute path to the .inf3 file field.
4. If you use a proxy server, select the Connect using a proxy check box 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 check box and specify user name and password.
5. Select the installation language and click Save to save the installation preferences and proceed to installation.
6. Click Update Components. You are taken to the list of components for which updates are available.
7. Select the components that you want to update. To select or deselect a component, select or clear the corresponding check box. To select or deselect all the components, click Select all or None respectively.
8. To start the components update, click Continue.

   The packages will be downloaded and installed. When the installation is finished, you will see a notification saying "All products and components have been successfully installed and upgraded." Click OK.