Installing/Uninstalling Deployment Packages

Installing a Deployment Package

Installing a Deployment Package from the Workspace

Using mToolkit you can install directly from within Eclipse the deployment packages you are keeping in the workspace - package might be defined as deployment package project files (.dpp files are deployment package descriptions created with the Deployment Package Editor) or might be present as ready deployment package archives (.dp files).

To install a deployment package from your Eclipse workspace, in one of the Eclipse navigation views (e.g. Package Explorer) right-click the deployment package project .dpp file node or the .dp file node and select the target OSGi framework from the Install to menu. If you are installing the deployment package from a project, the project will be built and exported to a .dp archive file. Then, the .dp file will be transferred to the framework and installed. In case you are installing the package by using a ready archive file, the file will be directly deployed on the framework.

On success, the installed deployment package will appear under the Deployment packages node of the framework-specific tree.

Installing a Deployment Package from outside the Workspace

To install a deployment package, located outside your Eclipse workspace, on a connected OSGi framework:

  1. Go to the Frameworks view.
  2. Connect the OSGi framework where you will install the deployment package.
  3. To install the deployment package JAR file, right-click the framework node or the Deployment package node, and use Install Deployment Package.
  4. In the Install deployment package dialog, browse to the location of the deployment package JAR (with extension .dp) to install in the file system and click OK.

    Note: The package will be automatically signed prior to installation in case you have selected Automatic signing upon install in the connecting settings of the relevant framework (see "Adding/Removing an OSGi Framework").


    Figure 1: Installing a deployment package.

On success, the installed deployment package will appear under the Deployment Packages node of the framework-specific tree. Package's bundles will be attached to the package node as well as will be available in the Bundles node.

Note: To be able to install deployment packages, which contain additional resources beside bundles, you must have the relevant resource processor bundle(s) running on the OSGi framework.

Uninstalling a Deployment Package

To uninstall a deployment package from a connected OSGi framework, in the Frameworks view right-click the package from the Deployment Packages device node and use Uninstall Deployment Package.

Tip: You can also uninstall more than one deployment package with a single operation.

OSGi Management Overview
OSGi Frameworks Tree

Viewing the Manifest of a Deployment Package
Connecting/Disconnecting an OSGi Runtime
Managing Bundles

Frameworks View
Frameworks View Tree Icons
Frameworks View Menus and Toolbar