ShowTable of Contents
The XPages2Eclipse API and Add-on products are implemented as a set of Eclipse plugins and features and make use of the XPages Extensibility API
provided by IBM.
This Extensibility API is available as of IBM Lotus Notes 8.5.2, which therefore is the minimum requirement for XPages2Eclipse as client and server platform.
XPages2Eclipse is implemented as pure Java code (no native libraries) running against Eclipse and Lotus Notes APIs. The product was tested on Windows and Linux based Domino servers and Windows, Linux and Mac as Notes Client platforms. It is expected that the server part will also run on other operating systems, but these platforms (e.g. AIX) are currently not officially supported.
Manual Deployment in Notes Client / Domino Designer
A step-by-step installation wizard guides you through the installation and setup process for the product when you open the installation database: Install plugins/features through widget deployment
On the last page of the installation wizard, you need to install the XPages2Eclipse plugins and features into your Lotus Notes Client, followed by an automatic Client restart.
To achieve this, the XPages2Eclipse installation database is based on
Update Site design template
from IBM, which contains the plugins/features as a set of Notes documents.
The installation is done using widget deployment
, which means that you need to drag and drop the widget, a small xml file called "extension.xml" with XML code pointing to the plugins/features in the installation database, into the My Widgets panel in the sidebar of the Lotus Notes Client.
The update site template has been enhanced so that the widget file is automatically created when the database is opened. This ensures that the widget always points to the right database, even when that database is copied to a corporate Domino server and it's server/replica is may change.
If Lotus Notes reports any errors during installation, you should find a detailed error report via the menu action "Help/Support/View Trace" and can hopefully track down the issue (e.g. disk full, installation database cannot be resolved).
It's also possible that custom plugin installation is prohibited via policy by your administrator. In that case, you should ask for installation rights or schedule an automatic deployment on your workstation.
Automatic Deployment in Notes Client / Domino Designer to many machines
This section contains instructions to automatically deploy the XPages2Eclipse product to a number of machines.
Plugins and features
The recommended way to automatically deploy Eclipse plugins/features to a number of workstations is to
- copy the XPages2Eclipse installation database to a Domino server
- open the installation database on the server and save the "extension.xml" widget XML file to a local folder
- set up a widget catalog database
- create a new catalog entry, import the XPages2Eclipse widget XML file and assign a category value (e.g. "XPages2Eclipse")
- configure the Domino policy
In the policy document, you can specify one or more categories of the widget catalog that should be deployed automatically. By removing categories from the policy, the plugins/features will be deleted from the Notes Client installation on the next startup.
To deploy an update, replace the widget in the widget catalog with a newer version. The Notes Client automatically checks for newer versions every 24 hours and will initiate a software update including Client restart.
Additional setup steps are required for a completely silent deployment (that means no installation prompts to confirm the plugin code signature and installation).
Please refer to the Domino Administrator documentation and the provided wiki articles for details. For our German audience, we have attached very good and detailed session slides of René Winkelmeyers Plug-in session at Entwicklercamp 2011 to this wiki article (see the attachments section).
The following Lotus Notes and Domino Wiki articles will give you a step by step guide in plugin deployment:Deploying the IBM Lotus Learning Widget using a Widgets Catalog and policy documentsDeployment Guide
Deployment on Domino Server
Xpages2Eclipse needs to be deployed to a Domino server, if users should be able to access an XPages database with their web browser and that database is using XPages2Eclipse technology.
The XPages2Eclipse installation database contains code from the OpenNTF project Plugins Deployment for Domino
for this purpose that makes the deployment process on Domino Servers very easy.
The following steps are required to deploy XPages2Eclipse on a Domino server:
- copy the installation database to the server
- sign the database with a Notes ID that has admin privileges on the server (the deployment agents will access the filesystem to add/remove plugin archives from the server's OSGi framework)
- open the installation database and click on the link "Manage Update Site"
- in the "Server Deployments" view, create a new Server Deployment document, enter the server, select the features/plugins to be installed and check/uncheck the options as required
- activate the agents "DeployOnSchedule" and "DeployOnServerStart" in the database design
The installation database can also be used to deploy plugin updates and remove plugins from the Domino server.