Updating a product or extension

By following the prescribed procedures for packaging and installing products, we can take advantage of the platform update manager, which treats products and extensions in a uniform way and allows users to discover and install updated versions of products and extensions.

Before looking at the implementation of such a server, it's important to revisit some important concepts:

That said, what do we do if we want to fully participate in the platform implementation of product updating and use its update server?

Feature and plug-in packaging

The previous example product and extension directory structures show how features and plug-ins are laid out once they are installed.  In order to install features using the update server, the features must be packaged in a feature archive file.  This is described in Feature Archive Files.

Plug-ins and fragments must be packaged according to the format described in Plug-in Archive Files.

Update server layout

The update server must be a URL-accessible server with a fixed layout.  The list of available features and plug-ins provided by the server is described in a site map file, site.xml.  The update server URL can be specified as a full URL to the site map file, or a URL of a directory path containing the site map.  The site map file contains a list of all the available features and the location of the feature archives on the server.  It also describes the locations of the plug-in archives that are referenced in the feature manifest.

A simple site layout for our example web product and extension could look something like this:

<site root>/
	site.xml
	features/	(contains feature archive files)
		com.example.acme.acmefeature_1.0.1.jar
		com.example.betterwebs.betterfeature_1.0.1.jar
		...
	plugins/	(contains plug-in archive files)
		com.example.acme.acmefeature_1.0.1.jar
		com.example.acme.acmewebsupport_1.0.3.jar
		com.example.betterwebs.betterfeature_1.0.1.jar
		com.example.betterwebs.betterwebsupport_1.0.1.jar
		...

The complete definition for the site map is described in Update Server Site Map.

Update servers and policies

An Eclipse update server is provided for updating the platform itself. In addition, the platform update UI allows users can maintain a list of update servers that can be searched for new features. Any site that conforms to the specified update server layout may be added to the list. Users can choose to manually or automatically search for additional features or upgrades to their installed features.

Some organizations may wish to have more control over how their user installations are updated. This can be accomplished with an update policy file that specifies which features can be updated and which servers can be used to update a particular feature. See Update Policy Control for a complete definition of the policy file and how it is used.