Jump to: navigation, search

Installing OSGi Remote Services

Redirect page

Depending upon your OSGi framework, there are several ways to install ECF's support for OSGi Remote Services and Remote Services Admin.

Using Equinox/Eclipse as the OSGi Framework

Adding ECF to Target Platform

To add ECF to your target platform:

  • In the Eclipse main menu, select Window->Preferences
  • In the Preferences tree (on left) navigate to Plug-in Development->Target Platform
  • From the buttons on the right, select either Add... to create/add a new target platform, or Edit... to add ECF to your existing target platform


  • Select Software Site



  • Open the Eclipse Communication Framework (ECF) tree item, and select the parts of ECF that you want in the target platform. The three available items are:
    • ECF Filetransfer Patch for Eclipse. This is an update to the ECF filetransfer and core plugins that are distributed as part of the Eclipse SDK (in support of p2)
    • ECF Remote Services Target Components. This is the OSGi Remote Services components of ECF only. If you are only interested in the ECF OSGi 4.2 Remote Services part of ECF, you can just select this one item to add to your target platform
    • ECF Target Components for Eclipse. This is all of ECF...both the Remote Services parts of ECF, as well as the other parts of Eclipse relevant to Eclipse (e.g. presence/IM, IRC client, collaboration, real-time shared editing, etc)


  • IMPORTANT: Deselect the Include required software check box in the lower left. The default is selected, and so this must be explicitly deselected to successfully install ECF into a target platform. Explanation: There is a bug in the PDE editor that currently prevents ECF from distributing a repository that will allow things to succeed with the Include required software selected


  • Click Finish. After some reading of the target platform and the ECF repo it should result in a output like the following


  • Click Finish

Install into Eclipse

To install ECF Remote Services (and/or other parts of ECF) into Eclipse:

  • From the Eclipse main menu, select Help->Install new software...
  • In the upper right of the dialog, click on Add... to add the ECF repository location
  • In the Name: field put: ECF 3.5, and in the Location: field put: http://download.eclipse.org/rt/ecf/3.5/site.p2 and click ok


  • Select the parts of ECF you would like and choose Next->. For example


  • Follow the rest of the install process

Install into Felix or other non-Equinox OSGi Framework

See README for doing this at ECF's github ECF4Felix location