This section provides information about how feature updates are handled. Updating an application is similar to the initial installation.
® Expeditor uses the rcp/eclipse
directory within the Lotus
Expeditor root for its own features and plug-ins. The shared
directory is provided as an Eclipse extension, and the default installation location for new features.
When new versions of features are provided, they are installed into the same directory as the previous version. The installation directory for a feature update cannot be changed. Some features have a colocation-affinity
attribute specified. In this case, the feature and its plug-ins are installed to the same location as the feature specified by the colocation-affinity
Versions for features are specified using major.minor.service
qualifier. For example, a version of 4.0.1 has a major version of 4, a minor version of 0, and a service version of 1. An equivalent version is a version that differs first at the service level. A compatible version is a version that differs first at the minor level. For example, using our version 4.0.1 in the previous example, a version of 4.0.2 would be an equivalent version, because the service value is the first value that changed. A version of 4.1.2 would be a compatible version, because the minor value is the first value that changed. A major version is a version that differs first at the major level. For example, using our version of 4.0.1, a version of 5.0.0 would be considered a major version upgrade.
The Automatic Updates capability provided as part of the Application Manager dialog enables updates of only major, equivalent or compatible versions, according to the preferences selected in the Install/Update dialog, which you access as follows: Manage
. The default value is for equivalent updates. Updates can only be performed here for features that have the URL and update attributes specified in their feature.xml file. For example:
<update_label="Your Update Site"
For additional information on versioning, refer to the Feature manifest section of the Platform Plug-in Developer's Guide
and to Eclipse ( http://help.eclipse.org/help32/index.jsp
Eclipse feature update on devices
You can search for updates to one or all existing applications that are installed on the Lotus
Expeditor on the device. When new versions of features are available, they are installed into the same directory as the previous version. The installation directory for a feature update cannot be changed.
The default update type on the Lotus
Expeditor for Devices is equivalent
. This means that the update process will search for all equivalent versions on the update site and update to the highest of all versions. The update type can not be changed by the user. However, the administrator can change it using a properties configuration job. To change the update type, modify the following property:
is the file name, and Eclipse.update.core.updateVersions
is the property key. There are three supported property values: equivalent
, and major
. The equivalent
value means the update process only searches equivalent versions on the update site. The compatible
value means the update process searches all equivalent and compatible versions, and the major
value means the update process will search all versions greater than the existing one.
Parent topic: Creating a feature