Question


What are the changes/impact to the subscriptions after synchronization in OA > Service templates > WHP ST > Synchronization?


The question is related to this statement from the official documentation:

If you make any changes to a service template later, you will need to synchronize the changes with the subscriptions that were created based on it. The synchronization involves the reconfiguration of multiple websites.


Answer


The changes depend on the service template the subscription is based on.

When the Synchronize button is clicked, 3 rest calls as below will be executed:


Example from Plesk service template resource:

Request URL: https://example.com/aps/2/resources/af9498c9-3ef8-4d46-bbb1-48a59a9df290/resources?implementing(http%3A%2F%2Fwww.odin.com%2Fshm%2Ftemplate%2F1)

[
    {
        "aps": {
            "modified": "2020-10-20T08:51:22Z",
            "id": "526852a6-6ad3-4675-8073-49c7c135ed6d",
            "type": "http://www.odin.com/shm/template/plesk/mail/1.0",
            "status": "aps:ready",
            "revision": 3
        },
        "configuration": {
            "nonExistingMail": {
                "action": "reject",
                "forwardTo": "",
                "bounceMessage": ""
            }
        },
        "properties": [
            {
                "label": "ウェブメール",
                "name": "webmail",
                "class": "setting",
                "type": "enum",
                "value": "roundcube"
            },
            {
                "name": "manageSpamFilter",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "manageAntivirus",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            }
        ]
    },
    {
        "ipv6Address": "none",
        "aps": {
            "modified": "2022-08-18T02:40:50Z",
            "id": "7a50426c-b302-4b60-a1b3-ab089d050ffe",
            "type": "http://www.odin.com/shm/web/template/apache/1.0",
            "status": "aps:ready",
            "revision": 17
        },
        "dbConfiguration": {
            "mode": "local"
        },
        "appsFilter": [
            "WordPress"
        ],
        "appsFilterEnabled": true,
        "ipv4Address": "shared",
        "technicalDomainName": "w{WEBSPACE_ID}.{PARENT_DOMAIN}",
        "properties": [
            {
                "name": "manage_sh_access",
                "class": "permission",
                "type": "boolean",
                "value": "false"
            },
            {
                "name": "manage_not_chroot_shell",
                "class": "permission",
                "type": "boolean",
                "value": "false"
            },
            {
                "name": "manage_phosting",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "manage_php_version",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "manage_php_settings",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "manage_crontab",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "manage_anonftp",
                "class": "permission",
                "type": "boolean",
                "value": "false"
            },
            {
                "name": "allow_local_backups",
                "class": "permission",
                "type": "boolean",
                "value": "true"
            },
            {
                "name": "allow_ftp_backups",
                "class": "permission",
                "type": "boolean",
                "value": "false"


When the synchronization is started, the following types of tasks are scheduled (per every webspace/site/mail domain) :


Configuring "SiteWeb" for APS application WebHosting Plesk 

Configuring "WebSpace" for APS application WebHosting Plesk 

Configuring "MailDomain" for APS application WebHosting Plesk



Default behaviour: Web Hosting Plesk does not check phpSettings by permissions and always overwrites them to a new value in the service template.


The following parameters will be changed to the new/default values from the service template:

  • PHP Setting
  • Hosting Parameter
  • Database configurations
  • Default FTP user (starts with sys_*)


The following parameters will be ignored/not be changed by the synchronization:

  • Default FTP password for user sys_*
  • Additional FTP users
  • Website content


Impact: The Apache web server may be restarted every time an Apache-based website is reconfigured. Thus, if a mass update is done, there will be many restarts of the Apache web server, and the corresponding websites will be unavailable for a relatively long period of time.

IMPORTANT: there is an existing issue with Web Hosting Plesk subscription synchronization #WHM-10757 which causes end-customers loosing their custom PHP settings of the websites on every synchronization of  a Web Hosting Plesk service template with its subscriptions. It means that all custom PHP settings must be re-configured after every synchronization.