Portlet Factory, Version 6.1.2

 

IBM WebSphere Portlet Factory generated update site for the Rich Client WAB and feature

This describes the characteristics of an Eclipse/OSGi update site and suggests update mechanisms.

Typically, an Eclipse/OSGi update site is a folder (either just on disk or in an HTTP servable content area) that contains a site.xml file at the root level, and features/ and plugins/ subfolders as children of the root (siblings of the site.xml file).

The following is a directory listing of a generated update site, feature and plugin WAB, for a IBM® WebSphere® Portal project named mytest. The feature jar contains the file, feature.xml, which describes the plugins that are associated with that feature. In the example, the single plugin is for the mytest WAB. The plugin jar is the generated portlet WAB. This is the same as a portlet WAR, but with the addition of the Eclipse plugin.xml file and the OSGi manifest.mf file which describe the bundle. 

Directory of C:\eclipse\workspace\mytest\WPFExpeditorUpdateSitemytest 05/30/2007 01:03 PM    <dir>    . 05/30/2007 01:03 PM    <dir>    .. 05/30/2007 01:03 PM    <dir>    features 05/30/2007 01:03 PM    <dir>    plugins 05/30/2007 01:03 PM        166 site.xml
        1 File(s)      166 bytes Directory of C:\eclipse\workspace\mytest\WPFExpeditorUpdateSitemytest\features 05/30/2007 01:03 PM    <dir>    . 05/30/2007 01:03 PM    <dir>    .. 05/30/2007 01:03 PM        897 mytest_1.0.0.200705301302.jar
        1 File(s)      897 bytes Directory of C:\eclipse\workspace\mytest\WPFExpeditorUpdateSitemytest\plugins 05/30/2007 01:03 PM    <dir>    . 05/30/2007 01:03 PM    <dir>    .. 05/30/2007 01:03 PM     5,044,318 mytest_1.0.0.200705301302.jar
        1 File(s)   5,044,318 bytes

To use this generated update site with the IBM Lotus® Expeditor update manager, click File > Application > Install > Search for New Features dialog, and then select Add Folder Location, and choose C:\eclipse\workspace\mytest\WPFExpeditorUpdateSitemytest as the folder based update site location.

To use this generated update site with the IBM Lotus Notes® 8 Composite Application Editor palette, click Tools > Component Palette > Add Components > Add Components from Update Site, choose local update site and choose C:\eclipse\workspace\mytest\WPFExpeditorUpdateSitemytest as the folder based update site location.

If you choose to put the generated folder-based update site on an HTTP server either manually to your own HTTP server, or by deploying the generated WAR that wraps the folder based update site to a J2EE server, then you would specify remote update site and the HTTP based URL to the site.xml file in that hosted update site.

If you use the portlets within a WebSphere Portal Composite Application, and then want to automatically provision your project WAB feature from your update site to IBM Lotus Expeditor, when the composite application is provisioned from WebSphere Portal to IBM Lotus Expeditor, then you can list the Update Site in the provisioning preferences for IBM Lotus Expeditor by setting the following preference values in the C:\Program Files\IBM\Lotus\Expeditor\rcp\plugin_customization.ini file: 

com.ibm.rcp.provisioning/updateSiteList=file:///eclipse/workspace/mytest/WPFExpeditorUpdateSitemytest|file:///eclipse/workspace/myothertest/WPFExpeditorUpdateSitemyothertest com.ibm.rcp.provisioning/useList=true com.ibm.rcp.provisioning/useFeatureURL=true
Restart IBM Lotus Expeditor. See the IBM Lotus Expeditor developer and administration guides for more information on setting provisioning preferences.

Note: You may specify multiple update sites (file URL or HTTP URL) in the updateSiteList preference by separating them with the vertical bar (|) character.

WebSphere Portlet Factory generates portlet preferences containing the feature information that you specified in the WebSphere Portlet Factory Rich Client Platform project properties dialog that identify which Eclipse feature id and version is associated with each portlet. When you provision a composite application from WebSphere Portal down to IBM Lotus Expeditor, if a feature URL is not also specified in the portlet preferences (either in the portlet.xml descriptor or in the WebSphere Portal Rich Client Platform administration UI), then the IBM Lotus Expeditor platform will search for a feature with the portlet preference specified feature id, in the provisioning list of update sites. In IBM Lotus Expeditor 6.1.1 and IBM Lotus Notes 8.0.0, the simplest way to specify the provisioning update site list, is to add the above preference values to plugin_customization.ini (which resides in C:\notes\framework\rcp for most default IBM Lotus Notes 8 installations).

Note: In future releases of IBM Lotus Expeditor 6.x.x and IBM Lotus Notes 8.x.x, there may be administration UIs to manage and possibly restrict the update site lists used for provisioning features. At such time, the default settings set in plugin_customization.ini may be overwritten with administrator managed settings, so please refer to your current IBM Lotus Expeditor or IBM Lotus Notes 8.x administration documentation for the correct means of managing update sites for the current version of your rich client platform.

Parent topic: About Building IBM WebSphere Portlet Factory-based Web Application Bundles (WAB) for Rich Client Platforms (RCP)

Library | Support |