Previous page

Next page

Locate page in Contents

Print this page

Creating Parallels Update XML File

Create a file named parallels_updates.xml on the Web server where it can be accessed via HTTP. The file is an XML document that should contain specifications for a particular Parallels Desktop update available on your local updated server.

To create your own document, use the following sample XML document and the XML document specification that follows it as a reference.

Sample parallels_updates.xml file

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

<ParallelsUpdates schemaVersion="1.0">

<Product>

<ProductName>Parallels Desktop</ProductName>

<UpdateEnabled>1</UpdateEnabled>

<Version>

<Major>8</Major>

<Minor>0</Minor>

<SubMinor>12494</SubMinor>

<SubSubMinor>262214</SubSubMinor>

<StringRepresentation>Sumer</StringRepresentation>

<Update uuid="desktop.8.0.13291.237436.en_US.parallels.mac">

<UpdateType>0</UpdateType>

<UpdateName>Build 13291 is available!</UpdateName>

<UpdateDescription> Update description goes here </UpdateDescription>

<FilePath> URL to the update file goes here </FilePath>

<FileSize>219515</FileSize>

<Status>0</Status>

<DateTime>2012-06-17 01:23:00</DateTime>

<Chargeable>0</Chargeable>

<LocaleName>en_US</LocaleName>

<DistributorName>parallels</DistributorName>

<OsType>mac</OsType>

<Ancestry>

<Ancestor>desktop.8.0.12927.482436.en_US.parallels.mac</Ancestor>

<Ancestor>desktop.8.0.12473.274921.en_US.parallels.mac</Ancestor>

<Ancestor>desktop.8.0.12262.823647.en_US.parallels.mac</Ancestor>

</Ancestry>

</Update>

</Version>

</Product>

</ParallelsUpdates>

XML Document Specification

Name

Type

Description

ParallelsUpdates

Root element.

Product

Container for Parallels Desktop information.

ProductName

string

Use "Parallels Desktop".

UpdateEnabled

int

Specifies whether the automatic updates are enabled. To enable updates, specify 1.

Version

Container for Parallels Desktop version information.

Major

int

Major version number.

For Parallels Desktop 7, specify 7.

For Parallels Desktop 8, specify 8.

Minor

int

Minor version number. Specify 0.

SubMinor

Build number. This element may be empty.

SubSubMinor

Revision number. This element may be empty.

StringRepresentation

Product codename. This element may be empty.

Update

Container for the information about the Parallels Desktop update.

Attributes:

uuid — string; a globally unique ID identifying the product.

The uuid attribute is very important and must contain the correct information for the update to work. The attribute value consists of the following parameters (substrings) separated by periods (see the provided XML example):

desktop — specify "desktop".

major — major version number (8).

minor — minor version number (0).

build — build number.

revision — revision number.

locale — locale ("en_US", "de_DE", etc).

vendor — vendor ("parallels").

platform — platform ("mac").

UpdateType

int

Update type. Specify 0.

UpdateName

string

The name for the update, user-defined.

UpdateDescription

string

The update description.

FilePath

string

A URL to the update file on your local update server. The actual update files can be obtained from Parallels.

FileSize

int

The update file size, in megabytes.

Status

int

Specify 0.

DateTime

string

Date and time when the updated was published. Use the following format:

yyyy-mm-dd hh:mm:ss

Chargeable

int

Specify 0.

LocaleName

string

Locale name ("en_US", "it_IT", etc).

DistributorName

The update distributor name. Specify "parallels".

OsType

Operating system type. Specify "mac".

Ancestry

Container for the list of updates that directly preceded this update.

Ancestor

string

An individual Parallels Desktop update information.

This element may appear more than once in the same document, one for each update.

The value is combined using the following parameters (substrings) separated by periods (see the provided XML example):

desktop —  specify "desktop".

major — Parallels Desktop major version number.

minor — minor version number.

build — build number.

revision — revision number.

locale — locale ("en_US", "ru_RU", etc.)

vendor —  vendor ("parallels").

platform -— platform ("mac").