Parallels Desktop Business Edition Administrator's Guide v18 - Creating the Parallels update XML file

Creating the 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



  
    Parallels Desktop
    1
    
      12
      0
      12494
      262214
      Sumer
      
        0
        Build 13291 is available!
        Update description goes here</UpdateDescription>
        URL to the update file goes here</FilePath>
        219515
        0
        2017-06-17 01:23:00
        0
        en_US
        parallels
        mac
        
          desktop.13.0.12927.482436.en_US.parallels.mac
          desktop.13.0.12473.274921.en_US.parallels.mac
          desktop.13.0.12262.823647.en_US.parallels.mac

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 (e.g. 13)
`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 (e.g. 13) `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 user-defined update name.
`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 (e.g. "en_US") `vendor` — vendor ("parallels"). `platform` -— platform ("mac").