How do I enable XSD validation for XML-API packets recevied from Plesk nodes?

Article ID: 5515 
Last Review: Oct,6 2008
Author: Tarasov Yuri
Last updated by: system APPLIES TO:
  • Parallels Business Automation - Standard 3.3.x

Cause

Malformed XML-API packet received by PBAS system may cause serious synchronization issues with Plesk nodes sending invalid/corrupted XML-API packets. Though Plesk validates XML before sending it out, enabling XSD validation in PBAS system should prevent any possibility of processing invalid/corrupted XML-API packets from Plesk nodes and notify Provider about such cases in Action log.

Resolution

To enable XSD validation for XML-API packets recevied from Plesk nodes please use the following steps:

  • ensure that libxml2 packet version installed inside PBAS Container is at least 2.6.16 version:
    # rpm -q libxml2
    libxml2-2.6.26-2.1.2.1
  • in case libxml2 version is older than 2.6.16 please update libxml2 package to more recent version using updates from vendor for corresponding OS distribution (using yum or rpm commands)
  • upgrade PBAS system to the latest available (at least 3.3.3-05) version
  • add the following line into /etc/hspc/hspc.conf configuration file:
    PLESK_XSD_VALIDATE = 1
  • restart PBAS backend to apply changes:
    # /etc/init.d/hspcd restart

With XSD validation enabled after receiving XML packets non-conforming to XSD schemas PBAS system will report failed action in Action log on Top > Action log screen and will ignore the API request/reply processing.

Keywords: XML-API, API, XML, XSD, validation


Subscription for this article changesSubscription for this article changes

Please provide feedback on this article

Did this article help you solve your issue?
Yes
No
Partially
I do not know yet
 
Strongly Agree   Strongly Disagree
  9 8 7 6 5 4 3 2 1
The article is easy to understand
The article is accurate
Additional Comments:
*Please provide us with your email address in case we need to contact you.
* - required fields