You can use the OSGI Bundles portlet to install and manage bundles. On the administration console, select the OSGI Bundles portlet in the Resources folder from the left navigation panel to access the portlet.
This document is organized into the following sections:
Installing an OSGi Bundle
You can install an OSGi Bundle by using the OSGI Bundles portlet on the administration console with the following steps:
- Click Browse to specify the location of the bundle you want to install.
- (Optional) Input a non-negative integer into the Start Level field to set a start level for your bundle. By default, the start level of a bundle is set to 60.
- (Optional) Select the Start check box if you want to start the bundle after installation.
- Click Install.
Each OSGi Bundle is associated with a start level that enable the server to control the relative starting and stopping order of bundles. Only bundles that have a start level less or equal to the active start level of the server framework must be active. Usually, a bundle with a smaller start level tend to be started earlier.
Managing the status of OSGi Bundles
The OSGI Bundles portlet displays the installed OSGi Bundles and their status in the table under the installation area. You can start, stop and uninstall the bundles in this table.
The table includes four main sections:
- Id: This column displays the bundle Id which is unique for each bundle. The bundles in the table are sorted according to the ascending order of their Ids. This listing order complies with the starting order of the bundles. The bundles with smaller start levels tend to have smaller Id numbers.
- Symbolic Name: This column displays the Symbolic Name of each bundle. This attribute is set by the Bundle-SymbolicName header in the MANIFEST.MF file in the bundle.
- Version: This column displays the version of each bundle, which is set by the Bundle-Version header in the MANIFEST.MF file in the bundle.
- State: This column displays the state of each bundle.
- Bundles that are started are shown as Active. You can stop the bundle with the following steps using the Stop button:
- Bundles that are stopped are shown as Resolved. You can start the bundle with the following steps using the Start button:
Steps for managing the installed bundles in the table:
- Select the check box of the bundle that you want to take action on.
- Click Start, Stop, or Uninstall according to your specific action.
Bundle information
Double click one bundle in the table, you will see the content of the MANIFEST.MF file of the bundle. This file contains headers that specify information that the server Framework needs to install correctly and activate a bundle. Such information includes: Import-Package, Export-Packages, Bundle-SymbolicName, Bundle-Version, and so on. For more information about the OSGi Bundles, see the OSGi Specifications.