Creating a Remote OSGi Framework Launch Configuration

To create a remote OSGi framework launch configuration in Eclipse:

1. Open the Launch Configuration dialog of Eclipse by using the menu command Run > Run Configurations or Run > Debug Configurations.
2. Create a new launch configuration of type OSGi Runtime – right-click the OSGi Runtime node and select New. The OSGi Runtime launch configuration represents a connection configuration to a specific OSGi Runtime. The configuration name will start with New_configuration – you might rename it if needed in the configuration's Name field.
3. In the Main tab, fill in the settings for the connection to the remote framework:

   

   • Type – Allows you to choose the type of launching you are about to execute. Set it to TCP/IP Device.
   • Connection Properties – Provides the properties for the connection to the remote OSGi framework. In the Address field, fill in the IP of the remote OSGi framework.
     • Restart runtime – Restarts the OSGi framework even if it is already running with the desired configuration. If the Ask for confirmation before restarting option is checked, a confirmation dialog will be displayed asking whether to restart the running OSGi framework or not.
     • Connection port – The OSGi Remote Launcher uses default ports to connect to a remote OSGi framework. In case you want to use different ports or you try to run several configurations simultaneously for different OSGi frameworks started on the same PC, use these settings to define different values for the connection ports:

       •   IAgent controller port – The default value is 7365. Indicates the IAgent controller port.

       •   mBSA start port and mBSA port range end – The default value is 5670. Indicates the range of ports used for finding one for connection before stopping all attempts.

     • Start bundles and applications after install – Starts those bundles selected in Bundles tab and allows you to launch applications on the target remote OSGi framework, that are successfully installed during the launching process.
     • Do not uninstall bundles on launch termination – Indicates that installed bundles from the Bundles tab will not be uninstalled when the OSGi framework is stopped.
4. Next, go to the Bundles tab and choose the bundles you want to install on the remote OSGi framework from the ones available in your Workspace as Plug-in Projects or Maven Projects as well as from the ones in the active PDE target platform. In addition, you can also include collections of bundles defined as PAR Projects.

   Use the Add required bundles button to include the bundles from the workspace and target platform required by the ones you have already selected – in this way you can easily resolve the dependencies within the remote OSGi framework.

   Select bundles from the Target Platform option with extra care, since the JVM of the remote OSGi framework is supposed to be running already and changing the framework's target platform may lead to unexpected collisions.

   

5. Optional. To sign the bundles from the Bundles tab prior to their installation on the remote OSGi framework:
   1. Configure signer keystores in mToolkit preferences page and the path to jarsigner.exe from a JDK image.
   2. Back into the remote OSGi framework launch configuration, go to the Signing tab and check the box Sign content before deployment and then select the signer certificates from the ones set in mToolkit's preferences: