Article ID: 115854, created on Mar 28, 2013, last review on Aug 15, 2014

  • Applies to:
  • Operations Automation

Symptoms


An APS application may declare structured-output element for provisioning scripts. It means that script must provide output in XML format which must conform to the special RELAX-NG scheme for APS controller to be able to process provided output correctly.

If an APS application declared structured-output element for a provisioning script and output of a script does not conform to the scheme APS tasks will fail for an application with the 'Document not well-formed' error message, the problem and resolution is described in the Knowledgebase article #115033 APS task fails: 'Document not well-formed'.

The article describes how to verify that script output conforms to the scheme.

Resolution


Download the following ZIP archive from the official APS Standard website - http://apsstandard.org/doc/package-format-specification-12.zip.

Unpack the downloaded file on a Linux server which has the xmllint utility installed, it is provided by the libxml2 RPM package.

Go to the rng folder in the unpacked content.

Run the script and save its output in the temporary file output.xml.

Use the xmllint utility to verify that the output.xml file conforms to the required RELAX-NG scheme.

For configuration scripts:
# xmllint --relaxng configure-output.rng output.xml
For resource scripts:
# xmllint --relaxng resource-output.rng output.xml
You may also verify scripts against W3C XML schema, corresponding files are located in the xsd folder in the ZIP archive linked above. Use the commands below to perform verificaion in the xsd folder.

For configuration scripts:
# xmllint --scheme configure-output.xsd output.xml
For resource scripts:
# xmllint --scheme resource-output.xsd output.xml

caea8340e2d186a540518d08602aa065 5356b422f65bdad1c3e9edca5d74a1ae e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF