This section describes the deployment preferences you can change.
The following set of preferences are available and managed using Eclipse Preferences. IBM
® Expeditor allows many of them to be set by the user using the Install/Update Preferences page. You can set other preferences through manual file updates of the plugin_customization.ini file or through remote management of the org.eclipse.update.core node, the org.eclipse.update.scheduler node, and the com.ibm.rcp.provisioning node. See Managing Eclipse preferences
for more information on remote management of Eclipse preferences.
Preferences for org.eclipse.update.core
Location of the update policy file. This may be a local file or one accessible through an HTTP (or similar) URL. This preference is available to the user using the Install/Update Preference page.org.eclipse.update.core.historySize
Default: Not specified
Number of history update files to maintain for the platform.org.eclipse.update.core.checkSignature
Whether to check for signed feature objects during installation.org.eclipse.update.core.automaticallyChooseMirror
Automatically check Mirrors during feature installation.org.eclipse.update.core.updateVersions
Select the features that the scan for updates will select prior to display. Available values are compatible, equivalent, or major. This preference is available to the user using the Install/Update Preference page.
Preferences for org.eclipse.update.scheduler
Search for updates and notify when they are available (false) or download new updates automatically and notify when ready to install them (true). Ignored unless enabled preference set to true. This preference is available to the user using the Install/Update Preferences page.enabled
Whether to automatically search for updates.schedule
Determines when to search for new updates. Choices are to search on platform start (on-startup) or on a schedule (on-schedule). Ignored unless enabled preference set to true. This preference is available to the user using the Install/Update Preferences page.hour
Time of day to search for new updates (time specified in HH:00 AM|PM). Note that this value is locale dependent, so a setting for US English is not recognized correctly on another locale. Administrators managing platforms in multiple locales will need to set a locale specific setting. This preference is available to the user using the Install/Update Preferences page.day
Default: 1:00 AM
Day of the week to search for new updates. Values are Every day, or Every <dayname>. Note that this value is locale dependent, so a setting for US English is not recognized correctly on another locale. Administrators managing platforms in multiple locales will need to set a locale specific setting. This preference is available to the user using the Install/Update Preferences page.
Default: Every day
Preferences for com.ibm.rcp.provisioning.
(These preferences are not available through the preferences user interface. See Managing Eclipse preferences
for more information on how to change these values.):
Specifies the number of old versions of a feature to retain on the file system. The default values will depend on the platform configuration. If the platform configuration (install.configuration) is set to user, the default is 0. If the platform configuration is set to multiuser, the default value is -1, indicating that all feature versions are retained. The default value used on device configurations is 0. runDeferredActionsOnStartup
As an example, if the value is set to 0, then installing an updated version of a feature will cause the previous version of the feature to be removed. If the value is set to 1, then when an updated version of a feature is installed, a single previous version will be maintained. If there was more than one version already installed on the platform, then the oldest versions will be removed. Only older versions of the currently enabled feature are removed. Versions greater than the currently enabled feature will not be removed.
Specifies when deferred actions should run, such as the uninstall of old versions of features. When set to true, the deferred actions will run immediately when the platform starts, and no progress indicator will be displayed. When set to false, the deferred actions will run after the workbench has completed its startup processing, and a progress indicator will be displayed. The default value is false.updateSiteList
A list of Strings representing update sites separated by the vertical bar (|) character. For example:
The sites in this list are in priority order. The first site in the list will be searched first, then the second site, and so on. A feature found on the first site will be used, even if the same feature with a higher version may be available on the second or third site. The default value for updateSiteList
is an empty list.
A Boolean specifying how the updateSiteList will be used. useFeatureURL
If this property is set to true, then the Policy URL searching will be turned off and the useList preference, feature.xml update site, and the bookmarks.xml update site will be ignored.
A Boolean specifying whether to include update site URLs provided using feature.xml, provisioning manifest, or provisioning API request in the search list. useList
This preference determines if the feature.xml provided update site should be searched. The manifest and provisioning API requests are always used if specified. If the whiteList preference is set to true, then this value will be ignored.
A Boolean specifying whether the list of update site URLs defined in updateSiteList are used. Parent topic: Configuring deployment settings
If set to true, and if the whiteList preference is set to false, then the updateSiteList is used. If the whiteList preference is set to true, then this value will be ignored.