Pax Cursor

Unknown macro: {ops4j-style}

Starting with May 28, 2009 Pax Cursor has been merged into Pax Runner as Pax Runner Plugin for Eclipse.
The following information is only valid for versions before and including 0.9.0.

Pax Cursor is an Eclipse Plugin that adds Eclipse launch configurations for all [platforms] / versions supported by [Pax Runner].
By using Pax Cursor you will be able to install and start your bundles into any of Felix, Equinox, Knopflerfish or Concierge beside the built in Equinox. (even more you will be able to start more versions of Equinox). And you will do all of this without learning anything new beside what you already know as Pax Cursor transparently integrates into the OSGi Framework Launcher using the OSGi Frameworks extension (org.eclipse.pde.ui.osgiFrameworks).

If you are wondering from where the name "Cursor" came from, then is good to know that "cursor" is the latin translation for "runner".

User guide

To use the Pax Cursor Eclipse plugin you just reuse your knowledge regarding running/starting an OSGi framework in Eclipse PDE. What you get in plus are "just" more options on what framework to run in OSGi Framework Launcher framework comb-box. Just select the OSGi framework you want to start and you are good to go.
Use one of the folowing resources to learn about using Eclipse OSGi Launcher:

Other resources

Issue tracker

Issues, bugs, and feature requests can be submitted to the issue tracking system.

System Requirements

Installation guide

You can use an update site (preferred) or a manual installation as follows:

OPS4J Pax Eclipse Update Site

Follow this instructions in order to install Pax Cursor via Eclipse's update manager:

  1. While in Eclipse, go to Help -> Software Updates -> Find and Install.
  2. Select option "Search for new features to install" and click on "Next".
  3. Click on "New Remote Site" (on the right side on the dialog).
  4. In the opened dialog enter the values bellow and then click on "OK": see screenshot
  5. Back in the main dialog you should have an entry named "OPS4J Pax Update Site" with a checkbox select before the name (if not checked, select it). Click on "Finish".
  6. In the opened dialog you should see a tree like structure. Drill down as much as you can and select the checkbox for the version you want to install, preferably the latest version and click on "Next". see screenshot
  7. Next you will get the license agreement screen. Read the license and select "I accept the terms in this license agreement" if you wish to continue and then click on "Next".
  8. On next wizard page click "Finish"
  9. The download of the plugin should start now. Once done you will get a question if you wish to install the plugin (the feature are not digitally signed). Click "Install" (or "Install All").
  10. On the question "Would you like to restart now?" click "Yes" (you can also use "Apply Changes")

Manual installation

Download on of the versions bellow and copy it into your Eclipse installation plugin folder (or target platform/plugins if you are using this way of working). Then start/restart Eclipse and you are ready.

Source code

https://scm.ops4j.org/repos/ops4j/projects/pax/cursor ( or browse via FishEye )
This project builds with Apache Maven and uses Apache Felix's maven-bundle-plugin, and Peter Krien's bnd tool.

Pax Cursor 0.9.0 Released

Pax Cursor 0.9.0 has been released.
This release highlights are:

  • support for Equinox 3.4.2
  • support for Felix 1.6.0, 1.6.1, 1.8.0
  • support for Knopflerfish 2.3.0, 2.3.1
  • support for snapshot versions (latest, unreleased) of Felix, Equinox, Knopflerfish
  • uses version 0.20.0 of Pax Runner

Checkout release notes for details.

Pax Cursor 0.8.0 Released

Pax Cursor 0.8.0 has been released.
This release highlights are:

  • support for Felix 1.4.0, 1.4.1
  • support for Knopflerfish 2.2.0 and older ones 2.0.1, 2.0.2
  • uses version 0.17.0 of Pax Runner

Checkout release notes for details.

Pax Cursor 0.7.0 Released

Pax Cursor 0.7.0 has been released.
This release highlights are:

  • support for Equinox 3.4.0, 3.4.1
  • support for Felix 1.2.0, 1.2.1, 1.2.2
  • support for Knopflerfish 2.1.0, 2.1.1
  • uses version 0.14.2 of Pax Runner

Checkout release notes for details.

Pax Cursor 0.6.0 Released

Pax Cursor 0.6.0 has been released.
This release highlights are:

  • support for Equinox 3.3.2, Felix 1.0.4, Knopflerfish 2.0.4/2.0.5
  • uses version 0.10.0 of Pax Runner

Checkout release notes for details.

Pax Cursor 0.5.0 Released

Pax Cursor 0.5.0 has been released.
This release highlights are:

Checkout release notes for details.