Upgrading the WebHosting Plesk Module

When you upgrade from CloudBlue Commerce 20.4 to CloudBlue Commerce 20.5, the WebHosting Plesk module and its components are automatically upgraded to the latest version. However, Plesk software running on hosting service nodes is not upgraded automatically.

Here is what you need to do to upgrade:

Ensure that all Plesk service nodes are upgraded to version 17.8.
Upgrade CloudBlue Commerce from version 20.4 to version 20.5.
Install the shm-20.5-41 hotfix. The hotfix adds support for Plesk 18.0 on CloudBlue Commerce 20.5.
Upgrade Plesk 17.8 to 18.0.

Note: PHP on the Websites Manager node is upgraded automatically to version 7.3 using RPM packages from the Remi's repository at https://rpms.remirepo.net/. To ensure a smooth upgrade, make sure that a firewall on the Websites Manager node does not block HTTP and HTTPS connections to remirepo.net.

Upgrading Plesk on Service Nodes to Version 17.8

Important: CloudBlue Commerce 20.5 does not support Plesk versions earlier than 17.8. Before upgrading to CloudBlue Commerce 20.5, ensure that all Plesk service nodes are upgraded to Plesk 17.8.

To upgrade Plesk on service nodes to version 17.8:

Log in as root or Administrator to the service node with Plesk over SSH (on Linux) or Remote Desktop (on Windows).
Open the following file for editing:
- On Linux: /root/.autoinstallerrc
- On Windows: C:\.autoinstallerrc
Locate the line starting with the word SOURCE and replace 17.5.3 with 17.8.11. Save the file.
Stop the Plesk Installer process (on Windows) or autoinstaller (on Linux) if it is running.
Go to the Provider Panel of CloudBlue Commerce > Services > WebHosting Plesk > Service Nodes tab, click Components in the Actions column, and then click Install or Upgrade Product.
Select the checkbox next to Plesk and click Continue.
After upgrading is finished, repeat the steps 1 to 6 for each hosting service node with Plesk.
Go to Provider Panel > Services > WebHosting Plesk > Service Nodes tab, select the checkbox next to the IP address column heading, and click Refresh.

Upgrading CloudBlue Commerce 20.4 to CloudBlue Commerce 20.5

For instructions on how to upgrade to CloudBlue Commerce, please refer to this guide.

Important: Before you start upgrading to CloudBlue Commerce 20.5, increase the timeout in the Websites Manager configuration: On the Websites Manager node, edit the file /etc/httpd/conf.d/dispatcher.conf, specify Timeout 7200 instead of the default Timeout 600, save the configuration file, and reload the httpd service with the command service httpd reload. After the upgrade is finished, be sure to set the timeout value back to 600. To learn more about this issue, please refer to this article.

Upgrading Plesk on Service Nodes to Version 18.0

Install the shm-20.5-41 hotfix before upgrading Plesk to version 18.0.
Upgrade Plesk on service nodes to version 18.0:
1. Log in as root or Administrator to the service node with Plesk over SSH (on Linux) or Remote Desktop (on Windows).
2. Open the following file for editing:
  - On Linux: /root/.autoinstallerrc
  - On Windows: C:\.autoinstallerrc
3. Locate the line starting with the word SOURCE and replace 17.8.11 with 18.0. Save the file.
4. Stop the Plesk Installer process (on Windows) or autoinstaller (on Linux) if it is running.
5. Go to the Provider Panel of CloudBlue Commerce > Services > WebHosting Plesk > Service Nodes tab, click Components in the Actions column, and then click Install or Upgrade Product.
6. Select the checkbox next to Plesk and click Continue. If you encounter the "Releases not selected yet." error message, click the Cancel modifying link, then click Install or Upgrade Product, select Plesk, and click Continue.
7. On Windows-based service nodes, add the read permission for the user shmsnapi to the file C:\Program Files (x86)\Plesk\admin\plib\modules\shm\public\whp-api.php.
8. After upgrading is finished, repeat the steps a to g for each hosting service node with Plesk.
9. Go to Provider Panel > Services > WebHosting Plesk > Service Nodes tab, select the checkbox next to the IP address column heading, and click Refresh.