Root Element and XML Namespaces

The table below contains the target namespace and namespaces required for XML parser to validate XML document (see the XML sample below).

Namespace

xmlns=” http://www.parallels.com/psa/migration/agent”

xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=”http://www.parallels.com/psa/migration/agent AgentManifest.xsd”

XML schema below defines the manifest element as the root element of the agent manifest XML document (see the AgentManifest.xsd).

XML schema:

<?xml version="1.0" encoding="UTF-8"?>

<xsd:schema

xmlns="http://www.parallels.com/psa/migration/agent"

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

targetNamespace="http://www.parallels.com/psa/migration/agent"

elementFormDefault="qualified"

attributeFormDefault="unqualified">

<xsd:simpleType name="SourceSystemName">

<xsd:restriction base="xsd:token">

<xsd:maxLength value="128"/>

<xsd:pattern value="[a-zA-Z]{1}[a-zA-Z0-9\._]*[a-zA-Z0-9]{1}"/>

</xsd:restriction>

</xsd:simpleType>

<xsd:simpleType name="Version">

<xsd:restriction base="xsd:token">

<xsd:maxLength value="128"/>

<xsd:pattern value="[0-9]+\.[0-9]+\.[0-9]+"/>

</xsd:restriction>

</xsd:simpleType>

<xsd:complexType name="ConnectionSettings">

<xsd:choice>

<xsd:element name="ssh" type="SSHConnectionSettings"/>

<xsd:element name="webservice"/>

</xsd:choice>

</xsd:complexType>

<xsd:simpleType name="Readme">

<xsd:restriction base="xsd:string">

<xsd:maxLength value="512"/>

</xsd:restriction>

</xsd:simpleType>

<xsd:complexType name="MigrationAgent">

<xsd:sequence>

<xsd:element name="sourceSystem" type="SourceSystemName"/>

<xsd:element name="version" type="Version"/>

<xsd:element name="connectionSettings" type="ConnectionSettings"/>

<xsd:element name="features" type="AgentFeatures" minOccurs="0"/>

<xsd:element name="platformTransformation" type="xsd:string" minOccurs="0"/>

<xsd:element name="accountTransformation" type="xsd:string" minOccurs="0"/>

<xsd:element name="servicesTransformation" type="xsd:string" minOccurs="0"/>

<xsd:element name="readme" type="Readme" minOccurs="0"/>

</xsd:sequence>

</xsd:complexType>

<xsd:element name="migrationAgent" type="MigrationAgent"/>

</xsd:schema>

Element/Attribute

Optional

Default Value

Available

since

 

Description

sourceSystem

 

 

2.8

Source system name. The value of this element will be used as Migration Agent unique identifier.

version

 

 

2.8

Agent’s version.

connectionSettings

 

 

2.8

Connection settings using for communicating with the Migration Agent on the source server. Child of this node depends on the connection type.

Supported connection types are:

ssh or webservice.

ssh

 

 

2.8

Indicates that SSH protocol should be used to communicate with the agent. See the SSH Connection Settings section.

webservice

 

 

2.8

Indicates that the agent should be deployed and accessed as a web-service.

features

*

 

2.8

Agent’s features description. See the Agent’s Features section.

platformTransformation

*

 

2.8

XSL transformation to apply to Platform XML documents before process them (see the Platform XSLT section).

accountTransformation

*

 

2.8

XSL transformation to apply to Account XML documents before process them (see the Account XSLT section).

servicesTransformation

*

 

2.8

XSL transformation to apply to Services XML documents before process them (see the Services XSLT section).

readme

*

 

2.8

Reserved but not supported yet.

Example:

<?xml version="1.0" encoding="UTF-8"?>

<migrationAgent xmlns="http://www.parallels.com/psa/migration/agent" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=

"http://www.parallels.com/psa/migration/agent AgentManifest.xsd">

<sourceSystem>SampleSourceSystem</sourceSystem>

<version>1.1.8</version>

<connectionSettings>

<ssh>

<executable>agent.pl</executable>

</ssh>

</connectionSettings>

<features>

<disableSubscriptions>true</disableSubscriptions>

</features>

</migrationAgent>