Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Swordfish Documentation: Running Target Platform

Running Swordfish Target Platform

This section contains instructions on setting up the Swordfish Target Platform produced by the headless build.
For more information about Swordfish headless builds, see Creating a headless build.

Prerequisites

Eclipse Galileo M7 build or later. The examples described here are based on Eclipse Galileo M7.

Setting up Target Platform

To run Swordfish Target Platform do the following:

  1. Create a new Target Platform definition. Click File > New > Other... > Target Definition
  2. Add the location (path) of the built Swordfish plugins to the list of locations presented in the definition.
    Target definition site.png

  3. Add to the platform definition location of Equinox the bundles that are necessary to run the target platform.
    When the build process successfully ends, you can find these bundles in the platform directory of org.eclipse.swordfish.build project.
    Target definition.png

    Go to the Content tab and select the bundles listed in c: as shown in this figure.
    This means that all bundles from the target platform as well as the Eclipse Equinox bundles must be selected. Target content1.png

  4. Configure Eclipse to use the Swordfish target platform.
    1. Click Window > Preferences > Target Platform and set the newly created definition as active target platform.
      Target platform.png

    2. In the Run Configurations... dialog create a new OSGi configuration based on Swordfish Target Platform.
      Launch configuration.png

  5. Switch to the Arguments tab and type the following VM arguments:
    -Dorg.osgi.service.http.port=9001
    -Dorg.eclipse.swordfish.registry.fileLocation="C:\swordfish\repository"
    -Dosgi.noShutdown=true
    -Dservicemix.base=.
    
    1. The value of org.osgi.service.http.port must be set to 9001 - the default port that the remote resolver uses to connect to the Swordfish registry.
    2. The next property org.eclipse.swordfish.registry.fileLocation must point to the directory where all the WSDL files that need to be loaded by the registry are placed.
    3. The properties osgi.noShutdown and org.osgi.framework.system.packages are the Eclipse Equinox (OSGI) container specific properties. The value must be set for osgi.noShutdown to true because Equinox shuts down by default after the start up if it does not find an Eclipse application. For details on this issue, see [Quick Start].

    For more information about Swordfish Registry properties, see Launching the Service Registry.

    Launch configuration vm params.png



Swordfish Documentation Home
Swordfish Wiki Home

Back to the top