Launching the Equinox OSGi Framework

This section describes how to launch the Equinox OSGi Framework with the SAT core runtime bundle installed. It is assumed that you have installed the SAT runtime bundles.

Select Run > Run... to open the Run dialog.
Create a new launch configuration by right clicking Equinox OSGi Framework on the left of the dialog and choosing New from the context menu.
Enter a name for this launch in the Name field, such as "SAT Runtime".
On the Plug-ins page, uncheck both the Workspace Plug-ins checkbox and the Target Platform checkbox. This deselects all the bundles, which is a good place to start.
Under Target Platform check the checkbox to the left of org.eclipse.soda.sat.core and then click the Add Required Plug-ins button. You should now have 4 bundles checked, all of which are required for a successful launch.

Equinox OSGi Framework

Click the Validate Plug-in Set button to validate that the set of bundles fulfill all the necessary package dependencies.
While not absolutely necessary, but still recommended, uncheck the Add new workspace plug-ins to this launch configuration automatically checkbox since this will prevent your launch configuration from changing as you add new projects to your workspace.
Turn to the Settings page and check the Clear the configuration are before launching checkbox. This is highly recommended since it ensures that every time you launch the framework the OSGi persistent store will be recreated, removing the chance of a previous version of you code being persisted and interfering with your testing.

Create plug-in project

Finally click the Run button to launch the Equinox OSGi Framework with the org.eclipse.soda.sat.core bundle installed and started.
In the Eclipse Console view you will see the osgi> prompt at which you can type ss to get a short status list of the installed bundles.
Type help at the osgi> prompt for a list of other available commands.

OSGi Console

To terminate the launch type close at the osgi> prompt.

| Next