ECF Logo Eclipse Communication Framework (ECF)

an eclipse runtime project

New and Noteworthy
3.13.0 Release

Return to ECF download page

New and Noteworthy for 3.12.0/Mars

New and Noteworthy for 3.12.1

Idea Icon

API to Create Distribution Providers

For some time, it has been possible to create custom remote service distribution providers. A number of distribution providers already exist, but with 3.13.0 new API has been added to simplify the creation of new distribution providers. This API is described with examples in a new Tutorial: Creating Custom Distribution Providers. See new tutorial for details

Remote Management for OSGi Runtimes and Eclipse

At the ECF Github organization, we've created OSGi Remote Services allow remote monitoring and management of any OSGi container (e.g. Eclipse, Equinox, Karaf, Concierge, others). The repository containing the service APIs, implementations, and tooling for Remote Management are here. Each management service is declared and implemented in separate bundles, so that only relevant services may be installed and used in appropriate environments. For example, if Karaf server environments the OSGi management services would be completely appropriate, and the Eclipse-specific services listed below would not be needed.

  • Framework Management Services
    • Framework Manager - Remotely access framework-level information such as framework properties, and get/set start levels.
    • Service Manager - Remotely access information about running services.
    • Bundle Manager - Remotely access information about bundles in framework, and remotely start/stop bundles.
    • Wiring Manager - Remotely access information about bundle wiring.
    • Application Manager - Remotely access information about OSGi applications. Also allows remotely starting/stopping applications.
    • Service Component Runtime (SCR) Manager - Remotely access meta-data about SCR/DS components. Also allows remotely enabling/disabling components.
    • Remote Service Admin Manager - Remotely access meta-data about RSA such as RSA events, and remote service registrations and references. Also allows remotely exporting, importing, updating, and closing remote services.
  • ECF Management Services
    • Identity Manager - Remotely access meta-data about ECF Namespaces and IDs, and remotely create/add namespaces and IDs.
    • Container Manager - Remotely access meta-data about existing and active ECF Containers, and remotely create new containers.
    • Shared Object Manager - Remotely access information about existing meta-data about shared object containers and shared objects, and remotely create and delete shared objects.
  • Eclipse-specific Management Services
    • P2 Management Services
      • Feature Install Manager - Remotely access feature meta-data and install, update, and install P2 feature groups.
      • Profile Manager - Remotely access meta-data about existing and active P2 profiles.
      • Repository Manager - Remotely access meta-data about repositories and their contents, and remotely add, refresh, and remove repositories.

Each of the above services also has an async proxy service interface (e.g. IServiceManagerAsync), allowing the remote service to be accessed via a non-blockingasync proxy created automatically for the service by ECF's Remote Services implementation. Host implementations of each of these services are also available in corresponding host bundles.

Also included in the OSGi Remote Management repository are Eclipse plugins to expose a running Eclipse as a host for remote management, or to use Eclipse views as a consumer to manage a remote host. For example, here is a new Eclipse Preferences user interface for exporting a Service Manager and an RSA Manager remote services:

Once exported, then on Eclipse consumers where the service can be discovered (e.g. on same LAN), a Remote OSGi Service view and a Remote RSA Manager views may be displayed, showing the remote host's currently Exported remote services (above) and the remote host's currently running OSGi services.

A P2 Repo containing the Remote Management API, Eclipse Remote Management Host and Eclipse Remote Management Consumer along with the Remote OSGi Services, and Remote RSA Manager views shown above can be found here. The P2 Repo containing the 5 Remote Management Features can be accessed directly or via the zip.

Enhanced Remote Services/Remote Service Admin Tooling

In ECF 3.10.0/Mars a Remote Services Perspective was introduced. This perspective included an Endpoint Discovery View allowing endpoints to be discovered (via network discovery and/or xml/EDEF-file-based discovery), examined, and imported for use as a remote service.

In this release, there's a new Remote Service Admin (RSA) manager view. This view presents the Exported Services and Imported Endpoints for the RSA running within Eclipse, allowing the programmer to examine and manipulate exported services and imported endpoints. This tooling may be used to test and debug ECF Remote Services by monitoring and managing the remote services export, discovery, and import.

For example, here is a screenshot showing an endpoint that has been exported and published for by a remote host (e.g. by a Karaf-based host), and then discovered via the Zeroconf protocol (presented in the Endpoint Discovery View)

The user can select this Discovered Endpoint, open the context menu, and select the 'Import Remote Service' menu. The selected Endpoint will then be imported, and the Imported Endpoint will appear in the RSA Manager view.

Note that the imported endpoint (the remote service proxy) is also presented in the OSGi Services View, and the properties associated with the selected mported endpoint are presented in the properties view.

The Imported Endpoints presented in the RSA Manager view can be Unimported (again via context menu). As well, if remote service hosts are exported, they will appear under the Exported Services group in the RSA Manager, and can also be unexported via the RSA Manager context menu.

New Distribution Providers and Distribution Provider documentation

Using the remote services distribution provider API above, several new distribution providers have been created:

Detailed documentation of existing distribution providers